Skip to main content
BB

Bahrul Bangsawan

AvailableMakassar, Indonesia
BB

Bahrul Bangsawan

Growth Hacker at the intersection of Data, Marketing, and Tech. Helping brands scale with data-driven strategies and modern technology.

Available for HireMakassar, Indonesia 🇮🇩
Book a Call

Blog · Engineering

3 Powerful Spec-Driven Development Tools for AI-Assisted Coding

OpenSpec, Spec Kit, and BMAD-METHOD are three spec-driven development tools that help developers and AI assistants collaborate on well-structured code.

Development Tools4 min read
Share
On this page

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 --version

Quick start

Get up and running in three steps:

  1. Initialize: cd my-project && openspec init – creates openspec/ with specs/ and changes/ directories.
  2. Create a proposal: Via Claude Code's slash command: /openspec:proposal Add user authentication with OAuth or from CLI: openspec new "Add user authentication".
  3. Review and apply: Once polished, run /openspec:apply auth-feature then archive: openspec archive auth-feature --yes.

Commands at a glance

  • openspec init – Initialize OpenSpec
  • openspec list – View active changes
  • openspec view – Interactive dashboard
  • openspec show <change> – Display details
  • openspec validate <change> – Check formatting
  • openspec archive <change> – Move to archive
  • /openspec:proposal – Create a new proposal (Claude Code)
  • /openspec:apply – Implement approved changes
  • /openspec:archive – Archive completed changes

OpenSpec GitHub

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.git

One‑time use:

uvx --from git+https://github.com/github/spec-kit.git specify init my-project

Note: You'll need Python 3.11+ and Git installed.

Quick start

  1. Initialize: specify init my-project && cd my-project
  2. Define your project constitution: /speckit.constitution
  3. Create specifications: /speckit.specify
  4. Plan and generate tasks: /speckit.plan then /speckit.tasks
  5. Implement: /speckit.implement

Key commands

  • specify init <name> – Create new Spec Kit project
  • specify 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

Spec Kit GitHub

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 install

Alpha is your friend. For the legacy v4, use bunx bmad-method install.

Quick start

  1. Initialize: after install, run workflow-init. It analyzes your project and recommends a development track.
  2. 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)
  3. 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

BMAD‑METHOD GitHub

Comparison at a glance

Choose the right tool for your context
ToolBest forKey strengthSetup time
OpenSpecBrownfield, light change trackingSpec versioning & historyMinutes
Spec KitGreenfield, scenario-driven devExecutable specificationsMinutes
BMAD‑METHODTeam/enterprise, complianceFull agile workflow with agents5–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.