What problem does it solve? Turning approved requirements into a sound system architecture is error-prone: designs often ignore how the codebase actually works, miss failure paths, or skip requirements traceability. This Skill produces a grounded high-level design (HLD) document that is critiqued against the real code before it is finalized. ## Core Features & Use Cases - Architecture Generation: Produces a design-hld.md covering architecture, system flows, change surface, requirements traceability, and a component summary, following a strict template. - Code-Grounded Critique Loop: Runs an architect critique dialogue that diffs the proposed design against actual codebase behavior, covering contracts, blast radius, consistency, and failure paths. - Discovery & Research Logging: Classifies the change (new feature, extension, simple addition) and persists findings, codebase grounding evidence, and assumptions to research.md. - Use Case: After approving requirements for a notifications feature, run the Skill to get an HLD that maps every requirement to components, flags risky integration points, and records design decisions for the downstream low-level design phase. ## Quick Start Ask the AI to generate the high-level design for your feature by running the kiro-spec-design-hld skill with your feature name after its requirements are approved.
