mirror of
https://github.com/bmadcode/BMAD-METHOD.git
synced 2025-12-29 16:14:59 +00:00
Major Enhancements:
- Installation path is now fully configurable, allowing users to specify custom installation directories during setup
- Default installation location changed to .bmad (hidden directory) for cleaner project root organization
Web Bundle Improvements:
- All web bundles (single agent and team) now include party mode support for multi-agent collaboration!
- Advanced elicitation capabilities integrated into standalone agents
- All bundles enhanced with party mode agent manifests
- Added default-party.csv files to bmm, bmgd, and cis module teams
- The default party file is what will be used with single agent bundles. teams can customize for different party configurations before web bundling through a setting in the team yaml file
- New web bundle outputs for all agents (analyst, architect, dev, pm, sm, tea, tech-writer, ux-designer, game-*, creative-squad)
Phase 4 Workflow Updates (In Progress):
- Initiated shift to separate phase 4 implementation artifacts from documentation
- Phase 4 implementation artifacts (stories, code review, sprint plan, context files) will move to dedicated location outside docs folder
- Installer questions and configuration added for artifact path selection
- Updated workflow.yaml files for code-review, sprint-planning, story-context, epic-tech-context, and retrospective workflows to support this, but still might require some udpates
Additional Changes:
- New agent and action command header models for standardization
- Enhanced web-bundle-activation-steps fragment
- Updated web-bundler.js to support new structure
- VS Code settings updated for new .bmad directory
- Party mode instructions and workflow enhanced for better orchestration
IDE Installer Updates:
- Show version number of installer in cli
- improved Installer UX
- Gemini TOML Improved to have clear loading instructions with @ commands
- All tools agent launcher mds improved to use a central file template critical indication isntead of hardcoding in 2 different locations.
This commit is contained in:
128
.bmad/bmm/README.md
Normal file
128
.bmad/bmm/README.md
Normal file
@@ -0,0 +1,128 @@
|
||||
# BMM - BMad Method Module
|
||||
|
||||
Core orchestration system for AI-driven agile development, providing comprehensive lifecycle management through specialized agents and workflows.
|
||||
|
||||
---
|
||||
|
||||
## 📚 Complete Documentation
|
||||
|
||||
👉 **[BMM Documentation Hub](./docs/README.md)** - Start here for complete guides, tutorials, and references
|
||||
|
||||
**Quick Links:**
|
||||
|
||||
- **[Quick Start Guide](./docs/quick-start.md)** - New to BMM? Start here (15 min)
|
||||
- **[Agents Guide](./docs/agents-guide.md)** - Meet your 12 specialized AI agents (45 min)
|
||||
- **[Scale Adaptive System](./docs/scale-adaptive-system.md)** - How BMM adapts to project size (42 min)
|
||||
- **[FAQ](./docs/faq.md)** - Quick answers to common questions
|
||||
- **[Glossary](./docs/glossary.md)** - Key terminology reference
|
||||
|
||||
---
|
||||
|
||||
## 🏗️ Module Structure
|
||||
|
||||
This module contains:
|
||||
|
||||
```
|
||||
bmm/
|
||||
├── agents/ # 12 specialized AI agents (PM, Architect, SM, DEV, TEA, etc.)
|
||||
├── workflows/ # 34 workflows across 4 phases + testing
|
||||
├── teams/ # Pre-configured agent groups
|
||||
├── tasks/ # Atomic work units
|
||||
├── testarch/ # Comprehensive testing infrastructure
|
||||
└── docs/ # Complete user documentation
|
||||
```
|
||||
|
||||
### Agent Roster
|
||||
|
||||
**Core Development:** PM, Analyst, Architect, SM, DEV, TEA, UX Designer, Technical Writer
|
||||
**Game Development:** Game Designer, Game Developer, Game Architect
|
||||
**Orchestration:** BMad Master (from Core)
|
||||
|
||||
👉 **[Full Agents Guide](./docs/agents-guide.md)** - Roles, workflows, and when to use each agent
|
||||
|
||||
### Workflow Phases
|
||||
|
||||
**Phase 0:** Documentation (brownfield only)
|
||||
**Phase 1:** Analysis (optional) - 5 workflows
|
||||
**Phase 2:** Planning (required) - 6 workflows
|
||||
**Phase 3:** Solutioning (Level 3-4) - 2 workflows
|
||||
**Phase 4:** Implementation (iterative) - 10 workflows
|
||||
**Testing:** Quality assurance (parallel) - 9 workflows
|
||||
|
||||
👉 **[Workflow Guides](./docs/README.md#-workflow-guides)** - Detailed documentation for each phase
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Getting Started
|
||||
|
||||
**New Project:**
|
||||
|
||||
```bash
|
||||
# Install BMM
|
||||
npx bmad-method@alpha install
|
||||
|
||||
# Load Analyst agent in your IDE, then:
|
||||
*workflow-init
|
||||
```
|
||||
|
||||
**Existing Project (Brownfield):**
|
||||
|
||||
```bash
|
||||
# Document your codebase first
|
||||
*document-project
|
||||
|
||||
# Then initialize
|
||||
*workflow-init
|
||||
```
|
||||
|
||||
👉 **[Quick Start Guide](./docs/quick-start.md)** - Complete setup and first project walkthrough
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Key Concepts
|
||||
|
||||
### Scale-Adaptive Design
|
||||
|
||||
BMM automatically adjusts to project complexity (Levels 0-4):
|
||||
|
||||
- **Level 0-1:** Quick Spec Flow for bug fixes and small features
|
||||
- **Level 2:** PRD with optional architecture
|
||||
- **Level 3-4:** Full PRD + comprehensive architecture
|
||||
|
||||
👉 **[Scale Adaptive System](./docs/scale-adaptive-system.md)** - Complete level breakdown
|
||||
|
||||
### Story-Centric Implementation
|
||||
|
||||
Stories move through a defined lifecycle: `backlog → drafted → ready → in-progress → review → done`
|
||||
|
||||
Just-in-time epic context and story context provide exact expertise when needed.
|
||||
|
||||
👉 **[Implementation Workflows](./docs/workflows-implementation.md)** - Complete story lifecycle guide
|
||||
|
||||
### Multi-Agent Collaboration
|
||||
|
||||
Use party mode to engage all 19+ agents (from BMM, CIS, BMB, custom modules) in group discussions for strategic decisions, creative brainstorming, and complex problem-solving.
|
||||
|
||||
👉 **[Party Mode Guide](./docs/party-mode.md)** - How to orchestrate multi-agent collaboration
|
||||
|
||||
---
|
||||
|
||||
## 📖 Additional Resources
|
||||
|
||||
- **[Brownfield Guide](./docs/brownfield-guide.md)** - Working with existing codebases
|
||||
- **[Quick Spec Flow](./docs/quick-spec-flow.md)** - Fast-track for Level 0-1 projects
|
||||
- **[Enterprise Agentic Development](./docs/enterprise-agentic-development.md)** - Team collaboration patterns
|
||||
- **[Troubleshooting](./docs/troubleshooting.md)** - Common issues and solutions
|
||||
- **[IDE Setup Guides](../../../docs/ide-info/)** - Configure Claude Code, Cursor, Windsurf, etc.
|
||||
|
||||
---
|
||||
|
||||
## 🤝 Community
|
||||
|
||||
- **[Discord](https://discord.gg/gk8jAdXWmj)** - Get help, share feedback (#general-dev, #bugs-issues)
|
||||
- **[GitHub Issues](https://github.com/bmad-code-org/BMAD-METHOD/issues)** - Report bugs or request features
|
||||
- **[YouTube](https://www.youtube.com/@BMadCode)** - Video tutorials and walkthroughs
|
||||
|
||||
---
|
||||
|
||||
**Ready to build?** → [Start with the Quick Start Guide](./docs/quick-start.md)
|
||||
Reference in New Issue
Block a user