What is specs.md?
specs.md is an AI-native development framework with pluggable flows for every use case. Choose the flow that matches your project needs:
Quick Start
Framework Architecture
specs.md is built as a pluggable framework where development methodologies are implemented as flows:
specs.md (Framework)
├── Core (Standards, Agents, State)
└── Flows/
├── simple/ ← Spec generation only
├── fire/ ← Rapid execution (0-2 checkpoints)
└── aidlc/ ← Full methodology with DDD
Key Features
Flow Comparison
| Aspect | Simple | FIRE | AI-DLC |
|---|---|---|---|
| Optimized For | Spec generation | Adaptive execution | Full traceability |
| Checkpoints | 3 (phase gates) | Adaptive (complexity + config) | Comprehensive |
| Agents | 1 | 3 | 4 |
| Execution Tracking | No | Yes | Yes |
| Design Docs | Basic | When complexity warrants | DDD or Simple bolt |
| Monorepo | No | First-class | Limited |
specs.md is IDE and AI-agnostic—you choose your tools, no vendor lock-in.
Get Started
Why specs.md?
Traditional development methods were built for human-driven, long-running processes. specs.md reimagines the development lifecycle with AI as a central collaborator:
- Choose your overhead: From no execution tracking (Simple) to full methodology (AI-DLC)
- Adaptive checkpoints: FIRE adapts oversight to complexity—skip ceremony for simple tasks
- Brownfield-first: FIRE auto-detects existing patterns and conventions
- Persistent context: AI can reference across sessions with structured artifacts
- Rapid cycles: Ship features in hours, not weeks