npm - bmad-method - Versions diffs - 6.0.0-alpha.5 → 6.0.0-alpha.7 - Mend

bmad-method 6.0.0-alpha.5 → 6.0.0-alpha.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (449) hide show

package/src/modules/bmm/docs/README.md CHANGED Viewed

@@ -36,7 +36,7 @@ Understanding how BMM adapts to your needs:
 ---
-## 🤖 Agents & Collaboration
+## 🤖 Agents and Collaboration
 Complete guide to BMM's AI agent team:
@@ -52,7 +52,7 @@ Complete guide to BMM's AI agent team:
   - Example party compositions
   - Multi-module integration (BMM + CIS + BMB + custom)
   - Agent customization in party mode
-  - Best practices and troubleshooting
+  - Best practices
 ---
@@ -65,7 +65,7 @@ Comprehensive guide for brownfield development:
   - Track selection for brownfield
   - Integration with existing patterns
   - Phase-by-phase workflow guidance
-  - Common scenarios and troubleshooting
+  - Common scenarios
 ---
@@ -75,7 +75,6 @@ Essential reference materials:
 - **[Glossary](./glossary.md)** - Key terminology and concepts
 - **[FAQ](./faq.md)** - Frequently asked questions across all topics
-- **[Troubleshooting](./troubleshooting.md)** - Common issues and solutions
 - **[Enterprise Agentic Development](./enterprise-agentic-development.md)** - Team collaboration strategies
 ---
@@ -99,7 +98,7 @@ Essential reference materials:
 → See [Scale Adaptive System](./scale-adaptive-system.md)
 **Find specific commands or answers**
-→ Check [FAQ](./faq.md) or [Troubleshooting](./troubleshooting.md)
+→ Check [FAQ](./faq.md)
 ---
@@ -127,7 +126,7 @@ Comprehensive documentation for all BMM workflows organized by phase:
   - Complete story lifecycle
   - One-story-at-a-time discipline
-- **[Testing & QA Workflows](./workflows-testing.md)** - Comprehensive quality assurance (1,420 lines)
+- **[Testing & QA Workflows](./test-architecture.md)** - Comprehensive quality assurance (1,420 lines)
   - Test strategy, automation, quality gates
   - TEA agent and test healing
   - BMad-integrated vs standalone modes
@@ -152,15 +151,16 @@ For detailed technical documentation on specific complex workflows:
 ---
-## 🧪 Testing & Quality
+## 🧪 Testing and Quality
 Quality assurance guidance:
-- **[Test Architect Guide](../testarch/README.md)** - Comprehensive testing strategy
-  - Test design workflows
-  - Quality gates
-  - Risk assessment
-  - NFR validation
+<!-- Test Architect documentation to be added -->
+- Test design workflows
+- Quality gates
+- Risk assessment
+- NFR validation
 ---
@@ -178,7 +178,7 @@ Understanding BMM components:
 ## 🌐 External Resources
-### Community & Support
+### Community and Support
 - **[Discord Community](https://discord.gg/gk8jAdXWmj)** - Get help from the community (#general-dev, #bugs-issues)
 - **[GitHub Issues](https://github.com/bmad-code-org/BMAD-METHOD/issues)** - Report bugs or request features
@@ -212,12 +212,12 @@ flowchart TD
     SAS --> IMPL
     BF --> IMPL
-    IMPL --> REF[Quick References<br/>Glossary, FAQ, Troubleshooting]
+    IMPL --> REF[Quick References<br/>Glossary, FAQ]
-    style START fill:#bfb,stroke:#333,stroke-width:2px
-    style QS fill:#bbf,stroke:#333,stroke-width:2px
-    style DECIDE fill:#ffb,stroke:#333,stroke-width:2px
-    style IMPL fill:#f9f,stroke:#333,stroke-width:2px
+    style START fill:#bfb,stroke:#333,stroke-width:2px,color:#000
+    style QS fill:#bbf,stroke:#333,stroke-width:2px,color:#000
+    style DECIDE fill:#ffb,stroke:#333,stroke-width:2px,color:#000
+    style IMPL fill:#f9f,stroke:#333,stroke-width:2px,color:#000
 ```
 ---

package/src/modules/bmm/docs/agents-guide.md CHANGED Viewed

@@ -996,7 +996,7 @@ Quick reference for agent selection:
 - [Phase 2: Planning Workflows](./workflows-planning.md)
 - [Phase 3: Solutioning Workflows](./workflows-solutioning.md)
 - [Phase 4: Implementation Workflows](./workflows-implementation.md)
-- [Testing & QA Workflows](./workflows-testing.md)
+<!-- Testing & QA Workflows documentation to be added -->
 **Advanced References:**
@@ -1013,7 +1013,6 @@ Quick reference for agent selection:
 - [Enterprise Agentic Development](./enterprise-agentic-development.md) - Team collaboration
 - [FAQ](./faq.md) - Common questions
-- [Troubleshooting](./troubleshooting.md) - Problem resolution
 - [Glossary](./glossary.md) - Terminology reference
 ---

package/src/modules/bmm/docs/brownfield-guide.md CHANGED Viewed

@@ -12,7 +12,6 @@
 - [Quick Reference](#quick-reference) - Commands and files
 - [Common Scenarios](#common-scenarios) - Real-world examples
-- [Troubleshooting](#troubleshooting) - Problem solutions
 - [Best Practices](#best-practices) - Success tips
 ---
@@ -277,7 +276,7 @@ It's better to spend 10-30 minutes generating fresh, accurate docs than to waste
 **When to skip:** Bug fixes, well-understood features, time-sensitive changes
-See [Workflows Guide](../workflows/README.md) for details.
+See the [Workflows section in BMM README](../README.md) for details.
 ### Phase 2: Planning (Required)
@@ -336,8 +335,8 @@ flowchart TD
     CHECK -->|Yes| CREATE
     CHECK -->|No| RETRO
-    style SPRINT fill:#bfb,stroke:#333,stroke-width:2px
-    style RETRO fill:#fbf,stroke:#333,stroke-width:2px
+    style SPRINT fill:#bfb,stroke:#333,stroke-width:2px,color:#000
+    style RETRO fill:#fbf,stroke:#333,stroke-width:2px,color:#000
 ```
 **Status Progression:**
@@ -534,8 +533,6 @@ Document in tech-spec/architecture:
 ## Troubleshooting
-For complete troubleshooting, see [Troubleshooting Guide](./troubleshooting.md).
 ### AI Agents Lack Codebase Understanding
 **Symptoms:**
@@ -706,9 +703,9 @@ flowchart TD
     PRD --> IMPL
     PRD2 --> IMPL
-    style START fill:#f9f,stroke:#333,stroke-width:2px
-    style DOC fill:#ffb,stroke:#333,stroke-width:2px
-    style IMPL fill:#bfb,stroke:#333,stroke-width:2px
+    style START fill:#f9f,stroke:#333,stroke-width:2px,color:#000
+    style DOC fill:#ffb,stroke:#333,stroke-width:2px,color:#000
+    style IMPL fill:#bfb,stroke:#333,stroke-width:2px,color:#000
 ```
 ---
@@ -735,12 +732,11 @@ flowchart TD
 - **[Quick Start Guide](./quick-start.md)** - Getting started with BMM
 - **[Glossary](./glossary.md)** - Key terminology
 - **[FAQ](./faq.md)** - Common questions
-- **[Troubleshooting](./troubleshooting.md)** - Problem resolution
-- **[Workflows Guide](../workflows/README.md)** - Complete workflow reference
+- **[Workflow Documentation](./README.md#-workflow-guides)** - Complete workflow reference
 ---
-## Support & Resources
+## Support and Resources
 **Community:**
@@ -750,9 +746,8 @@ flowchart TD
 **Documentation:**
-- [BMM Workflows Guide](../workflows/README.md)
-- [Test Architect Guide](../testarch/README.md)
-- [BMM Module README](../README.md)
+- [Test Architect Guide](./test-architecture.md) - Comprehensive testing strategy
+- [BMM Module README](../README.md) - Complete module and workflow reference
 ---

package/src/modules/bmm/docs/enterprise-agentic-development.md CHANGED Viewed

@@ -9,7 +9,7 @@
 ## Table of Contents
 - [The Paradigm Shift](#the-paradigm-shift)
-- [The Evolving Role of Product Managers & UX Designers](#the-evolving-role-of-product-managers--ux-designers)
+- [The Evolving Role of Product Managers and UX Designers](#the-evolving-role-of-product-managers-and-ux-designers)
 - [How BMad Method Enables PM/UX Technical Evolution](#how-bmad-method-enables-pmux-technical-evolution)
 - [Team Collaboration Patterns](#team-collaboration-patterns)
 - [Work Distribution Strategies](#work-distribution-strategies)
@@ -59,7 +59,7 @@
 ---
-## The Evolving Role of Product Managers & UX Designers
+## The Evolving Role of Product Managers and UX Designers
 ### The Future is Now
@@ -672,7 +672,7 @@ PMs write BMad PRDs → Stories auto-fed to cloud AI agents → Parallel impleme
 - [FAQ](./faq.md) - Common questions
 - [Scale Adaptive System](./scale-adaptive-system.md) - Project levels explained
 - [Quick Start Guide](./quick-start.md) - Getting started
-- [Workflows Guide](../workflows/README.md) - Complete workflow reference
+- [Workflow Documentation](./README.md#-workflow-guides) - Complete workflow reference
 - [Agents Guide](./agents-guide.md) - Understanding BMad agents
 ---

package/src/modules/bmm/docs/faq.md CHANGED Viewed

@@ -8,11 +8,11 @@ Quick answers to common questions about the BMad Method Module.
 - [Getting Started](#getting-started)
 - [Choosing the Right Level](#choosing-the-right-level)
-- [Workflows & Phases](#workflows--phases)
+- [Workflows and Phases](#workflows-and-phases)
 - [Planning Documents](#planning-documents)
 - [Implementation](#implementation)
 - [Brownfield Development](#brownfield-development)
-- [Tools & Technical](#tools--technical)
+- [Tools and Technical](#tools-and-technical)
 ---
@@ -26,7 +26,7 @@ Quick answers to common questions about the BMad Method Module.
 - Creates the tracking status file
 - Routes you to the correct starting workflow
-For experienced users: use the [Quick Reference](./quick-start.md#quick-reference-agent--document-mapping) to go directly to the right agent/workflow.
+For experienced users: use the [Quick Reference](./quick-start.md#quick-reference-agent-document-mapping) to go directly to the right agent/workflow.
 ### Q: Why do I need fresh chats for each workflow?
@@ -108,7 +108,7 @@ The overlap (5-10 stories) is intentional. Choose based on:
 ---
-## Workflows & Phases
+## Workflows and Phases
 ### Q: What's the difference between workflow-status and workflow-init?
@@ -339,7 +339,7 @@ BMM respects your choice - it won't force modernization, but it will offer it.
 ---
-## Tools & Technical
+## Tools and Technical
 ### Q: Why are my Mermaid diagrams not rendering?
@@ -399,7 +399,7 @@ Use them together for best results.
 **Why model quality matters:** BMM workflows require LLMs that can follow multi-step processes, maintain context across phases, and implement code that adheres to specifications. Tools with weaker models will struggle with workflow adherence and code quality.
-See [IDE Setup Guides](../../../docs/ide-info/) for configuration specifics.
+See [IDE Setup Guides](https://github.com/bmad-code-org/BMAD-METHOD/tree/main/docs/ide-info) for configuration specifics.
 ### Q: Can I customize agents?
@@ -557,11 +557,10 @@ Trust your expertise - BMM supports your decisions.
 **A:**
-1. Check [Troubleshooting Guide](./troubleshooting.md) for common issues
-2. Search [Complete Documentation](./README.md) for related topics
-3. Ask in [Discord Community](https://discord.gg/gk8jAdXWmj) (#general-dev)
-4. Open a [GitHub Issue](https://github.com/bmad-code-org/BMAD-METHOD/issues)
-5. Watch [YouTube Tutorials](https://www.youtube.com/@BMadCode)
+1. Search [Complete Documentation](./README.md) for related topics
+2. Ask in [Discord Community](https://discord.gg/gk8jAdXWmj) (#general-dev)
+3. Open a [GitHub Issue](https://github.com/bmad-code-org/BMAD-METHOD/issues)
+4. Watch [YouTube Tutorials](https://www.youtube.com/@BMadCode)
 ### Q: How do I report a bug or request a feature?
@@ -580,7 +579,6 @@ Please include:
 - [Quick Start Guide](./quick-start.md) - Get started with BMM
 - [Glossary](./glossary.md) - Terminology reference
-- [Troubleshooting](./troubleshooting.md) - Problem resolution
 - [Scale Adaptive System](./scale-adaptive-system.md) - Understanding levels
 - [Brownfield Guide](./brownfield-guide.md) - Existing codebase workflows

package/src/modules/bmm/docs/glossary.md CHANGED Viewed

@@ -7,11 +7,11 @@ Comprehensive terminology reference for the BMad Method Module.
 ## Navigation
 - [Core Concepts](#core-concepts)
-- [Scale & Complexity](#scale--complexity)
+- [Scale and Complexity](#scale-and-complexity)
 - [Planning Documents](#planning-documents)
-- [Workflow & Phases](#workflow--phases)
-- [Agents & Roles](#agents--roles)
-- [Status & Tracking](#status--tracking)
+- [Workflow and Phases](#workflow-and-phases)
+- [Agents and Roles](#agents-and-roles)
+- [Status and Tracking](#status-and-tracking)
 - [Project Types](#project-types)
 - [Implementation Terms](#implementation-terms)
@@ -41,7 +41,7 @@ A multi-step guided process that orchestrates AI agent activities to produce spe
 ---
-## Scale & Complexity
+## Scale and Complexity
 ### Quick Flow Track
@@ -99,7 +99,7 @@ Game development equivalent of PRD, created by Game Designer agent for game proj
 ---
-## Workflow & Phases
+## Workflow and Phases
 ### Phase 0: Documentation (Prerequisite)
@@ -135,7 +135,7 @@ Dynamic technical guidance generated for each story via epic-tech-context and st
 ---
-## Agents & Roles
+## Agents and Roles
 ### PM (Product Manager)
@@ -183,7 +183,7 @@ Multi-agent collaboration feature where all installed agents (19+ from BMM, CIS,
 ---
-## Status & Tracking
+## Status and Tracking
 ### bmm-workflow-status.yaml
@@ -318,4 +318,3 @@ Quick Spec Flow feature that automatically detects existing code style, naming c
 - [Brownfield Guide](./brownfield-guide.md) - Working with existing codebases
 - [Quick Spec Flow](./quick-spec-flow.md) - Fast-track for Quick Flow track
 - [FAQ](./faq.md) - Common questions
-- [Troubleshooting](./troubleshooting.md) - Problem resolution

package/src/modules/bmm/docs/quick-spec-flow.md CHANGED Viewed

@@ -60,10 +60,10 @@ flowchart TD
     STORIES --> IMPL
     IMPL --> DONE
-    style START fill:#bfb,stroke:#333,stroke-width:2px
-    style OPTIONAL fill:#ffb,stroke:#333,stroke-width:2px,stroke-dasharray: 5 5
-    style IMPL fill:#bbf,stroke:#333,stroke-width:2px
-    style DONE fill:#f9f,stroke:#333,stroke-width:3px
+    style START fill:#bfb,stroke:#333,stroke-width:2px,color:#000
+    style OPTIONAL fill:#ffb,stroke:#333,stroke-width:2px,stroke-dasharray: 5 5,color:#000
+    style IMPL fill:#bbf,stroke:#333,stroke-width:2px,color:#000
+    style DONE fill:#f9f,stroke:#333,stroke-width:3px,color:#000
 ```
 ---
@@ -277,7 +277,7 @@ For user-facing changes, Quick Spec Flow captures:
 ---
-## Auto-Validation & Quality Assurance
+## Auto-Validation and Quality Assurance
 Quick Spec Flow **automatically validates** everything:
@@ -543,7 +543,7 @@ Quick Spec Flow is **fully standalone**:
 ---
-## Tips & Best Practices
+## Tips and Best Practices
 ### 1. **Be Specific in Discovery**
@@ -643,7 +643,7 @@ Quick Spec Flow is your **fast path from idea to implementation** for:
 ## Next Steps
 - **Try it now:** Load PM agent and describe a small change
-- **Learn more:** See `src/modules/bmm/workflows/README.md` for full BMM workflow guide
+- **Learn more:** See the [BMM Workflow Guides](./README.md#-workflow-guides) for comprehensive workflow documentation
 - **Need help deciding?** Run `workflow-init` to get a recommendation
 - **Have questions?** Join us on Discord: https://discord.gg/gk8jAdXWmj

package/src/modules/bmm/docs/quick-start.md CHANGED Viewed

@@ -37,9 +37,9 @@ The interactive installer will guide you through setup and create a `bmad/` fold
 ### Step 1: Initialize Your Workflow
-1. **Load the Analyst agent** in your IDE - See your IDE-specific instructions in [docs/ide-info](../docs/ide-info/) for how to activate agents:
-   - [Claude Code](../docs/ide-info/claude-code.md)
-   - [VS Code/Cursor/Windsurf](../docs/ide-info/) - Check your IDE folder
+1. **Load the Analyst agent** in your IDE - See your IDE-specific instructions in [docs/ide-info](https://github.com/bmad-code-org/BMAD-METHOD/tree/main/docs/ide-info) for how to activate agents:
+   - [Claude Code](https://github.com/bmad-code-org/BMAD-METHOD/blob/main/docs/ide-info/claude-code.md)
+   - [VS Code/Cursor/Windsurf](https://github.com/bmad-code-org/BMAD-METHOD/tree/main/docs/ide-info) - Check your IDE folder
    - Other IDEs also supported
 2. **Wait for the agent's menu** to appear
 3. **Tell the agent**: "Run workflow-init" or type "\*workflow-init" or select the menu item number
@@ -107,7 +107,7 @@ The next TRULY REQUIRED step is:
 When an agent tells you to run a workflow (like `prd`):
-1. **Start a new chat** with the specified agent (e.g., PM) - See [docs/ide-info](../docs/ide-info/) for your IDE's specific instructions
+1. **Start a new chat** with the specified agent (e.g., PM) - See [docs/ide-info](https://github.com/bmad-code-org/BMAD-METHOD/tree/main/docs/ide-info) for your IDE's specific instructions
 2. **Wait for the menu** to appear
 3. **Tell the agent** to run it using any of these formats:
    - Type the shorthand: `*prd`
@@ -323,10 +323,10 @@ flowchart LR
     P2 --> P3
     P3 --> P4
-    style P1 fill:#bbf,stroke:#333,stroke-width:2px
-    style P2 fill:#bfb,stroke:#333,stroke-width:2px
-    style P3 fill:#ffb,stroke:#333,stroke-width:2px
-    style P4 fill:#fbf,stroke:#333,stroke-width:2px
+    style P1 fill:#bbf,stroke:#333,stroke-width:2px,color:#000
+    style P2 fill:#bfb,stroke:#333,stroke-width:2px,color:#000
+    style P3 fill:#ffb,stroke:#333,stroke-width:2px,color:#000
+    style P4 fill:#fbf,stroke:#333,stroke-width:2px,color:#000
 ```
 ## Common Questions
@@ -350,7 +350,7 @@ A: Yes, once you learn the flow. Use the Quick Reference in Step 2 to go directl
 - **During workflows**: Agents guide you with questions and explanations
 - **Community**: [Discord](https://discord.gg/gk8jAdXWmj) - #general-dev, #bugs-issues
-- **Complete guide**: [BMM Workflows README](../src/modules/bmm/workflows/README.md)
+- **Complete guide**: [BMM Workflow Documentation](./README.md#-workflow-guides)
 - **YouTube tutorials**: [BMad Code Channel](https://www.youtube.com/@BMadCode)
 ---

package/src/modules/bmm/docs/scale-adaptive-system.md CHANGED Viewed

@@ -51,9 +51,9 @@ flowchart TD
     Q1 -->|Yes| QF[Quick Flow<br/>Tech-spec only]
     Q1 -->|Uncertain| M
-    style QF fill:#bfb,stroke:#333,stroke-width:2px
-    style M fill:#bbf,stroke:#333,stroke-width:2px
-    style E fill:#f9f,stroke:#333,stroke-width:2px
+    style QF fill:#bfb,stroke:#333,stroke-width:2px,color:#000
+    style M fill:#bbf,stroke:#333,stroke-width:2px,color:#000
+    style E fill:#f9f,stroke:#333,stroke-width:2px,color:#000
 ```
 ### Quick Keywords
@@ -389,8 +389,8 @@ flowchart TD
     TRACK -->|Method| M[PRD + Arch]
     TRACK -->|Enterprise| E[PRD + Arch + Sec/Ops]
-    style DOC fill:#ffb,stroke:#333,stroke-width:2px
-    style TRACK fill:#bfb,stroke:#333,stroke-width:2px
+    style DOC fill:#ffb,stroke:#333,stroke-width:2px,color:#000
+    style TRACK fill:#bfb,stroke:#333,stroke-width:2px,color:#000
 ```
 ---
@@ -592,7 +592,7 @@ Run `workflow-init` on existing projects to migrate to new tracking system. It d
 - **[Brownfield Guide](./brownfield-guide.md)** - Existing codebase workflows
 - **[Glossary](./glossary.md)** - Complete terminology
 - **[FAQ](./faq.md)** - Common questions
-- **[Workflows Guide](../workflows/README.md)** - Complete workflow reference
+- **[Workflows Guide](./README.md#-workflow-guides)** - Complete workflow reference
 ---