Spec Kit is a toolkit for spec-driven development. At its core, it is a coordinated set of prompts, templates, scripts, and CLI/integration assets that define and deliver a spec-driven workflow for AI coding agents. This document is a starting point for people modifying Spec Kit itself, with a compact orientation to the key project documents and repository organization.
Essential project documents:
| Document | Role |
|---|---|
| README.md | Primary user-facing overview of Spec Kit and its workflow. |
| DEVELOPMENT.md | This document. |
| spec-driven.md | End-to-end explanation of the Spec-Driven Development workflow supported by Spec Kit. |
| RELEASE-PROCESS.md | Release workflow, versioning rules, and changelog generation process. |
| docs/index.md | Entry point to the docs/ documentation set. |
| CONTRIBUTING.md | Contribution process, review expectations, and required development practices. |
| TESTING.md | Validation strategy and testing procedures. |
Main repository components:
| Directory | Role |
|---|---|
templates/ |
Prompt assets and templates that define the core workflow behavior and generated artifacts. |
scripts/ |
Supporting scripts used by the workflow, setup, and repository tooling. |
src/specify_cli/ |
Python source for the specify CLI, including agent-specific assets. |
extensions/ |
Extension-related docs, catalogs, and supporting assets. |
presets/ |
Preset-related docs, catalogs, and supporting assets. |