---
slug: "kiro"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/jasonkneen/kiro@main/README.md"
repo: "https://github.com/jasonkneen/kiro"
source_file: "README.md"
branch: "main"
---
# Spec-Driven Development Guide

[![Run in Smithery](https://smithery.ai/badge/skills/jasonkneen)](https://smithery.ai/skills?ns=jasonkneen&utm_source=github&utm_medium=badge)


A comprehensive guide to systematic feature development using the three-phase spec process: Requirements → Design → Tasks.

<!-- Navigation Metadata -->
<!-- Keywords: spec-driven development, requirements engineering, system design, implementation planning, AI collaboration -->
<!-- Topics: methodology, process, templates, examples, best practices -->
<!-- Audience: developers, project managers, technical leads -->

## Used by

- [@kazini](https://github.com/kazini) in their spec kit https://github.com/kazini/yask-spec-kit
- Amazon in internal presentations: _"It’s the best stuff I have found on [spec driven development]. I will be sharing links back to your repo with full attribution."_

## 🧭 Navigation Guide

**New to spec-driven development?** → Start with [Methodology Overview](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/methodology/README.md)  
**Ready to create your first spec?** → Jump to [Process Guide](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/process/README.md)  
**Looking for examples?** → Browse [Examples & Case Studies](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/examples/README.md)  
**Need templates?** → Get [Ready-to-Use Templates](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/templates/README.md)  
**Working with AI?** → Learn [Prompting Strategies](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/prompting/README.md)

**📍 Need detailed navigation?** → See [Complete Navigation Index](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/NAVIGATION.md) - Find content by role, problem, or learning style

---

## 📚 Complete Table of Contents

### 🎯 [Methodology](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/methodology/README.md)
Learn the foundational concepts and philosophy behind spec-driven development
- [Overview](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/methodology/overview.md) - Core concepts and benefits
- [Philosophy](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/methodology/philosophy.md) - Why spec-driven development works
- [When to Use](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/methodology/when-to-use.md) - Decision framework and scenarios

### 📋 [Process Guide](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/process/README.md)
Step-by-step walkthrough of the three-phase workflow
- [Requirements Phase](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/process/requirements-phase.md) - Gathering and structuring requirements using EARS
- [Design Phase](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/process/design-phase.md) - Creating comprehensive design documents
- [Tasks Phase](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/process/tasks-phase.md) - Breaking down design into actionable coding tasks
- [Workflow Diagrams](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/process/workflow-diagrams.md) - Visual process flows and decision points

### 🧠 [AI Reasoning](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/ai-reasoning/README.md)
Insights into decision-making frameworks and thought processes
- [Decision Frameworks](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/ai-reasoning/decision-frameworks.md) - How choices are evaluated
- [Thought Processes](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/ai-reasoning/thought-processes.md) - Analysis and prioritization methods
- [Examples](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/ai-reasoning/examples.md) - Real reasoning chains and decision points

### 💬 [Prompting Strategies](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/prompting/README.md)
Effective communication techniques for AI collaboration
- [Strategies](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/prompting/strategies.md) - Core prompting approaches
- [Templates](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/prompting/templates.md) - Ready-to-use prompt patterns
- [Best Practices](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/prompting/best-practices.md) - Tips for clear, effective communication

### ⚡ [Execution Guide](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/execution/README.md)
Practical guidance for implementing features from specs
- [Implementation Guide](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/execution/implementation-guide.md) - Step-by-step execution strategies
- [Quality Assurance](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/execution/quality-assurance.md) - Testing and validation techniques
- [Troubleshooting](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/execution/troubleshooting.md) - Common issues and solutions

### 📚 [Resources](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/resources/README.md)
Curated references and learning materials
- [Standards](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/resources/standards.md) - EARS and industry standards
- [Tools](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/resources/tools.md) - Recommended tools and integrations
- [Further Reading](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/resources/further-reading.md) - Additional learning resources

### 📖 [Examples](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/examples/README.md)
Real-world case studies and complete spec examples
- [Simple Feature Specs](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/examples/simple-feature-spec.md) - Basic feature examples
- [Complex System Specs](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/examples/complex-system-spec.md) - Large system examples
- [Case Studies](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/examples/case-studies.md) - Success stories and lessons learned
- [Troubleshooting & Pitfalls](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/examples/troubleshooting-pitfalls.md) - Common mistakes and recovery strategies

### 📝 [Templates](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/templates/README.md)
Ready-to-use templates and checklists
- [Requirements Template](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/templates/requirements-template.md) - EARS-formatted requirements
- [Design Template](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/templates/design-template.md) - Comprehensive design structure
- [Tasks Template](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/templates/tasks-template.md) - Implementation planning format

---

## Quick Start

New to spec-driven development? Start here:

1. **Understand the Methodology** - Read the [Overview](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/methodology/overview.md) to grasp core concepts
2. **See It in Action** - Review a [Simple Feature Spec](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/examples/simple-feature-spec.md) example
3. **Try It Yourself** - Use the [Requirements Template](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/templates/requirements-template.md) for your first spec
4. **Get Better Results** - Apply [Prompting Strategies](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/prompting/strategies.md) for AI collaboration

## Navigation Tips

- 📋 **Process sections** provide step-by-step instructions
- 🧠 **AI Reasoning sections** explain the "why" behind decisions  
- 💬 **Prompting sections** help you communicate effectively with AI
- 📖 **Examples** show complete, real-world applications
- 📝 **Templates** give you ready-to-use starting points

---

## 🔗 Cross-References & Related Content

### By Workflow Phase
- **Planning Phase**: [Methodology](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/methodology/README.md) → [Requirements](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/process/requirements-phase.md) → [Design](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/process/design-phase.md) → [Tasks](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/process/tasks-phase.md)
- **Execution Phase**: [Implementation Guide](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/execution/implementation-guide.md) → [Quality Assurance](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/execution/quality-assurance.md)
- **AI Collaboration**: [Prompting Strategies](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/prompting/README.md) → [AI Reasoning](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/ai-reasoning/README.md) → [Best Practices](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/prompting/best-practices.md)

### By Experience Level
- **Beginner**: [Methodology](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/methodology/README.md) → [Simple Examples](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/examples/simple-feature-spec.md) → [Templates](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/templates/README.md)
- **Intermediate**: [Process Guide](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/process/README.md) → [Prompting Strategies](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/prompting/README.md) → [Case Studies](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/examples/case-studies.md)
- **Advanced**: [AI Reasoning](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/ai-reasoning/README.md) → [Complex Examples](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/examples/complex-system-spec.md) → [Decision Frameworks](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/ai-reasoning/decision-frameworks.md)

### Quick Problem Solving
- **Unclear Requirements** → [Requirements Phase](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/process/requirements-phase.md) + [EARS Standards](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/resources/standards.md)
- **Design Challenges** → [Design Phase](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/process/design-phase.md) + [AI Decision Frameworks](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/ai-reasoning/decision-frameworks.md)
- **Implementation Issues** → [Implementation Guide](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/execution/implementation-guide.md) + [Troubleshooting](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/examples/troubleshooting-pitfalls.md)
- **AI Communication Problems** → [Prompting Best Practices](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/prompting/best-practices.md) + [Troubleshooting](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/examples/troubleshooting-pitfalls.md)

---

## 🔌 Kiro MCP Server

The Kiro MCP Server exposes Kiro's system prompts and instructions through the Model Context Protocol (MCP), allowing other AI assistants and tools to access Kiro's best practices.

### Features

- **Resources**: Access all Kiro system documentation files via MCP resources
- **Tools**: Query and retrieve specific system instructions programmatically
- **Prompts**: Pre-configured prompts for common Kiro workflows

### Quick Start

Install and configure the MCP server:

```bash
# Using uvx (recommended)
uvx kiro-mcp-server

# Or install with pip
pip install kiro-mcp-server
```

Add to your MCP client configuration (e.g., `~/.kiro/settings/mcp.json`):

```json
{
  "mcpServers": {
    "kiro-prompts": {
      "command": "uvx",
      "args": ["kiro-mcp-server"],
      "disabled": false
    }
  }
}
```

For more details, see the [MCP Server Documentation](https://github.com/jasonkneen/kiro/blob/HEAD/mcp-server/README.md).

---

## 🎯 Claude Code Plugin

Kiro is available as an installable Claude Code plugin with 7 skills following the [agentskills.io](https://agentskills.io) specification.

### Quick Install

```bash
# In Claude Code
/plugin marketplace add https://github.com/jasonkneen/kiro
/plugin install kiro-spec-driven@kiro-marketplace
```

### Available Skills

Once installed, Claude automatically uses these skills when relevant:

| Skill | Description | Use When |
|-------|-------------|----------|
| [spec-driven-development](https://github.com/jasonkneen/kiro/tree/HEAD/skills/spec-driven-development/) | Master methodology | "create a spec for..." |
| [requirements-engineering](https://github.com/jasonkneen/kiro/tree/HEAD/skills/requirements-engineering/) | EARS format | "write requirements for..." |
| [design-documentation](https://github.com/jasonkneen/kiro/tree/HEAD/skills/design-documentation/) | Technical architecture | "design the architecture..." |
| [task-breakdown](https://github.com/jasonkneen/kiro/tree/HEAD/skills/task-breakdown/) | Implementation planning | "break down into tasks..." |
| [ai-prompting](https://github.com/jasonkneen/kiro/tree/HEAD/skills/ai-prompting/) | AI communication | "how to prompt better..." |
| [quality-assurance](https://github.com/jasonkneen/kiro/tree/HEAD/skills/quality-assurance/) | Testing strategies | "testing strategy for..." |
| [troubleshooting](https://github.com/jasonkneen/kiro/tree/HEAD/skills/troubleshooting/) | Problem resolution | "debug this issue..." |
| [create-steering-documents](https://github.com/jasonkneen/kiro/tree/HEAD/skills/create-steering-documents/) | Project guidelines | "create steering documents..." |

### Installation Options

```bash
# User scope (available everywhere)
/plugin install kiro-spec-driven@kiro-marketplace

# Project scope (shared via git)
/plugin install kiro-spec-driven@kiro-marketplace --scope project
```

### Validate Skills

```bash
./scripts/validate-skills.sh
```

For more details, see the [Plugin Documentation](https://github.com/jasonkneen/kiro/blob/HEAD/PLUGIN.md) and [Skills Documentation](https://github.com/jasonkneen/kiro/blob/HEAD/skills/README.md).

---

*This guide is designed to be both a learning resource and a reference manual. Jump to any section based on your current needs, or read through sequentially for comprehensive understanding.*

**📍 For detailed navigation by role, problem, or learning style, see the [Complete Navigation Index](https://github.com/jasonkneen/kiro/blob/HEAD/spec-process-guide/NAVIGATION.md)**