Documentation
Everything you need to install, run, and extend Atomic Spec.
10 guides covering installation, the four-phase assembly line, the Eight Prime Directives, and how to contribute back to the framework. Start with Installation if you're new, or jump straight to Quick Start if you've already got the CLI.
Getting Started 3 docs
-
Installation
Install the Atomic Spec CLI from PyPI or run the local init scripts to drop the framework into a new or existing project.
Read -
Quick Start
Bootstrap a project with Atomic Spec in six steps — from constitution to implementation, all driven by slash commands inside your AI agent.
Read -
Upgrade Guide
Refresh the Atomic Spec CLI and pull the latest framework files into existing projects without losing customizations.
Read
Guides 2 docs
-
Platform-Aware Verification Commands
How the task generator picks platform-correct verification commands for every atomic task — registry-driven, with fallbacks, no more `npm test` on iOS.
Read -
Verification Fallback Logic
Three-tier fallback strategy that keeps every atomic task verifiable — primary, alternative, language-native — and a manual checklist when nothing else works.
Read
Concepts 2 docs
-
The Atomic Traceability Model
The governance philosophy that turns Spec-Driven Development into something AI agents cannot quietly subvert — Eight Prime Directives, Knowledge Stations, and Context Pinning, explained.
Read -
The Eight Prime Directives
Article IX of the Atomic Spec constitution — the eight non-negotiable rules that turn AI agents from drift-prone collaborators into a governed assembly line.
Read
Community 3 docs
-
Local Development
Iterate on the Atomic Spec CLI locally — module entrypoints, editable installs, uvx from a working tree, and a rapid edit loop reference.
Read -
Contributing
How to propose changes to Atomic Spec — local development setup, testing template changes against a throwaway project, and the AI-disclosure rules for pull requests.
Read -
Support
How to file issues, request a new AI agent, and recover from failed releases — plus Atomic Spec's two-tier agent support policy.
Read
Spotted something out of date? Open a PR against the source MDX — the site rebuilds on merge.