Skip to main content

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
Choose your flow →

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

AI-DLC explicitly targets systems with “continuous functional adaptability, high architectural complexity, numerous trade-offs management, scalability, integration and customization requirements.”Simpler projects → specs.md (Simple Flow).

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