Kiro: Spec-Driven Development Workflow Skill

Kiro: Spec-Driven Development Workflow

Transform ideas into comprehensive specifications, design documents, and actionable implementation plans.

When to use

Use this skill when you want a Kiro-style spec pack under .kiro/specs/:

requirements with EARS acceptance criteria,
a design doc with architecture + correctness properties,
an executable tasks checklist.

Workflow

Requirements → Define what to build (EARS format) → Details
Design → How to build it (architecture + correctness properties) → Details
Tasks → Actionable implementation steps → Details
Execute → Implement one task at a time → Details

Storage: .kiro/specs/{feature-name}/ (kebab-case)

Core Rules

Sequential phases — Never skip phases
Explicit approval — Get user approval after each document
One task at a time — During execution, focus on single task
Correctness mandatory — Every design MUST include properties from EARS

Quick Reference

EARS Acceptance Criteria Format

WHEN [event] THEN THE [system] SHALL [response]
IF [condition] THEN THE [system] SHALL [response]
WHILE [state] THE [system] SHALL [response]

Correctness Property Format

### Property N: [Name]

_For any_ [inputs], [precondition], [system] SHALL [behavior].

**Validates: Requirement X.Y**

Phase Outputs

| Phase | Output File | Key Content | | ------------ | ----------------- | -------------------------------------- | | Requirements | requirements.md | User stories + EARS ACs | | Design | design.md | Architecture + Interfaces + Properties | | Tasks | tasks.md | Checkbox task list |

Workflow Diagram

stateDiagram-v2
  [*] --> Requirements

  Requirements --> ReviewReq : Complete
  ReviewReq --> Requirements : Changes
  ReviewReq --> Design : Approved

  Design --> ReviewDesign : Complete
  ReviewDesign --> Design : Changes
  ReviewDesign --> Tasks : Approved

  Tasks --> ReviewTasks : Complete
  ReviewTasks --> Tasks : Changes
  ReviewTasks --> [*] : Approved

  Execute : Execute Single Task
  [*] --> Execute : Task Request
  Execute --> [*] : Complete

Detection Logic

Determine current state by checking:

# Check for .kiro directory
if [ -d ".kiro/specs" ]; then
  # List features
  ls .kiro/specs/

  # For specific feature, check phase
  FEATURE="$1"
  if [ -f ".kiro/specs/$FEATURE/requirements.md" ]; then
    echo "Requirements exists"
  fi
  if [ -f ".kiro/specs/$FEATURE/design.md" ]; then
    echo "Design exists"
  fi
  if [ -f ".kiro/specs/$FEATURE/tasks.md" ]; then
    echo "Tasks exists - ready for execution"
  fi
fi

Summary

Kiro provides a structured, iterative approach to feature development:

Start with requirements (what to build)
Progress to design (how to build it)
Create tasks (implementation steps)
Execute tasks one at a time

Each phase requires explicit user approval before proceeding, ensuring alignment and quality throughout the development process.

Supporting Files

Kiro Identity — Response style
Workflow Diagrams — Visual references

Agent Skills: Kiro: Spec-Driven Development Workflow

Install this agent skill to your local

Skill Files