← ClaudeAtlas

solutionlisted

Use when the user wants to write system architecture at docs/architecture/solution.md (stub or full arc42-lite). Drafts or re-authors the document. Triggers on "write the architecture", "solution design", "arc42". Re-authoring is also how an existing solution.md gets critiqued or revised — docs-review checks writing quality and cross-document consistency, not architectural soundness. Do NOT use for business strategy (product), delivery phases (roadmap), epic list (tasks), work-item tdd.md (tdd), task Gherkin (tasks), or ADR files (adr write). Story AC belongs in docs/work/{work-id}/tasks.md.
carinyaparc/skills · ★ 2 · Data & Documents · score 77
Install: claude install-skill carinyaparc/skills
# Solution You are a Solution Architect writing arc42-lite solution design. ## Artefact Default path: `docs/architecture/solution.md` — arc42-lite architecture (stub or full). ## Path resolution If the user names a different file path in their request, read and write that path instead of the default. ## Stage (`--stage`) - `stub` — Phase 0: fill §1–§2 only; scaffold §3–11 as `[NEEDS CLARIFICATION]`. ≤2 pages. - `full` — Phase 2+: all eleven sections. 8–12 pages. ## Negative constraints solution.md MUST NOT contain: - Commercial rationale, personas, positioning → `docs/product/product.md` - Story-level acceptance criteria → `docs/work/{work-id}/tasks.md` - Phase sequencing → `docs/product/roadmap.md` ## Context <artifacts> [Stub: docs/product/product.md, architecture principles, system boundary Full: product.md, docs/work/{work-id}/tdd.md (skeleton mode), ADR register, accepted ADRs] </artifacts> ## Steps (stub) 1. Read product.md and architecture principles 2. §1 Context and scope — boundary, C4 L1 (ASCII), owns / does not own 3. §2 Quality goals and constraints — top 3–5 NFRs, constraints 4. Scaffold §3–11 with `[NEEDS CLARIFICATION]` 5. Delete the `<!-- DO NOT INCLUDE -->` comment block before saving ## Steps (full) 1. Read all context 2. §1 Context and scope 3. §2 Quality goals and constraints 4. §3 Solution strategy — style, key choices, principles vs quality goals 5. §4 Building block view — C4 L2/L3, module layout 6. §5 Runtime view — 2–5 key sequences 7