github / spec-kit
git clone https://github.com/github/spec-kit.git
v1.2.2 · 2d ago
💫 Toolkit to help you get started with SDD or any other process!
+77
stars, 24h · #184
+~539
stars, 7 days · #229
+~2.3k
stars, 30 days · #234
142k
★ total · +0% this week
13k
forks · 178 open issues
Star history (as recorded here)
LanguagePython
LicenseMIT
Created2025-08-21 (1y ago)
Last push1d ago
Watchers718
OwnerOrganization
GitHub topics
Links
- GitHub: github.com/github/spec-kit
- Homepage: https://github.github.com/spec-kit/
- Releases · Issues · Hacker News mentions
README excerpt
🌱 Spec Kit Build with a spec, fix a bug, or assess an idea — with your coding agent. English · 简体中文 · 日本語 · 한국어 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. [code] After installing the Specify CLI and creating your proj