kiro-spec-design

Generate technical design documents translating approved requirements into architecture and component boundaries.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/scapia-oss/compass --skill kiro-spec-design-scapia-oss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kiro-spec-design
Source: https://github.com/scapia-oss/compass/tree/main/tools/cc-sdd/templates/agents/claude-code-skills/skills/kiro-spec-design
Command: npx skills add https://github.com/scapia-oss/compass --skill kiro-spec-design-scapia-oss

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Turning approved requirements into a concrete, reviewable technical design is slow and error-prone, especially when the design must align with existing codebase patterns, steering context, and project memory. This Skill automates that translation, producing a design.md with explicit boundaries, file structure plans, and traceability back to requirements. ## Core Features & Use Cases - Discovery-driven design: Classifies the feature (greenfield, extension, simple addition, complex integration) and runs full, light, or minimal discovery, including web research and codebase analysis via subagents. - Boundary-first design documents: Generates design.md with explicit ownership boundaries, file structure plans, testing strategy, and requirement traceability IDs. - Review gate and learning capture: Runs a bounded design review gate before finalizing, and records directional user feedback as durable decisions and learnings in the spec directory. - Use Case: After approving requirements for a notifications feature, run the design phase to produce an architecture document with component interfaces, integration points, and a file-by-file implementation plan ready for task generation. ## Quick Start Ask the agent to generate the technical design for a feature whose requirements are already approved, for example by running the kiro-spec-design command with the feature name.

Frequently Asked Questions about kiro-spec-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a technical design from requirements in a spec-driven workflow?

Run the design phase after requirements are approved. The skill loads spec.json, requirements.md, and steering context, runs discovery matched to feature complexity, then writes design.md with boundaries, file structure plans, and a testing strategy.

What happens if requirements are not approved before design generation?

Execution stops with a message that approval is required. You can review and approve the requirements first, or pass the -y flag to auto-approve the requirements gate, which is recommended only for low-risk specs.

Does the design skill work for bugfix specs?

No. When spec_type is bugfix, the design phase is skipped entirely and the workflow routes directly to task generation. Split HLD/LLD specs are also redirected to their dedicated design commands.

How does the skill handle discovery for complex features?

It classifies the feature type and runs full discovery for new or complex features, including web research on patterns, dependencies, and APIs, plus parallel subagent research. Extensions get lighter integration-focused discovery, and simple additions skip formal discovery.

Why does design generation stop during the review gate?

The review gate stops when it finds a real requirements gap or ambiguity rather than papering over it in design.md. You must clarify or fix requirements.md and re-run the design command before the document is finalized.