kiro-spec-design

Translate product requirements into boundary-first technical design documents.

Updated Apr 16, 2026
One-click install
npx skills add https://github.com/manatago/gion --skill kiro-spec-design-manatago
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kiro-spec-design
Source: https://github.com/manatago/gion/tree/main/.claude/skills/kiro-spec-design
Command: npx skills add https://github.com/manatago/gion --skill kiro-spec-design-manatago

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts high-level product requirements and research into a concrete, implementable technical design that explicitly maps requirements to components, interfaces, file plans, and tests while enforcing boundary-first principles and type-safety constraints.

Core Features & Use Cases

  • Boundary-first architecture: Defines ownership, allowed dependencies, and out-of-boundary items before detailing components.
  • Discovery-driven synthesis: Executes full or light discovery (research, code analysis, external dependency checks) and records findings in a research log.
  • Design deliverables: Produces a draft design, review gate checks, final design.md, research.md, and updates spec metadata for downstream task generation.
  • Use Case: Ideal for turning an approved feature spec into a reviewable design for engineering tasks, including complex integrations or greenfield features requiring external research.

Quick Start

Use kiro-spec-design to generate a boundary-first technical design draft and research log for feature "payments".

Frequently Asked Questions about kiro-spec-design

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

FAQPage Schema
How do I translate product requirements into a technical design document?

To translate product requirements into a technical design document, this Skill synthesizes high-level feature specs and research into component contracts, file structure plans, and testing strategies. It enforces boundary-first principles to explicitly map requirements to interfaces.

What is boundary-first architecture and how does it help feature design?

Boundary-first architecture defines module ownership, allowed dependencies, and out-of-boundary items before detailing internal components. This approach prevents scope creep and coupling issues by establishing strict architectural constraints early in the technical design process.

How do I map engineering requirements to component contracts and file structure plans?

Mapping engineering requirements to component contracts is achieved by executing discovery-driven synthesis on your codebase. The process records research findings in a log and produces a final design document with traceable connections between requirements, interfaces, and test strategies.

Can I use this approach for complex integrations and greenfield features?

Yes, this approach suits complex integrations and greenfield features by performing full or light discovery including code analysis and external dependency checks. It records these findings in a research log to inform the final technical design and review gate checks.

How do I enforce type safety constraints in a technical design?

Type safety constraints are enforced during the technical design generation by explicitly defining component contracts and interface boundaries. The resulting design document and updated spec metadata ensure that downstream engineering tasks adhere to these strict type requirements.

What is the best way to generate traceable specs for downstream task generation?

The best way to generate traceable specs is to produce a final design document alongside a research log and updated spec metadata. This ensures every component contract and file structure plan maintains traceability back to the original product requirements for downstream tasks.