spec-driven-system-architecturelisted

Produces the System Architecture Document and the constitutional context files for a project through a spec-driven workflow with structural anti-skip enforcement. This skill is the macro/constitutional architect phase: it consumes the Project Management plan, locks the technology stack, defines system boundaries and integration topology, and emits the immutable context files plus ADRs. Use when the user runs /create-system-architecture or after the PM (/ideate) phase completes. Do NOT use for per-epic technical design (use spec-driven-solution-architecture).
bankielewicz/DevForgeAI · ★ 4 · AI & Automation · score 66

Install: claude install-skill bankielewicz/DevForgeAI

# Spec-Driven System Architecture Translate the Project Management plan into the project **constitution** — the 6 immutable context files, their `.ai.md` companions, `test-plan.ai.yaml`, the architecturally significant ADRs — and a **System Architecture Document** describing system boundaries, integration topology, tech-stack rationale, system NFRs, and deployment architecture. Governed by **ADR-067**. This skill owns the **System Architect** role: the macro / constitutional phase of the modernized DevForgeAI pipeline. ``` /brainstorm (BA) → /ideate (PM) → /create-system-architecture (THIS SKILL) → /create-solution-architecture (per-epic technical design) ``` **Input contract:** `ideation-output.schema.json` v1.0 — the PM plan, carried in the YAML frontmatter of `devforgeai/specs/requirements/{project}-requirements.md`. **Output contract:** `system-architecture-output.schema.json` v1.0 — emitted as a self-contained HTML document with an embedded JSON data island (`<script type="application/json" id="system-architecture-data">`). **Context files are THE LAW.** If ambiguous or conflicts detected: HALT and use AskUserQuestion. --- ## Execution Model See **`.claude/rules/core/anti-skip-behavior.md`** for the canonical execution contract (expand inline; do not wait passively or offer execution options; honor every step of every phase; Self-Check violation taxonomy; Token- Optimization-Bias prohibition; governed by ADR-076). After invocation, execute Phase 00 Initializati