{
  "markdown": "# Spec-Driven Development Guide\n\n[![Run in Smithery](https://smithery.ai/badge/skills/jasonkneen)](https://smithery.ai/skills?ns=jasonkneen&utm_source=github&utm_medium=badge)\n\n\nA comprehensive guide to systematic feature development using the three-phase spec process: Requirements → Design → Tasks.\n\n<!-- Navigation Metadata -->\n<!-- Keywords: spec-driven development, requirements engineering, system design, implementation planning, AI collaboration -->\n<!-- Topics: methodology, process, templates, examples, best practices -->\n<!-- Audience: developers, project managers, technical leads -->\n\n## Used by\n\n- [@kazini](https://github.com/kazini) in their spec kit https://github.com/kazini/yask-spec-kit\n- 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.\"_\n\n## 🧭 Navigation Guide\n\n**New to spec-driven development?** → Start with [Methodology Overview](spec-process-guide/methodology/README.md)  \n**Ready to create your first spec?** → Jump to [Process Guide](spec-process-guide/process/README.md)  \n**Looking for examples?** → Browse [Examples & Case Studies](spec-process-guide/examples/README.md)  \n**Need templates?** → Get [Ready-to-Use Templates](spec-process-guide/templates/README.md)  \n**Working with AI?** → Learn [Prompting Strategies](spec-process-guide/prompting/README.md)\n\n**📍 Need detailed navigation?** → See [Complete Navigation Index](spec-process-guide/NAVIGATION.md) - Find content by role, problem, or learning style\n\n---\n\n## 📚 Complete Table of Contents\n\n### 🎯 [Methodology](spec-process-guide/methodology/README.md)\nLearn the foundational concepts and philosophy behind spec-driven development\n- [Overview](spec-process-guide/methodology/overview.md) - Core concepts and benefits\n- [Philosophy](spec-process-guide/methodology/philosophy.md) - Why spec-driven development works\n- [When to Use](spec-process-guide/methodology/when-to-use.md) - Decision framework and scenarios\n\n### 📋 [Process Guide](spec-process-guide/process/README.md)\nStep-by-step walkthrough of the three-phase workflow\n- [Requirements Phase](spec-process-guide/process/requirements-phase.md) - Gathering and structuring requirements using EARS\n- [Design Phase](spec-process-guide/process/design-phase.md) - Creating comprehensive design documents\n- [Tasks Phase](spec-process-guide/process/tasks-phase.md) - Breaking down design into actionable coding tasks\n- [Workflow Diagrams](spec-process-guide/process/workflow-diagrams.md) - Visual process flows and decision points\n\n### 🧠 [AI Reasoning](spec-process-guide/ai-reasoning/README.md)\nInsights into decision-making frameworks and thought processes\n- [Decision Frameworks](spec-process-guide/ai-reasoning/decision-frameworks.md) - How choices are evaluated\n- [Thought Processes](spec-process-guide/ai-reasoning/thought-processes.md) - Analysis and prioritization methods\n- [Examples](spec-process-guide/ai-reasoning/examples.md) - Real reasoning chains and decision points\n\n### 💬 [Prompting Strategies](spec-process-guide/prompting/README.md)\nEffective communication techniques for AI collaboration\n- [Strategies](spec-process-guide/prompting/strategies.md) - Core prompting approaches\n- [Templates](spec-process-guide/prompting/templates.md) - Ready-to-use prompt patterns\n- [Best Practices](spec-process-guide/prompting/best-practices.md) - Tips for clear, effective communication\n\n### ⚡ [Execution Guide](spec-process-guide/execution/README.md)\nPractical guidance for implementing features from specs\n- [Implementation Guide](spec-process-guide/execution/implementation-guide.md) - Step-by-step execution strategies\n- [Quality Assurance](spec-process-guide/execution/quality-assurance.md) - Testing and validation techniques\n- [Troubleshooting](spec-process-guide/execution/troubleshooting.md) - Common issues and solutions\n\n### 📚 [Resources](spec-process-guide/resources/README.md)\nCurated references and learning materials\n- [Standards](spec-process-guide/resources/standards.md) - EARS and industry standards\n- [Tools](spec-process-guide/resources/tools.md) - Recommended tools and integrations\n- [Further Reading](spec-process-guide/resources/further-reading.md) - Additional learning resources\n\n### 📖 [Examples](spec-process-guide/examples/README.md)\nReal-world case studies and complete spec examples\n- [Simple Feature Specs](spec-process-guide/examples/simple-feature-spec.md) - Basic feature examples\n- [Complex System Specs](spec-process-guide/examples/complex-system-spec.md) - Large system examples\n- [Case Studies](spec-process-guide/examples/case-studies.md) - Success stories and lessons learned\n- [Troubleshooting & Pitfalls](spec-process-guide/examples/troubleshooting-pitfalls.md) - Common mistakes and recovery strategies\n\n### 📝 [Templates](spec-process-guide/templates/README.md)\nReady-to-use templates and checklists\n- [Requirements Template](spec-process-guide/templates/requirements-template.md) - EARS-formatted requirements\n- [Design Template](spec-process-guide/templates/design-template.md) - Comprehensive design structure\n- [Tasks Template](spec-process-guide/templates/tasks-template.md) - Implementation planning format\n\n---\n\n## Quick Start\n\nNew to spec-driven development? Start here:\n\n1. **Understand the Methodology** - Read the [Overview](spec-process-guide/methodology/overview.md) to grasp core concepts\n2. **See It in Action** - Review a [Simple Feature Spec](spec-process-guide/examples/simple-feature-spec.md) example\n3. **Try It Yourself** - Use the [Requirements Template](spec-process-guide/templates/requirements-template.md) for your first spec\n4. **Get Better Results** - Apply [Prompting Strategies](spec-process-guide/prompting/strategies.md) for AI collaboration\n\n## Navigation Tips\n\n- 📋 **Process sections** provide step-by-step instructions\n- 🧠 **AI Reasoning sections** explain the \"why\" behind decisions  \n- 💬 **Prompting sections** help you communicate effectively with AI\n- 📖 **Examples** show complete, real-world applications\n- 📝 **Templates** give you ready-to-use starting points\n\n---\n\n## 🔗 Cross-References & Related Content\n\n### By Workflow Phase\n- **Planning Phase**: [Methodology](spec-process-guide/methodology/README.md) → [Requirements](spec-process-guide/process/requirements-phase.md) → [Design](spec-process-guide/process/design-phase.md) → [Tasks](spec-process-guide/process/tasks-phase.md)\n- **Execution Phase**: [Implementation Guide](spec-process-guide/execution/implementation-guide.md) → [Quality Assurance](spec-process-guide/execution/quality-assurance.md)\n- **AI Collaboration**: [Prompting Strategies](spec-process-guide/prompting/README.md) → [AI Reasoning](spec-process-guide/ai-reasoning/README.md) → [Best Practices](spec-process-guide/prompting/best-practices.md)\n\n### By Experience Level\n- **Beginner**: [Methodology](spec-process-guide/methodology/README.md) → [Simple Examples](spec-process-guide/examples/simple-feature-spec.md) → [Templates](spec-process-guide/templates/README.md)\n- **Intermediate**: [Process Guide](spec-process-guide/process/README.md) → [Prompting Strategies](spec-process-guide/prompting/README.md) → [Case Studies](spec-process-guide/examples/case-studies.md)\n- **Advanced**: [AI Reasoning](spec-process-guide/ai-reasoning/README.md) → [Complex Examples](spec-process-guide/examples/complex-system-spec.md) → [Decision Frameworks](spec-process-guide/ai-reasoning/decision-frameworks.md)\n\n### Quick Problem Solving\n- **Unclear Requirements** → [Requirements Phase](spec-process-guide/process/requirements-phase.md) + [EARS Standards](spec-process-guide/resources/standards.md)\n- **Design Challenges** → [Design Phase](spec-process-guide/process/design-phase.md) + [AI Decision Frameworks](spec-process-guide/ai-reasoning/decision-frameworks.md)\n- **Implementation Issues** → [Implementation Guide](spec-process-guide/execution/implementation-guide.md) + [Troubleshooting](spec-process-guide/examples/troubleshooting-pitfalls.md)\n- **AI Communication Problems** → [Prompting Best Practices](spec-process-guide/prompting/best-practices.md) + [Troubleshooting](spec-process-guide/examples/troubleshooting-pitfalls.md)\n\n---\n\n## 🔌 Kiro MCP Server\n\nThe 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.\n\n### Features\n\n- **Resources**: Access all Kiro system documentation files via MCP resources\n- **Tools**: Query and retrieve specific system instructions programmatically\n- **Prompts**: Pre-configured prompts for common Kiro workflows\n\n### Quick Start\n\nInstall and configure the MCP server:\n\n```bash\n# Using uvx (recommended)\nuvx kiro-mcp-server\n\n# Or install with pip\npip install kiro-mcp-server\n```\n\nAdd to your MCP client configuration (e.g., `~/.kiro/settings/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"kiro-prompts\": {\n      \"command\": \"uvx\",\n      \"args\": [\"kiro-mcp-server\"],\n      \"disabled\": false\n    }\n  }\n}\n```\n\nFor more details, see the [MCP Server Documentation](mcp-server/README.md).\n\n---\n\n## 🎯 Claude Code Plugin\n\nKiro is available as an installable Claude Code plugin with 7 skills following the [agentskills.io](https://agentskills.io) specification.\n\n### Quick Install\n\n```bash\n# In Claude Code\n/plugin marketplace add https://github.com/jasonkneen/kiro\n/plugin install kiro-spec-driven@kiro-marketplace\n```\n\n### Available Skills\n\nOnce installed, Claude automatically uses these skills when relevant:\n\n| Skill | Description | Use When |\n|-------|-------------|----------|\n| [spec-driven-development](skills/spec-driven-development/) | Master methodology | \"create a spec for...\" |\n| [requirements-engineering](skills/requirements-engineering/) | EARS format | \"write requirements for...\" |\n| [design-documentation](skills/design-documentation/) | Technical architecture | \"design the architecture...\" |\n| [task-breakdown](skills/task-breakdown/) | Implementation planning | \"break down into tasks...\" |\n| [ai-prompting](skills/ai-prompting/) | AI communication | \"how to prompt better...\" |\n| [quality-assurance](skills/quality-assurance/) | Testing strategies | \"testing strategy for...\" |\n| [troubleshooting](skills/troubleshooting/) | Problem resolution | \"debug this issue...\" |\n| [create-steering-documents](skills/create-steering-documents/) | Project guidelines | \"create steering documents...\" |\n\n### Installation Options\n\n```bash\n# User scope (available everywhere)\n/plugin install kiro-spec-driven@kiro-marketplace\n\n# Project scope (shared via git)\n/plugin install kiro-spec-driven@kiro-marketplace --scope project\n```\n\n### Validate Skills\n\n```bash\n./scripts/validate-skills.sh\n```\n\nFor more details, see the [Plugin Documentation](PLUGIN.md) and [Skills Documentation](skills/README.md).\n\n---\n\n*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.*\n\n**📍 For detailed navigation by role, problem, or learning style, see the [Complete Navigation Index](spec-process-guide/NAVIGATION.md)**\n",
  "bytes": 11177,
  "sha": "1d377cd9854ec26a9403db6c9afb679fdf2c7a3d071dada6e92da37792cd15f8",
  "repo_slug": "jasonkneen/kiro",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_jasonkneen_kiro_skills_ai_prompting_main_0719fea6/readme"
}