spine-template.md 4.3 KB


name: '{name}' type: architecture-spine purpose: build-substrate # build-substrate (default) · discussion · report · deck altitude: feature # initiative (keeps features) · feature (keeps epics) · epic (keeps stories) paradigm: '{named design pattern, e.g. hexagonal, layered, pipes-and-filters, actor}' scope: '{what this spine governs}' status: draft # draft · final created: '{date}' updated: '{date}' binds: [] # capability / unit IDs governed (from the driving spec; at epic altitude, also the inherited parent AD ids) sources: []

companions: []

Architecture Spine — {name}

Design Paradigm

Inherited Invariants

Inherited From parent Binds here
{AD-id / convention} {parent spine} {what it constrains in this scope}

Invariants & Rules

AD-1 — {decision}

  • Binds: {capability / unit ids / fr/nfr's, areas, or all}
  • Prevents: {the divergence this stops}
  • Rule: {the constraint downstream must follow}

Consistency Conventions

Concern Convention
Naming (entities, files, interfaces, events)
Data & formats (ids, dates, error shapes, envelopes)
State & cross-cutting (mutation, errors, logging, config, auth)

Stack

Name Version
{language / framework / key dep / platform / chain} {pinned version}

Structural Seed

{root}/
  {dir}/   # {what lives here}

Capability → Architecture Map

Capability / Area Lives in Governed by
{CAP-id / area} {component / module} {AD-id, convention, paradigm}

Deferred