03 Architect

03 · Architect — realize (system)

Two modes. 03-architect init writes the durable system shape (system.md + the tech-stack ADR + the ADR index). 03-architect sprint N writes per-feature specs (with Verification Contracts) + any new ADRs for that sprint's REQs. Both reference REQs by ID and realize within the declared envelope (architecture-constraints.md). You are the second skill to run Reconcile — and the first to run its judgment pass in a context-isolated subagent (the architecture reconciler, shared/subagent-protocol.md).

Operating principle — realize, and reconcile (subagent-isolated)

Two moves, run together:

• Realize. Turn architecture-constraints.md + the sprint's REQs (+ the 02 design contract) into a lean

system shape, decisions (ADRs), and feature contracts. Reference REQs by ID; derive freely below the governed envelope. Fix only load-bearing invariants; mark starting values seed, un-needed ones deferred.

• Reconcile. Challenge architecture-constraints.md two ways: contradiction-flag — the realization violates a

stated constraint / Constitution mandate (a datastore that can't meet a stated REQ); flesh-out — a declaration-altitude decision the architecture forces is missing / derived. Both → Tier-2 gate, resolved by the tech-mandate flow (amend the constraint and record a resolving ADR — one trigger, two altitudes). Run it as a dual pass: Pass 1 deterministic inline, Pass 2 judgment in a fresh-context subagent. Full method: references/reconcile-architecture.md.

The boundary-test = the constraint line. Reconcile fires only on the governed layer (stated architecture- constraints: stack · hosting · region/residency · compliance · scale · "no X" · Constitution mandates); the delegated layer (the C4 shape · component decomposition · internal data shapes · library picks within the envelope) is free realization — no amendment, ever. A named-technology or scale change is minimum Tier 2.

Profile switch — agent-system. Read the spine's Profile (the per-seat toggle table in shared/agentic-profile.md). Under agent-system, ADRs carry a Category: line (memory · model-binding · topology · durability · isolation · observability · classic), a multi-agent topology ADR REQUIRES the ~15× token-economics justification, and a distributional REQ gets a Verification-Contract row with method eval-suite (oracle = the eval harness; harness cmd · dataset ref · floor). The Design-Contract STOP consults the profile (a skill-pack slice has no design contract; an agent-system manifest points at tools/turns). Craft: references/reconcile-architecture.md (categories) + references/feature-spec.md (the eval-suite oracle + the STOP). mcp-server transport/auth ADRs + the four MCP VC checks are RESERVED (Task 3.5b) — do not synthesize them.

Embedded-agent module — Profile: webapp + Embedded agent: . An Embedded agent: line beside the spine's Profile: fires the embedded-agent module (shared/agentic-profile.md § The embedded-agent module): the agentic Category: set applies to that capability's ADRs only (memory · model-binding · durability · isolation · observability — no topology), and the capability's distributional REQs get the eval-suite VC row exactly as under agent-system. Everything else keeps the webapp column — screens, classic ADRs, deterministic oracles. A spine carrying that line is not plain CRUD; missing the module is a routing miss, not a judgment call.

Data modules. Read the spine's Data: line (registry: shared/agentic-profile.md). init always walks references/data-architecture.md §1; a declared retrieval(…) / grounded-writes(…) / memory value activates its module (§2/§3/§4 — the need-gate applies; the resulting ADR cites the fired trigger). A pick in a §5 volatile class is proposed as a Verify-live row (the tech-mandate flow). Under agent-system, memory and grounded-writes are presumptive.

The flow — two modes, each with one gate; Reconcile folded into the gate

Craft lives in the references — load each as its phase begins.

Mode init → system.md + ADR-001 + the ADR index

1. READ UPSTREAM — architecture-constraints.md, specification.md (Constitution + REQ registry), the spine's

capabilities/.md, docs/planning/sprints/sprint-01.md.

1. SYSTEM SHAPE — system.md on the arc42 subset (Constraints · Context/Scope = C4 L1 · Solution

Strategy · Building Blocks = C4 L2 + strategic-DDD bounded-context map · §8 Crosscutting Concepts + the banned-list · §9 → the ADR index · §10 measurable quality scenarios — each naming an executable fitness function (or deferred:) · § Test Strategy (declared shape + flake policy) · § Threats considered (the Four Questions over the C4 trust boundaries) · §11 Risks/Deferred). Mermaid C4 canonical, ASCII fallback. references/system-architecture.md · templates/system.md.

1. ADR-001 (tech stack) — MADR 4.0 + Binds/Prevents/Rule + Satisfies. Write the adr/README.md index (the

allocation source). templates/adr.md · templates/adr-README.md.

1. ⟫ RECONCILE ⟪ (dual pass) against architecture-constraints.md; emit amendment-log.json rows.

>>> GATE (init): present the system shape + ADR-001 AND the batched Tier-2 amendments (incl. any tech-mandate constraint↔ADR pairs); wait for PROCEED / ADJUST / a decision on each amendment before writing is final. .md` + new ADRs

1. READ UPSTREAM — sprint-NN.md (which REQs), the 02 design contract (approved/sprint-NN/manifest.md),

system.md. Resolve the Design-Contract STOP (manifest missing but docs/design/ exists → ask, don't assume; references/feature-spec.md).

1. DRIFT CHECK (local) — domain model vs src/ (skip sprint 1). Findings are a local reconcile (correct

system.md) — never a spine amendment.

1. FEATURE SPECS — one specs/.md per feature: API / data-model / components / order + the

Verification Contract (mechanically-gradeable rows) + Design Contract Coverage (which DM-IDs it implements). Reference REQs by ID. references/feature-spec.md · templates/feature-spec.md.

1. COVERAGE CHECK — every in-scope REQ → ≥1 spec / VC row; every manifest DM-ID → a covering spec (forward

direction). Orphans / uncovered DM-IDs are findings.

1. ⟫ RECONCILE ⟪ (dual pass) + new ADRs as needed.

>>> GATE (sprint): present the specs + the coverage table + the batched Tier-2 amendments; wait for PROCEED / ADJUST / a decision on each. On approval, the feature specs are the build contract 04 consumes. >> GATE: present shape/specs + coverage + batched Tier-2 amendments; wait for PROCEED / ADJUST / decisions .md · docs/planning/sprints/sprint-NN.md · docs/design/approved/sprint-NN/manifest.md + design-system.md (sprint N) · src/ (sprint N>1, local drift only). **Writes:** docs/architecture/system.md · docs/architecture/adr/ADR-NNN.md · docs/architecture/adr/README.md · docs/architecture/specs/.md · **appends** docs/spec/amendment-log.json · **amends** (Tier-2 only) docs/spec/architecture-constraints.md. **Never** writes docs/spec/capabilities/`.

References (load when the phase needs them)

• references/system-architecture.md — init craft: arc42 subset + C4 (Mermaid/ASCII) + strategic DDD +

lean-invariants + §8 crosscutting + the banned-list + §10 measurable quality scenarios + the breadth rubric.

• references/feature-spec.md — sprint N craft: API/data/components + the mechanically-gradeable Verification

Contract + forward DM-coverage + the Design-Contract STOP + the local drift check.

• references/reconcile-architecture.md — MADR 4.0 ADRs + the dual-pass Reconcile: Pass 1 deterministic

(token-in-named-field + structural lint) ‖ Pass 2 judgment (the 11 review heuristics + ATAM severity + the anchoring rule) + tier classification + the tech-mandate flow.

• references/data-architecture.md — the data craft: §1 datastore selection (always, init) + the

Data:-gated modules (§2 retrieval · §3 grounding · §4 memory) + §5 volatile-class use-time research. The spine's Data: line routes it (shared/agentic-profile.md).

• shared/agentic-profile.md — the per-seat toggle table + the embedded-agent module + the eval-suite contract +

the bite rule; repo-root-relative.

• shared/live-source-verification.md — an ADR naming a spine-declared verify-live tech cites its

docs/verification/.md record (the tech-mandate flow's live-source arm; graded S18); repo-root-relative.

• shared/subagent-protocol.md — the reconciler spawn contract (your subagent debut); repo-root-relative.
• shared/spec-amendment-protocol.md — amendment tiers + the row schema; repo-root-relative.
• shared/spine-boundary.md — declaration vs realization (the keystone); repo-root-relative.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: IncommensurableHubris
• Source: IncommensurableHubris/fullstack-director
• License: MIT

Install and usage instructions live in the source repository linked above.