agent manifest generation, party mode uses it, and tea persona compression

bmad/bmm/README.md

@@ -0,0 +1,126 @@
+# BMM - BMad Method Module
+
+The BMM (BMad Method Module) is the core orchestration system for the BMad Method v6a, providing comprehensive software development lifecycle management through specialized agents, workflows, teams, and tasks.
+
+## 📚 Essential Reading
+
+**Before using BMM, you MUST read the [BMM v6 Workflows Guide](./workflows/README.md).** This document explains the revolutionary v6a workflow system and how all components work together.
+
+## Module Structure
+
+### 🤖 `/agents`
+
+Specialized AI agents for different development roles:
+
+- **PM** (Product Manager) - Product planning and requirements
+- **Analyst** - Business analysis and research
+- **Architect** - Technical architecture and design
+- **SM** (Scrum Master) - Sprint and story management
+- **DEV** (Developer) - Code implementation
+- **SR** (Senior Reviewer) - Code review and quality
+- **UX** - User experience design
+- And more specialized roles
+
+### 📋 `/workflows`
+
+The heart of BMM - structured workflows for the four development phases:
+
+1. **Analysis Phase** (Optional)
+   - `brainstorm-project` - Project ideation
+   - `research` - Market/technical research
+   - `product-brief` - Product strategy
+
+2. **Planning Phase** (Required)
+   - `plan-project` - Scale-adaptive project planning
+   - Routes to appropriate documentation based on project complexity
+
+3. **Solutioning Phase** (Level 3-4 projects)
+   - `3-solutioning` - Architecture design
+   - `tech-spec` - Epic-specific technical specifications
+
+4. **Implementation Phase** (Iterative)
+   - `create-story` - Story generation
+   - `story-context` - Expertise injection
+   - `dev-story` - Implementation
+   - `review-story` - Quality validation
+   - `correct-course` - Issue resolution
+   - `retrospective` - Continuous improvement
+
+### 👥 `/teams`
+
+Pre-configured agent teams for different project types and phases. Teams coordinate multiple agents working together on complex tasks.
+
+### 📝 `/tasks`
+
+Reusable task definitions that agents execute within workflows. These are the atomic units of work that compose into larger workflows.
+
+### 🔧 `/sub-modules`
+
+Extension modules that add specialized capabilities to BMM.
+
+### 🏗️ `/testarch`
+
+Test architecture and quality assurance components.
+
+## Quick Start
+
+```bash
+# Run a planning workflow
+bmad pm plan-project
+
+# Create a new story
+bmad sm create-story
+
+# Run development workflow
+bmad dev develop
+
+# Review implementation
+bmad sr review-story
+```
+
+## Key Concepts
+
+### Scale Levels
+
+BMM automatically adapts to project complexity:
+
+- **Level 0**: Single atomic change
+- **Level 1**: 1-10 stories, minimal documentation
+- **Level 2**: 5-15 stories, focused PRD
+- **Level 3**: 12-40 stories, full architecture
+- **Level 4**: 40+ stories, enterprise scale
+
+### Just-In-Time Design
+
+Technical specifications are created one epic at a time during implementation, not all upfront, allowing for learning and adaptation.
+
+### Context Injection
+
+Story-specific technical guidance is generated dynamically, providing developers with exactly the expertise needed for each task.
+
+## Integration with BMad Core
+
+BMM integrates seamlessly with the BMad Core framework, leveraging:
+
+- The agent execution engine
+- Workflow orchestration
+- Task management
+- Team coordination
+
+## Related Documentation
+
+- [BMM Workflows Guide](./workflows/README.md) - **Start here!**
+- [Agent Documentation](./agents/README.md) - Individual agent capabilities
+- [Team Configurations](./teams/README.md) - Pre-built team setups
+- [Task Library](./tasks/README.md) - Reusable task components
+
+## Best Practices
+
+1. **Always start with the workflows** - Let workflows guide your process
+2. **Respect the scale** - Don't over-document small projects
+3. **Embrace iteration** - Use retrospectives to continuously improve
+4. **Trust the process** - The v6a methodology has been carefully designed
+
+---
+
+For detailed information about the complete BMad Method v6a workflow system, see the [BMM Workflows README](./workflows/README.md).