What problem does it solve?
It produces a per-story high-level design (HLD) that keeps architecture consistent, prevents contract drift, and ensures each user story’s scope and integrations are explicitly traceable.
Core Features & Use Cases
- Per-story HLD delivery: Generates an HLD scoped to a single user story for Phase 3 (HLD work dispatched by the Planning Hub).
- Contract-gated integration design: Reads consumed contracts and designs integration realization (mock, interface-only, real, or realize) without redefining shared interfaces.
- Traceability and review-ready structure: Uses the HLD template and maps design units to story acceptance criteria for sparring review with the user.
- Correct output artifact: Writes the resulting document to plan/user-stories/US-NNN-name/hld.md.
Quick Start
Use the planning-hld skill to generate the HLD for story US-NNN-name by ensuring story.md, plan/system-architecture.md, consumed contracts in plan/contracts/, and the relevant plan/prd.md sections are present for context.