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