From Vibe Coding

To Spec-Driven Development

Victor Nitu

  • AI Engineer @ IMTF
  • AI Solutions for RegTech

Agenda

  • Vibe Coding & Spec-driven Development
  • Agentic Planning Workflow (Web UI)
  • Context-Engineered Development Cycle (IDE)
⚑ Vibe Coding πŸ“‘ Spec-driven Development
πŸš€ Fast to start πŸ—οΈ Built for scalability
🎨 Creative flow πŸ”’ Consistency through shared specs
⚑ Feels productive 🎯 Aligned with long-term goals
πŸ’‘ Great for prototypes 🌍 Reliable for large projects
🀝 Flexible and lightweight πŸ”Ž Clear documentation
πŸ”₯ Inspires innovation πŸ› οΈ Integration with existing systems
Kiro (Amazon) Spec Kit (GitHub) BMAD-METHODβ„’ (OSS)
Agentic IDE Lightweight toolkit Role-based framework
MCP integration Works with any agent Tool-agnostic (CLI & WebUI)
Free + paid plans Free, MIT Free, MIT
All-in-one workflow Layered structure Multi-agent orchestration

BMAD-METHODβ„’

Phase Roles / Agents Output / Artefacts
Planning Workflow (WebUI) Analyst, Product Manager, Architect PRD, Epics, Architecture
Development Cycle (IDE) Product Owner, Scrum Master, Dev, QA User Stories, Tasks, Code, Tests

Agentic Planning Workflow (Web UI)

  1. Get the bundle: dist/teams/team-fullstack.txt
  2. Create AI agent: OpenAI CustomGPT
  3. Start Workflow: Greenfield or Brownfield
Greenfield 🌱 Brownfield πŸ—οΈ
Start No existing system Existing system/codebase
Focus Build new PRD & architecture Adapt / modernize legacy
Stories Complete context from scratch Context merged with legacy constraints
Outcome New solution Enhanced / migrated solution
πŸ—οΈ πŸ€– Agent / Tool πŸ”§ Brownfield Task
Step 1 Codebase Flattener Format codebase to XML
Step 2 Analyst Document project
Step 3 Project Manager Define brownfield requirements (PRD)
Step 4 Project Manager Define brownfield epics
Step 5 Architect Document brownfield architecture

Codebase Flattener Tool

npx bmad-method flatten -i `pwd` -o `pwd`/docs/flattened-codebase.xml

A) Autopilot Option

# Fullstack project
*workflow brownfield-fullstack

# Backend project
*workflow brownfield-service

# Frontent project
*workflow brownfield-ui

B) Manual Option

# include flattened-codebase.xml
/analyst   *document-project
/analyst   generate `source-tree.md`

# include document-project.md
/pm        *create-brownfield-prd

# include prd.md
/pm        *create-brownfield-epic

# include document-project.md + prd.md + source-tree.md
/architect *create-brownfield-architecture
/architect generate `coding-standard.md`
/architect generate `tech-stack.md`

Analyst

  • Project documentation:
    • πŸ”§/analyst *document-project + πŸ“„flattened-codebase.xml
      • πŸ“„ docs/document-project.md
  • Source Tree:
    • πŸ”§/analyst generate `source-tree.md/` + πŸ“„flattened-codebase.xml
      • πŸ“„docs/architecture/source-tree.md

Project Manager

  • Product Requirements Document:
    • πŸ”§/pm *create-brownfield-prd + πŸ“„document-project.md
      • πŸ“„docs/prd.md
  • Epic 1:
    • πŸ”§/pm *create-brownfield-epic + πŸ“„prd.md
      • πŸ“„docs/prd/epic-1.md
  • Epic 2:
    • πŸ”§/pm *create-brownfield-epic + πŸ“„prd.md
      • πŸ“„docs/prd/epic-2.md
  • ...

Architect

πŸ“šbundle = πŸ“„document-project.md + πŸ“„prd.md + πŸ“„source-tree.md

  • Architecture:
    • πŸ”§/architect *create-brownfield-architecture + πŸ“šbundle
      • πŸ“„docs/architecture.md
  • Coding Standard:
    • πŸ”§/architect generate `coding-standard.md` + πŸ“šbundle
      • πŸ“„docs/architecture/coding-standard.md
  • Tech Stack:
    • πŸ”§/architect generate `tech-stack.md` + πŸ“šbundle
      • πŸ“„docs/architecture/tech-stack.md

Context-Engineered Development Cycle (IDE)

πŸ—οΈ πŸ€– Agent / Tool πŸ”§ Development Task
Step 1 Installer Install BMAD
Step 2 Product Owner Shard PRD & Architecture
Step 3 Scrum Master Create draft story
Step 4 Product Owner Validate draft story
Step 5 Developer Develop validated story
Step 6 Quality Advisor Review developed story

Install BMAD in IDE

npx bmad-method install

Product Owner

  • Shard PRD:
    • πŸ”§/po shard-doc docs/prd.md docs/prd
      • πŸ“„docs/prd/1-goals-background-context.md
      • πŸ“„docs/prd/2-requirements.md
      • ...
  • Shard Architecture:
    • πŸ”§/po shard-doc docs/architecture.md docs/architecture
      • πŸ“„docs/architecture/1-project-context-scope.md
      • πŸ“„docs/architecture/2-target-architecture-overview.md
      • ...

Scrum Master

  • Draft User Story:
    • πŸ”§/sm *draft
      • πŸ“„docs/stories/1.1.story.md
        • 🟠Draft

Product Owner

  • Validate Draft User Story:
    • πŸ”§/po *validate-story-draft 1.1
      • πŸ“„docs/stories/1.1.story.md
        • 🟠Draft => 🟣Approved

Full Stack Developer

  • Develop User Story:
    • πŸ”§/dev *develop-story 1.1
      • πŸ“„docs/stories/1.1.story.md
        • 🟣Approved => πŸ”΅Ready for Review

Test Architect & Quality Advisor

  • Review User Story:
    • πŸ”§/qa *review 1.1
      • πŸ“„docs/stories/1.1.story.md
        a. πŸ”΅Ready for Review => 🟒Done
        b. πŸ”΅Ready for Review => 🟠In Progress
        • πŸ“„docs/qa/gates/1.1-xxx.yml

Conclusion

  • Vibe coding is fun but breaks down at scale
  • Spec-driven practices enable structure + creativity
  • BMAD-METHODβ„’ provides:
    • Flattening & sharding tools
    • Role-based agent workflows
    • End-to-end support for greenfield & brownfield projects

Questions?

πŸ™ Thank you!
Let's turn vibes β†’ specs β†’ production πŸš€