Compare commits

..

3 Commits

Author SHA1 Message Date
github-actions[bot]
349adc1c06 release: bump to v4.41.0 2025-08-25 22:52:32 +00:00
Kayvan Sylvan
a900d28080 chore: update project dependencies and development tooling (#508)
- Update various direct and transitive project dependencies.
- Remove the circular `bmad-method` self-dependency.
- Upgrade ESLint, Prettier, Jest, and other dev tools.
- Update semantic-release and related GitHub packages.

Co-authored-by: Kayvan Sylvan <kayvan@meanwhile.bm>
2025-08-24 21:45:18 -05:00
circus
ab70baca59 fix: remove incorrect else branch causing flatten command regression (#452)
This fixes a regression bug where the flatten command would fail with an
error message even when valid arguments were provided.

The bug was:
- First introduced in commit 0fdbca7
- Fixed in commit fab9d5e (v5.0.0-beta.2)
- Accidentally reintroduced in commit ed53943

The else branch at lines 130-134 was incorrectly handling the case when
users provided arguments, showing a misleading error about
'no arguments provided' when arguments were actually present.

Fixes all flatten command variations:
- npx bmad-method flatten
- npx bmad-method flatten --input /path
- npx bmad-method flatten --output file.xml
- npx bmad-method flatten --input /path --output file.xml

Co-authored-by: Brian <bmadcode@gmail.com>
2025-08-17 22:09:56 -05:00
57 changed files with 2131 additions and 1526 deletions

2
.gitignore vendored
View File

@@ -38,7 +38,7 @@ CLAUDE.md
.gemini
# Project-specific
bmad-core
.bmad-core
.bmad-creator-tools
test-project-install/*
sample-project/*

View File

@@ -555,7 +555,7 @@
- add docs ([48ef875](https://github.com/bmadcode/BMAD-METHOD/commit/48ef875f5ec5b0f0211baa43bbc04701e54824f4))
- auto semantic versioning fix ([166ed04](https://github.com/bmadcode/BMAD-METHOD/commit/166ed047671cccab2874fd327efb1ac293ae7276))
- auto semantic versioning fix again ([11260e4](https://github.com/bmadcode/BMAD-METHOD/commit/11260e43950b6bf78d68c759dc3ac278bc13f8a8))
- BMAD install creates `bmad-core/bmad-core/` directory structure + updates ([#223](https://github.com/bmadcode/BMAD-METHOD/issues/223)) ([28b313c](https://github.com/bmadcode/BMAD-METHOD/commit/28b313c01df41961cebb71fb3bce0fcc7b4b4796))
- BMAD install creates `.bmad-core/.bmad-core/` directory structure + updates ([#223](https://github.com/bmadcode/BMAD-METHOD/issues/223)) ([28b313c](https://github.com/bmadcode/BMAD-METHOD/commit/28b313c01df41961cebb71fb3bce0fcc7b4b4796))
- resolve NPM token configuration ([620b09a](https://github.com/bmadcode/BMAD-METHOD/commit/620b09a556ce8d61ad1a4d8ee7c523d263abd69c))
- resolve NPM token configuration ([b447a8b](https://github.com/bmadcode/BMAD-METHOD/commit/b447a8bd57625d02692d7e2771241bacd120c631))
- update dependency resolver to support both yml and yaml code blocks ([ba1e5ce](https://github.com/bmadcode/BMAD-METHOD/commit/ba1e5ceb36f4a0bb204ceee40e92725d3fc57c5f))

View File

@@ -107,7 +107,7 @@ npx bmad-method install
**Verify Installation**:
- `bmad-core/` folder created with all agents
- `.bmad-core/` folder created with all agents
- IDE-specific integration files created
- All agent commands/rules/modes available

View File

@@ -10,7 +10,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
### 0. Load Core Configuration and Inputs
- Load `bmad-core/core-config.yaml`
- Load `.bmad-core/core-config.yaml`
- If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story validation."
- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`
- Identify and load the following inputs:

View File

@@ -17,7 +17,7 @@ When this task is invoked:
## Critical: Template Discovery
If a YAML Template has not been provided, list all templates from bmad-core/templates or ask the user to provide another.
If a YAML Template has not been provided, list all templates from .bmad-core/templates or ask the user to provide another.
## CRITICAL: Mandatory Elicitation Format

View File

@@ -8,13 +8,13 @@ You are now operating as a specialized AI agent from the BMad-Method framework.
2. **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
- `==================== START: bmad-core/folder/filename.md ====================`
- `==================== END: bmad-core/folder/filename.md ====================`
- `==================== START: .bmad-core/folder/filename.md ====================`
- `==================== END: .bmad-core/folder/filename.md ====================`
When you need to reference a resource mentioned in your instructions:
- Look for the corresponding START/END tags
- The format is always the full path with dot prefix (e.g., `bmad-core/personas/analyst.md`, `bmad-core/tasks/create-story.md`)
- The format is always the full path with dot prefix (e.g., `.bmad-core/personas/analyst.md`, `.bmad-core/tasks/create-story.md`)
- If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
**Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
@@ -29,8 +29,8 @@ dependencies:
These references map directly to bundle sections:
- `utils: template-format` → Look for `==================== START: bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: bmad-core/tasks/create-story.md ====================`
- `utils: template-format` → Look for `==================== START: .bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: .bmad-core/tasks/create-story.md ====================`
3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
@@ -39,7 +39,7 @@ These references map directly to bundle sections:
---
==================== START: bmad-core/agents/analyst.md ====================
==================== START: .bmad-core/agents/analyst.md ====================
# analyst
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -101,10 +101,11 @@ dependencies:
- market-research-tmpl.yaml
- project-brief-tmpl.yaml
```
==================== END: bmad-core/agents/analyst.md ====================
==================== END: .bmad-core/agents/analyst.md ====================
==================== START: bmad-core/tasks/advanced-elicitation.md ====================
==================== START: .bmad-core/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -222,10 +223,11 @@ Choose a number (0-8) or 9 to proceed:
- **Stay Relevant**: Tie all elicitation back to the specific content being analyzed
- **Identify Personas**: For multi-persona methods, clearly identify which viewpoint is speaking
- **Maintain Flow**: Keep the process moving efficiently
==================== END: bmad-core/tasks/advanced-elicitation.md ====================
==================== END: .bmad-core/tasks/advanced-elicitation.md ====================
==================== START: bmad-core/tasks/create-deep-research-prompt.md ====================
==================== START: .bmad-core/tasks/create-deep-research-prompt.md ====================
<!-- Powered by BMAD™ Core -->
# Create Deep Research Prompt Task
This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation.
@@ -504,10 +506,11 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
- Balance comprehensiveness with focus
- Document assumptions and limitations clearly
- Plan for iterative refinement based on initial findings
==================== END: bmad-core/tasks/create-deep-research-prompt.md ====================
==================== END: .bmad-core/tasks/create-deep-research-prompt.md ====================
==================== START: bmad-core/tasks/create-doc.md ====================
==================== START: .bmad-core/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -525,7 +528,7 @@ When this task is invoked:
## Critical: Template Discovery
If a YAML Template has not been provided, list all templates from bmad-core/templates or ask the user to provide another.
If a YAML Template has not been provided, list all templates from .bmad-core/templates or ask the user to provide another.
## CRITICAL: Mandatory Elicitation Format
@@ -609,10 +612,11 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
- Select options 2-9 from data/elicitation-methods only
- Provide detailed rationale explaining decisions
- End with "Select 1-9 or just type your question/feedback:"
==================== END: bmad-core/tasks/create-doc.md ====================
==================== END: .bmad-core/tasks/create-doc.md ====================
==================== START: bmad-core/tasks/document-project.md ====================
==================== START: .bmad-core/tasks/document-project.md ====================
<!-- Powered by BMAD™ Core -->
# Document an Existing Project
## Purpose
@@ -956,13 +960,14 @@ Apply the advanced elicitation task after major sections to refine based on user
- Documents technical debt, workarounds, and constraints honestly
- For brownfield projects with PRD: Provides clear enhancement impact analysis
- The goal is PRACTICAL documentation for AI agents doing real work
==================== END: bmad-core/tasks/document-project.md ====================
==================== END: .bmad-core/tasks/document-project.md ====================
==================== START: .bmad-core/tasks/facilitate-brainstorming-session.md ====================
## <!-- Powered by BMAD™ Core -->
==================== START: bmad-core/tasks/facilitate-brainstorming-session.md ====================
<!-- Powered by BMAD™ Core -->
---
docOutputLocation: docs/brainstorming-session-results.md
template: 'bmad-core/templates/brainstorming-output-tmpl.yaml'
template: '.bmad-core/templates/brainstorming-output-tmpl.yaml'
---
# Facilitate Brainstorming Session Task
@@ -1096,9 +1101,9 @@ Generate structured document with these sections:
- Always ask before switching techniques: "Ready to try a different approach?"
- Offer options: "Should we explore this idea deeper or generate more alternatives?"
- Respect their process and timing
==================== END: bmad-core/tasks/facilitate-brainstorming-session.md ====================
==================== END: .bmad-core/tasks/facilitate-brainstorming-session.md ====================
==================== START: bmad-core/templates/brainstorming-output-tmpl.yaml ====================
==================== START: .bmad-core/templates/brainstorming-output-tmpl.yaml ====================
template:
id: brainstorming-output-template-v2
name: Brainstorming Session Results
@@ -1255,9 +1260,9 @@ sections:
---
*Session facilitated using the BMAD-METHOD™ brainstorming framework*
==================== END: bmad-core/templates/brainstorming-output-tmpl.yaml ====================
==================== END: .bmad-core/templates/brainstorming-output-tmpl.yaml ====================
==================== START: bmad-core/templates/competitor-analysis-tmpl.yaml ====================
==================== START: .bmad-core/templates/competitor-analysis-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: competitor-analysis-template-v2
@@ -1565,9 +1570,9 @@ sections:
- Weekly: {{weekly_items}}
- Monthly: {{monthly_items}}
- Quarterly: {{quarterly_analysis}}
==================== END: bmad-core/templates/competitor-analysis-tmpl.yaml ====================
==================== END: .bmad-core/templates/competitor-analysis-tmpl.yaml ====================
==================== START: bmad-core/templates/market-research-tmpl.yaml ====================
==================== START: .bmad-core/templates/market-research-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: market-research-template-v2
@@ -1821,9 +1826,9 @@ sections:
- id: additional-analysis
title: C. Additional Analysis
instruction: Any supplementary analysis not included in main body
==================== END: bmad-core/templates/market-research-tmpl.yaml ====================
==================== END: .bmad-core/templates/market-research-tmpl.yaml ====================
==================== START: bmad-core/templates/project-brief-tmpl.yaml ====================
==================== START: .bmad-core/templates/project-brief-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: project-brief-template-v2
@@ -2046,10 +2051,11 @@ sections:
title: PM Handoff
content: |
This Project Brief provides the full context for {{project_name}}. Please start in 'PRD Generation Mode', review the brief thoroughly to work with the user to create the PRD section by section as the template indicates, asking for any necessary clarification or suggesting improvements.
==================== END: bmad-core/templates/project-brief-tmpl.yaml ====================
==================== END: .bmad-core/templates/project-brief-tmpl.yaml ====================
==================== START: bmad-core/data/bmad-kb.md ====================
==================== START: .bmad-core/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMAD™ Knowledge Base
## Overview
@@ -2157,7 +2163,7 @@ npx bmad-method install
**Verify Installation**:
- `bmad-core/` folder created with all agents
- `.bmad-core/` folder created with all agents
- IDE-specific integration files created
- All agent commands/rules/modes available
@@ -2856,10 +2862,11 @@ Use the **expansion-creator** pack to build your own:
- **Documentation**: Check `docs/` folder for project-specific context
- **Community**: Discord and GitHub resources available for support
- **Contributing**: See `CONTRIBUTING.md` for full guidelines
==================== END: bmad-core/data/bmad-kb.md ====================
==================== END: .bmad-core/data/bmad-kb.md ====================
==================== START: bmad-core/data/brainstorming-techniques.md ====================
==================== START: .bmad-core/data/brainstorming-techniques.md ====================
<!-- Powered by BMAD™ Core -->
# Brainstorming Techniques Data
## Creative Expansion
@@ -2896,4 +2903,4 @@ Use the **expansion-creator** pack to build your own:
18. **Resource Constraints**: "What if you had only $10 and 1 hour?"
19. **Metaphor Mapping**: Use extended metaphors to explore solutions
20. **Question Storming**: Generate questions instead of answers first
==================== END: bmad-core/data/brainstorming-techniques.md ====================
==================== END: .bmad-core/data/brainstorming-techniques.md ====================

View File

@@ -8,13 +8,13 @@ You are now operating as a specialized AI agent from the BMad-Method framework.
2. **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
- `==================== START: bmad-core/folder/filename.md ====================`
- `==================== END: bmad-core/folder/filename.md ====================`
- `==================== START: .bmad-core/folder/filename.md ====================`
- `==================== END: .bmad-core/folder/filename.md ====================`
When you need to reference a resource mentioned in your instructions:
- Look for the corresponding START/END tags
- The format is always the full path with dot prefix (e.g., `bmad-core/personas/analyst.md`, `bmad-core/tasks/create-story.md`)
- The format is always the full path with dot prefix (e.g., `.bmad-core/personas/analyst.md`, `.bmad-core/tasks/create-story.md`)
- If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
**Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
@@ -29,8 +29,8 @@ dependencies:
These references map directly to bundle sections:
- `utils: template-format` → Look for `==================== START: bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: bmad-core/tasks/create-story.md ====================`
- `utils: template-format` → Look for `==================== START: .bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: .bmad-core/tasks/create-story.md ====================`
3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
@@ -39,7 +39,7 @@ These references map directly to bundle sections:
---
==================== START: bmad-core/agents/architect.md ====================
==================== START: .bmad-core/agents/architect.md ====================
# architect
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -102,10 +102,11 @@ dependencies:
- front-end-architecture-tmpl.yaml
- fullstack-architecture-tmpl.yaml
```
==================== END: bmad-core/agents/architect.md ====================
==================== END: .bmad-core/agents/architect.md ====================
==================== START: bmad-core/tasks/create-deep-research-prompt.md ====================
==================== START: .bmad-core/tasks/create-deep-research-prompt.md ====================
<!-- Powered by BMAD™ Core -->
# Create Deep Research Prompt Task
This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation.
@@ -384,10 +385,11 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
- Balance comprehensiveness with focus
- Document assumptions and limitations clearly
- Plan for iterative refinement based on initial findings
==================== END: bmad-core/tasks/create-deep-research-prompt.md ====================
==================== END: .bmad-core/tasks/create-deep-research-prompt.md ====================
==================== START: bmad-core/tasks/create-doc.md ====================
==================== START: .bmad-core/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -405,7 +407,7 @@ When this task is invoked:
## Critical: Template Discovery
If a YAML Template has not been provided, list all templates from bmad-core/templates or ask the user to provide another.
If a YAML Template has not been provided, list all templates from .bmad-core/templates or ask the user to provide another.
## CRITICAL: Mandatory Elicitation Format
@@ -489,10 +491,11 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
- Select options 2-9 from data/elicitation-methods only
- Provide detailed rationale explaining decisions
- End with "Select 1-9 or just type your question/feedback:"
==================== END: bmad-core/tasks/create-doc.md ====================
==================== END: .bmad-core/tasks/create-doc.md ====================
==================== START: bmad-core/tasks/document-project.md ====================
==================== START: .bmad-core/tasks/document-project.md ====================
<!-- Powered by BMAD™ Core -->
# Document an Existing Project
## Purpose
@@ -836,17 +839,18 @@ Apply the advanced elicitation task after major sections to refine based on user
- Documents technical debt, workarounds, and constraints honestly
- For brownfield projects with PRD: Provides clear enhancement impact analysis
- The goal is PRACTICAL documentation for AI agents doing real work
==================== END: bmad-core/tasks/document-project.md ====================
==================== END: .bmad-core/tasks/document-project.md ====================
==================== START: bmad-core/tasks/execute-checklist.md ====================
==================== START: .bmad-core/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
## Available Checklists
If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the bmad-core/checklists folder to select the appropriate one to run.
If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the .bmad-core/checklists folder to select the appropriate one to run.
## Instructions
@@ -854,7 +858,7 @@ If the user asks or does not specify a specific checklist, list the checklists a
- If user or the task being run provides a checklist name:
- Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
- If multiple matches found, ask user to clarify
- Load the appropriate checklist from bmad-core/checklists/
- Load the appropriate checklist from .bmad-core/checklists/
- If no checklist specified:
- Ask the user which checklist they want to use
- Present the available options from the files in the checklists folder
@@ -926,9 +930,9 @@ The LLM will:
- Execute the complete checklist validation
- Present a final report with pass/fail rates and key findings
- Offer to provide detailed analysis of any section, especially those with warnings or failures
==================== END: bmad-core/tasks/execute-checklist.md ====================
==================== END: .bmad-core/tasks/execute-checklist.md ====================
==================== START: bmad-core/templates/architecture-tmpl.yaml ====================
==================== START: .bmad-core/templates/architecture-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: architecture-template-v2
@@ -1059,7 +1063,7 @@ sections:
instruction: |
This is the DEFINITIVE technology selection section. Work with the user to make specific choices:
1. Review PRD technical assumptions and any preferences from bmad-core/data/technical-preferences.yaml or an attached technical-preferences
1. Review PRD technical assumptions and any preferences from .bmad-core/data/technical-preferences.yaml or an attached technical-preferences
2. For each category, present 2-3 viable options with pros/cons
3. Make a clear recommendation based on project needs
4. Get explicit user approval for each selection
@@ -1580,9 +1584,9 @@ sections:
- Key UI requirements from PRD
- Any frontend-specific decisions made here
- Request for detailed frontend architecture
==================== END: bmad-core/templates/architecture-tmpl.yaml ====================
==================== END: .bmad-core/templates/architecture-tmpl.yaml ====================
==================== START: bmad-core/templates/brownfield-architecture-tmpl.yaml ====================
==================== START: .bmad-core/templates/brownfield-architecture-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: brownfield-architecture-template-v2
@@ -2060,9 +2064,9 @@ sections:
- Key technical decisions based on real project constraints
- Existing system compatibility requirements with specific verification steps
- Clear sequencing of implementation to minimize risk to existing functionality
==================== END: bmad-core/templates/brownfield-architecture-tmpl.yaml ====================
==================== END: .bmad-core/templates/brownfield-architecture-tmpl.yaml ====================
==================== START: bmad-core/templates/front-end-architecture-tmpl.yaml ====================
==================== START: .bmad-core/templates/front-end-architecture-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: frontend-architecture-template-v2
@@ -2282,9 +2286,9 @@ sections:
- Key import patterns
- File naming conventions
- Project-specific patterns and utilities
==================== END: bmad-core/templates/front-end-architecture-tmpl.yaml ====================
==================== END: .bmad-core/templates/front-end-architecture-tmpl.yaml ====================
==================== START: bmad-core/templates/fullstack-architecture-tmpl.yaml ====================
==================== START: .bmad-core/templates/fullstack-architecture-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: fullstack-architecture-template-v2
@@ -3109,10 +3113,11 @@ sections:
- id: checklist-results
title: Checklist Results Report
instruction: Before running the checklist, offer to output the full architecture document. Once user confirms, execute the architect-checklist and populate results here.
==================== END: bmad-core/templates/fullstack-architecture-tmpl.yaml ====================
==================== END: .bmad-core/templates/fullstack-architecture-tmpl.yaml ====================
==================== START: bmad-core/checklists/architect-checklist.md ====================
==================== START: .bmad-core/checklists/architect-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Architect Solution Validation Checklist
This checklist serves as a comprehensive framework for the Architect to validate the technical design and architecture before development execution. The Architect should systematically work through each item, ensuring the architecture is robust, scalable, secure, and aligned with the product requirements.
@@ -3551,11 +3556,12 @@ Now that you've completed the checklist, generate a comprehensive validation rep
- Component design clarity
After presenting the report, ask the user if they would like detailed analysis of any specific section, especially those with warnings or failures.]]
==================== END: bmad-core/checklists/architect-checklist.md ====================
==================== END: .bmad-core/checklists/architect-checklist.md ====================
==================== START: bmad-core/data/technical-preferences.md ====================
==================== START: .bmad-core/data/technical-preferences.md ====================
<!-- Powered by BMAD™ Core -->
# User-Defined Preferred Patterns and Preferences
None Listed
==================== END: bmad-core/data/technical-preferences.md ====================
==================== END: .bmad-core/data/technical-preferences.md ====================

View File

@@ -8,13 +8,13 @@ You are now operating as a specialized AI agent from the BMad-Method framework.
2. **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
- `==================== START: bmad-core/folder/filename.md ====================`
- `==================== END: bmad-core/folder/filename.md ====================`
- `==================== START: .bmad-core/folder/filename.md ====================`
- `==================== END: .bmad-core/folder/filename.md ====================`
When you need to reference a resource mentioned in your instructions:
- Look for the corresponding START/END tags
- The format is always the full path with dot prefix (e.g., `bmad-core/personas/analyst.md`, `bmad-core/tasks/create-story.md`)
- The format is always the full path with dot prefix (e.g., `.bmad-core/personas/analyst.md`, `.bmad-core/tasks/create-story.md`)
- If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
**Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
@@ -29,8 +29,8 @@ dependencies:
These references map directly to bundle sections:
- `utils: template-format` → Look for `==================== START: bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: bmad-core/tasks/create-story.md ====================`
- `utils: template-format` → Look for `==================== START: .bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: .bmad-core/tasks/create-story.md ====================`
3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
@@ -39,7 +39,7 @@ These references map directly to bundle sections:
---
==================== START: bmad-core/agents/bmad-master.md ====================
==================== START: .bmad-core/agents/bmad-master.md ====================
# bmad-master
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -72,7 +72,7 @@ commands:
- doc-out: Output full document to current destination file
- document-project: execute the task document-project.md
- execute-checklist {checklist}: Run task execute-checklist (no checklist = ONLY show available checklists listed under dependencies/checklist below)
- kb: Toggle KB mode off (default) or on, when on will load and reference the bmad-core/data/bmad-kb.md and converse with the user answering his questions with this informational resource
- kb: Toggle KB mode off (default) or on, when on will load and reference the .bmad-core/data/bmad-kb.md and converse with the user answering his questions with this informational resource
- shard-doc {document} {destination}: run the task shard-doc against the optionally provided document to the specified destination
- task {task}: Execute task, if not found or none specified, ONLY list available dependencies/tasks listed below
- yolo: Toggle Yolo Mode
@@ -124,10 +124,11 @@ dependencies:
- greenfield-service.md
- greenfield-ui.md
```
==================== END: bmad-core/agents/bmad-master.md ====================
==================== END: .bmad-core/agents/bmad-master.md ====================
==================== START: bmad-core/tasks/advanced-elicitation.md ====================
==================== START: .bmad-core/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -245,10 +246,11 @@ Choose a number (0-8) or 9 to proceed:
- **Stay Relevant**: Tie all elicitation back to the specific content being analyzed
- **Identify Personas**: For multi-persona methods, clearly identify which viewpoint is speaking
- **Maintain Flow**: Keep the process moving efficiently
==================== END: bmad-core/tasks/advanced-elicitation.md ====================
==================== END: .bmad-core/tasks/advanced-elicitation.md ====================
==================== START: bmad-core/tasks/brownfield-create-epic.md ====================
==================== START: .bmad-core/tasks/brownfield-create-epic.md ====================
<!-- Powered by BMAD™ Core -->
# Create Brownfield Epic Task
## Purpose
@@ -409,10 +411,11 @@ The epic creation is successful when:
- If the scope grows beyond 3 stories, consider the full brownfield PRD process
- Always prioritize existing system integrity over new functionality
- When in doubt about scope or complexity, escalate to full brownfield planning
==================== END: bmad-core/tasks/brownfield-create-epic.md ====================
==================== END: .bmad-core/tasks/brownfield-create-epic.md ====================
==================== START: bmad-core/tasks/brownfield-create-story.md ====================
==================== START: .bmad-core/tasks/brownfield-create-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Brownfield Story Task
## Purpose
@@ -560,15 +563,16 @@ The story creation is successful when:
- Always prioritize existing system integrity
- When in doubt about integration complexity, use brownfield-create-epic instead
- Stories should take no more than 4 hours of focused development work
==================== END: bmad-core/tasks/brownfield-create-story.md ====================
==================== END: .bmad-core/tasks/brownfield-create-story.md ====================
==================== START: bmad-core/tasks/correct-course.md ====================
==================== START: .bmad-core/tasks/correct-course.md ====================
<!-- Powered by BMAD™ Core -->
# Correct Course Task
## Purpose
- Guide a structured response to a change trigger using the `bmad-core/checklists/change-checklist`.
- Guide a structured response to a change trigger using the `.bmad-core/checklists/change-checklist`.
- Analyze the impacts of the change on epics, project artifacts, and the MVP, guided by the checklist's structure.
- Explore potential solutions (e.g., adjust scope, rollback elements, re-scope features) as prompted by the checklist.
- Draft specific, actionable proposed updates to any affected project artifacts (e.g., epics, user stories, PRD sections, architecture document sections) based on the analysis.
@@ -582,7 +586,7 @@ The story creation is successful when:
- **Acknowledge Task & Inputs:**
- Confirm with the user that the "Correct Course Task" (Change Navigation & Integration) is being initiated.
- Verify the change trigger and ensure you have the user's initial explanation of the issue and its perceived impact.
- Confirm access to all relevant project artifacts (e.g., PRD, Epics/Stories, Architecture Documents, UI/UX Specifications) and, critically, the `bmad-core/checklists/change-checklist`.
- Confirm access to all relevant project artifacts (e.g., PRD, Epics/Stories, Architecture Documents, UI/UX Specifications) and, critically, the `.bmad-core/checklists/change-checklist`.
- **Establish Interaction Mode:**
- Ask the user their preferred interaction mode for this task:
- **"Incrementally (Default & Recommended):** Shall we work through the change-checklist section by section, discussing findings and collaboratively drafting proposed changes for each relevant part before moving to the next? This allows for detailed, step-by-step refinement."
@@ -634,10 +638,11 @@ The story creation is successful when:
- A summary of the change-checklist analysis (issue, impact, rationale for the chosen path).
- Specific, clearly drafted proposed edits for all affected project artifacts.
- **Implicit:** An annotated change-checklist (or the record of its completion) reflecting the discussions, findings, and decisions made during the process.
==================== END: bmad-core/tasks/correct-course.md ====================
==================== END: .bmad-core/tasks/correct-course.md ====================
==================== START: bmad-core/tasks/create-deep-research-prompt.md ====================
==================== START: .bmad-core/tasks/create-deep-research-prompt.md ====================
<!-- Powered by BMAD™ Core -->
# Create Deep Research Prompt Task
This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation.
@@ -916,10 +921,11 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
- Balance comprehensiveness with focus
- Document assumptions and limitations clearly
- Plan for iterative refinement based on initial findings
==================== END: bmad-core/tasks/create-deep-research-prompt.md ====================
==================== END: .bmad-core/tasks/create-deep-research-prompt.md ====================
==================== START: bmad-core/tasks/create-doc.md ====================
==================== START: .bmad-core/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -937,7 +943,7 @@ When this task is invoked:
## Critical: Template Discovery
If a YAML Template has not been provided, list all templates from bmad-core/templates or ask the user to provide another.
If a YAML Template has not been provided, list all templates from .bmad-core/templates or ask the user to provide another.
## CRITICAL: Mandatory Elicitation Format
@@ -1021,10 +1027,11 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
- Select options 2-9 from data/elicitation-methods only
- Provide detailed rationale explaining decisions
- End with "Select 1-9 or just type your question/feedback:"
==================== END: bmad-core/tasks/create-doc.md ====================
==================== END: .bmad-core/tasks/create-doc.md ====================
==================== START: bmad-core/tasks/create-next-story.md ====================
==================== START: .bmad-core/tasks/create-next-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Next Story Task
## Purpose
@@ -1035,7 +1042,7 @@ To identify the next logical story based on project progress and epic definition
### 0. Load Core Configuration and Check Workflow
- Load `bmad-core/core-config.yaml` from the project root
- Load `.bmad-core/core-config.yaml` from the project root
- If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story creation. You can either: 1) Copy it from GITHUB bmad-core/core-config.yaml and configure it for your project OR 2) Run the BMad installer against your project to upgrade and add the file automatically. Please add and configure core-config.yaml before proceeding."
- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`, `workflow.*`
@@ -1129,18 +1136,19 @@ ALWAYS cite source documents: `[Source: architecture/{filename}.md#{section}]`
- Verify all source references are included for technical details
- Ensure tasks align with both epic requirements and architecture constraints
- Update status to "Draft" and save the story file
- Execute `bmad-core/tasks/execute-checklist` `bmad-core/checklists/story-draft-checklist`
- Execute `.bmad-core/tasks/execute-checklist` `.bmad-core/checklists/story-draft-checklist`
- Provide summary to user including:
- Story created: `{devStoryLocation}/{epicNum}.{storyNum}.story.md`
- Status: Draft
- Key technical components included from architecture docs
- Any deviations or conflicts noted between epic and architecture
- Checklist Results
- Next steps: For Complex stories, suggest the user carefully review the story draft and also optionally have the PO run the task `bmad-core/tasks/validate-next-story`
==================== END: bmad-core/tasks/create-next-story.md ====================
- Next steps: For Complex stories, suggest the user carefully review the story draft and also optionally have the PO run the task `.bmad-core/tasks/validate-next-story`
==================== END: .bmad-core/tasks/create-next-story.md ====================
==================== START: bmad-core/tasks/document-project.md ====================
==================== START: .bmad-core/tasks/document-project.md ====================
<!-- Powered by BMAD™ Core -->
# Document an Existing Project
## Purpose
@@ -1484,17 +1492,18 @@ Apply the advanced elicitation task after major sections to refine based on user
- Documents technical debt, workarounds, and constraints honestly
- For brownfield projects with PRD: Provides clear enhancement impact analysis
- The goal is PRACTICAL documentation for AI agents doing real work
==================== END: bmad-core/tasks/document-project.md ====================
==================== END: .bmad-core/tasks/document-project.md ====================
==================== START: bmad-core/tasks/execute-checklist.md ====================
==================== START: .bmad-core/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
## Available Checklists
If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the bmad-core/checklists folder to select the appropriate one to run.
If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the .bmad-core/checklists folder to select the appropriate one to run.
## Instructions
@@ -1502,7 +1511,7 @@ If the user asks or does not specify a specific checklist, list the checklists a
- If user or the task being run provides a checklist name:
- Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
- If multiple matches found, ask user to clarify
- Load the appropriate checklist from bmad-core/checklists/
- Load the appropriate checklist from .bmad-core/checklists/
- If no checklist specified:
- Ask the user which checklist they want to use
- Present the available options from the files in the checklists folder
@@ -1574,13 +1583,14 @@ The LLM will:
- Execute the complete checklist validation
- Present a final report with pass/fail rates and key findings
- Offer to provide detailed analysis of any section, especially those with warnings or failures
==================== END: bmad-core/tasks/execute-checklist.md ====================
==================== END: .bmad-core/tasks/execute-checklist.md ====================
==================== START: .bmad-core/tasks/facilitate-brainstorming-session.md ====================
## <!-- Powered by BMAD™ Core -->
==================== START: bmad-core/tasks/facilitate-brainstorming-session.md ====================
<!-- Powered by BMAD™ Core -->
---
docOutputLocation: docs/brainstorming-session-results.md
template: 'bmad-core/templates/brainstorming-output-tmpl.yaml'
template: '.bmad-core/templates/brainstorming-output-tmpl.yaml'
---
# Facilitate Brainstorming Session Task
@@ -1714,10 +1724,11 @@ Generate structured document with these sections:
- Always ask before switching techniques: "Ready to try a different approach?"
- Offer options: "Should we explore this idea deeper or generate more alternatives?"
- Respect their process and timing
==================== END: bmad-core/tasks/facilitate-brainstorming-session.md ====================
==================== END: .bmad-core/tasks/facilitate-brainstorming-session.md ====================
==================== START: bmad-core/tasks/generate-ai-frontend-prompt.md ====================
==================== START: .bmad-core/tasks/generate-ai-frontend-prompt.md ====================
<!-- Powered by BMAD™ Core -->
# Create AI Frontend Prompt Task
## Purpose
@@ -1769,10 +1780,11 @@ You will now synthesize the inputs and the above principles into a final, compre
- Output the complete, generated prompt in a clear, copy-pasteable format (e.g., a large code block).
- Explain the structure of the prompt and why certain information was included, referencing the principles above.
- <important_note>Conclude by reminding the user that all AI-generated code will require careful human review, testing, and refinement to be considered production-ready.</important_note>
==================== END: bmad-core/tasks/generate-ai-frontend-prompt.md ====================
==================== END: .bmad-core/tasks/generate-ai-frontend-prompt.md ====================
==================== START: bmad-core/tasks/index-docs.md ====================
==================== START: .bmad-core/tasks/index-docs.md ====================
<!-- Powered by BMAD™ Core -->
# Index Documentation Task
## Purpose
@@ -1946,10 +1958,11 @@ Please provide:
5. Whether to include hidden files/folders (starting with `.`)
Would you like to proceed with documentation indexing? Please provide the required input above.
==================== END: bmad-core/tasks/index-docs.md ====================
==================== END: .bmad-core/tasks/index-docs.md ====================
==================== START: bmad-core/tasks/shard-doc.md ====================
==================== START: .bmad-core/tasks/shard-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Document Sharding Task
## Purpose
@@ -1960,20 +1973,20 @@ Would you like to proceed with documentation indexing? Please provide the requir
## Primary Method: Automatic with markdown-tree
[[LLM: First, check if markdownExploder is set to true in bmad-core/core-config.yaml. If it is, attempt to run the command: `md-tree explode {input file} {output path}`.
[[LLM: First, check if markdownExploder is set to true in .bmad-core/core-config.yaml. If it is, attempt to run the command: `md-tree explode {input file} {output path}`.
If the command succeeds, inform the user that the document has been sharded successfully and STOP - do not proceed further.
If the command fails (especially with an error indicating the command is not found or not available), inform the user: "The markdownExploder setting is enabled but the md-tree command is not available. Please either:
1. Install @kayvan/markdown-tree-parser globally with: `npm install -g @kayvan/markdown-tree-parser`
2. Or set markdownExploder to false in bmad-core/core-config.yaml
2. Or set markdownExploder to false in .bmad-core/core-config.yaml
**IMPORTANT: STOP HERE - do not proceed with manual sharding until one of the above actions is taken.**"
If markdownExploder is set to false, inform the user: "The markdownExploder setting is currently false. For better performance and reliability, you should:
1. Set markdownExploder to true in bmad-core/core-config.yaml
1. Set markdownExploder to true in .bmad-core/core-config.yaml
2. Install @kayvan/markdown-tree-parser globally with: `npm install -g @kayvan/markdown-tree-parser`
I will now proceed with the manual sharding process."
@@ -2135,9 +2148,9 @@ Document sharded successfully:
- Preserve ALL formatting, including whitespace where significant
- Handle edge cases like sections with code blocks containing ## symbols
- Ensure the sharding is reversible (could reconstruct the original from shards)
==================== END: bmad-core/tasks/shard-doc.md ====================
==================== END: .bmad-core/tasks/shard-doc.md ====================
==================== START: bmad-core/templates/architecture-tmpl.yaml ====================
==================== START: .bmad-core/templates/architecture-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: architecture-template-v2
@@ -2268,7 +2281,7 @@ sections:
instruction: |
This is the DEFINITIVE technology selection section. Work with the user to make specific choices:
1. Review PRD technical assumptions and any preferences from bmad-core/data/technical-preferences.yaml or an attached technical-preferences
1. Review PRD technical assumptions and any preferences from .bmad-core/data/technical-preferences.yaml or an attached technical-preferences
2. For each category, present 2-3 viable options with pros/cons
3. Make a clear recommendation based on project needs
4. Get explicit user approval for each selection
@@ -2789,9 +2802,9 @@ sections:
- Key UI requirements from PRD
- Any frontend-specific decisions made here
- Request for detailed frontend architecture
==================== END: bmad-core/templates/architecture-tmpl.yaml ====================
==================== END: .bmad-core/templates/architecture-tmpl.yaml ====================
==================== START: bmad-core/templates/brownfield-architecture-tmpl.yaml ====================
==================== START: .bmad-core/templates/brownfield-architecture-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: brownfield-architecture-template-v2
@@ -3269,9 +3282,9 @@ sections:
- Key technical decisions based on real project constraints
- Existing system compatibility requirements with specific verification steps
- Clear sequencing of implementation to minimize risk to existing functionality
==================== END: bmad-core/templates/brownfield-architecture-tmpl.yaml ====================
==================== END: .bmad-core/templates/brownfield-architecture-tmpl.yaml ====================
==================== START: bmad-core/templates/brownfield-prd-tmpl.yaml ====================
==================== START: .bmad-core/templates/brownfield-prd-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: brownfield-prd-template-v2
@@ -3553,9 +3566,9 @@ sections:
- template: "IV1: {{existing_functionality_verification}}"
- template: "IV2: {{integration_point_verification}}"
- template: "IV3: {{performance_impact_verification}}"
==================== END: bmad-core/templates/brownfield-prd-tmpl.yaml ====================
==================== END: .bmad-core/templates/brownfield-prd-tmpl.yaml ====================
==================== START: bmad-core/templates/competitor-analysis-tmpl.yaml ====================
==================== START: .bmad-core/templates/competitor-analysis-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: competitor-analysis-template-v2
@@ -3863,9 +3876,9 @@ sections:
- Weekly: {{weekly_items}}
- Monthly: {{monthly_items}}
- Quarterly: {{quarterly_analysis}}
==================== END: bmad-core/templates/competitor-analysis-tmpl.yaml ====================
==================== END: .bmad-core/templates/competitor-analysis-tmpl.yaml ====================
==================== START: bmad-core/templates/front-end-architecture-tmpl.yaml ====================
==================== START: .bmad-core/templates/front-end-architecture-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: frontend-architecture-template-v2
@@ -4085,9 +4098,9 @@ sections:
- Key import patterns
- File naming conventions
- Project-specific patterns and utilities
==================== END: bmad-core/templates/front-end-architecture-tmpl.yaml ====================
==================== END: .bmad-core/templates/front-end-architecture-tmpl.yaml ====================
==================== START: bmad-core/templates/front-end-spec-tmpl.yaml ====================
==================== START: .bmad-core/templates/front-end-spec-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: frontend-spec-template-v2
@@ -4438,9 +4451,9 @@ sections:
- id: checklist-results
title: Checklist Results
instruction: If a UI/UX checklist exists, run it against this document and report results here.
==================== END: bmad-core/templates/front-end-spec-tmpl.yaml ====================
==================== END: .bmad-core/templates/front-end-spec-tmpl.yaml ====================
==================== START: bmad-core/templates/fullstack-architecture-tmpl.yaml ====================
==================== START: .bmad-core/templates/fullstack-architecture-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: fullstack-architecture-template-v2
@@ -5265,9 +5278,9 @@ sections:
- id: checklist-results
title: Checklist Results Report
instruction: Before running the checklist, offer to output the full architecture document. Once user confirms, execute the architect-checklist and populate results here.
==================== END: bmad-core/templates/fullstack-architecture-tmpl.yaml ====================
==================== END: .bmad-core/templates/fullstack-architecture-tmpl.yaml ====================
==================== START: bmad-core/templates/market-research-tmpl.yaml ====================
==================== START: .bmad-core/templates/market-research-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: market-research-template-v2
@@ -5521,9 +5534,9 @@ sections:
- id: additional-analysis
title: C. Additional Analysis
instruction: Any supplementary analysis not included in main body
==================== END: bmad-core/templates/market-research-tmpl.yaml ====================
==================== END: .bmad-core/templates/market-research-tmpl.yaml ====================
==================== START: bmad-core/templates/prd-tmpl.yaml ====================
==================== START: .bmad-core/templates/prd-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: prd-template-v2
@@ -5626,7 +5639,7 @@ sections:
instruction: |
Gather technical decisions that will guide the Architect. Steps:
1. Check if bmad-core/data/technical-preferences.yaml or an attached technical-preferences file exists - use it to pre-populate choices
1. Check if .bmad-core/data/technical-preferences.yaml or an attached technical-preferences file exists - use it to pre-populate choices
2. Ask user about: languages, frameworks, starter templates, libraries, APIs, deployment targets
3. For unknowns, offer guidance based on project goals and MVP scope
4. Document ALL technical choices with rationale (why this choice fits the project)
@@ -5727,9 +5740,9 @@ sections:
- id: architect-prompt
title: Architect Prompt
instruction: This section will contain the prompt for the Architect, keep it short and to the point to initiate create architecture mode using this document as input.
==================== END: bmad-core/templates/prd-tmpl.yaml ====================
==================== END: .bmad-core/templates/prd-tmpl.yaml ====================
==================== START: bmad-core/templates/project-brief-tmpl.yaml ====================
==================== START: .bmad-core/templates/project-brief-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: project-brief-template-v2
@@ -5952,9 +5965,9 @@ sections:
title: PM Handoff
content: |
This Project Brief provides the full context for {{project_name}}. Please start in 'PRD Generation Mode', review the brief thoroughly to work with the user to create the PRD section by section as the template indicates, asking for any necessary clarification or suggesting improvements.
==================== END: bmad-core/templates/project-brief-tmpl.yaml ====================
==================== END: .bmad-core/templates/project-brief-tmpl.yaml ====================
==================== START: bmad-core/templates/story-tmpl.yaml ====================
==================== START: .bmad-core/templates/story-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: story-template-v2
@@ -6093,10 +6106,11 @@ sections:
instruction: Results from QA Agent QA review of the completed story implementation
owner: qa-agent
editors: [qa-agent]
==================== END: bmad-core/templates/story-tmpl.yaml ====================
==================== END: .bmad-core/templates/story-tmpl.yaml ====================
==================== START: bmad-core/checklists/architect-checklist.md ====================
==================== START: .bmad-core/checklists/architect-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Architect Solution Validation Checklist
This checklist serves as a comprehensive framework for the Architect to validate the technical design and architecture before development execution. The Architect should systematically work through each item, ensuring the architecture is robust, scalable, secure, and aligned with the product requirements.
@@ -6535,10 +6549,11 @@ Now that you've completed the checklist, generate a comprehensive validation rep
- Component design clarity
After presenting the report, ask the user if they would like detailed analysis of any specific section, especially those with warnings or failures.]]
==================== END: bmad-core/checklists/architect-checklist.md ====================
==================== END: .bmad-core/checklists/architect-checklist.md ====================
==================== START: bmad-core/checklists/change-checklist.md ====================
==================== START: .bmad-core/checklists/change-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Change Navigation Checklist
**Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMad workflow.
@@ -6721,10 +6736,11 @@ Keep it action-oriented and forward-looking.]]
- [ ] **Confirm Next Steps:** Reiterate the handoff plan and the next actions to be taken by specific agents.
---
==================== END: bmad-core/checklists/change-checklist.md ====================
==================== END: .bmad-core/checklists/change-checklist.md ====================
==================== START: bmad-core/checklists/pm-checklist.md ====================
==================== START: .bmad-core/checklists/pm-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Product Manager (PM) Requirements Checklist
This checklist serves as a comprehensive framework to ensure the Product Requirements Document (PRD) and Epic definitions are complete, well-structured, and appropriately scoped for MVP development. The PM should systematically work through each item during the product definition process.
@@ -7095,10 +7111,11 @@ After presenting the report, ask if the user wants:
- **READY FOR ARCHITECT**: The PRD and epics are comprehensive, properly structured, and ready for architectural design.
- **NEEDS REFINEMENT**: The requirements documentation requires additional work to address the identified deficiencies.
==================== END: bmad-core/checklists/pm-checklist.md ====================
==================== END: .bmad-core/checklists/pm-checklist.md ====================
==================== START: bmad-core/checklists/po-master-checklist.md ====================
==================== START: .bmad-core/checklists/po-master-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Product Owner (PO) Master Validation Checklist
This checklist serves as a comprehensive framework for the Product Owner to validate project plans before development execution. It adapts intelligently based on project type (greenfield vs brownfield) and includes UI/UX considerations when applicable.
@@ -7531,10 +7548,11 @@ After presenting the report, ask if the user wants:
- **APPROVED**: The plan is comprehensive, properly sequenced, and ready for implementation.
- **CONDITIONAL**: The plan requires specific adjustments before proceeding.
- **REJECTED**: The plan requires significant revision to address critical deficiencies.
==================== END: bmad-core/checklists/po-master-checklist.md ====================
==================== END: .bmad-core/checklists/po-master-checklist.md ====================
==================== START: bmad-core/checklists/story-dod-checklist.md ====================
==================== START: .bmad-core/checklists/story-dod-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Story Definition of Done (DoD) Checklist
## Instructions for Developer Agent
@@ -7629,10 +7647,11 @@ After completing the checklist:
Be honest - it's better to flag issues now than have them discovered later.]]
- [ ] I, the Developer Agent, confirm that all applicable items above have been addressed.
==================== END: bmad-core/checklists/story-dod-checklist.md ====================
==================== END: .bmad-core/checklists/story-dod-checklist.md ====================
==================== START: bmad-core/checklists/story-draft-checklist.md ====================
==================== START: .bmad-core/checklists/story-draft-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Story Draft Checklist
The Scrum Master should use this checklist to validate that each story contains sufficient context for a developer agent to implement it successfully, while assuming the dev agent has reasonable capabilities to figure things out.
@@ -7786,10 +7805,11 @@ Be pragmatic - perfect documentation doesn't exist, but it must be enough to pro
- READY: The story provides sufficient context for implementation
- NEEDS REVISION: The story requires updates (see issues)
- BLOCKED: External information required (specify what information)
==================== END: bmad-core/checklists/story-draft-checklist.md ====================
==================== END: .bmad-core/checklists/story-draft-checklist.md ====================
==================== START: bmad-core/data/bmad-kb.md ====================
==================== START: .bmad-core/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMAD™ Knowledge Base
## Overview
@@ -7897,7 +7917,7 @@ npx bmad-method install
**Verify Installation**:
- `bmad-core/` folder created with all agents
- `.bmad-core/` folder created with all agents
- IDE-specific integration files created
- All agent commands/rules/modes available
@@ -8596,10 +8616,11 @@ Use the **expansion-creator** pack to build your own:
- **Documentation**: Check `docs/` folder for project-specific context
- **Community**: Discord and GitHub resources available for support
- **Contributing**: See `CONTRIBUTING.md` for full guidelines
==================== END: bmad-core/data/bmad-kb.md ====================
==================== END: .bmad-core/data/bmad-kb.md ====================
==================== START: bmad-core/data/brainstorming-techniques.md ====================
==================== START: .bmad-core/data/brainstorming-techniques.md ====================
<!-- Powered by BMAD™ Core -->
# Brainstorming Techniques Data
## Creative Expansion
@@ -8636,10 +8657,11 @@ Use the **expansion-creator** pack to build your own:
18. **Resource Constraints**: "What if you had only $10 and 1 hour?"
19. **Metaphor Mapping**: Use extended metaphors to explore solutions
20. **Question Storming**: Generate questions instead of answers first
==================== END: bmad-core/data/brainstorming-techniques.md ====================
==================== END: .bmad-core/data/brainstorming-techniques.md ====================
==================== START: bmad-core/data/elicitation-methods.md ====================
==================== START: .bmad-core/data/elicitation-methods.md ====================
<!-- Powered by BMAD™ Core -->
# Elicitation Methods Data
## Core Reflective Methods
@@ -8794,11 +8816,12 @@ Use the **expansion-creator** pack to build your own:
- Acknowledge choice to finalize current work
- Accept output as-is or move to next step
- Prepare to continue without additional elicitation
==================== END: bmad-core/data/elicitation-methods.md ====================
==================== END: .bmad-core/data/elicitation-methods.md ====================
==================== START: bmad-core/data/technical-preferences.md ====================
==================== START: .bmad-core/data/technical-preferences.md ====================
<!-- Powered by BMAD™ Core -->
# User-Defined Preferred Patterns and Preferences
None Listed
==================== END: bmad-core/data/technical-preferences.md ====================
==================== END: .bmad-core/data/technical-preferences.md ====================

View File

@@ -8,13 +8,13 @@ You are now operating as a specialized AI agent from the BMad-Method framework.
2. **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
- `==================== START: bmad-core/folder/filename.md ====================`
- `==================== END: bmad-core/folder/filename.md ====================`
- `==================== START: .bmad-core/folder/filename.md ====================`
- `==================== END: .bmad-core/folder/filename.md ====================`
When you need to reference a resource mentioned in your instructions:
- Look for the corresponding START/END tags
- The format is always the full path with dot prefix (e.g., `bmad-core/personas/analyst.md`, `bmad-core/tasks/create-story.md`)
- The format is always the full path with dot prefix (e.g., `.bmad-core/personas/analyst.md`, `.bmad-core/tasks/create-story.md`)
- If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
**Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
@@ -29,8 +29,8 @@ dependencies:
These references map directly to bundle sections:
- `utils: template-format` → Look for `==================== START: bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: bmad-core/tasks/create-story.md ====================`
- `utils: template-format` → Look for `==================== START: .bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: .bmad-core/tasks/create-story.md ====================`
3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
@@ -39,7 +39,7 @@ These references map directly to bundle sections:
---
==================== START: bmad-core/agents/bmad-orchestrator.md ====================
==================== START: .bmad-core/agents/bmad-orchestrator.md ====================
# bmad-orchestrator
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -164,10 +164,11 @@ dependencies:
utils:
- workflow-management.md
```
==================== END: bmad-core/agents/bmad-orchestrator.md ====================
==================== END: .bmad-core/agents/bmad-orchestrator.md ====================
==================== START: bmad-core/tasks/advanced-elicitation.md ====================
==================== START: .bmad-core/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -285,10 +286,11 @@ Choose a number (0-8) or 9 to proceed:
- **Stay Relevant**: Tie all elicitation back to the specific content being analyzed
- **Identify Personas**: For multi-persona methods, clearly identify which viewpoint is speaking
- **Maintain Flow**: Keep the process moving efficiently
==================== END: bmad-core/tasks/advanced-elicitation.md ====================
==================== END: .bmad-core/tasks/advanced-elicitation.md ====================
==================== START: bmad-core/tasks/create-doc.md ====================
==================== START: .bmad-core/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -306,7 +308,7 @@ When this task is invoked:
## Critical: Template Discovery
If a YAML Template has not been provided, list all templates from bmad-core/templates or ask the user to provide another.
If a YAML Template has not been provided, list all templates from .bmad-core/templates or ask the user to provide another.
## CRITICAL: Mandatory Elicitation Format
@@ -390,10 +392,11 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
- Select options 2-9 from data/elicitation-methods only
- Provide detailed rationale explaining decisions
- End with "Select 1-9 or just type your question/feedback:"
==================== END: bmad-core/tasks/create-doc.md ====================
==================== END: .bmad-core/tasks/create-doc.md ====================
==================== START: bmad-core/tasks/kb-mode-interaction.md ====================
==================== START: .bmad-core/tasks/kb-mode-interaction.md ====================
<!-- Powered by BMAD™ Core -->
# KB Mode Interaction Task
## Purpose
@@ -469,10 +472,11 @@ Or ask me about anything else related to BMad-Method!
**User**: Tell me about workflows
**Assistant**: [Provides focused information about workflows from the KB, then offers to explore specific workflow types or related topics]
==================== END: bmad-core/tasks/kb-mode-interaction.md ====================
==================== END: .bmad-core/tasks/kb-mode-interaction.md ====================
==================== START: bmad-core/data/bmad-kb.md ====================
==================== START: .bmad-core/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMAD™ Knowledge Base
## Overview
@@ -580,7 +584,7 @@ npx bmad-method install
**Verify Installation**:
- `bmad-core/` folder created with all agents
- `.bmad-core/` folder created with all agents
- IDE-specific integration files created
- All agent commands/rules/modes available
@@ -1279,10 +1283,11 @@ Use the **expansion-creator** pack to build your own:
- **Documentation**: Check `docs/` folder for project-specific context
- **Community**: Discord and GitHub resources available for support
- **Contributing**: See `CONTRIBUTING.md` for full guidelines
==================== END: bmad-core/data/bmad-kb.md ====================
==================== END: .bmad-core/data/bmad-kb.md ====================
==================== START: bmad-core/data/elicitation-methods.md ====================
==================== START: .bmad-core/data/elicitation-methods.md ====================
<!-- Powered by BMAD™ Core -->
# Elicitation Methods Data
## Core Reflective Methods
@@ -1437,10 +1442,11 @@ Use the **expansion-creator** pack to build your own:
- Acknowledge choice to finalize current work
- Accept output as-is or move to next step
- Prepare to continue without additional elicitation
==================== END: bmad-core/data/elicitation-methods.md ====================
==================== END: .bmad-core/data/elicitation-methods.md ====================
==================== START: bmad-core/utils/workflow-management.md ====================
==================== START: .bmad-core/utils/workflow-management.md ====================
<!-- Powered by BMAD™ Core -->
# Workflow Management
Enables BMad orchestrator to manage and execute team workflows.
@@ -1510,4 +1516,4 @@ Handle conditional paths by asking clarifying questions when needed.
## Agent Integration
Agents should be workflow-aware: know active workflow, their role, access artifacts, understand expected outputs.
==================== END: bmad-core/utils/workflow-management.md ====================
==================== END: .bmad-core/utils/workflow-management.md ====================

40
dist/agents/dev.txt vendored
View File

@@ -8,13 +8,13 @@ You are now operating as a specialized AI agent from the BMad-Method framework.
2. **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
- `==================== START: bmad-core/folder/filename.md ====================`
- `==================== END: bmad-core/folder/filename.md ====================`
- `==================== START: .bmad-core/folder/filename.md ====================`
- `==================== END: .bmad-core/folder/filename.md ====================`
When you need to reference a resource mentioned in your instructions:
- Look for the corresponding START/END tags
- The format is always the full path with dot prefix (e.g., `bmad-core/personas/analyst.md`, `bmad-core/tasks/create-story.md`)
- The format is always the full path with dot prefix (e.g., `.bmad-core/personas/analyst.md`, `.bmad-core/tasks/create-story.md`)
- If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
**Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
@@ -29,8 +29,8 @@ dependencies:
These references map directly to bundle sections:
- `utils: template-format` → Look for `==================== START: bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: bmad-core/tasks/create-story.md ====================`
- `utils: template-format` → Look for `==================== START: .bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: .bmad-core/tasks/create-story.md ====================`
3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
@@ -39,7 +39,7 @@ These references map directly to bundle sections:
---
==================== START: bmad-core/agents/dev.md ====================
==================== START: .bmad-core/agents/dev.md ====================
# dev
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -90,10 +90,11 @@ dependencies:
- execute-checklist.md
- validate-next-story.md
```
==================== END: bmad-core/agents/dev.md ====================
==================== END: .bmad-core/agents/dev.md ====================
==================== START: bmad-core/tasks/apply-qa-fixes.md ====================
==================== START: .bmad-core/tasks/apply-qa-fixes.md ====================
<!-- Powered by BMAD™ Core -->
# apply-qa-fixes
Implement fixes based on QA results (gate and assessments) for a specific story. This task is for the Dev agent to systematically consume QA outputs and apply code/test changes while only updating allowed sections in the story file.
@@ -242,17 +243,18 @@ Fix plan:
- Tests validate behavior and close gaps
- Strict adherence to allowed story update areas
- Gate ownership remains with QA; Dev signals readiness via Status
==================== END: bmad-core/tasks/apply-qa-fixes.md ====================
==================== END: .bmad-core/tasks/apply-qa-fixes.md ====================
==================== START: bmad-core/tasks/execute-checklist.md ====================
==================== START: .bmad-core/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
## Available Checklists
If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the bmad-core/checklists folder to select the appropriate one to run.
If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the .bmad-core/checklists folder to select the appropriate one to run.
## Instructions
@@ -260,7 +262,7 @@ If the user asks or does not specify a specific checklist, list the checklists a
- If user or the task being run provides a checklist name:
- Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
- If multiple matches found, ask user to clarify
- Load the appropriate checklist from bmad-core/checklists/
- Load the appropriate checklist from .bmad-core/checklists/
- If no checklist specified:
- Ask the user which checklist they want to use
- Present the available options from the files in the checklists folder
@@ -332,10 +334,11 @@ The LLM will:
- Execute the complete checklist validation
- Present a final report with pass/fail rates and key findings
- Offer to provide detailed analysis of any section, especially those with warnings or failures
==================== END: bmad-core/tasks/execute-checklist.md ====================
==================== END: .bmad-core/tasks/execute-checklist.md ====================
==================== START: bmad-core/tasks/validate-next-story.md ====================
==================== START: .bmad-core/tasks/validate-next-story.md ====================
<!-- Powered by BMAD™ Core -->
# Validate Next Story Task
## Purpose
@@ -346,7 +349,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
### 0. Load Core Configuration and Inputs
- Load `bmad-core/core-config.yaml`
- Load `.bmad-core/core-config.yaml`
- If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story validation."
- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`
- Identify and load the following inputs:
@@ -470,10 +473,11 @@ Provide a structured validation report including:
- **NO-GO**: Story requires fixes before implementation
- **Implementation Readiness Score**: 1-10 scale
- **Confidence Level**: High/Medium/Low for successful implementation
==================== END: bmad-core/tasks/validate-next-story.md ====================
==================== END: .bmad-core/tasks/validate-next-story.md ====================
==================== START: bmad-core/checklists/story-dod-checklist.md ====================
==================== START: .bmad-core/checklists/story-dod-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Story Definition of Done (DoD) Checklist
## Instructions for Developer Agent
@@ -568,4 +572,4 @@ After completing the checklist:
Be honest - it's better to flag issues now than have them discovered later.]]
- [ ] I, the Developer Agent, confirm that all applicable items above have been addressed.
==================== END: bmad-core/checklists/story-dod-checklist.md ====================
==================== END: .bmad-core/checklists/story-dod-checklist.md ====================

90
dist/agents/pm.txt vendored
View File

@@ -8,13 +8,13 @@ You are now operating as a specialized AI agent from the BMad-Method framework.
2. **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
- `==================== START: bmad-core/folder/filename.md ====================`
- `==================== END: bmad-core/folder/filename.md ====================`
- `==================== START: .bmad-core/folder/filename.md ====================`
- `==================== END: .bmad-core/folder/filename.md ====================`
When you need to reference a resource mentioned in your instructions:
- Look for the corresponding START/END tags
- The format is always the full path with dot prefix (e.g., `bmad-core/personas/analyst.md`, `bmad-core/tasks/create-story.md`)
- The format is always the full path with dot prefix (e.g., `.bmad-core/personas/analyst.md`, `.bmad-core/tasks/create-story.md`)
- If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
**Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
@@ -29,8 +29,8 @@ dependencies:
These references map directly to bundle sections:
- `utils: template-format` → Look for `==================== START: bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: bmad-core/tasks/create-story.md ====================`
- `utils: template-format` → Look for `==================== START: .bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: .bmad-core/tasks/create-story.md ====================`
3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
@@ -39,7 +39,7 @@ These references map directly to bundle sections:
---
==================== START: bmad-core/agents/pm.md ====================
==================== START: .bmad-core/agents/pm.md ====================
# pm
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -101,10 +101,11 @@ dependencies:
- brownfield-prd-tmpl.yaml
- prd-tmpl.yaml
```
==================== END: bmad-core/agents/pm.md ====================
==================== END: .bmad-core/agents/pm.md ====================
==================== START: bmad-core/tasks/brownfield-create-epic.md ====================
==================== START: .bmad-core/tasks/brownfield-create-epic.md ====================
<!-- Powered by BMAD™ Core -->
# Create Brownfield Epic Task
## Purpose
@@ -265,10 +266,11 @@ The epic creation is successful when:
- If the scope grows beyond 3 stories, consider the full brownfield PRD process
- Always prioritize existing system integrity over new functionality
- When in doubt about scope or complexity, escalate to full brownfield planning
==================== END: bmad-core/tasks/brownfield-create-epic.md ====================
==================== END: .bmad-core/tasks/brownfield-create-epic.md ====================
==================== START: bmad-core/tasks/brownfield-create-story.md ====================
==================== START: .bmad-core/tasks/brownfield-create-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Brownfield Story Task
## Purpose
@@ -416,15 +418,16 @@ The story creation is successful when:
- Always prioritize existing system integrity
- When in doubt about integration complexity, use brownfield-create-epic instead
- Stories should take no more than 4 hours of focused development work
==================== END: bmad-core/tasks/brownfield-create-story.md ====================
==================== END: .bmad-core/tasks/brownfield-create-story.md ====================
==================== START: bmad-core/tasks/correct-course.md ====================
==================== START: .bmad-core/tasks/correct-course.md ====================
<!-- Powered by BMAD™ Core -->
# Correct Course Task
## Purpose
- Guide a structured response to a change trigger using the `bmad-core/checklists/change-checklist`.
- Guide a structured response to a change trigger using the `.bmad-core/checklists/change-checklist`.
- Analyze the impacts of the change on epics, project artifacts, and the MVP, guided by the checklist's structure.
- Explore potential solutions (e.g., adjust scope, rollback elements, re-scope features) as prompted by the checklist.
- Draft specific, actionable proposed updates to any affected project artifacts (e.g., epics, user stories, PRD sections, architecture document sections) based on the analysis.
@@ -438,7 +441,7 @@ The story creation is successful when:
- **Acknowledge Task & Inputs:**
- Confirm with the user that the "Correct Course Task" (Change Navigation & Integration) is being initiated.
- Verify the change trigger and ensure you have the user's initial explanation of the issue and its perceived impact.
- Confirm access to all relevant project artifacts (e.g., PRD, Epics/Stories, Architecture Documents, UI/UX Specifications) and, critically, the `bmad-core/checklists/change-checklist`.
- Confirm access to all relevant project artifacts (e.g., PRD, Epics/Stories, Architecture Documents, UI/UX Specifications) and, critically, the `.bmad-core/checklists/change-checklist`.
- **Establish Interaction Mode:**
- Ask the user their preferred interaction mode for this task:
- **"Incrementally (Default & Recommended):** Shall we work through the change-checklist section by section, discussing findings and collaboratively drafting proposed changes for each relevant part before moving to the next? This allows for detailed, step-by-step refinement."
@@ -490,10 +493,11 @@ The story creation is successful when:
- A summary of the change-checklist analysis (issue, impact, rationale for the chosen path).
- Specific, clearly drafted proposed edits for all affected project artifacts.
- **Implicit:** An annotated change-checklist (or the record of its completion) reflecting the discussions, findings, and decisions made during the process.
==================== END: bmad-core/tasks/correct-course.md ====================
==================== END: .bmad-core/tasks/correct-course.md ====================
==================== START: bmad-core/tasks/create-deep-research-prompt.md ====================
==================== START: .bmad-core/tasks/create-deep-research-prompt.md ====================
<!-- Powered by BMAD™ Core -->
# Create Deep Research Prompt Task
This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation.
@@ -772,10 +776,11 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
- Balance comprehensiveness with focus
- Document assumptions and limitations clearly
- Plan for iterative refinement based on initial findings
==================== END: bmad-core/tasks/create-deep-research-prompt.md ====================
==================== END: .bmad-core/tasks/create-deep-research-prompt.md ====================
==================== START: bmad-core/tasks/create-doc.md ====================
==================== START: .bmad-core/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -793,7 +798,7 @@ When this task is invoked:
## Critical: Template Discovery
If a YAML Template has not been provided, list all templates from bmad-core/templates or ask the user to provide another.
If a YAML Template has not been provided, list all templates from .bmad-core/templates or ask the user to provide another.
## CRITICAL: Mandatory Elicitation Format
@@ -877,17 +882,18 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
- Select options 2-9 from data/elicitation-methods only
- Provide detailed rationale explaining decisions
- End with "Select 1-9 or just type your question/feedback:"
==================== END: bmad-core/tasks/create-doc.md ====================
==================== END: .bmad-core/tasks/create-doc.md ====================
==================== START: bmad-core/tasks/execute-checklist.md ====================
==================== START: .bmad-core/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
## Available Checklists
If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the bmad-core/checklists folder to select the appropriate one to run.
If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the .bmad-core/checklists folder to select the appropriate one to run.
## Instructions
@@ -895,7 +901,7 @@ If the user asks or does not specify a specific checklist, list the checklists a
- If user or the task being run provides a checklist name:
- Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
- If multiple matches found, ask user to clarify
- Load the appropriate checklist from bmad-core/checklists/
- Load the appropriate checklist from .bmad-core/checklists/
- If no checklist specified:
- Ask the user which checklist they want to use
- Present the available options from the files in the checklists folder
@@ -967,10 +973,11 @@ The LLM will:
- Execute the complete checklist validation
- Present a final report with pass/fail rates and key findings
- Offer to provide detailed analysis of any section, especially those with warnings or failures
==================== END: bmad-core/tasks/execute-checklist.md ====================
==================== END: .bmad-core/tasks/execute-checklist.md ====================
==================== START: bmad-core/tasks/shard-doc.md ====================
==================== START: .bmad-core/tasks/shard-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Document Sharding Task
## Purpose
@@ -981,20 +988,20 @@ The LLM will:
## Primary Method: Automatic with markdown-tree
[[LLM: First, check if markdownExploder is set to true in bmad-core/core-config.yaml. If it is, attempt to run the command: `md-tree explode {input file} {output path}`.
[[LLM: First, check if markdownExploder is set to true in .bmad-core/core-config.yaml. If it is, attempt to run the command: `md-tree explode {input file} {output path}`.
If the command succeeds, inform the user that the document has been sharded successfully and STOP - do not proceed further.
If the command fails (especially with an error indicating the command is not found or not available), inform the user: "The markdownExploder setting is enabled but the md-tree command is not available. Please either:
1. Install @kayvan/markdown-tree-parser globally with: `npm install -g @kayvan/markdown-tree-parser`
2. Or set markdownExploder to false in bmad-core/core-config.yaml
2. Or set markdownExploder to false in .bmad-core/core-config.yaml
**IMPORTANT: STOP HERE - do not proceed with manual sharding until one of the above actions is taken.**"
If markdownExploder is set to false, inform the user: "The markdownExploder setting is currently false. For better performance and reliability, you should:
1. Set markdownExploder to true in bmad-core/core-config.yaml
1. Set markdownExploder to true in .bmad-core/core-config.yaml
2. Install @kayvan/markdown-tree-parser globally with: `npm install -g @kayvan/markdown-tree-parser`
I will now proceed with the manual sharding process."
@@ -1156,9 +1163,9 @@ Document sharded successfully:
- Preserve ALL formatting, including whitespace where significant
- Handle edge cases like sections with code blocks containing ## symbols
- Ensure the sharding is reversible (could reconstruct the original from shards)
==================== END: bmad-core/tasks/shard-doc.md ====================
==================== END: .bmad-core/tasks/shard-doc.md ====================
==================== START: bmad-core/templates/brownfield-prd-tmpl.yaml ====================
==================== START: .bmad-core/templates/brownfield-prd-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: brownfield-prd-template-v2
@@ -1440,9 +1447,9 @@ sections:
- template: "IV1: {{existing_functionality_verification}}"
- template: "IV2: {{integration_point_verification}}"
- template: "IV3: {{performance_impact_verification}}"
==================== END: bmad-core/templates/brownfield-prd-tmpl.yaml ====================
==================== END: .bmad-core/templates/brownfield-prd-tmpl.yaml ====================
==================== START: bmad-core/templates/prd-tmpl.yaml ====================
==================== START: .bmad-core/templates/prd-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: prd-template-v2
@@ -1545,7 +1552,7 @@ sections:
instruction: |
Gather technical decisions that will guide the Architect. Steps:
1. Check if bmad-core/data/technical-preferences.yaml or an attached technical-preferences file exists - use it to pre-populate choices
1. Check if .bmad-core/data/technical-preferences.yaml or an attached technical-preferences file exists - use it to pre-populate choices
2. Ask user about: languages, frameworks, starter templates, libraries, APIs, deployment targets
3. For unknowns, offer guidance based on project goals and MVP scope
4. Document ALL technical choices with rationale (why this choice fits the project)
@@ -1646,10 +1653,11 @@ sections:
- id: architect-prompt
title: Architect Prompt
instruction: This section will contain the prompt for the Architect, keep it short and to the point to initiate create architecture mode using this document as input.
==================== END: bmad-core/templates/prd-tmpl.yaml ====================
==================== END: .bmad-core/templates/prd-tmpl.yaml ====================
==================== START: bmad-core/checklists/change-checklist.md ====================
==================== START: .bmad-core/checklists/change-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Change Navigation Checklist
**Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMad workflow.
@@ -1832,10 +1840,11 @@ Keep it action-oriented and forward-looking.]]
- [ ] **Confirm Next Steps:** Reiterate the handoff plan and the next actions to be taken by specific agents.
---
==================== END: bmad-core/checklists/change-checklist.md ====================
==================== END: .bmad-core/checklists/change-checklist.md ====================
==================== START: bmad-core/checklists/pm-checklist.md ====================
==================== START: .bmad-core/checklists/pm-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Product Manager (PM) Requirements Checklist
This checklist serves as a comprehensive framework to ensure the Product Requirements Document (PRD) and Epic definitions are complete, well-structured, and appropriately scoped for MVP development. The PM should systematically work through each item during the product definition process.
@@ -2206,11 +2215,12 @@ After presenting the report, ask if the user wants:
- **READY FOR ARCHITECT**: The PRD and epics are comprehensive, properly structured, and ready for architectural design.
- **NEEDS REFINEMENT**: The requirements documentation requires additional work to address the identified deficiencies.
==================== END: bmad-core/checklists/pm-checklist.md ====================
==================== END: .bmad-core/checklists/pm-checklist.md ====================
==================== START: bmad-core/data/technical-preferences.md ====================
==================== START: .bmad-core/data/technical-preferences.md ====================
<!-- Powered by BMAD™ Core -->
# User-Defined Preferred Patterns and Preferences
None Listed
==================== END: bmad-core/data/technical-preferences.md ====================
==================== END: .bmad-core/data/technical-preferences.md ====================

64
dist/agents/po.txt vendored
View File

@@ -8,13 +8,13 @@ You are now operating as a specialized AI agent from the BMad-Method framework.
2. **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
- `==================== START: bmad-core/folder/filename.md ====================`
- `==================== END: bmad-core/folder/filename.md ====================`
- `==================== START: .bmad-core/folder/filename.md ====================`
- `==================== END: .bmad-core/folder/filename.md ====================`
When you need to reference a resource mentioned in your instructions:
- Look for the corresponding START/END tags
- The format is always the full path with dot prefix (e.g., `bmad-core/personas/analyst.md`, `bmad-core/tasks/create-story.md`)
- The format is always the full path with dot prefix (e.g., `.bmad-core/personas/analyst.md`, `.bmad-core/tasks/create-story.md`)
- If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
**Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
@@ -29,8 +29,8 @@ dependencies:
These references map directly to bundle sections:
- `utils: template-format` → Look for `==================== START: bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: bmad-core/tasks/create-story.md ====================`
- `utils: template-format` → Look for `==================== START: .bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: .bmad-core/tasks/create-story.md ====================`
3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
@@ -39,7 +39,7 @@ These references map directly to bundle sections:
---
==================== START: bmad-core/agents/po.md ====================
==================== START: .bmad-core/agents/po.md ====================
# po
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -96,15 +96,16 @@ dependencies:
templates:
- story-tmpl.yaml
```
==================== END: bmad-core/agents/po.md ====================
==================== END: .bmad-core/agents/po.md ====================
==================== START: bmad-core/tasks/correct-course.md ====================
==================== START: .bmad-core/tasks/correct-course.md ====================
<!-- Powered by BMAD™ Core -->
# Correct Course Task
## Purpose
- Guide a structured response to a change trigger using the `bmad-core/checklists/change-checklist`.
- Guide a structured response to a change trigger using the `.bmad-core/checklists/change-checklist`.
- Analyze the impacts of the change on epics, project artifacts, and the MVP, guided by the checklist's structure.
- Explore potential solutions (e.g., adjust scope, rollback elements, re-scope features) as prompted by the checklist.
- Draft specific, actionable proposed updates to any affected project artifacts (e.g., epics, user stories, PRD sections, architecture document sections) based on the analysis.
@@ -118,7 +119,7 @@ dependencies:
- **Acknowledge Task & Inputs:**
- Confirm with the user that the "Correct Course Task" (Change Navigation & Integration) is being initiated.
- Verify the change trigger and ensure you have the user's initial explanation of the issue and its perceived impact.
- Confirm access to all relevant project artifacts (e.g., PRD, Epics/Stories, Architecture Documents, UI/UX Specifications) and, critically, the `bmad-core/checklists/change-checklist`.
- Confirm access to all relevant project artifacts (e.g., PRD, Epics/Stories, Architecture Documents, UI/UX Specifications) and, critically, the `.bmad-core/checklists/change-checklist`.
- **Establish Interaction Mode:**
- Ask the user their preferred interaction mode for this task:
- **"Incrementally (Default & Recommended):** Shall we work through the change-checklist section by section, discussing findings and collaboratively drafting proposed changes for each relevant part before moving to the next? This allows for detailed, step-by-step refinement."
@@ -170,17 +171,18 @@ dependencies:
- A summary of the change-checklist analysis (issue, impact, rationale for the chosen path).
- Specific, clearly drafted proposed edits for all affected project artifacts.
- **Implicit:** An annotated change-checklist (or the record of its completion) reflecting the discussions, findings, and decisions made during the process.
==================== END: bmad-core/tasks/correct-course.md ====================
==================== END: .bmad-core/tasks/correct-course.md ====================
==================== START: bmad-core/tasks/execute-checklist.md ====================
==================== START: .bmad-core/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
## Available Checklists
If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the bmad-core/checklists folder to select the appropriate one to run.
If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the .bmad-core/checklists folder to select the appropriate one to run.
## Instructions
@@ -188,7 +190,7 @@ If the user asks or does not specify a specific checklist, list the checklists a
- If user or the task being run provides a checklist name:
- Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
- If multiple matches found, ask user to clarify
- Load the appropriate checklist from bmad-core/checklists/
- Load the appropriate checklist from .bmad-core/checklists/
- If no checklist specified:
- Ask the user which checklist they want to use
- Present the available options from the files in the checklists folder
@@ -260,10 +262,11 @@ The LLM will:
- Execute the complete checklist validation
- Present a final report with pass/fail rates and key findings
- Offer to provide detailed analysis of any section, especially those with warnings or failures
==================== END: bmad-core/tasks/execute-checklist.md ====================
==================== END: .bmad-core/tasks/execute-checklist.md ====================
==================== START: bmad-core/tasks/shard-doc.md ====================
==================== START: .bmad-core/tasks/shard-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Document Sharding Task
## Purpose
@@ -274,20 +277,20 @@ The LLM will:
## Primary Method: Automatic with markdown-tree
[[LLM: First, check if markdownExploder is set to true in bmad-core/core-config.yaml. If it is, attempt to run the command: `md-tree explode {input file} {output path}`.
[[LLM: First, check if markdownExploder is set to true in .bmad-core/core-config.yaml. If it is, attempt to run the command: `md-tree explode {input file} {output path}`.
If the command succeeds, inform the user that the document has been sharded successfully and STOP - do not proceed further.
If the command fails (especially with an error indicating the command is not found or not available), inform the user: "The markdownExploder setting is enabled but the md-tree command is not available. Please either:
1. Install @kayvan/markdown-tree-parser globally with: `npm install -g @kayvan/markdown-tree-parser`
2. Or set markdownExploder to false in bmad-core/core-config.yaml
2. Or set markdownExploder to false in .bmad-core/core-config.yaml
**IMPORTANT: STOP HERE - do not proceed with manual sharding until one of the above actions is taken.**"
If markdownExploder is set to false, inform the user: "The markdownExploder setting is currently false. For better performance and reliability, you should:
1. Set markdownExploder to true in bmad-core/core-config.yaml
1. Set markdownExploder to true in .bmad-core/core-config.yaml
2. Install @kayvan/markdown-tree-parser globally with: `npm install -g @kayvan/markdown-tree-parser`
I will now proceed with the manual sharding process."
@@ -449,10 +452,11 @@ Document sharded successfully:
- Preserve ALL formatting, including whitespace where significant
- Handle edge cases like sections with code blocks containing ## symbols
- Ensure the sharding is reversible (could reconstruct the original from shards)
==================== END: bmad-core/tasks/shard-doc.md ====================
==================== END: .bmad-core/tasks/shard-doc.md ====================
==================== START: bmad-core/tasks/validate-next-story.md ====================
==================== START: .bmad-core/tasks/validate-next-story.md ====================
<!-- Powered by BMAD™ Core -->
# Validate Next Story Task
## Purpose
@@ -463,7 +467,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
### 0. Load Core Configuration and Inputs
- Load `bmad-core/core-config.yaml`
- Load `.bmad-core/core-config.yaml`
- If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story validation."
- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`
- Identify and load the following inputs:
@@ -587,9 +591,9 @@ Provide a structured validation report including:
- **NO-GO**: Story requires fixes before implementation
- **Implementation Readiness Score**: 1-10 scale
- **Confidence Level**: High/Medium/Low for successful implementation
==================== END: bmad-core/tasks/validate-next-story.md ====================
==================== END: .bmad-core/tasks/validate-next-story.md ====================
==================== START: bmad-core/templates/story-tmpl.yaml ====================
==================== START: .bmad-core/templates/story-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: story-template-v2
@@ -728,10 +732,11 @@ sections:
instruction: Results from QA Agent QA review of the completed story implementation
owner: qa-agent
editors: [qa-agent]
==================== END: bmad-core/templates/story-tmpl.yaml ====================
==================== END: .bmad-core/templates/story-tmpl.yaml ====================
==================== START: bmad-core/checklists/change-checklist.md ====================
==================== START: .bmad-core/checklists/change-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Change Navigation Checklist
**Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMad workflow.
@@ -914,10 +919,11 @@ Keep it action-oriented and forward-looking.]]
- [ ] **Confirm Next Steps:** Reiterate the handoff plan and the next actions to be taken by specific agents.
---
==================== END: bmad-core/checklists/change-checklist.md ====================
==================== END: .bmad-core/checklists/change-checklist.md ====================
==================== START: bmad-core/checklists/po-master-checklist.md ====================
==================== START: .bmad-core/checklists/po-master-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Product Owner (PO) Master Validation Checklist
This checklist serves as a comprehensive framework for the Product Owner to validate project plans before development execution. It adapts intelligently based on project type (greenfield vs brownfield) and includes UI/UX considerations when applicable.
@@ -1350,4 +1356,4 @@ After presenting the report, ask if the user wants:
- **APPROVED**: The plan is comprehensive, properly sequenced, and ready for implementation.
- **CONDITIONAL**: The plan requires specific adjustments before proceeding.
- **REJECTED**: The plan requires significant revision to address critical deficiencies.
==================== END: bmad-core/checklists/po-master-checklist.md ====================
==================== END: .bmad-core/checklists/po-master-checklist.md ====================

57
dist/agents/qa.txt vendored
View File

@@ -8,13 +8,13 @@ You are now operating as a specialized AI agent from the BMad-Method framework.
2. **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
- `==================== START: bmad-core/folder/filename.md ====================`
- `==================== END: bmad-core/folder/filename.md ====================`
- `==================== START: .bmad-core/folder/filename.md ====================`
- `==================== END: .bmad-core/folder/filename.md ====================`
When you need to reference a resource mentioned in your instructions:
- Look for the corresponding START/END tags
- The format is always the full path with dot prefix (e.g., `bmad-core/personas/analyst.md`, `bmad-core/tasks/create-story.md`)
- The format is always the full path with dot prefix (e.g., `.bmad-core/personas/analyst.md`, `.bmad-core/tasks/create-story.md`)
- If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
**Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
@@ -29,8 +29,8 @@ dependencies:
These references map directly to bundle sections:
- `utils: template-format` → Look for `==================== START: bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: bmad-core/tasks/create-story.md ====================`
- `utils: template-format` → Look for `==================== START: .bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: .bmad-core/tasks/create-story.md ====================`
3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
@@ -39,7 +39,7 @@ These references map directly to bundle sections:
---
==================== START: bmad-core/agents/qa.md ====================
==================== START: .bmad-core/agents/qa.md ====================
# qa
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -108,10 +108,11 @@ dependencies:
- qa-gate-tmpl.yaml
- story-tmpl.yaml
```
==================== END: bmad-core/agents/qa.md ====================
==================== END: .bmad-core/agents/qa.md ====================
==================== START: bmad-core/tasks/nfr-assess.md ====================
==================== START: .bmad-core/tasks/nfr-assess.md ====================
<!-- Powered by BMAD™ Core -->
# nfr-assess
Quick NFR validation focused on the core four: security, performance, reliability, maintainability.
@@ -455,10 +456,11 @@ performance_deep_dive:
```
</details>
==================== END: bmad-core/tasks/nfr-assess.md ====================
==================== END: .bmad-core/tasks/nfr-assess.md ====================
==================== START: bmad-core/tasks/qa-gate.md ====================
==================== START: .bmad-core/tasks/qa-gate.md ====================
<!-- Powered by BMAD™ Core -->
# qa-gate
Create or update a quality gate decision file for a story based on review findings.
@@ -620,10 +622,11 @@ Gate: CONCERNS → qa.qaLocation/gates/{epic}.{story}-{slug}.yml
- Always write to standard path
- Always update story with gate reference
- Clear, actionable findings
==================== END: bmad-core/tasks/qa-gate.md ====================
==================== END: .bmad-core/tasks/qa-gate.md ====================
==================== START: bmad-core/tasks/review-story.md ====================
==================== START: .bmad-core/tasks/review-story.md ====================
<!-- Powered by BMAD™ Core -->
# review-story
Perform a comprehensive test architecture review with quality gate decision. This adaptive, risk-aware review creates both a story update and a detailed gate file.
@@ -938,10 +941,11 @@ After review:
3. Recommend status: "Ready for Done" or "Changes Required" (owner decides)
4. If files were modified, list them in QA Results and ask Dev to update File List
5. Always provide constructive feedback and actionable recommendations
==================== END: bmad-core/tasks/review-story.md ====================
==================== END: .bmad-core/tasks/review-story.md ====================
==================== START: bmad-core/tasks/risk-profile.md ====================
==================== START: .bmad-core/tasks/risk-profile.md ====================
<!-- Powered by BMAD™ Core -->
# risk-profile
Generate a comprehensive risk assessment matrix for a story implementation using probability × impact analysis.
@@ -1295,10 +1299,11 @@ Risk profile: qa.qaLocation/assessments/{epic}.{story}-risk-{YYYYMMDD}.md
- Link risks to specific test requirements
- Track residual risk after mitigation
- Update risk profile as story evolves
==================== END: bmad-core/tasks/risk-profile.md ====================
==================== END: .bmad-core/tasks/risk-profile.md ====================
==================== START: bmad-core/tasks/test-design.md ====================
==================== START: .bmad-core/tasks/test-design.md ====================
<!-- Powered by BMAD™ Core -->
# test-design
Create comprehensive test scenarios with appropriate test level recommendations for story implementation.
@@ -1473,10 +1478,11 @@ Before finalizing, verify:
- **Efficient coverage**: Test once at the right level
- **Maintainability**: Consider long-term test maintenance
- **Fast feedback**: Quick tests run first
==================== END: bmad-core/tasks/test-design.md ====================
==================== END: .bmad-core/tasks/test-design.md ====================
==================== START: bmad-core/tasks/trace-requirements.md ====================
==================== START: .bmad-core/tasks/trace-requirements.md ====================
<!-- Powered by BMAD™ Core -->
# trace-requirements
Map story requirements to test cases using Given-When-Then patterns for comprehensive traceability.
@@ -1741,9 +1747,9 @@ Trace matrix: qa.qaLocation/assessments/{epic}.{story}-trace-{YYYYMMDD}.md
- Identify both presence and absence
- Prioritize based on risk
- Make recommendations actionable
==================== END: bmad-core/tasks/trace-requirements.md ====================
==================== END: .bmad-core/tasks/trace-requirements.md ====================
==================== START: bmad-core/templates/qa-gate-tmpl.yaml ====================
==================== START: .bmad-core/templates/qa-gate-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: qa-gate-template-v1
@@ -1847,9 +1853,9 @@ optional_fields_examples:
future: # Can be addressed later
- action: "Consider caching for better performance"
refs: ["services/data.service.ts"]
==================== END: bmad-core/templates/qa-gate-tmpl.yaml ====================
==================== END: .bmad-core/templates/qa-gate-tmpl.yaml ====================
==================== START: bmad-core/templates/story-tmpl.yaml ====================
==================== START: .bmad-core/templates/story-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: story-template-v2
@@ -1988,11 +1994,12 @@ sections:
instruction: Results from QA Agent QA review of the completed story implementation
owner: qa-agent
editors: [qa-agent]
==================== END: bmad-core/templates/story-tmpl.yaml ====================
==================== END: .bmad-core/templates/story-tmpl.yaml ====================
==================== START: bmad-core/data/technical-preferences.md ====================
==================== START: .bmad-core/data/technical-preferences.md ====================
<!-- Powered by BMAD™ Core -->
# User-Defined Preferred Patterns and Preferences
None Listed
==================== END: bmad-core/data/technical-preferences.md ====================
==================== END: .bmad-core/data/technical-preferences.md ====================

52
dist/agents/sm.txt vendored
View File

@@ -8,13 +8,13 @@ You are now operating as a specialized AI agent from the BMad-Method framework.
2. **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
- `==================== START: bmad-core/folder/filename.md ====================`
- `==================== END: bmad-core/folder/filename.md ====================`
- `==================== START: .bmad-core/folder/filename.md ====================`
- `==================== END: .bmad-core/folder/filename.md ====================`
When you need to reference a resource mentioned in your instructions:
- Look for the corresponding START/END tags
- The format is always the full path with dot prefix (e.g., `bmad-core/personas/analyst.md`, `bmad-core/tasks/create-story.md`)
- The format is always the full path with dot prefix (e.g., `.bmad-core/personas/analyst.md`, `.bmad-core/tasks/create-story.md`)
- If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
**Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
@@ -29,8 +29,8 @@ dependencies:
These references map directly to bundle sections:
- `utils: template-format` → Look for `==================== START: bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: bmad-core/tasks/create-story.md ====================`
- `utils: template-format` → Look for `==================== START: .bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: .bmad-core/tasks/create-story.md ====================`
3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
@@ -39,7 +39,7 @@ These references map directly to bundle sections:
---
==================== START: bmad-core/agents/sm.md ====================
==================== START: .bmad-core/agents/sm.md ====================
# sm
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -82,15 +82,16 @@ dependencies:
templates:
- story-tmpl.yaml
```
==================== END: bmad-core/agents/sm.md ====================
==================== END: .bmad-core/agents/sm.md ====================
==================== START: bmad-core/tasks/correct-course.md ====================
==================== START: .bmad-core/tasks/correct-course.md ====================
<!-- Powered by BMAD™ Core -->
# Correct Course Task
## Purpose
- Guide a structured response to a change trigger using the `bmad-core/checklists/change-checklist`.
- Guide a structured response to a change trigger using the `.bmad-core/checklists/change-checklist`.
- Analyze the impacts of the change on epics, project artifacts, and the MVP, guided by the checklist's structure.
- Explore potential solutions (e.g., adjust scope, rollback elements, re-scope features) as prompted by the checklist.
- Draft specific, actionable proposed updates to any affected project artifacts (e.g., epics, user stories, PRD sections, architecture document sections) based on the analysis.
@@ -104,7 +105,7 @@ dependencies:
- **Acknowledge Task & Inputs:**
- Confirm with the user that the "Correct Course Task" (Change Navigation & Integration) is being initiated.
- Verify the change trigger and ensure you have the user's initial explanation of the issue and its perceived impact.
- Confirm access to all relevant project artifacts (e.g., PRD, Epics/Stories, Architecture Documents, UI/UX Specifications) and, critically, the `bmad-core/checklists/change-checklist`.
- Confirm access to all relevant project artifacts (e.g., PRD, Epics/Stories, Architecture Documents, UI/UX Specifications) and, critically, the `.bmad-core/checklists/change-checklist`.
- **Establish Interaction Mode:**
- Ask the user their preferred interaction mode for this task:
- **"Incrementally (Default & Recommended):** Shall we work through the change-checklist section by section, discussing findings and collaboratively drafting proposed changes for each relevant part before moving to the next? This allows for detailed, step-by-step refinement."
@@ -156,10 +157,11 @@ dependencies:
- A summary of the change-checklist analysis (issue, impact, rationale for the chosen path).
- Specific, clearly drafted proposed edits for all affected project artifacts.
- **Implicit:** An annotated change-checklist (or the record of its completion) reflecting the discussions, findings, and decisions made during the process.
==================== END: bmad-core/tasks/correct-course.md ====================
==================== END: .bmad-core/tasks/correct-course.md ====================
==================== START: bmad-core/tasks/create-next-story.md ====================
==================== START: .bmad-core/tasks/create-next-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Next Story Task
## Purpose
@@ -170,7 +172,7 @@ To identify the next logical story based on project progress and epic definition
### 0. Load Core Configuration and Check Workflow
- Load `bmad-core/core-config.yaml` from the project root
- Load `.bmad-core/core-config.yaml` from the project root
- If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story creation. You can either: 1) Copy it from GITHUB bmad-core/core-config.yaml and configure it for your project OR 2) Run the BMad installer against your project to upgrade and add the file automatically. Please add and configure core-config.yaml before proceeding."
- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`, `workflow.*`
@@ -264,25 +266,26 @@ ALWAYS cite source documents: `[Source: architecture/{filename}.md#{section}]`
- Verify all source references are included for technical details
- Ensure tasks align with both epic requirements and architecture constraints
- Update status to "Draft" and save the story file
- Execute `bmad-core/tasks/execute-checklist` `bmad-core/checklists/story-draft-checklist`
- Execute `.bmad-core/tasks/execute-checklist` `.bmad-core/checklists/story-draft-checklist`
- Provide summary to user including:
- Story created: `{devStoryLocation}/{epicNum}.{storyNum}.story.md`
- Status: Draft
- Key technical components included from architecture docs
- Any deviations or conflicts noted between epic and architecture
- Checklist Results
- Next steps: For Complex stories, suggest the user carefully review the story draft and also optionally have the PO run the task `bmad-core/tasks/validate-next-story`
==================== END: bmad-core/tasks/create-next-story.md ====================
- Next steps: For Complex stories, suggest the user carefully review the story draft and also optionally have the PO run the task `.bmad-core/tasks/validate-next-story`
==================== END: .bmad-core/tasks/create-next-story.md ====================
==================== START: bmad-core/tasks/execute-checklist.md ====================
==================== START: .bmad-core/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
## Available Checklists
If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the bmad-core/checklists folder to select the appropriate one to run.
If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the .bmad-core/checklists folder to select the appropriate one to run.
## Instructions
@@ -290,7 +293,7 @@ If the user asks or does not specify a specific checklist, list the checklists a
- If user or the task being run provides a checklist name:
- Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
- If multiple matches found, ask user to clarify
- Load the appropriate checklist from bmad-core/checklists/
- Load the appropriate checklist from .bmad-core/checklists/
- If no checklist specified:
- Ask the user which checklist they want to use
- Present the available options from the files in the checklists folder
@@ -362,9 +365,9 @@ The LLM will:
- Execute the complete checklist validation
- Present a final report with pass/fail rates and key findings
- Offer to provide detailed analysis of any section, especially those with warnings or failures
==================== END: bmad-core/tasks/execute-checklist.md ====================
==================== END: .bmad-core/tasks/execute-checklist.md ====================
==================== START: bmad-core/templates/story-tmpl.yaml ====================
==================== START: .bmad-core/templates/story-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: story-template-v2
@@ -503,10 +506,11 @@ sections:
instruction: Results from QA Agent QA review of the completed story implementation
owner: qa-agent
editors: [qa-agent]
==================== END: bmad-core/templates/story-tmpl.yaml ====================
==================== END: .bmad-core/templates/story-tmpl.yaml ====================
==================== START: bmad-core/checklists/story-draft-checklist.md ====================
==================== START: .bmad-core/checklists/story-draft-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Story Draft Checklist
The Scrum Master should use this checklist to validate that each story contains sufficient context for a developer agent to implement it successfully, while assuming the dev agent has reasonable capabilities to figure things out.
@@ -660,4 +664,4 @@ Be pragmatic - perfect documentation doesn't exist, but it must be enough to pro
- READY: The story provides sufficient context for implementation
- NEEDS REVISION: The story requires updates (see issues)
- BLOCKED: External information required (specify what information)
==================== END: bmad-core/checklists/story-draft-checklist.md ====================
==================== END: .bmad-core/checklists/story-draft-checklist.md ====================

View File

@@ -8,13 +8,13 @@ You are now operating as a specialized AI agent from the BMad-Method framework.
2. **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
- `==================== START: bmad-core/folder/filename.md ====================`
- `==================== END: bmad-core/folder/filename.md ====================`
- `==================== START: .bmad-core/folder/filename.md ====================`
- `==================== END: .bmad-core/folder/filename.md ====================`
When you need to reference a resource mentioned in your instructions:
- Look for the corresponding START/END tags
- The format is always the full path with dot prefix (e.g., `bmad-core/personas/analyst.md`, `bmad-core/tasks/create-story.md`)
- The format is always the full path with dot prefix (e.g., `.bmad-core/personas/analyst.md`, `.bmad-core/tasks/create-story.md`)
- If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
**Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
@@ -29,8 +29,8 @@ dependencies:
These references map directly to bundle sections:
- `utils: template-format` → Look for `==================== START: bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: bmad-core/tasks/create-story.md ====================`
- `utils: template-format` → Look for `==================== START: .bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: .bmad-core/tasks/create-story.md ====================`
3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
@@ -39,7 +39,7 @@ These references map directly to bundle sections:
---
==================== START: bmad-core/agents/ux-expert.md ====================
==================== START: .bmad-core/agents/ux-expert.md ====================
# ux-expert
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -86,10 +86,11 @@ dependencies:
templates:
- front-end-spec-tmpl.yaml
```
==================== END: bmad-core/agents/ux-expert.md ====================
==================== END: .bmad-core/agents/ux-expert.md ====================
==================== START: bmad-core/tasks/create-doc.md ====================
==================== START: .bmad-core/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -107,7 +108,7 @@ When this task is invoked:
## Critical: Template Discovery
If a YAML Template has not been provided, list all templates from bmad-core/templates or ask the user to provide another.
If a YAML Template has not been provided, list all templates from .bmad-core/templates or ask the user to provide another.
## CRITICAL: Mandatory Elicitation Format
@@ -191,17 +192,18 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
- Select options 2-9 from data/elicitation-methods only
- Provide detailed rationale explaining decisions
- End with "Select 1-9 or just type your question/feedback:"
==================== END: bmad-core/tasks/create-doc.md ====================
==================== END: .bmad-core/tasks/create-doc.md ====================
==================== START: bmad-core/tasks/execute-checklist.md ====================
==================== START: .bmad-core/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
## Available Checklists
If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the bmad-core/checklists folder to select the appropriate one to run.
If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the .bmad-core/checklists folder to select the appropriate one to run.
## Instructions
@@ -209,7 +211,7 @@ If the user asks or does not specify a specific checklist, list the checklists a
- If user or the task being run provides a checklist name:
- Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
- If multiple matches found, ask user to clarify
- Load the appropriate checklist from bmad-core/checklists/
- Load the appropriate checklist from .bmad-core/checklists/
- If no checklist specified:
- Ask the user which checklist they want to use
- Present the available options from the files in the checklists folder
@@ -281,10 +283,11 @@ The LLM will:
- Execute the complete checklist validation
- Present a final report with pass/fail rates and key findings
- Offer to provide detailed analysis of any section, especially those with warnings or failures
==================== END: bmad-core/tasks/execute-checklist.md ====================
==================== END: .bmad-core/tasks/execute-checklist.md ====================
==================== START: bmad-core/tasks/generate-ai-frontend-prompt.md ====================
==================== START: .bmad-core/tasks/generate-ai-frontend-prompt.md ====================
<!-- Powered by BMAD™ Core -->
# Create AI Frontend Prompt Task
## Purpose
@@ -336,9 +339,9 @@ You will now synthesize the inputs and the above principles into a final, compre
- Output the complete, generated prompt in a clear, copy-pasteable format (e.g., a large code block).
- Explain the structure of the prompt and why certain information was included, referencing the principles above.
- <important_note>Conclude by reminding the user that all AI-generated code will require careful human review, testing, and refinement to be considered production-ready.</important_note>
==================== END: bmad-core/tasks/generate-ai-frontend-prompt.md ====================
==================== END: .bmad-core/tasks/generate-ai-frontend-prompt.md ====================
==================== START: bmad-core/templates/front-end-spec-tmpl.yaml ====================
==================== START: .bmad-core/templates/front-end-spec-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: frontend-spec-template-v2
@@ -689,11 +692,12 @@ sections:
- id: checklist-results
title: Checklist Results
instruction: If a UI/UX checklist exists, run it against this document and report results here.
==================== END: bmad-core/templates/front-end-spec-tmpl.yaml ====================
==================== END: .bmad-core/templates/front-end-spec-tmpl.yaml ====================
==================== START: bmad-core/data/technical-preferences.md ====================
==================== START: .bmad-core/data/technical-preferences.md ====================
<!-- Powered by BMAD™ Core -->
# User-Defined Preferred Patterns and Preferences
None Listed
==================== END: bmad-core/data/technical-preferences.md ====================
==================== END: .bmad-core/data/technical-preferences.md ====================

View File

@@ -96,6 +96,7 @@ dependencies:
==================== START: .bmad-2d-phaser-game-dev/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -113,7 +114,7 @@ When this task is invoked:
## Critical: Template Discovery
If a YAML Template has not been provided, list all templates from bmad-core/templates or ask the user to provide another.
If a YAML Template has not been provided, list all templates from .bmad-core/templates or ask the user to provide another.
## CRITICAL: Mandatory Elicitation Format
@@ -201,6 +202,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-2d-phaser-game-dev/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -291,6 +293,7 @@ The LLM will:
==================== START: .bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md ====================
<!-- Powered by BMAD™ Core -->
# Game Design Brainstorming Techniques Task
This task provides a comprehensive toolkit of creative brainstorming techniques specifically designed for game design ideation and innovative thinking. The game designer can use these techniques to facilitate productive brainstorming sessions focused on game mechanics, player experience, and creative concepts.
@@ -585,6 +588,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
==================== START: .bmad-2d-phaser-game-dev/tasks/create-deep-research-prompt.md ====================
<!-- Powered by BMAD™ Core -->
# Create Deep Research Prompt Task
This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation.
@@ -867,6 +871,7 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
==================== START: .bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Game Design Elicitation Task
## Purpose
@@ -2176,6 +2181,7 @@ sections:
==================== START: .bmad-2d-phaser-game-dev/checklists/game-design-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Game Design Document Quality Checklist
## Document Completeness

View File

@@ -103,6 +103,7 @@ dependencies:
==================== START: .bmad-2d-phaser-game-dev/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -810,6 +811,7 @@ sections:
==================== START: .bmad-2d-phaser-game-dev/checklists/game-story-dod-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Game Development Story Definition of Done Checklist
## Story Completeness
@@ -974,6 +976,7 @@ _Any specific concerns, recommendations, or clarifications needed before develop
==================== START: .bmad-2d-phaser-game-dev/data/development-guidelines.md ====================
<!-- Powered by BMAD™ Core -->
# Game Development Guidelines
## Overview

View File

@@ -89,6 +89,7 @@ dependencies:
==================== START: .bmad-2d-phaser-game-dev/tasks/create-game-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Game Development Story Task
## Purpose
@@ -309,6 +310,7 @@ This task ensures game development stories are immediately actionable and enable
==================== START: .bmad-2d-phaser-game-dev/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -656,6 +658,7 @@ sections:
==================== START: .bmad-2d-phaser-game-dev/checklists/game-story-dod-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Game Development Story Definition of Done Checklist
## Story Completeness

View File

@@ -414,6 +414,7 @@ dependencies:
==================== START: .bmad-2d-phaser-game-dev/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# Game Development BMad Knowledge Base
## Overview
@@ -668,6 +669,7 @@ This knowledge base provides the foundation for effective game development using
==================== START: .bmad-2d-phaser-game-dev/data/brainstorming-techniques.md ====================
<!-- Powered by BMAD™ Core -->
# Brainstorming Techniques Data
## Creative Expansion
@@ -708,6 +710,7 @@ This knowledge base provides the foundation for effective game development using
==================== START: .bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Game Design Elicitation Task
## Purpose
@@ -822,6 +825,7 @@ The questions and perspectives offered should always consider:
==================== START: .bmad-2d-phaser-game-dev/tasks/create-deep-research-prompt.md ====================
<!-- Powered by BMAD™ Core -->
# Create Deep Research Prompt Task
This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation.
@@ -1104,6 +1108,7 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
==================== START: .bmad-2d-phaser-game-dev/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -1121,7 +1126,7 @@ When this task is invoked:
## Critical: Template Discovery
If a YAML Template has not been provided, list all templates from bmad-core/templates or ask the user to provide another.
If a YAML Template has not been provided, list all templates from .bmad-core/templates or ask the user to provide another.
## CRITICAL: Mandatory Elicitation Format
@@ -1209,6 +1214,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-2d-phaser-game-dev/tasks/document-project.md ====================
<!-- Powered by BMAD™ Core -->
# Document an Existing Project
## Purpose
@@ -1555,10 +1561,11 @@ Apply the advanced elicitation task after major sections to refine based on user
==================== END: .bmad-2d-phaser-game-dev/tasks/document-project.md ====================
==================== START: .bmad-2d-phaser-game-dev/tasks/facilitate-brainstorming-session.md ====================
<!-- Powered by BMAD™ Core -->
---
## <!-- Powered by BMAD™ Core -->
docOutputLocation: docs/brainstorming-session-results.md
template: '.bmad-2d-phaser-game-dev/templates/brainstorming-output-tmpl.yaml'
---
# Facilitate Brainstorming Session Task
@@ -2646,6 +2653,7 @@ sections:
==================== START: .bmad-2d-phaser-game-dev/data/elicitation-methods.md ====================
<!-- Powered by BMAD™ Core -->
# Elicitation Methods Data
## Core Reflective Methods
@@ -2804,6 +2812,7 @@ sections:
==================== START: .bmad-2d-phaser-game-dev/tasks/kb-mode-interaction.md ====================
<!-- Powered by BMAD™ Core -->
# KB Mode Interaction Task
## Purpose
@@ -2883,6 +2892,7 @@ Or ask me about anything else related to BMad-Method!
==================== START: .bmad-2d-phaser-game-dev/utils/workflow-management.md ====================
<!-- Powered by BMAD™ Core -->
# Workflow Management
Enables BMad orchestrator to manage and execute team workflows.
@@ -2956,6 +2966,7 @@ Agents should be workflow-aware: know active workflow, their role, access artifa
==================== START: .bmad-2d-phaser-game-dev/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -3046,6 +3057,7 @@ The LLM will:
==================== START: .bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md ====================
<!-- Powered by BMAD™ Core -->
# Game Design Brainstorming Techniques Task
This task provides a comprehensive toolkit of creative brainstorming techniques specifically designed for game design ideation and innovative thinking. The game designer can use these techniques to facilitate productive brainstorming sessions focused on game mechanics, player experience, and creative concepts.
@@ -4535,6 +4547,7 @@ sections:
==================== START: .bmad-2d-phaser-game-dev/checklists/game-design-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Game Design Document Quality Checklist
## Document Completeness
@@ -5357,6 +5370,7 @@ sections:
==================== START: .bmad-2d-phaser-game-dev/checklists/game-story-dod-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Game Development Story Definition of Done Checklist
## Story Completeness
@@ -5521,6 +5535,7 @@ _Any specific concerns, recommendations, or clarifications needed before develop
==================== START: .bmad-2d-phaser-game-dev/data/development-guidelines.md ====================
<!-- Powered by BMAD™ Core -->
# Game Development Guidelines
## Overview
@@ -6172,6 +6187,7 @@ These guidelines ensure consistent, high-quality game development that meets per
==================== START: .bmad-2d-phaser-game-dev/tasks/create-game-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Game Development Story Task
## Purpose
@@ -8718,6 +8734,7 @@ sections:
==================== START: .bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Game Design Elicitation Task
## Purpose
@@ -8832,6 +8849,7 @@ The questions and perspectives offered should always consider:
==================== START: .bmad-2d-phaser-game-dev/tasks/create-game-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Game Development Story Task
## Purpose
@@ -9052,6 +9070,7 @@ This task ensures game development stories are immediately actionable and enable
==================== START: .bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md ====================
<!-- Powered by BMAD™ Core -->
# Game Design Brainstorming Techniques Task
This task provides a comprehensive toolkit of creative brainstorming techniques specifically designed for game design ideation and innovative thinking. The game designer can use these techniques to facilitate productive brainstorming sessions focused on game mechanics, player experience, and creative concepts.
@@ -9346,6 +9365,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
==================== START: .bmad-2d-phaser-game-dev/checklists/game-design-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Game Design Document Quality Checklist
## Document Completeness
@@ -9551,6 +9571,7 @@ _Outline immediate next actions for the team based on this assessment._
==================== START: .bmad-2d-phaser-game-dev/checklists/game-story-dod-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Game Development Story Definition of Done Checklist
## Story Completeness
@@ -10081,6 +10102,7 @@ workflow:
==================== START: .bmad-2d-phaser-game-dev/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# Game Development BMad Knowledge Base
## Overview
@@ -10335,6 +10357,7 @@ This knowledge base provides the foundation for effective game development using
==================== START: .bmad-2d-phaser-game-dev/data/development-guidelines.md ====================
<!-- Powered by BMAD™ Core -->
# Game Development Guidelines
## Overview

View File

@@ -104,6 +104,7 @@ dependencies:
==================== START: .bmad-2d-unity-game-dev/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -121,7 +122,7 @@ When this task is invoked:
## Critical: Template Discovery
If a YAML Template has not been provided, list all templates from bmad-core/templates or ask the user to provide another.
If a YAML Template has not been provided, list all templates from .bmad-core/templates or ask the user to provide another.
## CRITICAL: Mandatory Elicitation Format
@@ -209,6 +210,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-2d-unity-game-dev/tasks/create-deep-research-prompt.md ====================
<!-- Powered by BMAD™ Core -->
# Create Deep Research Prompt Task
This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation.
@@ -491,6 +493,7 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
==================== START: .bmad-2d-unity-game-dev/tasks/shard-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Document Sharding Task
## Purpose
@@ -680,6 +683,7 @@ Document sharded successfully:
==================== START: .bmad-2d-unity-game-dev/tasks/document-project.md ====================
<!-- Powered by BMAD™ Core -->
# Document an Existing Project
## Purpose
@@ -1027,6 +1031,7 @@ Apply the advanced elicitation task after major sections to refine based on user
==================== START: .bmad-2d-unity-game-dev/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -1117,6 +1122,7 @@ The LLM will:
==================== START: .bmad-2d-unity-game-dev/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Game Design Elicitation Task
## Purpose
@@ -2265,6 +2271,7 @@ sections:
==================== START: .bmad-2d-unity-game-dev/checklists/game-architect-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Game Architect Solution Validation Checklist
This checklist serves as a comprehensive framework for the Game Architect to validate the technical design and architecture before game development execution. The Game Architect should systematically work through each item, ensuring the game architecture is robust, scalable, performant, and aligned with the Game Design Document requirements.
@@ -2660,6 +2667,7 @@ After presenting the report, ask the user if they would like detailed analysis o
==================== START: .bmad-2d-unity-game-dev/data/development-guidelines.md ====================
<!-- Powered by BMAD™ Core -->
# Game Development Guidelines (Unity & C#)
## Overview
@@ -3250,6 +3258,7 @@ These guidelines ensure consistent, high-quality game development that meets per
==================== START: .bmad-2d-unity-game-dev/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMad Knowledge Base - 2D Unity Game Development
## Overview
@@ -3382,7 +3391,7 @@ npx bmad-method install
**Verify Game Development Installation**:
- `bmad-core/` folder created with all core agents
- `.bmad-core/` folder created with all core agents
- `.bmad-2d-unity-game-dev/` folder with game development agents
- IDE-specific integration files created
- Game development agents available with `/bmad2du` prefix (per config.yaml)

View File

@@ -101,6 +101,7 @@ dependencies:
==================== START: .bmad-2d-unity-game-dev/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -118,7 +119,7 @@ When this task is invoked:
## Critical: Template Discovery
If a YAML Template has not been provided, list all templates from bmad-core/templates or ask the user to provide another.
If a YAML Template has not been provided, list all templates from .bmad-core/templates or ask the user to provide another.
## CRITICAL: Mandatory Elicitation Format
@@ -206,6 +207,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-2d-unity-game-dev/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -296,6 +298,7 @@ The LLM will:
==================== START: .bmad-2d-unity-game-dev/tasks/shard-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Document Sharding Task
## Purpose
@@ -485,6 +488,7 @@ Document sharded successfully:
==================== START: .bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md ====================
<!-- Powered by BMAD™ Core -->
# Game Design Brainstorming Techniques Task
This task provides a comprehensive toolkit of creative brainstorming techniques specifically designed for game design ideation and innovative thinking. The game designer can use these techniques to facilitate productive brainstorming sessions focused on game mechanics, player experience, and creative concepts.
@@ -779,6 +783,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
==================== START: .bmad-2d-unity-game-dev/tasks/create-deep-research-prompt.md ====================
<!-- Powered by BMAD™ Core -->
# Create Deep Research Prompt Task
This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation.
@@ -1061,6 +1066,7 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
==================== START: .bmad-2d-unity-game-dev/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Game Design Elicitation Task
## Purpose
@@ -2732,6 +2738,7 @@ sections:
==================== START: .bmad-2d-unity-game-dev/checklists/game-design-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Game Design Document Quality Checklist
## Document Completeness
@@ -2937,6 +2944,7 @@ _Outline immediate next actions for the team based on this assessment._
==================== START: .bmad-2d-unity-game-dev/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMad Knowledge Base - 2D Unity Game Development
## Overview
@@ -3069,7 +3077,7 @@ npx bmad-method install
**Verify Game Development Installation**:
- `bmad-core/` folder created with all core agents
- `.bmad-core/` folder created with all core agents
- `.bmad-2d-unity-game-dev/` folder with game development agents
- IDE-specific integration files created
- Game development agents available with `/bmad2du` prefix (per config.yaml)

View File

@@ -98,6 +98,7 @@ dependencies:
==================== START: .bmad-2d-unity-game-dev/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -188,6 +189,7 @@ The LLM will:
==================== START: .bmad-2d-unity-game-dev/tasks/validate-next-story.md ====================
<!-- Powered by BMAD™ Core -->
# Validate Next Story Task
## Purpose
@@ -198,7 +200,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
### 0. Load Core Configuration and Inputs
- Load `bmad-core/core-config.yaml`
- Load `.bmad-core/core-config.yaml`
- If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story validation."
- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`
- Identify and load the following inputs:
@@ -326,6 +328,7 @@ Provide a structured validation report including:
==================== START: .bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Game Development Story Definition of Done (DoD) Checklist
## Instructions for Developer Agent

View File

@@ -89,6 +89,7 @@ dependencies:
==================== START: .bmad-2d-unity-game-dev/tasks/create-game-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Game Story Task
## Purpose
@@ -277,6 +278,7 @@ This task ensures game development stories are immediately actionable and enable
==================== START: .bmad-2d-unity-game-dev/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -367,6 +369,7 @@ The LLM will:
==================== START: .bmad-2d-unity-game-dev/tasks/correct-course-game.md ====================
<!-- Powered by BMAD™ Core -->
# Correct Course Task - Game Development
## Purpose
@@ -772,6 +775,7 @@ sections:
==================== START: .bmad-2d-unity-game-dev/checklists/game-change-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Game Development Change Navigation Checklist
**Purpose:** To systematically guide the Game SM agent and user through analysis and planning when a significant change (performance issue, platform constraint, technical blocker, gameplay feedback) is identified during Unity game development.

View File

@@ -478,6 +478,7 @@ dependencies:
==================== START: .bmad-2d-unity-game-dev/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMad Knowledge Base - 2D Unity Game Development
## Overview
@@ -610,7 +611,7 @@ npx bmad-method install
**Verify Game Development Installation**:
- `bmad-core/` folder created with all core agents
- `.bmad-core/` folder created with all core agents
- `.bmad-2d-unity-game-dev/` folder with game development agents
- IDE-specific integration files created
- Game development agents available with `/bmad2du` prefix (per config.yaml)
@@ -1251,6 +1252,7 @@ This knowledge base provides the foundation for effective game development using
==================== START: .bmad-2d-unity-game-dev/data/brainstorming-techniques.md ====================
<!-- Powered by BMAD™ Core -->
# Brainstorming Techniques Data
## Creative Expansion
@@ -1291,6 +1293,7 @@ This knowledge base provides the foundation for effective game development using
==================== START: .bmad-2d-unity-game-dev/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Game Design Elicitation Task
## Purpose
@@ -1405,6 +1408,7 @@ The questions and perspectives offered should always consider:
==================== START: .bmad-2d-unity-game-dev/tasks/create-deep-research-prompt.md ====================
<!-- Powered by BMAD™ Core -->
# Create Deep Research Prompt Task
This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation.
@@ -1687,6 +1691,7 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
==================== START: .bmad-2d-unity-game-dev/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -1704,7 +1709,7 @@ When this task is invoked:
## Critical: Template Discovery
If a YAML Template has not been provided, list all templates from bmad-core/templates or ask the user to provide another.
If a YAML Template has not been provided, list all templates from .bmad-core/templates or ask the user to provide another.
## CRITICAL: Mandatory Elicitation Format
@@ -1792,6 +1797,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-2d-unity-game-dev/tasks/document-project.md ====================
<!-- Powered by BMAD™ Core -->
# Document an Existing Project
## Purpose
@@ -2138,10 +2144,11 @@ Apply the advanced elicitation task after major sections to refine based on user
==================== END: .bmad-2d-unity-game-dev/tasks/document-project.md ====================
==================== START: .bmad-2d-unity-game-dev/tasks/facilitate-brainstorming-session.md ====================
<!-- Powered by BMAD™ Core -->
---
## <!-- Powered by BMAD™ Core -->
docOutputLocation: docs/brainstorming-session-results.md
template: '.bmad-2d-unity-game-dev/templates/brainstorming-output-tmpl.yaml'
---
# Facilitate Brainstorming Session Task
@@ -3229,6 +3236,7 @@ sections:
==================== START: .bmad-2d-unity-game-dev/data/elicitation-methods.md ====================
<!-- Powered by BMAD™ Core -->
# Elicitation Methods Data
## Core Reflective Methods
@@ -3387,6 +3395,7 @@ sections:
==================== START: .bmad-2d-unity-game-dev/tasks/kb-mode-interaction.md ====================
<!-- Powered by BMAD™ Core -->
# KB Mode Interaction Task
## Purpose
@@ -3466,6 +3475,7 @@ Or ask me about anything else related to BMad-Method!
==================== START: .bmad-2d-unity-game-dev/utils/workflow-management.md ====================
<!-- Powered by BMAD™ Core -->
# Workflow Management
Enables BMad orchestrator to manage and execute team workflows.
@@ -3539,6 +3549,7 @@ Agents should be workflow-aware: know active workflow, their role, access artifa
==================== START: .bmad-2d-unity-game-dev/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -3629,6 +3640,7 @@ The LLM will:
==================== START: .bmad-2d-unity-game-dev/tasks/shard-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Document Sharding Task
## Purpose
@@ -3818,6 +3830,7 @@ Document sharded successfully:
==================== START: .bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md ====================
<!-- Powered by BMAD™ Core -->
# Game Design Brainstorming Techniques Task
This task provides a comprehensive toolkit of creative brainstorming techniques specifically designed for game design ideation and innovative thinking. The game designer can use these techniques to facilitate productive brainstorming sessions focused on game mechanics, player experience, and creative concepts.
@@ -5669,6 +5682,7 @@ sections:
==================== START: .bmad-2d-unity-game-dev/checklists/game-design-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Game Design Document Quality Checklist
## Document Completeness
@@ -6908,6 +6922,7 @@ sections:
==================== START: .bmad-2d-unity-game-dev/checklists/game-architect-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Game Architect Solution Validation Checklist
This checklist serves as a comprehensive framework for the Game Architect to validate the technical design and architecture before game development execution. The Game Architect should systematically work through each item, ensuring the game architecture is robust, scalable, performant, and aligned with the Game Design Document requirements.
@@ -7303,6 +7318,7 @@ After presenting the report, ask the user if they would like detailed analysis o
==================== START: .bmad-2d-unity-game-dev/data/development-guidelines.md ====================
<!-- Powered by BMAD™ Core -->
# Game Development Guidelines (Unity & C#)
## Overview
@@ -7893,6 +7909,7 @@ These guidelines ensure consistent, high-quality game development that meets per
==================== START: .bmad-2d-unity-game-dev/tasks/validate-next-story.md ====================
<!-- Powered by BMAD™ Core -->
# Validate Next Story Task
## Purpose
@@ -7903,7 +7920,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
### 0. Load Core Configuration and Inputs
- Load `bmad-core/core-config.yaml`
- Load `.bmad-core/core-config.yaml`
- If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story validation."
- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`
- Identify and load the following inputs:
@@ -8031,6 +8048,7 @@ Provide a structured validation report including:
==================== START: .bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Game Development Story Definition of Done (DoD) Checklist
## Instructions for Developer Agent
@@ -8159,6 +8177,7 @@ Be honest - it's better to flag issues now than have them discovered during play
==================== START: .bmad-2d-unity-game-dev/tasks/create-game-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Game Story Task
## Purpose
@@ -8347,6 +8366,7 @@ This task ensures game development stories are immediately actionable and enable
==================== START: .bmad-2d-unity-game-dev/tasks/correct-course-game.md ====================
<!-- Powered by BMAD™ Core -->
# Correct Course Task - Game Development
## Purpose
@@ -8752,6 +8772,7 @@ sections:
==================== START: .bmad-2d-unity-game-dev/checklists/game-change-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Game Development Change Navigation Checklist
**Purpose:** To systematically guide the Game SM agent and user through analysis and planning when a significant change (performance issue, platform constraint, technical blocker, gameplay feedback) is identified during Unity game development.
@@ -11810,6 +11831,7 @@ sections:
==================== START: .bmad-2d-unity-game-dev/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Game Design Elicitation Task
## Purpose
@@ -11924,6 +11946,7 @@ The questions and perspectives offered should always consider:
==================== START: .bmad-2d-unity-game-dev/tasks/correct-course-game.md ====================
<!-- Powered by BMAD™ Core -->
# Correct Course Task - Game Development
## Purpose
@@ -12069,6 +12092,7 @@ Based on the analysis and agreed path forward:
==================== START: .bmad-2d-unity-game-dev/tasks/create-game-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Game Story Task
## Purpose
@@ -12257,6 +12281,7 @@ This task ensures game development stories are immediately actionable and enable
==================== START: .bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md ====================
<!-- Powered by BMAD™ Core -->
# Game Design Brainstorming Techniques Task
This task provides a comprehensive toolkit of creative brainstorming techniques specifically designed for game design ideation and innovative thinking. The game designer can use these techniques to facilitate productive brainstorming sessions focused on game mechanics, player experience, and creative concepts.
@@ -12551,6 +12576,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
==================== START: .bmad-2d-unity-game-dev/tasks/validate-game-story.md ====================
<!-- Powered by BMAD™ Core -->
# Validate Game Story Task
## Purpose
@@ -12755,6 +12781,7 @@ Based on validation results, provide specific recommendations for:
==================== START: .bmad-2d-unity-game-dev/checklists/game-architect-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Game Architect Solution Validation Checklist
This checklist serves as a comprehensive framework for the Game Architect to validate the technical design and architecture before game development execution. The Game Architect should systematically work through each item, ensuring the game architecture is robust, scalable, performant, and aligned with the Game Design Document requirements.
@@ -13150,6 +13177,7 @@ After presenting the report, ask the user if they would like detailed analysis o
==================== START: .bmad-2d-unity-game-dev/checklists/game-change-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Game Development Change Navigation Checklist
**Purpose:** To systematically guide the Game SM agent and user through analysis and planning when a significant change (performance issue, platform constraint, technical blocker, gameplay feedback) is identified during Unity game development.
@@ -13357,6 +13385,7 @@ Keep it technically precise and actionable.]]
==================== START: .bmad-2d-unity-game-dev/checklists/game-design-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Game Design Document Quality Checklist
## Document Completeness
@@ -13562,6 +13591,7 @@ _Outline immediate next actions for the team based on this assessment._
==================== START: .bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Game Development Story Definition of Done (DoD) Checklist
## Instructions for Developer Agent
@@ -14056,6 +14086,7 @@ workflow:
==================== START: .bmad-2d-unity-game-dev/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMad Knowledge Base - 2D Unity Game Development
## Overview
@@ -14188,7 +14219,7 @@ npx bmad-method install
**Verify Game Development Installation**:
- `bmad-core/` folder created with all core agents
- `.bmad-core/` folder created with all core agents
- `.bmad-2d-unity-game-dev/` folder with game development agents
- IDE-specific integration files created
- Game development agents available with `/bmad2du` prefix (per config.yaml)
@@ -14829,6 +14860,7 @@ This knowledge base provides the foundation for effective game development using
==================== START: .bmad-2d-unity-game-dev/data/development-guidelines.md ====================
<!-- Powered by BMAD™ Core -->
# Game Development Guidelines (Unity & C#)
## Overview

View File

@@ -117,6 +117,7 @@ Remember to present all options as numbered lists for easy selection.
==================== START: .bmad-creative-writing/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -222,6 +223,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-creative-writing/tasks/provide-feedback.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 5. Provide Feedback (Beta)
@@ -248,6 +250,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/quick-feedback.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 13. Quick Feedback (Serial)
@@ -272,6 +275,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/analyze-reader-feedback.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 16. Analyze Reader Feedback
@@ -297,6 +301,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -387,6 +392,7 @@ The LLM will:
==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -608,6 +614,7 @@ sections:
==================== START: .bmad-creative-writing/checklists/beta-feedback-closure-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 6. BetaFeedback Closure Checklist
@@ -633,6 +640,7 @@ items:
==================== START: .bmad-creative-writing/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMad Creative Writing Knowledge Base
## Overview
@@ -844,6 +852,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
==================== START: .bmad-creative-writing/data/story-structures.md ====================
<!-- Powered by BMAD™ Core -->
# Story Structure Patterns
## Three-Act Structure

View File

@@ -116,6 +116,7 @@ Remember to present all options as numbered lists for easy selection.
==================== START: .bmad-creative-writing/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -221,6 +222,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-creative-writing/tasks/develop-character.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 3. Develop Character
@@ -247,6 +249,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/workshop-dialog.md ====================
<!-- Powered by BMAD™ Core -->
# Workshop Dialog
## Purpose
@@ -313,6 +316,7 @@ Refined dialog with stronger voices and dramatic impact
==================== START: .bmad-creative-writing/tasks/character-depth-pass.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 9. Character Depth Pass
@@ -337,6 +341,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -427,6 +432,7 @@ The LLM will:
==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -643,6 +649,7 @@ sections:
==================== START: .bmad-creative-writing/checklists/character-consistency-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 1. Character Consistency Checklist
@@ -668,6 +675,7 @@ items:
==================== START: .bmad-creative-writing/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMad Creative Writing Knowledge Base
## Overview

View File

@@ -115,6 +115,7 @@ Remember to present all options as numbered lists for easy selection.
==================== START: .bmad-creative-writing/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -220,6 +221,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-creative-writing/tasks/workshop-dialog.md ====================
<!-- Powered by BMAD™ Core -->
# Workshop Dialog
## Purpose
@@ -286,6 +288,7 @@ Refined dialog with stronger voices and dramatic impact
==================== START: .bmad-creative-writing/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -376,6 +379,7 @@ The LLM will:
==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -592,6 +596,7 @@ sections:
==================== START: .bmad-creative-writing/checklists/comedic-timing-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 23. Comedic Timing & Humor Checklist
@@ -617,6 +622,7 @@ items:
==================== START: .bmad-creative-writing/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMad Creative Writing Knowledge Base
## Overview
@@ -828,6 +834,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
==================== START: .bmad-creative-writing/data/story-structures.md ====================
<!-- Powered by BMAD™ Core -->
# Story Structure Patterns
## Three-Act Structure

View File

@@ -116,6 +116,7 @@ Remember to present all options as numbered lists for easy selection.
==================== START: .bmad-creative-writing/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -221,6 +222,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-creative-writing/tasks/final-polish.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 14. Final Polish
@@ -246,6 +248,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/incorporate-feedback.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 6. Incorporate Feedback
@@ -273,6 +276,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -363,6 +367,7 @@ The LLM will:
==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -569,6 +574,7 @@ sections:
==================== START: .bmad-creative-writing/checklists/line-edit-quality-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 4. LineEdit Quality Checklist
@@ -594,6 +600,7 @@ items:
==================== START: .bmad-creative-writing/checklists/publication-readiness-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 5. Publication Readiness Checklist
@@ -619,6 +626,7 @@ items:
==================== START: .bmad-creative-writing/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMad Creative Writing Knowledge Base
## Overview

View File

@@ -118,6 +118,7 @@ Remember to present all options as numbered lists for easy selection.
==================== START: .bmad-creative-writing/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -223,6 +224,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-creative-writing/tasks/analyze-story-structure.md ====================
<!-- Powered by BMAD™ Core -->
# Analyze Story Structure
## Purpose
@@ -292,6 +294,7 @@ Comprehensive structural analysis with actionable recommendations
==================== START: .bmad-creative-writing/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -382,6 +385,7 @@ The LLM will:
==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -602,6 +606,7 @@ sections:
==================== START: .bmad-creative-writing/checklists/genre-tropes-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 10. Genre Tropes Checklist (General)
@@ -626,6 +631,7 @@ items:
==================== START: .bmad-creative-writing/checklists/fantasy-magic-system-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 17. Fantasy Magic System Consistency Checklist
@@ -651,6 +657,7 @@ items:
==================== START: .bmad-creative-writing/checklists/scifi-technology-plausibility-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 15. SciFi Technology Plausibility Checklist
@@ -675,6 +682,7 @@ items:
==================== START: .bmad-creative-writing/checklists/romance-emotional-beats-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 12. Romance Emotional Beats Checklist
@@ -700,6 +708,7 @@ items:
==================== START: .bmad-creative-writing/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMad Creative Writing Knowledge Base
## Overview
@@ -911,6 +920,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
==================== START: .bmad-creative-writing/data/story-structures.md ====================
<!-- Powered by BMAD™ Core -->
# Story Structure Patterns
## Three-Act Structure

View File

@@ -116,6 +116,7 @@ Remember to present all options as numbered lists for easy selection.
==================== START: .bmad-creative-writing/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -221,6 +222,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-creative-writing/tasks/outline-scenes.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 11. Outline Scenes
@@ -246,6 +248,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/generate-scene-list.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 10. Generate Scene List
@@ -271,6 +274,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -361,6 +365,7 @@ The LLM will:
==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -540,6 +545,7 @@ sections:
==================== START: .bmad-creative-writing/checklists/plot-structure-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Plot Structure Checklist
## Opening
@@ -601,6 +607,7 @@ sections:
==================== START: .bmad-creative-writing/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMad Creative Writing Knowledge Base
## Overview
@@ -812,6 +819,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
==================== START: .bmad-creative-writing/data/story-structures.md ====================
<!-- Powered by BMAD™ Core -->
# Story Structure Patterns
## Three-Act Structure

View File

@@ -118,6 +118,7 @@ Remember to present all options as numbered lists for easy selection.
==================== START: .bmad-creative-writing/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -223,6 +224,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-creative-writing/tasks/analyze-story-structure.md ====================
<!-- Powered by BMAD™ Core -->
# Analyze Story Structure
## Purpose
@@ -292,6 +294,7 @@ Comprehensive structural analysis with actionable recommendations
==================== START: .bmad-creative-writing/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -382,6 +385,7 @@ The LLM will:
==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -826,6 +830,7 @@ sections:
==================== START: .bmad-creative-writing/checklists/plot-structure-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Plot Structure Checklist
## Opening
@@ -887,6 +892,7 @@ sections:
==================== START: .bmad-creative-writing/data/story-structures.md ====================
<!-- Powered by BMAD™ Core -->
# Story Structure Patterns
## Three-Act Structure
@@ -956,6 +962,7 @@ sections:
==================== START: .bmad-creative-writing/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMad Creative Writing Knowledge Base
## Overview

View File

@@ -117,6 +117,7 @@ Remember to present all options as numbered lists for easy selection.
==================== START: .bmad-creative-writing/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -222,6 +223,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-creative-writing/tasks/build-world.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 2. Build World
@@ -248,6 +250,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -338,6 +341,7 @@ The LLM will:
==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -551,6 +555,7 @@ sections:
==================== START: .bmad-creative-writing/checklists/world-building-continuity-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 2. WorldBuilding Continuity Checklist
@@ -576,6 +581,7 @@ items:
==================== START: .bmad-creative-writing/checklists/fantasy-magic-system-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 17. Fantasy Magic System Consistency Checklist
@@ -601,6 +607,7 @@ items:
==================== START: .bmad-creative-writing/checklists/steampunk-gadget-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 25. Steampunk Gadget Plausibility Checklist
@@ -626,6 +633,7 @@ items:
==================== START: .bmad-creative-writing/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMad Creative Writing Knowledge Base
## Overview
@@ -837,6 +845,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
==================== START: .bmad-creative-writing/data/story-structures.md ====================
<!-- Powered by BMAD™ Core -->
# Story Structure Patterns
## Three-Act Structure

View File

@@ -837,6 +837,7 @@ dependencies:
==================== START: .bmad-creative-writing/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMad Creative Writing Knowledge Base
## Overview
@@ -1048,6 +1049,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
==================== START: .bmad-creative-writing/data/elicitation-methods.md ====================
<!-- Powered by BMAD™ Core -->
# Elicitation Methods Data
## Core Reflective Methods
@@ -1206,6 +1208,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -1327,6 +1330,7 @@ Choose a number (0-8) or 9 to proceed:
==================== START: .bmad-creative-writing/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -1432,6 +1436,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-creative-writing/tasks/kb-mode-interaction.md ====================
<!-- Powered by BMAD™ Core -->
# KB Mode Interaction Task
## Purpose
@@ -1511,6 +1516,7 @@ Or ask me about anything else related to BMad-Method!
==================== START: .bmad-creative-writing/utils/workflow-management.md ====================
<!-- Powered by BMAD™ Core -->
# Workflow Management
Enables BMad orchestrator to manage and execute team workflows.
@@ -1584,6 +1590,7 @@ Agents should be workflow-aware: know active workflow, their role, access artifa
==================== START: .bmad-creative-writing/tasks/analyze-story-structure.md ====================
<!-- Powered by BMAD™ Core -->
# Analyze Story Structure
## Purpose
@@ -1653,6 +1660,7 @@ Comprehensive structural analysis with actionable recommendations
==================== START: .bmad-creative-writing/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -2066,6 +2074,7 @@ sections:
==================== START: .bmad-creative-writing/checklists/plot-structure-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Plot Structure Checklist
## Opening
@@ -2127,6 +2136,7 @@ sections:
==================== START: .bmad-creative-writing/data/story-structures.md ====================
<!-- Powered by BMAD™ Core -->
# Story Structure Patterns
## Three-Act Structure
@@ -2196,6 +2206,7 @@ sections:
==================== START: .bmad-creative-writing/tasks/develop-character.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 3. Develop Character
@@ -2222,6 +2233,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/workshop-dialog.md ====================
<!-- Powered by BMAD™ Core -->
# Workshop Dialog
## Purpose
@@ -2288,6 +2300,7 @@ Refined dialog with stronger voices and dramatic impact
==================== START: .bmad-creative-writing/tasks/character-depth-pass.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 9. Character Depth Pass
@@ -2407,6 +2420,7 @@ sections:
==================== START: .bmad-creative-writing/checklists/character-consistency-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 1. Character Consistency Checklist
@@ -2432,6 +2446,7 @@ items:
==================== START: .bmad-creative-writing/tasks/build-world.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 2. Build World
@@ -2550,6 +2565,7 @@ sections:
==================== START: .bmad-creative-writing/checklists/world-building-continuity-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 2. WorldBuilding Continuity Checklist
@@ -2575,6 +2591,7 @@ items:
==================== START: .bmad-creative-writing/checklists/fantasy-magic-system-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 17. Fantasy Magic System Consistency Checklist
@@ -2600,6 +2617,7 @@ items:
==================== START: .bmad-creative-writing/checklists/steampunk-gadget-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 25. Steampunk Gadget Plausibility Checklist
@@ -2625,6 +2643,7 @@ items:
==================== START: .bmad-creative-writing/tasks/final-polish.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 14. Final Polish
@@ -2650,6 +2669,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/incorporate-feedback.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 6. Incorporate Feedback
@@ -2677,6 +2697,7 @@ inputs:
==================== START: .bmad-creative-writing/checklists/line-edit-quality-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 4. LineEdit Quality Checklist
@@ -2702,6 +2723,7 @@ items:
==================== START: .bmad-creative-writing/checklists/publication-readiness-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 5. Publication Readiness Checklist
@@ -2727,6 +2749,7 @@ items:
==================== START: .bmad-creative-writing/tasks/provide-feedback.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 5. Provide Feedback (Beta)
@@ -2753,6 +2776,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/quick-feedback.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 13. Quick Feedback (Serial)
@@ -2777,6 +2801,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/analyze-reader-feedback.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 16. Analyze Reader Feedback
@@ -2902,6 +2927,7 @@ sections:
==================== START: .bmad-creative-writing/checklists/beta-feedback-closure-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 6. BetaFeedback Closure Checklist
@@ -2927,6 +2953,7 @@ items:
==================== START: .bmad-creative-writing/checklists/comedic-timing-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 23. Comedic Timing & Humor Checklist
@@ -2952,6 +2979,7 @@ items:
==================== START: .bmad-creative-writing/tasks/outline-scenes.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 11. Outline Scenes
@@ -2977,6 +3005,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/generate-scene-list.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 10. Generate Scene List
@@ -3002,6 +3031,7 @@ inputs:
==================== START: .bmad-creative-writing/checklists/genre-tropes-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 10. Genre Tropes Checklist (General)
@@ -3026,6 +3056,7 @@ items:
==================== START: .bmad-creative-writing/checklists/scifi-technology-plausibility-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 15. SciFi Technology Plausibility Checklist
@@ -3050,6 +3081,7 @@ items:
==================== START: .bmad-creative-writing/checklists/romance-emotional-beats-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 12. Romance Emotional Beats Checklist
@@ -3786,6 +3818,7 @@ sections:
==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -3907,6 +3940,7 @@ Choose a number (0-8) or 9 to proceed:
==================== START: .bmad-creative-writing/tasks/analyze-reader-feedback.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 16. Analyze Reader Feedback
@@ -3932,6 +3966,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/analyze-story-structure.md ====================
<!-- Powered by BMAD™ Core -->
# Analyze Story Structure
## Purpose
@@ -4001,6 +4036,7 @@ Comprehensive structural analysis with actionable recommendations
==================== START: .bmad-creative-writing/tasks/assemble-kdp-package.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# tasks/assemble-kdp-package.md
@@ -4032,6 +4068,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/brainstorm-premise.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 1. Brainstorm Premise
@@ -4057,6 +4094,7 @@ steps:
==================== START: .bmad-creative-writing/tasks/build-world.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 2. Build World
@@ -4083,6 +4121,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/character-depth-pass.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 9. Character Depth Pass
@@ -4107,6 +4146,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -4212,6 +4252,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-creative-writing/tasks/create-draft-section.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 4. Create Draft Section (Chapter)
@@ -4240,6 +4281,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/develop-character.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 3. Develop Character
@@ -4266,6 +4308,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -4356,6 +4399,7 @@ The LLM will:
==================== START: .bmad-creative-writing/tasks/expand-premise.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 7. Expand Premise (Snowflake Step 2)
@@ -4381,6 +4425,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/expand-synopsis.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 8. Expand Synopsis (Snowflake Step 4)
@@ -4406,6 +4451,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/final-polish.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 14. Final Polish
@@ -4431,6 +4477,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/generate-cover-brief.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# tasks/generate-cover-brief.md
@@ -4458,6 +4505,7 @@ steps:
==================== START: .bmad-creative-writing/tasks/generate-cover-prompts.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# tasks/generate-cover-prompts.md
@@ -4486,6 +4534,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/generate-scene-list.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 10. Generate Scene List
@@ -4511,6 +4560,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/incorporate-feedback.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 6. Incorporate Feedback
@@ -4538,6 +4588,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/outline-scenes.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 11. Outline Scenes
@@ -4563,6 +4614,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/provide-feedback.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 5. Provide Feedback (Beta)
@@ -4589,6 +4641,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/publish-chapter.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 15. Publish Chapter
@@ -4614,6 +4667,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/quick-feedback.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 13. Quick Feedback (Serial)
@@ -4638,6 +4692,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/select-next-arc.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 12. Select Next Arc (Serial)
@@ -4663,6 +4718,7 @@ inputs:
==================== START: .bmad-creative-writing/tasks/workshop-dialog.md ====================
<!-- Powered by BMAD™ Core -->
# Workshop Dialog
## Purpose
@@ -4729,6 +4785,7 @@ Refined dialog with stronger voices and dramatic impact
==================== START: .bmad-creative-writing/checklists/beta-feedback-closure-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 6. BetaFeedback Closure Checklist
@@ -4754,6 +4811,7 @@ items:
==================== START: .bmad-creative-writing/checklists/character-consistency-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 1. Character Consistency Checklist
@@ -4779,6 +4837,7 @@ items:
==================== START: .bmad-creative-writing/checklists/comedic-timing-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 23. Comedic Timing & Humor Checklist
@@ -4804,6 +4863,7 @@ items:
==================== START: .bmad-creative-writing/checklists/cyberpunk-aesthetic-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 24. Cyberpunk Aesthetic Consistency Checklist
@@ -4829,6 +4889,7 @@ items:
==================== START: .bmad-creative-writing/checklists/ebook-formatting-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 14. eBook Formatting Checklist
@@ -4852,6 +4913,7 @@ items:
==================== START: .bmad-creative-writing/checklists/epic-poetry-meter-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 22. Epic Poetry Meter & Form Checklist
@@ -4877,6 +4939,7 @@ items:
==================== START: .bmad-creative-writing/checklists/fantasy-magic-system-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 17. Fantasy Magic System Consistency Checklist
@@ -4902,6 +4965,7 @@ items:
==================== START: .bmad-creative-writing/checklists/foreshadowing-payoff-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 9. Foreshadowing & Payoff Checklist
@@ -4926,6 +4990,7 @@ items:
==================== START: .bmad-creative-writing/checklists/historical-accuracy-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 18. Historical Accuracy Checklist
@@ -4951,6 +5016,7 @@ items:
==================== START: .bmad-creative-writing/checklists/horror-suspense-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 16. Horror Suspense & Scare Checklist
@@ -4976,6 +5042,7 @@ items:
==================== START: .bmad-creative-writing/checklists/kdp-cover-ready-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# checklists/kdp-cover-ready-checklist.md
@@ -5003,6 +5070,7 @@ items:
==================== START: .bmad-creative-writing/checklists/line-edit-quality-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 4. LineEdit Quality Checklist
@@ -5028,6 +5096,7 @@ items:
==================== START: .bmad-creative-writing/checklists/marketing-copy-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 13. Marketing Copy Checklist
@@ -5053,6 +5122,7 @@ items:
==================== START: .bmad-creative-writing/checklists/mystery-clue-trail-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 11. Mystery Clue Trail Checklist
@@ -5078,6 +5148,7 @@ items:
==================== START: .bmad-creative-writing/checklists/orbital-mechanics-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 21. HardScience Orbital Mechanics Checklist
@@ -5103,6 +5174,7 @@ items:
==================== START: .bmad-creative-writing/checklists/plot-structure-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Plot Structure Checklist
## Opening
@@ -5164,6 +5236,7 @@ items:
==================== START: .bmad-creative-writing/checklists/publication-readiness-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 5. Publication Readiness Checklist
@@ -5189,6 +5262,7 @@ items:
==================== START: .bmad-creative-writing/checklists/romance-emotional-beats-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 12. Romance Emotional Beats Checklist
@@ -5214,6 +5288,7 @@ items:
==================== START: .bmad-creative-writing/checklists/scene-quality-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 3. Scene Quality Checklist
@@ -5239,6 +5314,7 @@ items:
==================== START: .bmad-creative-writing/checklists/scifi-technology-plausibility-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 15. SciFi Technology Plausibility Checklist
@@ -5263,6 +5339,7 @@ items:
==================== START: .bmad-creative-writing/checklists/sensitivity-representation-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 7. Sensitivity & Representation Checklist
@@ -5288,6 +5365,7 @@ items:
==================== START: .bmad-creative-writing/checklists/steampunk-gadget-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 25. Steampunk Gadget Plausibility Checklist
@@ -5313,6 +5391,7 @@ items:
==================== START: .bmad-creative-writing/checklists/thriller-pacing-stakes-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 19. Thriller Pacing & Stakes Checklist
@@ -5338,6 +5417,7 @@ items:
==================== START: .bmad-creative-writing/checklists/timeline-continuity-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 8. Timeline & Continuity Checklist
@@ -5363,6 +5443,7 @@ items:
==================== START: .bmad-creative-writing/checklists/world-building-continuity-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 2. WorldBuilding Continuity Checklist
@@ -5388,6 +5469,7 @@ items:
==================== START: .bmad-creative-writing/checklists/ya-appropriateness-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 20. YA Appropriateness Checklist
@@ -5413,6 +5495,7 @@ items:
==================== START: .bmad-creative-writing/workflows/book-cover-design-workflow.md ====================
<!-- Powered by BMAD™ Core -->
# Book Cover Design Assets
# ============================================================
@@ -6147,6 +6230,7 @@ outputs:
==================== START: .bmad-creative-writing/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMad Creative Writing Knowledge Base
## Overview
@@ -6358,6 +6442,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
==================== START: .bmad-creative-writing/data/story-structures.md ====================
<!-- Powered by BMAD™ Core -->
# Story Structure Patterns
## Three-Act Structure

View File

@@ -102,6 +102,7 @@ dependencies:
==================== START: .bmad-infrastructure-devops/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -119,7 +120,7 @@ When this task is invoked:
## Critical: Template Discovery
If a YAML Template has not been provided, list all templates from bmad-core/templates or ask the user to provide another.
If a YAML Template has not been provided, list all templates from .bmad-core/templates or ask the user to provide another.
## CRITICAL: Mandatory Elicitation Format
@@ -207,6 +208,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-infrastructure-devops/tasks/review-infrastructure.md ====================
<!-- Powered by BMAD™ Core -->
# Infrastructure Review Task
## Purpose
@@ -370,6 +372,7 @@ REPEAT by Asking the user if they would like to perform another Reflective, Elic
==================== START: .bmad-infrastructure-devops/tasks/validate-infrastructure.md ====================
<!-- Powered by BMAD™ Core -->
# Infrastructure Validation Task
## Purpose
@@ -1588,6 +1591,7 @@ sections:
==================== START: .bmad-infrastructure-devops/checklists/infrastructure-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Infrastructure Change Validation Checklist
This checklist serves as a comprehensive framework for validating infrastructure changes before deployment to production. The DevOps/Platform Engineer should systematically work through each item, ensuring the infrastructure is secure, compliant, resilient, and properly implemented according to organizational standards.
@@ -2076,6 +2080,7 @@ This checklist serves as a comprehensive framework for validating infrastructure
==================== START: .bmad-infrastructure-devops/data/technical-preferences.md ====================
<!-- Powered by BMAD™ Core -->
# User-Defined Preferred Patterns and Preferences
None Listed

View File

@@ -8,13 +8,13 @@ You are now operating as a specialized AI agent from the BMad-Method framework.
2. **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
- `==================== START: bmad-core/folder/filename.md ====================`
- `==================== END: bmad-core/folder/filename.md ====================`
- `==================== START: .bmad-core/folder/filename.md ====================`
- `==================== END: .bmad-core/folder/filename.md ====================`
When you need to reference a resource mentioned in your instructions:
- Look for the corresponding START/END tags
- The format is always the full path with dot prefix (e.g., `bmad-core/personas/analyst.md`, `bmad-core/tasks/create-story.md`)
- The format is always the full path with dot prefix (e.g., `.bmad-core/personas/analyst.md`, `.bmad-core/tasks/create-story.md`)
- If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
**Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
@@ -29,8 +29,8 @@ dependencies:
These references map directly to bundle sections:
- `utils: template-format` → Look for `==================== START: bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: bmad-core/tasks/create-story.md ====================`
- `utils: template-format` → Look for `==================== START: .bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: .bmad-core/tasks/create-story.md ====================`
3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
@@ -39,7 +39,7 @@ These references map directly to bundle sections:
---
==================== START: bmad-core/agent-teams/team-all.yaml ====================
==================== START: .bmad-core/agent-teams/team-all.yaml ====================
# <!-- Powered by BMAD™ Core -->
bundle:
name: Team All
@@ -55,9 +55,9 @@ workflows:
- greenfield-fullstack.yaml
- greenfield-service.yaml
- greenfield-ui.yaml
==================== END: bmad-core/agent-teams/team-all.yaml ====================
==================== END: .bmad-core/agent-teams/team-all.yaml ====================
==================== START: bmad-core/agents/bmad-orchestrator.md ====================
==================== START: .bmad-core/agents/bmad-orchestrator.md ====================
# bmad-orchestrator
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -182,9 +182,9 @@ dependencies:
utils:
- workflow-management.md
```
==================== END: bmad-core/agents/bmad-orchestrator.md ====================
==================== END: .bmad-core/agents/bmad-orchestrator.md ====================
==================== START: bmad-core/agents/analyst.md ====================
==================== START: .bmad-core/agents/analyst.md ====================
# analyst
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -246,9 +246,9 @@ dependencies:
- market-research-tmpl.yaml
- project-brief-tmpl.yaml
```
==================== END: bmad-core/agents/analyst.md ====================
==================== END: .bmad-core/agents/analyst.md ====================
==================== START: bmad-core/agents/architect.md ====================
==================== START: .bmad-core/agents/architect.md ====================
# architect
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -311,9 +311,9 @@ dependencies:
- front-end-architecture-tmpl.yaml
- fullstack-architecture-tmpl.yaml
```
==================== END: bmad-core/agents/architect.md ====================
==================== END: .bmad-core/agents/architect.md ====================
==================== START: bmad-core/agents/dev.md ====================
==================== START: .bmad-core/agents/dev.md ====================
# dev
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -364,9 +364,9 @@ dependencies:
- execute-checklist.md
- validate-next-story.md
```
==================== END: bmad-core/agents/dev.md ====================
==================== END: .bmad-core/agents/dev.md ====================
==================== START: bmad-core/agents/pm.md ====================
==================== START: .bmad-core/agents/pm.md ====================
# pm
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -428,9 +428,9 @@ dependencies:
- brownfield-prd-tmpl.yaml
- prd-tmpl.yaml
```
==================== END: bmad-core/agents/pm.md ====================
==================== END: .bmad-core/agents/pm.md ====================
==================== START: bmad-core/agents/po.md ====================
==================== START: .bmad-core/agents/po.md ====================
# po
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -487,9 +487,9 @@ dependencies:
templates:
- story-tmpl.yaml
```
==================== END: bmad-core/agents/po.md ====================
==================== END: .bmad-core/agents/po.md ====================
==================== START: bmad-core/agents/qa.md ====================
==================== START: .bmad-core/agents/qa.md ====================
# qa
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -558,9 +558,9 @@ dependencies:
- qa-gate-tmpl.yaml
- story-tmpl.yaml
```
==================== END: bmad-core/agents/qa.md ====================
==================== END: .bmad-core/agents/qa.md ====================
==================== START: bmad-core/agents/sm.md ====================
==================== START: .bmad-core/agents/sm.md ====================
# sm
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -603,9 +603,9 @@ dependencies:
templates:
- story-tmpl.yaml
```
==================== END: bmad-core/agents/sm.md ====================
==================== END: .bmad-core/agents/sm.md ====================
==================== START: bmad-core/agents/ux-expert.md ====================
==================== START: .bmad-core/agents/ux-expert.md ====================
# ux-expert
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -652,10 +652,11 @@ dependencies:
templates:
- front-end-spec-tmpl.yaml
```
==================== END: bmad-core/agents/ux-expert.md ====================
==================== END: .bmad-core/agents/ux-expert.md ====================
==================== START: bmad-core/tasks/advanced-elicitation.md ====================
==================== START: .bmad-core/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -773,10 +774,11 @@ Choose a number (0-8) or 9 to proceed:
- **Stay Relevant**: Tie all elicitation back to the specific content being analyzed
- **Identify Personas**: For multi-persona methods, clearly identify which viewpoint is speaking
- **Maintain Flow**: Keep the process moving efficiently
==================== END: bmad-core/tasks/advanced-elicitation.md ====================
==================== END: .bmad-core/tasks/advanced-elicitation.md ====================
==================== START: bmad-core/tasks/create-doc.md ====================
==================== START: .bmad-core/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -794,7 +796,7 @@ When this task is invoked:
## Critical: Template Discovery
If a YAML Template has not been provided, list all templates from bmad-core/templates or ask the user to provide another.
If a YAML Template has not been provided, list all templates from .bmad-core/templates or ask the user to provide another.
## CRITICAL: Mandatory Elicitation Format
@@ -878,10 +880,11 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
- Select options 2-9 from data/elicitation-methods only
- Provide detailed rationale explaining decisions
- End with "Select 1-9 or just type your question/feedback:"
==================== END: bmad-core/tasks/create-doc.md ====================
==================== END: .bmad-core/tasks/create-doc.md ====================
==================== START: bmad-core/tasks/kb-mode-interaction.md ====================
==================== START: .bmad-core/tasks/kb-mode-interaction.md ====================
<!-- Powered by BMAD™ Core -->
# KB Mode Interaction Task
## Purpose
@@ -957,10 +960,11 @@ Or ask me about anything else related to BMad-Method!
**User**: Tell me about workflows
**Assistant**: [Provides focused information about workflows from the KB, then offers to explore specific workflow types or related topics]
==================== END: bmad-core/tasks/kb-mode-interaction.md ====================
==================== END: .bmad-core/tasks/kb-mode-interaction.md ====================
==================== START: bmad-core/data/bmad-kb.md ====================
==================== START: .bmad-core/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMAD™ Knowledge Base
## Overview
@@ -1068,7 +1072,7 @@ npx bmad-method install
**Verify Installation**:
- `bmad-core/` folder created with all agents
- `.bmad-core/` folder created with all agents
- IDE-specific integration files created
- All agent commands/rules/modes available
@@ -1767,10 +1771,11 @@ Use the **expansion-creator** pack to build your own:
- **Documentation**: Check `docs/` folder for project-specific context
- **Community**: Discord and GitHub resources available for support
- **Contributing**: See `CONTRIBUTING.md` for full guidelines
==================== END: bmad-core/data/bmad-kb.md ====================
==================== END: .bmad-core/data/bmad-kb.md ====================
==================== START: bmad-core/data/elicitation-methods.md ====================
==================== START: .bmad-core/data/elicitation-methods.md ====================
<!-- Powered by BMAD™ Core -->
# Elicitation Methods Data
## Core Reflective Methods
@@ -1925,10 +1930,11 @@ Use the **expansion-creator** pack to build your own:
- Acknowledge choice to finalize current work
- Accept output as-is or move to next step
- Prepare to continue without additional elicitation
==================== END: bmad-core/data/elicitation-methods.md ====================
==================== END: .bmad-core/data/elicitation-methods.md ====================
==================== START: bmad-core/utils/workflow-management.md ====================
==================== START: .bmad-core/utils/workflow-management.md ====================
<!-- Powered by BMAD™ Core -->
# Workflow Management
Enables BMad orchestrator to manage and execute team workflows.
@@ -1998,10 +2004,11 @@ Handle conditional paths by asking clarifying questions when needed.
## Agent Integration
Agents should be workflow-aware: know active workflow, their role, access artifacts, understand expected outputs.
==================== END: bmad-core/utils/workflow-management.md ====================
==================== END: .bmad-core/utils/workflow-management.md ====================
==================== START: bmad-core/tasks/create-deep-research-prompt.md ====================
==================== START: .bmad-core/tasks/create-deep-research-prompt.md ====================
<!-- Powered by BMAD™ Core -->
# Create Deep Research Prompt Task
This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation.
@@ -2280,10 +2287,11 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
- Balance comprehensiveness with focus
- Document assumptions and limitations clearly
- Plan for iterative refinement based on initial findings
==================== END: bmad-core/tasks/create-deep-research-prompt.md ====================
==================== END: .bmad-core/tasks/create-deep-research-prompt.md ====================
==================== START: bmad-core/tasks/document-project.md ====================
==================== START: .bmad-core/tasks/document-project.md ====================
<!-- Powered by BMAD™ Core -->
# Document an Existing Project
## Purpose
@@ -2627,13 +2635,14 @@ Apply the advanced elicitation task after major sections to refine based on user
- Documents technical debt, workarounds, and constraints honestly
- For brownfield projects with PRD: Provides clear enhancement impact analysis
- The goal is PRACTICAL documentation for AI agents doing real work
==================== END: bmad-core/tasks/document-project.md ====================
==================== END: .bmad-core/tasks/document-project.md ====================
==================== START: .bmad-core/tasks/facilitate-brainstorming-session.md ====================
## <!-- Powered by BMAD™ Core -->
==================== START: bmad-core/tasks/facilitate-brainstorming-session.md ====================
<!-- Powered by BMAD™ Core -->
---
docOutputLocation: docs/brainstorming-session-results.md
template: 'bmad-core/templates/brainstorming-output-tmpl.yaml'
template: '.bmad-core/templates/brainstorming-output-tmpl.yaml'
---
# Facilitate Brainstorming Session Task
@@ -2767,9 +2776,9 @@ Generate structured document with these sections:
- Always ask before switching techniques: "Ready to try a different approach?"
- Offer options: "Should we explore this idea deeper or generate more alternatives?"
- Respect their process and timing
==================== END: bmad-core/tasks/facilitate-brainstorming-session.md ====================
==================== END: .bmad-core/tasks/facilitate-brainstorming-session.md ====================
==================== START: bmad-core/templates/brainstorming-output-tmpl.yaml ====================
==================== START: .bmad-core/templates/brainstorming-output-tmpl.yaml ====================
template:
id: brainstorming-output-template-v2
name: Brainstorming Session Results
@@ -2926,9 +2935,9 @@ sections:
---
*Session facilitated using the BMAD-METHOD™ brainstorming framework*
==================== END: bmad-core/templates/brainstorming-output-tmpl.yaml ====================
==================== END: .bmad-core/templates/brainstorming-output-tmpl.yaml ====================
==================== START: bmad-core/templates/competitor-analysis-tmpl.yaml ====================
==================== START: .bmad-core/templates/competitor-analysis-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: competitor-analysis-template-v2
@@ -3236,9 +3245,9 @@ sections:
- Weekly: {{weekly_items}}
- Monthly: {{monthly_items}}
- Quarterly: {{quarterly_analysis}}
==================== END: bmad-core/templates/competitor-analysis-tmpl.yaml ====================
==================== END: .bmad-core/templates/competitor-analysis-tmpl.yaml ====================
==================== START: bmad-core/templates/market-research-tmpl.yaml ====================
==================== START: .bmad-core/templates/market-research-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: market-research-template-v2
@@ -3492,9 +3501,9 @@ sections:
- id: additional-analysis
title: C. Additional Analysis
instruction: Any supplementary analysis not included in main body
==================== END: bmad-core/templates/market-research-tmpl.yaml ====================
==================== END: .bmad-core/templates/market-research-tmpl.yaml ====================
==================== START: bmad-core/templates/project-brief-tmpl.yaml ====================
==================== START: .bmad-core/templates/project-brief-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: project-brief-template-v2
@@ -3717,10 +3726,11 @@ sections:
title: PM Handoff
content: |
This Project Brief provides the full context for {{project_name}}. Please start in 'PRD Generation Mode', review the brief thoroughly to work with the user to create the PRD section by section as the template indicates, asking for any necessary clarification or suggesting improvements.
==================== END: bmad-core/templates/project-brief-tmpl.yaml ====================
==================== END: .bmad-core/templates/project-brief-tmpl.yaml ====================
==================== START: bmad-core/data/brainstorming-techniques.md ====================
==================== START: .bmad-core/data/brainstorming-techniques.md ====================
<!-- Powered by BMAD™ Core -->
# Brainstorming Techniques Data
## Creative Expansion
@@ -3757,17 +3767,18 @@ sections:
18. **Resource Constraints**: "What if you had only $10 and 1 hour?"
19. **Metaphor Mapping**: Use extended metaphors to explore solutions
20. **Question Storming**: Generate questions instead of answers first
==================== END: bmad-core/data/brainstorming-techniques.md ====================
==================== END: .bmad-core/data/brainstorming-techniques.md ====================
==================== START: bmad-core/tasks/execute-checklist.md ====================
==================== START: .bmad-core/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
## Available Checklists
If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the bmad-core/checklists folder to select the appropriate one to run.
If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the .bmad-core/checklists folder to select the appropriate one to run.
## Instructions
@@ -3775,7 +3786,7 @@ If the user asks or does not specify a specific checklist, list the checklists a
- If user or the task being run provides a checklist name:
- Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
- If multiple matches found, ask user to clarify
- Load the appropriate checklist from bmad-core/checklists/
- Load the appropriate checklist from .bmad-core/checklists/
- If no checklist specified:
- Ask the user which checklist they want to use
- Present the available options from the files in the checklists folder
@@ -3847,9 +3858,9 @@ The LLM will:
- Execute the complete checklist validation
- Present a final report with pass/fail rates and key findings
- Offer to provide detailed analysis of any section, especially those with warnings or failures
==================== END: bmad-core/tasks/execute-checklist.md ====================
==================== END: .bmad-core/tasks/execute-checklist.md ====================
==================== START: bmad-core/templates/architecture-tmpl.yaml ====================
==================== START: .bmad-core/templates/architecture-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: architecture-template-v2
@@ -3980,7 +3991,7 @@ sections:
instruction: |
This is the DEFINITIVE technology selection section. Work with the user to make specific choices:
1. Review PRD technical assumptions and any preferences from bmad-core/data/technical-preferences.yaml or an attached technical-preferences
1. Review PRD technical assumptions and any preferences from .bmad-core/data/technical-preferences.yaml or an attached technical-preferences
2. For each category, present 2-3 viable options with pros/cons
3. Make a clear recommendation based on project needs
4. Get explicit user approval for each selection
@@ -4501,9 +4512,9 @@ sections:
- Key UI requirements from PRD
- Any frontend-specific decisions made here
- Request for detailed frontend architecture
==================== END: bmad-core/templates/architecture-tmpl.yaml ====================
==================== END: .bmad-core/templates/architecture-tmpl.yaml ====================
==================== START: bmad-core/templates/brownfield-architecture-tmpl.yaml ====================
==================== START: .bmad-core/templates/brownfield-architecture-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: brownfield-architecture-template-v2
@@ -4981,9 +4992,9 @@ sections:
- Key technical decisions based on real project constraints
- Existing system compatibility requirements with specific verification steps
- Clear sequencing of implementation to minimize risk to existing functionality
==================== END: bmad-core/templates/brownfield-architecture-tmpl.yaml ====================
==================== END: .bmad-core/templates/brownfield-architecture-tmpl.yaml ====================
==================== START: bmad-core/templates/front-end-architecture-tmpl.yaml ====================
==================== START: .bmad-core/templates/front-end-architecture-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: frontend-architecture-template-v2
@@ -5203,9 +5214,9 @@ sections:
- Key import patterns
- File naming conventions
- Project-specific patterns and utilities
==================== END: bmad-core/templates/front-end-architecture-tmpl.yaml ====================
==================== END: .bmad-core/templates/front-end-architecture-tmpl.yaml ====================
==================== START: bmad-core/templates/fullstack-architecture-tmpl.yaml ====================
==================== START: .bmad-core/templates/fullstack-architecture-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: fullstack-architecture-template-v2
@@ -6030,10 +6041,11 @@ sections:
- id: checklist-results
title: Checklist Results Report
instruction: Before running the checklist, offer to output the full architecture document. Once user confirms, execute the architect-checklist and populate results here.
==================== END: bmad-core/templates/fullstack-architecture-tmpl.yaml ====================
==================== END: .bmad-core/templates/fullstack-architecture-tmpl.yaml ====================
==================== START: bmad-core/checklists/architect-checklist.md ====================
==================== START: .bmad-core/checklists/architect-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Architect Solution Validation Checklist
This checklist serves as a comprehensive framework for the Architect to validate the technical design and architecture before development execution. The Architect should systematically work through each item, ensuring the architecture is robust, scalable, secure, and aligned with the product requirements.
@@ -6472,17 +6484,19 @@ Now that you've completed the checklist, generate a comprehensive validation rep
- Component design clarity
After presenting the report, ask the user if they would like detailed analysis of any specific section, especially those with warnings or failures.]]
==================== END: bmad-core/checklists/architect-checklist.md ====================
==================== END: .bmad-core/checklists/architect-checklist.md ====================
==================== START: bmad-core/data/technical-preferences.md ====================
==================== START: .bmad-core/data/technical-preferences.md ====================
<!-- Powered by BMAD™ Core -->
# User-Defined Preferred Patterns and Preferences
None Listed
==================== END: bmad-core/data/technical-preferences.md ====================
==================== END: .bmad-core/data/technical-preferences.md ====================
==================== START: bmad-core/tasks/apply-qa-fixes.md ====================
==================== START: .bmad-core/tasks/apply-qa-fixes.md ====================
<!-- Powered by BMAD™ Core -->
# apply-qa-fixes
Implement fixes based on QA results (gate and assessments) for a specific story. This task is for the Dev agent to systematically consume QA outputs and apply code/test changes while only updating allowed sections in the story file.
@@ -6631,10 +6645,11 @@ Fix plan:
- Tests validate behavior and close gaps
- Strict adherence to allowed story update areas
- Gate ownership remains with QA; Dev signals readiness via Status
==================== END: bmad-core/tasks/apply-qa-fixes.md ====================
==================== END: .bmad-core/tasks/apply-qa-fixes.md ====================
==================== START: bmad-core/tasks/validate-next-story.md ====================
==================== START: .bmad-core/tasks/validate-next-story.md ====================
<!-- Powered by BMAD™ Core -->
# Validate Next Story Task
## Purpose
@@ -6645,7 +6660,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
### 0. Load Core Configuration and Inputs
- Load `bmad-core/core-config.yaml`
- Load `.bmad-core/core-config.yaml`
- If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story validation."
- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`
- Identify and load the following inputs:
@@ -6769,10 +6784,11 @@ Provide a structured validation report including:
- **NO-GO**: Story requires fixes before implementation
- **Implementation Readiness Score**: 1-10 scale
- **Confidence Level**: High/Medium/Low for successful implementation
==================== END: bmad-core/tasks/validate-next-story.md ====================
==================== END: .bmad-core/tasks/validate-next-story.md ====================
==================== START: bmad-core/checklists/story-dod-checklist.md ====================
==================== START: .bmad-core/checklists/story-dod-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Story Definition of Done (DoD) Checklist
## Instructions for Developer Agent
@@ -6867,10 +6883,11 @@ After completing the checklist:
Be honest - it's better to flag issues now than have them discovered later.]]
- [ ] I, the Developer Agent, confirm that all applicable items above have been addressed.
==================== END: bmad-core/checklists/story-dod-checklist.md ====================
==================== END: .bmad-core/checklists/story-dod-checklist.md ====================
==================== START: bmad-core/tasks/brownfield-create-epic.md ====================
==================== START: .bmad-core/tasks/brownfield-create-epic.md ====================
<!-- Powered by BMAD™ Core -->
# Create Brownfield Epic Task
## Purpose
@@ -7031,10 +7048,11 @@ The epic creation is successful when:
- If the scope grows beyond 3 stories, consider the full brownfield PRD process
- Always prioritize existing system integrity over new functionality
- When in doubt about scope or complexity, escalate to full brownfield planning
==================== END: bmad-core/tasks/brownfield-create-epic.md ====================
==================== END: .bmad-core/tasks/brownfield-create-epic.md ====================
==================== START: bmad-core/tasks/brownfield-create-story.md ====================
==================== START: .bmad-core/tasks/brownfield-create-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Brownfield Story Task
## Purpose
@@ -7182,15 +7200,16 @@ The story creation is successful when:
- Always prioritize existing system integrity
- When in doubt about integration complexity, use brownfield-create-epic instead
- Stories should take no more than 4 hours of focused development work
==================== END: bmad-core/tasks/brownfield-create-story.md ====================
==================== END: .bmad-core/tasks/brownfield-create-story.md ====================
==================== START: bmad-core/tasks/correct-course.md ====================
==================== START: .bmad-core/tasks/correct-course.md ====================
<!-- Powered by BMAD™ Core -->
# Correct Course Task
## Purpose
- Guide a structured response to a change trigger using the `bmad-core/checklists/change-checklist`.
- Guide a structured response to a change trigger using the `.bmad-core/checklists/change-checklist`.
- Analyze the impacts of the change on epics, project artifacts, and the MVP, guided by the checklist's structure.
- Explore potential solutions (e.g., adjust scope, rollback elements, re-scope features) as prompted by the checklist.
- Draft specific, actionable proposed updates to any affected project artifacts (e.g., epics, user stories, PRD sections, architecture document sections) based on the analysis.
@@ -7204,7 +7223,7 @@ The story creation is successful when:
- **Acknowledge Task & Inputs:**
- Confirm with the user that the "Correct Course Task" (Change Navigation & Integration) is being initiated.
- Verify the change trigger and ensure you have the user's initial explanation of the issue and its perceived impact.
- Confirm access to all relevant project artifacts (e.g., PRD, Epics/Stories, Architecture Documents, UI/UX Specifications) and, critically, the `bmad-core/checklists/change-checklist`.
- Confirm access to all relevant project artifacts (e.g., PRD, Epics/Stories, Architecture Documents, UI/UX Specifications) and, critically, the `.bmad-core/checklists/change-checklist`.
- **Establish Interaction Mode:**
- Ask the user their preferred interaction mode for this task:
- **"Incrementally (Default & Recommended):** Shall we work through the change-checklist section by section, discussing findings and collaboratively drafting proposed changes for each relevant part before moving to the next? This allows for detailed, step-by-step refinement."
@@ -7256,10 +7275,11 @@ The story creation is successful when:
- A summary of the change-checklist analysis (issue, impact, rationale for the chosen path).
- Specific, clearly drafted proposed edits for all affected project artifacts.
- **Implicit:** An annotated change-checklist (or the record of its completion) reflecting the discussions, findings, and decisions made during the process.
==================== END: bmad-core/tasks/correct-course.md ====================
==================== END: .bmad-core/tasks/correct-course.md ====================
==================== START: bmad-core/tasks/shard-doc.md ====================
==================== START: .bmad-core/tasks/shard-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Document Sharding Task
## Purpose
@@ -7270,20 +7290,20 @@ The story creation is successful when:
## Primary Method: Automatic with markdown-tree
[[LLM: First, check if markdownExploder is set to true in bmad-core/core-config.yaml. If it is, attempt to run the command: `md-tree explode {input file} {output path}`.
[[LLM: First, check if markdownExploder is set to true in .bmad-core/core-config.yaml. If it is, attempt to run the command: `md-tree explode {input file} {output path}`.
If the command succeeds, inform the user that the document has been sharded successfully and STOP - do not proceed further.
If the command fails (especially with an error indicating the command is not found or not available), inform the user: "The markdownExploder setting is enabled but the md-tree command is not available. Please either:
1. Install @kayvan/markdown-tree-parser globally with: `npm install -g @kayvan/markdown-tree-parser`
2. Or set markdownExploder to false in bmad-core/core-config.yaml
2. Or set markdownExploder to false in .bmad-core/core-config.yaml
**IMPORTANT: STOP HERE - do not proceed with manual sharding until one of the above actions is taken.**"
If markdownExploder is set to false, inform the user: "The markdownExploder setting is currently false. For better performance and reliability, you should:
1. Set markdownExploder to true in bmad-core/core-config.yaml
1. Set markdownExploder to true in .bmad-core/core-config.yaml
2. Install @kayvan/markdown-tree-parser globally with: `npm install -g @kayvan/markdown-tree-parser`
I will now proceed with the manual sharding process."
@@ -7445,9 +7465,9 @@ Document sharded successfully:
- Preserve ALL formatting, including whitespace where significant
- Handle edge cases like sections with code blocks containing ## symbols
- Ensure the sharding is reversible (could reconstruct the original from shards)
==================== END: bmad-core/tasks/shard-doc.md ====================
==================== END: .bmad-core/tasks/shard-doc.md ====================
==================== START: bmad-core/templates/brownfield-prd-tmpl.yaml ====================
==================== START: .bmad-core/templates/brownfield-prd-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: brownfield-prd-template-v2
@@ -7729,9 +7749,9 @@ sections:
- template: "IV1: {{existing_functionality_verification}}"
- template: "IV2: {{integration_point_verification}}"
- template: "IV3: {{performance_impact_verification}}"
==================== END: bmad-core/templates/brownfield-prd-tmpl.yaml ====================
==================== END: .bmad-core/templates/brownfield-prd-tmpl.yaml ====================
==================== START: bmad-core/templates/prd-tmpl.yaml ====================
==================== START: .bmad-core/templates/prd-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: prd-template-v2
@@ -7834,7 +7854,7 @@ sections:
instruction: |
Gather technical decisions that will guide the Architect. Steps:
1. Check if bmad-core/data/technical-preferences.yaml or an attached technical-preferences file exists - use it to pre-populate choices
1. Check if .bmad-core/data/technical-preferences.yaml or an attached technical-preferences file exists - use it to pre-populate choices
2. Ask user about: languages, frameworks, starter templates, libraries, APIs, deployment targets
3. For unknowns, offer guidance based on project goals and MVP scope
4. Document ALL technical choices with rationale (why this choice fits the project)
@@ -7935,10 +7955,11 @@ sections:
- id: architect-prompt
title: Architect Prompt
instruction: This section will contain the prompt for the Architect, keep it short and to the point to initiate create architecture mode using this document as input.
==================== END: bmad-core/templates/prd-tmpl.yaml ====================
==================== END: .bmad-core/templates/prd-tmpl.yaml ====================
==================== START: bmad-core/checklists/change-checklist.md ====================
==================== START: .bmad-core/checklists/change-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Change Navigation Checklist
**Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMad workflow.
@@ -8121,10 +8142,11 @@ Keep it action-oriented and forward-looking.]]
- [ ] **Confirm Next Steps:** Reiterate the handoff plan and the next actions to be taken by specific agents.
---
==================== END: bmad-core/checklists/change-checklist.md ====================
==================== END: .bmad-core/checklists/change-checklist.md ====================
==================== START: bmad-core/checklists/pm-checklist.md ====================
==================== START: .bmad-core/checklists/pm-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Product Manager (PM) Requirements Checklist
This checklist serves as a comprehensive framework to ensure the Product Requirements Document (PRD) and Epic definitions are complete, well-structured, and appropriately scoped for MVP development. The PM should systematically work through each item during the product definition process.
@@ -8495,9 +8517,9 @@ After presenting the report, ask if the user wants:
- **READY FOR ARCHITECT**: The PRD and epics are comprehensive, properly structured, and ready for architectural design.
- **NEEDS REFINEMENT**: The requirements documentation requires additional work to address the identified deficiencies.
==================== END: bmad-core/checklists/pm-checklist.md ====================
==================== END: .bmad-core/checklists/pm-checklist.md ====================
==================== START: bmad-core/templates/story-tmpl.yaml ====================
==================== START: .bmad-core/templates/story-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: story-template-v2
@@ -8636,10 +8658,11 @@ sections:
instruction: Results from QA Agent QA review of the completed story implementation
owner: qa-agent
editors: [qa-agent]
==================== END: bmad-core/templates/story-tmpl.yaml ====================
==================== END: .bmad-core/templates/story-tmpl.yaml ====================
==================== START: bmad-core/checklists/po-master-checklist.md ====================
==================== START: .bmad-core/checklists/po-master-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Product Owner (PO) Master Validation Checklist
This checklist serves as a comprehensive framework for the Product Owner to validate project plans before development execution. It adapts intelligently based on project type (greenfield vs brownfield) and includes UI/UX considerations when applicable.
@@ -9072,10 +9095,11 @@ After presenting the report, ask if the user wants:
- **APPROVED**: The plan is comprehensive, properly sequenced, and ready for implementation.
- **CONDITIONAL**: The plan requires specific adjustments before proceeding.
- **REJECTED**: The plan requires significant revision to address critical deficiencies.
==================== END: bmad-core/checklists/po-master-checklist.md ====================
==================== END: .bmad-core/checklists/po-master-checklist.md ====================
==================== START: bmad-core/tasks/nfr-assess.md ====================
==================== START: .bmad-core/tasks/nfr-assess.md ====================
<!-- Powered by BMAD™ Core -->
# nfr-assess
Quick NFR validation focused on the core four: security, performance, reliability, maintainability.
@@ -9419,10 +9443,11 @@ performance_deep_dive:
```
</details>
==================== END: bmad-core/tasks/nfr-assess.md ====================
==================== END: .bmad-core/tasks/nfr-assess.md ====================
==================== START: bmad-core/tasks/qa-gate.md ====================
==================== START: .bmad-core/tasks/qa-gate.md ====================
<!-- Powered by BMAD™ Core -->
# qa-gate
Create or update a quality gate decision file for a story based on review findings.
@@ -9584,10 +9609,11 @@ Gate: CONCERNS → qa.qaLocation/gates/{epic}.{story}-{slug}.yml
- Always write to standard path
- Always update story with gate reference
- Clear, actionable findings
==================== END: bmad-core/tasks/qa-gate.md ====================
==================== END: .bmad-core/tasks/qa-gate.md ====================
==================== START: bmad-core/tasks/review-story.md ====================
==================== START: .bmad-core/tasks/review-story.md ====================
<!-- Powered by BMAD™ Core -->
# review-story
Perform a comprehensive test architecture review with quality gate decision. This adaptive, risk-aware review creates both a story update and a detailed gate file.
@@ -9902,10 +9928,11 @@ After review:
3. Recommend status: "Ready for Done" or "Changes Required" (owner decides)
4. If files were modified, list them in QA Results and ask Dev to update File List
5. Always provide constructive feedback and actionable recommendations
==================== END: bmad-core/tasks/review-story.md ====================
==================== END: .bmad-core/tasks/review-story.md ====================
==================== START: bmad-core/tasks/risk-profile.md ====================
==================== START: .bmad-core/tasks/risk-profile.md ====================
<!-- Powered by BMAD™ Core -->
# risk-profile
Generate a comprehensive risk assessment matrix for a story implementation using probability × impact analysis.
@@ -10259,10 +10286,11 @@ Risk profile: qa.qaLocation/assessments/{epic}.{story}-risk-{YYYYMMDD}.md
- Link risks to specific test requirements
- Track residual risk after mitigation
- Update risk profile as story evolves
==================== END: bmad-core/tasks/risk-profile.md ====================
==================== END: .bmad-core/tasks/risk-profile.md ====================
==================== START: bmad-core/tasks/test-design.md ====================
==================== START: .bmad-core/tasks/test-design.md ====================
<!-- Powered by BMAD™ Core -->
# test-design
Create comprehensive test scenarios with appropriate test level recommendations for story implementation.
@@ -10437,10 +10465,11 @@ Before finalizing, verify:
- **Efficient coverage**: Test once at the right level
- **Maintainability**: Consider long-term test maintenance
- **Fast feedback**: Quick tests run first
==================== END: bmad-core/tasks/test-design.md ====================
==================== END: .bmad-core/tasks/test-design.md ====================
==================== START: bmad-core/tasks/trace-requirements.md ====================
==================== START: .bmad-core/tasks/trace-requirements.md ====================
<!-- Powered by BMAD™ Core -->
# trace-requirements
Map story requirements to test cases using Given-When-Then patterns for comprehensive traceability.
@@ -10705,9 +10734,9 @@ Trace matrix: qa.qaLocation/assessments/{epic}.{story}-trace-{YYYYMMDD}.md
- Identify both presence and absence
- Prioritize based on risk
- Make recommendations actionable
==================== END: bmad-core/tasks/trace-requirements.md ====================
==================== END: .bmad-core/tasks/trace-requirements.md ====================
==================== START: bmad-core/templates/qa-gate-tmpl.yaml ====================
==================== START: .bmad-core/templates/qa-gate-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: qa-gate-template-v1
@@ -10811,10 +10840,11 @@ optional_fields_examples:
future: # Can be addressed later
- action: "Consider caching for better performance"
refs: ["services/data.service.ts"]
==================== END: bmad-core/templates/qa-gate-tmpl.yaml ====================
==================== END: .bmad-core/templates/qa-gate-tmpl.yaml ====================
==================== START: bmad-core/tasks/create-next-story.md ====================
==================== START: .bmad-core/tasks/create-next-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Next Story Task
## Purpose
@@ -10825,7 +10855,7 @@ To identify the next logical story based on project progress and epic definition
### 0. Load Core Configuration and Check Workflow
- Load `bmad-core/core-config.yaml` from the project root
- Load `.bmad-core/core-config.yaml` from the project root
- If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story creation. You can either: 1) Copy it from GITHUB bmad-core/core-config.yaml and configure it for your project OR 2) Run the BMad installer against your project to upgrade and add the file automatically. Please add and configure core-config.yaml before proceeding."
- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`, `workflow.*`
@@ -10919,18 +10949,19 @@ ALWAYS cite source documents: `[Source: architecture/{filename}.md#{section}]`
- Verify all source references are included for technical details
- Ensure tasks align with both epic requirements and architecture constraints
- Update status to "Draft" and save the story file
- Execute `bmad-core/tasks/execute-checklist` `bmad-core/checklists/story-draft-checklist`
- Execute `.bmad-core/tasks/execute-checklist` `.bmad-core/checklists/story-draft-checklist`
- Provide summary to user including:
- Story created: `{devStoryLocation}/{epicNum}.{storyNum}.story.md`
- Status: Draft
- Key technical components included from architecture docs
- Any deviations or conflicts noted between epic and architecture
- Checklist Results
- Next steps: For Complex stories, suggest the user carefully review the story draft and also optionally have the PO run the task `bmad-core/tasks/validate-next-story`
==================== END: bmad-core/tasks/create-next-story.md ====================
- Next steps: For Complex stories, suggest the user carefully review the story draft and also optionally have the PO run the task `.bmad-core/tasks/validate-next-story`
==================== END: .bmad-core/tasks/create-next-story.md ====================
==================== START: bmad-core/checklists/story-draft-checklist.md ====================
==================== START: .bmad-core/checklists/story-draft-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Story Draft Checklist
The Scrum Master should use this checklist to validate that each story contains sufficient context for a developer agent to implement it successfully, while assuming the dev agent has reasonable capabilities to figure things out.
@@ -11084,10 +11115,11 @@ Be pragmatic - perfect documentation doesn't exist, but it must be enough to pro
- READY: The story provides sufficient context for implementation
- NEEDS REVISION: The story requires updates (see issues)
- BLOCKED: External information required (specify what information)
==================== END: bmad-core/checklists/story-draft-checklist.md ====================
==================== END: .bmad-core/checklists/story-draft-checklist.md ====================
==================== START: bmad-core/tasks/generate-ai-frontend-prompt.md ====================
==================== START: .bmad-core/tasks/generate-ai-frontend-prompt.md ====================
<!-- Powered by BMAD™ Core -->
# Create AI Frontend Prompt Task
## Purpose
@@ -11139,9 +11171,9 @@ You will now synthesize the inputs and the above principles into a final, compre
- Output the complete, generated prompt in a clear, copy-pasteable format (e.g., a large code block).
- Explain the structure of the prompt and why certain information was included, referencing the principles above.
- <important_note>Conclude by reminding the user that all AI-generated code will require careful human review, testing, and refinement to be considered production-ready.</important_note>
==================== END: bmad-core/tasks/generate-ai-frontend-prompt.md ====================
==================== END: .bmad-core/tasks/generate-ai-frontend-prompt.md ====================
==================== START: bmad-core/templates/front-end-spec-tmpl.yaml ====================
==================== START: .bmad-core/templates/front-end-spec-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: frontend-spec-template-v2
@@ -11492,9 +11524,9 @@ sections:
- id: checklist-results
title: Checklist Results
instruction: If a UI/UX checklist exists, run it against this document and report results here.
==================== END: bmad-core/templates/front-end-spec-tmpl.yaml ====================
==================== END: .bmad-core/templates/front-end-spec-tmpl.yaml ====================
==================== START: bmad-core/workflows/brownfield-fullstack.yaml ====================
==================== START: .bmad-core/workflows/brownfield-fullstack.yaml ====================
# <!-- Powered by BMAD™ Core -->
workflow:
id: brownfield-fullstack
@@ -11680,7 +11712,7 @@ workflow:
All stories implemented and reviewed!
Project development phase complete.
Reference: bmad-core/data/bmad-kb.md#IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid
@@ -11793,9 +11825,9 @@ workflow:
{{if missing_context}}: May need to gather additional context from user during story creation.
complete: "All planning artifacts validated and development can begin. Stories will be created based on available documentation format."
==================== END: bmad-core/workflows/brownfield-fullstack.yaml ====================
==================== END: .bmad-core/workflows/brownfield-fullstack.yaml ====================
==================== START: bmad-core/workflows/brownfield-service.yaml ====================
==================== START: .bmad-core/workflows/brownfield-service.yaml ====================
# <!-- Powered by BMAD™ Core -->
workflow:
id: brownfield-service
@@ -11927,7 +11959,7 @@ workflow:
All stories implemented and reviewed!
Project development phase complete.
Reference: bmad-core/data/bmad-kb.md#IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid
@@ -11984,9 +12016,9 @@ workflow:
architect_to_po: "Architecture complete. Save it as docs/architecture.md. Please validate all artifacts for service integration safety."
po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
==================== END: bmad-core/workflows/brownfield-service.yaml ====================
==================== END: .bmad-core/workflows/brownfield-service.yaml ====================
==================== START: bmad-core/workflows/brownfield-ui.yaml ====================
==================== START: .bmad-core/workflows/brownfield-ui.yaml ====================
# <!-- Powered by BMAD™ Core -->
workflow:
id: brownfield-ui
@@ -12125,7 +12157,7 @@ workflow:
All stories implemented and reviewed!
Project development phase complete.
Reference: bmad-core/data/bmad-kb.md#IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid
@@ -12185,9 +12217,9 @@ workflow:
architect_to_po: "Architecture complete. Save it as docs/architecture.md. Please validate all artifacts for UI integration safety."
po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
==================== END: bmad-core/workflows/brownfield-ui.yaml ====================
==================== END: .bmad-core/workflows/brownfield-ui.yaml ====================
==================== START: bmad-core/workflows/greenfield-fullstack.yaml ====================
==================== START: .bmad-core/workflows/greenfield-fullstack.yaml ====================
# <!-- Powered by BMAD™ Core -->
workflow:
id: greenfield-fullstack
@@ -12351,7 +12383,7 @@ workflow:
All stories implemented and reviewed!
Project development phase complete.
Reference: bmad-core/data/bmad-kb.md#IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid
@@ -12429,9 +12461,9 @@ workflow:
updated_to_po: "All documents ready in docs/ folder. Please validate all artifacts for consistency."
po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
==================== END: bmad-core/workflows/greenfield-fullstack.yaml ====================
==================== END: .bmad-core/workflows/greenfield-fullstack.yaml ====================
==================== START: bmad-core/workflows/greenfield-service.yaml ====================
==================== START: .bmad-core/workflows/greenfield-service.yaml ====================
# <!-- Powered by BMAD™ Core -->
workflow:
id: greenfield-service
@@ -12571,7 +12603,7 @@ workflow:
All stories implemented and reviewed!
Service development phase complete.
Reference: bmad-core/data/bmad-kb.md#IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid
@@ -12639,9 +12671,9 @@ workflow:
updated_to_po: "All documents ready in docs/ folder. Please validate all artifacts for consistency."
po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
==================== END: bmad-core/workflows/greenfield-service.yaml ====================
==================== END: .bmad-core/workflows/greenfield-service.yaml ====================
==================== START: bmad-core/workflows/greenfield-ui.yaml ====================
==================== START: .bmad-core/workflows/greenfield-ui.yaml ====================
# <!-- Powered by BMAD™ Core -->
workflow:
id: greenfield-ui
@@ -12800,7 +12832,7 @@ workflow:
All stories implemented and reviewed!
Project development phase complete.
Reference: bmad-core/data/bmad-kb.md#IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid
@@ -12878,4 +12910,4 @@ workflow:
updated_to_po: "All documents ready in docs/ folder. Please validate all artifacts for consistency."
po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
==================== END: bmad-core/workflows/greenfield-ui.yaml ====================
==================== END: .bmad-core/workflows/greenfield-ui.yaml ====================

View File

@@ -8,13 +8,13 @@ You are now operating as a specialized AI agent from the BMad-Method framework.
2. **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
- `==================== START: bmad-core/folder/filename.md ====================`
- `==================== END: bmad-core/folder/filename.md ====================`
- `==================== START: .bmad-core/folder/filename.md ====================`
- `==================== END: .bmad-core/folder/filename.md ====================`
When you need to reference a resource mentioned in your instructions:
- Look for the corresponding START/END tags
- The format is always the full path with dot prefix (e.g., `bmad-core/personas/analyst.md`, `bmad-core/tasks/create-story.md`)
- The format is always the full path with dot prefix (e.g., `.bmad-core/personas/analyst.md`, `.bmad-core/tasks/create-story.md`)
- If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
**Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
@@ -29,8 +29,8 @@ dependencies:
These references map directly to bundle sections:
- `utils: template-format` → Look for `==================== START: bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: bmad-core/tasks/create-story.md ====================`
- `utils: template-format` → Look for `==================== START: .bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: .bmad-core/tasks/create-story.md ====================`
3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
@@ -39,7 +39,7 @@ These references map directly to bundle sections:
---
==================== START: bmad-core/agent-teams/team-fullstack.yaml ====================
==================== START: .bmad-core/agent-teams/team-fullstack.yaml ====================
# <!-- Powered by BMAD™ Core -->
bundle:
name: Team Fullstack
@@ -59,9 +59,9 @@ workflows:
- greenfield-fullstack.yaml
- greenfield-service.yaml
- greenfield-ui.yaml
==================== END: bmad-core/agent-teams/team-fullstack.yaml ====================
==================== END: .bmad-core/agent-teams/team-fullstack.yaml ====================
==================== START: bmad-core/agents/bmad-orchestrator.md ====================
==================== START: .bmad-core/agents/bmad-orchestrator.md ====================
# bmad-orchestrator
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -186,9 +186,9 @@ dependencies:
utils:
- workflow-management.md
```
==================== END: bmad-core/agents/bmad-orchestrator.md ====================
==================== END: .bmad-core/agents/bmad-orchestrator.md ====================
==================== START: bmad-core/agents/analyst.md ====================
==================== START: .bmad-core/agents/analyst.md ====================
# analyst
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -250,9 +250,9 @@ dependencies:
- market-research-tmpl.yaml
- project-brief-tmpl.yaml
```
==================== END: bmad-core/agents/analyst.md ====================
==================== END: .bmad-core/agents/analyst.md ====================
==================== START: bmad-core/agents/pm.md ====================
==================== START: .bmad-core/agents/pm.md ====================
# pm
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -314,9 +314,9 @@ dependencies:
- brownfield-prd-tmpl.yaml
- prd-tmpl.yaml
```
==================== END: bmad-core/agents/pm.md ====================
==================== END: .bmad-core/agents/pm.md ====================
==================== START: bmad-core/agents/ux-expert.md ====================
==================== START: .bmad-core/agents/ux-expert.md ====================
# ux-expert
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -363,9 +363,9 @@ dependencies:
templates:
- front-end-spec-tmpl.yaml
```
==================== END: bmad-core/agents/ux-expert.md ====================
==================== END: .bmad-core/agents/ux-expert.md ====================
==================== START: bmad-core/agents/architect.md ====================
==================== START: .bmad-core/agents/architect.md ====================
# architect
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -428,9 +428,9 @@ dependencies:
- front-end-architecture-tmpl.yaml
- fullstack-architecture-tmpl.yaml
```
==================== END: bmad-core/agents/architect.md ====================
==================== END: .bmad-core/agents/architect.md ====================
==================== START: bmad-core/agents/po.md ====================
==================== START: .bmad-core/agents/po.md ====================
# po
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -487,10 +487,11 @@ dependencies:
templates:
- story-tmpl.yaml
```
==================== END: bmad-core/agents/po.md ====================
==================== END: .bmad-core/agents/po.md ====================
==================== START: bmad-core/tasks/advanced-elicitation.md ====================
==================== START: .bmad-core/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -608,10 +609,11 @@ Choose a number (0-8) or 9 to proceed:
- **Stay Relevant**: Tie all elicitation back to the specific content being analyzed
- **Identify Personas**: For multi-persona methods, clearly identify which viewpoint is speaking
- **Maintain Flow**: Keep the process moving efficiently
==================== END: bmad-core/tasks/advanced-elicitation.md ====================
==================== END: .bmad-core/tasks/advanced-elicitation.md ====================
==================== START: bmad-core/tasks/create-doc.md ====================
==================== START: .bmad-core/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -629,7 +631,7 @@ When this task is invoked:
## Critical: Template Discovery
If a YAML Template has not been provided, list all templates from bmad-core/templates or ask the user to provide another.
If a YAML Template has not been provided, list all templates from .bmad-core/templates or ask the user to provide another.
## CRITICAL: Mandatory Elicitation Format
@@ -713,10 +715,11 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
- Select options 2-9 from data/elicitation-methods only
- Provide detailed rationale explaining decisions
- End with "Select 1-9 or just type your question/feedback:"
==================== END: bmad-core/tasks/create-doc.md ====================
==================== END: .bmad-core/tasks/create-doc.md ====================
==================== START: bmad-core/tasks/kb-mode-interaction.md ====================
==================== START: .bmad-core/tasks/kb-mode-interaction.md ====================
<!-- Powered by BMAD™ Core -->
# KB Mode Interaction Task
## Purpose
@@ -792,10 +795,11 @@ Or ask me about anything else related to BMad-Method!
**User**: Tell me about workflows
**Assistant**: [Provides focused information about workflows from the KB, then offers to explore specific workflow types or related topics]
==================== END: bmad-core/tasks/kb-mode-interaction.md ====================
==================== END: .bmad-core/tasks/kb-mode-interaction.md ====================
==================== START: bmad-core/data/bmad-kb.md ====================
==================== START: .bmad-core/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMAD™ Knowledge Base
## Overview
@@ -903,7 +907,7 @@ npx bmad-method install
**Verify Installation**:
- `bmad-core/` folder created with all agents
- `.bmad-core/` folder created with all agents
- IDE-specific integration files created
- All agent commands/rules/modes available
@@ -1602,10 +1606,11 @@ Use the **expansion-creator** pack to build your own:
- **Documentation**: Check `docs/` folder for project-specific context
- **Community**: Discord and GitHub resources available for support
- **Contributing**: See `CONTRIBUTING.md` for full guidelines
==================== END: bmad-core/data/bmad-kb.md ====================
==================== END: .bmad-core/data/bmad-kb.md ====================
==================== START: bmad-core/data/elicitation-methods.md ====================
==================== START: .bmad-core/data/elicitation-methods.md ====================
<!-- Powered by BMAD™ Core -->
# Elicitation Methods Data
## Core Reflective Methods
@@ -1760,10 +1765,11 @@ Use the **expansion-creator** pack to build your own:
- Acknowledge choice to finalize current work
- Accept output as-is or move to next step
- Prepare to continue without additional elicitation
==================== END: bmad-core/data/elicitation-methods.md ====================
==================== END: .bmad-core/data/elicitation-methods.md ====================
==================== START: bmad-core/utils/workflow-management.md ====================
==================== START: .bmad-core/utils/workflow-management.md ====================
<!-- Powered by BMAD™ Core -->
# Workflow Management
Enables BMad orchestrator to manage and execute team workflows.
@@ -1833,10 +1839,11 @@ Handle conditional paths by asking clarifying questions when needed.
## Agent Integration
Agents should be workflow-aware: know active workflow, their role, access artifacts, understand expected outputs.
==================== END: bmad-core/utils/workflow-management.md ====================
==================== END: .bmad-core/utils/workflow-management.md ====================
==================== START: bmad-core/tasks/create-deep-research-prompt.md ====================
==================== START: .bmad-core/tasks/create-deep-research-prompt.md ====================
<!-- Powered by BMAD™ Core -->
# Create Deep Research Prompt Task
This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation.
@@ -2115,10 +2122,11 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
- Balance comprehensiveness with focus
- Document assumptions and limitations clearly
- Plan for iterative refinement based on initial findings
==================== END: bmad-core/tasks/create-deep-research-prompt.md ====================
==================== END: .bmad-core/tasks/create-deep-research-prompt.md ====================
==================== START: bmad-core/tasks/document-project.md ====================
==================== START: .bmad-core/tasks/document-project.md ====================
<!-- Powered by BMAD™ Core -->
# Document an Existing Project
## Purpose
@@ -2462,13 +2470,14 @@ Apply the advanced elicitation task after major sections to refine based on user
- Documents technical debt, workarounds, and constraints honestly
- For brownfield projects with PRD: Provides clear enhancement impact analysis
- The goal is PRACTICAL documentation for AI agents doing real work
==================== END: bmad-core/tasks/document-project.md ====================
==================== END: .bmad-core/tasks/document-project.md ====================
==================== START: .bmad-core/tasks/facilitate-brainstorming-session.md ====================
## <!-- Powered by BMAD™ Core -->
==================== START: bmad-core/tasks/facilitate-brainstorming-session.md ====================
<!-- Powered by BMAD™ Core -->
---
docOutputLocation: docs/brainstorming-session-results.md
template: 'bmad-core/templates/brainstorming-output-tmpl.yaml'
template: '.bmad-core/templates/brainstorming-output-tmpl.yaml'
---
# Facilitate Brainstorming Session Task
@@ -2602,9 +2611,9 @@ Generate structured document with these sections:
- Always ask before switching techniques: "Ready to try a different approach?"
- Offer options: "Should we explore this idea deeper or generate more alternatives?"
- Respect their process and timing
==================== END: bmad-core/tasks/facilitate-brainstorming-session.md ====================
==================== END: .bmad-core/tasks/facilitate-brainstorming-session.md ====================
==================== START: bmad-core/templates/brainstorming-output-tmpl.yaml ====================
==================== START: .bmad-core/templates/brainstorming-output-tmpl.yaml ====================
template:
id: brainstorming-output-template-v2
name: Brainstorming Session Results
@@ -2761,9 +2770,9 @@ sections:
---
*Session facilitated using the BMAD-METHOD™ brainstorming framework*
==================== END: bmad-core/templates/brainstorming-output-tmpl.yaml ====================
==================== END: .bmad-core/templates/brainstorming-output-tmpl.yaml ====================
==================== START: bmad-core/templates/competitor-analysis-tmpl.yaml ====================
==================== START: .bmad-core/templates/competitor-analysis-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: competitor-analysis-template-v2
@@ -3071,9 +3080,9 @@ sections:
- Weekly: {{weekly_items}}
- Monthly: {{monthly_items}}
- Quarterly: {{quarterly_analysis}}
==================== END: bmad-core/templates/competitor-analysis-tmpl.yaml ====================
==================== END: .bmad-core/templates/competitor-analysis-tmpl.yaml ====================
==================== START: bmad-core/templates/market-research-tmpl.yaml ====================
==================== START: .bmad-core/templates/market-research-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: market-research-template-v2
@@ -3327,9 +3336,9 @@ sections:
- id: additional-analysis
title: C. Additional Analysis
instruction: Any supplementary analysis not included in main body
==================== END: bmad-core/templates/market-research-tmpl.yaml ====================
==================== END: .bmad-core/templates/market-research-tmpl.yaml ====================
==================== START: bmad-core/templates/project-brief-tmpl.yaml ====================
==================== START: .bmad-core/templates/project-brief-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: project-brief-template-v2
@@ -3552,10 +3561,11 @@ sections:
title: PM Handoff
content: |
This Project Brief provides the full context for {{project_name}}. Please start in 'PRD Generation Mode', review the brief thoroughly to work with the user to create the PRD section by section as the template indicates, asking for any necessary clarification or suggesting improvements.
==================== END: bmad-core/templates/project-brief-tmpl.yaml ====================
==================== END: .bmad-core/templates/project-brief-tmpl.yaml ====================
==================== START: bmad-core/data/brainstorming-techniques.md ====================
==================== START: .bmad-core/data/brainstorming-techniques.md ====================
<!-- Powered by BMAD™ Core -->
# Brainstorming Techniques Data
## Creative Expansion
@@ -3592,10 +3602,11 @@ sections:
18. **Resource Constraints**: "What if you had only $10 and 1 hour?"
19. **Metaphor Mapping**: Use extended metaphors to explore solutions
20. **Question Storming**: Generate questions instead of answers first
==================== END: bmad-core/data/brainstorming-techniques.md ====================
==================== END: .bmad-core/data/brainstorming-techniques.md ====================
==================== START: bmad-core/tasks/brownfield-create-epic.md ====================
==================== START: .bmad-core/tasks/brownfield-create-epic.md ====================
<!-- Powered by BMAD™ Core -->
# Create Brownfield Epic Task
## Purpose
@@ -3756,10 +3767,11 @@ The epic creation is successful when:
- If the scope grows beyond 3 stories, consider the full brownfield PRD process
- Always prioritize existing system integrity over new functionality
- When in doubt about scope or complexity, escalate to full brownfield planning
==================== END: bmad-core/tasks/brownfield-create-epic.md ====================
==================== END: .bmad-core/tasks/brownfield-create-epic.md ====================
==================== START: bmad-core/tasks/brownfield-create-story.md ====================
==================== START: .bmad-core/tasks/brownfield-create-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Brownfield Story Task
## Purpose
@@ -3907,15 +3919,16 @@ The story creation is successful when:
- Always prioritize existing system integrity
- When in doubt about integration complexity, use brownfield-create-epic instead
- Stories should take no more than 4 hours of focused development work
==================== END: bmad-core/tasks/brownfield-create-story.md ====================
==================== END: .bmad-core/tasks/brownfield-create-story.md ====================
==================== START: bmad-core/tasks/correct-course.md ====================
==================== START: .bmad-core/tasks/correct-course.md ====================
<!-- Powered by BMAD™ Core -->
# Correct Course Task
## Purpose
- Guide a structured response to a change trigger using the `bmad-core/checklists/change-checklist`.
- Guide a structured response to a change trigger using the `.bmad-core/checklists/change-checklist`.
- Analyze the impacts of the change on epics, project artifacts, and the MVP, guided by the checklist's structure.
- Explore potential solutions (e.g., adjust scope, rollback elements, re-scope features) as prompted by the checklist.
- Draft specific, actionable proposed updates to any affected project artifacts (e.g., epics, user stories, PRD sections, architecture document sections) based on the analysis.
@@ -3929,7 +3942,7 @@ The story creation is successful when:
- **Acknowledge Task & Inputs:**
- Confirm with the user that the "Correct Course Task" (Change Navigation & Integration) is being initiated.
- Verify the change trigger and ensure you have the user's initial explanation of the issue and its perceived impact.
- Confirm access to all relevant project artifacts (e.g., PRD, Epics/Stories, Architecture Documents, UI/UX Specifications) and, critically, the `bmad-core/checklists/change-checklist`.
- Confirm access to all relevant project artifacts (e.g., PRD, Epics/Stories, Architecture Documents, UI/UX Specifications) and, critically, the `.bmad-core/checklists/change-checklist`.
- **Establish Interaction Mode:**
- Ask the user their preferred interaction mode for this task:
- **"Incrementally (Default & Recommended):** Shall we work through the change-checklist section by section, discussing findings and collaboratively drafting proposed changes for each relevant part before moving to the next? This allows for detailed, step-by-step refinement."
@@ -3981,17 +3994,18 @@ The story creation is successful when:
- A summary of the change-checklist analysis (issue, impact, rationale for the chosen path).
- Specific, clearly drafted proposed edits for all affected project artifacts.
- **Implicit:** An annotated change-checklist (or the record of its completion) reflecting the discussions, findings, and decisions made during the process.
==================== END: bmad-core/tasks/correct-course.md ====================
==================== END: .bmad-core/tasks/correct-course.md ====================
==================== START: bmad-core/tasks/execute-checklist.md ====================
==================== START: .bmad-core/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
## Available Checklists
If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the bmad-core/checklists folder to select the appropriate one to run.
If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the .bmad-core/checklists folder to select the appropriate one to run.
## Instructions
@@ -3999,7 +4013,7 @@ If the user asks or does not specify a specific checklist, list the checklists a
- If user or the task being run provides a checklist name:
- Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
- If multiple matches found, ask user to clarify
- Load the appropriate checklist from bmad-core/checklists/
- Load the appropriate checklist from .bmad-core/checklists/
- If no checklist specified:
- Ask the user which checklist they want to use
- Present the available options from the files in the checklists folder
@@ -4071,10 +4085,11 @@ The LLM will:
- Execute the complete checklist validation
- Present a final report with pass/fail rates and key findings
- Offer to provide detailed analysis of any section, especially those with warnings or failures
==================== END: bmad-core/tasks/execute-checklist.md ====================
==================== END: .bmad-core/tasks/execute-checklist.md ====================
==================== START: bmad-core/tasks/shard-doc.md ====================
==================== START: .bmad-core/tasks/shard-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Document Sharding Task
## Purpose
@@ -4085,20 +4100,20 @@ The LLM will:
## Primary Method: Automatic with markdown-tree
[[LLM: First, check if markdownExploder is set to true in bmad-core/core-config.yaml. If it is, attempt to run the command: `md-tree explode {input file} {output path}`.
[[LLM: First, check if markdownExploder is set to true in .bmad-core/core-config.yaml. If it is, attempt to run the command: `md-tree explode {input file} {output path}`.
If the command succeeds, inform the user that the document has been sharded successfully and STOP - do not proceed further.
If the command fails (especially with an error indicating the command is not found or not available), inform the user: "The markdownExploder setting is enabled but the md-tree command is not available. Please either:
1. Install @kayvan/markdown-tree-parser globally with: `npm install -g @kayvan/markdown-tree-parser`
2. Or set markdownExploder to false in bmad-core/core-config.yaml
2. Or set markdownExploder to false in .bmad-core/core-config.yaml
**IMPORTANT: STOP HERE - do not proceed with manual sharding until one of the above actions is taken.**"
If markdownExploder is set to false, inform the user: "The markdownExploder setting is currently false. For better performance and reliability, you should:
1. Set markdownExploder to true in bmad-core/core-config.yaml
1. Set markdownExploder to true in .bmad-core/core-config.yaml
2. Install @kayvan/markdown-tree-parser globally with: `npm install -g @kayvan/markdown-tree-parser`
I will now proceed with the manual sharding process."
@@ -4260,9 +4275,9 @@ Document sharded successfully:
- Preserve ALL formatting, including whitespace where significant
- Handle edge cases like sections with code blocks containing ## symbols
- Ensure the sharding is reversible (could reconstruct the original from shards)
==================== END: bmad-core/tasks/shard-doc.md ====================
==================== END: .bmad-core/tasks/shard-doc.md ====================
==================== START: bmad-core/templates/brownfield-prd-tmpl.yaml ====================
==================== START: .bmad-core/templates/brownfield-prd-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: brownfield-prd-template-v2
@@ -4544,9 +4559,9 @@ sections:
- template: "IV1: {{existing_functionality_verification}}"
- template: "IV2: {{integration_point_verification}}"
- template: "IV3: {{performance_impact_verification}}"
==================== END: bmad-core/templates/brownfield-prd-tmpl.yaml ====================
==================== END: .bmad-core/templates/brownfield-prd-tmpl.yaml ====================
==================== START: bmad-core/templates/prd-tmpl.yaml ====================
==================== START: .bmad-core/templates/prd-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: prd-template-v2
@@ -4649,7 +4664,7 @@ sections:
instruction: |
Gather technical decisions that will guide the Architect. Steps:
1. Check if bmad-core/data/technical-preferences.yaml or an attached technical-preferences file exists - use it to pre-populate choices
1. Check if .bmad-core/data/technical-preferences.yaml or an attached technical-preferences file exists - use it to pre-populate choices
2. Ask user about: languages, frameworks, starter templates, libraries, APIs, deployment targets
3. For unknowns, offer guidance based on project goals and MVP scope
4. Document ALL technical choices with rationale (why this choice fits the project)
@@ -4750,10 +4765,11 @@ sections:
- id: architect-prompt
title: Architect Prompt
instruction: This section will contain the prompt for the Architect, keep it short and to the point to initiate create architecture mode using this document as input.
==================== END: bmad-core/templates/prd-tmpl.yaml ====================
==================== END: .bmad-core/templates/prd-tmpl.yaml ====================
==================== START: bmad-core/checklists/change-checklist.md ====================
==================== START: .bmad-core/checklists/change-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Change Navigation Checklist
**Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMad workflow.
@@ -4936,10 +4952,11 @@ Keep it action-oriented and forward-looking.]]
- [ ] **Confirm Next Steps:** Reiterate the handoff plan and the next actions to be taken by specific agents.
---
==================== END: bmad-core/checklists/change-checklist.md ====================
==================== END: .bmad-core/checklists/change-checklist.md ====================
==================== START: bmad-core/checklists/pm-checklist.md ====================
==================== START: .bmad-core/checklists/pm-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Product Manager (PM) Requirements Checklist
This checklist serves as a comprehensive framework to ensure the Product Requirements Document (PRD) and Epic definitions are complete, well-structured, and appropriately scoped for MVP development. The PM should systematically work through each item during the product definition process.
@@ -5310,17 +5327,19 @@ After presenting the report, ask if the user wants:
- **READY FOR ARCHITECT**: The PRD and epics are comprehensive, properly structured, and ready for architectural design.
- **NEEDS REFINEMENT**: The requirements documentation requires additional work to address the identified deficiencies.
==================== END: bmad-core/checklists/pm-checklist.md ====================
==================== END: .bmad-core/checklists/pm-checklist.md ====================
==================== START: bmad-core/data/technical-preferences.md ====================
==================== START: .bmad-core/data/technical-preferences.md ====================
<!-- Powered by BMAD™ Core -->
# User-Defined Preferred Patterns and Preferences
None Listed
==================== END: bmad-core/data/technical-preferences.md ====================
==================== END: .bmad-core/data/technical-preferences.md ====================
==================== START: bmad-core/tasks/generate-ai-frontend-prompt.md ====================
==================== START: .bmad-core/tasks/generate-ai-frontend-prompt.md ====================
<!-- Powered by BMAD™ Core -->
# Create AI Frontend Prompt Task
## Purpose
@@ -5372,9 +5391,9 @@ You will now synthesize the inputs and the above principles into a final, compre
- Output the complete, generated prompt in a clear, copy-pasteable format (e.g., a large code block).
- Explain the structure of the prompt and why certain information was included, referencing the principles above.
- <important_note>Conclude by reminding the user that all AI-generated code will require careful human review, testing, and refinement to be considered production-ready.</important_note>
==================== END: bmad-core/tasks/generate-ai-frontend-prompt.md ====================
==================== END: .bmad-core/tasks/generate-ai-frontend-prompt.md ====================
==================== START: bmad-core/templates/front-end-spec-tmpl.yaml ====================
==================== START: .bmad-core/templates/front-end-spec-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: frontend-spec-template-v2
@@ -5725,9 +5744,9 @@ sections:
- id: checklist-results
title: Checklist Results
instruction: If a UI/UX checklist exists, run it against this document and report results here.
==================== END: bmad-core/templates/front-end-spec-tmpl.yaml ====================
==================== END: .bmad-core/templates/front-end-spec-tmpl.yaml ====================
==================== START: bmad-core/templates/architecture-tmpl.yaml ====================
==================== START: .bmad-core/templates/architecture-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: architecture-template-v2
@@ -5858,7 +5877,7 @@ sections:
instruction: |
This is the DEFINITIVE technology selection section. Work with the user to make specific choices:
1. Review PRD technical assumptions and any preferences from bmad-core/data/technical-preferences.yaml or an attached technical-preferences
1. Review PRD technical assumptions and any preferences from .bmad-core/data/technical-preferences.yaml or an attached technical-preferences
2. For each category, present 2-3 viable options with pros/cons
3. Make a clear recommendation based on project needs
4. Get explicit user approval for each selection
@@ -6379,9 +6398,9 @@ sections:
- Key UI requirements from PRD
- Any frontend-specific decisions made here
- Request for detailed frontend architecture
==================== END: bmad-core/templates/architecture-tmpl.yaml ====================
==================== END: .bmad-core/templates/architecture-tmpl.yaml ====================
==================== START: bmad-core/templates/brownfield-architecture-tmpl.yaml ====================
==================== START: .bmad-core/templates/brownfield-architecture-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: brownfield-architecture-template-v2
@@ -6859,9 +6878,9 @@ sections:
- Key technical decisions based on real project constraints
- Existing system compatibility requirements with specific verification steps
- Clear sequencing of implementation to minimize risk to existing functionality
==================== END: bmad-core/templates/brownfield-architecture-tmpl.yaml ====================
==================== END: .bmad-core/templates/brownfield-architecture-tmpl.yaml ====================
==================== START: bmad-core/templates/front-end-architecture-tmpl.yaml ====================
==================== START: .bmad-core/templates/front-end-architecture-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: frontend-architecture-template-v2
@@ -7081,9 +7100,9 @@ sections:
- Key import patterns
- File naming conventions
- Project-specific patterns and utilities
==================== END: bmad-core/templates/front-end-architecture-tmpl.yaml ====================
==================== END: .bmad-core/templates/front-end-architecture-tmpl.yaml ====================
==================== START: bmad-core/templates/fullstack-architecture-tmpl.yaml ====================
==================== START: .bmad-core/templates/fullstack-architecture-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: fullstack-architecture-template-v2
@@ -7908,10 +7927,11 @@ sections:
- id: checklist-results
title: Checklist Results Report
instruction: Before running the checklist, offer to output the full architecture document. Once user confirms, execute the architect-checklist and populate results here.
==================== END: bmad-core/templates/fullstack-architecture-tmpl.yaml ====================
==================== END: .bmad-core/templates/fullstack-architecture-tmpl.yaml ====================
==================== START: bmad-core/checklists/architect-checklist.md ====================
==================== START: .bmad-core/checklists/architect-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Architect Solution Validation Checklist
This checklist serves as a comprehensive framework for the Architect to validate the technical design and architecture before development execution. The Architect should systematically work through each item, ensuring the architecture is robust, scalable, secure, and aligned with the product requirements.
@@ -8350,10 +8370,11 @@ Now that you've completed the checklist, generate a comprehensive validation rep
- Component design clarity
After presenting the report, ask the user if they would like detailed analysis of any specific section, especially those with warnings or failures.]]
==================== END: bmad-core/checklists/architect-checklist.md ====================
==================== END: .bmad-core/checklists/architect-checklist.md ====================
==================== START: bmad-core/tasks/validate-next-story.md ====================
==================== START: .bmad-core/tasks/validate-next-story.md ====================
<!-- Powered by BMAD™ Core -->
# Validate Next Story Task
## Purpose
@@ -8364,7 +8385,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
### 0. Load Core Configuration and Inputs
- Load `bmad-core/core-config.yaml`
- Load `.bmad-core/core-config.yaml`
- If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story validation."
- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`
- Identify and load the following inputs:
@@ -8488,9 +8509,9 @@ Provide a structured validation report including:
- **NO-GO**: Story requires fixes before implementation
- **Implementation Readiness Score**: 1-10 scale
- **Confidence Level**: High/Medium/Low for successful implementation
==================== END: bmad-core/tasks/validate-next-story.md ====================
==================== END: .bmad-core/tasks/validate-next-story.md ====================
==================== START: bmad-core/templates/story-tmpl.yaml ====================
==================== START: .bmad-core/templates/story-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: story-template-v2
@@ -8629,10 +8650,11 @@ sections:
instruction: Results from QA Agent QA review of the completed story implementation
owner: qa-agent
editors: [qa-agent]
==================== END: bmad-core/templates/story-tmpl.yaml ====================
==================== END: .bmad-core/templates/story-tmpl.yaml ====================
==================== START: bmad-core/checklists/po-master-checklist.md ====================
==================== START: .bmad-core/checklists/po-master-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Product Owner (PO) Master Validation Checklist
This checklist serves as a comprehensive framework for the Product Owner to validate project plans before development execution. It adapts intelligently based on project type (greenfield vs brownfield) and includes UI/UX considerations when applicable.
@@ -9065,9 +9087,9 @@ After presenting the report, ask if the user wants:
- **APPROVED**: The plan is comprehensive, properly sequenced, and ready for implementation.
- **CONDITIONAL**: The plan requires specific adjustments before proceeding.
- **REJECTED**: The plan requires significant revision to address critical deficiencies.
==================== END: bmad-core/checklists/po-master-checklist.md ====================
==================== END: .bmad-core/checklists/po-master-checklist.md ====================
==================== START: bmad-core/workflows/brownfield-fullstack.yaml ====================
==================== START: .bmad-core/workflows/brownfield-fullstack.yaml ====================
# <!-- Powered by BMAD™ Core -->
workflow:
id: brownfield-fullstack
@@ -9253,7 +9275,7 @@ workflow:
All stories implemented and reviewed!
Project development phase complete.
Reference: bmad-core/data/bmad-kb.md#IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid
@@ -9366,9 +9388,9 @@ workflow:
{{if missing_context}}: May need to gather additional context from user during story creation.
complete: "All planning artifacts validated and development can begin. Stories will be created based on available documentation format."
==================== END: bmad-core/workflows/brownfield-fullstack.yaml ====================
==================== END: .bmad-core/workflows/brownfield-fullstack.yaml ====================
==================== START: bmad-core/workflows/brownfield-service.yaml ====================
==================== START: .bmad-core/workflows/brownfield-service.yaml ====================
# <!-- Powered by BMAD™ Core -->
workflow:
id: brownfield-service
@@ -9500,7 +9522,7 @@ workflow:
All stories implemented and reviewed!
Project development phase complete.
Reference: bmad-core/data/bmad-kb.md#IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid
@@ -9557,9 +9579,9 @@ workflow:
architect_to_po: "Architecture complete. Save it as docs/architecture.md. Please validate all artifacts for service integration safety."
po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
==================== END: bmad-core/workflows/brownfield-service.yaml ====================
==================== END: .bmad-core/workflows/brownfield-service.yaml ====================
==================== START: bmad-core/workflows/brownfield-ui.yaml ====================
==================== START: .bmad-core/workflows/brownfield-ui.yaml ====================
# <!-- Powered by BMAD™ Core -->
workflow:
id: brownfield-ui
@@ -9698,7 +9720,7 @@ workflow:
All stories implemented and reviewed!
Project development phase complete.
Reference: bmad-core/data/bmad-kb.md#IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid
@@ -9758,9 +9780,9 @@ workflow:
architect_to_po: "Architecture complete. Save it as docs/architecture.md. Please validate all artifacts for UI integration safety."
po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
==================== END: bmad-core/workflows/brownfield-ui.yaml ====================
==================== END: .bmad-core/workflows/brownfield-ui.yaml ====================
==================== START: bmad-core/workflows/greenfield-fullstack.yaml ====================
==================== START: .bmad-core/workflows/greenfield-fullstack.yaml ====================
# <!-- Powered by BMAD™ Core -->
workflow:
id: greenfield-fullstack
@@ -9924,7 +9946,7 @@ workflow:
All stories implemented and reviewed!
Project development phase complete.
Reference: bmad-core/data/bmad-kb.md#IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid
@@ -10002,9 +10024,9 @@ workflow:
updated_to_po: "All documents ready in docs/ folder. Please validate all artifacts for consistency."
po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
==================== END: bmad-core/workflows/greenfield-fullstack.yaml ====================
==================== END: .bmad-core/workflows/greenfield-fullstack.yaml ====================
==================== START: bmad-core/workflows/greenfield-service.yaml ====================
==================== START: .bmad-core/workflows/greenfield-service.yaml ====================
# <!-- Powered by BMAD™ Core -->
workflow:
id: greenfield-service
@@ -10144,7 +10166,7 @@ workflow:
All stories implemented and reviewed!
Service development phase complete.
Reference: bmad-core/data/bmad-kb.md#IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid
@@ -10212,9 +10234,9 @@ workflow:
updated_to_po: "All documents ready in docs/ folder. Please validate all artifacts for consistency."
po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
==================== END: bmad-core/workflows/greenfield-service.yaml ====================
==================== END: .bmad-core/workflows/greenfield-service.yaml ====================
==================== START: bmad-core/workflows/greenfield-ui.yaml ====================
==================== START: .bmad-core/workflows/greenfield-ui.yaml ====================
# <!-- Powered by BMAD™ Core -->
workflow:
id: greenfield-ui
@@ -10373,7 +10395,7 @@ workflow:
All stories implemented and reviewed!
Project development phase complete.
Reference: bmad-core/data/bmad-kb.md#IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid
@@ -10451,4 +10473,4 @@ workflow:
updated_to_po: "All documents ready in docs/ folder. Please validate all artifacts for consistency."
po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
==================== END: bmad-core/workflows/greenfield-ui.yaml ====================
==================== END: .bmad-core/workflows/greenfield-ui.yaml ====================

View File

@@ -8,13 +8,13 @@ You are now operating as a specialized AI agent from the BMad-Method framework.
2. **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
- `==================== START: bmad-core/folder/filename.md ====================`
- `==================== END: bmad-core/folder/filename.md ====================`
- `==================== START: .bmad-core/folder/filename.md ====================`
- `==================== END: .bmad-core/folder/filename.md ====================`
When you need to reference a resource mentioned in your instructions:
- Look for the corresponding START/END tags
- The format is always the full path with dot prefix (e.g., `bmad-core/personas/analyst.md`, `bmad-core/tasks/create-story.md`)
- The format is always the full path with dot prefix (e.g., `.bmad-core/personas/analyst.md`, `.bmad-core/tasks/create-story.md`)
- If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
**Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
@@ -29,8 +29,8 @@ dependencies:
These references map directly to bundle sections:
- `utils: template-format` → Look for `==================== START: bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: bmad-core/tasks/create-story.md ====================`
- `utils: template-format` → Look for `==================== START: .bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: .bmad-core/tasks/create-story.md ====================`
3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
@@ -39,7 +39,7 @@ These references map directly to bundle sections:
---
==================== START: bmad-core/agent-teams/team-ide-minimal.yaml ====================
==================== START: .bmad-core/agent-teams/team-ide-minimal.yaml ====================
# <!-- Powered by BMAD™ Core -->
bundle:
name: Team IDE Minimal
@@ -51,9 +51,9 @@ agents:
- dev
- qa
workflows: null
==================== END: bmad-core/agent-teams/team-ide-minimal.yaml ====================
==================== END: .bmad-core/agent-teams/team-ide-minimal.yaml ====================
==================== START: bmad-core/agents/bmad-orchestrator.md ====================
==================== START: .bmad-core/agents/bmad-orchestrator.md ====================
# bmad-orchestrator
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -178,9 +178,9 @@ dependencies:
utils:
- workflow-management.md
```
==================== END: bmad-core/agents/bmad-orchestrator.md ====================
==================== END: .bmad-core/agents/bmad-orchestrator.md ====================
==================== START: bmad-core/agents/po.md ====================
==================== START: .bmad-core/agents/po.md ====================
# po
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -237,9 +237,9 @@ dependencies:
templates:
- story-tmpl.yaml
```
==================== END: bmad-core/agents/po.md ====================
==================== END: .bmad-core/agents/po.md ====================
==================== START: bmad-core/agents/sm.md ====================
==================== START: .bmad-core/agents/sm.md ====================
# sm
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -282,9 +282,9 @@ dependencies:
templates:
- story-tmpl.yaml
```
==================== END: bmad-core/agents/sm.md ====================
==================== END: .bmad-core/agents/sm.md ====================
==================== START: bmad-core/agents/dev.md ====================
==================== START: .bmad-core/agents/dev.md ====================
# dev
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -335,9 +335,9 @@ dependencies:
- execute-checklist.md
- validate-next-story.md
```
==================== END: bmad-core/agents/dev.md ====================
==================== END: .bmad-core/agents/dev.md ====================
==================== START: bmad-core/agents/qa.md ====================
==================== START: .bmad-core/agents/qa.md ====================
# qa
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -406,10 +406,11 @@ dependencies:
- qa-gate-tmpl.yaml
- story-tmpl.yaml
```
==================== END: bmad-core/agents/qa.md ====================
==================== END: .bmad-core/agents/qa.md ====================
==================== START: bmad-core/tasks/advanced-elicitation.md ====================
==================== START: .bmad-core/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -527,10 +528,11 @@ Choose a number (0-8) or 9 to proceed:
- **Stay Relevant**: Tie all elicitation back to the specific content being analyzed
- **Identify Personas**: For multi-persona methods, clearly identify which viewpoint is speaking
- **Maintain Flow**: Keep the process moving efficiently
==================== END: bmad-core/tasks/advanced-elicitation.md ====================
==================== END: .bmad-core/tasks/advanced-elicitation.md ====================
==================== START: bmad-core/tasks/create-doc.md ====================
==================== START: .bmad-core/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -548,7 +550,7 @@ When this task is invoked:
## Critical: Template Discovery
If a YAML Template has not been provided, list all templates from bmad-core/templates or ask the user to provide another.
If a YAML Template has not been provided, list all templates from .bmad-core/templates or ask the user to provide another.
## CRITICAL: Mandatory Elicitation Format
@@ -632,10 +634,11 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
- Select options 2-9 from data/elicitation-methods only
- Provide detailed rationale explaining decisions
- End with "Select 1-9 or just type your question/feedback:"
==================== END: bmad-core/tasks/create-doc.md ====================
==================== END: .bmad-core/tasks/create-doc.md ====================
==================== START: bmad-core/tasks/kb-mode-interaction.md ====================
==================== START: .bmad-core/tasks/kb-mode-interaction.md ====================
<!-- Powered by BMAD™ Core -->
# KB Mode Interaction Task
## Purpose
@@ -711,10 +714,11 @@ Or ask me about anything else related to BMad-Method!
**User**: Tell me about workflows
**Assistant**: [Provides focused information about workflows from the KB, then offers to explore specific workflow types or related topics]
==================== END: bmad-core/tasks/kb-mode-interaction.md ====================
==================== END: .bmad-core/tasks/kb-mode-interaction.md ====================
==================== START: bmad-core/data/bmad-kb.md ====================
==================== START: .bmad-core/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMAD™ Knowledge Base
## Overview
@@ -822,7 +826,7 @@ npx bmad-method install
**Verify Installation**:
- `bmad-core/` folder created with all agents
- `.bmad-core/` folder created with all agents
- IDE-specific integration files created
- All agent commands/rules/modes available
@@ -1521,10 +1525,11 @@ Use the **expansion-creator** pack to build your own:
- **Documentation**: Check `docs/` folder for project-specific context
- **Community**: Discord and GitHub resources available for support
- **Contributing**: See `CONTRIBUTING.md` for full guidelines
==================== END: bmad-core/data/bmad-kb.md ====================
==================== END: .bmad-core/data/bmad-kb.md ====================
==================== START: bmad-core/data/elicitation-methods.md ====================
==================== START: .bmad-core/data/elicitation-methods.md ====================
<!-- Powered by BMAD™ Core -->
# Elicitation Methods Data
## Core Reflective Methods
@@ -1679,10 +1684,11 @@ Use the **expansion-creator** pack to build your own:
- Acknowledge choice to finalize current work
- Accept output as-is or move to next step
- Prepare to continue without additional elicitation
==================== END: bmad-core/data/elicitation-methods.md ====================
==================== END: .bmad-core/data/elicitation-methods.md ====================
==================== START: bmad-core/utils/workflow-management.md ====================
==================== START: .bmad-core/utils/workflow-management.md ====================
<!-- Powered by BMAD™ Core -->
# Workflow Management
Enables BMad orchestrator to manage and execute team workflows.
@@ -1752,15 +1758,16 @@ Handle conditional paths by asking clarifying questions when needed.
## Agent Integration
Agents should be workflow-aware: know active workflow, their role, access artifacts, understand expected outputs.
==================== END: bmad-core/utils/workflow-management.md ====================
==================== END: .bmad-core/utils/workflow-management.md ====================
==================== START: bmad-core/tasks/correct-course.md ====================
==================== START: .bmad-core/tasks/correct-course.md ====================
<!-- Powered by BMAD™ Core -->
# Correct Course Task
## Purpose
- Guide a structured response to a change trigger using the `bmad-core/checklists/change-checklist`.
- Guide a structured response to a change trigger using the `.bmad-core/checklists/change-checklist`.
- Analyze the impacts of the change on epics, project artifacts, and the MVP, guided by the checklist's structure.
- Explore potential solutions (e.g., adjust scope, rollback elements, re-scope features) as prompted by the checklist.
- Draft specific, actionable proposed updates to any affected project artifacts (e.g., epics, user stories, PRD sections, architecture document sections) based on the analysis.
@@ -1774,7 +1781,7 @@ Agents should be workflow-aware: know active workflow, their role, access artifa
- **Acknowledge Task & Inputs:**
- Confirm with the user that the "Correct Course Task" (Change Navigation & Integration) is being initiated.
- Verify the change trigger and ensure you have the user's initial explanation of the issue and its perceived impact.
- Confirm access to all relevant project artifacts (e.g., PRD, Epics/Stories, Architecture Documents, UI/UX Specifications) and, critically, the `bmad-core/checklists/change-checklist`.
- Confirm access to all relevant project artifacts (e.g., PRD, Epics/Stories, Architecture Documents, UI/UX Specifications) and, critically, the `.bmad-core/checklists/change-checklist`.
- **Establish Interaction Mode:**
- Ask the user their preferred interaction mode for this task:
- **"Incrementally (Default & Recommended):** Shall we work through the change-checklist section by section, discussing findings and collaboratively drafting proposed changes for each relevant part before moving to the next? This allows for detailed, step-by-step refinement."
@@ -1826,17 +1833,18 @@ Agents should be workflow-aware: know active workflow, their role, access artifa
- A summary of the change-checklist analysis (issue, impact, rationale for the chosen path).
- Specific, clearly drafted proposed edits for all affected project artifacts.
- **Implicit:** An annotated change-checklist (or the record of its completion) reflecting the discussions, findings, and decisions made during the process.
==================== END: bmad-core/tasks/correct-course.md ====================
==================== END: .bmad-core/tasks/correct-course.md ====================
==================== START: bmad-core/tasks/execute-checklist.md ====================
==================== START: .bmad-core/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
## Available Checklists
If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the bmad-core/checklists folder to select the appropriate one to run.
If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the .bmad-core/checklists folder to select the appropriate one to run.
## Instructions
@@ -1844,7 +1852,7 @@ If the user asks or does not specify a specific checklist, list the checklists a
- If user or the task being run provides a checklist name:
- Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
- If multiple matches found, ask user to clarify
- Load the appropriate checklist from bmad-core/checklists/
- Load the appropriate checklist from .bmad-core/checklists/
- If no checklist specified:
- Ask the user which checklist they want to use
- Present the available options from the files in the checklists folder
@@ -1916,10 +1924,11 @@ The LLM will:
- Execute the complete checklist validation
- Present a final report with pass/fail rates and key findings
- Offer to provide detailed analysis of any section, especially those with warnings or failures
==================== END: bmad-core/tasks/execute-checklist.md ====================
==================== END: .bmad-core/tasks/execute-checklist.md ====================
==================== START: bmad-core/tasks/shard-doc.md ====================
==================== START: .bmad-core/tasks/shard-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Document Sharding Task
## Purpose
@@ -1930,20 +1939,20 @@ The LLM will:
## Primary Method: Automatic with markdown-tree
[[LLM: First, check if markdownExploder is set to true in bmad-core/core-config.yaml. If it is, attempt to run the command: `md-tree explode {input file} {output path}`.
[[LLM: First, check if markdownExploder is set to true in .bmad-core/core-config.yaml. If it is, attempt to run the command: `md-tree explode {input file} {output path}`.
If the command succeeds, inform the user that the document has been sharded successfully and STOP - do not proceed further.
If the command fails (especially with an error indicating the command is not found or not available), inform the user: "The markdownExploder setting is enabled but the md-tree command is not available. Please either:
1. Install @kayvan/markdown-tree-parser globally with: `npm install -g @kayvan/markdown-tree-parser`
2. Or set markdownExploder to false in bmad-core/core-config.yaml
2. Or set markdownExploder to false in .bmad-core/core-config.yaml
**IMPORTANT: STOP HERE - do not proceed with manual sharding until one of the above actions is taken.**"
If markdownExploder is set to false, inform the user: "The markdownExploder setting is currently false. For better performance and reliability, you should:
1. Set markdownExploder to true in bmad-core/core-config.yaml
1. Set markdownExploder to true in .bmad-core/core-config.yaml
2. Install @kayvan/markdown-tree-parser globally with: `npm install -g @kayvan/markdown-tree-parser`
I will now proceed with the manual sharding process."
@@ -2105,10 +2114,11 @@ Document sharded successfully:
- Preserve ALL formatting, including whitespace where significant
- Handle edge cases like sections with code blocks containing ## symbols
- Ensure the sharding is reversible (could reconstruct the original from shards)
==================== END: bmad-core/tasks/shard-doc.md ====================
==================== END: .bmad-core/tasks/shard-doc.md ====================
==================== START: bmad-core/tasks/validate-next-story.md ====================
==================== START: .bmad-core/tasks/validate-next-story.md ====================
<!-- Powered by BMAD™ Core -->
# Validate Next Story Task
## Purpose
@@ -2119,7 +2129,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
### 0. Load Core Configuration and Inputs
- Load `bmad-core/core-config.yaml`
- Load `.bmad-core/core-config.yaml`
- If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story validation."
- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`
- Identify and load the following inputs:
@@ -2243,9 +2253,9 @@ Provide a structured validation report including:
- **NO-GO**: Story requires fixes before implementation
- **Implementation Readiness Score**: 1-10 scale
- **Confidence Level**: High/Medium/Low for successful implementation
==================== END: bmad-core/tasks/validate-next-story.md ====================
==================== END: .bmad-core/tasks/validate-next-story.md ====================
==================== START: bmad-core/templates/story-tmpl.yaml ====================
==================== START: .bmad-core/templates/story-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: story-template-v2
@@ -2384,10 +2394,11 @@ sections:
instruction: Results from QA Agent QA review of the completed story implementation
owner: qa-agent
editors: [qa-agent]
==================== END: bmad-core/templates/story-tmpl.yaml ====================
==================== END: .bmad-core/templates/story-tmpl.yaml ====================
==================== START: bmad-core/checklists/change-checklist.md ====================
==================== START: .bmad-core/checklists/change-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Change Navigation Checklist
**Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMad workflow.
@@ -2570,10 +2581,11 @@ Keep it action-oriented and forward-looking.]]
- [ ] **Confirm Next Steps:** Reiterate the handoff plan and the next actions to be taken by specific agents.
---
==================== END: bmad-core/checklists/change-checklist.md ====================
==================== END: .bmad-core/checklists/change-checklist.md ====================
==================== START: bmad-core/checklists/po-master-checklist.md ====================
==================== START: .bmad-core/checklists/po-master-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Product Owner (PO) Master Validation Checklist
This checklist serves as a comprehensive framework for the Product Owner to validate project plans before development execution. It adapts intelligently based on project type (greenfield vs brownfield) and includes UI/UX considerations when applicable.
@@ -3006,10 +3018,11 @@ After presenting the report, ask if the user wants:
- **APPROVED**: The plan is comprehensive, properly sequenced, and ready for implementation.
- **CONDITIONAL**: The plan requires specific adjustments before proceeding.
- **REJECTED**: The plan requires significant revision to address critical deficiencies.
==================== END: bmad-core/checklists/po-master-checklist.md ====================
==================== END: .bmad-core/checklists/po-master-checklist.md ====================
==================== START: bmad-core/tasks/create-next-story.md ====================
==================== START: .bmad-core/tasks/create-next-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Next Story Task
## Purpose
@@ -3020,7 +3033,7 @@ To identify the next logical story based on project progress and epic definition
### 0. Load Core Configuration and Check Workflow
- Load `bmad-core/core-config.yaml` from the project root
- Load `.bmad-core/core-config.yaml` from the project root
- If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story creation. You can either: 1) Copy it from GITHUB bmad-core/core-config.yaml and configure it for your project OR 2) Run the BMad installer against your project to upgrade and add the file automatically. Please add and configure core-config.yaml before proceeding."
- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`, `workflow.*`
@@ -3114,18 +3127,19 @@ ALWAYS cite source documents: `[Source: architecture/{filename}.md#{section}]`
- Verify all source references are included for technical details
- Ensure tasks align with both epic requirements and architecture constraints
- Update status to "Draft" and save the story file
- Execute `bmad-core/tasks/execute-checklist` `bmad-core/checklists/story-draft-checklist`
- Execute `.bmad-core/tasks/execute-checklist` `.bmad-core/checklists/story-draft-checklist`
- Provide summary to user including:
- Story created: `{devStoryLocation}/{epicNum}.{storyNum}.story.md`
- Status: Draft
- Key technical components included from architecture docs
- Any deviations or conflicts noted between epic and architecture
- Checklist Results
- Next steps: For Complex stories, suggest the user carefully review the story draft and also optionally have the PO run the task `bmad-core/tasks/validate-next-story`
==================== END: bmad-core/tasks/create-next-story.md ====================
- Next steps: For Complex stories, suggest the user carefully review the story draft and also optionally have the PO run the task `.bmad-core/tasks/validate-next-story`
==================== END: .bmad-core/tasks/create-next-story.md ====================
==================== START: bmad-core/checklists/story-draft-checklist.md ====================
==================== START: .bmad-core/checklists/story-draft-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Story Draft Checklist
The Scrum Master should use this checklist to validate that each story contains sufficient context for a developer agent to implement it successfully, while assuming the dev agent has reasonable capabilities to figure things out.
@@ -3279,10 +3293,11 @@ Be pragmatic - perfect documentation doesn't exist, but it must be enough to pro
- READY: The story provides sufficient context for implementation
- NEEDS REVISION: The story requires updates (see issues)
- BLOCKED: External information required (specify what information)
==================== END: bmad-core/checklists/story-draft-checklist.md ====================
==================== END: .bmad-core/checklists/story-draft-checklist.md ====================
==================== START: bmad-core/tasks/apply-qa-fixes.md ====================
==================== START: .bmad-core/tasks/apply-qa-fixes.md ====================
<!-- Powered by BMAD™ Core -->
# apply-qa-fixes
Implement fixes based on QA results (gate and assessments) for a specific story. This task is for the Dev agent to systematically consume QA outputs and apply code/test changes while only updating allowed sections in the story file.
@@ -3431,10 +3446,11 @@ Fix plan:
- Tests validate behavior and close gaps
- Strict adherence to allowed story update areas
- Gate ownership remains with QA; Dev signals readiness via Status
==================== END: bmad-core/tasks/apply-qa-fixes.md ====================
==================== END: .bmad-core/tasks/apply-qa-fixes.md ====================
==================== START: bmad-core/checklists/story-dod-checklist.md ====================
==================== START: .bmad-core/checklists/story-dod-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Story Definition of Done (DoD) Checklist
## Instructions for Developer Agent
@@ -3529,10 +3545,11 @@ After completing the checklist:
Be honest - it's better to flag issues now than have them discovered later.]]
- [ ] I, the Developer Agent, confirm that all applicable items above have been addressed.
==================== END: bmad-core/checklists/story-dod-checklist.md ====================
==================== END: .bmad-core/checklists/story-dod-checklist.md ====================
==================== START: bmad-core/tasks/nfr-assess.md ====================
==================== START: .bmad-core/tasks/nfr-assess.md ====================
<!-- Powered by BMAD™ Core -->
# nfr-assess
Quick NFR validation focused on the core four: security, performance, reliability, maintainability.
@@ -3876,10 +3893,11 @@ performance_deep_dive:
```
</details>
==================== END: bmad-core/tasks/nfr-assess.md ====================
==================== END: .bmad-core/tasks/nfr-assess.md ====================
==================== START: bmad-core/tasks/qa-gate.md ====================
==================== START: .bmad-core/tasks/qa-gate.md ====================
<!-- Powered by BMAD™ Core -->
# qa-gate
Create or update a quality gate decision file for a story based on review findings.
@@ -4041,10 +4059,11 @@ Gate: CONCERNS → qa.qaLocation/gates/{epic}.{story}-{slug}.yml
- Always write to standard path
- Always update story with gate reference
- Clear, actionable findings
==================== END: bmad-core/tasks/qa-gate.md ====================
==================== END: .bmad-core/tasks/qa-gate.md ====================
==================== START: bmad-core/tasks/review-story.md ====================
==================== START: .bmad-core/tasks/review-story.md ====================
<!-- Powered by BMAD™ Core -->
# review-story
Perform a comprehensive test architecture review with quality gate decision. This adaptive, risk-aware review creates both a story update and a detailed gate file.
@@ -4359,10 +4378,11 @@ After review:
3. Recommend status: "Ready for Done" or "Changes Required" (owner decides)
4. If files were modified, list them in QA Results and ask Dev to update File List
5. Always provide constructive feedback and actionable recommendations
==================== END: bmad-core/tasks/review-story.md ====================
==================== END: .bmad-core/tasks/review-story.md ====================
==================== START: bmad-core/tasks/risk-profile.md ====================
==================== START: .bmad-core/tasks/risk-profile.md ====================
<!-- Powered by BMAD™ Core -->
# risk-profile
Generate a comprehensive risk assessment matrix for a story implementation using probability × impact analysis.
@@ -4716,10 +4736,11 @@ Risk profile: qa.qaLocation/assessments/{epic}.{story}-risk-{YYYYMMDD}.md
- Link risks to specific test requirements
- Track residual risk after mitigation
- Update risk profile as story evolves
==================== END: bmad-core/tasks/risk-profile.md ====================
==================== END: .bmad-core/tasks/risk-profile.md ====================
==================== START: bmad-core/tasks/test-design.md ====================
==================== START: .bmad-core/tasks/test-design.md ====================
<!-- Powered by BMAD™ Core -->
# test-design
Create comprehensive test scenarios with appropriate test level recommendations for story implementation.
@@ -4894,10 +4915,11 @@ Before finalizing, verify:
- **Efficient coverage**: Test once at the right level
- **Maintainability**: Consider long-term test maintenance
- **Fast feedback**: Quick tests run first
==================== END: bmad-core/tasks/test-design.md ====================
==================== END: .bmad-core/tasks/test-design.md ====================
==================== START: bmad-core/tasks/trace-requirements.md ====================
==================== START: .bmad-core/tasks/trace-requirements.md ====================
<!-- Powered by BMAD™ Core -->
# trace-requirements
Map story requirements to test cases using Given-When-Then patterns for comprehensive traceability.
@@ -5162,9 +5184,9 @@ Trace matrix: qa.qaLocation/assessments/{epic}.{story}-trace-{YYYYMMDD}.md
- Identify both presence and absence
- Prioritize based on risk
- Make recommendations actionable
==================== END: bmad-core/tasks/trace-requirements.md ====================
==================== END: .bmad-core/tasks/trace-requirements.md ====================
==================== START: bmad-core/templates/qa-gate-tmpl.yaml ====================
==================== START: .bmad-core/templates/qa-gate-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: qa-gate-template-v1
@@ -5268,11 +5290,12 @@ optional_fields_examples:
future: # Can be addressed later
- action: "Consider caching for better performance"
refs: ["services/data.service.ts"]
==================== END: bmad-core/templates/qa-gate-tmpl.yaml ====================
==================== END: .bmad-core/templates/qa-gate-tmpl.yaml ====================
==================== START: bmad-core/data/technical-preferences.md ====================
==================== START: .bmad-core/data/technical-preferences.md ====================
<!-- Powered by BMAD™ Core -->
# User-Defined Preferred Patterns and Preferences
None Listed
==================== END: bmad-core/data/technical-preferences.md ====================
==================== END: .bmad-core/data/technical-preferences.md ====================

View File

@@ -8,13 +8,13 @@ You are now operating as a specialized AI agent from the BMad-Method framework.
2. **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
- `==================== START: bmad-core/folder/filename.md ====================`
- `==================== END: bmad-core/folder/filename.md ====================`
- `==================== START: .bmad-core/folder/filename.md ====================`
- `==================== END: .bmad-core/folder/filename.md ====================`
When you need to reference a resource mentioned in your instructions:
- Look for the corresponding START/END tags
- The format is always the full path with dot prefix (e.g., `bmad-core/personas/analyst.md`, `bmad-core/tasks/create-story.md`)
- The format is always the full path with dot prefix (e.g., `.bmad-core/personas/analyst.md`, `.bmad-core/tasks/create-story.md`)
- If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
**Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
@@ -29,8 +29,8 @@ dependencies:
These references map directly to bundle sections:
- `utils: template-format` → Look for `==================== START: bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: bmad-core/tasks/create-story.md ====================`
- `utils: template-format` → Look for `==================== START: .bmad-core/utils/template-format.md ====================`
- `tasks: create-story` → Look for `==================== START: .bmad-core/tasks/create-story.md ====================`
3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
@@ -39,7 +39,7 @@ These references map directly to bundle sections:
---
==================== START: bmad-core/agent-teams/team-no-ui.yaml ====================
==================== START: .bmad-core/agent-teams/team-no-ui.yaml ====================
# <!-- Powered by BMAD™ Core -->
bundle:
name: Team No UI
@@ -54,9 +54,9 @@ agents:
workflows:
- greenfield-service.yaml
- brownfield-service.yaml
==================== END: bmad-core/agent-teams/team-no-ui.yaml ====================
==================== END: .bmad-core/agent-teams/team-no-ui.yaml ====================
==================== START: bmad-core/agents/bmad-orchestrator.md ====================
==================== START: .bmad-core/agents/bmad-orchestrator.md ====================
# bmad-orchestrator
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -181,9 +181,9 @@ dependencies:
utils:
- workflow-management.md
```
==================== END: bmad-core/agents/bmad-orchestrator.md ====================
==================== END: .bmad-core/agents/bmad-orchestrator.md ====================
==================== START: bmad-core/agents/analyst.md ====================
==================== START: .bmad-core/agents/analyst.md ====================
# analyst
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -245,9 +245,9 @@ dependencies:
- market-research-tmpl.yaml
- project-brief-tmpl.yaml
```
==================== END: bmad-core/agents/analyst.md ====================
==================== END: .bmad-core/agents/analyst.md ====================
==================== START: bmad-core/agents/pm.md ====================
==================== START: .bmad-core/agents/pm.md ====================
# pm
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -309,9 +309,9 @@ dependencies:
- brownfield-prd-tmpl.yaml
- prd-tmpl.yaml
```
==================== END: bmad-core/agents/pm.md ====================
==================== END: .bmad-core/agents/pm.md ====================
==================== START: bmad-core/agents/architect.md ====================
==================== START: .bmad-core/agents/architect.md ====================
# architect
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -374,9 +374,9 @@ dependencies:
- front-end-architecture-tmpl.yaml
- fullstack-architecture-tmpl.yaml
```
==================== END: bmad-core/agents/architect.md ====================
==================== END: .bmad-core/agents/architect.md ====================
==================== START: bmad-core/agents/po.md ====================
==================== START: .bmad-core/agents/po.md ====================
# po
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -433,10 +433,11 @@ dependencies:
templates:
- story-tmpl.yaml
```
==================== END: bmad-core/agents/po.md ====================
==================== END: .bmad-core/agents/po.md ====================
==================== START: bmad-core/tasks/advanced-elicitation.md ====================
==================== START: .bmad-core/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -554,10 +555,11 @@ Choose a number (0-8) or 9 to proceed:
- **Stay Relevant**: Tie all elicitation back to the specific content being analyzed
- **Identify Personas**: For multi-persona methods, clearly identify which viewpoint is speaking
- **Maintain Flow**: Keep the process moving efficiently
==================== END: bmad-core/tasks/advanced-elicitation.md ====================
==================== END: .bmad-core/tasks/advanced-elicitation.md ====================
==================== START: bmad-core/tasks/create-doc.md ====================
==================== START: .bmad-core/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -575,7 +577,7 @@ When this task is invoked:
## Critical: Template Discovery
If a YAML Template has not been provided, list all templates from bmad-core/templates or ask the user to provide another.
If a YAML Template has not been provided, list all templates from .bmad-core/templates or ask the user to provide another.
## CRITICAL: Mandatory Elicitation Format
@@ -659,10 +661,11 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
- Select options 2-9 from data/elicitation-methods only
- Provide detailed rationale explaining decisions
- End with "Select 1-9 or just type your question/feedback:"
==================== END: bmad-core/tasks/create-doc.md ====================
==================== END: .bmad-core/tasks/create-doc.md ====================
==================== START: bmad-core/tasks/kb-mode-interaction.md ====================
==================== START: .bmad-core/tasks/kb-mode-interaction.md ====================
<!-- Powered by BMAD™ Core -->
# KB Mode Interaction Task
## Purpose
@@ -738,10 +741,11 @@ Or ask me about anything else related to BMad-Method!
**User**: Tell me about workflows
**Assistant**: [Provides focused information about workflows from the KB, then offers to explore specific workflow types or related topics]
==================== END: bmad-core/tasks/kb-mode-interaction.md ====================
==================== END: .bmad-core/tasks/kb-mode-interaction.md ====================
==================== START: bmad-core/data/bmad-kb.md ====================
==================== START: .bmad-core/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMAD™ Knowledge Base
## Overview
@@ -849,7 +853,7 @@ npx bmad-method install
**Verify Installation**:
- `bmad-core/` folder created with all agents
- `.bmad-core/` folder created with all agents
- IDE-specific integration files created
- All agent commands/rules/modes available
@@ -1548,10 +1552,11 @@ Use the **expansion-creator** pack to build your own:
- **Documentation**: Check `docs/` folder for project-specific context
- **Community**: Discord and GitHub resources available for support
- **Contributing**: See `CONTRIBUTING.md` for full guidelines
==================== END: bmad-core/data/bmad-kb.md ====================
==================== END: .bmad-core/data/bmad-kb.md ====================
==================== START: bmad-core/data/elicitation-methods.md ====================
==================== START: .bmad-core/data/elicitation-methods.md ====================
<!-- Powered by BMAD™ Core -->
# Elicitation Methods Data
## Core Reflective Methods
@@ -1706,10 +1711,11 @@ Use the **expansion-creator** pack to build your own:
- Acknowledge choice to finalize current work
- Accept output as-is or move to next step
- Prepare to continue without additional elicitation
==================== END: bmad-core/data/elicitation-methods.md ====================
==================== END: .bmad-core/data/elicitation-methods.md ====================
==================== START: bmad-core/utils/workflow-management.md ====================
==================== START: .bmad-core/utils/workflow-management.md ====================
<!-- Powered by BMAD™ Core -->
# Workflow Management
Enables BMad orchestrator to manage and execute team workflows.
@@ -1779,10 +1785,11 @@ Handle conditional paths by asking clarifying questions when needed.
## Agent Integration
Agents should be workflow-aware: know active workflow, their role, access artifacts, understand expected outputs.
==================== END: bmad-core/utils/workflow-management.md ====================
==================== END: .bmad-core/utils/workflow-management.md ====================
==================== START: bmad-core/tasks/create-deep-research-prompt.md ====================
==================== START: .bmad-core/tasks/create-deep-research-prompt.md ====================
<!-- Powered by BMAD™ Core -->
# Create Deep Research Prompt Task
This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation.
@@ -2061,10 +2068,11 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
- Balance comprehensiveness with focus
- Document assumptions and limitations clearly
- Plan for iterative refinement based on initial findings
==================== END: bmad-core/tasks/create-deep-research-prompt.md ====================
==================== END: .bmad-core/tasks/create-deep-research-prompt.md ====================
==================== START: bmad-core/tasks/document-project.md ====================
==================== START: .bmad-core/tasks/document-project.md ====================
<!-- Powered by BMAD™ Core -->
# Document an Existing Project
## Purpose
@@ -2408,13 +2416,14 @@ Apply the advanced elicitation task after major sections to refine based on user
- Documents technical debt, workarounds, and constraints honestly
- For brownfield projects with PRD: Provides clear enhancement impact analysis
- The goal is PRACTICAL documentation for AI agents doing real work
==================== END: bmad-core/tasks/document-project.md ====================
==================== END: .bmad-core/tasks/document-project.md ====================
==================== START: .bmad-core/tasks/facilitate-brainstorming-session.md ====================
## <!-- Powered by BMAD™ Core -->
==================== START: bmad-core/tasks/facilitate-brainstorming-session.md ====================
<!-- Powered by BMAD™ Core -->
---
docOutputLocation: docs/brainstorming-session-results.md
template: 'bmad-core/templates/brainstorming-output-tmpl.yaml'
template: '.bmad-core/templates/brainstorming-output-tmpl.yaml'
---
# Facilitate Brainstorming Session Task
@@ -2548,9 +2557,9 @@ Generate structured document with these sections:
- Always ask before switching techniques: "Ready to try a different approach?"
- Offer options: "Should we explore this idea deeper or generate more alternatives?"
- Respect their process and timing
==================== END: bmad-core/tasks/facilitate-brainstorming-session.md ====================
==================== END: .bmad-core/tasks/facilitate-brainstorming-session.md ====================
==================== START: bmad-core/templates/brainstorming-output-tmpl.yaml ====================
==================== START: .bmad-core/templates/brainstorming-output-tmpl.yaml ====================
template:
id: brainstorming-output-template-v2
name: Brainstorming Session Results
@@ -2707,9 +2716,9 @@ sections:
---
*Session facilitated using the BMAD-METHOD™ brainstorming framework*
==================== END: bmad-core/templates/brainstorming-output-tmpl.yaml ====================
==================== END: .bmad-core/templates/brainstorming-output-tmpl.yaml ====================
==================== START: bmad-core/templates/competitor-analysis-tmpl.yaml ====================
==================== START: .bmad-core/templates/competitor-analysis-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: competitor-analysis-template-v2
@@ -3017,9 +3026,9 @@ sections:
- Weekly: {{weekly_items}}
- Monthly: {{monthly_items}}
- Quarterly: {{quarterly_analysis}}
==================== END: bmad-core/templates/competitor-analysis-tmpl.yaml ====================
==================== END: .bmad-core/templates/competitor-analysis-tmpl.yaml ====================
==================== START: bmad-core/templates/market-research-tmpl.yaml ====================
==================== START: .bmad-core/templates/market-research-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: market-research-template-v2
@@ -3273,9 +3282,9 @@ sections:
- id: additional-analysis
title: C. Additional Analysis
instruction: Any supplementary analysis not included in main body
==================== END: bmad-core/templates/market-research-tmpl.yaml ====================
==================== END: .bmad-core/templates/market-research-tmpl.yaml ====================
==================== START: bmad-core/templates/project-brief-tmpl.yaml ====================
==================== START: .bmad-core/templates/project-brief-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: project-brief-template-v2
@@ -3498,10 +3507,11 @@ sections:
title: PM Handoff
content: |
This Project Brief provides the full context for {{project_name}}. Please start in 'PRD Generation Mode', review the brief thoroughly to work with the user to create the PRD section by section as the template indicates, asking for any necessary clarification or suggesting improvements.
==================== END: bmad-core/templates/project-brief-tmpl.yaml ====================
==================== END: .bmad-core/templates/project-brief-tmpl.yaml ====================
==================== START: bmad-core/data/brainstorming-techniques.md ====================
==================== START: .bmad-core/data/brainstorming-techniques.md ====================
<!-- Powered by BMAD™ Core -->
# Brainstorming Techniques Data
## Creative Expansion
@@ -3538,10 +3548,11 @@ sections:
18. **Resource Constraints**: "What if you had only $10 and 1 hour?"
19. **Metaphor Mapping**: Use extended metaphors to explore solutions
20. **Question Storming**: Generate questions instead of answers first
==================== END: bmad-core/data/brainstorming-techniques.md ====================
==================== END: .bmad-core/data/brainstorming-techniques.md ====================
==================== START: bmad-core/tasks/brownfield-create-epic.md ====================
==================== START: .bmad-core/tasks/brownfield-create-epic.md ====================
<!-- Powered by BMAD™ Core -->
# Create Brownfield Epic Task
## Purpose
@@ -3702,10 +3713,11 @@ The epic creation is successful when:
- If the scope grows beyond 3 stories, consider the full brownfield PRD process
- Always prioritize existing system integrity over new functionality
- When in doubt about scope or complexity, escalate to full brownfield planning
==================== END: bmad-core/tasks/brownfield-create-epic.md ====================
==================== END: .bmad-core/tasks/brownfield-create-epic.md ====================
==================== START: bmad-core/tasks/brownfield-create-story.md ====================
==================== START: .bmad-core/tasks/brownfield-create-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Brownfield Story Task
## Purpose
@@ -3853,15 +3865,16 @@ The story creation is successful when:
- Always prioritize existing system integrity
- When in doubt about integration complexity, use brownfield-create-epic instead
- Stories should take no more than 4 hours of focused development work
==================== END: bmad-core/tasks/brownfield-create-story.md ====================
==================== END: .bmad-core/tasks/brownfield-create-story.md ====================
==================== START: bmad-core/tasks/correct-course.md ====================
==================== START: .bmad-core/tasks/correct-course.md ====================
<!-- Powered by BMAD™ Core -->
# Correct Course Task
## Purpose
- Guide a structured response to a change trigger using the `bmad-core/checklists/change-checklist`.
- Guide a structured response to a change trigger using the `.bmad-core/checklists/change-checklist`.
- Analyze the impacts of the change on epics, project artifacts, and the MVP, guided by the checklist's structure.
- Explore potential solutions (e.g., adjust scope, rollback elements, re-scope features) as prompted by the checklist.
- Draft specific, actionable proposed updates to any affected project artifacts (e.g., epics, user stories, PRD sections, architecture document sections) based on the analysis.
@@ -3875,7 +3888,7 @@ The story creation is successful when:
- **Acknowledge Task & Inputs:**
- Confirm with the user that the "Correct Course Task" (Change Navigation & Integration) is being initiated.
- Verify the change trigger and ensure you have the user's initial explanation of the issue and its perceived impact.
- Confirm access to all relevant project artifacts (e.g., PRD, Epics/Stories, Architecture Documents, UI/UX Specifications) and, critically, the `bmad-core/checklists/change-checklist`.
- Confirm access to all relevant project artifacts (e.g., PRD, Epics/Stories, Architecture Documents, UI/UX Specifications) and, critically, the `.bmad-core/checklists/change-checklist`.
- **Establish Interaction Mode:**
- Ask the user their preferred interaction mode for this task:
- **"Incrementally (Default & Recommended):** Shall we work through the change-checklist section by section, discussing findings and collaboratively drafting proposed changes for each relevant part before moving to the next? This allows for detailed, step-by-step refinement."
@@ -3927,17 +3940,18 @@ The story creation is successful when:
- A summary of the change-checklist analysis (issue, impact, rationale for the chosen path).
- Specific, clearly drafted proposed edits for all affected project artifacts.
- **Implicit:** An annotated change-checklist (or the record of its completion) reflecting the discussions, findings, and decisions made during the process.
==================== END: bmad-core/tasks/correct-course.md ====================
==================== END: .bmad-core/tasks/correct-course.md ====================
==================== START: bmad-core/tasks/execute-checklist.md ====================
==================== START: .bmad-core/tasks/execute-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Checklist Validation Task
This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
## Available Checklists
If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the bmad-core/checklists folder to select the appropriate one to run.
If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the .bmad-core/checklists folder to select the appropriate one to run.
## Instructions
@@ -3945,7 +3959,7 @@ If the user asks or does not specify a specific checklist, list the checklists a
- If user or the task being run provides a checklist name:
- Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
- If multiple matches found, ask user to clarify
- Load the appropriate checklist from bmad-core/checklists/
- Load the appropriate checklist from .bmad-core/checklists/
- If no checklist specified:
- Ask the user which checklist they want to use
- Present the available options from the files in the checklists folder
@@ -4017,10 +4031,11 @@ The LLM will:
- Execute the complete checklist validation
- Present a final report with pass/fail rates and key findings
- Offer to provide detailed analysis of any section, especially those with warnings or failures
==================== END: bmad-core/tasks/execute-checklist.md ====================
==================== END: .bmad-core/tasks/execute-checklist.md ====================
==================== START: bmad-core/tasks/shard-doc.md ====================
==================== START: .bmad-core/tasks/shard-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Document Sharding Task
## Purpose
@@ -4031,20 +4046,20 @@ The LLM will:
## Primary Method: Automatic with markdown-tree
[[LLM: First, check if markdownExploder is set to true in bmad-core/core-config.yaml. If it is, attempt to run the command: `md-tree explode {input file} {output path}`.
[[LLM: First, check if markdownExploder is set to true in .bmad-core/core-config.yaml. If it is, attempt to run the command: `md-tree explode {input file} {output path}`.
If the command succeeds, inform the user that the document has been sharded successfully and STOP - do not proceed further.
If the command fails (especially with an error indicating the command is not found or not available), inform the user: "The markdownExploder setting is enabled but the md-tree command is not available. Please either:
1. Install @kayvan/markdown-tree-parser globally with: `npm install -g @kayvan/markdown-tree-parser`
2. Or set markdownExploder to false in bmad-core/core-config.yaml
2. Or set markdownExploder to false in .bmad-core/core-config.yaml
**IMPORTANT: STOP HERE - do not proceed with manual sharding until one of the above actions is taken.**"
If markdownExploder is set to false, inform the user: "The markdownExploder setting is currently false. For better performance and reliability, you should:
1. Set markdownExploder to true in bmad-core/core-config.yaml
1. Set markdownExploder to true in .bmad-core/core-config.yaml
2. Install @kayvan/markdown-tree-parser globally with: `npm install -g @kayvan/markdown-tree-parser`
I will now proceed with the manual sharding process."
@@ -4206,9 +4221,9 @@ Document sharded successfully:
- Preserve ALL formatting, including whitespace where significant
- Handle edge cases like sections with code blocks containing ## symbols
- Ensure the sharding is reversible (could reconstruct the original from shards)
==================== END: bmad-core/tasks/shard-doc.md ====================
==================== END: .bmad-core/tasks/shard-doc.md ====================
==================== START: bmad-core/templates/brownfield-prd-tmpl.yaml ====================
==================== START: .bmad-core/templates/brownfield-prd-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: brownfield-prd-template-v2
@@ -4490,9 +4505,9 @@ sections:
- template: "IV1: {{existing_functionality_verification}}"
- template: "IV2: {{integration_point_verification}}"
- template: "IV3: {{performance_impact_verification}}"
==================== END: bmad-core/templates/brownfield-prd-tmpl.yaml ====================
==================== END: .bmad-core/templates/brownfield-prd-tmpl.yaml ====================
==================== START: bmad-core/templates/prd-tmpl.yaml ====================
==================== START: .bmad-core/templates/prd-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: prd-template-v2
@@ -4595,7 +4610,7 @@ sections:
instruction: |
Gather technical decisions that will guide the Architect. Steps:
1. Check if bmad-core/data/technical-preferences.yaml or an attached technical-preferences file exists - use it to pre-populate choices
1. Check if .bmad-core/data/technical-preferences.yaml or an attached technical-preferences file exists - use it to pre-populate choices
2. Ask user about: languages, frameworks, starter templates, libraries, APIs, deployment targets
3. For unknowns, offer guidance based on project goals and MVP scope
4. Document ALL technical choices with rationale (why this choice fits the project)
@@ -4696,10 +4711,11 @@ sections:
- id: architect-prompt
title: Architect Prompt
instruction: This section will contain the prompt for the Architect, keep it short and to the point to initiate create architecture mode using this document as input.
==================== END: bmad-core/templates/prd-tmpl.yaml ====================
==================== END: .bmad-core/templates/prd-tmpl.yaml ====================
==================== START: bmad-core/checklists/change-checklist.md ====================
==================== START: .bmad-core/checklists/change-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Change Navigation Checklist
**Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMad workflow.
@@ -4882,10 +4898,11 @@ Keep it action-oriented and forward-looking.]]
- [ ] **Confirm Next Steps:** Reiterate the handoff plan and the next actions to be taken by specific agents.
---
==================== END: bmad-core/checklists/change-checklist.md ====================
==================== END: .bmad-core/checklists/change-checklist.md ====================
==================== START: bmad-core/checklists/pm-checklist.md ====================
==================== START: .bmad-core/checklists/pm-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Product Manager (PM) Requirements Checklist
This checklist serves as a comprehensive framework to ensure the Product Requirements Document (PRD) and Epic definitions are complete, well-structured, and appropriately scoped for MVP development. The PM should systematically work through each item during the product definition process.
@@ -5256,16 +5273,17 @@ After presenting the report, ask if the user wants:
- **READY FOR ARCHITECT**: The PRD and epics are comprehensive, properly structured, and ready for architectural design.
- **NEEDS REFINEMENT**: The requirements documentation requires additional work to address the identified deficiencies.
==================== END: bmad-core/checklists/pm-checklist.md ====================
==================== END: .bmad-core/checklists/pm-checklist.md ====================
==================== START: bmad-core/data/technical-preferences.md ====================
==================== START: .bmad-core/data/technical-preferences.md ====================
<!-- Powered by BMAD™ Core -->
# User-Defined Preferred Patterns and Preferences
None Listed
==================== END: bmad-core/data/technical-preferences.md ====================
==================== END: .bmad-core/data/technical-preferences.md ====================
==================== START: bmad-core/templates/architecture-tmpl.yaml ====================
==================== START: .bmad-core/templates/architecture-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: architecture-template-v2
@@ -5396,7 +5414,7 @@ sections:
instruction: |
This is the DEFINITIVE technology selection section. Work with the user to make specific choices:
1. Review PRD technical assumptions and any preferences from bmad-core/data/technical-preferences.yaml or an attached technical-preferences
1. Review PRD technical assumptions and any preferences from .bmad-core/data/technical-preferences.yaml or an attached technical-preferences
2. For each category, present 2-3 viable options with pros/cons
3. Make a clear recommendation based on project needs
4. Get explicit user approval for each selection
@@ -5917,9 +5935,9 @@ sections:
- Key UI requirements from PRD
- Any frontend-specific decisions made here
- Request for detailed frontend architecture
==================== END: bmad-core/templates/architecture-tmpl.yaml ====================
==================== END: .bmad-core/templates/architecture-tmpl.yaml ====================
==================== START: bmad-core/templates/brownfield-architecture-tmpl.yaml ====================
==================== START: .bmad-core/templates/brownfield-architecture-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: brownfield-architecture-template-v2
@@ -6397,9 +6415,9 @@ sections:
- Key technical decisions based on real project constraints
- Existing system compatibility requirements with specific verification steps
- Clear sequencing of implementation to minimize risk to existing functionality
==================== END: bmad-core/templates/brownfield-architecture-tmpl.yaml ====================
==================== END: .bmad-core/templates/brownfield-architecture-tmpl.yaml ====================
==================== START: bmad-core/templates/front-end-architecture-tmpl.yaml ====================
==================== START: .bmad-core/templates/front-end-architecture-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: frontend-architecture-template-v2
@@ -6619,9 +6637,9 @@ sections:
- Key import patterns
- File naming conventions
- Project-specific patterns and utilities
==================== END: bmad-core/templates/front-end-architecture-tmpl.yaml ====================
==================== END: .bmad-core/templates/front-end-architecture-tmpl.yaml ====================
==================== START: bmad-core/templates/fullstack-architecture-tmpl.yaml ====================
==================== START: .bmad-core/templates/fullstack-architecture-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: fullstack-architecture-template-v2
@@ -7446,10 +7464,11 @@ sections:
- id: checklist-results
title: Checklist Results Report
instruction: Before running the checklist, offer to output the full architecture document. Once user confirms, execute the architect-checklist and populate results here.
==================== END: bmad-core/templates/fullstack-architecture-tmpl.yaml ====================
==================== END: .bmad-core/templates/fullstack-architecture-tmpl.yaml ====================
==================== START: bmad-core/checklists/architect-checklist.md ====================
==================== START: .bmad-core/checklists/architect-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Architect Solution Validation Checklist
This checklist serves as a comprehensive framework for the Architect to validate the technical design and architecture before development execution. The Architect should systematically work through each item, ensuring the architecture is robust, scalable, secure, and aligned with the product requirements.
@@ -7888,10 +7907,11 @@ Now that you've completed the checklist, generate a comprehensive validation rep
- Component design clarity
After presenting the report, ask the user if they would like detailed analysis of any specific section, especially those with warnings or failures.]]
==================== END: bmad-core/checklists/architect-checklist.md ====================
==================== END: .bmad-core/checklists/architect-checklist.md ====================
==================== START: bmad-core/tasks/validate-next-story.md ====================
==================== START: .bmad-core/tasks/validate-next-story.md ====================
<!-- Powered by BMAD™ Core -->
# Validate Next Story Task
## Purpose
@@ -7902,7 +7922,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
### 0. Load Core Configuration and Inputs
- Load `bmad-core/core-config.yaml`
- Load `.bmad-core/core-config.yaml`
- If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story validation."
- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`
- Identify and load the following inputs:
@@ -8026,9 +8046,9 @@ Provide a structured validation report including:
- **NO-GO**: Story requires fixes before implementation
- **Implementation Readiness Score**: 1-10 scale
- **Confidence Level**: High/Medium/Low for successful implementation
==================== END: bmad-core/tasks/validate-next-story.md ====================
==================== END: .bmad-core/tasks/validate-next-story.md ====================
==================== START: bmad-core/templates/story-tmpl.yaml ====================
==================== START: .bmad-core/templates/story-tmpl.yaml ====================
# <!-- Powered by BMAD™ Core -->
template:
id: story-template-v2
@@ -8167,10 +8187,11 @@ sections:
instruction: Results from QA Agent QA review of the completed story implementation
owner: qa-agent
editors: [qa-agent]
==================== END: bmad-core/templates/story-tmpl.yaml ====================
==================== END: .bmad-core/templates/story-tmpl.yaml ====================
==================== START: bmad-core/checklists/po-master-checklist.md ====================
==================== START: .bmad-core/checklists/po-master-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Product Owner (PO) Master Validation Checklist
This checklist serves as a comprehensive framework for the Product Owner to validate project plans before development execution. It adapts intelligently based on project type (greenfield vs brownfield) and includes UI/UX considerations when applicable.
@@ -8603,9 +8624,9 @@ After presenting the report, ask if the user wants:
- **APPROVED**: The plan is comprehensive, properly sequenced, and ready for implementation.
- **CONDITIONAL**: The plan requires specific adjustments before proceeding.
- **REJECTED**: The plan requires significant revision to address critical deficiencies.
==================== END: bmad-core/checklists/po-master-checklist.md ====================
==================== END: .bmad-core/checklists/po-master-checklist.md ====================
==================== START: bmad-core/workflows/greenfield-service.yaml ====================
==================== START: .bmad-core/workflows/greenfield-service.yaml ====================
# <!-- Powered by BMAD™ Core -->
workflow:
id: greenfield-service
@@ -8745,7 +8766,7 @@ workflow:
All stories implemented and reviewed!
Service development phase complete.
Reference: bmad-core/data/bmad-kb.md#IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid
@@ -8813,9 +8834,9 @@ workflow:
updated_to_po: "All documents ready in docs/ folder. Please validate all artifacts for consistency."
po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
==================== END: bmad-core/workflows/greenfield-service.yaml ====================
==================== END: .bmad-core/workflows/greenfield-service.yaml ====================
==================== START: bmad-core/workflows/brownfield-service.yaml ====================
==================== START: .bmad-core/workflows/brownfield-service.yaml ====================
# <!-- Powered by BMAD™ Core -->
workflow:
id: brownfield-service
@@ -8947,7 +8968,7 @@ workflow:
All stories implemented and reviewed!
Project development phase complete.
Reference: bmad-core/data/bmad-kb.md#IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid
@@ -9004,4 +9025,4 @@ workflow:
architect_to_po: "Architecture complete. Save it as docs/architecture.md. Please validate all artifacts for service integration safety."
po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
==================== END: bmad-core/workflows/brownfield-service.yaml ====================
==================== END: .bmad-core/workflows/brownfield-service.yaml ====================

View File

@@ -12,38 +12,38 @@ If the diagrams below don't render, install Markdown All in One along with the M
### The Planning Workflow (Web UI or Powerful IDE Agents)
Before development begins, BMad follows a structured planning workflow that's ideally done in web UI for cost efficiency. When loading an agent, always initialize the agent before loading anything else. This will ensure the agent loads any dependencies and is ready to assist you in the planning process. Some IDE's and web models will automatically initialize the agent for you, but if not, simply sending an arbitrary message such as a period will initialize the agent.
Before development begins, BMad follows a structured planning workflow that's ideally done in web UI for cost efficiency:
```mermaid
graph TD
A["Start: Project Idea"] --> B{"Optional: Analyst Research"}
B -->|Yes| C["Analyst: Brainstorming (Optional)<br/>*brainstorm {topic}"]
B -->|Yes| C["Analyst: Brainstorming (Optional)"]
B -->|No| G{"Project Brief Available?"}
C --> C2["Analyst: Market Research (Optional)<br/>*perform-market-research"]
C2 --> C3["Analyst: Competitor Analysis (Optional)<br/>*create-competitor-analysis"]
C3 --> D["Analyst: Create Project Brief<br/>*create-project-brief"]
C --> C2["Analyst: Market Research (Optional)"]
C2 --> C3["Analyst: Competitor Analysis (Optional)"]
C3 --> D["Analyst: Create Project Brief"]
D --> G
G -->|Yes| E["PM: Create PRD from Brief (Fast Track)<br/>*create-prd"]
G -->|No| E2["PM: Interactive PRD Creation (More Questions)<br/>*create-prd"]
G -->|Yes| E["PM: Create PRD from Brief (Fast Track)"]
G -->|No| E2["PM: Interactive PRD Creation (More Questions)"]
E --> F["PRD Created with FRs, NFRs, Epics & Stories"]
E2 --> F
F --> F2{"UX Required?"}
F2 -->|Yes| F3["UX Expert: Create Front End Spec<br/>*create-front-end-spec"]
F2 -->|No| H["Architect: Create Architecture from PRD<br/>*create-full-stack-architecture"]
F3 --> F4["UX Expert: Generate UI Prompt for Lovable/V0 (Optional)<br/>*generate-ui-prompt"]
F4 --> H2["Architect: Create Architecture from PRD + UX Spec<br/>*create-full-stack-architecture"]
F2 -->|Yes| F3["UX Expert: Create Front End Spec"]
F2 -->|No| H["Architect: Create Architecture from PRD"]
F3 --> F4["UX Expert: Generate UI Prompt for Lovable/V0 (Optional)"]
F4 --> H2["Architect: Create Architecture from PRD + UX Spec"]
H --> Q{"Early Test Strategy? (Optional)"}
H2 --> Q
Q -->|Yes| R["QA: Early Test Architecture Input on High-Risk Areas<br/>*risk-profile + *test-design"]
Q -->|Yes| R["QA: Early Test Architecture Input on High-Risk Areas"]
Q -->|No| I
R --> I["PO: Run Master Checklist<br/>*execute-checklist-po"]
R --> I["PO: Run Master Checklist"]
I --> J{"Documents Aligned?"}
J -->|Yes| K["Planning Complete"]
J -->|No| L["PO: Update Epics & Stories<br/>*create-epic/*create-story"]
J -->|No| L["PO: Update Epics & Stories"]
L --> M["Update PRD/Architecture as needed"]
M --> I
K --> N["📁 Switch to IDE (If in a Web Agent Platform)"]
N --> O["PO: Shard Documents<br/>*shard-doc {document} {destination}"]
N --> O["PO: Shard Documents"]
O --> P["Ready for SM/Dev Cycle"]
style A fill:#f5f5f5,color:#000
@@ -100,36 +100,35 @@ Once planning is complete and documents are sharded, BMad follows a structured d
```mermaid
graph TD
A["Development Phase Start"] --> B["SM: Reviews Previous Story Dev/QA Notes"]
B --> B2["SM: Drafts Next Story from Sharded Epic + Architecture<br/>*draft"]
B --> B2["SM: Drafts Next Story from Sharded Epic + Architecture"]
B2 --> S{"High-Risk Story? (Optional)"}
S -->|Yes| T["QA: *risk + *design on Draft Story"]
S -->|No| B3
T --> U["Test Strategy & Risk Profile Created"]
U --> B3{"PO: Validate Story Draft (Optional)"}
B3 -->|Validation Requested| B4["PO: Validate Story Against Artifacts<br/>*validate-story-draft {story}"]
B3 -->|Validation Requested| B4["PO: Validate Story Against Artifacts"]
B3 -->|Skip Validation| C{"User Approval"}
B4 --> C
C -->|Approved| D["Dev: Sequential Task Execution"]
C -->|Needs Changes| B2
D --> E["Dev: Implement Tasks + Tests<br/>*develop-story"]
D --> E["Dev: Implement Tasks + Tests"]
E --> V{"Mid-Dev QA Check? (Optional)"}
V -->|Yes| W["QA: Early Validation<br/>*trace or *nfr-assess"]
V -->|Yes| W["QA: *trace or *nfr for Early Validation"]
V -->|No| F
W --> X["Dev: Address Coverage/NFR Gaps<br/>*review-qa"]
X --> F["Dev: Run All Validations<br/>*run-tests"]
W --> X["Dev: Address Coverage/NFR Gaps"]
X --> F["Dev: Run All Validations"]
F --> G["Dev: Mark Ready for Review + Add Notes"]
G --> H{"User Verification"}
H -->|Request QA Review| I["QA: Test Architect Review + Quality Gate"]
H -->|Approve Without QA| M["IMPORTANT: Verify All Regression Tests and Linting are Passing"]
I --> J["QA: Test Architecture Analysis + Active Refactoring<br/>*review {story}"]
I --> J["QA: Test Architecture Analysis + Active Refactoring"]
J --> L{"QA Decision"}
L -->|Needs Dev Work| D2["Dev: Apply QA Fixes<br/>*review-qa"]
D2 --> M
L -->|Needs Dev Work| D
L -->|Approved| M
H -->|Needs Fixes| D
M --> N["IMPORTANT: COMMIT YOUR CHANGES BEFORE PROCEEDING!"]
N --> Y{"Gate Update Needed?"}
Y -->|Yes| Z["QA: Update Gate Status<br/>*gate {story}"]
Y -->|Yes| Z["QA: *gate to Update Status"]
Y -->|No| K
Z --> K["Mark Story as Done"]
K --> B
@@ -468,7 +467,7 @@ Quick reference for where Test Architect outputs are stored:
## Technical Preferences System
BMad includes a personalization system through the `technical-preferences.md` file located in `bmad-core/data/` - this can help bias the PM and Architect to recommend your preferences for design patterns, technology selection, or anything else you would like to put in here.
BMad includes a personalization system through the `technical-preferences.md` file located in `.bmad-core/data/` - this can help bias the PM and Architect to recommend your preferences for design patterns, technology selection, or anything else you would like to put in here.
### Using with Web Bundles

View File

@@ -132,7 +132,7 @@ npx bmad-method install
**Verify Game Development Installation**:
- `bmad-core/` folder created with all core agents
- `.bmad-core/` folder created with all core agents
- `.bmad-2d-unity-game-dev/` folder with game development agents
- IDE-specific integration files created
- Game development agents available with `/bmad2du` prefix (per config.yaml)

View File

@@ -76,7 +76,7 @@ node tools/install-expansion-pack.js infrastructure
This will:
1. Copy all files to their appropriate locations in `bmad-core/`
1. Copy all files to their appropriate locations in `.bmad-core/`
2. Update any necessary configurations
3. Make the DevOps agent available in teams

1317
package-lock.json generated

File diff suppressed because it is too large Load Diff

View File

@@ -1,7 +1,7 @@
{
"$schema": "https://json.schemastore.org/package.json",
"name": "bmad-method",
"version": "4.39.1",
"version": "4.41.0",
"description": "Breakthrough Method of Agile AI-driven Development",
"keywords": [
"agile",
@@ -69,31 +69,33 @@
]
},
"dependencies": {
"@kayvan/markdown-tree-parser": "^1.5.0",
"bmad-method": "^4.30.3",
"@kayvan/markdown-tree-parser": "^1.6.1",
"chalk": "^4.1.2",
"commander": "^14.0.0",
"fs-extra": "^11.3.0",
"fs-extra": "^11.3.1",
"glob": "^11.0.3",
"ignore": "^7.0.5",
"inquirer": "^8.2.6",
"js-yaml": "^4.1.0",
"ora": "^5.4.1",
"semver": "^7.6.3"
"semver": "^7.7.2"
},
"devDependencies": {
"@eslint/js": "^9.33.0",
"eslint": "^9.33.0",
"@eslint/js": "^9.34.0",
"@semantic-release/changelog": "6.0.3",
"@semantic-release/git": "^10.0.1",
"eslint": "^9.34.0",
"eslint-config-prettier": "^10.1.8",
"eslint-plugin-n": "^17.21.3",
"eslint-plugin-unicorn": "^60.0.0",
"eslint-plugin-yml": "^1.18.0",
"husky": "^9.1.7",
"jest": "^30.0.4",
"lint-staged": "^16.1.1",
"prettier": "^3.5.3",
"jest": "^30.0.5",
"lint-staged": "^16.1.5",
"prettier": "^3.6.2",
"prettier-plugin-packagejson": "^2.5.19",
"yaml-eslint-parser": "^1.2.3",
"semantic-release": "24.2.7",
"yaml-eslint-parser": "^1.3.0",
"yaml-lint": "^1.7.0"
},
"engines": {

View File

@@ -41,22 +41,22 @@ class WebBuilder {
generateWebInstructions(bundleType, packName = null) {
// Generate dynamic web instructions based on bundle type
const rootExample = packName ? `.${packName}` : 'bmad-core';
const rootExample = packName ? `.${packName}` : '.bmad-core';
const examplePath = packName
? `.${packName}/folder/filename.md`
: 'bmad-core/folder/filename.md';
: '.bmad-core/folder/filename.md';
const personasExample = packName
? `.${packName}/personas/analyst.md`
: 'bmad-core/personas/analyst.md';
: '.bmad-core/personas/analyst.md';
const tasksExample = packName
? `.${packName}/tasks/create-story.md`
: 'bmad-core/tasks/create-story.md';
: '.bmad-core/tasks/create-story.md';
const utilitiesExample = packName
? `.${packName}/utils/template-format.md`
: 'bmad-core/utils/template-format.md';
: '.bmad-core/utils/template-format.md';
const tasksReference = packName
? `.${packName}/tasks/create-story.md`
: 'bmad-core/tasks/create-story.md';
: '.bmad-core/tasks/create-story.md';
return `# Web Agent Bundle Instructions

View File

@@ -6,7 +6,7 @@ const ignore = require('ignore');
// These complement .gitignore and are applied regardless of VCS presence.
const DEFAULT_PATTERNS = [
// Project/VCS
'**/bmad-core/**',
'**/.bmad-core/**',
'**/.git/**',
'**/.svn/**',
'**/.hg/**',

View File

@@ -115,11 +115,6 @@ program
path.join(inputDir, 'flattened-codebase.xml'),
);
}
} else {
console.error(
'Could not auto-detect a project root and no arguments were provided. Please specify -i/--input and -o/--output.',
);
process.exit(1);
}
// Ensure output directory exists

View File

@@ -254,9 +254,9 @@ async function promptInstallation() {
currentVersion === newVersion
? `(v${currentVersion} - reinstall)`
: `(v${currentVersion} → v${newVersion})`;
bmadOptionText = `Update ${coreShortTitle} ${versionInfo} bmad-core`;
bmadOptionText = `Update ${coreShortTitle} ${versionInfo} .bmad-core`;
} else {
bmadOptionText = `${coreShortTitle} (v${version}) bmad-core`;
bmadOptionText = `${coreShortTitle} (v${version}) .bmad-core`;
}
choices.push({

View File

@@ -1,7 +1,7 @@
installation-options:
full:
name: Complete BMad Core
description: Copy the entire bmad-core folder with all agents, templates, and tools
description: Copy the entire .bmad-core folder with all agents, templates, and tools
action: copy-folder
source: bmad-core
single-agent:

View File

@@ -148,7 +148,7 @@ class ConfigLoader {
// Add all resolved resources
for (const resource of agentDeps.resources) {
const filePath = `bmad-core/${resource.type}/${resource.id}.md`;
const filePath = `.bmad-core/${resource.type}/${resource.id}.md`;
if (!depPaths.includes(filePath)) {
depPaths.push(filePath);
}
@@ -229,11 +229,11 @@ class ConfigLoader {
const depPaths = [];
// Add team config file
depPaths.push(`bmad-core/agent-teams/${teamId}.yaml`);
depPaths.push(`.bmad-core/agent-teams/${teamId}.yaml`);
// Add all agents
for (const agent of teamDeps.agents) {
const filePath = `bmad-core/agents/${agent.id}.md`;
const filePath = `.bmad-core/agents/${agent.id}.md`;
if (!depPaths.includes(filePath)) {
depPaths.push(filePath);
}
@@ -241,7 +241,7 @@ class ConfigLoader {
// Add all resolved resources
for (const resource of teamDeps.resources) {
const filePath = `bmad-core/${resource.type}/${resource.id}.${resource.type === 'workflows' ? 'yaml' : 'md'}`;
const filePath = `.bmad-core/${resource.type}/${resource.id}.${resource.type === 'workflows' ? 'yaml' : 'md'}`;
if (!depPaths.includes(filePath)) {
depPaths.push(filePath);
}

View File

@@ -272,7 +272,7 @@ class FileManager {
}
async modifyCoreConfig(installDir, config) {
const coreConfigPath = path.join(installDir, 'bmad-core', 'core-config.yaml');
const coreConfigPath = path.join(installDir, '.bmad-core', 'core-config.yaml');
try {
// Read the existing core-config.yaml
@@ -382,7 +382,7 @@ class FileManager {
return false;
}
}
manifestDir = 'bmad-core';
manifestDir = '.bmad-core';
manifestFile = 'install-manifest.yaml';
}

View File

@@ -50,7 +50,7 @@ class BaseIdeSetup {
async getCoreAgentIds(installDir) {
const coreAgents = [];
const corePaths = [
path.join(installDir, 'bmad-core', 'agents'),
path.join(installDir, '.bmad-core', 'agents'),
path.join(installDir, 'bmad-core', 'agents'),
];
@@ -80,7 +80,7 @@ class BaseIdeSetup {
if (!agentPath) {
// Check installation-specific paths
const possiblePaths = [
path.join(installDir, 'bmad-core', 'agents', `${agentId}.md`),
path.join(installDir, '.bmad-core', 'agents', `${agentId}.md`),
path.join(installDir, 'bmad-core', 'agents', `${agentId}.md`),
path.join(installDir, 'common', 'agents', `${agentId}.md`),
];
@@ -134,7 +134,7 @@ class BaseIdeSetup {
const dotExpansions = await resourceLocator.findFiles('.bmad-*', { cwd: installDir });
for (const dotExpansion of dotExpansions) {
if (dotExpansion !== 'bmad-core') {
if (dotExpansion !== '.bmad-core') {
const packPath = path.join(installDir, dotExpansion);
const packName = dotExpansion.slice(1); // remove the dot
expansionPacks.push({
@@ -147,7 +147,7 @@ class BaseIdeSetup {
// Check other dot folders that have config.yaml
const allDotFolders = await resourceLocator.findFiles('.*', { cwd: installDir });
for (const folder of allDotFolders) {
if (!folder.startsWith('.bmad-') && folder !== 'bmad-core') {
if (!folder.startsWith('.bmad-') && folder !== '.bmad-core') {
const packPath = path.join(installDir, folder);
const configPath = path.join(packPath, 'config.yaml');
if (await fileManager.pathExists(configPath)) {

View File

@@ -113,7 +113,7 @@ class IdeSetup extends BaseIdeSetup {
coreSlashPrefix,
coreAgents,
coreTasks,
'bmad-core',
'.bmad-core',
);
// Setup expansion pack commands
@@ -151,7 +151,7 @@ class IdeSetup extends BaseIdeSetup {
coreSlashPrefix,
coreAgents,
coreTasks,
'bmad-core',
'.bmad-core',
);
// Setup expansion pack commands
@@ -445,7 +445,7 @@ class IdeSetup extends BaseIdeSetup {
async findAgentPath(agentId, installDir) {
// Try to find the agent file in various locations
const possiblePaths = [
path.join(installDir, 'bmad-core', 'agents', `${agentId}.md`),
path.join(installDir, '.bmad-core', 'agents', `${agentId}.md`),
path.join(installDir, 'agents', `${agentId}.md`),
];
@@ -469,8 +469,8 @@ class IdeSetup extends BaseIdeSetup {
const glob = require('glob');
const allAgentIds = [];
// Check core agents in bmad-core or root
let agentsDir = path.join(installDir, 'bmad-core', 'agents');
// Check core agents in .bmad-core or root
let agentsDir = path.join(installDir, '.bmad-core', 'agents');
if (!(await fileManager.pathExists(agentsDir))) {
agentsDir = path.join(installDir, 'agents');
}
@@ -495,8 +495,8 @@ class IdeSetup extends BaseIdeSetup {
async getCoreAgentIds(installDir) {
const allAgentIds = [];
// Check core agents in bmad-core or root only
let agentsDir = path.join(installDir, 'bmad-core', 'agents');
// Check core agents in .bmad-core or root only
let agentsDir = path.join(installDir, '.bmad-core', 'agents');
if (!(await fileManager.pathExists(agentsDir))) {
agentsDir = path.join(installDir, 'bmad-core', 'agents');
}
@@ -513,8 +513,8 @@ class IdeSetup extends BaseIdeSetup {
async getCoreTaskIds(installDir) {
const allTaskIds = [];
// Check core tasks in bmad-core or root only
let tasksDir = path.join(installDir, 'bmad-core', 'tasks');
// Check core tasks in .bmad-core or root only
let tasksDir = path.join(installDir, '.bmad-core', 'tasks');
if (!(await fileManager.pathExists(tasksDir))) {
tasksDir = path.join(installDir, 'bmad-core', 'tasks');
}
@@ -538,7 +538,7 @@ class IdeSetup extends BaseIdeSetup {
async getAgentTitle(agentId, installDir) {
// Try to find the agent file in various locations
const possiblePaths = [
path.join(installDir, 'bmad-core', 'agents', `${agentId}.md`),
path.join(installDir, '.bmad-core', 'agents', `${agentId}.md`),
path.join(installDir, 'agents', `${agentId}.md`),
];
@@ -579,8 +579,8 @@ class IdeSetup extends BaseIdeSetup {
const glob = require('glob');
const allTaskIds = [];
// Check core tasks in bmad-core or root
let tasksDir = path.join(installDir, 'bmad-core', 'tasks');
// Check core tasks in .bmad-core or root
let tasksDir = path.join(installDir, '.bmad-core', 'tasks');
if (!(await fileManager.pathExists(tasksDir))) {
tasksDir = path.join(installDir, 'bmad-core', 'tasks');
}
@@ -623,7 +623,7 @@ class IdeSetup extends BaseIdeSetup {
async findTaskPath(taskId, installDir) {
// Try to find the task file in various locations
const possiblePaths = [
path.join(installDir, 'bmad-core', 'tasks', `${taskId}.md`),
path.join(installDir, '.bmad-core', 'tasks', `${taskId}.md`),
path.join(installDir, 'bmad-core', 'tasks', `${taskId}.md`),
path.join(installDir, 'common', 'tasks', `${taskId}.md`),
];
@@ -657,7 +657,7 @@ class IdeSetup extends BaseIdeSetup {
async getCoreSlashPrefix(installDir) {
try {
const coreConfigPath = path.join(installDir, 'bmad-core', 'core-config.yaml');
const coreConfigPath = path.join(installDir, '.bmad-core', 'core-config.yaml');
if (!(await fileManager.pathExists(coreConfigPath))) {
// Try bmad-core directory
const altConfigPath = path.join(installDir, 'bmad-core', 'core-config.yaml');
@@ -686,7 +686,7 @@ class IdeSetup extends BaseIdeSetup {
const dotExpansions = glob.sync('.bmad-*', { cwd: installDir });
for (const dotExpansion of dotExpansions) {
if (dotExpansion !== 'bmad-core') {
if (dotExpansion !== '.bmad-core') {
const packPath = path.join(installDir, dotExpansion);
const packName = dotExpansion.slice(1); // remove the dot
expansionPacks.push({
@@ -1012,7 +1012,7 @@ class IdeSetup extends BaseIdeSetup {
}
mdContent += '\n```\n\n';
mdContent += '## Project Standards\n\n';
mdContent += `- Always maintain consistency with project documentation in bmad-core/\n`;
mdContent += `- Always maintain consistency with project documentation in .bmad-core/\n`;
mdContent += `- Follow the agent's specific guidelines and constraints\n`;
mdContent += `- Update relevant project files when making changes\n`;
const relativePath = path.relative(installDir, agentPath).replaceAll('\\', '/');

View File

@@ -34,8 +34,8 @@ class Installer {
? config.directory
: path.resolve(originalCwd, config.directory);
if (path.basename(installDir) === 'bmad-core') {
// If user points directly to bmad-core, treat its parent as the project root
if (path.basename(installDir) === '.bmad-core') {
// If user points directly to .bmad-core, treat its parent as the project root
installDir = path.dirname(installDir);
}
@@ -173,8 +173,8 @@ class Installer {
return state; // clean install
}
// Check for V4 installation (has bmad-core with manifest)
const bmadCorePath = path.join(installDir, 'bmad-core');
// Check for V4 installation (has .bmad-core with manifest)
const bmadCorePath = path.join(installDir, '.bmad-core');
const manifestPath = path.join(bmadCorePath, 'install-manifest.yaml');
if (await fileManager.pathExists(manifestPath)) {
@@ -193,7 +193,7 @@ class Installer {
return state;
}
// Check for bmad-core without manifest (broken V4 or manual copy)
// Check for .bmad-core without manifest (broken V4 or manual copy)
if (await fileManager.pathExists(bmadCorePath)) {
state.type = 'unknown_existing';
state.hasBmadCore = true;
@@ -227,19 +227,23 @@ class Installer {
switch (config.installType) {
case 'full': {
// Full installation - copy entire bmad-core folder as a subdirectory
spinner.text = 'Copying complete bmad-core folder...';
// Full installation - copy entire .bmad-core folder as a subdirectory
spinner.text = 'Copying complete .bmad-core folder...';
const sourceDir = resourceLocator.getBmadCorePath();
const bmadCoreDestDir = path.join(installDir, 'bmad-core');
await fileManager.copyDirectoryWithRootReplacement(sourceDir, bmadCoreDestDir, 'bmad-core');
const bmadCoreDestDir = path.join(installDir, '.bmad-core');
await fileManager.copyDirectoryWithRootReplacement(
sourceDir,
bmadCoreDestDir,
'.bmad-core',
);
// Copy common/ items to bmad-core
// Copy common/ items to .bmad-core
spinner.text = 'Copying common utilities...';
await this.copyCommonItems(installDir, 'bmad-core', spinner);
await this.copyCommonItems(installDir, '.bmad-core', spinner);
// Copy documentation files from docs/ to bmad-core
// Copy documentation files from docs/ to .bmad-core
spinner.text = 'Copying documentation files...';
await this.copyDocsItems(installDir, 'bmad-core', spinner);
await this.copyDocsItems(installDir, '.bmad-core', spinner);
// Get list of all files for manifest
const foundFiles = await resourceLocator.findFiles('**/*', {
@@ -247,7 +251,7 @@ class Installer {
nodir: true,
ignore: ['**/.git/**', '**/node_modules/**'],
});
files = foundFiles.map((file) => path.join('bmad-core', file));
files = foundFiles.map((file) => path.join('.bmad-core', file));
break;
}
@@ -259,12 +263,16 @@ class Installer {
const agentPath = configLoader.getAgentPath(config.agent);
const destinationAgentPath = path.join(
installDir,
'bmad-core',
'.bmad-core',
'agents',
`${config.agent}.md`,
);
await fileManager.copyFileWithRootReplacement(agentPath, destinationAgentPath, 'bmad-core');
files.push(`bmad-core/agents/${config.agent}.md`);
await fileManager.copyFileWithRootReplacement(
agentPath,
destinationAgentPath,
'.bmad-core',
);
files.push(`.bmad-core/agents/${config.agent}.md`);
// Copy dependencies
const { all: dependencies } = await resourceLocator.getAgentDependencies(config.agent);
@@ -276,15 +284,15 @@ class Installer {
if (dep.includes('*')) {
// Handle glob patterns with {root} replacement
const copiedFiles = await fileManager.copyGlobPattern(
dep.replace('bmad-core/', ''),
dep.replace('.bmad-core/', ''),
sourceBase,
path.join(installDir, 'bmad-core'),
'bmad-core',
path.join(installDir, '.bmad-core'),
'.bmad-core',
);
files.push(...copiedFiles.map((f) => `bmad-core/${f}`));
files.push(...copiedFiles.map((f) => `.bmad-core/${f}`));
} else {
// Handle single files with {root} replacement if needed
const sourcePath = path.join(sourceBase, dep.replace('bmad-core/', ''));
const sourcePath = path.join(sourceBase, dep.replace('.bmad-core/', ''));
const destinationPath = path.join(installDir, dep);
const needsRootReplacement =
@@ -292,7 +300,7 @@ class Installer {
let success = false;
success = await (needsRootReplacement
? fileManager.copyFileWithRootReplacement(sourcePath, destinationPath, 'bmad-core')
? fileManager.copyFileWithRootReplacement(sourcePath, destinationPath, '.bmad-core')
: fileManager.copyFile(sourcePath, destinationPath));
if (success) {
@@ -301,14 +309,14 @@ class Installer {
}
}
// Copy common/ items to bmad-core
// Copy common/ items to .bmad-core
spinner.text = 'Copying common utilities...';
const commonFiles = await this.copyCommonItems(installDir, 'bmad-core', spinner);
const commonFiles = await this.copyCommonItems(installDir, '.bmad-core', spinner);
files.push(...commonFiles);
// Copy documentation files from docs/ to bmad-core
// Copy documentation files from docs/ to .bmad-core
spinner.text = 'Copying documentation files...';
const documentFiles = await this.copyDocsItems(installDir, 'bmad-core', spinner);
const documentFiles = await this.copyDocsItems(installDir, '.bmad-core', spinner);
files.push(...documentFiles);
break;
@@ -328,15 +336,15 @@ class Installer {
if (dep.includes('*')) {
// Handle glob patterns with {root} replacement
const copiedFiles = await fileManager.copyGlobPattern(
dep.replace('bmad-core/', ''),
dep.replace('.bmad-core/', ''),
sourceBase,
path.join(installDir, 'bmad-core'),
'bmad-core',
path.join(installDir, '.bmad-core'),
'.bmad-core',
);
files.push(...copiedFiles.map((f) => `bmad-core/${f}`));
files.push(...copiedFiles.map((f) => `.bmad-core/${f}`));
} else {
// Handle single files with {root} replacement if needed
const sourcePath = path.join(sourceBase, dep.replace('bmad-core/', ''));
const sourcePath = path.join(sourceBase, dep.replace('.bmad-core/', ''));
const destinationPath = path.join(installDir, dep);
const needsRootReplacement =
@@ -344,7 +352,7 @@ class Installer {
let success = false;
success = await (needsRootReplacement
? fileManager.copyFileWithRootReplacement(sourcePath, destinationPath, 'bmad-core')
? fileManager.copyFileWithRootReplacement(sourcePath, destinationPath, '.bmad-core')
: fileManager.copyFile(sourcePath, destinationPath));
if (success) {
@@ -353,20 +361,20 @@ class Installer {
}
}
// Copy common/ items to bmad-core
// Copy common/ items to .bmad-core
spinner.text = 'Copying common utilities...';
const commonFiles = await this.copyCommonItems(installDir, 'bmad-core', spinner);
const commonFiles = await this.copyCommonItems(installDir, '.bmad-core', spinner);
files.push(...commonFiles);
// Copy documentation files from docs/ to bmad-core
// Copy documentation files from docs/ to .bmad-core
spinner.text = 'Copying documentation files...';
const documentFiles = await this.copyDocsItems(installDir, 'bmad-core', spinner);
const documentFiles = await this.copyDocsItems(installDir, '.bmad-core', spinner);
files.push(...documentFiles);
break;
}
case 'expansion-only': {
// Expansion-only installation - DO NOT create bmad-core
// Expansion-only installation - DO NOT create .bmad-core
// Only install expansion packs
spinner.text = 'Installing expansion packs only...';
@@ -625,7 +633,7 @@ class Installer {
console.log(` Directory: ${installDir}`);
if (state.hasBmadCore) {
console.log(' Found: bmad-core directory (but no manifest)');
console.log(' Found: .bmad-core directory (but no manifest)');
}
if (state.hasOtherFiles) {
console.log(' Found: Other files in directory');
@@ -763,7 +771,7 @@ class Installer {
// Skip the manifest file itself
if (file.endsWith('install-manifest.yaml')) continue;
const relativePath = file.replace('bmad-core/', '');
const relativePath = file.replace('.bmad-core/', '');
const destinationPath = path.join(installDir, file);
// Check if this is a common/ file that needs special processing
@@ -774,7 +782,7 @@ class Installer {
// This is a common/ file - needs template processing
const fs = require('node:fs').promises;
const content = await fs.readFile(commonSourcePath, 'utf8');
const updatedContent = content.replaceAll('{root}', 'bmad-core');
const updatedContent = content.replaceAll('{root}', '.bmad-core');
await fileManager.ensureDirectory(path.dirname(destinationPath));
await fs.writeFile(destinationPath, updatedContent, 'utf8');
spinner.text = `Restored: ${file}`;
@@ -837,8 +845,8 @@ class Installer {
async performReinstall(config, installDir, spinner) {
spinner.start('Preparing to reinstall BMad Method...');
// Remove existing bmad-core
const bmadCorePath = path.join(installDir, 'bmad-core');
// Remove existing .bmad-core
const bmadCorePath = path.join(installDir, '.bmad-core');
if (await fileManager.pathExists(bmadCorePath)) {
spinner.text = 'Removing existing installation...';
await fileManager.removeDirectory(bmadCorePath);
@@ -874,7 +882,7 @@ class Installer {
// Information about installation components
console.log(chalk.bold('\n🎯 Installation Summary:'));
if (config.installType !== 'expansion-only') {
console.log(chalk.green('✓ bmad-core framework installed with all agents and workflows'));
console.log(chalk.green('✓ .bmad-core framework installed with all agents and workflows'));
}
if (config.expansionPacks && config.expansionPacks.length > 0) {
@@ -933,7 +941,7 @@ class Installer {
// Important notice to read the user guide
console.log(
chalk.red.bold(
'\n📖 IMPORTANT: Please read the user guide at docs/user-guide.md (also installed at bmad-core/user-guide.md)',
'\n📖 IMPORTANT: Please read the user guide at docs/user-guide.md (also installed at .bmad-core/user-guide.md)',
),
);
console.log(
@@ -1779,7 +1787,7 @@ class Installer {
// Find all dot folders that might be expansion packs
const dotFolders = glob.sync('.*', {
cwd: installDir,
ignore: ['.git', '.git/**', 'bmad-core', 'bmad-core/**'],
ignore: ['.git', '.git/**', '.bmad-core', '.bmad-core/**'],
});
for (const folder of dotFolders) {
@@ -1936,22 +1944,22 @@ class Installer {
}
async findInstallation() {
// Look for bmad-core in current directory or parent directories
// Look for .bmad-core in current directory or parent directories
let currentDir = process.cwd();
while (currentDir !== path.dirname(currentDir)) {
const bmadDir = path.join(currentDir, 'bmad-core');
const bmadDir = path.join(currentDir, '.bmad-core');
const manifestPath = path.join(bmadDir, 'install-manifest.yaml');
if (await fileManager.pathExists(manifestPath)) {
return currentDir; // Return parent directory, not bmad-core itself
return currentDir; // Return parent directory, not .bmad-core itself
}
currentDir = path.dirname(currentDir);
}
// Also check if we're inside a bmad-core directory
if (path.basename(process.cwd()) === 'bmad-core') {
// Also check if we're inside a .bmad-core directory
if (path.basename(process.cwd()) === '.bmad-core') {
const manifestPath = path.join(process.cwd(), 'install-manifest.yaml');
if (await fileManager.pathExists(manifestPath)) {
return path.dirname(process.cwd()); // Return parent directory

View File

@@ -251,7 +251,7 @@ class ResourceLocator {
if (Array.isArray(deps)) {
byType[type] = deps;
for (const dep of deps) {
allDeps.push(`bmad-core/${type}/${dep}`);
allDeps.push(`.bmad-core/${type}/${dep}`);
}
}
}

View File

@@ -1,6 +1,6 @@
{
"name": "bmad-method",
"version": "4.39.1",
"version": "4.41.0",
"description": "BMad Method installer - AI-powered Agile development framework",
"keywords": [
"bmad",

View File

@@ -8,13 +8,13 @@ You are now operating as a specialized AI agent from the BMad-Method framework.
### **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
- `==================== START: bmad-core/folder/filename.md ====================`
- `==================== END: bmad-core/folder/filename.md ====================`
- `==================== START: .bmad-core/folder/filename.md ====================`
- `==================== END: .bmad-core/folder/filename.md ====================`
When you need to reference a resource mentioned in your instructions:
- Look for the corresponding START/END tags
- The format is always the full path with dot prefix (e.g., `bmad-core/personas/analyst.md`, `bmad-core/tasks/create-story.md`)
- The format is always the full path with dot prefix (e.g., `.bmad-core/personas/analyst.md`, `.bmad-core/tasks/create-story.md`)
- If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
**Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
@@ -29,8 +29,8 @@ dependencies:
These references map directly to bundle sections:
- `dependencies.utils: template-format` → Look for `==================== START: bmad-core/utils/template-format.md ====================`
- `dependencies.utils: create-story` → Look for `==================== START: bmad-core/tasks/create-story.md ====================`
- `dependencies.utils: template-format` → Look for `==================== START: .bmad-core/utils/template-format.md ====================`
- `dependencies.utils: create-story` → Look for `==================== START: .bmad-core/tasks/create-story.md ====================`
### **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance. You have no file system to write to, so you will maintain document history being drafted in your memory unless a canvas feature is available and the user confirms its usage.

View File

@@ -29,7 +29,7 @@ class V3ToV4Upgrader {
console.log('This tool will help you upgrade your BMad-Method V3 project to V4.\n');
console.log(chalk.cyan('What this tool does:'));
console.log('- Creates a backup of your V3 files (.bmad-v3-backup/)');
console.log('- Installs the new V4 bmad-core structure');
console.log('- Installs the new V4 .bmad-core structure');
console.log('- Preserves your PRD, Architecture, and Stories in the new format\n');
console.log(chalk.yellow('What this tool does NOT do:'));
console.log('- Modify your document content (use doc-migration-task after upgrade)');
@@ -336,12 +336,12 @@ class V3ToV4Upgrader {
try {
// Get the source bmad-core directory (without dot prefix)
const sourcePath = path.join(__dirname, '..', '..', 'bmad-core');
const destinationPath = path.join(projectPath, 'bmad-core');
const destinationPath = path.join(projectPath, '.bmad-core');
// Copy bmad-core
// Copy .bmad-core
await this.copyDirectory(sourcePath, destinationPath);
spinner.text = '✓ Copied fresh bmad-core/ directory from V4';
console.log(chalk.green('\n✓ Copied fresh bmad-core/ directory from V4'));
spinner.text = '✓ Copied fresh .bmad-core/ directory from V4';
console.log(chalk.green('\n✓ Copied fresh .bmad-core/ directory from V4'));
// Create docs directory
const docsPath = path.join(projectPath, 'docs');
@@ -516,7 +516,7 @@ class V3ToV4Upgrader {
console.log(chalk.bold.green('\n✓ Upgrade Complete!\n'));
console.log(chalk.bold('Summary:'));
console.log(`- V3 files backed up to: .bmad-v3-backup/`);
console.log(`- V4 structure installed: bmad-core/ (fresh from V4)`);
console.log(`- V4 structure installed: .bmad-core/ (fresh from V4)`);
const totalDocs =
(analysis.prdFile ? 1 : 0) +
@@ -648,16 +648,16 @@ class V3ToV4Upgrader {
const fileManager = require('../installer/lib/file-manager');
const { glob } = require('glob');
// Get all files in bmad-core for the manifest
const bmadCorePath = path.join(projectPath, 'bmad-core');
// Get all files in .bmad-core for the manifest
const bmadCorePath = path.join(projectPath, '.bmad-core');
const files = await glob('**/*', {
cwd: bmadCorePath,
nodir: true,
ignore: ['**/.git/**', '**/node_modules/**'],
});
// Prepend bmad-core/ to file paths for manifest
const manifestFiles = files.map((file) => path.join('bmad-core', file));
// Prepend .bmad-core/ to file paths for manifest
const manifestFiles = files.map((file) => path.join('.bmad-core', file));
const config = {
installType: 'full',