8a00f8ad70
This major enhancement revolutionizes the tech-spec workflow from a basic template-filling exercise into a context-aware, intelligent planning system for rapid development of bug fixes and small features. ## Tech-Spec Workflow Transformation (11 files) ### Core Workflow Intelligence (instructions.md) - Add standalone mode with interactive level/field-type detection - Implement brownfield convention detection and user confirmation - Integrate WebSearch for current framework versions and starter templates - Add comprehensive context discovery (stack, patterns, dependencies) - Implement auto-validation with quality scoring (always runs) - Add UX/UI considerations capture for user-facing changes - Add test framework detection and pattern analysis - Transform from batch generation to living document approach ### Comprehensive Tech-Spec Template (tech-spec-template.md) - Expand from 8 to 23 sections for complete context - Add Context section (available docs, project stack, existing structure) - Add Development Context (conventions, test framework, existing code) - Add UX/UI Considerations section - Add Developer Resources (file paths, key locations, testing) - Add Integration Points and Configuration Changes - All sections populated via template-output tags during workflow ### Enhanced Story Generation - Level 0 (instructions-level0-story.md): Extract from comprehensive tech-spec - Level 1 (instructions-level1-stories.md): Add story sequence validation, AC quality checks - User Story Template: Add Dev Agent Record sections for implementation tracking - Epic Template: Complete rewrite with proper structure and variables ### Validation & Quality (checklist.md) - Add context gathering completeness checks - Add definitiveness validation (no "use X or Y" statements) - Add brownfield integration quality scoring - Add stack alignment verification - Add implementation readiness assessment - Auto-generates validation report with scores ### Configuration (workflow.yaml) - Add runtime variables: project_level, project_type, development_context, change_type, field_type - Enable standalone operation without workflow-status.yaml - Support both workflow-init integration and quick-start mode ## Phase 4 Integration (3 files) ### Story Context Workflow - Add tech_spec to input_file_patterns (recognizes as authoritative source) - Update instructions to prioritize tech-spec for Level 0-1 projects - Tech-spec provides brownfield analysis, framework details, existing patterns ### Create Story Workflow - Add tech_spec to input_file_patterns - Enable story generation from tech-spec (alternative to PRD) - Supports both Quick Spec Flow and traditional BMM flow ## Documentation (2 new files) ### Quick Spec Flow Guide (docs/quick-spec-flow.md) - Comprehensive 595-line guide for Level 0-1 rapid development - Complete user journey examples (bug fix, small feature) - Context discovery explanation (stack, brownfield, conventions) - Auto-validation details and benefits - Integration with Phase 4 workflows - Comparison: Quick Spec vs Full BMM - Real-world examples and best practices ### Scale Adaptive System (docs/scale-adaptive-system.md) - Complete 950-line technical guide to BMad Method's 5-level system - Key terminology: Analysis, Tech-Spec, Epic-Tech-Spec, Architecture - Level 0-4 workflows, planning docs, and progression - Brownfield emphasis: document-project required first - Tech-spec (upfront, Level 0-1) vs epic-tech-spec (during implementation, Level 2-4) - Architecture document replaces tech-spec at Level 2+ (scales with complexity) - Retrospectives after each epic in multi-epic projects - Workflow path configuration reference ### README Updates - Add Quick Spec Flow announcement with benefits - Link to Scale Adaptive System documentation - Clarify when to use Quick Spec Flow vs Full BMM ## Key Features ### Context-Aware Intelligence - Auto-detects project stack from package.json, requirements.txt, etc. - Analyzes brownfield codebases using document-project output - Detects code conventions and confirms with user before proceeding - Uses WebSearch for up-to-date framework info and starter templates ### Brownfield Respect - Detects existing patterns (code style, test framework, naming conventions) - Asks user for confirmation before applying conventions - Adapts to existing code vs forcing changes - References document-project analysis for comprehensive context ### Auto-Validation - Always runs (not optional) - Validates context gathering, definitiveness, brownfield integration - Scores tech-spec quality and implementation readiness - Validates story sequence for Level 1 (no forward dependencies) ### Living Document Approach - Write to tech-spec continuously during discovery - Progressive refinement vs batch generation - Template variables populated via template-output tags in real-time ## Breaking Changes None - all changes are additive and backward compatible. ## Impact This transformation enables: - Bug fixes and small features implemented in minutes vs hours - Automatic stack detection and brownfield analysis - Respect for existing conventions and patterns - Current best practices via WebSearch integration - Comprehensive context that can replace story-context for simple efforts - Seamless integration with Phase 4 implementation workflows Quick Spec Flow now provides a **true fast path from idea to implementation** for Level 0-1 projects while maintaining quality through auto-validation and comprehensive context gathering. |
||
|---|---|---|
| .claude/commands/bmad | ||
| .github | ||
| .husky | ||
| .vscode | ||
| bmad | ||
| bmd | ||
| docs | ||
| src | ||
| test | ||
| tools | ||
| .gitignore | ||
| .npmrc | ||
| .nvmrc | ||
| .prettierignore | ||
| CHANGELOG.md | ||
| CONTRIBUTING.md | ||
| LICENSE | ||
| README.md | ||
| eslint.config.mjs | ||
| package-lock.json | ||
| package.json | ||
| prettier.config.mjs | ||
| v6-open-items.md | ||
README.md
BMad CORE + BMad Method
🚨 ALPHA VERSION DOCUMENTATION
- Install v6 Alpha:
npx bmad-method@alpha install- Install stable v4:
npx bmad-method install- View v4 documentation
Universal Human-AI Collaboration Platform
BMad-CORE (Collaboration Optimized Reflection Engine) amplifies human potential through specialized AI agents. Unlike tools that replace thinking, BMad-CORE guides reflective workflows that bring out your best ideas and AI's full capabilities.
🎯 Human Amplification • 🎨 Domain Agnostic • ⚡ Agent-Powered
Table of Contents
- BMad CORE + BMad Method
Quick Start
- New to v6? → BMad Method V6 Quick Start Guide
- Need a quick bug fix or small feature? ⚡ → BMad Quick Spec Flow - Go from idea to implementation in minutes!
- Upgrading? → v4 to v6 Upgrade Guide
⚡ NEW: Quick Spec Flow for Rapid Development
Perfect for: Bug fixes, small features, rapid prototyping
Skip the full planning docs and go straight to implementation with auto-detected stack, brownfield analysis, and context-rich technical specs. Ideal for Level 0-1 projects that don't need Product Briefs or PRDs.
📚 Learn about project levels: BMad Method Scale Adaptive System - Automatically adapts from Level 0 (bug fixes) to Level 4 (enterprise systems)
When to use Quick Spec Flow:
- 🐛 Bug fixes - Single file changes, isolated improvements
- ✨ Small features - 2-3 related changes, coherent functionality
- 🚀 Rapid prototyping - Quick experiments and validation
- 🔧 Brownfield enhancements - Adding to existing codebases
Not sure which flow to use? Run workflow-init - it will analyze your project goal and recommend either Quick Spec Flow (Level 0-1) or Full BMM Flow (Level 2-4).
→ Read the complete Quick Spec Flow guide
What is BMad-CORE?
Foundation framework powering all BMad modules:
- Agent Orchestration - Specialized AI personas with unique capabilities
- Workflow Engine - Guided multi-step processes
- Modular Architecture - Domain-specific extensions
- IDE Integration - Works across development environments
- Update-Safe Customization - Persistent configuration through updates
v6 Core Enhancements
- 🎨 Agent Customization - Modify names, roles, personalities via
bmad/_cfg/agents/ - 🌐 Multi-Language - Independent language settings for communication and output
- 👤 Personalization - Agents adapt to your name, technical level, preferences
- 🔄 Persistent Config - Customizations survive all updates
- ⚙️ Flexible Settings - Module or global configuration options
C.O.R.E. Philosophy
- Collaboration: Human-AI partnership leveraging unique strengths
- Optimized: Refined processes for maximum effectiveness
- Reflection: Guided thinking unlocking better solutions
- Engine: Framework orchestrating specialized agents and workflows
BMad-CORE helps you discover better solutions through strategic questioning and structured thinking.
Modules
BMad Method (BMM) - Agile AI Development
AI-driven agile framework revolutionizing software and game development. Adapts from bug fixes to enterprise systems.
v6 Highlights
🎯 Scale-Adaptive Workflows (Levels 0-4)
- Automatically adjusts complexity from quick fixes to enterprise projects
- Greenfield & brownfield support with smart context engine
🏗️ Project-Adaptive Architecture
- Documents adapt to project type (web, mobile, embedded, game)
- Engine-specific game development (Unity, Phaser, Godot, Unreal)
📋 Four-Phase Methodology
- Analysis - Brainstorming, research, briefs
- Planning - Scale-adaptive PRD/GDD
- Solutioning - Architecture and tech specs
- Implementation - Stories, development, review
Specialized Agents: PM, Analyst, Architect, Scrum Master, Developer, Game Designer/Developer/Architect, UX, Test Architect
Documentation: 📚 BMM Module | 📖 Workflows Guide
BMad Builder (BMB) - Create Custom Solutions
Build custom agents, workflows, and modules using BMad-CORE framework.
- Agent Creation - Custom roles and behaviors
- Workflow Design - Structured multi-step processes
- Module Development - Complete domain solutions
- Three Agent Types - Full module, hybrid, standalone
Documentation:
- 📚 BMB Module - Complete module reference
- 🎯 Create Agent - Agent builder workflow
- 📋 Create Workflow - Workflow designer
- 📦 Create Module - Module scaffolding
Creative Intelligence Suite (CIS) - Innovation & Creativity
AI-powered creative facilitation across five domains.
- 5 Interactive Workflows - Brainstorming, Design Thinking, Problem Solving, Innovation Strategy, Storytelling
- 150+ Creative Techniques - Proven frameworks and methodologies
- 5 Specialized Agents - Unique personas and facilitation styles
- Shared Resource - Powers creative workflows in other modules
Documentation: 📚 CIS Module | 📖 CIS Workflows
Installation
Prerequisites: Node.js v20+ (Download)
# Install v6 Alpha
npx bmad-method@alpha install
# Install stable v4
npx bmad-method install
Interactive installer guides you through:
- Project location - Installation directory
- Module selection - BMM, BMB, CIS
- Configuration - Name, language, game dev options
- IDE integration - Environment setup
Project Structure
your-project/
└── bmad/
├── core/ # Core framework
├── bmm/ # BMad Method
├── bmb/ # BMad Builder
├── cis/ # Creative Intelligence
└── _cfg/ # Your customizations
└── agents/ # Agent configs
Getting Started
After installation, activate Analyst agent and run:
/workflow-init
This initializes the workflow system and helps choose your starting point.
Key Features
🎨 Update-Safe Customization
- Agent modification via
bmad/_cfg/agents/ - Persistent settings through updates
- Multi-language support
- Flexible configuration
🚀 Intelligent Installation
- Auto-detects v4 installations
- Configures IDE integrations
- Resolves dependencies
- Creates unified manifests
📁 Unified Architecture
Single bmad/ folder - clean, organized, maintainable.
📄 Document Sharding
Optional efficiency optimization for large projects:
- Automatic Support - All workflows handle whole or sharded documents
- Selective Loading - Phase 4 workflows load only needed sections (90%+ token savings)
- Easy Sharding - Built-in tool splits documents by headings
- Smart Discovery - Workflows auto-detect format
Documentation
- 📚 Documentation Index - Complete documentation map
- v4 to v6 Upgrade Guide - Migration instructions
- CLI Tool Guide - Installer reference
- Contributing Guide - Contribution guidelines
Community & Support
- 💬 Discord - Community help
- 🐛 Issues - Bug reports
- 🎥 YouTube - Tutorials
- ⭐ Star this repo - Updates
Contributing
See CONTRIBUTING.md for guidelines.
License
MIT License - See LICENSE
Trademark: BMAD™ and BMAD-METHOD™ are trademarks of BMad Code, LLC.
Built with ❤️ for the human-AI collaboration community