Spec Kitty

Spec Kitty documentation

Spec Kitty is for developers and teams who use AI coding agents (Claude Code, Cursor, Gemini CLI, and others) and want those agents to build the right thing, in the right order, without losing the plot halfway through. It gives your agent a clear spec, a plan, and a checklist to work from — instead of a loose prompt and a hope.

Get started Upgrade a project Open the API reference

New here? Get started walks you through installing Spec Kitty and running your first mission end to end — about 30 minutes, no prior Spec Kitty knowledge required.

Already using Spec Kitty? Head to Migrations if you're upgrading, Guides for task-oriented how-tos, or the API and CLI reference for exact command behavior.

What's new and roadmap

• Changelog — release history (canonical CHANGELOG.md).
• Release goals — declared intent of each release line (3.2.x, 3.3.x); each line's execution roadmap is linked from there and from Plans.

Browse by topic

Context Context Glossary narrative, audiences, and the Charter-era governance model. Core Concepts Core Concepts Context, terminology, and the doctrine layer that governs your agent. Doctrine Doctrine The layered artifacts — directives, tactics, profiles — that shape agent behavior. Architecture Architecture Unified, unversioned living design for the system. ADRs Decision records Architecture decision records by era (1.x, 2.x, 3.x). Plans Plans User journeys, investigations, and traces (distil-then-retire). API API and CLI reference Exact CLI, file, schema, and environment behavior. Reference Reference API, configuration, integrations, and security — exact behavior, no narrative. Configuration Configuration Configuration files, flags, and environment variables. Integrations Integrations AI harness and external-system integration. Security Security Security posture, credentials, and secrets handling. Guides Guides Task-oriented guides and guided learning workflows. Operations Operations Operational and developer-workflow guides, including recovery. Migrations Migrations Version migrations, upgrade paths, and shim rules. Changelog Changelog Release history. Release Goals Release goals Declared intent of each release line. Project Updates Project Updates Changelog, release goals, and mission run history.

Section index

Section	Landing page
Context	context/index.md
Core Concepts	core-concepts/index.md
Doctrine	doctrine/index.md
Architecture	architecture/index.md
ADRs	adr/index.md
Plans	plans/index.md
API	api/index.md
Reference	reference/index.md
Configuration	configuration/index.md
Integrations	integrations/index.md
Security	security/index.md
Guides	guides/index.md
Operations	operations/index.md
Migrations	migrations/index.md
Changelog	changelog/index.md
Release Goals	release-goals/index.md
Project Updates	updates/index.md

Migration and archive

Use Migrations when moving an existing project onto the current release. 1.x and 2.x docs are preserved as a historical archive and should not be used to start a new project.