Status: Not Ready for Use This project is still being actively designed and iterated on. APIs, commands, and behavior may change significantly. Do not depend on it for production workflows.
Speck sandwiches requirements gathering and verification around the meat of product development.
speck is a Rust CLI for spec-driven development: transform requirements into verifiable task specs, then prove they're done with automated checks.
# Build
cargo build
# Configure API key (required for speck plan)
cp env.example.txt .env # then edit with your Anthropic API key
# Plan → Inspect → Validate
speck plan "your requirement here"
speck status
speck show
speck validate --allSee the Getting Started guide for full setup instructions.
| Command | Description |
|---|---|
speck plan |
Generate task specs from requirements via multi-pass LLM analysis |
speck validate |
Run verification checks against specs |
speck map |
Generate codebase structure maps and detect drift |
speck status |
List all specs with signal type and strategy |
speck show |
Inspect spec details |
speck deps |
Visualize dependency graph between specs |
speck sync |
Push specs to external issue trackers (beads/bd) |
| Document | Description |
|---|---|
| Overview | What Speck is, philosophy, and how features connect |
| Getting Started | Installation, configuration, and first run |
| CLI Reference | Full command documentation with all options |
| Planning | Multi-pass planning pipeline deep dive |
| Validation | Verification checks, strategies, and the feedback loop |
| Spec Format | TaskSpec YAML structure reference |
| Codebase Mapping | Map generation, caching, and drift detection |
| Sync | External tracker integration (beads/bd) |
| Architecture | Port/adapter design, project layout, request flow |
| Record/Replay | Cassette system for deterministic testing |
| Development | Building, testing, and contributing |
| Walkthrough | End-to-end tutorial: plan a calculator, file issues, validate |
git config core.hooksPath .githooks
cargo fmt --all -- --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test --all-targets --all-featuresSee Development for full details.