specs.md: One Framework, Three Flows
Choose Your Level of Ceremony: specs.md offers three flows from lightweight spec generation to full methodology. Pick the one that matches your project needs.
Three Flows Available
Simple
Quick specs without execution tracking
FIRE
Rapid execution with adaptive checkpoints
AI-DLC
Full methodology with DDD
Comparison Matrix
Quick Comparisons
vs GitHub Spec Kit
Lightweight toolkit vs full methodology. Learn when to choose each.
vs BMAD-Method
Both target complex projects. Compare phase-based vs role-based agents.
vs Kiro (AWS)
IDE-integrated vs IDE-agnostic. Compare automation approaches.
vs OpenSpec
Full lifecycle vs change-centric. Compare brownfield strategies.
Key Differentiators
1. AI-DLC is a Formal AWS Methodology
Unlike generic “spec-driven development,” AI-DLC is defined by AWS with specific phases, rituals, and artifacts. specs.md is a faithful implementation—not an interpretation.2. DDD as Default, Extensible via Bolt Types
Agile frameworks leave design techniques optional. AI-DLC integrates Domain-Driven Design as its default—AI applies DDD principles during decomposition, developers validate. Extensible: Use bolt types to add other methodologies like BDD, TDD, or model your own construction flow. DDD is the default, not a limitation.3. Bolts: Batched Stories with Full Traceability
Unlike other tools with variable iteration cycles, specs.md uses Bolts—planned batches of related stories executed together by an agent. Each Bolt follows DDD steps during execution, and artifacts created during construction provide full traceability of what was built and how.4. Reversed Conversation Direction
In AI-DLC, AI initiates and directs conversations. AI proposes breakdown, trade-offs, designs. Humans validate and approve. This is the opposite of most tools where humans prompt AI.5. Mob Rituals for Team Alignment
Mob Elaboration (Inception) and Mob Construction condense weeks of sequential work into hours while achieving deep alignment between team and AI.6. Built for Complex Systems
Vendor Lock-in
Cost Comparison
Roadmap
Start where you are: Use Simple for quick specs, FIRE for rapid execution, or AI-DLC for full methodology. No upgrade path required—each flow is designed for different needs.
Request a Feature
Have a feature request or feedback? Let us know what you’d like to see in specs.md.
Further Reading
The AI-Native SDLC: Reimagined
Why the Agentic Age demands a new methodology
What is AI-DLC?
Deep dive into AI-DLC methodology
