Skip to content

Document command routing and artifact ownership - #8

Merged
developzoneio merged 1 commit into
mainfrom
docs/architecture-routing-artifact-map
Jun 18, 2026
Merged

Document command routing and artifact ownership#8
developzoneio merged 1 commit into
mainfrom
docs/architecture-routing-artifact-map

Conversation

@developzoneio

Copy link
Copy Markdown
Owner

What

Routing (which command fans out to which agents) and artifact ownership (which phase/agent produces each .specs/<ID>/ file) were implicit across the command files — no consolidated view existed. This adds two reference sections to docs/architecture.md, no rewrites of existing content:

  1. Command -> agent routing (after the Agents section) — a per-command tree of the subagent fan-out, including the three file-ops commands (/sd:spec, /sd:setup, /sd:release) that invoke no subagent.
  2. Artifact ownership (within "Spec artifacts as durable memory") — a table mapping each spec file to its producing phase/agent and downstream readers, plus a note on the intentionally-empty cross-phase fields.

Scope

  • docs/architecture.md — additive only.
  • CHANGELOG.md — one ### Changed line under [Unreleased].

Item 4d of the command/agent discipline refinements backlog. Routing claims verified against the command files (feature.md, bug.md, refactor.md, perf.md, rca.md, explore.md, review.md).

Verification

bash scripts/validate.sh — all 6 checks pass.

🤖 Generated with Claude Code

@developzoneio
developzoneio force-pushed the docs/architecture-routing-artifact-map branch from 32eee08 to 3d05fa9 Compare June 18, 2026 03:29
@developzoneio
developzoneio merged commit a45abaf into main Jun 18, 2026
4 checks passed
@developzoneio
developzoneio deleted the docs/architecture-routing-artifact-map branch June 18, 2026 03:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant