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.