Tired of the same old dev grind where specifications are vague, code goes rogue, and your AI assistant keeps generating nonsense? It's time to flip the script. Spec-Driven Development puts specifications in the driver's seat, turning your AI sidekicks into disciplined, predictable code machines. Here are three heavyweight tools—each with its own superpower—that will revolutionize your workflow.
Pro tip: All three tools play beautifully with Claude Code, Cursor, GitHub Copilot, and your other favorite AI assistants.
Choose your weapon: a quick decision diagram
flowchart TD
A[Which project type?] --> B{Brownfield?}
B -->|Yes| C[Try OpenSpec]
B -->|No| D{Greenfield?}
D -->|Yes| E[Consider Spec Kit]
D -->|No| F[Enterprise or team?]
F -->|Yes| G[Use BMAD‑METHOD]
F -->|No| H[Start with Spec Kit for new projects]
OpenSpec – The lightweight pact‑maker
OpenSpec is your two‑folder brain that keeps current specs and proposed changes neatly separated. Think of it as a lightweight pact‑maker: it ensures humans and AI agree on specs before a single line of code gets written. Perfect for brownfield projects where you're tweaking existing features without losing your mind.
Installation
You'll need Bun or Node.js 20.19.0 or higher.
bun add -g @fission-ai/openspec@latest
openspec --versionQuick start
Get up and running in three steps:
- Initialize:
cd my-project && openspec init– createsopenspec/withspecs/andchanges/directories. - Create a proposal: Via Claude Code's slash command:
/openspec:proposal Add user authentication with OAuthor from CLI:openspec new "Add user authentication". - Review and apply: Once polished, run
/openspec:apply auth-featurethen archive:openspec archive auth-feature --yes.
Commands at a glance
openspec init– Initialize OpenSpecopenspec list– View active changesopenspec view– Interactive dashboardopenspec show <change>– Display detailsopenspec validate <change>– Check formattingopenspec archive <change>– Move to archive/openspec:proposal– Create a new proposal (Claude Code)/openspec:apply– Implement approved changes/openspec:archive– Archive completed changes
Spec Kit – The roadmap that builds itself
GitHub's own open‑source toolkit. Spec Kit transforms your specs into executable code through a structured flow of clarification, planning, and task generation. It's like having a roadmap that builds itself—ideal for greenfield projects and scenario‑driven development.
Installation
Persistent install:
uv tool install specify-cli --from git+https://github.com/github/spec-kit.gitOne‑time use:
uvx --from git+https://github.com/github/spec-kit.git specify init my-projectNote: You'll need Python 3.11+ and Git installed.
Quick start
- Initialize:
specify init my-project && cd my-project - Define your project constitution:
/speckit.constitution - Create specifications:
/speckit.specify - Plan and generate tasks:
/speckit.planthen/speckit.tasks - Implement:
/speckit.implement
Key commands
specify init <name>– Create new Spec Kit projectspecify check– Verify system requirements/speckit.constitution– Define governing principles/speckit.specify– Create requirements and user stories/speckit.plan– Generate implementation strategy/speckit.tasks– Create actionable task list/speckit.implement– Execute tasks/speckit.clarify– Clarify ambiguous requirements/speckit.analyze– Analyze existing code/specs/speckit.checklist– Generate verification checklist
BMAD‑METHOD – The full‑spectrum agile army
An AI‑driven agile framework that comes with 12 specialized agents and 34 workflows. Whether you're squashing a quick bug or running a compliance‑heavy enterprise project, BMAD‑METHOD scales to fit. It's like having a whole dev team in your terminal.
Installation
bunx bmad-method@alpha installAlpha is your friend. For the legacy v4, use bunx bmad-method install.
Quick start
- Initialize: after install, run
workflow-init. It analyzes your project and recommends a development track. - Choose your track:
- Quick Flow – Bug fixes, small changes (<5 min setup)
- BMad Method – Products and platforms (<15 min)
- Enterprise – Compliance‑heavy projects (<30 min)
- Work through four phases: Analysis → Planning → Solutioning → Implementation (with validation baked in).
Meet your AI agents
BMAD‑METHOD puts 12 experts on your team:
- Core Dev: Developer, Architect, Product Manager
- Design & Quality: UX Designer, Test Architect, Scrum Master
- Additional: Analyst, DevOps, Security, Documentation, Reviewer, Integration
Key features
- Scale‑adaptive intelligence – automatically adjusts planning depth
- Multi‑language support – works with any language
- Token optimization – up to 90% savings via document sharding
- Customizable agents – build domain‑specific agents with BMad Builder
Comparison at a glance
| Tool | Best for | Key strength | Setup time |
|---|---|---|---|
| OpenSpec | Brownfield, light change tracking | Spec versioning & history | Minutes |
| Spec Kit | Greenfield, scenario-driven dev | Executable specifications | Minutes |
| BMAD‑METHOD | Team/enterprise, compliance | Full agile workflow with agents | 5–30 min |
Next steps
- ☑ Clone your project or create a new one
- ☐ Choose your tool using the decision diagram above
- ☐ Install the selected tool
- ☐ Follow the quick start guide
- ☐ Run a small test feature end‑to‑end
- ☐ Configure your AI assistant (Claude Code, Cursor, etc.)
Ready to stop wrestling with unpredictable code? Install your tool of choice today and watch your AI assistant become a spec‑driven powerhouse.