kiro-spec-design

Generate technical design documents from approved specification requirements.

Updated Jun 23, 2026
One-click install
npx skills add https://github.com/j5ik2o/marp-ai-base --skill kiro-spec-design-j5ik2o
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kiro-spec-design
Source: https://github.com/j5ik2o/marp-ai-base/tree/main/.agents/skills/kiro-spec-design
Command: npx skills add https://github.com/j5ik2o/marp-ai-base --skill kiro-spec-design-j5ik2o

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning approved requirements into a concrete, implementation-ready technical design is slow and error-prone, often producing vague component boundaries and untraceable requirement coverage. ## Core Features & Use Cases - Discovery-Driven Design: Classifies features as new, extension, or simple addition and runs full, light, or minimal research (including web research and codebase analysis) before designing. - Boundary-First Design Documents: Produces design.md with explicit ownership boundaries, component contracts, file structure plans, Mermaid diagrams, and requirement traceability. - Review Gate: Validates requirements coverage, architecture readiness, and executability with up to two repair passes before finalizing the design. - Use Case: After approving requirements for a new API feature, run the skill to research dependencies, synthesize architecture decisions into research.md, and generate a reviewed design.md ready for task generation. ## Quick Start Run the kiro-spec-design skill on my approved spec to generate the technical design document.

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 specification requirements?

Run the skill with the spec name after requirements are approved. It loads requirements.md and steering context, runs discovery research, synthesizes findings, and writes design.md only after the built-in review gate passes.

What happens if requirements are not approved before design generation?

Execution stops with a message that approval is required. You can pass the -y flag to auto-approve requirements in spec.json and proceed directly to design generation.

Does the design process differ for new features versus extensions?

Yes. New or complex features trigger full discovery with web research and architecture evaluation, extensions use light discovery focused on integration points, and simple additions skip formal discovery entirely.

Can the design document be written in Japanese or English?

Yes. The skill reads spec.json.language and selects the matching design and research templates for ja or en. Missing or unsupported languages stop execution with an error.

Why does design generation stop during the review gate?

The review gate stops when requirements are ambiguous, contradictory, or reveal a real spec gap that cannot be repaired locally. You must fix requirements.md and re-run rather than papering over the gap in design.md.