Compare commits

..

7 Commits

Author SHA1 Message Date
Brian Madison
3b6a507ab8 require issue tempalte 2025-10-09 18:51:59 -05:00
Brian Madison
415026b0eb v4 readme updated with v6 info 2025-10-04 08:36:13 -05:00
Yoav Gal
91c8e12777 qwen cli - custom commands (#551)
* qwen cli - custom commands

* moved prompt to the inside of the command

---------

Co-authored-by: Davor Racic <davor.racic@gmail.com>
Co-authored-by: Brian <bmadcode@gmail.com>
2025-10-01 16:33:17 -05:00
Brian Madison
458704f82b workflow manual release update 2025-09-29 17:24:46 -05:00
Brian Madison
37e5fd50dd version up 2025-09-29 17:09:18 -05:00
lihangmissu
52f6889089 fix: BMAD Brownfield Document Naming Inconsistency Bug (#627) 2025-09-19 18:08:31 -05:00
Javier Gomez
f09e282d72 feat(opencode): add JSON-only integration and compact AGENTS.md generator (#570)
* feat: add OpenCode integration implementation plan for BMAD-METHOD

* installer(opencode): add OpenCode target metadata in install.config.yaml

* chore(deps): add comment-json for JSONC parsing in OpenCode integration

* feat(installer/opencode): implement setupOpenCode with minimal instructions merge and BMAD-managed agents/commands

* feat(installer): add OpenCode (SST) to IDE selector and CLI --ide help

* fix(opencode): align generated opencode.json(c) with schema (instructions as strings; agent.prompt; command.template; remove unsupported fields)

* feat(installer): enhance OpenCode setup with agent selection and prefix options

* fix: update configuration file references from `bmad-core/core-config.yaml` to `.bmad-core/core-config.yaml` across multiple agent and task files for consistency and clarity.

* refactor: streamline OpenCode configuration prompts and normalize instruction paths for agents and tasks

* feat: add tools property to agent definitions for enhanced functionality. Otherwise opencode consders the subagents as readonly

* feat: add extraction of 'whenToUse'  from agents markdown files for improved agent configuration in opencode

* feat: enhance task purpose extraction from markdown files with improved parsing and cleanup logic

* feat: add collision warnings for non-BMAD-managed agent and command keys during setup

* feat: generate and update AGENTS.md for OpenCode integration with agent and task details

* feat: add compact AGENTS.md generator and JSON-only integration for OpenCode

* chore(docs): remove completed OpenCode integration implementation plans

* feat: enable default prefixes for agent and command keys to avoid collisions

* fix: remove unnecessary line breaks in 'whenToUse' descriptions for QA agents to mathc the rest of the agents definitions and improve programatic parsing of whenToUse prop

* fix: update OpenCode references to remove 'SST' for consistency across documentation and configuration

* fix: update agent mode from 'subagent' to 'all' for consistency in agent definitions

* fix: consolidate 'whenToUse' description format for clarity and consistent parsing
2025-09-11 17:44:41 -05:00
68 changed files with 1147 additions and 732 deletions

5
.github/ISSUE_TEMPLATE/config.yml vendored Normal file
View File

@@ -0,0 +1,5 @@
blank_issues_enabled: false
contact_links:
- name: Discord Community Support
url: https://discord.gg/gk8jAdXWmj
about: Please join our Discord server for general questions and community discussion before opening an issue.

View File

@@ -26,7 +26,7 @@ jobs:
uses: actions/checkout@v4
with:
fetch-depth: 0
token: ${{ secrets.GITHUB_TOKEN }}
token: ${{ secrets.GH_PAT }}
- name: Setup Node.js
uses: actions/setup-node@v4

View File

@@ -0,0 +1,40 @@
# feat(opencode): compact AGENTS.md generator and JSON-only integration
## What
Add JSON-only OpenCode integration and a compact AGENTS.md generator (no large embeds; clickable file links) with idempotent merges for BMAD instructions, agents, and commands.
## Why
Keep OpenCode config schemacompliant and small, avoid key collisions, and provide a readable agents/tasks index without inflating AGENTS.md.
## How
- Ensure `.bmad-core/core-config.yaml` in `instructions`
- Merge only selected packages agents/commands into opencode.json file
- Orchestrators `mode: primary`; all agents enable `write`, `edit`, `bash`
- Descriptions from `whenToUse`/task `Purpose` with sanitization + fallbacks
- Explicit warnings for nonBMAD collisions; AGENTS.md uses a strict 3column table with links
## Testing
- Run: `npx bmad-method install -f -i opencode`
- Verify: `opencode.json[c]` updated/created as expected, `AGENTS.md` OpenCode section is compact with links
- Prepush checks:
```bash
npm run pre-release
# or individually
npm run validate
npm run format:check
npm run lint
# if anything fails
npm run fix
# or
npm run format
npm run lint:fix
```
Fixes #<issue-number>
Targets: `next` branch

View File

@@ -1,5 +1,36 @@
# BMAD-METHOD™: Universal AI Agent Framework
> ## 🚨 **IMPORTANT VERSION ANNOUNCEMENT** 🚨
>
> ### Current Stable: v4.x | Next Major: v6 Alpha
>
> - **v4.x** - The current stable release version available via npm
> - **v5** - Skipped (replaced by v6)
> - **[v6-alpha](https://github.com/bmad-code-org/BMAD-METHOD/tree/v6-alpha)** - **NOW AVAILABLE FOR EARLY TESTING!**
>
> ### 🧪 Try v6 Alpha (Early Adopters Only)
>
> The next major version of BMAD-METHOD is now available for early experimentation and testing. This is a complete rewrite with significant architectural changes.
>
> **⚠️ WARNING: v6-alpha is for early adopters who are comfortable with:**
>
> - Potential breaking changes
> - Daily updates and instability
> - Incomplete features
> - Experimental functionality
>
> **📅 Timeline:** Official beta version will be merged mid-October 2025
>
> **To try v6-alpha:**
>
> ```bash
> git clone https://github.com/bmad-code-org/BMAD-METHOD.git
> cd BMAD-METHOD
> git checkout v6-alpha
> ```
>
> ---
[![Version](https://img.shields.io/npm/v/bmad-method?color=blue&label=version)](https://www.npmjs.com/package/bmad-method)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org)

View File

@@ -19,7 +19,7 @@ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (
activation-instructions:
- STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
- STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
- STEP 3: Load and read `bmad-core/core-config.yaml` (project configuration) before any greeting
- STEP 3: Load and read `.bmad-core/core-config.yaml` (project configuration) before any greeting
- STEP 4: Greet user with your name/role and immediately run `*help` to display available commands
- DO NOT: Load any other agent files during activation
- ONLY load dependency files when user selects them for execution via command or request of a task

View File

@@ -19,7 +19,7 @@ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (
activation-instructions:
- STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
- STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
- STEP 3: Load and read `bmad-core/core-config.yaml` (project configuration) before any greeting
- STEP 3: Load and read `.bmad-core/core-config.yaml` (project configuration) before any greeting
- STEP 4: Greet user with your name/role and immediately run `*help` to display available commands
- DO NOT: Load any other agent files during activation
- ONLY load dependency files when user selects them for execution via command or request of a task

View File

@@ -19,7 +19,7 @@ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (
activation-instructions:
- STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
- STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
- STEP 3: Load and read `bmad-core/core-config.yaml` (project configuration) before any greeting
- STEP 3: Load and read `.bmad-core/core-config.yaml` (project configuration) before any greeting
- STEP 4: Greet user with your name/role and immediately run `*help` to display available commands
- DO NOT: Load any other agent files during activation
- ONLY load dependency files when user selects them for execution via command or request of a task

View File

@@ -19,7 +19,7 @@ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (
activation-instructions:
- STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
- STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
- STEP 3: Load and read `bmad-core/core-config.yaml` (project configuration) before any greeting
- STEP 3: Load and read `.bmad-core/core-config.yaml` (project configuration) before any greeting
- STEP 4: Greet user with your name/role and immediately run `*help` to display available commands
- DO NOT: Load any other agent files during activation
- ONLY load dependency files when user selects them for execution via command or request of a task
@@ -31,7 +31,7 @@ activation-instructions:
- Assess user goal against available agents and workflows in this bundle
- If clear match to an agent's expertise, suggest transformation with *agent command
- If project-oriented, suggest *workflow-guidance to explore options
- Load resources only when needed - never pre-load (Exception: Read `bmad-core/core-config.yaml` during activation)
- Load resources only when needed - never pre-load (Exception: Read `.bmad-core/core-config.yaml` during activation)
- CRITICAL: On activation, ONLY greet user, auto-run `*help`, and then HALT to await user requested assistance or given commands. ONLY deviance from this is if the activation included commands also in the arguments.
agent:
name: BMad Orchestrator

View File

@@ -19,7 +19,7 @@ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (
activation-instructions:
- STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
- STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
- STEP 3: Load and read `bmad-core/core-config.yaml` (project configuration) before any greeting
- STEP 3: Load and read `.bmad-core/core-config.yaml` (project configuration) before any greeting
- STEP 4: Greet user with your name/role and immediately run `*help` to display available commands
- DO NOT: Load any other agent files during activation
- ONLY load dependency files when user selects them for execution via command or request of a task

View File

@@ -19,7 +19,7 @@ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (
activation-instructions:
- STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
- STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
- STEP 3: Load and read `bmad-core/core-config.yaml` (project configuration) before any greeting
- STEP 3: Load and read `.bmad-core/core-config.yaml` (project configuration) before any greeting
- STEP 4: Greet user with your name/role and immediately run `*help` to display available commands
- DO NOT: Load any other agent files during activation
- ONLY load dependency files when user selects them for execution via command or request of a task

View File

@@ -19,7 +19,7 @@ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (
activation-instructions:
- STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
- STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
- STEP 3: Load and read `bmad-core/core-config.yaml` (project configuration) before any greeting
- STEP 3: Load and read `.bmad-core/core-config.yaml` (project configuration) before any greeting
- STEP 4: Greet user with your name/role and immediately run `*help` to display available commands
- DO NOT: Load any other agent files during activation
- ONLY load dependency files when user selects them for execution via command or request of a task

View File

@@ -19,7 +19,7 @@ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (
activation-instructions:
- STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
- STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
- STEP 3: Load and read `bmad-core/core-config.yaml` (project configuration) before any greeting
- STEP 3: Load and read `.bmad-core/core-config.yaml` (project configuration) before any greeting
- STEP 4: Greet user with your name/role and immediately run `*help` to display available commands
- DO NOT: Load any other agent files during activation
- ONLY load dependency files when user selects them for execution via command or request of a task
@@ -35,11 +35,7 @@ agent:
id: qa
title: Test Architect & Quality Advisor
icon: 🧪
whenToUse: |
Use for comprehensive test architecture review, quality gate decisions,
and code improvement. Provides thorough analysis including requirements
traceability, risk assessment, and test strategy.
Advisory only - teams choose their quality bar.
whenToUse: Use for comprehensive test architecture review, quality gate decisions, and code improvement. Provides thorough analysis including requirements traceability, risk assessment, and test strategy. Advisory only - teams choose their quality bar.
customization: null
persona:
role: Test Architect with Quality Advisory Authority

View File

@@ -19,7 +19,7 @@ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (
activation-instructions:
- STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
- STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
- STEP 3: Load and read `bmad-core/core-config.yaml` (project configuration) before any greeting
- STEP 3: Load and read `.bmad-core/core-config.yaml` (project configuration) before any greeting
- STEP 4: Greet user with your name/role and immediately run `*help` to display available commands
- DO NOT: Load any other agent files during activation
- ONLY load dependency files when user selects them for execution via command or request of a task

View File

@@ -19,7 +19,7 @@ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (
activation-instructions:
- STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
- STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
- STEP 3: Load and read `bmad-core/core-config.yaml` (project configuration) before any greeting
- STEP 3: Load and read `.bmad-core/core-config.yaml` (project configuration) before any greeting
- STEP 4: Greet user with your name/role and immediately run `*help` to display available commands
- DO NOT: Load any other agent files during activation
- ONLY load dependency files when user selects them for execution via command or request of a task

View File

@@ -15,7 +15,7 @@ First, determine the project type by checking:
2. Is this a BROWNFIELD project (enhancing existing system)?
- Look for: References to existing codebase, enhancement/modification language
- Check for: brownfield-prd.md, brownfield-architecture.md, existing system analysis
- Check for: prd.md, architecture.md, existing system analysis
3. Does the project include UI/UX components?
- Check for: frontend-architecture.md, UI/UX specifications, design files
@@ -33,8 +33,8 @@ For GREENFIELD projects:
For BROWNFIELD projects:
- brownfield-prd.md - The brownfield enhancement requirements
- brownfield-architecture.md - The enhancement architecture
- prd.md - The brownfield enhancement requirements
- architecture.md - The enhancement architecture
- Existing project codebase access (CRITICAL - cannot proceed without this)
- Current deployment configuration and infrastructure details
- Database schemas, API documentation, monitoring setup

View File

@@ -181,7 +181,7 @@ npx bmad-method install
## Core Configuration (core-config.yaml)
**New in V4**: The `bmad-core/core-config.yaml` file is a critical innovation that enables BMad to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
**New in V4**: The `.bmad-core/core-config.yaml` file is a critical innovation that enables BMad to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
### What is core-config.yaml?

View File

@@ -16,8 +16,8 @@ Implement fixes based on QA results (gate and assessments) for a specific story.
```yaml
required:
- story_id: '{epic}.{story}' # e.g., "2.2"
- qa_root: from `bmad-core/core-config.yaml` key `qa.qaLocation` (e.g., `docs/project/qa`)
- story_root: from `bmad-core/core-config.yaml` key `devStoryLocation` (e.g., `docs/project/stories`)
- qa_root: from `.bmad-core/core-config.yaml` key `qa.qaLocation` (e.g., `docs/project/qa`)
- story_root: from `.bmad-core/core-config.yaml` key `devStoryLocation` (e.g., `docs/project/stories`)
optional:
- story_title: '{title}' # derive from story H1 if missing
@@ -45,7 +45,7 @@ optional:
### 0) Load Core Config & Locate Story
- Read `bmad-core/core-config.yaml` and resolve `qa_root` and `story_root`
- Read `.bmad-core/core-config.yaml` and resolve `qa_root` and `story_root`
- Locate story file in `{story_root}/{epic}.{story}.*.md`
- HALT if missing and ask for correct story id/path
@@ -113,7 +113,7 @@ Status Rule:
## Blocking Conditions
- Missing `bmad-core/core-config.yaml`
- Missing `.bmad-core/core-config.yaml`
- Story file not found for `story_id`
- No QA artifacts found (neither gate nor assessments)
- HALT and request QA to generate at least a gate file (or proceed only with clear developer-provided fix list)

View File

@@ -9,11 +9,11 @@ Quick NFR validation focused on the core four: security, performance, reliabilit
```yaml
required:
- story_id: '{epic}.{story}' # e.g., "1.3"
- story_path: `bmad-core/core-config.yaml` for the `devStoryLocation`
- story_path: `.bmad-core/core-config.yaml` for the `devStoryLocation`
optional:
- architecture_refs: `bmad-core/core-config.yaml` for the `architecture.architectureFile`
- technical_preferences: `bmad-core/core-config.yaml` for the `technicalPreferences`
- architecture_refs: `.bmad-core/core-config.yaml` for the `architecture.architectureFile`
- technical_preferences: `.bmad-core/core-config.yaml` for the `technicalPreferences`
- acceptance_criteria: From story file
```

View File

@@ -16,7 +16,7 @@ Generate a standalone quality gate file that provides a clear pass/fail decision
## Gate File Location
**ALWAYS** check the `bmad-core/core-config.yaml` for the `qa.qaLocation/gates`
**ALWAYS** check the `.bmad-core/core-config.yaml` for the `qa.qaLocation/gates`
Slug rules:
@@ -126,7 +126,7 @@ waiver:
## Output Requirements
1. **ALWAYS** create gate file at: `qa.qaLocation/gates` from `bmad-core/core-config.yaml`
1. **ALWAYS** create gate file at: `qa.qaLocation/gates` from `.bmad-core/core-config.yaml`
2. **ALWAYS** append this exact format to story's QA Results section:
```text

View File

@@ -186,7 +186,7 @@ NFR assessment: qa.qaLocation/assessments/{epic}.{story}-nfr-{YYYYMMDD}.md
**Template and Directory:**
- Render from `../templates/qa-gate-tmpl.yaml`
- Create directory defined in `qa.qaLocation/gates` (see `bmad-core/core-config.yaml`) if missing
- Create directory defined in `qa.qaLocation/gates` (see `.bmad-core/core-config.yaml`) if missing
- Save to: `qa.qaLocation/gates/{epic}.{story}-{slug}.yml`
Gate file structure:

View File

@@ -23,7 +23,7 @@ sections:
1. **Verify Complexity**: Confirm this enhancement requires architectural planning. For simple additions, recommend: "For simpler changes that don't require architectural planning, consider using the brownfield-create-epic or brownfield-create-story task with the Product Owner instead."
2. **REQUIRED INPUTS**:
- Completed brownfield-prd.md
- Completed prd.md
- Existing project technical documentation (from docs folder or user-provided)
- Access to existing project structure (IDE or uploaded files)

View File

@@ -105,7 +105,6 @@ dependencies:
==================== START: .bmad-core/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -227,7 +226,6 @@ Choose a number (0-8) or 9 to proceed:
==================== 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.
@@ -510,7 +508,6 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
==================== START: .bmad-core/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -616,7 +613,6 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-core/tasks/document-project.md ====================
<!-- Powered by BMAD™ Core -->
# Document an Existing Project
## Purpose
@@ -963,11 +959,10 @@ Apply the advanced elicitation task after major sections to refine based on user
==================== END: .bmad-core/tasks/document-project.md ====================
==================== START: .bmad-core/tasks/facilitate-brainstorming-session.md ====================
## <!-- Powered by BMAD™ Core -->
<!-- Powered by BMAD™ Core -->
---
docOutputLocation: docs/brainstorming-session-results.md
template: '.bmad-core/templates/brainstorming-output-tmpl.yaml'
---
# Facilitate Brainstorming Session Task
@@ -2055,7 +2050,6 @@ sections:
==================== START: .bmad-core/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMAD™ Knowledge Base
## Overview
@@ -2158,7 +2152,6 @@ npx bmad-method install
- **Cline**: VS Code extension with AI features
- **Roo Code**: Web-based IDE with agent support
- **GitHub Copilot**: VS Code extension with AI peer programming assistant
- **Auggie CLI (Augment Code)**: AI-powered development environment
**Note for VS Code Users**: BMAD-METHOD™ assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo.
@@ -2237,7 +2230,7 @@ npx bmad-method install
## Core Configuration (core-config.yaml)
**New in V4**: The `bmad-core/core-config.yaml` file is a critical innovation that enables BMad to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
**New in V4**: The `.bmad-core/core-config.yaml` file is a critical innovation that enables BMad to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
### What is core-config.yaml?
@@ -2867,7 +2860,6 @@ Use the **expansion-creator** pack to build your own:
==================== START: .bmad-core/data/brainstorming-techniques.md ====================
<!-- Powered by BMAD™ Core -->
# Brainstorming Techniques Data
## Creative Expansion

View File

@@ -106,7 +106,6 @@ dependencies:
==================== 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.
@@ -389,7 +388,6 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
==================== START: .bmad-core/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -495,7 +493,6 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-core/tasks/document-project.md ====================
<!-- Powered by BMAD™ Core -->
# Document an Existing Project
## Purpose
@@ -843,7 +840,6 @@ Apply the advanced elicitation task after major sections to refine based on user
==================== 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.
@@ -1612,7 +1608,7 @@ sections:
1. **Verify Complexity**: Confirm this enhancement requires architectural planning. For simple additions, recommend: "For simpler changes that don't require architectural planning, consider using the brownfield-create-epic or brownfield-create-story task with the Product Owner instead."
2. **REQUIRED INPUTS**:
- Completed brownfield-prd.md
- Completed prd.md
- Existing project technical documentation (from docs folder or user-provided)
- Access to existing project structure (IDE or uploaded files)
@@ -1698,8 +1694,8 @@ sections:
- **UI/UX Consistency:** {{ui_compatibility}}
- **Performance Impact:** {{performance_constraints}}
- id: tech-stack
title: Tech Stack
- id: tech-stack-alignment
title: Tech Stack Alignment
instruction: |
Ensure new components align with existing technology choices:
@@ -1861,8 +1857,8 @@ sections:
**Error Handling:** {{error_handling_strategy}}
- id: source-tree
title: Source Tree
- id: source-tree-integration
title: Source Tree Integration
instruction: |
Define how new code will integrate with existing project structure:
@@ -1931,7 +1927,7 @@ sections:
**Monitoring:** {{monitoring_approach}}
- id: coding-standards
title: Coding Standards
title: Coding Standards and Conventions
instruction: |
Ensure new code follows existing project conventions:
@@ -3117,7 +3113,6 @@ sections:
==================== 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.
@@ -3560,7 +3555,6 @@ After presenting the report, ask the user if they would like detailed analysis o
==================== START: .bmad-core/data/technical-preferences.md ====================
<!-- Powered by BMAD™ Core -->
# User-Defined Preferred Patterns and Preferences
None Listed

View File

@@ -117,18 +117,17 @@ dependencies:
- project-brief-tmpl.yaml
- story-tmpl.yaml
workflows:
- brownfield-fullstack.yaml
- brownfield-service.yaml
- brownfield-ui.yaml
- greenfield-fullstack.yaml
- greenfield-service.yaml
- greenfield-ui.yaml
- brownfield-fullstack.md
- brownfield-service.md
- brownfield-ui.md
- greenfield-fullstack.md
- greenfield-service.md
- greenfield-ui.md
```
==================== END: .bmad-core/agents/bmad-master.md ====================
==================== START: .bmad-core/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -250,7 +249,6 @@ Choose a number (0-8) or 9 to proceed:
==================== START: .bmad-core/tasks/brownfield-create-epic.md ====================
<!-- Powered by BMAD™ Core -->
# Create Brownfield Epic Task
## Purpose
@@ -415,7 +413,6 @@ The epic creation is successful when:
==================== START: .bmad-core/tasks/brownfield-create-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Brownfield Story Task
## Purpose
@@ -567,7 +564,6 @@ The story creation is successful when:
==================== START: .bmad-core/tasks/correct-course.md ====================
<!-- Powered by BMAD™ Core -->
# Correct Course Task
## Purpose
@@ -642,7 +638,6 @@ The story creation is successful when:
==================== 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.
@@ -925,7 +920,6 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
==================== START: .bmad-core/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -1031,7 +1025,6 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-core/tasks/create-next-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Next Story Task
## Purpose
@@ -1148,7 +1141,6 @@ ALWAYS cite source documents: `[Source: architecture/{filename}.md#{section}]`
==================== START: .bmad-core/tasks/document-project.md ====================
<!-- Powered by BMAD™ Core -->
# Document an Existing Project
## Purpose
@@ -1496,7 +1488,6 @@ Apply the advanced elicitation task after major sections to refine based on user
==================== 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.
@@ -1586,11 +1577,10 @@ The LLM will:
==================== END: .bmad-core/tasks/execute-checklist.md ====================
==================== START: .bmad-core/tasks/facilitate-brainstorming-session.md ====================
## <!-- Powered by BMAD™ Core -->
<!-- Powered by BMAD™ Core -->
---
docOutputLocation: docs/brainstorming-session-results.md
template: '.bmad-core/templates/brainstorming-output-tmpl.yaml'
---
# Facilitate Brainstorming Session Task
@@ -1728,7 +1718,6 @@ Generate structured document with these sections:
==================== START: .bmad-core/tasks/generate-ai-frontend-prompt.md ====================
<!-- Powered by BMAD™ Core -->
# Create AI Frontend Prompt Task
## Purpose
@@ -1784,7 +1773,6 @@ You will now synthesize the inputs and the above principles into a final, compre
==================== START: .bmad-core/tasks/index-docs.md ====================
<!-- Powered by BMAD™ Core -->
# Index Documentation Task
## Purpose
@@ -1962,7 +1950,6 @@ Would you like to proceed with documentation indexing? Please provide the requir
==================== START: .bmad-core/tasks/shard-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Document Sharding Task
## Purpose
@@ -2830,7 +2817,7 @@ sections:
1. **Verify Complexity**: Confirm this enhancement requires architectural planning. For simple additions, recommend: "For simpler changes that don't require architectural planning, consider using the brownfield-create-epic or brownfield-create-story task with the Product Owner instead."
2. **REQUIRED INPUTS**:
- Completed brownfield-prd.md
- Completed prd.md
- Existing project technical documentation (from docs folder or user-provided)
- Access to existing project structure (IDE or uploaded files)
@@ -2916,8 +2903,8 @@ sections:
- **UI/UX Consistency:** {{ui_compatibility}}
- **Performance Impact:** {{performance_constraints}}
- id: tech-stack
title: Tech Stack
- id: tech-stack-alignment
title: Tech Stack Alignment
instruction: |
Ensure new components align with existing technology choices:
@@ -3079,8 +3066,8 @@ sections:
**Error Handling:** {{error_handling_strategy}}
- id: source-tree
title: Source Tree
- id: source-tree-integration
title: Source Tree Integration
instruction: |
Define how new code will integrate with existing project structure:
@@ -3149,7 +3136,7 @@ sections:
**Monitoring:** {{monitoring_approach}}
- id: coding-standards
title: Coding Standards
title: Coding Standards and Conventions
instruction: |
Ensure new code follows existing project conventions:
@@ -6110,7 +6097,6 @@ sections:
==================== 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.
@@ -6553,7 +6539,6 @@ After presenting the report, ask the user if they would like detailed analysis o
==================== 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.
@@ -6740,7 +6725,6 @@ Keep it action-oriented and forward-looking.]]
==================== 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.
@@ -7115,7 +7099,6 @@ After presenting the report, ask if the user wants:
==================== 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.
@@ -7131,7 +7114,7 @@ First, determine the project type by checking:
2. Is this a BROWNFIELD project (enhancing existing system)?
- Look for: References to existing codebase, enhancement/modification language
- Check for: brownfield-prd.md, brownfield-architecture.md, existing system analysis
- Check for: prd.md, architecture.md, existing system analysis
3. Does the project include UI/UX components?
- Check for: frontend-architecture.md, UI/UX specifications, design files
@@ -7149,8 +7132,8 @@ For GREENFIELD projects:
For BROWNFIELD projects:
- brownfield-prd.md - The brownfield enhancement requirements
- brownfield-architecture.md - The enhancement architecture
- prd.md - The brownfield enhancement requirements
- architecture.md - The enhancement architecture
- Existing project codebase access (CRITICAL - cannot proceed without this)
- Current deployment configuration and infrastructure details
- Database schemas, API documentation, monitoring setup
@@ -7552,7 +7535,6 @@ After presenting the report, ask if the user wants:
==================== START: .bmad-core/checklists/story-dod-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Story Definition of Done (DoD) Checklist
## Instructions for Developer Agent
@@ -7651,7 +7633,6 @@ Be honest - it's better to flag issues now than have them discovered later.]]
==================== 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.
@@ -7809,7 +7790,6 @@ Be pragmatic - perfect documentation doesn't exist, but it must be enough to pro
==================== START: .bmad-core/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMAD™ Knowledge Base
## Overview
@@ -7912,7 +7892,6 @@ npx bmad-method install
- **Cline**: VS Code extension with AI features
- **Roo Code**: Web-based IDE with agent support
- **GitHub Copilot**: VS Code extension with AI peer programming assistant
- **Auggie CLI (Augment Code)**: AI-powered development environment
**Note for VS Code Users**: BMAD-METHOD™ assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo.
@@ -7991,7 +7970,7 @@ npx bmad-method install
## Core Configuration (core-config.yaml)
**New in V4**: The `bmad-core/core-config.yaml` file is a critical innovation that enables BMad to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
**New in V4**: The `.bmad-core/core-config.yaml` file is a critical innovation that enables BMad to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
### What is core-config.yaml?
@@ -8621,7 +8600,6 @@ Use the **expansion-creator** pack to build your own:
==================== START: .bmad-core/data/brainstorming-techniques.md ====================
<!-- Powered by BMAD™ Core -->
# Brainstorming Techniques Data
## Creative Expansion
@@ -8662,7 +8640,6 @@ Use the **expansion-creator** pack to build your own:
==================== START: .bmad-core/data/elicitation-methods.md ====================
<!-- Powered by BMAD™ Core -->
# Elicitation Methods Data
## Core Reflective Methods
@@ -8821,7 +8798,6 @@ Use the **expansion-creator** pack to build your own:
==================== START: .bmad-core/data/technical-preferences.md ====================
<!-- Powered by BMAD™ Core -->
# User-Defined Preferred Patterns and Preferences
None Listed

View File

@@ -168,7 +168,6 @@ dependencies:
==================== START: .bmad-core/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -290,7 +289,6 @@ Choose a number (0-8) or 9 to proceed:
==================== START: .bmad-core/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -396,7 +394,6 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-core/tasks/kb-mode-interaction.md ====================
<!-- Powered by BMAD™ Core -->
# KB Mode Interaction Task
## Purpose
@@ -476,7 +473,6 @@ Or ask me about anything else related to BMad-Method!
==================== START: .bmad-core/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMAD™ Knowledge Base
## Overview
@@ -579,7 +575,6 @@ npx bmad-method install
- **Cline**: VS Code extension with AI features
- **Roo Code**: Web-based IDE with agent support
- **GitHub Copilot**: VS Code extension with AI peer programming assistant
- **Auggie CLI (Augment Code)**: AI-powered development environment
**Note for VS Code Users**: BMAD-METHOD™ assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo.
@@ -658,7 +653,7 @@ npx bmad-method install
## Core Configuration (core-config.yaml)
**New in V4**: The `bmad-core/core-config.yaml` file is a critical innovation that enables BMad to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
**New in V4**: The `.bmad-core/core-config.yaml` file is a critical innovation that enables BMad to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
### What is core-config.yaml?
@@ -1288,7 +1283,6 @@ Use the **expansion-creator** pack to build your own:
==================== START: .bmad-core/data/elicitation-methods.md ====================
<!-- Powered by BMAD™ Core -->
# Elicitation Methods Data
## Core Reflective Methods
@@ -1447,7 +1441,6 @@ Use the **expansion-creator** pack to build your own:
==================== START: .bmad-core/utils/workflow-management.md ====================
<!-- Powered by BMAD™ Core -->
# Workflow Management
Enables BMad orchestrator to manage and execute team workflows.

15
dist/agents/dev.txt vendored
View File

@@ -64,7 +64,6 @@ persona:
focus: Executing story tasks with precision, updating Dev Agent Record sections only, maintaining minimal context overhead
core_principles:
- CRITICAL: Story has ALL info you will need aside from what you loaded during the startup commands. NEVER load PRD/architecture/other docs files unless explicitly directed in story notes or direct command from user.
- CRITICAL: ALWAYS check current folder structure before starting your story tasks, don't create new working directory if it already exists. Create new one when you're sure it's a brand new project.
- CRITICAL: ONLY update story file Dev Agent Record sections (checkboxes/Debug Log/Completion Notes/Change Log)
- CRITICAL: FOLLOW THE develop-story command when the user tells you to implement the story
- Numbered Options - Always use numbered lists when presenting choices to the user
@@ -95,7 +94,6 @@ dependencies:
==================== 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.
@@ -112,8 +110,8 @@ Implement fixes based on QA results (gate and assessments) for a specific story.
```yaml
required:
- story_id: '{epic}.{story}' # e.g., "2.2"
- qa_root: from `bmad-core/core-config.yaml` key `qa.qaLocation` (e.g., `docs/project/qa`)
- story_root: from `bmad-core/core-config.yaml` key `devStoryLocation` (e.g., `docs/project/stories`)
- qa_root: from `.bmad-core/core-config.yaml` key `qa.qaLocation` (e.g., `docs/project/qa`)
- story_root: from `.bmad-core/core-config.yaml` key `devStoryLocation` (e.g., `docs/project/stories`)
optional:
- story_title: '{title}' # derive from story H1 if missing
@@ -141,7 +139,7 @@ optional:
### 0) Load Core Config & Locate Story
- Read `bmad-core/core-config.yaml` and resolve `qa_root` and `story_root`
- Read `.bmad-core/core-config.yaml` and resolve `qa_root` and `story_root`
- Locate story file in `{story_root}/{epic}.{story}.*.md`
- HALT if missing and ask for correct story id/path
@@ -209,7 +207,7 @@ Status Rule:
## Blocking Conditions
- Missing `bmad-core/core-config.yaml`
- Missing `.bmad-core/core-config.yaml`
- Story file not found for `story_id`
- No QA artifacts found (neither gate nor assessments)
- HALT and request QA to generate at least a gate file (or proceed only with clear developer-provided fix list)
@@ -248,7 +246,6 @@ Fix plan:
==================== 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.
@@ -339,7 +336,6 @@ The LLM will:
==================== START: .bmad-core/tasks/validate-next-story.md ====================
<!-- Powered by BMAD™ Core -->
# Validate Next Story Task
## Purpose
@@ -361,7 +357,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
### 1. Template Completeness Validation
- Load `.bmad-core/templates/story-tmpl.yaml` and extract all section headings from the template
- Load `bmad-core/templates/story-tmpl.md` and extract all section headings from the template
- **Missing sections check**: Compare story sections against template sections to verify all required sections are present
- **Placeholder validation**: Ensure no template placeholders remain unfilled (e.g., `{{EpicNum}}`, `{{role}}`, `_TBD_`)
- **Agent section verification**: Confirm all sections from template exist for future agent use
@@ -478,7 +474,6 @@ Provide a structured validation report including:
==================== START: .bmad-core/checklists/story-dod-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Story Definition of Done (DoD) Checklist
## Instructions for Developer Agent

10
dist/agents/pm.txt vendored
View File

@@ -105,7 +105,6 @@ dependencies:
==================== START: .bmad-core/tasks/brownfield-create-epic.md ====================
<!-- Powered by BMAD™ Core -->
# Create Brownfield Epic Task
## Purpose
@@ -270,7 +269,6 @@ The epic creation is successful when:
==================== START: .bmad-core/tasks/brownfield-create-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Brownfield Story Task
## Purpose
@@ -422,7 +420,6 @@ The story creation is successful when:
==================== START: .bmad-core/tasks/correct-course.md ====================
<!-- Powered by BMAD™ Core -->
# Correct Course Task
## Purpose
@@ -497,7 +494,6 @@ The story creation is successful when:
==================== 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.
@@ -780,7 +776,6 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
==================== START: .bmad-core/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -886,7 +881,6 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== 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.
@@ -977,7 +971,6 @@ The LLM will:
==================== START: .bmad-core/tasks/shard-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Document Sharding Task
## Purpose
@@ -1657,7 +1650,6 @@ sections:
==================== 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.
@@ -1844,7 +1836,6 @@ Keep it action-oriented and forward-looking.]]
==================== 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.
@@ -2219,7 +2210,6 @@ After presenting the report, ask if the user wants:
==================== START: .bmad-core/data/technical-preferences.md ====================
<!-- Powered by BMAD™ Core -->
# User-Defined Preferred Patterns and Preferences
None Listed

14
dist/agents/po.txt vendored
View File

@@ -100,7 +100,6 @@ dependencies:
==================== START: .bmad-core/tasks/correct-course.md ====================
<!-- Powered by BMAD™ Core -->
# Correct Course Task
## Purpose
@@ -175,7 +174,6 @@ dependencies:
==================== 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.
@@ -266,7 +264,6 @@ The LLM will:
==================== START: .bmad-core/tasks/shard-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Document Sharding Task
## Purpose
@@ -456,7 +453,6 @@ Document sharded successfully:
==================== START: .bmad-core/tasks/validate-next-story.md ====================
<!-- Powered by BMAD™ Core -->
# Validate Next Story Task
## Purpose
@@ -478,7 +474,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
### 1. Template Completeness Validation
- Load `.bmad-core/templates/story-tmpl.yaml` and extract all section headings from the template
- Load `bmad-core/templates/story-tmpl.md` and extract all section headings from the template
- **Missing sections check**: Compare story sections against template sections to verify all required sections are present
- **Placeholder validation**: Ensure no template placeholders remain unfilled (e.g., `{{EpicNum}}`, `{{role}}`, `_TBD_`)
- **Agent section verification**: Confirm all sections from template exist for future agent use
@@ -736,7 +732,6 @@ sections:
==================== 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.
@@ -923,7 +918,6 @@ Keep it action-oriented and forward-looking.]]
==================== 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.
@@ -939,7 +933,7 @@ First, determine the project type by checking:
2. Is this a BROWNFIELD project (enhancing existing system)?
- Look for: References to existing codebase, enhancement/modification language
- Check for: brownfield-prd.md, brownfield-architecture.md, existing system analysis
- Check for: prd.md, architecture.md, existing system analysis
3. Does the project include UI/UX components?
- Check for: frontend-architecture.md, UI/UX specifications, design files
@@ -957,8 +951,8 @@ For GREENFIELD projects:
For BROWNFIELD projects:
- brownfield-prd.md - The brownfield enhancement requirements
- brownfield-architecture.md - The enhancement architecture
- prd.md - The brownfield enhancement requirements
- architecture.md - The enhancement architecture
- Existing project codebase access (CRITICAL - cannot proceed without this)
- Current deployment configuration and infrastructure details
- Database schemas, API documentation, monitoring setup

22
dist/agents/qa.txt vendored
View File

@@ -55,8 +55,7 @@ agent:
id: qa
title: Test Architect & Quality Advisor
icon: 🧪
whenToUse: |
Use for comprehensive test architecture review, quality gate decisions,
whenToUse: Use for comprehensive test architecture review, quality gate decisions,
and code improvement. Provides thorough analysis including requirements
traceability, risk assessment, and test strategy.
Advisory only - teams choose their quality bar.
@@ -112,7 +111,6 @@ dependencies:
==================== 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.
@@ -122,11 +120,11 @@ Quick NFR validation focused on the core four: security, performance, reliabilit
```yaml
required:
- story_id: '{epic}.{story}' # e.g., "1.3"
- story_path: `bmad-core/core-config.yaml` for the `devStoryLocation`
- story_path: `.bmad-core/core-config.yaml` for the `devStoryLocation`
optional:
- architecture_refs: `bmad-core/core-config.yaml` for the `architecture.architectureFile`
- technical_preferences: `bmad-core/core-config.yaml` for the `technicalPreferences`
- architecture_refs: `.bmad-core/core-config.yaml` for the `architecture.architectureFile`
- technical_preferences: `.bmad-core/core-config.yaml` for the `technicalPreferences`
- acceptance_criteria: From story file
```
@@ -460,7 +458,6 @@ performance_deep_dive:
==================== 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.
@@ -477,7 +474,7 @@ Generate a standalone quality gate file that provides a clear pass/fail decision
## Gate File Location
**ALWAYS** check the `bmad-core/core-config.yaml` for the `qa.qaLocation/gates`
**ALWAYS** check the `.bmad-core/core-config.yaml` for the `qa.qaLocation/gates`
Slug rules:
@@ -587,7 +584,7 @@ waiver:
## Output Requirements
1. **ALWAYS** create gate file at: `qa.qaLocation/gates` from `bmad-core/core-config.yaml`
1. **ALWAYS** create gate file at: `qa.qaLocation/gates` from `.bmad-core/core-config.yaml`
2. **ALWAYS** append this exact format to story's QA Results section:
```text
@@ -626,7 +623,6 @@ Gate: CONCERNS → qa.qaLocation/gates/{epic}.{story}-{slug}.yml
==================== 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.
@@ -813,7 +809,7 @@ NFR assessment: qa.qaLocation/assessments/{epic}.{story}-nfr-{YYYYMMDD}.md
**Template and Directory:**
- Render from `../templates/qa-gate-tmpl.yaml`
- Create directory defined in `qa.qaLocation/gates` (see `bmad-core/core-config.yaml`) if missing
- Create directory defined in `qa.qaLocation/gates` (see `.bmad-core/core-config.yaml`) if missing
- Save to: `qa.qaLocation/gates/{epic}.{story}-{slug}.yml`
Gate file structure:
@@ -945,7 +941,6 @@ After review:
==================== 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.
@@ -1303,7 +1298,6 @@ Risk profile: qa.qaLocation/assessments/{epic}.{story}-risk-{YYYYMMDD}.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.
@@ -1482,7 +1476,6 @@ Before finalizing, verify:
==================== 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.
@@ -1998,7 +1991,6 @@ sections:
==================== START: .bmad-core/data/technical-preferences.md ====================
<!-- Powered by BMAD™ Core -->
# User-Defined Preferred Patterns and Preferences
None Listed

4
dist/agents/sm.txt vendored
View File

@@ -86,7 +86,6 @@ dependencies:
==================== START: .bmad-core/tasks/correct-course.md ====================
<!-- Powered by BMAD™ Core -->
# Correct Course Task
## Purpose
@@ -161,7 +160,6 @@ dependencies:
==================== START: .bmad-core/tasks/create-next-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Next Story Task
## Purpose
@@ -278,7 +276,6 @@ ALWAYS cite source documents: `[Source: architecture/{filename}.md#{section}]`
==================== 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.
@@ -510,7 +507,6 @@ sections:
==================== 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.

View File

@@ -90,7 +90,6 @@ dependencies:
==================== START: .bmad-core/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -196,7 +195,6 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== 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.
@@ -287,7 +285,6 @@ The LLM will:
==================== START: .bmad-core/tasks/generate-ai-frontend-prompt.md ====================
<!-- Powered by BMAD™ Core -->
# Create AI Frontend Prompt Task
## Purpose
@@ -696,7 +693,6 @@ sections:
==================== START: .bmad-core/data/technical-preferences.md ====================
<!-- Powered by BMAD™ Core -->
# User-Defined Preferred Patterns and Preferences
None Listed

View File

@@ -96,7 +96,6 @@ dependencies:
==================== START: .bmad-2d-phaser-game-dev/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -202,7 +201,6 @@ 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.
@@ -293,7 +291,6 @@ 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.
@@ -588,7 +585,6 @@ 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.
@@ -871,7 +867,6 @@ 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
@@ -2181,7 +2176,6 @@ 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,7 +103,6 @@ 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.
@@ -811,7 +810,6 @@ 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
@@ -976,7 +974,6 @@ _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,7 +89,6 @@ dependencies:
==================== START: .bmad-2d-phaser-game-dev/tasks/create-game-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Game Development Story Task
## Purpose
@@ -310,7 +309,6 @@ 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.
@@ -658,7 +656,6 @@ 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,7 +414,6 @@ dependencies:
==================== START: .bmad-2d-phaser-game-dev/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# Game Development BMad Knowledge Base
## Overview
@@ -669,7 +668,6 @@ 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
@@ -710,7 +708,6 @@ 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
@@ -825,7 +822,6 @@ 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.
@@ -1108,7 +1104,6 @@ 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 ⚠️
@@ -1214,7 +1209,6 @@ 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
@@ -1561,11 +1555,10 @@ 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
@@ -2653,7 +2646,6 @@ sections:
==================== START: .bmad-2d-phaser-game-dev/data/elicitation-methods.md ====================
<!-- Powered by BMAD™ Core -->
# Elicitation Methods Data
## Core Reflective Methods
@@ -2812,7 +2804,6 @@ sections:
==================== START: .bmad-2d-phaser-game-dev/tasks/kb-mode-interaction.md ====================
<!-- Powered by BMAD™ Core -->
# KB Mode Interaction Task
## Purpose
@@ -2892,7 +2883,6 @@ 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.
@@ -2966,7 +2956,6 @@ 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.
@@ -3057,7 +3046,6 @@ 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.
@@ -4547,7 +4535,6 @@ sections:
==================== START: .bmad-2d-phaser-game-dev/checklists/game-design-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Game Design Document Quality Checklist
## Document Completeness
@@ -5370,7 +5357,6 @@ 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
@@ -5535,7 +5521,6 @@ _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
@@ -6187,7 +6172,6 @@ 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
@@ -8734,7 +8718,6 @@ sections:
==================== START: .bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Game Design Elicitation Task
## Purpose
@@ -8849,7 +8832,6 @@ 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
@@ -9070,7 +9052,6 @@ 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.
@@ -9365,7 +9346,6 @@ 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
@@ -9571,7 +9551,6 @@ _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
@@ -10102,7 +10081,6 @@ workflow:
==================== START: .bmad-2d-phaser-game-dev/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# Game Development BMad Knowledge Base
## Overview
@@ -10357,7 +10335,6 @@ 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,7 +104,6 @@ dependencies:
==================== START: .bmad-2d-unity-game-dev/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -210,7 +209,6 @@ 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.
@@ -493,7 +491,6 @@ 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
@@ -683,7 +680,6 @@ Document sharded successfully:
==================== START: .bmad-2d-unity-game-dev/tasks/document-project.md ====================
<!-- Powered by BMAD™ Core -->
# Document an Existing Project
## Purpose
@@ -1031,7 +1027,6 @@ 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.
@@ -1122,7 +1117,6 @@ The LLM will:
==================== START: .bmad-2d-unity-game-dev/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Game Design Elicitation Task
## Purpose
@@ -2271,7 +2265,6 @@ 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.
@@ -2667,7 +2660,6 @@ 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
@@ -3258,7 +3250,6 @@ 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

View File

@@ -101,7 +101,6 @@ dependencies:
==================== START: .bmad-2d-unity-game-dev/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -207,7 +206,6 @@ 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.
@@ -298,7 +296,6 @@ The LLM will:
==================== START: .bmad-2d-unity-game-dev/tasks/shard-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Document Sharding Task
## Purpose
@@ -488,7 +485,6 @@ 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.
@@ -783,7 +779,6 @@ 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.
@@ -1066,7 +1061,6 @@ 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
@@ -2738,7 +2732,6 @@ sections:
==================== START: .bmad-2d-unity-game-dev/checklists/game-design-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Game Design Document Quality Checklist
## Document Completeness
@@ -2944,7 +2937,6 @@ _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

View File

@@ -98,7 +98,6 @@ 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.
@@ -189,7 +188,6 @@ The LLM will:
==================== START: .bmad-2d-unity-game-dev/tasks/validate-next-story.md ====================
<!-- Powered by BMAD™ Core -->
# Validate Next Story Task
## Purpose
@@ -211,7 +209,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
### 1. Template Completeness Validation
- Load `.bmad-core/templates/story-tmpl.yaml` and extract all section headings from the template
- Load `bmad-core/templates/story-tmpl.md` and extract all section headings from the template
- **Missing sections check**: Compare story sections against template sections to verify all required sections are present
- **Placeholder validation**: Ensure no template placeholders remain unfilled (e.g., `{{EpicNum}}`, `{{role}}`, `_TBD_`)
- **Agent section verification**: Confirm all sections from template exist for future agent use
@@ -328,7 +326,6 @@ 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,7 +89,6 @@ dependencies:
==================== START: .bmad-2d-unity-game-dev/tasks/create-game-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Game Story Task
## Purpose
@@ -278,7 +277,6 @@ 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.
@@ -369,7 +367,6 @@ The LLM will:
==================== START: .bmad-2d-unity-game-dev/tasks/correct-course-game.md ====================
<!-- Powered by BMAD™ Core -->
# Correct Course Task - Game Development
## Purpose
@@ -775,7 +772,6 @@ 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,7 +478,6 @@ dependencies:
==================== START: .bmad-2d-unity-game-dev/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMad Knowledge Base - 2D Unity Game Development
## Overview
@@ -1252,7 +1251,6 @@ 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
@@ -1293,7 +1291,6 @@ 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
@@ -1408,7 +1405,6 @@ 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.
@@ -1691,7 +1687,6 @@ 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 ⚠️
@@ -1797,7 +1792,6 @@ 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
@@ -2144,11 +2138,10 @@ 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
@@ -3236,7 +3229,6 @@ sections:
==================== START: .bmad-2d-unity-game-dev/data/elicitation-methods.md ====================
<!-- Powered by BMAD™ Core -->
# Elicitation Methods Data
## Core Reflective Methods
@@ -3395,7 +3387,6 @@ sections:
==================== START: .bmad-2d-unity-game-dev/tasks/kb-mode-interaction.md ====================
<!-- Powered by BMAD™ Core -->
# KB Mode Interaction Task
## Purpose
@@ -3475,7 +3466,6 @@ 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.
@@ -3549,7 +3539,6 @@ 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.
@@ -3640,7 +3629,6 @@ The LLM will:
==================== START: .bmad-2d-unity-game-dev/tasks/shard-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Document Sharding Task
## Purpose
@@ -3830,7 +3818,6 @@ 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.
@@ -5682,7 +5669,6 @@ sections:
==================== START: .bmad-2d-unity-game-dev/checklists/game-design-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Game Design Document Quality Checklist
## Document Completeness
@@ -6922,7 +6908,6 @@ 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.
@@ -7318,7 +7303,6 @@ 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
@@ -7909,7 +7893,6 @@ 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
@@ -7931,7 +7914,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
### 1. Template Completeness Validation
- Load `.bmad-core/templates/story-tmpl.yaml` and extract all section headings from the template
- Load `bmad-core/templates/story-tmpl.md` and extract all section headings from the template
- **Missing sections check**: Compare story sections against template sections to verify all required sections are present
- **Placeholder validation**: Ensure no template placeholders remain unfilled (e.g., `{{EpicNum}}`, `{{role}}`, `_TBD_`)
- **Agent section verification**: Confirm all sections from template exist for future agent use
@@ -8048,7 +8031,6 @@ 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
@@ -8177,7 +8159,6 @@ 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
@@ -8366,7 +8347,6 @@ 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
@@ -8772,7 +8752,6 @@ 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.
@@ -11831,7 +11810,6 @@ sections:
==================== START: .bmad-2d-unity-game-dev/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Game Design Elicitation Task
## Purpose
@@ -11946,7 +11924,6 @@ 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
@@ -12092,7 +12069,6 @@ 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
@@ -12281,7 +12257,6 @@ 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.
@@ -12576,7 +12551,6 @@ 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
@@ -12781,7 +12755,6 @@ 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.
@@ -13177,7 +13150,6 @@ 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.
@@ -13385,7 +13357,6 @@ 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
@@ -13591,7 +13562,6 @@ _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
@@ -14086,7 +14056,6 @@ workflow:
==================== START: .bmad-2d-unity-game-dev/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMad Knowledge Base - 2D Unity Game Development
## Overview
@@ -14860,7 +14829,6 @@ 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,7 +117,6 @@ 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,7 +222,6 @@ 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)
@@ -250,7 +248,6 @@ inputs:
==================== START: .bmad-creative-writing/tasks/quick-feedback.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 13. Quick Feedback (Serial)
@@ -275,7 +272,6 @@ inputs:
==================== START: .bmad-creative-writing/tasks/analyze-reader-feedback.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 16. Analyze Reader Feedback
@@ -301,7 +297,6 @@ 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.
@@ -392,7 +387,6 @@ The LLM will:
==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -614,7 +608,6 @@ sections:
==================== START: .bmad-creative-writing/checklists/beta-feedback-closure-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 6. BetaFeedback Closure Checklist
@@ -640,7 +633,6 @@ items:
==================== START: .bmad-creative-writing/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMad Creative Writing Knowledge Base
## Overview
@@ -852,7 +844,6 @@ 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,7 +116,6 @@ 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,7 +221,6 @@ 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
@@ -249,7 +247,6 @@ inputs:
==================== START: .bmad-creative-writing/tasks/workshop-dialog.md ====================
<!-- Powered by BMAD™ Core -->
# Workshop Dialog
## Purpose
@@ -316,7 +313,6 @@ 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
@@ -341,7 +337,6 @@ 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.
@@ -432,7 +427,6 @@ The LLM will:
==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -649,7 +643,6 @@ sections:
==================== START: .bmad-creative-writing/checklists/character-consistency-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 1. Character Consistency Checklist
@@ -675,7 +668,6 @@ items:
==================== START: .bmad-creative-writing/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMad Creative Writing Knowledge Base
## Overview

View File

@@ -115,7 +115,6 @@ 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,7 +220,6 @@ 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
@@ -288,7 +286,6 @@ 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.
@@ -379,7 +376,6 @@ The LLM will:
==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -596,7 +592,6 @@ sections:
==================== START: .bmad-creative-writing/checklists/comedic-timing-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 23. Comedic Timing & Humor Checklist
@@ -622,7 +617,6 @@ items:
==================== START: .bmad-creative-writing/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMad Creative Writing Knowledge Base
## Overview
@@ -834,7 +828,6 @@ 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,7 +116,6 @@ 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,7 +221,6 @@ 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
@@ -248,7 +246,6 @@ inputs:
==================== START: .bmad-creative-writing/tasks/incorporate-feedback.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 6. Incorporate Feedback
@@ -276,7 +273,6 @@ 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.
@@ -367,7 +363,6 @@ The LLM will:
==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -574,7 +569,6 @@ sections:
==================== START: .bmad-creative-writing/checklists/line-edit-quality-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 4. LineEdit Quality Checklist
@@ -600,7 +594,6 @@ items:
==================== START: .bmad-creative-writing/checklists/publication-readiness-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 5. Publication Readiness Checklist
@@ -626,7 +619,6 @@ items:
==================== START: .bmad-creative-writing/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMad Creative Writing Knowledge Base
## Overview

View File

@@ -118,7 +118,6 @@ 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 ⚠️
@@ -224,7 +223,6 @@ 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
@@ -294,7 +292,6 @@ 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.
@@ -385,7 +382,6 @@ The LLM will:
==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -606,7 +602,6 @@ sections:
==================== START: .bmad-creative-writing/checklists/genre-tropes-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 10. Genre Tropes Checklist (General)
@@ -631,7 +626,6 @@ items:
==================== START: .bmad-creative-writing/checklists/fantasy-magic-system-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 17. Fantasy Magic System Consistency Checklist
@@ -657,7 +651,6 @@ items:
==================== START: .bmad-creative-writing/checklists/scifi-technology-plausibility-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 15. SciFi Technology Plausibility Checklist
@@ -682,7 +675,6 @@ items:
==================== START: .bmad-creative-writing/checklists/romance-emotional-beats-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 12. Romance Emotional Beats Checklist
@@ -708,7 +700,6 @@ items:
==================== START: .bmad-creative-writing/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMad Creative Writing Knowledge Base
## Overview
@@ -920,7 +911,6 @@ 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,7 +116,6 @@ 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,7 +221,6 @@ 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
@@ -248,7 +246,6 @@ inputs:
==================== START: .bmad-creative-writing/tasks/generate-scene-list.md ====================
<!-- Powered by BMAD™ Core -->
# ------------------------------------------------------------
# 10. Generate Scene List
@@ -274,7 +271,6 @@ 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.
@@ -365,7 +361,6 @@ The LLM will:
==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -545,7 +540,6 @@ sections:
==================== START: .bmad-creative-writing/checklists/plot-structure-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Plot Structure Checklist
## Opening
@@ -607,7 +601,6 @@ sections:
==================== START: .bmad-creative-writing/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMad Creative Writing Knowledge Base
## Overview
@@ -819,7 +812,6 @@ 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,7 +118,6 @@ 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 ⚠️
@@ -224,7 +223,6 @@ 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
@@ -294,7 +292,6 @@ 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.
@@ -385,7 +382,6 @@ The LLM will:
==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -830,7 +826,6 @@ sections:
==================== START: .bmad-creative-writing/checklists/plot-structure-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Plot Structure Checklist
## Opening
@@ -892,7 +887,6 @@ sections:
==================== START: .bmad-creative-writing/data/story-structures.md ====================
<!-- Powered by BMAD™ Core -->
# Story Structure Patterns
## Three-Act Structure
@@ -962,7 +956,6 @@ sections:
==================== START: .bmad-creative-writing/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMad Creative Writing Knowledge Base
## Overview

View File

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

@@ -286,7 +286,7 @@ optional:
### 0) Load Core Config & Locate Story
- Read `bmad-core/core-config.yaml` and resolve `qa_root`, `story_root`, and `project_root`
- Read `.bmad-core/core-config.yaml` and resolve `qa_root`, `story_root`, and `project_root`
- Locate story file in `{story_root}/{epic}.{story}.*.md`
- HALT if missing and ask for correct story id/path
@@ -386,7 +386,7 @@ Status Rule:
## Blocking Conditions
- Missing `bmad-core/core-config.yaml`
- Missing `.bmad-core/core-config.yaml`
- Story file not found for `story_id`
- No QA artifacts found (neither gate nor assessments)
- HALT and request QA to generate at least a gate file (or proceed only with clear developer-provided fix list)

View File

@@ -55,8 +55,7 @@ agent:
id: game-qa
title: Game Test Architect & TDD Enforcer (Godot)
icon: 🎮🧪
whenToUse: |
Use for Godot game testing architecture, test-driven development enforcement,
whenToUse: Use for Godot game testing architecture, test-driven development enforcement,
performance validation, and gameplay quality assurance. Ensures all code is
test-first, performance targets are met, and player experience is validated.
Enforces GUT for GDScript and GoDotTest/GodotTestDriver for C# with TDD practices.

View File

@@ -558,8 +558,7 @@ agent:
id: game-qa
title: Game Test Architect & TDD Enforcer (Godot)
icon: 🎮🧪
whenToUse: |
Use for Godot game testing architecture, test-driven development enforcement,
whenToUse: Use for Godot game testing architecture, test-driven development enforcement,
performance validation, and gameplay quality assurance. Ensures all code is
test-first, performance targets are met, and player experience is validated.
Enforces GUT for GDScript and GoDotTest/GodotTestDriver for C# with TDD practices.
@@ -8943,7 +8942,7 @@ optional:
### 0) Load Core Config & Locate Story
- Read `bmad-core/core-config.yaml` and resolve `qa_root`, `story_root`, and `project_root`
- Read `.bmad-core/core-config.yaml` and resolve `qa_root`, `story_root`, and `project_root`
- Locate story file in `{story_root}/{epic}.{story}.*.md`
- HALT if missing and ask for correct story id/path
@@ -9043,7 +9042,7 @@ Status Rule:
## Blocking Conditions
- Missing `bmad-core/core-config.yaml`
- Missing `.bmad-core/core-config.yaml`
- Story file not found for `story_id`
- No QA artifacts found (neither gate nor assessments)
- HALT and request QA to generate at least a gate file (or proceed only with clear developer-provided fix list)
@@ -19903,7 +19902,7 @@ optional:
### 0) Load Core Config & Locate Story
- Read `bmad-core/core-config.yaml` and resolve `qa_root`, `story_root`, and `project_root`
- Read `.bmad-core/core-config.yaml` and resolve `qa_root`, `story_root`, and `project_root`
- Locate story file in `{story_root}/{epic}.{story}.*.md`
- HALT if missing and ask for correct story id/path
@@ -20003,7 +20002,7 @@ Status Rule:
## Blocking Conditions
- Missing `bmad-core/core-config.yaml`
- Missing `.bmad-core/core-config.yaml`
- Story file not found for `story_id`
- No QA artifacts found (neither gate nor assessments)
- HALT and request QA to generate at least a gate file (or proceed only with clear developer-provided fix list)

View File

@@ -102,7 +102,6 @@ dependencies:
==================== START: .bmad-infrastructure-devops/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -208,7 +207,6 @@ 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
@@ -372,7 +370,6 @@ 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
@@ -1591,7 +1588,6 @@ 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.
@@ -2080,7 +2076,6 @@ 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

@@ -338,7 +338,6 @@ persona:
focus: Executing story tasks with precision, updating Dev Agent Record sections only, maintaining minimal context overhead
core_principles:
- CRITICAL: Story has ALL info you will need aside from what you loaded during the startup commands. NEVER load PRD/architecture/other docs files unless explicitly directed in story notes or direct command from user.
- CRITICAL: ALWAYS check current folder structure before starting your story tasks, don't create new working directory if it already exists. Create new one when you're sure it's a brand new project.
- CRITICAL: ONLY update story file Dev Agent Record sections (checkboxes/Debug Log/Completion Notes/Change Log)
- CRITICAL: FOLLOW THE develop-story command when the user tells you to implement the story
- Numbered Options - Always use numbered lists when presenting choices to the user
@@ -506,8 +505,7 @@ agent:
id: qa
title: Test Architect & Quality Advisor
icon: 🧪
whenToUse: |
Use for comprehensive test architecture review, quality gate decisions,
whenToUse: Use for comprehensive test architecture review, quality gate decisions,
and code improvement. Provides thorough analysis including requirements
traceability, risk assessment, and test strategy.
Advisory only - teams choose their quality bar.
@@ -657,7 +655,6 @@ dependencies:
==================== START: .bmad-core/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -779,7 +776,6 @@ Choose a number (0-8) or 9 to proceed:
==================== START: .bmad-core/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -885,7 +881,6 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-core/tasks/kb-mode-interaction.md ====================
<!-- Powered by BMAD™ Core -->
# KB Mode Interaction Task
## Purpose
@@ -965,7 +960,6 @@ Or ask me about anything else related to BMad-Method!
==================== START: .bmad-core/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMAD™ Knowledge Base
## Overview
@@ -1068,7 +1062,6 @@ npx bmad-method install
- **Cline**: VS Code extension with AI features
- **Roo Code**: Web-based IDE with agent support
- **GitHub Copilot**: VS Code extension with AI peer programming assistant
- **Auggie CLI (Augment Code)**: AI-powered development environment
**Note for VS Code Users**: BMAD-METHOD™ assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo.
@@ -1147,7 +1140,7 @@ npx bmad-method install
## Core Configuration (core-config.yaml)
**New in V4**: The `bmad-core/core-config.yaml` file is a critical innovation that enables BMad to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
**New in V4**: The `.bmad-core/core-config.yaml` file is a critical innovation that enables BMad to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
### What is core-config.yaml?
@@ -1777,7 +1770,6 @@ Use the **expansion-creator** pack to build your own:
==================== START: .bmad-core/data/elicitation-methods.md ====================
<!-- Powered by BMAD™ Core -->
# Elicitation Methods Data
## Core Reflective Methods
@@ -1936,7 +1928,6 @@ Use the **expansion-creator** pack to build your own:
==================== START: .bmad-core/utils/workflow-management.md ====================
<!-- Powered by BMAD™ Core -->
# Workflow Management
Enables BMad orchestrator to manage and execute team workflows.
@@ -2010,7 +2001,6 @@ Agents should be workflow-aware: know active workflow, their role, access artifa
==================== 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.
@@ -2293,7 +2283,6 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
==================== START: .bmad-core/tasks/document-project.md ====================
<!-- Powered by BMAD™ Core -->
# Document an Existing Project
## Purpose
@@ -2640,11 +2629,10 @@ Apply the advanced elicitation task after major sections to refine based on user
==================== END: .bmad-core/tasks/document-project.md ====================
==================== START: .bmad-core/tasks/facilitate-brainstorming-session.md ====================
## <!-- Powered by BMAD™ Core -->
<!-- Powered by BMAD™ Core -->
---
docOutputLocation: docs/brainstorming-session-results.md
template: '.bmad-core/templates/brainstorming-output-tmpl.yaml'
---
# Facilitate Brainstorming Session Task
@@ -3732,7 +3720,6 @@ sections:
==================== START: .bmad-core/data/brainstorming-techniques.md ====================
<!-- Powered by BMAD™ Core -->
# Brainstorming Techniques Data
## Creative Expansion
@@ -3773,7 +3760,6 @@ sections:
==================== 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.
@@ -4542,7 +4528,7 @@ sections:
1. **Verify Complexity**: Confirm this enhancement requires architectural planning. For simple additions, recommend: "For simpler changes that don't require architectural planning, consider using the brownfield-create-epic or brownfield-create-story task with the Product Owner instead."
2. **REQUIRED INPUTS**:
- Completed brownfield-prd.md
- Completed prd.md
- Existing project technical documentation (from docs folder or user-provided)
- Access to existing project structure (IDE or uploaded files)
@@ -4628,8 +4614,8 @@ sections:
- **UI/UX Consistency:** {{ui_compatibility}}
- **Performance Impact:** {{performance_constraints}}
- id: tech-stack
title: Tech Stack
- id: tech-stack-alignment
title: Tech Stack Alignment
instruction: |
Ensure new components align with existing technology choices:
@@ -4791,8 +4777,8 @@ sections:
**Error Handling:** {{error_handling_strategy}}
- id: source-tree
title: Source Tree
- id: source-tree-integration
title: Source Tree Integration
instruction: |
Define how new code will integrate with existing project structure:
@@ -4861,7 +4847,7 @@ sections:
**Monitoring:** {{monitoring_approach}}
- id: coding-standards
title: Coding Standards
title: Coding Standards and Conventions
instruction: |
Ensure new code follows existing project conventions:
@@ -6047,7 +6033,6 @@ sections:
==================== 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.
@@ -6490,7 +6475,6 @@ After presenting the report, ask the user if they would like detailed analysis o
==================== START: .bmad-core/data/technical-preferences.md ====================
<!-- Powered by BMAD™ Core -->
# User-Defined Preferred Patterns and Preferences
None Listed
@@ -6498,7 +6482,6 @@ None Listed
==================== 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.
@@ -6515,8 +6498,8 @@ Implement fixes based on QA results (gate and assessments) for a specific story.
```yaml
required:
- story_id: '{epic}.{story}' # e.g., "2.2"
- qa_root: from `bmad-core/core-config.yaml` key `qa.qaLocation` (e.g., `docs/project/qa`)
- story_root: from `bmad-core/core-config.yaml` key `devStoryLocation` (e.g., `docs/project/stories`)
- qa_root: from `.bmad-core/core-config.yaml` key `qa.qaLocation` (e.g., `docs/project/qa`)
- story_root: from `.bmad-core/core-config.yaml` key `devStoryLocation` (e.g., `docs/project/stories`)
optional:
- story_title: '{title}' # derive from story H1 if missing
@@ -6544,7 +6527,7 @@ optional:
### 0) Load Core Config & Locate Story
- Read `bmad-core/core-config.yaml` and resolve `qa_root` and `story_root`
- Read `.bmad-core/core-config.yaml` and resolve `qa_root` and `story_root`
- Locate story file in `{story_root}/{epic}.{story}.*.md`
- HALT if missing and ask for correct story id/path
@@ -6612,7 +6595,7 @@ Status Rule:
## Blocking Conditions
- Missing `bmad-core/core-config.yaml`
- Missing `.bmad-core/core-config.yaml`
- Story file not found for `story_id`
- No QA artifacts found (neither gate nor assessments)
- HALT and request QA to generate at least a gate file (or proceed only with clear developer-provided fix list)
@@ -6651,7 +6634,6 @@ Fix plan:
==================== START: .bmad-core/tasks/validate-next-story.md ====================
<!-- Powered by BMAD™ Core -->
# Validate Next Story Task
## Purpose
@@ -6673,7 +6655,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
### 1. Template Completeness Validation
- Load `.bmad-core/templates/story-tmpl.yaml` and extract all section headings from the template
- Load `bmad-core/templates/story-tmpl.md` and extract all section headings from the template
- **Missing sections check**: Compare story sections against template sections to verify all required sections are present
- **Placeholder validation**: Ensure no template placeholders remain unfilled (e.g., `{{EpicNum}}`, `{{role}}`, `_TBD_`)
- **Agent section verification**: Confirm all sections from template exist for future agent use
@@ -6790,7 +6772,6 @@ Provide a structured validation report including:
==================== START: .bmad-core/checklists/story-dod-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Story Definition of Done (DoD) Checklist
## Instructions for Developer Agent
@@ -6889,7 +6870,6 @@ Be honest - it's better to flag issues now than have them discovered later.]]
==================== START: .bmad-core/tasks/brownfield-create-epic.md ====================
<!-- Powered by BMAD™ Core -->
# Create Brownfield Epic Task
## Purpose
@@ -7054,7 +7034,6 @@ The epic creation is successful when:
==================== START: .bmad-core/tasks/brownfield-create-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Brownfield Story Task
## Purpose
@@ -7206,7 +7185,6 @@ The story creation is successful when:
==================== START: .bmad-core/tasks/correct-course.md ====================
<!-- Powered by BMAD™ Core -->
# Correct Course Task
## Purpose
@@ -7281,7 +7259,6 @@ The story creation is successful when:
==================== START: .bmad-core/tasks/shard-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Document Sharding Task
## Purpose
@@ -7961,7 +7938,6 @@ sections:
==================== 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.
@@ -8148,7 +8124,6 @@ Keep it action-oriented and forward-looking.]]
==================== 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.
@@ -8664,7 +8639,6 @@ sections:
==================== 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.
@@ -8680,7 +8654,7 @@ First, determine the project type by checking:
2. Is this a BROWNFIELD project (enhancing existing system)?
- Look for: References to existing codebase, enhancement/modification language
- Check for: brownfield-prd.md, brownfield-architecture.md, existing system analysis
- Check for: prd.md, architecture.md, existing system analysis
3. Does the project include UI/UX components?
- Check for: frontend-architecture.md, UI/UX specifications, design files
@@ -8698,8 +8672,8 @@ For GREENFIELD projects:
For BROWNFIELD projects:
- brownfield-prd.md - The brownfield enhancement requirements
- brownfield-architecture.md - The enhancement architecture
- prd.md - The brownfield enhancement requirements
- architecture.md - The enhancement architecture
- Existing project codebase access (CRITICAL - cannot proceed without this)
- Current deployment configuration and infrastructure details
- Database schemas, API documentation, monitoring setup
@@ -9101,7 +9075,6 @@ After presenting the report, ask if the user wants:
==================== 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.
@@ -9111,11 +9084,11 @@ Quick NFR validation focused on the core four: security, performance, reliabilit
```yaml
required:
- story_id: '{epic}.{story}' # e.g., "1.3"
- story_path: `bmad-core/core-config.yaml` for the `devStoryLocation`
- story_path: `.bmad-core/core-config.yaml` for the `devStoryLocation`
optional:
- architecture_refs: `bmad-core/core-config.yaml` for the `architecture.architectureFile`
- technical_preferences: `bmad-core/core-config.yaml` for the `technicalPreferences`
- architecture_refs: `.bmad-core/core-config.yaml` for the `architecture.architectureFile`
- technical_preferences: `.bmad-core/core-config.yaml` for the `technicalPreferences`
- acceptance_criteria: From story file
```
@@ -9449,7 +9422,6 @@ performance_deep_dive:
==================== 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.
@@ -9466,7 +9438,7 @@ Generate a standalone quality gate file that provides a clear pass/fail decision
## Gate File Location
**ALWAYS** check the `bmad-core/core-config.yaml` for the `qa.qaLocation/gates`
**ALWAYS** check the `.bmad-core/core-config.yaml` for the `qa.qaLocation/gates`
Slug rules:
@@ -9576,7 +9548,7 @@ waiver:
## Output Requirements
1. **ALWAYS** create gate file at: `qa.qaLocation/gates` from `bmad-core/core-config.yaml`
1. **ALWAYS** create gate file at: `qa.qaLocation/gates` from `.bmad-core/core-config.yaml`
2. **ALWAYS** append this exact format to story's QA Results section:
```text
@@ -9615,7 +9587,6 @@ Gate: CONCERNS → qa.qaLocation/gates/{epic}.{story}-{slug}.yml
==================== 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.
@@ -9802,7 +9773,7 @@ NFR assessment: qa.qaLocation/assessments/{epic}.{story}-nfr-{YYYYMMDD}.md
**Template and Directory:**
- Render from `../templates/qa-gate-tmpl.yaml`
- Create directory defined in `qa.qaLocation/gates` (see `bmad-core/core-config.yaml`) if missing
- Create directory defined in `qa.qaLocation/gates` (see `.bmad-core/core-config.yaml`) if missing
- Save to: `qa.qaLocation/gates/{epic}.{story}-{slug}.yml`
Gate file structure:
@@ -9934,7 +9905,6 @@ After review:
==================== 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.
@@ -10292,7 +10262,6 @@ Risk profile: qa.qaLocation/assessments/{epic}.{story}-risk-{YYYYMMDD}.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.
@@ -10471,7 +10440,6 @@ Before finalizing, verify:
==================== 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.
@@ -10846,7 +10814,6 @@ optional_fields_examples:
==================== START: .bmad-core/tasks/create-next-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Next Story Task
## Purpose
@@ -10963,7 +10930,6 @@ ALWAYS cite source documents: `[Source: architecture/{filename}.md#{section}]`
==================== 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.
@@ -11121,7 +11087,6 @@ Be pragmatic - perfect documentation doesn't exist, but it must be enough to pro
==================== START: .bmad-core/tasks/generate-ai-frontend-prompt.md ====================
<!-- Powered by BMAD™ Core -->
# Create AI Frontend Prompt Task
## Purpose
@@ -11691,7 +11656,7 @@ workflow:
- Dev Agent (New Chat): Address remaining items
- Return to QA for final approval
- step: repeat_development_cycle
- repeat_development_cycle:
action: continue_for_all_stories
notes: |
Repeat story cycle (SM → Dev → QA) for all epic stories
@@ -11708,7 +11673,7 @@ workflow:
- Validate epic was completed correctly
- Document learnings and improvements
- step: workflow_end
- workflow_end:
action: project_complete
notes: |
All stories implemented and reviewed!
@@ -11938,7 +11903,7 @@ workflow:
- Dev Agent (New Chat): Address remaining items
- Return to QA for final approval
- step: repeat_development_cycle
- repeat_development_cycle:
action: continue_for_all_stories
notes: |
Repeat story cycle (SM → Dev → QA) for all epic stories
@@ -11955,7 +11920,7 @@ workflow:
- Validate epic was completed correctly
- Document learnings and improvements
- step: workflow_end
- workflow_end:
action: project_complete
notes: |
All stories implemented and reviewed!
@@ -12136,7 +12101,7 @@ workflow:
- Dev Agent (New Chat): Address remaining items
- Return to QA for final approval
- step: repeat_development_cycle
- repeat_development_cycle:
action: continue_for_all_stories
notes: |
Repeat story cycle (SM → Dev → QA) for all epic stories
@@ -12153,7 +12118,7 @@ workflow:
- Validate epic was completed correctly
- Document learnings and improvements
- step: workflow_end
- workflow_end:
action: project_complete
notes: |
All stories implemented and reviewed!
@@ -12289,12 +12254,12 @@ workflow:
condition: po_checklist_issues
notes: "If PO finds issues, return to relevant agent to fix and re-export updated documents to docs/ folder."
- step: project_setup_guidance
- project_setup_guidance:
action: guide_project_structure
condition: user_has_generated_ui
notes: "If user generated UI with v0/Lovable: For polyrepo setup, place downloaded project in separate frontend repo alongside backend repo. For monorepo, place in apps/web or packages/frontend directory. Review architecture document for specific guidance."
- step: development_order_guidance
- development_order_guidance:
action: guide_development_sequence
notes: "Based on PRD stories: If stories are frontend-heavy, start with frontend project/directory first. If backend-heavy or API-first, start with backend. For tightly coupled features, follow story sequence in monorepo setup. Reference sharded PRD epics for development order."
@@ -12362,7 +12327,7 @@ workflow:
- Dev Agent (New Chat): Address remaining items
- Return to QA for final approval
- step: repeat_development_cycle
- repeat_development_cycle:
action: continue_for_all_stories
notes: |
Repeat story cycle (SM → Dev → QA) for all epic stories
@@ -12379,7 +12344,7 @@ workflow:
- Validate epic was completed correctly
- Document learnings and improvements
- step: workflow_end
- workflow_end:
action: project_complete
notes: |
All stories implemented and reviewed!
@@ -12582,7 +12547,7 @@ workflow:
- Dev Agent (New Chat): Address remaining items
- Return to QA for final approval
- step: repeat_development_cycle
- repeat_development_cycle:
action: continue_for_all_stories
notes: |
Repeat story cycle (SM → Dev → QA) for all epic stories
@@ -12599,7 +12564,7 @@ workflow:
- Validate epic was completed correctly
- Document learnings and improvements
- step: workflow_end
- workflow_end:
action: project_complete
notes: |
All stories implemented and reviewed!
@@ -12742,7 +12707,7 @@ workflow:
condition: po_checklist_issues
notes: "If PO finds issues, return to relevant agent to fix and re-export updated documents to docs/ folder."
- step: project_setup_guidance
- project_setup_guidance:
action: guide_project_structure
condition: user_has_generated_ui
notes: "If user generated UI with v0/Lovable: For polyrepo setup, place downloaded project in separate frontend repo. For monorepo, place in apps/web or frontend/ directory. Review architecture document for specific guidance."
@@ -12811,7 +12776,7 @@ workflow:
- Dev Agent (New Chat): Address remaining items
- Return to QA for final approval
- step: repeat_development_cycle
- repeat_development_cycle:
action: continue_for_all_stories
notes: |
Repeat story cycle (SM → Dev → QA) for all epic stories
@@ -12828,7 +12793,7 @@ workflow:
- Validate epic was completed correctly
- Document learnings and improvements
- step: workflow_end
- workflow_end:
action: project_complete
notes: |
All stories implemented and reviewed!

View File

@@ -491,7 +491,6 @@ dependencies:
==================== START: .bmad-core/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -613,7 +612,6 @@ Choose a number (0-8) or 9 to proceed:
==================== START: .bmad-core/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -719,7 +717,6 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-core/tasks/kb-mode-interaction.md ====================
<!-- Powered by BMAD™ Core -->
# KB Mode Interaction Task
## Purpose
@@ -799,7 +796,6 @@ Or ask me about anything else related to BMad-Method!
==================== START: .bmad-core/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMAD™ Knowledge Base
## Overview
@@ -902,7 +898,6 @@ npx bmad-method install
- **Cline**: VS Code extension with AI features
- **Roo Code**: Web-based IDE with agent support
- **GitHub Copilot**: VS Code extension with AI peer programming assistant
- **Auggie CLI (Augment Code)**: AI-powered development environment
**Note for VS Code Users**: BMAD-METHOD™ assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo.
@@ -981,7 +976,7 @@ npx bmad-method install
## Core Configuration (core-config.yaml)
**New in V4**: The `bmad-core/core-config.yaml` file is a critical innovation that enables BMad to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
**New in V4**: The `.bmad-core/core-config.yaml` file is a critical innovation that enables BMad to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
### What is core-config.yaml?
@@ -1611,7 +1606,6 @@ Use the **expansion-creator** pack to build your own:
==================== START: .bmad-core/data/elicitation-methods.md ====================
<!-- Powered by BMAD™ Core -->
# Elicitation Methods Data
## Core Reflective Methods
@@ -1770,7 +1764,6 @@ Use the **expansion-creator** pack to build your own:
==================== START: .bmad-core/utils/workflow-management.md ====================
<!-- Powered by BMAD™ Core -->
# Workflow Management
Enables BMad orchestrator to manage and execute team workflows.
@@ -1844,7 +1837,6 @@ Agents should be workflow-aware: know active workflow, their role, access artifa
==================== 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.
@@ -2127,7 +2119,6 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
==================== START: .bmad-core/tasks/document-project.md ====================
<!-- Powered by BMAD™ Core -->
# Document an Existing Project
## Purpose
@@ -2474,11 +2465,10 @@ Apply the advanced elicitation task after major sections to refine based on user
==================== END: .bmad-core/tasks/document-project.md ====================
==================== START: .bmad-core/tasks/facilitate-brainstorming-session.md ====================
## <!-- Powered by BMAD™ Core -->
<!-- Powered by BMAD™ Core -->
---
docOutputLocation: docs/brainstorming-session-results.md
template: '.bmad-core/templates/brainstorming-output-tmpl.yaml'
---
# Facilitate Brainstorming Session Task
@@ -3566,7 +3556,6 @@ sections:
==================== START: .bmad-core/data/brainstorming-techniques.md ====================
<!-- Powered by BMAD™ Core -->
# Brainstorming Techniques Data
## Creative Expansion
@@ -3607,7 +3596,6 @@ sections:
==================== START: .bmad-core/tasks/brownfield-create-epic.md ====================
<!-- Powered by BMAD™ Core -->
# Create Brownfield Epic Task
## Purpose
@@ -3772,7 +3760,6 @@ The epic creation is successful when:
==================== START: .bmad-core/tasks/brownfield-create-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Brownfield Story Task
## Purpose
@@ -3924,7 +3911,6 @@ The story creation is successful when:
==================== START: .bmad-core/tasks/correct-course.md ====================
<!-- Powered by BMAD™ Core -->
# Correct Course Task
## Purpose
@@ -3999,7 +3985,6 @@ The story creation is successful when:
==================== 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.
@@ -4090,7 +4075,6 @@ The LLM will:
==================== START: .bmad-core/tasks/shard-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Document Sharding Task
## Purpose
@@ -4770,7 +4754,6 @@ sections:
==================== 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.
@@ -4957,7 +4940,6 @@ Keep it action-oriented and forward-looking.]]
==================== 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.
@@ -5332,7 +5314,6 @@ After presenting the report, ask if the user wants:
==================== START: .bmad-core/data/technical-preferences.md ====================
<!-- Powered by BMAD™ Core -->
# User-Defined Preferred Patterns and Preferences
None Listed
@@ -5340,7 +5321,6 @@ None Listed
==================== START: .bmad-core/tasks/generate-ai-frontend-prompt.md ====================
<!-- Powered by BMAD™ Core -->
# Create AI Frontend Prompt Task
## Purpose
@@ -6427,7 +6407,7 @@ sections:
1. **Verify Complexity**: Confirm this enhancement requires architectural planning. For simple additions, recommend: "For simpler changes that don't require architectural planning, consider using the brownfield-create-epic or brownfield-create-story task with the Product Owner instead."
2. **REQUIRED INPUTS**:
- Completed brownfield-prd.md
- Completed prd.md
- Existing project technical documentation (from docs folder or user-provided)
- Access to existing project structure (IDE or uploaded files)
@@ -6513,8 +6493,8 @@ sections:
- **UI/UX Consistency:** {{ui_compatibility}}
- **Performance Impact:** {{performance_constraints}}
- id: tech-stack
title: Tech Stack
- id: tech-stack-alignment
title: Tech Stack Alignment
instruction: |
Ensure new components align with existing technology choices:
@@ -6676,8 +6656,8 @@ sections:
**Error Handling:** {{error_handling_strategy}}
- id: source-tree
title: Source Tree
- id: source-tree-integration
title: Source Tree Integration
instruction: |
Define how new code will integrate with existing project structure:
@@ -6746,7 +6726,7 @@ sections:
**Monitoring:** {{monitoring_approach}}
- id: coding-standards
title: Coding Standards
title: Coding Standards and Conventions
instruction: |
Ensure new code follows existing project conventions:
@@ -7932,7 +7912,6 @@ sections:
==================== 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.
@@ -8375,7 +8354,6 @@ After presenting the report, ask the user if they would like detailed analysis o
==================== START: .bmad-core/tasks/validate-next-story.md ====================
<!-- Powered by BMAD™ Core -->
# Validate Next Story Task
## Purpose
@@ -8397,7 +8375,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
### 1. Template Completeness Validation
- Load `.bmad-core/templates/story-tmpl.yaml` and extract all section headings from the template
- Load `bmad-core/templates/story-tmpl.md` and extract all section headings from the template
- **Missing sections check**: Compare story sections against template sections to verify all required sections are present
- **Placeholder validation**: Ensure no template placeholders remain unfilled (e.g., `{{EpicNum}}`, `{{role}}`, `_TBD_`)
- **Agent section verification**: Confirm all sections from template exist for future agent use
@@ -8655,7 +8633,6 @@ sections:
==================== 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.
@@ -8671,7 +8648,7 @@ First, determine the project type by checking:
2. Is this a BROWNFIELD project (enhancing existing system)?
- Look for: References to existing codebase, enhancement/modification language
- Check for: brownfield-prd.md, brownfield-architecture.md, existing system analysis
- Check for: prd.md, architecture.md, existing system analysis
3. Does the project include UI/UX components?
- Check for: frontend-architecture.md, UI/UX specifications, design files
@@ -8689,8 +8666,8 @@ For GREENFIELD projects:
For BROWNFIELD projects:
- brownfield-prd.md - The brownfield enhancement requirements
- brownfield-architecture.md - The enhancement architecture
- prd.md - The brownfield enhancement requirements
- architecture.md - The enhancement architecture
- Existing project codebase access (CRITICAL - cannot proceed without this)
- Current deployment configuration and infrastructure details
- Database schemas, API documentation, monitoring setup
@@ -9253,7 +9230,7 @@ workflow:
- Dev Agent (New Chat): Address remaining items
- Return to QA for final approval
- step: repeat_development_cycle
- repeat_development_cycle:
action: continue_for_all_stories
notes: |
Repeat story cycle (SM → Dev → QA) for all epic stories
@@ -9270,7 +9247,7 @@ workflow:
- Validate epic was completed correctly
- Document learnings and improvements
- step: workflow_end
- workflow_end:
action: project_complete
notes: |
All stories implemented and reviewed!
@@ -9500,7 +9477,7 @@ workflow:
- Dev Agent (New Chat): Address remaining items
- Return to QA for final approval
- step: repeat_development_cycle
- repeat_development_cycle:
action: continue_for_all_stories
notes: |
Repeat story cycle (SM → Dev → QA) for all epic stories
@@ -9517,7 +9494,7 @@ workflow:
- Validate epic was completed correctly
- Document learnings and improvements
- step: workflow_end
- workflow_end:
action: project_complete
notes: |
All stories implemented and reviewed!
@@ -9698,7 +9675,7 @@ workflow:
- Dev Agent (New Chat): Address remaining items
- Return to QA for final approval
- step: repeat_development_cycle
- repeat_development_cycle:
action: continue_for_all_stories
notes: |
Repeat story cycle (SM → Dev → QA) for all epic stories
@@ -9715,7 +9692,7 @@ workflow:
- Validate epic was completed correctly
- Document learnings and improvements
- step: workflow_end
- workflow_end:
action: project_complete
notes: |
All stories implemented and reviewed!
@@ -9851,12 +9828,12 @@ workflow:
condition: po_checklist_issues
notes: "If PO finds issues, return to relevant agent to fix and re-export updated documents to docs/ folder."
- step: project_setup_guidance
- project_setup_guidance:
action: guide_project_structure
condition: user_has_generated_ui
notes: "If user generated UI with v0/Lovable: For polyrepo setup, place downloaded project in separate frontend repo alongside backend repo. For monorepo, place in apps/web or packages/frontend directory. Review architecture document for specific guidance."
- step: development_order_guidance
- development_order_guidance:
action: guide_development_sequence
notes: "Based on PRD stories: If stories are frontend-heavy, start with frontend project/directory first. If backend-heavy or API-first, start with backend. For tightly coupled features, follow story sequence in monorepo setup. Reference sharded PRD epics for development order."
@@ -9924,7 +9901,7 @@ workflow:
- Dev Agent (New Chat): Address remaining items
- Return to QA for final approval
- step: repeat_development_cycle
- repeat_development_cycle:
action: continue_for_all_stories
notes: |
Repeat story cycle (SM → Dev → QA) for all epic stories
@@ -9941,7 +9918,7 @@ workflow:
- Validate epic was completed correctly
- Document learnings and improvements
- step: workflow_end
- workflow_end:
action: project_complete
notes: |
All stories implemented and reviewed!
@@ -10144,7 +10121,7 @@ workflow:
- Dev Agent (New Chat): Address remaining items
- Return to QA for final approval
- step: repeat_development_cycle
- repeat_development_cycle:
action: continue_for_all_stories
notes: |
Repeat story cycle (SM → Dev → QA) for all epic stories
@@ -10161,7 +10138,7 @@ workflow:
- Validate epic was completed correctly
- Document learnings and improvements
- step: workflow_end
- workflow_end:
action: project_complete
notes: |
All stories implemented and reviewed!
@@ -10304,7 +10281,7 @@ workflow:
condition: po_checklist_issues
notes: "If PO finds issues, return to relevant agent to fix and re-export updated documents to docs/ folder."
- step: project_setup_guidance
- project_setup_guidance:
action: guide_project_structure
condition: user_has_generated_ui
notes: "If user generated UI with v0/Lovable: For polyrepo setup, place downloaded project in separate frontend repo. For monorepo, place in apps/web or frontend/ directory. Review architecture document for specific guidance."
@@ -10373,7 +10350,7 @@ workflow:
- Dev Agent (New Chat): Address remaining items
- Return to QA for final approval
- step: repeat_development_cycle
- repeat_development_cycle:
action: continue_for_all_stories
notes: |
Repeat story cycle (SM → Dev → QA) for all epic stories
@@ -10390,7 +10367,7 @@ workflow:
- Validate epic was completed correctly
- Document learnings and improvements
- step: workflow_end
- workflow_end:
action: project_complete
notes: |
All stories implemented and reviewed!

View File

@@ -309,7 +309,6 @@ persona:
focus: Executing story tasks with precision, updating Dev Agent Record sections only, maintaining minimal context overhead
core_principles:
- CRITICAL: Story has ALL info you will need aside from what you loaded during the startup commands. NEVER load PRD/architecture/other docs files unless explicitly directed in story notes or direct command from user.
- CRITICAL: ALWAYS check current folder structure before starting your story tasks, don't create new working directory if it already exists. Create new one when you're sure it's a brand new project.
- CRITICAL: ONLY update story file Dev Agent Record sections (checkboxes/Debug Log/Completion Notes/Change Log)
- CRITICAL: FOLLOW THE develop-story command when the user tells you to implement the story
- Numbered Options - Always use numbered lists when presenting choices to the user
@@ -354,8 +353,7 @@ agent:
id: qa
title: Test Architect & Quality Advisor
icon: 🧪
whenToUse: |
Use for comprehensive test architecture review, quality gate decisions,
whenToUse: Use for comprehensive test architecture review, quality gate decisions,
and code improvement. Provides thorough analysis including requirements
traceability, risk assessment, and test strategy.
Advisory only - teams choose their quality bar.
@@ -411,7 +409,6 @@ dependencies:
==================== START: .bmad-core/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -533,7 +530,6 @@ Choose a number (0-8) or 9 to proceed:
==================== START: .bmad-core/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -639,7 +635,6 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-core/tasks/kb-mode-interaction.md ====================
<!-- Powered by BMAD™ Core -->
# KB Mode Interaction Task
## Purpose
@@ -719,7 +714,6 @@ Or ask me about anything else related to BMad-Method!
==================== START: .bmad-core/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMAD™ Knowledge Base
## Overview
@@ -822,7 +816,6 @@ npx bmad-method install
- **Cline**: VS Code extension with AI features
- **Roo Code**: Web-based IDE with agent support
- **GitHub Copilot**: VS Code extension with AI peer programming assistant
- **Auggie CLI (Augment Code)**: AI-powered development environment
**Note for VS Code Users**: BMAD-METHOD™ assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo.
@@ -901,7 +894,7 @@ npx bmad-method install
## Core Configuration (core-config.yaml)
**New in V4**: The `bmad-core/core-config.yaml` file is a critical innovation that enables BMad to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
**New in V4**: The `.bmad-core/core-config.yaml` file is a critical innovation that enables BMad to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
### What is core-config.yaml?
@@ -1531,7 +1524,6 @@ Use the **expansion-creator** pack to build your own:
==================== START: .bmad-core/data/elicitation-methods.md ====================
<!-- Powered by BMAD™ Core -->
# Elicitation Methods Data
## Core Reflective Methods
@@ -1690,7 +1682,6 @@ Use the **expansion-creator** pack to build your own:
==================== START: .bmad-core/utils/workflow-management.md ====================
<!-- Powered by BMAD™ Core -->
# Workflow Management
Enables BMad orchestrator to manage and execute team workflows.
@@ -1764,7 +1755,6 @@ Agents should be workflow-aware: know active workflow, their role, access artifa
==================== START: .bmad-core/tasks/correct-course.md ====================
<!-- Powered by BMAD™ Core -->
# Correct Course Task
## Purpose
@@ -1839,7 +1829,6 @@ Agents should be workflow-aware: know active workflow, their role, access artifa
==================== 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.
@@ -1930,7 +1919,6 @@ The LLM will:
==================== START: .bmad-core/tasks/shard-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Document Sharding Task
## Purpose
@@ -2120,7 +2108,6 @@ Document sharded successfully:
==================== START: .bmad-core/tasks/validate-next-story.md ====================
<!-- Powered by BMAD™ Core -->
# Validate Next Story Task
## Purpose
@@ -2142,7 +2129,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
### 1. Template Completeness Validation
- Load `.bmad-core/templates/story-tmpl.yaml` and extract all section headings from the template
- Load `bmad-core/templates/story-tmpl.md` and extract all section headings from the template
- **Missing sections check**: Compare story sections against template sections to verify all required sections are present
- **Placeholder validation**: Ensure no template placeholders remain unfilled (e.g., `{{EpicNum}}`, `{{role}}`, `_TBD_`)
- **Agent section verification**: Confirm all sections from template exist for future agent use
@@ -2400,7 +2387,6 @@ sections:
==================== 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.
@@ -2587,7 +2573,6 @@ Keep it action-oriented and forward-looking.]]
==================== 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.
@@ -2603,7 +2588,7 @@ First, determine the project type by checking:
2. Is this a BROWNFIELD project (enhancing existing system)?
- Look for: References to existing codebase, enhancement/modification language
- Check for: brownfield-prd.md, brownfield-architecture.md, existing system analysis
- Check for: prd.md, architecture.md, existing system analysis
3. Does the project include UI/UX components?
- Check for: frontend-architecture.md, UI/UX specifications, design files
@@ -2621,8 +2606,8 @@ For GREENFIELD projects:
For BROWNFIELD projects:
- brownfield-prd.md - The brownfield enhancement requirements
- brownfield-architecture.md - The enhancement architecture
- prd.md - The brownfield enhancement requirements
- architecture.md - The enhancement architecture
- Existing project codebase access (CRITICAL - cannot proceed without this)
- Current deployment configuration and infrastructure details
- Database schemas, API documentation, monitoring setup
@@ -3024,7 +3009,6 @@ After presenting the report, ask if the user wants:
==================== START: .bmad-core/tasks/create-next-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Next Story Task
## Purpose
@@ -3141,7 +3125,6 @@ ALWAYS cite source documents: `[Source: architecture/{filename}.md#{section}]`
==================== 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.
@@ -3299,7 +3282,6 @@ Be pragmatic - perfect documentation doesn't exist, but it must be enough to pro
==================== 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.
@@ -3316,8 +3298,8 @@ Implement fixes based on QA results (gate and assessments) for a specific story.
```yaml
required:
- story_id: '{epic}.{story}' # e.g., "2.2"
- qa_root: from `bmad-core/core-config.yaml` key `qa.qaLocation` (e.g., `docs/project/qa`)
- story_root: from `bmad-core/core-config.yaml` key `devStoryLocation` (e.g., `docs/project/stories`)
- qa_root: from `.bmad-core/core-config.yaml` key `qa.qaLocation` (e.g., `docs/project/qa`)
- story_root: from `.bmad-core/core-config.yaml` key `devStoryLocation` (e.g., `docs/project/stories`)
optional:
- story_title: '{title}' # derive from story H1 if missing
@@ -3345,7 +3327,7 @@ optional:
### 0) Load Core Config & Locate Story
- Read `bmad-core/core-config.yaml` and resolve `qa_root` and `story_root`
- Read `.bmad-core/core-config.yaml` and resolve `qa_root` and `story_root`
- Locate story file in `{story_root}/{epic}.{story}.*.md`
- HALT if missing and ask for correct story id/path
@@ -3413,7 +3395,7 @@ Status Rule:
## Blocking Conditions
- Missing `bmad-core/core-config.yaml`
- Missing `.bmad-core/core-config.yaml`
- Story file not found for `story_id`
- No QA artifacts found (neither gate nor assessments)
- HALT and request QA to generate at least a gate file (or proceed only with clear developer-provided fix list)
@@ -3452,7 +3434,6 @@ Fix plan:
==================== START: .bmad-core/checklists/story-dod-checklist.md ====================
<!-- Powered by BMAD™ Core -->
# Story Definition of Done (DoD) Checklist
## Instructions for Developer Agent
@@ -3551,7 +3532,6 @@ Be honest - it's better to flag issues now than have them discovered later.]]
==================== 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.
@@ -3561,11 +3541,11 @@ Quick NFR validation focused on the core four: security, performance, reliabilit
```yaml
required:
- story_id: '{epic}.{story}' # e.g., "1.3"
- story_path: `bmad-core/core-config.yaml` for the `devStoryLocation`
- story_path: `.bmad-core/core-config.yaml` for the `devStoryLocation`
optional:
- architecture_refs: `bmad-core/core-config.yaml` for the `architecture.architectureFile`
- technical_preferences: `bmad-core/core-config.yaml` for the `technicalPreferences`
- architecture_refs: `.bmad-core/core-config.yaml` for the `architecture.architectureFile`
- technical_preferences: `.bmad-core/core-config.yaml` for the `technicalPreferences`
- acceptance_criteria: From story file
```
@@ -3899,7 +3879,6 @@ performance_deep_dive:
==================== 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.
@@ -3916,7 +3895,7 @@ Generate a standalone quality gate file that provides a clear pass/fail decision
## Gate File Location
**ALWAYS** check the `bmad-core/core-config.yaml` for the `qa.qaLocation/gates`
**ALWAYS** check the `.bmad-core/core-config.yaml` for the `qa.qaLocation/gates`
Slug rules:
@@ -4026,7 +4005,7 @@ waiver:
## Output Requirements
1. **ALWAYS** create gate file at: `qa.qaLocation/gates` from `bmad-core/core-config.yaml`
1. **ALWAYS** create gate file at: `qa.qaLocation/gates` from `.bmad-core/core-config.yaml`
2. **ALWAYS** append this exact format to story's QA Results section:
```text
@@ -4065,7 +4044,6 @@ Gate: CONCERNS → qa.qaLocation/gates/{epic}.{story}-{slug}.yml
==================== 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.
@@ -4252,7 +4230,7 @@ NFR assessment: qa.qaLocation/assessments/{epic}.{story}-nfr-{YYYYMMDD}.md
**Template and Directory:**
- Render from `../templates/qa-gate-tmpl.yaml`
- Create directory defined in `qa.qaLocation/gates` (see `bmad-core/core-config.yaml`) if missing
- Create directory defined in `qa.qaLocation/gates` (see `.bmad-core/core-config.yaml`) if missing
- Save to: `qa.qaLocation/gates/{epic}.{story}-{slug}.yml`
Gate file structure:
@@ -4384,7 +4362,6 @@ After review:
==================== 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.
@@ -4742,7 +4719,6 @@ Risk profile: qa.qaLocation/assessments/{epic}.{story}-risk-{YYYYMMDD}.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.
@@ -4921,7 +4897,6 @@ Before finalizing, verify:
==================== 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.
@@ -5296,7 +5271,6 @@ optional_fields_examples:
==================== START: .bmad-core/data/technical-preferences.md ====================
<!-- Powered by BMAD™ Core -->
# User-Defined Preferred Patterns and Preferences
None Listed

View File

@@ -437,7 +437,6 @@ dependencies:
==================== START: .bmad-core/tasks/advanced-elicitation.md ====================
<!-- Powered by BMAD™ Core -->
# Advanced Elicitation Task
## Purpose
@@ -559,7 +558,6 @@ Choose a number (0-8) or 9 to proceed:
==================== START: .bmad-core/tasks/create-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Create Document from Template (YAML Driven)
## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -665,7 +663,6 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
==================== START: .bmad-core/tasks/kb-mode-interaction.md ====================
<!-- Powered by BMAD™ Core -->
# KB Mode Interaction Task
## Purpose
@@ -745,7 +742,6 @@ Or ask me about anything else related to BMad-Method!
==================== START: .bmad-core/data/bmad-kb.md ====================
<!-- Powered by BMAD™ Core -->
# BMAD™ Knowledge Base
## Overview
@@ -848,7 +844,6 @@ npx bmad-method install
- **Cline**: VS Code extension with AI features
- **Roo Code**: Web-based IDE with agent support
- **GitHub Copilot**: VS Code extension with AI peer programming assistant
- **Auggie CLI (Augment Code)**: AI-powered development environment
**Note for VS Code Users**: BMAD-METHOD™ assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo.
@@ -927,7 +922,7 @@ npx bmad-method install
## Core Configuration (core-config.yaml)
**New in V4**: The `bmad-core/core-config.yaml` file is a critical innovation that enables BMad to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
**New in V4**: The `.bmad-core/core-config.yaml` file is a critical innovation that enables BMad to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
### What is core-config.yaml?
@@ -1557,7 +1552,6 @@ Use the **expansion-creator** pack to build your own:
==================== START: .bmad-core/data/elicitation-methods.md ====================
<!-- Powered by BMAD™ Core -->
# Elicitation Methods Data
## Core Reflective Methods
@@ -1716,7 +1710,6 @@ Use the **expansion-creator** pack to build your own:
==================== START: .bmad-core/utils/workflow-management.md ====================
<!-- Powered by BMAD™ Core -->
# Workflow Management
Enables BMad orchestrator to manage and execute team workflows.
@@ -1790,7 +1783,6 @@ Agents should be workflow-aware: know active workflow, their role, access artifa
==================== 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.
@@ -2073,7 +2065,6 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
==================== START: .bmad-core/tasks/document-project.md ====================
<!-- Powered by BMAD™ Core -->
# Document an Existing Project
## Purpose
@@ -2420,11 +2411,10 @@ Apply the advanced elicitation task after major sections to refine based on user
==================== END: .bmad-core/tasks/document-project.md ====================
==================== START: .bmad-core/tasks/facilitate-brainstorming-session.md ====================
## <!-- Powered by BMAD™ Core -->
<!-- Powered by BMAD™ Core -->
---
docOutputLocation: docs/brainstorming-session-results.md
template: '.bmad-core/templates/brainstorming-output-tmpl.yaml'
---
# Facilitate Brainstorming Session Task
@@ -3512,7 +3502,6 @@ sections:
==================== START: .bmad-core/data/brainstorming-techniques.md ====================
<!-- Powered by BMAD™ Core -->
# Brainstorming Techniques Data
## Creative Expansion
@@ -3553,7 +3542,6 @@ sections:
==================== START: .bmad-core/tasks/brownfield-create-epic.md ====================
<!-- Powered by BMAD™ Core -->
# Create Brownfield Epic Task
## Purpose
@@ -3718,7 +3706,6 @@ The epic creation is successful when:
==================== START: .bmad-core/tasks/brownfield-create-story.md ====================
<!-- Powered by BMAD™ Core -->
# Create Brownfield Story Task
## Purpose
@@ -3870,7 +3857,6 @@ The story creation is successful when:
==================== START: .bmad-core/tasks/correct-course.md ====================
<!-- Powered by BMAD™ Core -->
# Correct Course Task
## Purpose
@@ -3945,7 +3931,6 @@ The story creation is successful when:
==================== 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.
@@ -4036,7 +4021,6 @@ The LLM will:
==================== START: .bmad-core/tasks/shard-doc.md ====================
<!-- Powered by BMAD™ Core -->
# Document Sharding Task
## Purpose
@@ -4716,7 +4700,6 @@ sections:
==================== 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.
@@ -4903,7 +4886,6 @@ Keep it action-oriented and forward-looking.]]
==================== 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.
@@ -5278,7 +5260,6 @@ After presenting the report, ask if the user wants:
==================== START: .bmad-core/data/technical-preferences.md ====================
<!-- Powered by BMAD™ Core -->
# User-Defined Preferred Patterns and Preferences
None Listed
@@ -5964,7 +5945,7 @@ sections:
1. **Verify Complexity**: Confirm this enhancement requires architectural planning. For simple additions, recommend: "For simpler changes that don't require architectural planning, consider using the brownfield-create-epic or brownfield-create-story task with the Product Owner instead."
2. **REQUIRED INPUTS**:
- Completed brownfield-prd.md
- Completed prd.md
- Existing project technical documentation (from docs folder or user-provided)
- Access to existing project structure (IDE or uploaded files)
@@ -6050,8 +6031,8 @@ sections:
- **UI/UX Consistency:** {{ui_compatibility}}
- **Performance Impact:** {{performance_constraints}}
- id: tech-stack
title: Tech Stack
- id: tech-stack-alignment
title: Tech Stack Alignment
instruction: |
Ensure new components align with existing technology choices:
@@ -6213,8 +6194,8 @@ sections:
**Error Handling:** {{error_handling_strategy}}
- id: source-tree
title: Source Tree
- id: source-tree-integration
title: Source Tree Integration
instruction: |
Define how new code will integrate with existing project structure:
@@ -6283,7 +6264,7 @@ sections:
**Monitoring:** {{monitoring_approach}}
- id: coding-standards
title: Coding Standards
title: Coding Standards and Conventions
instruction: |
Ensure new code follows existing project conventions:
@@ -7469,7 +7450,6 @@ sections:
==================== 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.
@@ -7912,7 +7892,6 @@ After presenting the report, ask the user if they would like detailed analysis o
==================== START: .bmad-core/tasks/validate-next-story.md ====================
<!-- Powered by BMAD™ Core -->
# Validate Next Story Task
## Purpose
@@ -7934,7 +7913,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
### 1. Template Completeness Validation
- Load `.bmad-core/templates/story-tmpl.yaml` and extract all section headings from the template
- Load `bmad-core/templates/story-tmpl.md` and extract all section headings from the template
- **Missing sections check**: Compare story sections against template sections to verify all required sections are present
- **Placeholder validation**: Ensure no template placeholders remain unfilled (e.g., `{{EpicNum}}`, `{{role}}`, `_TBD_`)
- **Agent section verification**: Confirm all sections from template exist for future agent use
@@ -8192,7 +8171,6 @@ sections:
==================== 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.
@@ -8208,7 +8186,7 @@ First, determine the project type by checking:
2. Is this a BROWNFIELD project (enhancing existing system)?
- Look for: References to existing codebase, enhancement/modification language
- Check for: brownfield-prd.md, brownfield-architecture.md, existing system analysis
- Check for: prd.md, architecture.md, existing system analysis
3. Does the project include UI/UX components?
- Check for: frontend-architecture.md, UI/UX specifications, design files
@@ -8226,8 +8204,8 @@ For GREENFIELD projects:
For BROWNFIELD projects:
- brownfield-prd.md - The brownfield enhancement requirements
- brownfield-architecture.md - The enhancement architecture
- prd.md - The brownfield enhancement requirements
- architecture.md - The enhancement architecture
- Existing project codebase access (CRITICAL - cannot proceed without this)
- Current deployment configuration and infrastructure details
- Database schemas, API documentation, monitoring setup
@@ -8744,7 +8722,7 @@ workflow:
- Dev Agent (New Chat): Address remaining items
- Return to QA for final approval
- step: repeat_development_cycle
- repeat_development_cycle:
action: continue_for_all_stories
notes: |
Repeat story cycle (SM → Dev → QA) for all epic stories
@@ -8761,7 +8739,7 @@ workflow:
- Validate epic was completed correctly
- Document learnings and improvements
- step: workflow_end
- workflow_end:
action: project_complete
notes: |
All stories implemented and reviewed!
@@ -8946,7 +8924,7 @@ workflow:
- Dev Agent (New Chat): Address remaining items
- Return to QA for final approval
- step: repeat_development_cycle
- repeat_development_cycle:
action: continue_for_all_stories
notes: |
Repeat story cycle (SM → Dev → QA) for all epic stories
@@ -8963,7 +8941,7 @@ workflow:
- Validate epic was completed correctly
- Document learnings and improvements
- step: workflow_end
- workflow_end:
action: project_complete
notes: |
All stories implemented and reviewed!

View File

@@ -187,6 +187,53 @@ If you want to do the planning on the web with Claude (Sonnet 4 or Opus), Gemini
npx bmad-method install
```
### OpenCode
BMAD integrates with OpenCode via a project-level `opencode.jsonc`/`opencode.json` (JSON-only, no Markdown fallback).
- Installation:
- Run `npx bmad-method install` and choose `OpenCode` in the IDE list.
- The installer will detect an existing `opencode.jsonc`/`opencode.json` or create a minimal `opencode.jsonc` if missing.
- It will:
- Ensure `instructions` includes `.bmad-core/core-config.yaml` (and each selected expansion packs `config.yaml`).
- Merge BMAD agents and commands using file references (`{file:./.bmad-core/...}`), idempotently.
- Preserve other top-level fields and user-defined entries.
- Prefixes and collisions:
- You can opt-in to prefix agent keys with `bmad-` and command keys with `bmad:tasks:` to avoid name collisions.
- If a key already exists and is not BMAD-managed, the installer will skip it and suggest enabling prefixes.
- What gets added:
- `instructions`: `.bmad-core/core-config.yaml` plus any selected expansion pack `config.yaml` files.
- `agent`: BMAD agents from core and selected packs.
- `prompt`: `{file:./.bmad-core/agents/<id>.md}` (or pack path)
- `mode`: `primary` for orchestrators, otherwise `all`
- `tools`: `{ write: true, edit: true, bash: true }`
- `description`: extracted from the agents `whenToUse`
- `command`: BMAD tasks from core and selected packs.
- `template`: `{file:./.bmad-core/tasks/<id>.md}` (or pack path)
- `description`: extracted from the tasks “Purpose” section
- Selected Packages Only:
- The installer includes agents and tasks only from the packages you selected in the earlier step (core and chosen packs).
- Refresh after changes:
- Re-run:
```bash
npx bmad-method install -f -i opencode
```
- The installer safely updates entries without duplication and preserves your custom fields and comments.
- Optional convenience script:
- You can add a script to your projects `package.json` for quick refreshes:
```json
{
"scripts": {
"bmad:opencode": "bmad-method install -f -i opencode"
}
}
```
### Codex (CLI & Web)
BMAD integrates with OpenAI Codex via `AGENTS.md` and committed core agent files.
@@ -501,7 +548,7 @@ When creating custom web bundles or uploading to AI platforms, include your `tec
## Core Configuration
The `bmad-core/core-config.yaml` file is a critical config that enables BMad to work seamlessly with differing project structures, more options will be made available in the future. Currently the most important is the devLoadAlwaysFiles list section in the yaml.
The `.bmad-core/core-config.yaml` file is a critical config that enables BMad to work seamlessly with differing project structures, more options will be made available in the future. Currently the most important is the devLoadAlwaysFiles list section in the yaml.
### Developer Context Files

View File

@@ -31,7 +31,7 @@ activation-instructions:
- Assess user goal against available agents and workflows in this bundle
- If clear match to an agent's expertise, suggest transformation with *agent command
- If project-oriented, suggest *workflow-guidance to explore options
- Load resources only when needed - never pre-load (Exception: Read `bmad-core/core-config.yaml` during activation)
- Load resources only when needed - never pre-load (Exception: Read `.bmad-core/core-config.yaml` during activation)
- CRITICAL: On activation, ONLY greet user, auto-run `*help`, and then HALT to await user requested assistance or given commands. ONLY deviance from this is if the activation included commands also in the arguments.
agent:
name: BMad Orchestrator

View File

@@ -34,8 +34,7 @@ agent:
id: game-qa
title: Game Test Architect & TDD Enforcer (Godot)
icon: 🎮🧪
whenToUse: |
Use for Godot game testing architecture, test-driven development enforcement,
whenToUse: Use for Godot game testing architecture, test-driven development enforcement,
performance validation, and gameplay quality assurance. Ensures all code is
test-first, performance targets are met, and player experience is validated.
Enforces GUT for GDScript and GoDotTest/GodotTestDriver for C# with TDD practices.

View File

@@ -50,7 +50,7 @@ optional:
### 0) Load Core Config & Locate Story
- Read `bmad-core/core-config.yaml` and resolve `qa_root`, `story_root`, and `project_root`
- Read `.bmad-core/core-config.yaml` and resolve `qa_root`, `story_root`, and `project_root`
- Locate story file in `{story_root}/{epic}.{story}.*.md`
- HALT if missing and ask for correct story id/path
@@ -150,7 +150,7 @@ Status Rule:
## Blocking Conditions
- Missing `bmad-core/core-config.yaml`
- Missing `.bmad-core/core-config.yaml`
- Story file not found for `story_id`
- No QA artifacts found (neither gate nor assessments)
- HALT and request QA to generate at least a gate file (or proceed only with clear developer-provided fix list)

47
package-lock.json generated
View File

@@ -1,17 +1,18 @@
{
"name": "bmad-method",
"version": "4.42.1",
"version": "4.43.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "bmad-method",
"version": "4.42.1",
"version": "4.43.0",
"license": "MIT",
"dependencies": {
"@kayvan/markdown-tree-parser": "^1.6.1",
"chalk": "^4.1.2",
"commander": "^14.0.0",
"comment-json": "^4.2.5",
"fs-extra": "^11.3.1",
"glob": "^11.0.3",
"ignore": "^7.0.5",
@@ -2950,6 +2951,12 @@
"dev": true,
"license": "MIT"
},
"node_modules/array-timsort": {
"version": "1.0.3",
"resolved": "https://registry.npmjs.org/array-timsort/-/array-timsort-1.0.3.tgz",
"integrity": "sha512-/+3GRL7dDAGEfM6TseQk/U+mi18TU2Ms9I3UlLdUMhz2hbvGNTKdj9xniwXfUqgYhHxRx0+8UnKkvlNwVU+cWQ==",
"license": "MIT"
},
"node_modules/array-union": {
"version": "2.1.0",
"resolved": "https://registry.npmjs.org/array-union/-/array-union-2.1.0.tgz",
@@ -3674,6 +3681,22 @@
"node": ">=20"
}
},
"node_modules/comment-json": {
"version": "4.2.5",
"resolved": "https://registry.npmjs.org/comment-json/-/comment-json-4.2.5.tgz",
"integrity": "sha512-bKw/r35jR3HGt5PEPm1ljsQQGyCrR8sFGNiN5L+ykDHdpO8Smxkrkla9Yi6NkQyUrb8V54PGhfMs6NrIwtxtdw==",
"license": "MIT",
"dependencies": {
"array-timsort": "^1.0.3",
"core-util-is": "^1.0.3",
"esprima": "^4.0.1",
"has-own-prop": "^2.0.0",
"repeat-string": "^1.6.1"
},
"engines": {
"node": ">= 6"
}
},
"node_modules/compare-func": {
"version": "2.0.0",
"resolved": "https://registry.npmjs.org/compare-func/-/compare-func-2.0.0.tgz",
@@ -3806,7 +3829,6 @@
"version": "1.0.3",
"resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.3.tgz",
"integrity": "sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==",
"dev": true,
"license": "MIT"
},
"node_modules/cosmiconfig": {
@@ -4845,7 +4867,6 @@
"version": "4.0.1",
"resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz",
"integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==",
"dev": true,
"license": "BSD-2-Clause",
"bin": {
"esparse": "bin/esparse.js",
@@ -5502,6 +5523,15 @@
"node": ">=8"
}
},
"node_modules/has-own-prop": {
"version": "2.0.0",
"resolved": "https://registry.npmjs.org/has-own-prop/-/has-own-prop-2.0.0.tgz",
"integrity": "sha512-Pq0h+hvsVm6dDEa8x82GnLSYHOzNDt7f0ddFa3FqcQlgzEiptPqL+XrOJNavjOzSYiYWIrgeVYYgGlLmnxwilQ==",
"license": "MIT",
"engines": {
"node": ">=8"
}
},
"node_modules/highlight.js": {
"version": "10.7.3",
"resolved": "https://registry.npmjs.org/highlight.js/-/highlight.js-10.7.3.tgz",
@@ -12050,6 +12080,15 @@
"url": "https://opencollective.com/unified"
}
},
"node_modules/repeat-string": {
"version": "1.6.1",
"resolved": "https://registry.npmjs.org/repeat-string/-/repeat-string-1.6.1.tgz",
"integrity": "sha512-PV0dzCYDNfRi1jCDbJzpW7jNNDRuCOG/jI5ctQcGKt/clZD+YcPS3yIlWuTJMmESC8aevCFmWJy5wjAFgNqN6w==",
"license": "MIT",
"engines": {
"node": ">=0.10"
}
},
"node_modules/require-directory": {
"version": "2.1.1",
"resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz",

View File

@@ -1,7 +1,7 @@
{
"$schema": "https://json.schemastore.org/package.json",
"name": "bmad-method",
"version": "4.43.1",
"version": "4.44.0",
"description": "Breakthrough Method of Agile AI-driven Development",
"keywords": [
"agile",
@@ -75,6 +75,7 @@
"@kayvan/markdown-tree-parser": "^1.6.1",
"chalk": "^4.1.2",
"commander": "^14.0.0",
"comment-json": "^4.2.5",
"fs-extra": "^11.3.1",
"glob": "^11.0.3",
"ignore": "^7.0.5",

View File

@@ -49,7 +49,7 @@ program
.option('-d, --directory <path>', 'Installation directory')
.option(
'-i, --ide <ide...>',
'Configure for specific IDE(s) - can specify multiple (cursor, claude-code, windsurf, trae, roo, kilo, cline, gemini, qwen-code, github-copilot, codex, codex-web, auggie-cli, iflow-cli, other)',
'Configure for specific IDE(s) - can specify multiple (cursor, claude-code, windsurf, trae, roo, kilo, cline, gemini, qwen-code, github-copilot, codex, codex-web, auggie-cli, iflow-cli, opencode, other)',
)
.option(
'-e, --expansion-packs <packs...>',
@@ -410,6 +410,7 @@ async function promptInstallation() {
{ name: 'Auggie CLI (Augment Code)', value: 'auggie-cli' },
{ name: 'Codex CLI', value: 'codex' },
{ name: 'Codex Web', value: 'codex-web' },
{ name: 'OpenCode', value: 'opencode' },
],
},
]);
@@ -478,6 +479,43 @@ async function promptInstallation() {
answers.githubCopilotConfig = { configChoice };
}
// Configure OpenCode immediately if selected
if (ides.includes('opencode')) {
console.log(chalk.cyan('\n⚙ OpenCode Configuration'));
console.log(
chalk.dim(
'OpenCode will include agents and tasks from the packages you selected above; choose optional key prefixes (defaults: no prefixes).\n',
),
);
const { useAgentPrefix, useCommandPrefix } = await inquirer.prompt([
{
type: 'confirm',
name: 'useAgentPrefix',
message: "Prefix agent keys with 'bmad-'? (e.g., 'bmad-dev')",
default: true,
},
{
type: 'confirm',
name: 'useCommandPrefix',
message: "Prefix command keys with 'bmad:tasks:'? (e.g., 'bmad:tasks:create-doc')",
default: true,
},
]);
answers.openCodeConfig = {
opencode: {
useAgentPrefix,
useCommandPrefix,
},
// pass previously selected packages so IDE setup only applies those
selectedPackages: {
includeCore: selectedItems.includes('bmad-core'),
packs: answers.expansionPacks || [],
},
};
}
// Configure Auggie CLI (Augment Code) immediately if selected
if (ides.includes('auggie-cli')) {
console.log(chalk.cyan('\n📍 Auggie CLI Location Configuration'));

View File

@@ -121,15 +121,15 @@ ide-configurations:
qwen-code:
name: Qwen Code
rule-dir: .qwen/bmad-method/
format: single-file
command-suffix: .md
rule-dir: .qwen/commands/BMad/
format: multi-file
command-suffix: .toml
instructions: |
# To use BMad agents with Qwen Code:
# 1. The installer creates a .qwen/bmad-method/ directory in your project.
# 2. It concatenates all agent files into a single QWEN.md file.
# 3. Simply mention the agent in your prompt (e.g., "As *dev, ...").
# 4. The Qwen Code CLI will automatically have the context for that agent.
# 1. The installer creates a `BMad` folder in `.qwen/commands`.
# 2. This adds custom commands for each agent and task.
# 3. Type /BMad:agents:<agent-name> (e.g., "/BMad:agents:dev", "/BMad:agents:pm") or /BMad:tasks:<task-name> (e.g., "/BMad:tasks:create-doc").
# 4. The agent will adopt that persona for the conversation or perform the task.
auggie-cli:
name: Auggie CLI (Augment Code)
@@ -171,3 +171,14 @@ ide-configurations:
# 2. Commit `.bmad-core/` and `AGENTS.md` to your repository.
# 3. Open the repo in Codex Web and reference agents naturally (e.g., "As dev, ...").
# 4. Re-run this installer to refresh agent sections when the core changes.
opencode:
name: OpenCode CLI
format: jsonc-config
file: opencode.jsonc
instructions: |
# To use BMAD agents with OpenCode CLI:
# 1. The installer creates/updates `opencode.jsonc` at your project root.
# 2. It ensures the BMAD core instructions file is referenced: `./.bmad-core/core-config.yaml`.
# 3. If an existing `opencode.json` or `opencode.jsonc` is present, it is preserved and only `instructions` are minimally merged.
# 4. Run `opencode` in this project to use your configured agents and commands.

View File

@@ -3,6 +3,7 @@ const fs = require('fs-extra');
const yaml = require('js-yaml');
const chalk = require('chalk');
const inquirer = require('inquirer');
const cjson = require('comment-json');
const fileManager = require('./file-manager');
const configLoader = require('./config-loader');
const { extractYamlFromAgent } = require('../../lib/yaml-utils');
@@ -44,6 +45,9 @@ class IdeSetup extends BaseIdeSetup {
case 'cursor': {
return this.setupCursor(installDir, selectedAgent);
}
case 'opencode': {
return this.setupOpenCode(installDir, selectedAgent, spinner, preConfiguredSettings);
}
case 'claude-code': {
return this.setupClaudeCode(installDir, selectedAgent);
}
@@ -93,6 +97,643 @@ class IdeSetup extends BaseIdeSetup {
}
}
async setupOpenCode(installDir, selectedAgent, spinner = null, preConfiguredSettings = null) {
// Minimal JSON-only integration per plan:
// - If opencode.json or opencode.jsonc exists: only ensure instructions include .bmad-core/core-config.yaml
// - If none exists: create minimal opencode.jsonc with $schema and instructions array including that file
const jsonPath = path.join(installDir, 'opencode.json');
const jsoncPath = path.join(installDir, 'opencode.jsonc');
const hasJson = await fileManager.pathExists(jsonPath);
const hasJsonc = await fileManager.pathExists(jsoncPath);
// Determine key prefix preferences (with sensible defaults)
// Defaults: non-prefixed (agents = "dev", commands = "create-doc")
let useAgentPrefix = false;
let useCommandPrefix = false;
// Allow pre-configuration (if passed) to skip prompts
const pre = preConfiguredSettings && preConfiguredSettings.opencode;
if (pre && typeof pre.useAgentPrefix === 'boolean') useAgentPrefix = pre.useAgentPrefix;
if (pre && typeof pre.useCommandPrefix === 'boolean') useCommandPrefix = pre.useCommandPrefix;
// If no pre-config and in interactive mode, prompt the user
if (!pre) {
// Pause spinner during prompts if active
let spinnerWasActive = false;
if (spinner && spinner.isSpinning) {
spinner.stop();
spinnerWasActive = true;
}
try {
const resp = await inquirer.prompt([
{
type: 'confirm',
name: 'useAgentPrefix',
message:
"Prefix agent keys with 'bmad-'? (Recommended to avoid collisions, e.g., 'bmad-dev')",
default: true,
},
{
type: 'confirm',
name: 'useCommandPrefix',
message:
"Prefix command keys with 'bmad:tasks:'? (Recommended, e.g., 'bmad:tasks:create-doc')",
default: true,
},
]);
useAgentPrefix = resp.useAgentPrefix;
useCommandPrefix = resp.useCommandPrefix;
} catch {
// Keep defaults if prompt fails or is not interactive
} finally {
if (spinner && spinnerWasActive) spinner.start();
}
}
const ensureInstructionRef = (obj) => {
const preferred = '.bmad-core/core-config.yaml';
const alt = './.bmad-core/core-config.yaml';
if (!obj.instructions) obj.instructions = [];
if (!Array.isArray(obj.instructions)) obj.instructions = [obj.instructions];
// Normalize alternative form (with './') to preferred without './'
obj.instructions = obj.instructions.map((it) =>
typeof it === 'string' && it === alt ? preferred : it,
);
const hasPreferred = obj.instructions.some(
(it) => typeof it === 'string' && it === preferred,
);
if (!hasPreferred) obj.instructions.push(preferred);
return obj;
};
const mergeBmadAgentsAndCommands = async (configObj) => {
// Ensure objects exist
if (!configObj.agent || typeof configObj.agent !== 'object') configObj.agent = {};
if (!configObj.command || typeof configObj.command !== 'object') configObj.command = {};
if (!configObj.instructions) configObj.instructions = [];
if (!Array.isArray(configObj.instructions)) configObj.instructions = [configObj.instructions];
// Track a concise summary of changes
const summary = {
target: null,
created: false,
agentsAdded: 0,
agentsUpdated: 0,
agentsSkipped: 0,
commandsAdded: 0,
commandsUpdated: 0,
commandsSkipped: 0,
};
// Determine package scope: previously SELECTED packages in installer UI
const selectedPackages = preConfiguredSettings?.selectedPackages || {
includeCore: true,
packs: [],
};
// Helper: ensure an instruction path is present without './' prefix, de-duplicating './' variants
const ensureInstructionPath = (pathNoDot) => {
const withDot = `./${pathNoDot}`;
// Normalize any existing './' variant to non './'
configObj.instructions = configObj.instructions.map((it) =>
typeof it === 'string' && it === withDot ? pathNoDot : it,
);
const has = configObj.instructions.some((it) => typeof it === 'string' && it === pathNoDot);
if (!has) configObj.instructions.push(pathNoDot);
};
// Helper: detect orchestrator agents to set as primary mode
const isOrchestratorAgent = (agentId) => /(^|-)orchestrator$/i.test(agentId);
// Helper: extract whenToUse string from an agent markdown file
const extractWhenToUseFromFile = async (absPath) => {
try {
const raw = await fileManager.readFile(absPath);
const yamlMatch = raw.match(/```ya?ml\r?\n([\s\S]*?)```/);
const yamlBlock = yamlMatch ? yamlMatch[1].trim() : null;
if (!yamlBlock) return null;
// Try quoted first, then unquoted
const quoted = yamlBlock.match(/whenToUse:\s*"([^"]+)"/i);
if (quoted && quoted[1]) return quoted[1].trim();
const unquoted = yamlBlock.match(/whenToUse:\s*([^\n\r]+)/i);
if (unquoted && unquoted[1]) return unquoted[1].trim();
} catch {
// ignore
}
return null;
};
// Helper: extract Purpose string from a task file (YAML fenced block, Markdown heading, or inline 'Purpose:')
const extractTaskPurposeFromFile = async (absPath) => {
const cleanupAndSummarize = (text) => {
if (!text) return null;
let t = String(text);
// Drop code fences and HTML comments
t = t.replaceAll(/```[\s\S]*?```/g, '');
t = t.replaceAll(/<!--([\s\S]*?)-->/g, '');
// Normalize line endings
t = t.replaceAll(/\r\n?/g, '\n');
// Take the first non-empty paragraph
const paragraphs = t.split(/\n\s*\n/g).map((p) => p.trim());
let first = paragraphs.find((p) => p.length > 0) || '';
// Remove leading list markers, quotes, and headings remnants
first = first.replaceAll(/^\s*[>*-]\s+/gm, '');
first = first.replaceAll(/^#{1,6}\s+/gm, '');
// Strip simple Markdown formatting
first = first.replaceAll(/\*\*([^*]+)\*\*/g, '$1').replaceAll(/\*([^*]+)\*/g, '$1');
first = first.replaceAll(/`([^`]+)`/g, '$1');
// Collapse whitespace
first = first.replaceAll(/\s+/g, ' ').trim();
if (!first) return null;
// Prefer ending at a sentence boundary if long
const maxLen = 320;
if (first.length > maxLen) {
const boundary = first.slice(0, maxLen + 40).match(/^[\s\S]*?[.!?](\s|$)/);
const cut = boundary ? boundary[0] : first.slice(0, maxLen);
return cut.trim();
}
return first;
};
try {
const raw = await fileManager.readFile(absPath);
// 1) YAML fenced block: look for Purpose fields
const yamlMatch = raw.match(/```ya?ml\r?\n([\s\S]*?)```/);
const yamlBlock = yamlMatch ? yamlMatch[1].trim() : null;
if (yamlBlock) {
try {
const data = yaml.load(yamlBlock);
if (data) {
let val = data.Purpose ?? data.purpose;
if (!val && data.task && (data.task.Purpose || data.task.purpose)) {
val = data.task.Purpose ?? data.task.purpose;
}
if (typeof val === 'string') {
const cleaned = cleanupAndSummarize(val);
if (cleaned) return cleaned;
}
}
} catch {
// ignore YAML parse errors
}
// Fallback regex inside YAML block
const quoted = yamlBlock.match(/(?:^|\n)\s*(?:Purpose|purpose):\s*"([^"]+)"/);
if (quoted && quoted[1]) {
const cleaned = cleanupAndSummarize(quoted[1]);
if (cleaned) return cleaned;
}
const unquoted = yamlBlock.match(/(?:^|\n)\s*(?:Purpose|purpose):\s*([^\n\r]+)/);
if (unquoted && unquoted[1]) {
const cleaned = cleanupAndSummarize(unquoted[1]);
if (cleaned) return cleaned;
}
}
// 2) Markdown heading section: ## Purpose (any level >= 2)
const headingRe = /^(#{2,6})\s*Purpose\s*$/im;
const headingMatch = headingRe.exec(raw);
if (headingMatch) {
const headingLevel = headingMatch[1].length;
const sectionStart = headingMatch.index + headingMatch[0].length;
const rest = raw.slice(sectionStart);
// Next heading of same or higher level ends the section
const nextHeadingRe = new RegExp(`^#{1,${headingLevel}}\\s+[^\n]+`, 'im');
const nextMatch = nextHeadingRe.exec(rest);
const section = nextMatch ? rest.slice(0, nextMatch.index) : rest;
const cleaned = cleanupAndSummarize(section);
if (cleaned) return cleaned;
}
// 3) Inline single-line fallback: Purpose: ...
const inline = raw.match(/(?:^|\n)\s*Purpose\s*:\s*([^\n\r]+)/i);
if (inline && inline[1]) {
const cleaned = cleanupAndSummarize(inline[1]);
if (cleaned) return cleaned;
}
} catch {
// ignore
}
return null;
};
// Build core sets
const coreAgentIds = new Set();
const coreTaskIds = new Set();
if (selectedPackages.includeCore) {
for (const id of await this.getCoreAgentIds(installDir)) coreAgentIds.add(id);
for (const id of await this.getCoreTaskIds(installDir)) coreTaskIds.add(id);
}
// Build packs info: { packId, packPath, packKey, agents:Set, tasks:Set }
const packsInfo = [];
if (Array.isArray(selectedPackages.packs)) {
for (const packId of selectedPackages.packs) {
const dotPackPath = path.join(installDir, `.${packId}`);
const altPackPath = path.join(installDir, 'expansion-packs', packId);
const packPath = (await fileManager.pathExists(dotPackPath))
? dotPackPath
: (await fileManager.pathExists(altPackPath))
? altPackPath
: null;
if (!packPath) continue;
// Ensure pack config.yaml is added to instructions (relative path, no './')
const packConfigAbs = path.join(packPath, 'config.yaml');
if (await fileManager.pathExists(packConfigAbs)) {
const relCfg = path.relative(installDir, packConfigAbs).replaceAll('\\', '/');
ensureInstructionPath(relCfg);
}
const packKey = packId.replace(/^bmad-/, '').replaceAll('/', '-');
const info = { packId, packPath, packKey, agents: new Set(), tasks: new Set() };
const glob = require('glob');
const agentsDir = path.join(packPath, 'agents');
if (await fileManager.pathExists(agentsDir)) {
const files = glob.sync('*.md', { cwd: agentsDir });
for (const f of files) info.agents.add(path.basename(f, '.md'));
}
const tasksDir = path.join(packPath, 'tasks');
if (await fileManager.pathExists(tasksDir)) {
const files = glob.sync('*.md', { cwd: tasksDir });
for (const f of files) info.tasks.add(path.basename(f, '.md'));
}
packsInfo.push(info);
}
}
// Generate agents - core first (respect optional agent prefix)
for (const agentId of coreAgentIds) {
const p = await this.findAgentPath(agentId, installDir); // prefers core
if (!p) continue;
const rel = path.relative(installDir, p).replaceAll('\\', '/');
const fileRef = `{file:./${rel}}`;
const baseKey = agentId;
const key = useAgentPrefix
? baseKey.startsWith('bmad-')
? baseKey
: `bmad-${baseKey}`
: baseKey;
const existing = configObj.agent[key];
const whenToUse = await extractWhenToUseFromFile(p);
const agentDef = {
prompt: fileRef,
mode: isOrchestratorAgent(agentId) ? 'primary' : 'all',
tools: { write: true, edit: true, bash: true },
...(whenToUse ? { description: whenToUse } : {}),
};
if (!existing) {
configObj.agent[key] = agentDef;
summary.agentsAdded++;
} else if (
existing &&
typeof existing === 'object' &&
typeof existing.prompt === 'string' &&
existing.prompt.includes(rel)
) {
existing.prompt = agentDef.prompt;
existing.mode = agentDef.mode;
if (whenToUse) existing.description = whenToUse;
existing.tools = { write: true, edit: true, bash: true };
configObj.agent[key] = existing;
summary.agentsUpdated++;
} else {
summary.agentsSkipped++;
// Collision warning: key exists but does not appear BMAD-managed (different prompt path)
console.log(
chalk.yellow(
`⚠︎ Skipped agent key '${key}' (existing entry not BMAD-managed). Tip: enable agent prefixes to avoid collisions.`,
),
);
}
}
// Generate agents - expansion packs (forced pack-specific prefix)
for (const pack of packsInfo) {
for (const agentId of pack.agents) {
const p = path.join(pack.packPath, 'agents', `${agentId}.md`);
if (!(await fileManager.pathExists(p))) continue;
const rel = path.relative(installDir, p).replaceAll('\\', '/');
const fileRef = `{file:./${rel}}`;
const prefixedKey = `bmad-${pack.packKey}-${agentId}`;
const existing = configObj.agent[prefixedKey];
const whenToUse = await extractWhenToUseFromFile(p);
const agentDef = {
prompt: fileRef,
mode: isOrchestratorAgent(agentId) ? 'primary' : 'all',
tools: { write: true, edit: true, bash: true },
...(whenToUse ? { description: whenToUse } : {}),
};
if (!existing) {
configObj.agent[prefixedKey] = agentDef;
summary.agentsAdded++;
} else if (
existing &&
typeof existing === 'object' &&
typeof existing.prompt === 'string' &&
existing.prompt.includes(rel)
) {
existing.prompt = agentDef.prompt;
existing.mode = agentDef.mode;
if (whenToUse) existing.description = whenToUse;
existing.tools = { write: true, edit: true, bash: true };
configObj.agent[prefixedKey] = existing;
summary.agentsUpdated++;
} else {
summary.agentsSkipped++;
console.log(
chalk.yellow(
`⚠︎ Skipped agent key '${prefixedKey}' (existing entry not BMAD-managed). Tip: enable agent prefixes to avoid collisions.`,
),
);
}
}
}
// Generate commands - core first (respect optional command prefix)
for (const taskId of coreTaskIds) {
const p = await this.findTaskPath(taskId, installDir); // prefers core/common
if (!p) continue;
const rel = path.relative(installDir, p).replaceAll('\\', '/');
const fileRef = `{file:./${rel}}`;
const key = useCommandPrefix ? `bmad:tasks:${taskId}` : `${taskId}`;
const existing = configObj.command[key];
const purpose = await extractTaskPurposeFromFile(p);
const cmdDef = { template: fileRef, ...(purpose ? { description: purpose } : {}) };
if (!existing) {
configObj.command[key] = cmdDef;
summary.commandsAdded++;
} else if (
existing &&
typeof existing === 'object' &&
typeof existing.template === 'string' &&
existing.template.includes(rel)
) {
existing.template = cmdDef.template;
if (purpose) existing.description = purpose;
configObj.command[key] = existing;
summary.commandsUpdated++;
} else {
summary.commandsSkipped++;
console.log(
chalk.yellow(
`⚠︎ Skipped command key '${key}' (existing entry not BMAD-managed). Tip: enable command prefixes to avoid collisions.`,
),
);
}
}
// Generate commands - expansion packs (forced pack-specific prefix)
for (const pack of packsInfo) {
for (const taskId of pack.tasks) {
const p = path.join(pack.packPath, 'tasks', `${taskId}.md`);
if (!(await fileManager.pathExists(p))) continue;
const rel = path.relative(installDir, p).replaceAll('\\', '/');
const fileRef = `{file:./${rel}}`;
const prefixedKey = `bmad:${pack.packKey}:${taskId}`;
const existing = configObj.command[prefixedKey];
const purpose = await extractTaskPurposeFromFile(p);
const cmdDef = { template: fileRef, ...(purpose ? { description: purpose } : {}) };
if (!existing) {
configObj.command[prefixedKey] = cmdDef;
summary.commandsAdded++;
} else if (
existing &&
typeof existing === 'object' &&
typeof existing.template === 'string' &&
existing.template.includes(rel)
) {
existing.template = cmdDef.template;
if (purpose) existing.description = purpose;
configObj.command[prefixedKey] = existing;
summary.commandsUpdated++;
} else {
summary.commandsSkipped++;
console.log(
chalk.yellow(
`⚠︎ Skipped command key '${prefixedKey}' (existing entry not BMAD-managed). Tip: enable command prefixes to avoid collisions.`,
),
);
}
}
}
return { configObj, summary };
};
// Helper: generate AGENTS.md section for OpenCode (acts as system prompt memory)
const generateOpenCodeAgentsMd = async () => {
try {
const filePath = path.join(installDir, 'AGENTS.md');
const startMarker = '<!-- BEGIN: BMAD-AGENTS-OPENCODE -->';
const endMarker = '<!-- END: BMAD-AGENTS-OPENCODE -->';
const agents = selectedAgent ? [selectedAgent] : await this.getAllAgentIds(installDir);
const tasks = await this.getAllTaskIds(installDir);
let section = '';
section += `${startMarker}\n`;
section += `# BMAD-METHOD Agents and Tasks (OpenCode)\n\n`;
section += `OpenCode reads AGENTS.md during initialization and uses it as part of its system prompt for the session. This section is auto-generated by BMAD-METHOD for OpenCode.\n\n`;
section += `## How To Use With OpenCode\n\n`;
section += `- Run \`opencode\` in this project. OpenCode will read \`AGENTS.md\` and your OpenCode config (opencode.json[c]).\n`;
section += `- Reference a role naturally, e.g., "As dev, implement ..." or use commands defined in your BMAD tasks.\n`;
section += `- Commit \`.bmad-core\` and \`AGENTS.md\` if you want teammates to share the same configuration.\n`;
section += `- Refresh this section after BMAD updates: \`npx bmad-method install -f -i opencode\`.\n\n`;
section += `### Helpful Commands\n\n`;
section += `- List agents: \`npx bmad-method list:agents\`\n`;
section += `- Reinstall BMAD core and regenerate this section: \`npx bmad-method install -f -i opencode\`\n`;
section += `- Validate configuration: \`npx bmad-method validate\`\n\n`;
// Brief context note for modes and tools
section += `Note\n`;
section += `- Orchestrators run as mode: primary; other agents as all.\n`;
section += `- All agents have tools enabled: write, edit, bash.\n\n`;
section += `## Agents\n\n`;
section += `### Directory\n\n`;
section += `| Title | ID | When To Use |\n|---|---|---|\n`;
// Fallback descriptions for core agents (used if whenToUse is missing)
const fallbackDescriptions = {
'ux-expert':
'Use for UI/UX design, wireframes, prototypes, front-end specs, and user experience optimization',
sm: 'Use for story creation, epic management, retrospectives in party-mode, and agile process guidance',
qa: 'Ensure quality strategy, test design, risk profiling, and QA gates across features',
po: 'Backlog management, story refinement, acceptance criteria, sprint planning, prioritization decisions',
pm: 'PRDs, product strategy, feature prioritization, roadmap planning, and stakeholder communication',
dev: 'Code implementation, debugging, refactoring, and development best practices',
'bmad-orchestrator':
'Workflow coordination, multi-agent tasks, role switching guidance, and when unsure which specialist to consult',
'bmad-master':
'Comprehensive cross-domain execution for tasks that do not require a specific persona',
architect:
'System design, architecture docs, technology selection, API design, and infrastructure planning',
analyst:
'Discovery/research, competitive analysis, project briefs, initial discovery, and brownfield documentation',
};
const sanitizeDesc = (s) => {
if (!s) return '';
let t = String(s).trim();
// Drop surrounding single/double/backtick quotes
t = t.replaceAll(/^['"`]+|['"`]+$/g, '');
// Collapse whitespace
t = t.replaceAll(/\s+/g, ' ').trim();
return t;
};
const agentSummaries = [];
for (const agentId of agents) {
const agentPath = await this.findAgentPath(agentId, installDir);
if (!agentPath) continue;
let whenToUse = '';
try {
const raw = await fileManager.readFile(agentPath);
const yamlMatch = raw.match(/```ya?ml\r?\n([\s\S]*?)```/);
const yamlBlock = yamlMatch ? yamlMatch[1].trim() : null;
if (yamlBlock) {
try {
const data = yaml.load(yamlBlock);
if (data && typeof data.whenToUse === 'string') {
whenToUse = data.whenToUse;
}
} catch {
// ignore YAML parse errors
}
if (!whenToUse) {
// Fallback regex supporting single or double quotes
const m1 = yamlBlock.match(/whenToUse:\s*"([^\n"]+)"/i);
const m2 = yamlBlock.match(/whenToUse:\s*'([^\n']+)'/i);
const m3 = yamlBlock.match(/whenToUse:\s*([^\n\r]+)/i);
whenToUse = (m1?.[1] || m2?.[1] || m3?.[1] || '').trim();
}
}
} catch {
// ignore read/parse errors for agent metadata extraction
}
const title = await this.getAgentTitle(agentId, installDir);
const finalDesc = sanitizeDesc(whenToUse) || fallbackDescriptions[agentId] || '—';
agentSummaries.push({ agentId, title, whenToUse: finalDesc, path: agentPath });
// Strict 3-column row
section += `| ${title} | ${agentId} | ${finalDesc} |\n`;
}
section += `\n`;
for (const { agentId, title, whenToUse, path: agentPath } of agentSummaries) {
const relativePath = path.relative(installDir, agentPath).replaceAll('\\', '/');
section += `### ${title} (id: ${agentId})\n`;
section += `Source: [${relativePath}](${relativePath})\n\n`;
if (whenToUse) section += `- When to use: ${whenToUse}\n`;
section += `- How to activate: Mention "As ${agentId}, ..." to get role-aligned behavior\n`;
section += `- Full definition: open the source file above (content not embedded)\n\n`;
}
if (tasks && tasks.length > 0) {
section += `## Tasks\n\n`;
section += `These are reusable task briefs; use the paths to open them as needed.\n\n`;
for (const taskId of tasks) {
const taskPath = await this.findTaskPath(taskId, installDir);
if (!taskPath) continue;
const relativePath = path.relative(installDir, taskPath).replaceAll('\\', '/');
section += `### Task: ${taskId}\n`;
section += `Source: [${relativePath}](${relativePath})\n`;
section += `- How to use: Reference the task in your prompt or execute via your configured commands.\n`;
section += `- Full brief: open the source file above (content not embedded)\n\n`;
}
}
section += `${endMarker}\n`;
let finalContent = '';
if (await fileManager.pathExists(filePath)) {
const existing = await fileManager.readFile(filePath);
if (existing.includes(startMarker) && existing.includes(endMarker)) {
const pattern = String.raw`${startMarker}[\s\S]*?${endMarker}`;
const replaced = existing.replace(new RegExp(pattern, 'm'), section);
finalContent = replaced;
} else {
finalContent = existing.trimEnd() + `\n\n` + section;
}
} else {
finalContent += '# Project Agents\n\n';
finalContent += 'This file provides guidance and memory for your coding CLI.\n\n';
finalContent += section;
}
await fileManager.writeFile(filePath, finalContent);
console.log(chalk.green('✓ Created/updated AGENTS.md for OpenCode CLI integration'));
console.log(
chalk.dim(
'OpenCode reads AGENTS.md automatically on init. Run `opencode` in this project to use BMAD agents.',
),
);
} catch {
console.log(chalk.yellow('⚠︎ Skipped creating AGENTS.md for OpenCode (write failed)'));
}
};
if (hasJson || hasJsonc) {
// Preserve existing top-level fields; only touch instructions
const targetPath = hasJsonc ? jsoncPath : jsonPath;
try {
const raw = await fs.readFile(targetPath, 'utf8');
// Use comment-json for both .json and .jsonc for resilience
const parsed = cjson.parse(raw, undefined, true);
ensureInstructionRef(parsed);
const { configObj, summary } = await mergeBmadAgentsAndCommands(parsed);
const output = cjson.stringify(parsed, null, 2);
await fs.writeFile(targetPath, output + (output.endsWith('\n') ? '' : '\n'));
console.log(
chalk.green(
'✓ Updated OpenCode config: ensured BMAD instructions and merged agents/commands',
),
);
// Summary output
console.log(
chalk.dim(
` File: ${path.basename(targetPath)} | Agents +${summary.agentsAdded} ~${summary.agentsUpdated} ${summary.agentsSkipped} | Commands +${summary.commandsAdded} ~${summary.commandsUpdated} ${summary.commandsSkipped}`,
),
);
// Ensure AGENTS.md is created/updated for OpenCode as well
await generateOpenCodeAgentsMd();
} catch (error) {
console.log(chalk.red('✗ Failed to update existing OpenCode config'), error.message);
return false;
}
return true;
}
// Create minimal opencode.jsonc
const minimal = {
$schema: 'https://opencode.ai/config.json',
instructions: ['.bmad-core/core-config.yaml'],
agent: {},
command: {},
};
try {
const { configObj, summary } = await mergeBmadAgentsAndCommands(minimal);
const output = cjson.stringify(minimal, null, 2);
await fs.writeFile(jsoncPath, output + (output.endsWith('\n') ? '' : '\n'));
console.log(
chalk.green('✓ Created opencode.jsonc with BMAD instructions, agents, and commands'),
);
console.log(
chalk.dim(
` File: opencode.jsonc | Agents +${summary.agentsAdded} | Commands +${summary.commandsAdded}`,
),
);
// Also create/update AGENTS.md for OpenCode on new-config path
await generateOpenCodeAgentsMd();
return true;
} catch (error) {
console.log(chalk.red('✗ Failed to create opencode.jsonc'), error.message);
return false;
}
}
async setupCodex(installDir, selectedAgent, options) {
options = options ?? { webEnabled: false };
// Codex reads AGENTS.md at the project root as project memory (CLI & Web).
@@ -230,7 +871,6 @@ class IdeSetup extends BaseIdeSetup {
if (options.webEnabled) {
if (exists) {
let gi = await fileManager.readFile(gitignorePath);
// Remove lines that ignore BMAD dot-folders
const updated = gi
.split(/\r?\n/)
.filter((l) => !/^\s*\.bmad-core\/?\s*$/.test(l) && !/^\s*\.bmad-\*\/?\s*$/.test(l))
@@ -1416,94 +2056,86 @@ CRITICAL: You are to execute the BMad Task defined below.
}
async setupQwenCode(installDir, selectedAgent) {
const qwenDir = path.join(installDir, '.qwen');
const bmadMethodDir = path.join(qwenDir, 'bmad-method');
await fileManager.ensureDirectory(bmadMethodDir);
const ideConfig = await configLoader.getIdeConfiguration('qwen-code');
const bmadCommandsDir = path.join(installDir, ideConfig['rule-dir']);
// Update logic for existing settings.json
const settingsPath = path.join(qwenDir, 'settings.json');
if (await fileManager.pathExists(settingsPath)) {
try {
const settingsContent = await fileManager.readFile(settingsPath);
const settings = JSON.parse(settingsContent);
let updated = false;
const agentCommandsDir = path.join(bmadCommandsDir, 'agents');
const taskCommandsDir = path.join(bmadCommandsDir, 'tasks');
await fileManager.ensureDirectory(agentCommandsDir);
await fileManager.ensureDirectory(taskCommandsDir);
// Handle contextFileName property
if (settings.contextFileName && Array.isArray(settings.contextFileName)) {
const originalLength = settings.contextFileName.length;
settings.contextFileName = settings.contextFileName.filter(
(fileName) => !fileName.startsWith('agents/'),
);
if (settings.contextFileName.length !== originalLength) {
updated = true;
}
}
if (updated) {
await fileManager.writeFile(settingsPath, JSON.stringify(settings, null, 2));
console.log(chalk.green('✓ Updated .qwen/settings.json - removed agent file references'));
}
} catch (error) {
console.warn(chalk.yellow('Could not update .qwen/settings.json'), error);
}
}
// Remove old agents directory
const agentsDir = path.join(qwenDir, 'agents');
if (await fileManager.pathExists(agentsDir)) {
await fileManager.removeDirectory(agentsDir);
console.log(chalk.green('✓ Removed old .qwen/agents directory'));
}
// Get all available agents
// Process Agents
const agents = selectedAgent ? [selectedAgent] : await this.getAllAgentIds(installDir);
let concatenatedContent = '';
for (const agentId of agents) {
// Find the source agent file
const agentPath = await this.findAgentPath(agentId, installDir);
if (agentPath) {
const agentContent = await fileManager.readFile(agentPath);
// Create properly formatted agent rule content (similar to gemini)
let agentRuleContent = `# ${agentId.toUpperCase()} Agent Rule\n\n`;
agentRuleContent += `This rule is triggered when the user types \`*${agentId}\` and activates the ${await this.getAgentTitle(
agentId,
installDir,
)} agent persona.\n\n`;
agentRuleContent += '## Agent Activation\n\n';
agentRuleContent +=
'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:\n\n';
agentRuleContent += '```yaml\n';
// Extract just the YAML content from the agent file
const yamlContent = extractYamlFromAgent(agentContent);
if (yamlContent) {
agentRuleContent += yamlContent;
} else {
// If no YAML found, include the whole content minus the header
agentRuleContent += agentContent.replace(/^#.*$/m, '').trim();
}
agentRuleContent += '\n```\n\n';
agentRuleContent += '## File Reference\n\n';
const relativePath = path.relative(installDir, agentPath).replaceAll('\\', '/');
agentRuleContent += `The complete agent definition is available in [${relativePath}](${relativePath}).\n\n`;
agentRuleContent += '## Usage\n\n';
agentRuleContent += `When the user types \`*${agentId}\`, activate this ${await this.getAgentTitle(
agentId,
installDir,
)} persona and follow all instructions defined in the YAML configuration above.\n`;
// Add to concatenated content with separator
concatenatedContent += agentRuleContent + '\n\n---\n\n';
console.log(chalk.green(`✓ Added context for *${agentId}`));
if (!agentPath) {
console.log(chalk.yellow(`✗ Agent file not found for ${agentId}, skipping.`));
continue;
}
const agentTitle = await this.getAgentTitle(agentId, installDir);
const commandPath = path.join(agentCommandsDir, `${agentId}.toml`);
// Get relative path from installDir to agent file for @{file} reference
const relativeAgentPath = path.relative(installDir, agentPath).replaceAll('\\', '/');
// Read the agent content
const agentContent = await fileManager.readFile(agentPath);
const tomlContent = `description = " Activates the ${agentTitle} agent from the BMad Method."
prompt = """
CRITICAL: You are now the BMad '${agentTitle}' agent. Adopt its persona, follow its instructions, and use its capabilities.
READ THIS BEFORE ANSWERING AS THE PERSONA!
${agentContent}
"""`;
await fileManager.writeFile(commandPath, tomlContent);
console.log(chalk.green(`✓ Created agent command: /bmad:agents:${agentId}`));
}
// Write the concatenated content to QWEN.md
const qwenMdPath = path.join(bmadMethodDir, 'QWEN.md');
await fileManager.writeFile(qwenMdPath, concatenatedContent);
console.log(chalk.green(`\n✓ Created QWEN.md in ${bmadMethodDir}`));
// Process Tasks
const tasks = await this.getAllTaskIds(installDir);
for (const taskId of tasks) {
const taskPath = await this.findTaskPath(taskId, installDir);
if (!taskPath) {
console.log(chalk.yellow(`✗ Task file not found for ${taskId}, skipping.`));
continue;
}
const taskTitle = taskId
.split('-')
.map((word) => word.charAt(0).toUpperCase() + word.slice(1))
.join(' ');
const commandPath = path.join(taskCommandsDir, `${taskId}.toml`);
// Get relative path from installDir to task file for @{file} reference
const relativeTaskPath = path.relative(installDir, taskPath).replaceAll('\\', '/');
// Read the task content
const taskContent = await fileManager.readFile(taskPath);
const tomlContent = `description = " Executes the BMad Task: ${taskTitle}"
prompt = """
CRITICAL: You are to execute the BMad Task defined below.
READ THIS BEFORE EXECUTING THE TASK AS THE INSTRUCTIONS SPECIFIED!
${taskContent}
"""`;
await fileManager.writeFile(commandPath, tomlContent);
console.log(chalk.green(`✓ Created task command: /bmad:tasks:${taskId}`));
}
console.log(
chalk.green(`
✓ Created Qwen Code extension in ${bmadCommandsDir}`),
);
console.log(
chalk.dim('You can now use commands like /bmad:agents:dev or /bmad:tasks:create-doc.'),
);
return true;
}

View File

@@ -409,10 +409,23 @@ class Installer {
for (const ide of ides) {
spinner.text = `Setting up ${ide} integration...`;
let preConfiguredSettings = null;
if (ide === 'github-copilot') {
preConfiguredSettings = config.githubCopilotConfig;
} else if (ide === 'auggie-cli') {
preConfiguredSettings = config.augmentCodeConfig;
switch (ide) {
case 'github-copilot': {
preConfiguredSettings = config.githubCopilotConfig;
break;
}
case 'auggie-cli': {
preConfiguredSettings = config.augmentCodeConfig;
break;
}
case 'opencode': {
preConfiguredSettings = config.openCodeConfig;
break;
}
default: {
// no pre-configured settings
break;
}
}
await ideSetup.setup(ide, installDir, config.agent, spinner, preConfiguredSettings);
}

View File

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