kiro-spec-design

Translate product requirements into architecture-ready technical design specifications.

1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/taku-o/gitignore-merge --skill kiro-spec-design-taku-o
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kiro-spec-design
Source: https://github.com/taku-o/gitignore-merge/tree/main/.claude/skills/kiro-spec-design
Command: npx skills add https://github.com/taku-o/gitignore-merge --skill kiro-spec-design-taku-o

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill translates product and feature requirements (the WHAT) into a complete, implementable technical design (the HOW), ensuring requirement traceability, clear boundaries, and architecture-ready artifacts for engineering teams. It reduces ambiguity, enforces type-safety and review gates, and captures discovery rationale so designs are reviewable and actionable.

Core Features & Use Cases

  • Discovery workflows: Runs full, light, or minimal discovery processes, including external research, codebase analysis, and risk assessment, to inform architecture decisions.
  • Synthesis & Design Drafting: Applies boundary-first principles, produces File Structure Plans, component contracts, test strategies, and mermaid diagrams as needed.
  • Governance & Outputs: Enforces requirements traceability, review-gate checks, updates research.md, and writes .kiro/specs/{feature}/design.md once readiness is confirmed.
  • Use Cases: Creating architecture for a greenfield feature, designing an extension that integrates with existing services, or drafting a tight CRUD/UI addition with minimal discovery.

Quick Start

Run /kiro-spec-design <feature> to generate a draft design and update the research log after confirming the requirements are present and approved.

Frequently Asked Questions about kiro-spec-design

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

FAQPage Schema
How do I convert product requirements into a technical design with architecture-ready specifications?

To convert product requirements into a technical design, you need a process that defines boundaries, file structures, and component contracts. This ensures your feature specifications are implementable and maintain type-safety constraints for engineering teams.

What is requirements traceability in software architecture design?

Requirements traceability in software architecture design maps product requirements directly to technical implementation decisions. It ensures every architectural choice, boundary definition, and component contract satisfies a specific requirement and passes review-gate validation.

How do I generate technical specifications for a greenfield feature extension?

Generating technical specifications for a feature extension requires running discovery workflows, synthesizing codebase analysis, and drafting file structure plans. This produces an architecture-ready design document enforcing type-safety and boundary-first principles.

Can I run a minimal discovery process for a simple CRUD feature design?

Yes, you can run a minimal discovery process for a simple CRUD feature design. This lightweight approach performs basic codebase analysis and risk assessment to quickly generate component contracts and test strategies without extensive external research.

How do I ensure my technical design passes review-gate validation?

To ensure your technical design passes review-gate validation, apply boundary-first principles and verify requirements traceability. Confirm readiness by checking component contracts, test strategies, and type-safety constraints before finalizing the design document.

What's the best way to structure component contracts and test strategies for new features?

The best way to structure component contracts and test strategies is to synthesize discovery research and apply boundary-first principles. This approach captures discovery rationale, enforces type-safety, and ensures architecture-ready artifacts are reviewable.