mirror of
https://github.com/bmadcode/BMAD-METHOD.git
synced 2025-12-29 16:14:59 +00:00
## 📚 Complete Documentation Restructure **BMM Documentation Hub Created:** - New centralized documentation system at `src/modules/bmm/docs/` - 18 comprehensive guides organized by topic (7000+ lines total) - Clear learning paths for greenfield, brownfield, and quick spec flows - Professional technical writing standards throughout **New Documentation:** - `README.md` - Complete documentation hub with navigation - `quick-start.md` - 15-minute getting started guide - `agents-guide.md` - Comprehensive 12-agent reference (45 min read) - `party-mode.md` - Multi-agent collaboration guide (20 min read) - `scale-adaptive-system.md` - Deep dive on Levels 0-4 (42 min read) - `brownfield-guide.md` - Existing codebase development (53 min read) - `quick-spec-flow.md` - Rapid Level 0-1 development (26 min read) - `workflows-analysis.md` - Phase 1 workflows (12 min read) - `workflows-planning.md` - Phase 2 workflows (19 min read) - `workflows-solutioning.md` - Phase 3 workflows (13 min read) - `workflows-implementation.md` - Phase 4 workflows (33 min read) - `workflows-testing.md` - Testing & QA workflows (29 min read) - `workflow-architecture-reference.md` - Architecture workflow deep-dive - `workflow-document-project-reference.md` - Document-project workflow reference - `enterprise-agentic-development.md` - Team collaboration patterns - `faq.md` - Comprehensive Q&A covering all topics - `glossary.md` - Complete terminology reference - `troubleshooting.md` - Common issues and solutions **Documentation Improvements:** - Removed all version/date footers (git handles versioning) - Agent customization docs now include full rebuild process - Cross-referenced links between all guides - Reading time estimates for all major docs - Consistent professional formatting and structure **Consolidated & Streamlined:** - Module README (`src/modules/bmm/README.md`) streamlined to lean signpost - Root README polished with better hierarchy and clear CTAs - Moved docs from root `docs/` to module-specific locations - Better separation of user docs vs. developer reference ## 🤖 New Agent: Paige (Documentation Guide) **Role:** Technical documentation specialist and information architect **Expertise:** - Professional technical writing standards - Documentation structure and organization - Information architecture and navigation - User-focused content design - Style guide enforcement **Status:** Work in progress - Paige will evolve as documentation needs grow **Integration:** - Listed in agents-guide.md, glossary.md, FAQ - Available for all phases (documentation is continuous) - Can be customized like all BMM agents ## 🔧 Additional Changes - Updated agent manifest with Paige - Updated workflow manifest with new documentation workflows - Fixed workflow-to-agent mappings across all guides - Improved root README with clearer Quick Start section - Better module structure explanations - Enhanced community links with Discord channel names **Total Impact:** - 18 new/restructured documentation files - 7000+ lines of professional technical documentation - Complete navigation system with cross-references - Clear learning paths for all user types - Foundation for knowledge base (coming in beta) Co-Authored-By: Claude <noreply@anthropic.com>
6.3 KiB
6.3 KiB
| 1 | phase | method_name | description | facilitation_prompts |
|---|---|---|---|---|
| 2 | empathize | User Interviews | Conduct deep conversations to understand user needs experiences and pain points through active listening | What brings you here today?|Walk me through a recent experience|What frustrates you most?|What would make this easier?|Tell me more about that |
| 3 | empathize | Empathy Mapping | Create visual representation of what users say think do and feel to build deep understanding | What did they say?|What might they be thinking?|What actions did they take?|What emotions surfaced? |
| 4 | empathize | Shadowing | Observe users in their natural environment to see unspoken behaviors and contextual factors | Watch without interrupting|Note their workarounds|What patterns emerge?|What do they not say? |
| 5 | empathize | Journey Mapping | Document complete user experience across touchpoints to identify pain points and opportunities | What's their starting point?|What steps do they take?|Where do they struggle?|What delights them?|What's the emotional arc? |
| 6 | empathize | Diary Studies | Have users document experiences over time to capture authentic moments and evolving needs | What did you experience today?|How did you feel?|What worked or didn't?|What surprised you? |
| 7 | define | Problem Framing | Transform observations into clear actionable problem statements that inspire solution generation | What's the real problem?|Who experiences this?|Why does it matter?|What would success look like? |
| 8 | define | How Might We | Reframe problems as opportunity questions that open solution space without prescribing answers | How might we help users...?|How might we make it easier to...?|How might we reduce the friction of...? |
| 9 | define | Point of View Statement | Create specific user-centered problem statements that capture who what and why | User type needs what because insight|What's driving this need?|Why does it matter to them? |
| 10 | define | Affinity Clustering | Group related observations and insights to reveal patterns and opportunity themes | What connects these?|What themes emerge?|Group similar items|Name each cluster|What story do they tell? |
| 11 | define | Jobs to be Done | Identify functional emotional and social jobs users are hiring solutions to accomplish | What job are they trying to do?|What progress do they want?|What are they really hiring this for?|What alternatives exist? |
| 12 | ideate | Brainstorming | Generate large quantity of diverse ideas without judgment to explore solution space fully | No bad ideas|Build on others|Go for quantity|Be visual|Stay on topic|Defer judgment |
| 13 | ideate | Crazy 8s | Rapidly sketch eight solution variations in eight minutes to force quick creative thinking | Fold paper in 8|1 minute per sketch|No overthinking|Quantity over quality|Push past obvious |
| 14 | ideate | SCAMPER Design | Apply seven design lenses to existing solutions - Substitute Combine Adapt Modify Purposes Eliminate Reverse | What could we substitute?|How could we combine elements?|What could we adapt?|How could we modify it?|Other purposes?|What to eliminate?|What if reversed? |
| 15 | ideate | Provotype Sketching | Create deliberately provocative or extreme prototypes to spark breakthrough thinking | What's the most extreme version?|Make it ridiculous|Push boundaries|What useful insights emerge? |
| 16 | ideate | Analogous Inspiration | Find inspiration from completely different domains to spark innovative connections | What other field solves this?|How does nature handle this?|What's an analogous problem?|What can we borrow? |
| 17 | prototype | Paper Prototyping | Create quick low-fidelity sketches and mockups to make ideas tangible for testing | Sketch it out|Make it rough|Focus on core concept|Test assumptions|Learn fast |
| 18 | prototype | Role Playing | Act out user scenarios and service interactions to test experience flow and pain points | Play the user|Act out the scenario|What feels awkward?|Where does it break?|What works? |
| 19 | prototype | Wizard of Oz | Simulate complex functionality manually behind scenes to test concept before building | Fake the backend|Focus on experience|What do they think is happening?|Does the concept work? |
| 20 | prototype | Storyboarding | Visualize user experience across time and touchpoints as sequential illustrated narrative | What's scene 1?|How does it progress?|What's the emotional journey?|Where's the climax?|How does it resolve? |
| 21 | prototype | Physical Mockups | Build tangible artifacts users can touch and interact with to test form and function | Make it 3D|Use basic materials|Make it interactive|Test ergonomics|Gather reactions |
| 22 | test | Usability Testing | Watch users attempt tasks with prototype to identify friction points and opportunities | Try to accomplish X|Think aloud please|Don't help them|Where do they struggle?|What surprises them? |
| 23 | test | Feedback Capture Grid | Organize user feedback across likes questions ideas and changes for actionable insights | What did they like?|What questions arose?|What ideas did they have?|What needs changing? |
| 24 | test | A/B Testing | Compare two variations to understand which approach better serves user needs | Show version A|Show version B|Which works better?|Why the difference?|What does data show? |
| 25 | test | Assumption Testing | Identify and validate critical assumptions underlying your solution to reduce risk | What are we assuming?|How can we test this?|What would prove us wrong?|What's the riskiest assumption? |
| 26 | test | Iterate and Refine | Use test insights to improve prototype through rapid cycles of refinement and re-testing | What did we learn?|What needs fixing?|What stays?|Make changes quickly|Test again |
| 27 | implement | Pilot Programs | Launch small-scale real-world implementation to learn before full rollout | Start small|Real users|Real context|What breaks?|What works?|Scale lessons learned |
| 28 | implement | Service Blueprinting | Map all service components interactions and touchpoints to guide implementation | What's visible to users?|What happens backstage?|What systems are needed?|Where are handoffs? |
| 29 | implement | Design System Creation | Build consistent patterns components and guidelines for scalable implementation | What patterns repeat?|Create reusable components|Document standards|Enable consistency |
| 30 | implement | Stakeholder Alignment | Bring team and stakeholders along journey to build shared understanding and commitment | Show the research|Walk through prototypes|Share user stories|Build empathy|Get buy-in |
| 31 | implement | Measurement Framework | Define success metrics and feedback loops to track impact and inform future iterations | How will we measure success?|What are key metrics?|How do we gather feedback?|When do we revisit? |