spec-kit

🌱 Spec Kit <em>Build with a spec, fix a bug, or assess an idea — with your coding agent.</em>

<strong>English</strong> · 简体中文 · 日本語 · 한국어

Spec Kit is an open source toolkit that gives AI coding agents structured processes, reusable templates, and documented outcomes. Start with a ready-made process, customize it, or bring your own.

Choose your process

| What you need | Process | Outcome | | --- | --- | --- | | Build a feature or application | Spec-Driven Development | A specification carried through planning, implementation, and convergence | | Diagnose and repair broken behavior | Bug fixing | An assessed cause, scoped fix, and recorded verification | | Decide whether an idea deserves investment | Idea assessment | An evidence-backed go, clarify, or stop decision | | Adopt or create a different process | Your own process | A process adapted or assembled from reusable primitives |

These are independent entry points, not mandatory phases. SDD ships in core; bug fixing and assessment are bundled extensions you install when needed, and the primitives below let you adopt or create other processes.

Capabilities

Spec Kit combines ready-to-use processes with composable mechanisms:

| Capability | Spec Kit mechanism | | --- | --- | | Connect to or switch between coding agents | Integration | | Add a command, quality gate, or complete process | Extension | | Connect a process to an external tool or service | Extension | | React to coding-agent lifecycle events | Extension runtime event | | Run extension commands before or after Spec Kit commands | Extension hook | | Adapt templates, commands, terminology, or methodology | Preset | | Enforce organizational or regulatory standards | Preset | | Override a template for one project | Project-local override | | Automate prompts, commands, gates, and shell tasks | Workflow | | Modify an installed workflow without forking it | Workflow overlay | | Add reusable executable behavior to workflows | Workflow step | | Install a curated setup for a role or team | Bundle | | Discover community components | Catalog | | Host a private catalog of approved components | Catalog | | Access private catalogs and component downloads | Authentication | | Work offline or behind a firewall | Local sources and self-hosted catalogs | | Inspect which layer supplies a command, template, or script | Artifact inventory |

Search the active catalogs with commands such as specify extension search, specify preset search, specify workflow search, and specify bundle search. Spec Kit includes community catalogs, and organizations can add their own curated sources. Catalog listings are not audits or endorsements, so review community source code before installing or running it.

Get started

You need Python 3.11+, uv, and a supported AI coding agent on Linux, macOS, or Windows.

Run these commands in your terminal to install Spec Kit and create a project. This example uses GitHub Copilot.

uv tool install specify-cli
specify init my-project --integration copilot
cd my-project