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

FlowCheckpointsOptimized For
Simple Flow3 (phase gates)Spec generation only, quick prototypes
FIRE FlowAdaptiveAdaptive execution, brownfield, monorepos
AI-DLC FlowComprehensiveFull traceability, regulated environments

Simple

Quick specs without execution tracking

FIRE

Rapid execution with adaptive checkpoints

AI-DLC

Full methodology with DDD
Choose your flow →

Comparison Matrix

Featurespecs.mdSpec KitBMADOpenSpecKiro
Target ComplexityComplex systemsSmall-mediumComplex/EnterpriseAny (brownfield-first)Any
TypeMethodology + FrameworkToolkit + Agent PromptsMulti-agent FrameworkLightweight FrameworkFull IDE
MethodologyAWS AI-DLC (formal)Spec Kit SDDAgentic AgileOpenSpec SDDKiro SDD
Design IntegrationDDD default (extensible via bolt types)Constitution fileOptionalDesign-agnosticDesign-agnostic
RitualsMob Elaboration, Mob ConstructionNoneNoneNoneNone
Phases3 sequential6 sequential4 phasesChange-centricRequirements→Design→Tasks
Agent Model3 phase-based agentsPrompts for 15+ assistants19 role-based agentsAGENTS.md compatibleBuilt-in + Subagents
Iteration Cycles”Hours or days” (Bolts)VariableVariableVariableVariable
Brownfield SupportYes (with model elevation)YesYesYes (primary focus)Yes
IDE Lock-inNone (any IDE)NoneNoneNoneKiro IDE only
VS Code ExtensionYes (visual dashboard)NoNoCLI dashboardBuilt into IDE
Open SourceYesYesYesYesPartial (Code OSS base, proprietary features)
PricingFree (OSS)Free (OSS)Free (OSS)Free (OSS)Free preview → $20-200/mo

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.
Intent → Units → Stories → Bolt (batched stories)

                    DDD Construction Steps

                    Traceable Artifacts

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

ToolLock-in Risk
specs.mdNone - works with any IDE/AI
Spec KitNone - works with 15+ AI assistants
BMADNone - works with any IDE/AI
OpenSpecNone - AGENTS.md compatible with any tool
KiroHigh - Kiro IDE + Claude Sonnet only

Cost Comparison

ToolCost
specs.md$0 + API tokens
Spec Kit$0 + API tokens
BMAD$0 + API tokens
OpenSpec$0 + API tokens
Kiro Pro$20/month (225 vibe + 125 spec/mo)
Kiro Pro+$39/month (450 vibe + 250 spec/mo)
Kiro Power$200/month (2,250 vibe + 1,250 spec/mo)

Roadmap

FeatureStatusDescription
AI-DLC FlowAvailableFull methodology with DDD, 4 agents
Simple FlowAvailableSpec generation (requirements, design, tasks)
FIRE FlowAvailableRapid execution with adaptive checkpoints
Brownfield SupportAvailableFirst-class in FIRE Flow
Monorepo SupportAvailableHierarchical standards in FIRE Flow
VS Code ExtensionAvailableVisual dashboard for all flows
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