mirror of
https://github.com/bmadcode/BMAD-METHOD.git
synced 2025-12-29 16:14:59 +00:00
The install directory is now configurable, with a few minute issues
This commit is contained in:
Brian Madison
@@ -10,18 +10,20 @@ prompt: "Happy Building - Build the Modules, Workflows and Agents of your dreams
|
||||
## communication_language
|
||||
## output_folder
|
||||
## bmad_folder
|
||||
## install_user_docs
|
||||
## kb_install
|
||||
|
||||
custom_agent_location:
|
||||
prompt: "Where do custom agents get created?"
|
||||
default: "bmad/agents"
|
||||
default: "{bmad_folder}/custom/agents"
|
||||
result: "{project-root}/{value}"
|
||||
|
||||
custom_workflow_location:
|
||||
prompt: "Where do custom workflows get stored?"
|
||||
default: "bmad/workflows"
|
||||
default: "{bmad_folder}/custom/workflows"
|
||||
result: "{project-root}/{value}"
|
||||
|
||||
custom_module_location:
|
||||
prompt: "Where do custom modules get stored?"
|
||||
default: "bmad"
|
||||
default: "{bmad_folder}/custom/modules"
|
||||
result: "{project-root}/{value}"
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
|
||||
agent:
|
||||
metadata:
|
||||
id: bmad/bmb/agents/bmad-builder.md
|
||||
id: "{bmad_folder}/bmb/agents/bmad-builder.md"
|
||||
name: BMad Builder
|
||||
title: BMad Builder
|
||||
icon: 🧙
|
||||
@@ -22,37 +22,37 @@ agent:
|
||||
# help and exit are auto-injected, don't define them here
|
||||
menu:
|
||||
- trigger: audit-workflow
|
||||
workflow: "{project-root}/bmad/bmb/workflows/audit-workflow/workflow.yaml"
|
||||
workflow: "{project-root}/{bmad_folder}/bmb/workflows/audit-workflow/workflow.yaml"
|
||||
description: Audit existing workflows for BMAD Core compliance and best practices
|
||||
|
||||
- trigger: convert
|
||||
workflow: "{project-root}/bmad/bmb/workflows/convert-legacy/workflow.yaml"
|
||||
workflow: "{project-root}/{bmad_folder}/bmb/workflows/convert-legacy/workflow.yaml"
|
||||
description: Convert v4 or any other style task agent or template to a workflow
|
||||
|
||||
- trigger: create-agent
|
||||
workflow: "{project-root}/bmad/bmb/workflows/create-agent/workflow.yaml"
|
||||
workflow: "{project-root}/{bmad_folder}/bmb/workflows/create-agent/workflow.yaml"
|
||||
description: Create a new BMAD Core compliant agent
|
||||
|
||||
- trigger: create-module
|
||||
workflow: "{project-root}/bmad/bmb/workflows/create-module/workflow.yaml"
|
||||
workflow: "{project-root}/{bmad_folder}/bmb/workflows/create-module/workflow.yaml"
|
||||
description: Create a complete BMAD compatible module (custom agents and workflows)
|
||||
|
||||
- trigger: create-workflow
|
||||
workflow: "{project-root}/bmad/bmb/workflows/create-workflow/workflow.yaml"
|
||||
workflow: "{project-root}/{bmad_folder}/bmb/workflows/create-workflow/workflow.yaml"
|
||||
description: Create a new BMAD Core workflow with proper structure
|
||||
|
||||
- trigger: edit-agent
|
||||
workflow: "{project-root}/bmad/bmb/workflows/edit-agent/workflow.yaml"
|
||||
workflow: "{project-root}/{bmad_folder}/bmb/workflows/edit-agent/workflow.yaml"
|
||||
description: Edit existing agents while following best practices
|
||||
|
||||
- trigger: edit-module
|
||||
workflow: "{project-root}/bmad/bmb/workflows/edit-module/workflow.yaml"
|
||||
workflow: "{project-root}/{bmad_folder}/bmb/workflows/edit-module/workflow.yaml"
|
||||
description: Edit existing modules (structure, agents, workflows, documentation)
|
||||
|
||||
- trigger: edit-workflow
|
||||
workflow: "{project-root}/bmad/bmb/workflows/edit-workflow/workflow.yaml"
|
||||
workflow: "{project-root}/{bmad_folder}/bmb/workflows/edit-workflow/workflow.yaml"
|
||||
description: Edit existing workflows while following best practices
|
||||
|
||||
- trigger: redoc
|
||||
workflow: "{project-root}/bmad/bmb/workflows/redoc/workflow.yaml"
|
||||
workflow: "{project-root}/{bmad_folder}/bmb/workflows/redoc/workflow.yaml"
|
||||
description: Create or update module documentation
|
||||
|
||||
@@ -45,7 +45,7 @@
|
||||
## Web Bundle Validation (if applicable)
|
||||
|
||||
- [ ] web_bundle section present if workflow needs deployment
|
||||
- [ ] All paths in web_bundle use bmad/-relative format (NOT {project-root})
|
||||
- [ ] All paths in web_bundle use {bmad_folder}/-relative format (NOT {project-root})
|
||||
- [ ] No {config_source} variables in web_bundle section
|
||||
- [ ] instructions file listed in web_bundle_files array
|
||||
- [ ] template file listed in web_bundle_files (if document workflow)
|
||||
@@ -53,7 +53,7 @@
|
||||
- [ ] All data files (CSV, JSON, YAML) listed in web_bundle_files
|
||||
- [ ] All <invoke-workflow> called workflows have their .yaml files in web_bundle_files
|
||||
- [ ] **CRITICAL**: If workflow invokes other workflows, existing_workflows field is present
|
||||
- [ ] existing_workflows maps workflow variables to bmad/-relative paths correctly
|
||||
- [ ] existing_workflows maps workflow variables to {bmad_folder}/-relative paths correctly
|
||||
- [ ] All files referenced in instructions <action> tags listed in web_bundle_files
|
||||
- [ ] No files listed in web_bundle_files that don't exist
|
||||
- [ ] Web bundle metadata (name, description, author) matches top-level metadata
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# Audit Workflow - Workflow Quality Audit Instructions
|
||||
|
||||
<critical>The workflow execution engine is governed by: {project-root}/bmad/core/tasks/workflow.xml</critical>
|
||||
<critical>You MUST have already loaded and processed: {project-root}/bmad/bmb/workflows/audit-workflow/workflow.yaml</critical>
|
||||
<critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
|
||||
<critical>You MUST have already loaded and processed: {project-root}/{bmad_folder}/bmb/workflows/audit-workflow/workflow.yaml</critical>
|
||||
|
||||
<workflow>
|
||||
|
||||
@@ -33,7 +33,7 @@
|
||||
|
||||
**Required variables:**
|
||||
|
||||
- `config_source: "{project-root}/bmad/[module]/config.yaml"`
|
||||
- `config_source: "{project-root}/{bmad_folder}/[module]/config.yaml"`
|
||||
- `output_folder: "{config_source}:output_folder"`
|
||||
- `user_name: "{config_source}:user_name"`
|
||||
- `communication_language: "{config_source}:communication_language"`
|
||||
@@ -182,7 +182,7 @@
|
||||
|
||||
**Path Validation:**
|
||||
|
||||
- [ ] All paths use bmad/-relative format (NOT {project-root})
|
||||
- [ ] All paths use {bmad_folder}/-relative format (NOT {project-root})
|
||||
- [ ] No {config_source} variables in web_bundle section
|
||||
- [ ] Paths match actual file locations
|
||||
|
||||
@@ -200,7 +200,7 @@
|
||||
<action>Verify each called workflow.yaml is in web_bundle_files</action>
|
||||
<action>**CRITICAL**: Check if existing_workflows field is present when workflows are invoked</action>
|
||||
<action>If invoke-workflow calls exist, existing_workflows MUST map workflow variables to paths</action>
|
||||
<action>Example: If instructions use {core_brainstorming}, web_bundle needs: existing_workflows: - core_brainstorming: "bmad/core/workflows/brainstorming/workflow.yaml"</action>
|
||||
<action>Example: If instructions use {core_brainstorming}, web_bundle needs: existing_workflows: - core_brainstorming: "{bmad_folder}/core/workflows/brainstorming/workflow.yaml"</action>
|
||||
|
||||
**File Reference Scan:**
|
||||
<action>Scan instructions.md for file references in action tags</action>
|
||||
|
||||
@@ -4,14 +4,14 @@ description: "Comprehensive workflow quality audit - validates structure, config
|
||||
author: "BMad"
|
||||
|
||||
# Critical variables from config
|
||||
config_source: "{project-root}/bmad/bmb/config.yaml"
|
||||
config_source: "{project-root}/{bmad_folder}/bmb/config.yaml"
|
||||
output_folder: "{config_source}:output_folder"
|
||||
user_name: "{config_source}:user_name"
|
||||
communication_language: "{config_source}:communication_language"
|
||||
date: system-generated
|
||||
|
||||
# Module path and component files
|
||||
installed_path: "{project-root}/bmad/bmb/workflows/audit-workflow"
|
||||
installed_path: "{project-root}/{bmad_folder}/bmb/workflows/audit-workflow"
|
||||
template: "{installed_path}/template.md"
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
validation: "{installed_path}/checklist.md"
|
||||
|
||||
@@ -84,7 +84,7 @@ convert-legacy/
|
||||
- Prompts for target module (bmm, bmb, cis, custom)
|
||||
- Determines proper installation paths using v6 conventions
|
||||
- Shows target location for user confirmation
|
||||
- Ensures all paths use `{project-root}/bmad/` format
|
||||
- Ensures all paths use `{project-root}/{bmad_folder}/` format
|
||||
|
||||
### Phase 2: Conversion Strategy (Step 4)
|
||||
|
||||
@@ -126,7 +126,7 @@ convert-legacy/
|
||||
**Template-to-Workflow Conversion (5c)**
|
||||
|
||||
- Converts YAML template sections to workflow steps
|
||||
- Maps `elicit: true` flags to `<invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>` tags
|
||||
- Maps `elicit: true` flags to `<invoke-task halt="true">{project-root}/{bmad_folder}/core/tasks/adv-elicit.xml</invoke-task>` tags
|
||||
- Transforms conditional sections to flow control
|
||||
- Creates proper template.md from content structure
|
||||
- Integrates v4 create-doc.md task patterns
|
||||
@@ -218,7 +218,7 @@ Converted items follow v6 conventions:
|
||||
|
||||
**Issue**: Path conversion errors
|
||||
|
||||
- **Solution**: Ensure all references use `{project-root}/bmad/` format
|
||||
- **Solution**: Ensure all references use `{project-root}/{bmad_folder}/` format
|
||||
- **Check**: Review conversion mappings for proper path patterns
|
||||
|
||||
**Issue**: Sub-workflow invocation fails
|
||||
@@ -252,8 +252,8 @@ To customize this workflow:
|
||||
|
||||
For issues or questions:
|
||||
|
||||
- Review the workflow creation guide at `/bmad/bmb/workflows/create-workflow/workflow-creation-guide.md`
|
||||
- Check conversion mappings at `/bmad/bmb/data/v4-to-v6-mappings.yaml`
|
||||
- Review the workflow creation guide at `/{bmad_folder}/bmb/workflows/create-workflow/workflow-creation-guide.md`
|
||||
- Check conversion mappings at `/{bmad_folder}/bmb/data/v4-to-v6-mappings.yaml`
|
||||
- Validate output using `checklist.md`
|
||||
- Consult BMAD v6 documentation for proper conventions
|
||||
|
||||
|
||||
@@ -37,7 +37,7 @@
|
||||
- [ ] File paths use {project-root} variables
|
||||
- [ ] Config values use {config_source}: pattern
|
||||
- [ ] Agent follows naming conventions (kebab-case for files)
|
||||
- [ ] ALL paths reference {project-root}/bmad/{{module}}/ locations, NOT src/
|
||||
- [ ] ALL paths reference {project-root}/{bmad_folder}/{{module}}/ locations, NOT src/
|
||||
- [ ] exec, data, run-workflow commands point to final BMAD installation paths
|
||||
|
||||
### For Template/Workflow Conversions
|
||||
@@ -48,7 +48,7 @@
|
||||
- [ ] All sections converted to workflow steps
|
||||
- [ ] Section hierarchy maintained in instructions
|
||||
- [ ] Variables ({{var}}) preserved in template.md
|
||||
- [ ] Elicitation points (elicit: true) converted to <invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
|
||||
- [ ] Elicitation points (elicit: true) converted to <invoke-task halt="true">{project-root}/{bmad_folder}/core/tasks/adv-elicit.xml</invoke-task>
|
||||
- [ ] Conditional sections preserved with if="" attributes
|
||||
- [ ] Repeatable sections converted to repeat="" attributes
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# Convert Legacy - v4 to v6 Conversion Instructions
|
||||
|
||||
<critical>The workflow execution engine is governed by: {project-root}/bmad/core/tasks/workflow.xml</critical>
|
||||
<parameter name="You MUST have already loaded and processed: {project-root}/bmad/bmb/workflows/convert-legacy/workflow.yaml</critical>
|
||||
<critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
|
||||
<parameter name="You MUST have already loaded and processed: {project-root}/{bmad_folder}/bmb/workflows/convert-legacy/workflow.yaml</critical>
|
||||
<critical>Communicate in {communication_language} throughout the conversion process</critical>
|
||||
|
||||
<workflow>
|
||||
@@ -70,8 +70,8 @@ For Modules:
|
||||
<action if="custom module"><ask>Enter custom module code (kebab-case):</ask></action>
|
||||
<action>Determine installation path based on type and module</action>
|
||||
<critical>IMPORTANT: All paths must use final BMAD installation locations, not src paths!</critical>
|
||||
<action>Show user the target location: {project-root}/bmad/{{target_module}}/{{item_type}}/{{item_name}}</action>
|
||||
<action>Note: Files will be created in bmad/ but all internal paths will reference {project-root}/bmad/ locations</action>
|
||||
<action>Show user the target location: {project-root}/{bmad_folder}/{{target_module}}/{{item_type}}/{{item_name}}</action>
|
||||
<action>Note: Files will be created in {bmad_folder}/ but all internal paths will reference {project-root}/{bmad_folder}/ locations</action>
|
||||
<ask>Proceed with this location? (y/n)</ask>
|
||||
</step>
|
||||
|
||||
@@ -150,16 +150,16 @@ For Modules:
|
||||
- Convert task dependencies to workflow references
|
||||
- Map template dependencies to v6 workflows
|
||||
- Preserve checklist and data file references
|
||||
- CRITICAL: All paths must use {project-root}/bmad/{{module}}/ NOT src/
|
||||
- CRITICAL: All paths must use {project-root}/{bmad_folder}/{{module}}/ NOT src/
|
||||
|
||||
<action>Generate the converted v6 agent YAML file (.agent.yaml)</action>
|
||||
<action>Example path conversions:
|
||||
|
||||
- exec="{project-root}/bmad/{{target_module}}/tasks/task-name.md"
|
||||
- run-workflow="{project-root}/bmad/{{target_module}}/workflows/workflow-name/workflow.yaml"
|
||||
- data="{project-root}/bmad/{{target_module}}/data/data-file.yaml"
|
||||
- exec="{project-root}/{bmad_folder}/{{target_module}}/tasks/task-name.md"
|
||||
- run-workflow="{project-root}/{bmad_folder}/{{target_module}}/workflows/workflow-name/workflow.yaml"
|
||||
- data="{project-root}/{bmad_folder}/{{target_module}}/data/data-file.yaml"
|
||||
</action>
|
||||
<action>Save to: bmad/{{target_module}}/agents/{{agent_name}}.agent.yaml (physical location)</action>
|
||||
<action>Save to: {bmad_folder}/{{target_module}}/agents/{{agent_name}}.agent.yaml (physical location)</action>
|
||||
<action>Note: The build process will later compile this to .md with XML format</action>
|
||||
<goto step="6">Continue to Validation</goto>
|
||||
</step>
|
||||
@@ -172,7 +172,7 @@ For Modules:
|
||||
- Any special behaviors
|
||||
|
||||
<invoke-workflow>
|
||||
workflow: {project-root}/bmad/bmb/workflows/create-agent/workflow.yaml
|
||||
workflow: {project-root}/{bmad_folder}/bmb/workflows/create-agent/workflow.yaml
|
||||
inputs:
|
||||
- agent_name: {{extracted_name}}
|
||||
- agent_purpose: {{extracted_purpose}}
|
||||
@@ -193,7 +193,7 @@ For Modules:
|
||||
|
||||
2. Convert template sections to instructions.md:
|
||||
- Each YAML section → workflow step
|
||||
- `elicit: true` → `<invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>` tag
|
||||
- `elicit: true` → `<invoke-task halt="true">{project-root}/{bmad_folder}/core/tasks/adv-elicit.xml</invoke-task>` tag
|
||||
- Conditional sections → `if="condition"` attribute
|
||||
- Repeatable sections → `repeat="for-each"` attribute
|
||||
- Section instructions → step content
|
||||
@@ -212,7 +212,7 @@ For Modules:
|
||||
|
||||
```yaml
|
||||
# Critical variables from config
|
||||
config_source: '{project-root}/bmad/{{target_module}}/config.yaml'
|
||||
config_source: '{project-root}/{bmad_folder}/{{target_module}}/config.yaml'
|
||||
output_folder: '{config_source}:output_folder'
|
||||
user_name: '{config_source}:user_name'
|
||||
communication_language: '{config_source}:communication_language'
|
||||
@@ -220,7 +220,7 @@ date: system-generated
|
||||
```
|
||||
|
||||
<invoke-workflow>
|
||||
workflow: {project-root}/bmad/bmb/workflows/create-workflow/workflow.yaml
|
||||
workflow: {project-root}/{bmad_folder}/bmb/workflows/create-workflow/workflow.yaml
|
||||
inputs:
|
||||
- workflow_name: {{template_name}}
|
||||
- workflow_type: document
|
||||
@@ -239,7 +239,7 @@ date: system-generated
|
||||
<action>Create module blueprint with all components</action>
|
||||
|
||||
<invoke-workflow>
|
||||
workflow: {project-root}/bmad/bmb/workflows/create-module/workflow.yaml
|
||||
workflow: {project-root}/{bmad_folder}/bmb/workflows/create-module/workflow.yaml
|
||||
inputs:
|
||||
- module_name: {{module_name}}
|
||||
- components: {{component_list}}
|
||||
@@ -277,7 +277,7 @@ date: system-generated
|
||||
</check>
|
||||
|
||||
4. Handle special v4 patterns:
|
||||
- 1-9 elicitation menus → v6 <invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
|
||||
- 1-9 elicitation menus → v6 <invoke-task halt="true">{project-root}/{bmad_folder}/core/tasks/adv-elicit.xml</invoke-task>
|
||||
- Agent permissions → note in instructions
|
||||
- YOLO mode → autonomous flag or optional steps
|
||||
- Critical notices → workflow.yaml comments
|
||||
@@ -286,7 +286,7 @@ date: system-generated
|
||||
|
||||
```yaml
|
||||
# Critical variables from config
|
||||
config_source: '{project-root}/bmad/{{target_module}}/config.yaml'
|
||||
config_source: '{project-root}/{bmad_folder}/{{target_module}}/config.yaml'
|
||||
output_folder: '{config_source}:output_folder'
|
||||
user_name: '{config_source}:user_name'
|
||||
communication_language: '{config_source}:communication_language'
|
||||
@@ -294,7 +294,7 @@ date: system-generated
|
||||
```
|
||||
|
||||
<invoke-workflow>
|
||||
workflow: {project-root}/bmad/bmb/workflows/create-workflow/workflow.yaml
|
||||
workflow: {project-root}/{bmad_folder}/bmb/workflows/create-workflow/workflow.yaml
|
||||
inputs:
|
||||
- workflow_name: {{task_name}}
|
||||
- workflow_type: {{confirmed_workflow_type}}
|
||||
|
||||
@@ -4,7 +4,7 @@ description: "Converts legacy BMAD v4 or similar items (agents, workflows, modul
|
||||
author: "BMad"
|
||||
|
||||
# Critical variables load from config_source
|
||||
config_source: "{project-root}/bmad/bmb/config.yaml"
|
||||
config_source: "{project-root}/{bmad_folder}/bmb/config.yaml"
|
||||
output_folder: "{config_source}:output_folder"
|
||||
user_name: "{config_source}:user_name"
|
||||
communication_language: "{config_source}:communication_language"
|
||||
@@ -15,19 +15,19 @@ recommended_inputs:
|
||||
- legacy_file: "Path to v4 agent, workflow, or module to convert"
|
||||
|
||||
# Module path and component files
|
||||
installed_path: "{project-root}/bmad/bmb/workflows/convert-legacy"
|
||||
installed_path: "{project-root}/{bmad_folder}/bmb/workflows/convert-legacy"
|
||||
template: false # This is an action/meta workflow - no template needed
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
validation: "{installed_path}/checklist.md"
|
||||
|
||||
# Output configuration - Creates converted items in appropriate module locations
|
||||
default_output_folder: "{project-root}/bmad/{{target_module}}/{{item_type}}/{{item_name}}"
|
||||
default_output_folder: "{project-root}/{bmad_folder}/{{target_module}}/{{item_type}}/{{item_name}}"
|
||||
|
||||
# Sub-workflows that may be invoked for conversion
|
||||
sub_workflows:
|
||||
- create_agent: "{project-root}/bmad/bmb/workflows/create-agent/workflow.yaml"
|
||||
- create_workflow: "{project-root}/bmad/bmb/workflows/create-workflow/workflow.yaml"
|
||||
- create_module: "{project-root}/bmad/bmb/workflows/create-module/workflow.yaml"
|
||||
- create_agent: "{project-root}/{bmad_folder}/bmb/workflows/create-agent/workflow.yaml"
|
||||
- create_workflow: "{project-root}/{bmad_folder}/bmb/workflows/create-workflow/workflow.yaml"
|
||||
- create_module: "{project-root}/{bmad_folder}/bmb/workflows/create-module/workflow.yaml"
|
||||
|
||||
standalone: true
|
||||
|
||||
|
||||
@@ -86,20 +86,20 @@ workflow create-agent
|
||||
|
||||
**Standalone Agents:**
|
||||
|
||||
- Source: `bmad/agents/{filename}.agent.yaml`
|
||||
- Compiled: `bmad/agents/{filename}.md`
|
||||
- Source: `{bmad_folder}/agents/{filename}.agent.yaml`
|
||||
- Compiled: `{bmad_folder}/agents/{filename}.md`
|
||||
|
||||
**Module Agents:**
|
||||
|
||||
- Source: `src/modules/{module}/agents/{filename}.agent.yaml`
|
||||
- Compiled: `bmad/{module}/agents/{filename}.md`
|
||||
- Compiled: `{bmad_folder}/{module}/agents/{filename}.md`
|
||||
|
||||
### YAML Structure
|
||||
|
||||
```yaml
|
||||
agent:
|
||||
metadata:
|
||||
id: bmad/{module}/agents/{filename}.md
|
||||
id: {bmad_folder}/{module}/agents/{filename}.md
|
||||
name: Agent Name
|
||||
title: Agent Title
|
||||
icon: 🤖
|
||||
@@ -117,7 +117,7 @@ agent:
|
||||
|
||||
### Optional Customize File
|
||||
|
||||
Location: `bmad/_cfg/agents/{module}-{filename}.customize.yaml`
|
||||
Location: `{bmad_folder}/_cfg/agents/{module}-{filename}.customize.yaml`
|
||||
|
||||
Allows persona and menu overrides that persist through updates.
|
||||
|
||||
|
||||
@@ -31,7 +31,7 @@ _LLM-Optimized Technical Documentation for Agent Building_
|
||||
|
||||
**Required Attributes:**
|
||||
|
||||
- `id` - Unique path identifier (e.g., "bmad/bmm/agents/analyst.md")
|
||||
- `id` - Unique path identifier (e.g., "{bmad_folder}/bmm/agents/analyst.md")
|
||||
- `name` - Agent's name (e.g., "Mary", "John", "Helper")
|
||||
- `title` - Professional title (e.g., "Business Analyst", "Security Engineer")
|
||||
- `icon` - Single emoji representing the agent
|
||||
@@ -60,7 +60,7 @@ _LLM-Optimized Technical Documentation for Agent Building_
|
||||
|
||||
```xml
|
||||
<critical-actions>
|
||||
<i>Load into memory {project-root}/bmad/{module}/config.yaml and set variables</i>
|
||||
<i>Load into memory {project-root}/{bmad_folder}/{module}/config.yaml and set variables</i>
|
||||
<i>Remember the users name is {user_name}</i>
|
||||
<i>ALWAYS communicate in {communication_language}</i>
|
||||
<!-- Custom initialization actions -->
|
||||
@@ -77,7 +77,7 @@ _LLM-Optimized Technical Documentation for Agent Building_
|
||||
<i critical="MANDATORY">You MUST follow all rules in instructions.md on EVERY interaction</i>
|
||||
|
||||
<!-- Standard initialization -->
|
||||
<i>Load into memory {project-root}/bmad/{module}/config.yaml and set variables</i>
|
||||
<i>Load into memory {project-root}/{bmad_folder}/{module}/config.yaml and set variables</i>
|
||||
<i>Remember the users name is {user_name}</i>
|
||||
<i>ALWAYS communicate in {communication_language}</i>
|
||||
|
||||
@@ -162,9 +162,9 @@ _LLM-Optimized Technical Documentation for Agent Building_
|
||||
|
||||
```xml
|
||||
<module-integration>
|
||||
<module-path>{project-root}/bmad/{module-code}</module-path>
|
||||
<module-path>{project-root}/{bmad_folder}/{module-code}</module-path>
|
||||
<config-source>{module-path}/config.yaml</config-source>
|
||||
<workflows-path>{project-root}/bmad/{module-code}/workflows</workflows-path>
|
||||
<workflows-path>{project-root}/{bmad_folder}/{module-code}/workflows</workflows-path>
|
||||
</module-integration>
|
||||
```
|
||||
|
||||
@@ -186,7 +186,7 @@ Example: `{config_source}:output_folder`
|
||||
### Path Construction
|
||||
|
||||
```
|
||||
Good: {project-root}/bmad/{module}/agents/
|
||||
Good: {project-root}/{bmad_folder}/{module}/agents/
|
||||
Bad: /absolute/path/to/agents/
|
||||
Bad: ../../../relative/paths/
|
||||
```
|
||||
@@ -197,7 +197,7 @@ Bad: ../../../relative/paths/
|
||||
|
||||
```xml
|
||||
<!-- Full path -->
|
||||
<item cmd="*create-prd" run-workflow="{project-root}/bmad/bmm/workflows/prd/workflow.yaml">
|
||||
<item cmd="*create-prd" run-workflow="{project-root}/{bmad_folder}/bmm/workflows/prd/workflow.yaml">
|
||||
Create Product Requirements Document
|
||||
</item>
|
||||
|
||||
@@ -210,7 +210,7 @@ Bad: ../../../relative/paths/
|
||||
### Task Commands
|
||||
|
||||
```xml
|
||||
<item cmd="*validate" exec="{project-root}/bmad/core/tasks/validate-workflow.xml">
|
||||
<item cmd="*validate" exec="{project-root}/{bmad_folder}/core/tasks/validate-workflow.xml">
|
||||
Validate document
|
||||
</item>
|
||||
```
|
||||
@@ -219,8 +219,8 @@ Bad: ../../../relative/paths/
|
||||
|
||||
```xml
|
||||
<item cmd="*brief"
|
||||
exec="{project-root}/bmad/core/tasks/create-doc.md"
|
||||
tmpl="{project-root}/bmad/bmm/templates/brief.md">
|
||||
exec="{project-root}/{bmad_folder}/core/tasks/create-doc.md"
|
||||
tmpl="{project-root}/{bmad_folder}/bmm/templates/brief.md">
|
||||
Create project brief
|
||||
</item>
|
||||
```
|
||||
@@ -229,8 +229,8 @@ Bad: ../../../relative/paths/
|
||||
|
||||
```xml
|
||||
<item cmd="*standup"
|
||||
exec="{project-root}/bmad/bmm/tasks/daily-standup.xml"
|
||||
data="{project-root}/bmad/_cfg/agent-manifest.csv">
|
||||
exec="{project-root}/{bmad_folder}/bmm/tasks/daily-standup.xml"
|
||||
data="{project-root}/{bmad_folder}/_cfg/agent-manifest.csv">
|
||||
Run daily standup
|
||||
</item>
|
||||
```
|
||||
@@ -295,7 +295,7 @@ Bad: ../../../relative/paths/
|
||||
</persona>
|
||||
|
||||
<!-- Variable-based paths -->
|
||||
<item cmd="*run" exec="{project-root}/bmad/module/task.md">
|
||||
<item cmd="*run" exec="{project-root}/{bmad_folder}/module/task.md">
|
||||
|
||||
<!-- Required commands present -->
|
||||
<menu>
|
||||
@@ -395,7 +395,7 @@ When building agents:
|
||||
|
||||
```xml
|
||||
<critical-actions>
|
||||
<i>Load into memory {project-root}/bmad/{module}/config.yaml</i>
|
||||
<i>Load into memory {project-root}/{bmad_folder}/{module}/config.yaml</i>
|
||||
<i>Remember the users name is {user_name}</i>
|
||||
<i>ALWAYS communicate in {communication_language}</i>
|
||||
</critical-actions>
|
||||
@@ -404,7 +404,7 @@ When building agents:
|
||||
### Module Agent Pattern
|
||||
|
||||
```xml
|
||||
<agent id="bmad/{module}/agents/{name}.md"
|
||||
<agent id="{bmad_folder}/{module}/agents/{name}.md"
|
||||
name="{Name}"
|
||||
title="{Title}"
|
||||
icon="{emoji}">
|
||||
|
||||
@@ -67,14 +67,14 @@ Execute complete multi-step processes
|
||||
```xml
|
||||
<!-- Standard workflow -->
|
||||
<item cmd="*create-prd"
|
||||
run-workflow="{project-root}/bmad/bmm/workflows/prd/workflow.yaml">
|
||||
run-workflow="{project-root}/{bmad_folder}/bmm/workflows/prd/workflow.yaml">
|
||||
Create Product Requirements Document
|
||||
</item>
|
||||
|
||||
<!-- Workflow with validation -->
|
||||
<item cmd="*validate-prd"
|
||||
validate-workflow="{output_folder}/prd-draft.md"
|
||||
workflow="{project-root}/bmad/bmm/workflows/prd/workflow.yaml">
|
||||
workflow="{project-root}/{bmad_folder}/bmm/workflows/prd/workflow.yaml">
|
||||
Validate PRD Against Checklist
|
||||
</item>
|
||||
|
||||
@@ -112,14 +112,14 @@ Execute single operations
|
||||
```xml
|
||||
<!-- Simple task -->
|
||||
<item cmd="*validate"
|
||||
exec="{project-root}/bmad/core/tasks/validate-workflow.xml">
|
||||
exec="{project-root}/{bmad_folder}/core/tasks/validate-workflow.xml">
|
||||
Validate document against checklist
|
||||
</item>
|
||||
|
||||
<!-- Task with data -->
|
||||
<item cmd="*standup"
|
||||
exec="{project-root}/bmad/mmm/tasks/daily-standup.xml"
|
||||
data="{project-root}/bmad/_cfg/agent-manifest.csv">
|
||||
exec="{project-root}/{bmad_folder}/mmm/tasks/daily-standup.xml"
|
||||
data="{project-root}/{bmad_folder}/_cfg/agent-manifest.csv">
|
||||
Run agile team standup
|
||||
</item>
|
||||
```
|
||||
@@ -137,15 +137,15 @@ Generate documents from templates
|
||||
|
||||
```xml
|
||||
<item cmd="*brief"
|
||||
exec="{project-root}/bmad/core/tasks/create-doc.md"
|
||||
tmpl="{project-root}/bmad/bmm/templates/brief.md">
|
||||
exec="{project-root}/{bmad_folder}/core/tasks/create-doc.md"
|
||||
tmpl="{project-root}/{bmad_folder}/bmm/templates/brief.md">
|
||||
Produce Project Brief
|
||||
</item>
|
||||
|
||||
<item cmd="*competitor-analysis"
|
||||
exec="{project-root}/bmad/core/tasks/create-doc.md"
|
||||
tmpl="{project-root}/bmad/bmm/templates/competitor.md"
|
||||
data="{project-root}/bmad/_data/market-research.csv">
|
||||
exec="{project-root}/{bmad_folder}/core/tasks/create-doc.md"
|
||||
tmpl="{project-root}/{bmad_folder}/bmm/templates/competitor.md"
|
||||
data="{project-root}/{bmad_folder}/_data/market-research.csv">
|
||||
Produce Competitor Analysis
|
||||
</item>
|
||||
```
|
||||
@@ -174,7 +174,7 @@ Direct prompts embedded in commands (Simple agents)
|
||||
```xml
|
||||
<!-- Short action attribute with embedded prompt -->
|
||||
<item cmd="*list-tasks"
|
||||
action="list all tasks from {project-root}/bmad/_cfg/task-manifest.csv">
|
||||
action="list all tasks from {project-root}/{bmad_folder}/_cfg/task-manifest.csv">
|
||||
List Available Tasks
|
||||
</item>
|
||||
|
||||
@@ -227,7 +227,7 @@ For multiline/complex prompts, define them separately and reference by id:
|
||||
|
||||
<item cmd="*review-literature"
|
||||
action="#literature-review"
|
||||
data="{project-root}/bmad/_data/sources.csv">
|
||||
data="{project-root}/{bmad_folder}/_data/sources.csv">
|
||||
Conduct Literature Review
|
||||
</item>
|
||||
|
||||
@@ -407,23 +407,23 @@ The `data` attribute can be added to ANY command type to provide supplementary i
|
||||
```xml
|
||||
<!-- Workflow with data -->
|
||||
<item cmd="*brainstorm"
|
||||
run-workflow="{project-root}/bmad/core/workflows/brainstorming/workflow.yaml"
|
||||
data="{project-root}/bmad/core/workflows/brainstorming/brain-methods.csv">
|
||||
run-workflow="{project-root}/{bmad_folder}/core/workflows/brainstorming/workflow.yaml"
|
||||
data="{project-root}/{bmad_folder}/core/workflows/brainstorming/brain-methods.csv">
|
||||
Creative Brainstorming Session
|
||||
</item>
|
||||
|
||||
<!-- Action with data -->
|
||||
<item cmd="*analyze-metrics"
|
||||
action="analyze these metrics and identify trends"
|
||||
data="{project-root}/bmad/_data/performance-metrics.json">
|
||||
data="{project-root}/{bmad_folder}/_data/performance-metrics.json">
|
||||
Analyze Performance Metrics
|
||||
</item>
|
||||
|
||||
<!-- Template with data -->
|
||||
<item cmd="*report"
|
||||
exec="{project-root}/bmad/core/tasks/create-doc.md"
|
||||
tmpl="{project-root}/bmad/bmm/templates/report.md"
|
||||
data="{project-root}/bmad/_data/quarterly-results.csv">
|
||||
exec="{project-root}/{bmad_folder}/core/tasks/create-doc.md"
|
||||
tmpl="{project-root}/{bmad_folder}/bmm/templates/report.md"
|
||||
data="{project-root}/{bmad_folder}/_data/quarterly-results.csv">
|
||||
Generate Quarterly Report
|
||||
</item>
|
||||
```
|
||||
@@ -572,14 +572,14 @@ The `data` attribute can be added to ANY command type to provide supplementary i
|
||||
```xml
|
||||
<!-- Create document -->
|
||||
<item cmd="*{action}-{object}"
|
||||
run-workflow="{project-root}/bmad/{module}/workflows/{workflow}/workflow.yaml">
|
||||
run-workflow="{project-root}/{bmad_folder}/{module}/workflows/{workflow}/workflow.yaml">
|
||||
{Action} {Object Description}
|
||||
</item>
|
||||
|
||||
<!-- Validate document -->
|
||||
<item cmd="*validate-{object}"
|
||||
validate-workflow="{output_folder}/{document}.md"
|
||||
workflow="{project-root}/bmad/{module}/workflows/{workflow}/workflow.yaml">
|
||||
workflow="{project-root}/{bmad_folder}/{module}/workflows/{workflow}/workflow.yaml">
|
||||
Validate {Object Description}
|
||||
</item>
|
||||
```
|
||||
@@ -588,7 +588,7 @@ The `data` attribute can be added to ANY command type to provide supplementary i
|
||||
|
||||
```xml
|
||||
<item cmd="*{action}"
|
||||
exec="{project-root}/bmad/{module}/tasks/{task}.md">
|
||||
exec="{project-root}/{bmad_folder}/{module}/tasks/{task}.md">
|
||||
{Action Description}
|
||||
</item>
|
||||
```
|
||||
@@ -597,8 +597,8 @@ The `data` attribute can be added to ANY command type to provide supplementary i
|
||||
|
||||
```xml
|
||||
<item cmd="*{document}"
|
||||
exec="{project-root}/bmad/core/tasks/create-doc.md"
|
||||
tmpl="{project-root}/bmad/{module}/templates/{template}.md">
|
||||
exec="{project-root}/{bmad_folder}/core/tasks/create-doc.md"
|
||||
tmpl="{project-root}/{bmad_folder}/{module}/templates/{template}.md">
|
||||
Create {Document Name}
|
||||
</item>
|
||||
```
|
||||
@@ -631,7 +631,7 @@ The `data` attribute can be added to ANY command type to provide supplementary i
|
||||
### Complete Self-Contained Agent
|
||||
|
||||
```xml
|
||||
<agent id="bmad/research/agents/analyst.md" name="Research Analyst" icon="🔬">
|
||||
<agent id="{bmad_folder}/research/agents/analyst.md" name="Research Analyst" icon="🔬">
|
||||
<!-- Embedded prompt library -->
|
||||
<prompts>
|
||||
<prompt id="swot-analysis">
|
||||
@@ -688,14 +688,14 @@ The `data` attribute can be added to ANY command type to provide supplementary i
|
||||
|
||||
<item cmd="*compete"
|
||||
action="#competitive-intel"
|
||||
data="{project-root}/bmad/_data/market-data.csv">
|
||||
data="{project-root}/{bmad_folder}/_data/market-data.csv">
|
||||
Analyze Competition
|
||||
</item>
|
||||
|
||||
<!-- Hybrid: external task with internal data -->
|
||||
<item cmd="*report"
|
||||
exec="{project-root}/bmad/core/tasks/create-doc.md"
|
||||
tmpl="{project-root}/bmad/research/templates/report.md">
|
||||
exec="{project-root}/{bmad_folder}/core/tasks/create-doc.md"
|
||||
tmpl="{project-root}/{bmad_folder}/research/templates/report.md">
|
||||
Generate Research Report
|
||||
</item>
|
||||
|
||||
@@ -721,7 +721,7 @@ For agents that primarily use embedded logic:
|
||||
|
||||
<item cmd="*analyze"
|
||||
action="perform statistical analysis on the provided data"
|
||||
data="{project-root}/bmad/_data/dataset.csv">
|
||||
data="{project-root}/{bmad_folder}/_data/dataset.csv">
|
||||
Analyze Dataset
|
||||
</item>
|
||||
|
||||
|
||||
@@ -8,10 +8,10 @@ BMAD agents come in three distinct types, each designed for different use cases
|
||||
|
||||
### Standalone Agents (Simple & Expert)
|
||||
|
||||
Live in their own dedicated directories under `bmad/agents/`:
|
||||
Live in their own dedicated directories under `{bmad_folder}/agents/`:
|
||||
|
||||
```
|
||||
bmad/agents/
|
||||
{bmad_folder}/agents/
|
||||
├── my-helper/ # Simple agent
|
||||
│ ├── my-helper.agent.yaml # Agent definition
|
||||
│ └── my-helper.md # Built XML (generated)
|
||||
@@ -28,10 +28,10 @@ bmad/agents/
|
||||
|
||||
### Module Agents
|
||||
|
||||
Part of a module system under `bmad/{module}/agents/`:
|
||||
Part of a module system under `{bmad_folder}/{module}/agents/`:
|
||||
|
||||
```
|
||||
bmad/bmm/agents/
|
||||
{bmad_folder}/bmm/agents/
|
||||
├── product-manager.agent.yaml
|
||||
├── product-manager.md # Built XML
|
||||
├── business-analyst.agent.yaml
|
||||
@@ -44,7 +44,7 @@ bmad/bmm/agents/
|
||||
|
||||
**Purpose:** Self-contained, standalone agents with embedded capabilities
|
||||
|
||||
**Location:** `bmad/agents/{agent-name}/`
|
||||
**Location:** `{bmad_folder}/agents/{agent-name}/`
|
||||
|
||||
**Characteristics:**
|
||||
|
||||
@@ -105,7 +105,7 @@ agent:
|
||||
|
||||
**Purpose:** Specialized agents with domain expertise and sidecar resources
|
||||
|
||||
**Location:** `bmad/agents/{agent-name}/` with sidecar directory
|
||||
**Location:** `{bmad_folder}/agents/{agent-name}/` with sidecar directory
|
||||
|
||||
**Characteristics:**
|
||||
|
||||
@@ -168,7 +168,7 @@ agent:
|
||||
**Complete Directory Structure:**
|
||||
|
||||
```
|
||||
bmad/agents/expert-agent/
|
||||
{bmad_folder}/agents/expert-agent/
|
||||
├── expert-agent.agent.yaml # Agent YAML source
|
||||
├── expert-agent.md # Built XML (generated)
|
||||
└── expert-agent-sidecar/ # Sidecar resources
|
||||
@@ -183,7 +183,7 @@ bmad/agents/expert-agent/
|
||||
|
||||
**Purpose:** Full-featured agents belonging to a module with access to workflows and resources
|
||||
|
||||
**Location:** `bmad/{module}/agents/`
|
||||
**Location:** `{bmad_folder}/{module}/agents/`
|
||||
|
||||
**Characteristics:**
|
||||
|
||||
@@ -216,20 +216,20 @@ agent:
|
||||
communication_style: '...'
|
||||
principles: ['...']
|
||||
critical_actions:
|
||||
- 'Load config from {project-root}/bmad/{module}/config.yaml'
|
||||
- 'Load config from {project-root}/{bmad_folder}/{module}/config.yaml'
|
||||
menu:
|
||||
- trigger: create-prd
|
||||
workflow: '{project-root}/bmad/bmm/workflows/prd/workflow.yaml'
|
||||
workflow: '{project-root}/{bmad_folder}/bmm/workflows/prd/workflow.yaml'
|
||||
description: 'Create PRD'
|
||||
- trigger: validate
|
||||
exec: '{project-root}/bmad/core/tasks/validate-workflow.xml'
|
||||
exec: '{project-root}/{bmad_folder}/core/tasks/validate-workflow.xml'
|
||||
description: 'Validate document'
|
||||
```
|
||||
|
||||
**XML Structure (built):**
|
||||
|
||||
```xml
|
||||
<agent id="bmad/bmm/agents/pm.md" name="John" title="Product Manager" icon="📋">
|
||||
<agent id="{bmad_folder}/bmm/agents/pm.md" name="John" title="Product Manager" icon="📋">
|
||||
<persona>
|
||||
<role>Product Management Expert</role>
|
||||
<identity>...</identity>
|
||||
@@ -237,12 +237,12 @@ agent:
|
||||
<principles>...</principles>
|
||||
</persona>
|
||||
<critical-actions>
|
||||
<i>Load config from {project-root}/bmad/{module}/config.yaml</i>
|
||||
<i>Load config from {project-root}/{bmad_folder}/{module}/config.yaml</i>
|
||||
</critical-actions>
|
||||
<menu>
|
||||
<item cmd="*help">Show numbered menu</item>
|
||||
<item cmd="*create-prd" run-workflow="{project-root}/bmad/bmm/workflows/prd/workflow.yaml">Create PRD</item>
|
||||
<item cmd="*validate" exec="{project-root}/bmad/core/tasks/validate-workflow.xml">Validate document</item>
|
||||
<item cmd="*create-prd" run-workflow="{project-root}/{bmad_folder}/bmm/workflows/prd/workflow.yaml">Create PRD</item>
|
||||
<item cmd="*validate" exec="{project-root}/{bmad_folder}/core/tasks/validate-workflow.xml">Validate document</item>
|
||||
<item cmd="*exit">Exit</item>
|
||||
</menu>
|
||||
</agent>
|
||||
|
||||
@@ -11,7 +11,7 @@
|
||||
|
||||
### Core Components
|
||||
|
||||
- [ ] `metadata.id` points to final compiled path: `bmad/{{module}}/agents/{{agent}}.md`
|
||||
- [ ] `metadata.id` points to final compiled path: `{bmad_folder}/{{module}}/agents/{{agent}}.md`
|
||||
- [ ] `metadata.module` matches the module folder (e.g., `bmm`, `bmb`, `cis`)
|
||||
- [ ] Principles are an array (preferred) or string with clear values
|
||||
|
||||
@@ -34,12 +34,12 @@
|
||||
|
||||
- [ ] `prompts` defined when using `action: "#id"`
|
||||
- [ ] `critical_actions` present if custom activation steps are needed
|
||||
- [ ] Customize file (if created) located at `{project-root}/bmad/_cfg/agents/{{module}}-{{agent}}.customize.yaml`
|
||||
- [ ] Customize file (if created) located at `{project-root}/{bmad_folder}/_cfg/agents/{{module}}-{{agent}}.customize.yaml`
|
||||
|
||||
## Build Verification
|
||||
|
||||
- [ ] Run compile to build `.md`: `npm run install:bmad` → "Compile Agents" (or `bmad install` → Compile)
|
||||
- [ ] Confirm compiled file exists at `{project-root}/bmad/{{module}}/agents/{{agent}}.md`
|
||||
- [ ] Confirm compiled file exists at `{project-root}/{bmad_folder}/{{module}}/agents/{{agent}}.md`
|
||||
|
||||
## Final Quality
|
||||
|
||||
|
||||
@@ -1,8 +1,8 @@
|
||||
# Build Agent - Interactive Agent Builder Instructions
|
||||
|
||||
<critical>The workflow execution engine is governed by: {project-root}/bmad/core/tasks/workflow.xml</critical>
|
||||
<critical>You MUST have already loaded and processed: {project-root}/bmad/bmb/workflows/create-agent/workflow.yaml</critical>
|
||||
<critical>Study YAML agent examples in: {project-root}/bmad/bmm/agents/ for patterns</critical>
|
||||
<critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
|
||||
<critical>You MUST have already loaded and processed: {project-root}/{bmad_folder}/bmb/workflows/create-agent/workflow.yaml</critical>
|
||||
<critical>Study YAML agent examples in: {project-root}/{bmad_folder}/bmm/agents/ for patterns</critical>
|
||||
<critical>Communicate in {communication_language} throughout the agent creation process</critical>
|
||||
|
||||
<workflow>
|
||||
@@ -11,7 +11,7 @@
|
||||
<ask>Do you want to brainstorm agent ideas first? [y/n]</ask>
|
||||
|
||||
<check if="user answered yes">
|
||||
<action>Invoke brainstorming workflow: {project-root}/bmad/core/workflows/brainstorming/workflow.yaml</action>
|
||||
<action>Invoke brainstorming workflow: {project-root}/{bmad_folder}/core/workflows/brainstorming/workflow.yaml</action>
|
||||
<action>Pass context data: {installed_path}/brainstorm-context.md</action>
|
||||
<action>Wait for brainstorming session completion</action>
|
||||
<action>Use brainstorming output to inform agent identity and persona development in following steps</action>
|
||||
@@ -51,19 +51,19 @@
|
||||
<check if="module agent selected">
|
||||
<action>Discover which module system fits best (bmm, bmb, cis, or custom)</action>
|
||||
<action>Store as {{target_module}} for path determination</action>
|
||||
<note>Agent will be saved to: bmad/{{target_module}}/agents/</note>
|
||||
<note>Agent will be saved to: {bmad_folder}/{{target_module}}/agents/</note>
|
||||
</check>
|
||||
|
||||
<check if="standalone agent selected">
|
||||
<action>Explain this will be their personal agent, not tied to a module</action>
|
||||
<note>Agent will be saved to: bmad/agents/{{agent-name}}/</note>
|
||||
<note>Agent will be saved to: {bmad_folder}/agents/{{agent-name}}/</note>
|
||||
<note>All sidecar files will be in the same folder</note>
|
||||
</check>
|
||||
|
||||
<critical>Determine agent location:</critical>
|
||||
|
||||
- Module Agent → bmad/{{module}}/agents/{{agent-name}}.agent.yaml
|
||||
- Standalone Agent → bmad/agents/{{agent-name}}/{{agent-name}}.agent.yaml
|
||||
- Module Agent → {bmad_folder}/{{module}}/agents/{{agent-name}}.agent.yaml
|
||||
- Standalone Agent → {bmad_folder}/agents/{{agent-name}}/{{agent-name}}.agent.yaml
|
||||
|
||||
<note>Keep agent naming/identity details for later - let them emerge naturally through the creation process</note>
|
||||
|
||||
@@ -197,8 +197,8 @@ menu:
|
||||
# For cross-module workflow references (advanced):
|
||||
|
||||
- trigger: [another capability]
|
||||
workflow: "{project-root}/bmad/SOURCE_MODULE/workflows/path/to/workflow.yaml"
|
||||
workflow-install: "{project-root}/bmad/THIS_MODULE/workflows/vendored/path/workflow.yaml"
|
||||
workflow: "{project-root}/{bmad_folder}/SOURCE_MODULE/workflows/path/to/workflow.yaml"
|
||||
workflow-install: "{project-root}/{bmad_folder}/THIS_MODULE/workflows/vendored/path/workflow.yaml"
|
||||
description: [description]
|
||||
|
||||
`````
|
||||
@@ -238,7 +238,7 @@ This is typically used when creating specialized modules that reuse common workf
|
||||
<example type="yaml">
|
||||
agent:
|
||||
metadata:
|
||||
id: bmad/{{target_module}}/agents/{{agent_filename}}.md
|
||||
id: {bmad_folder}/{{target_module}}/agents/{{agent_filename}}.md
|
||||
name: {{agent_name}} # The name chosen together
|
||||
title: {{agent_title}} # From the role that emerged
|
||||
icon: {{agent_icon}} # The perfect emoji
|
||||
|
||||
@@ -4,7 +4,7 @@ description: "Interactive workflow to build BMAD Core compliant agents (YAML sou
|
||||
author: "BMad"
|
||||
|
||||
# Critical variables load from config_source
|
||||
config_source: "{project-root}/bmad/bmb/config.yaml"
|
||||
config_source: "{project-root}/{bmad_folder}/bmb/config.yaml"
|
||||
custom_agent_location: "{config_source}:custom_agent_location"
|
||||
user_name: "{config_source}:user_name"
|
||||
communication_language: "{config_source}:communication_language"
|
||||
@@ -17,22 +17,22 @@ communication_styles: "{installed_path}/communication-styles.md"
|
||||
|
||||
# Optional docs that help understand agent patterns
|
||||
recommended_inputs:
|
||||
- example_agents: "{project-root}/bmad/bmm/agents/"
|
||||
- example_agents: "{project-root}/{bmad_folder}/bmm/agents/"
|
||||
- agent_activation_rules: "{project-root}/src/utility/models/agent-activation-ide.xml"
|
||||
|
||||
# Module path and component files
|
||||
installed_path: "{project-root}/bmad/bmb/workflows/create-agent"
|
||||
installed_path: "{project-root}/{bmad_folder}/bmb/workflows/create-agent"
|
||||
template: false # This is an interactive workflow - no template needed
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
validation: "{installed_path}/checklist.md"
|
||||
|
||||
# Output configuration - YAML agents compiled to .md at install time
|
||||
# Module agents: Save to bmad/{{target_module}}/agents/
|
||||
# Module agents: Save to {bmad_folder}/{{target_module}}/agents/
|
||||
# Standalone agents: Save to custom_agent_location/
|
||||
module_output_file: "{project-root}/bmad/{{target_module}}/agents/{{agent_filename}}.agent.yaml"
|
||||
module_output_file: "{project-root}/{bmad_folder}/{{target_module}}/agents/{{agent_filename}}.agent.yaml"
|
||||
standalone_output_file: "{custom_agent_location}/{{agent_filename}}.agent.yaml"
|
||||
# Optional user override file (auto-created by installer if missing)
|
||||
config_output_file: "{project-root}/bmad/_cfg/agents/{{target_module}}-{{agent_filename}}.customize.yaml"
|
||||
config_output_file: "{project-root}/{bmad_folder}/_cfg/agents/{{target_module}}-{{agent_filename}}.customize.yaml"
|
||||
|
||||
standalone: true
|
||||
|
||||
@@ -41,9 +41,9 @@ web_bundle:
|
||||
description: "Interactive workflow to build BMAD Core compliant agents (simple, expert, or module types) with optional brainstorming for agent ideas, proper persona development, activation rules, and command structure"
|
||||
author: "BMad"
|
||||
web_bundle_files:
|
||||
- "bmad/bmb/workflows/create-agent/instructions.md"
|
||||
- "bmad/bmb/workflows/create-agent/checklist.md"
|
||||
- "bmad/bmb/workflows/create-agent/agent-types.md"
|
||||
- "bmad/bmb/workflows/create-agent/agent-architecture.md"
|
||||
- "bmad/bmb/workflows/create-agent/agent-command-patterns.md"
|
||||
- "bmad/bmb/workflows/create-agent/communication-styles.md"
|
||||
- "{bmad_folder}/bmb/workflows/create-agent/instructions.md"
|
||||
- "{bmad_folder}/bmb/workflows/create-agent/checklist.md"
|
||||
- "{bmad_folder}/bmb/workflows/create-agent/agent-types.md"
|
||||
- "{bmad_folder}/bmb/workflows/create-agent/agent-architecture.md"
|
||||
- "{bmad_folder}/bmb/workflows/create-agent/agent-command-patterns.md"
|
||||
- "{bmad_folder}/bmb/workflows/create-agent/communication-styles.md"
|
||||
|
||||
@@ -71,7 +71,7 @@ workflow create-module --input module-brief-{name}-{date}.md
|
||||
### Generated Directory
|
||||
|
||||
```
|
||||
bmad/{module-code}/
|
||||
{bmad_folder}/{module-code}/
|
||||
├── agents/ # Agent definitions
|
||||
├── workflows/ # Workflow processes
|
||||
├── tasks/ # Reusable tasks
|
||||
|
||||
@@ -19,7 +19,7 @@
|
||||
|
||||
## Directory Structure
|
||||
|
||||
### Source Directories (bmad/{module-code}/)
|
||||
### Source Directories ({bmad_folder}/{module-code}/)
|
||||
|
||||
- [ ] `/agents` directory created (even if empty)
|
||||
- [ ] `/workflows` directory created (even if empty)
|
||||
|
||||
@@ -80,7 +80,7 @@ prompt:
|
||||
|
||||
# EXAMPLE: Static path
|
||||
# module_data_path:
|
||||
# result: "{project-root}/bmad/{{MODULE_CODE}}/data"
|
||||
# result: "{project-root}/{bmad_folder}/{{MODULE_CODE}}/data"
|
||||
|
||||
# ============================================================================
|
||||
# YOUR MODULE CONFIGURATION FIELDS
|
||||
|
||||
@@ -1,8 +1,8 @@
|
||||
# Build Module - Interactive Module Builder Instructions
|
||||
|
||||
<critical>The workflow execution engine is governed by: {project-root}/bmad/core/tasks/workflow.xml</critical>
|
||||
<critical>You MUST have already loaded and processed: {project-root}/bmad/bmb/workflows/create-module/workflow.yaml</critical>
|
||||
<critical>Study existing modules in: {project-root}/bmad/ for patterns</critical>
|
||||
<critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
|
||||
<critical>You MUST have already loaded and processed: {project-root}/{bmad_folder}/bmb/workflows/create-module/workflow.yaml</critical>
|
||||
<critical>Study existing modules in: {project-root}/{bmad_folder}/ for patterns</critical>
|
||||
<critical>Communicate in {communication_language} throughout the module creation process</critical>
|
||||
|
||||
<workflow>
|
||||
@@ -28,7 +28,7 @@
|
||||
<ask>Do you have a module brief or should we create one? [have/create/skip]</ask>
|
||||
|
||||
<check if="create">
|
||||
<action>Invoke module-brief workflow: {project-root}/bmad/bmb/workflows/module-brief/workflow.yaml</action>
|
||||
<action>Invoke module-brief workflow: {project-root}/{bmad_folder}/bmb/workflows/module-brief/workflow.yaml</action>
|
||||
<action>Wait for module brief completion</action>
|
||||
<action>Load the module brief to use as blueprint</action>
|
||||
</check>
|
||||
@@ -64,7 +64,7 @@
|
||||
2. **Module code** - Generate kebab-case from name following patterns:
|
||||
- Multi-word descriptive names → shortened kebab-case
|
||||
- Domain-specific terms → recognizable abbreviations
|
||||
- Present suggested code and confirm it works for paths like bmad/{{code}}/agents/
|
||||
- Present suggested code and confirm it works for paths like {bmad_folder}/{{code}}/agents/
|
||||
3. **Module purpose** - Refine their description into 1-2 clear sentences
|
||||
4. **Target audience** - Infer from context or ask if unclear
|
||||
|
||||
@@ -322,7 +322,7 @@ prompt:
|
||||
|
||||
# EXAMPLE Static path:
|
||||
# data_path:
|
||||
# result: "{project-root}/bmad/{{module_code}}/data"
|
||||
# result: "{project-root}/{bmad_folder}/{{module_code}}/data"
|
||||
|
||||
{{generated_config_fields_from_step_4}}
|
||||
```
|
||||
@@ -446,7 +446,7 @@ bmad install {{module_code}}
|
||||
|
||||
## Configuration
|
||||
|
||||
The module can be configured in `bmad/{{module_code}}/config.yaml`
|
||||
The module can be configured in `{bmad_folder}/{{module_code}}/config.yaml`
|
||||
|
||||
Key settings:
|
||||
{{configuration_options}}
|
||||
|
||||
@@ -24,7 +24,7 @@ src/modules/{module-code}/
|
||||
└── README.md # Module documentation
|
||||
|
||||
# INSTALLED MODULE (in target project)
|
||||
{project-root}/bmad/{module-code}/
|
||||
{project-root}/{bmad_folder}/{module-code}/
|
||||
├── agents/ # Compiled agent files (.md)
|
||||
├── workflows/ # Workflow instances
|
||||
├── tasks/ # Task files
|
||||
@@ -145,8 +145,8 @@ For modules that need workflows from other modules but want to remain standalone
|
||||
```yaml
|
||||
menu:
|
||||
- trigger: command-name
|
||||
workflow: '{project-root}/bmad/SOURCE_MODULE/workflows/path/workflow.yaml'
|
||||
workflow-install: '{project-root}/bmad/THIS_MODULE/workflows/vendored/workflow.yaml'
|
||||
workflow: '{project-root}/{bmad_folder}/SOURCE_MODULE/workflows/path/workflow.yaml'
|
||||
workflow-install: '{project-root}/{bmad_folder}/THIS_MODULE/workflows/vendored/workflow.yaml'
|
||||
description: 'Command description'
|
||||
```
|
||||
|
||||
@@ -216,7 +216,7 @@ module_version:
|
||||
result: '1.0.0'
|
||||
|
||||
data_path:
|
||||
result: '{project-root}/bmad/module-code/data'
|
||||
result: '{project-root}/{bmad_folder}/module-code/data'
|
||||
```
|
||||
|
||||
**Key Points:**
|
||||
|
||||
@@ -4,7 +4,7 @@ description: "Interactive workflow to build complete BMAD modules with agents, w
|
||||
author: "BMad"
|
||||
|
||||
# Critical variables load from config_source
|
||||
config_source: "{project-root}/bmad/bmb/config.yaml"
|
||||
config_source: "{project-root}/{bmad_folder}/bmb/config.yaml"
|
||||
custom_module_location: "{config_source}:custom_module_location"
|
||||
communication_language: "{config_source}:communication_language"
|
||||
user_name: "{config_source}:user_name"
|
||||
@@ -14,22 +14,22 @@ module_structure_guide: "{installed_path}/module-structure.md"
|
||||
installer_templates: "{installed_path}/installer-templates/"
|
||||
|
||||
# Use existing build workflows
|
||||
agent_builder: "{project-root}/bmad/bmb/workflows/create-agent/workflow.yaml"
|
||||
workflow_builder: "{project-root}/bmad/bmb/workflows/create-workflow/workflow.yaml"
|
||||
brainstorming_workflow: "{project-root}/bmad/core/workflows/brainstorming/workflow.yaml"
|
||||
agent_builder: "{project-root}/{bmad_folder}/bmb/workflows/create-agent/workflow.yaml"
|
||||
workflow_builder: "{project-root}/{bmad_folder}/bmb/workflows/create-workflow/workflow.yaml"
|
||||
brainstorming_workflow: "{project-root}/{bmad_folder}/core/workflows/brainstorming/workflow.yaml"
|
||||
brainstorming_context: "{installed_path}/brainstorm-context.md"
|
||||
|
||||
# Optional docs that help understand module patterns
|
||||
recommended_inputs:
|
||||
- module_brief: "{output_folder}/module-brief-*.md"
|
||||
- brainstorming_results: "{output_folder}/brainstorming-*.md"
|
||||
- bmm_module: "{project-root}/bmad/bmm/"
|
||||
- cis_module: "{project-root}/bmad/cis/"
|
||||
- existing_agents: "{project-root}/bmad/*/agents/"
|
||||
- existing_workflows: "{project-root}/bmad/*/workflows/"
|
||||
- bmm_module: "{project-root}/{bmad_folder}/bmm/"
|
||||
- cis_module: "{project-root}/{bmad_folder}/cis/"
|
||||
- existing_agents: "{project-root}/{bmad_folder}/*/agents/"
|
||||
- existing_workflows: "{project-root}/{bmad_folder}/*/workflows/"
|
||||
|
||||
# Module path and component files
|
||||
installed_path: "{project-root}/bmad/bmb/workflows/create-module"
|
||||
installed_path: "{project-root}/{bmad_folder}/bmb/workflows/create-module"
|
||||
template: false # This is an interactive scaffolding workflow
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
validation: "{installed_path}/checklist.md"
|
||||
|
||||
@@ -159,7 +159,7 @@ The brainstorming phase invokes the CIS brainstorming workflow to:
|
||||
### Generated Workflow Folder
|
||||
|
||||
Creates a complete workflow folder at:
|
||||
`{project-root}/bmad/{{target_module}}/workflows/{{workflow_name}}/`
|
||||
`{project-root}/{bmad_folder}/{{target_module}}/workflows/{{workflow_name}}/`
|
||||
|
||||
### Files Created
|
||||
|
||||
@@ -267,9 +267,9 @@ To modify this workflow:
|
||||
|
||||
For issues or questions:
|
||||
|
||||
- Review `/bmad/bmb/workflows/create-workflow/workflow-creation-guide.md`
|
||||
- Check existing workflows in `/bmad/bmm/workflows/` for examples
|
||||
- Validate against `/bmad/bmb/workflows/create-workflow/checklist.md`
|
||||
- Review `/{bmad_folder}/bmb/workflows/create-workflow/workflow-creation-guide.md`
|
||||
- Check existing workflows in `/{bmad_folder}/bmm/workflows/` for examples
|
||||
- Validate against `/{bmad_folder}/bmb/workflows/create-workflow/checklist.md`
|
||||
- Consult BMAD Method v6 documentation
|
||||
|
||||
---
|
||||
|
||||
@@ -61,7 +61,7 @@
|
||||
|
||||
- [ ] web_bundle section present if needed
|
||||
- [ ] Name, description, author copied from main config
|
||||
- [ ] All file paths converted to bmad/-relative format
|
||||
- [ ] All file paths converted to {bmad_folder}/-relative format
|
||||
- [ ] NO {config_source} variables in web bundle
|
||||
- [ ] NO {project-root} prefixes in paths
|
||||
- [ ] Instructions path listed correctly
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# Build Workflow - Workflow Builder Instructions
|
||||
|
||||
<critical>The workflow execution engine is governed by: {project-root}/bmad/core/tasks/workflow.xml</critical>
|
||||
<critical>You MUST have already loaded and processed: {project-root}/bmad/bmb/workflows/create-workflow/workflow.yaml</critical>
|
||||
<critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
|
||||
<critical>You MUST have already loaded and processed: {project-root}/{bmad_folder}/bmb/workflows/create-workflow/workflow.yaml</critical>
|
||||
<critical>You MUST fully understand the workflow creation guide at: {workflow_creation_guide}</critical>
|
||||
<critical>Study the guide thoroughly to follow ALL conventions for optimal human-AI collaboration</critical>
|
||||
<critical>Communicate in {communication_language} throughout the workflow creation process</critical>
|
||||
@@ -13,7 +13,7 @@
|
||||
|
||||
<action if="user_response == 'y' or user_response == 'yes'">
|
||||
Invoke brainstorming workflow to explore ideas and design concepts:
|
||||
- Workflow: {project-root}/bmad/core/workflows/brainstorming/workflow.yaml
|
||||
- Workflow: {project-root}/{bmad_folder}/core/workflows/brainstorming/workflow.yaml
|
||||
- Context data: {installed_path}/brainstorm-context.md
|
||||
- Purpose: Generate creative workflow ideas, explore different approaches, and clarify requirements
|
||||
|
||||
@@ -255,7 +255,7 @@ Include:
|
||||
|
||||
```yaml
|
||||
# Critical variables from config
|
||||
config_source: '{project-root}/bmad/{{target_module}}/config.yaml'
|
||||
config_source: '{project-root}/{bmad_folder}/{{target_module}}/config.yaml'
|
||||
output_folder: '{config_source}:output_folder'
|
||||
user_name: '{config_source}:user_name'
|
||||
communication_language: '{config_source}:communication_language'
|
||||
@@ -277,13 +277,13 @@ name: 'workflow-name'
|
||||
description: 'Clear purpose statement'
|
||||
|
||||
# Paths
|
||||
installed_path: '{project-root}/bmad/module/workflows/name'
|
||||
installed_path: '{project-root}/{bmad_folder}/module/workflows/name'
|
||||
template: '{installed_path}/template.md'
|
||||
instructions: '{installed_path}/instructions.md'
|
||||
validation: '{installed_path}/checklist.md'
|
||||
|
||||
# Critical variables from config
|
||||
config_source: '{project-root}/bmad/module/config.yaml'
|
||||
config_source: '{project-root}/{bmad_folder}/module/config.yaml'
|
||||
output_folder: '{config_source}:output_folder'
|
||||
user_name: '{config_source}:user_name'
|
||||
communication_language: '{config_source}:communication_language'
|
||||
@@ -314,7 +314,7 @@ Load and use the template at: {template_instructions}
|
||||
Generate the instructions.md file following the workflow creation guide:
|
||||
|
||||
1. ALWAYS include critical headers:
|
||||
- Workflow engine reference: {project-root}/bmad/core/tasks/workflow.xml
|
||||
- Workflow engine reference: {project-root}/{bmad_folder}/core/tasks/workflow.xml
|
||||
- workflow.yaml reference: must be loaded and processed
|
||||
|
||||
2. Structure with <workflow> tags containing all steps
|
||||
@@ -328,7 +328,7 @@ Generate the instructions.md file following the workflow creation guide:
|
||||
|
||||
4. Use proper XML tags from guide:
|
||||
- Execution: <action>, <check>, <ask>, <goto>, <invoke-workflow>
|
||||
- Output: <template-output>, <invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>, <critical>, <example>
|
||||
- Output: <template-output>, <invoke-task halt="true">{project-root}/{bmad_folder}/core/tasks/adv-elicit.xml</invoke-task>, <critical>, <example>
|
||||
- Flow: <loop>, <break>, <continue>
|
||||
|
||||
5. Best practices from guide:
|
||||
@@ -616,15 +616,15 @@ If yes:
|
||||
|
||||
- Web bundles are self-contained and cannot use config_source variables
|
||||
- All files must be explicitly listed in web_bundle_files
|
||||
- File paths use bmad/ root (not {project-root})
|
||||
- File paths use {bmad_folder}/ root (not {project-root})
|
||||
|
||||
<action>Configure web_bundle section in workflow.yaml:</action>
|
||||
|
||||
1. Copy core workflow metadata (name, description, author)
|
||||
2. Convert all file paths to bmad/-relative paths:
|
||||
2. Convert all file paths to {bmad_folder}/-relative paths:
|
||||
- Remove {project-root}/ prefix
|
||||
- Remove {config_source} references (use hardcoded values)
|
||||
- Example: "{project-root}/bmad/bmm/workflows/x" → "bmad/bmm/workflows/x"
|
||||
- Example: "{project-root}/{bmad_folder}/bmm/workflows/x" → "{bmad_folder}/bmm/workflows/x"
|
||||
|
||||
3. List ALL referenced files by scanning:
|
||||
|
||||
@@ -642,8 +642,8 @@ If yes:
|
||||
|
||||
**Critical: Workflow Dependencies**
|
||||
- If instructions call another workflow, that workflow's yaml MUST be in web_bundle_files
|
||||
- Example: `<invoke-workflow>{project-root}/bmad/core/workflows/x/workflow.yaml</invoke-workflow>`
|
||||
→ Add "bmad/core/workflows/x/workflow.yaml" to web_bundle_files
|
||||
- Example: `<invoke-workflow>{project-root}/{bmad_folder}/core/workflows/x/workflow.yaml</invoke-workflow>`
|
||||
→ Add "{bmad_folder}/core/workflows/x/workflow.yaml" to web_bundle_files
|
||||
|
||||
4. Create web_bundle_files array with complete list
|
||||
|
||||
@@ -654,24 +654,24 @@ web_bundle:
|
||||
name: '{workflow_name}'
|
||||
description: '{workflow_description}'
|
||||
author: '{author}'
|
||||
instructions: 'bmad/{module}/workflows/{workflow}/instructions.md'
|
||||
validation: 'bmad/{module}/workflows/{workflow}/checklist.md'
|
||||
template: 'bmad/{module}/workflows/{workflow}/template.md'
|
||||
instructions: '{bmad_folder}/{module}/workflows/{workflow}/instructions.md'
|
||||
validation: '{bmad_folder}/{module}/workflows/{workflow}/checklist.md'
|
||||
template: '{bmad_folder}/{module}/workflows/{workflow}/template.md'
|
||||
|
||||
# Any data files (no config_source)
|
||||
data_file: 'bmad/{module}/workflows/{workflow}/data.csv'
|
||||
data_file: '{bmad_folder}/{module}/workflows/{workflow}/data.csv'
|
||||
|
||||
web_bundle_files:
|
||||
- 'bmad/{module}/workflows/{workflow}/instructions.md'
|
||||
- 'bmad/{module}/workflows/{workflow}/checklist.md'
|
||||
- 'bmad/{module}/workflows/{workflow}/template.md'
|
||||
- 'bmad/{module}/workflows/{workflow}/data.csv'
|
||||
- '{bmad_folder}/{module}/workflows/{workflow}/instructions.md'
|
||||
- '{bmad_folder}/{module}/workflows/{workflow}/checklist.md'
|
||||
- '{bmad_folder}/{module}/workflows/{workflow}/template.md'
|
||||
- '{bmad_folder}/{module}/workflows/{workflow}/data.csv'
|
||||
# Add every single file referenced anywhere
|
||||
|
||||
# CRITICAL: If this workflow invokes other workflows, use existing_workflows
|
||||
# This signals the bundler to recursively include those workflows' web_bundles
|
||||
existing_workflows:
|
||||
- workflow_variable_name: 'bmad/path/to/workflow.yaml'
|
||||
- workflow_variable_name: '{bmad_folder}/path/to/workflow.yaml'
|
||||
```
|
||||
|
||||
**Example with existing_workflows:**
|
||||
@@ -681,14 +681,14 @@ web_bundle:
|
||||
name: 'brainstorm-game'
|
||||
description: 'Game brainstorming with CIS workflow'
|
||||
author: 'BMad'
|
||||
instructions: 'bmad/bmm/workflows/brainstorm-game/instructions.md'
|
||||
instructions: '{bmad_folder}/bmm/workflows/brainstorm-game/instructions.md'
|
||||
template: false
|
||||
web_bundle_files:
|
||||
- 'bmad/bmm/workflows/brainstorm-game/instructions.md'
|
||||
- 'bmad/mmm/workflows/brainstorm-game/game-context.md'
|
||||
- 'bmad/core/workflows/brainstorming/workflow.yaml'
|
||||
- '{bmad_folder}/bmm/workflows/brainstorm-game/instructions.md'
|
||||
- '{bmad_folder}/mmm/workflows/brainstorm-game/game-context.md'
|
||||
- '{bmad_folder}/core/workflows/brainstorming/workflow.yaml'
|
||||
existing_workflows:
|
||||
- core_brainstorming: 'bmad/core/workflows/brainstorming/workflow.yaml'
|
||||
- core_brainstorming: '{bmad_folder}/core/workflows/brainstorming/workflow.yaml'
|
||||
```
|
||||
|
||||
**What existing_workflows does:**
|
||||
@@ -696,13 +696,13 @@ web_bundle:
|
||||
- Tells the bundler this workflow invokes another workflow
|
||||
- Bundler recursively includes the invoked workflow's entire web_bundle
|
||||
- Essential for meta-workflows that orchestrate other workflows
|
||||
- Maps workflow variable names to their bmad/-relative paths
|
||||
- Maps workflow variable names to their {bmad_folder}/-relative paths
|
||||
|
||||
<action>Validate web bundle completeness:</action>
|
||||
|
||||
- Ensure no {config_source} variables remain
|
||||
- Verify all file paths are listed
|
||||
- Check that paths are bmad/-relative
|
||||
- Check that paths are {bmad_folder}/-relative
|
||||
- If workflow uses <invoke-workflow>, add to existing_workflows
|
||||
|
||||
<template-output>web_bundle_config</template-output>
|
||||
|
||||
@@ -25,7 +25,7 @@ Create a folder with these files:
|
||||
# workflow.yaml (REQUIRED)
|
||||
name: 'my-workflow'
|
||||
description: 'What this workflow does'
|
||||
installed_path: '{project-root}/bmad/module/workflows/my-workflow'
|
||||
installed_path: '{project-root}/{bmad_folder}/module/workflows/my-workflow'
|
||||
template: '{installed_path}/template.md'
|
||||
instructions: '{installed_path}/instructions.md'
|
||||
default_output_file: '{output_folder}/output.md'
|
||||
@@ -44,7 +44,7 @@ standalone: true
|
||||
```markdown
|
||||
# instructions.md
|
||||
|
||||
<critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.xml</critical>
|
||||
<critical>The workflow execution engine is governed by: {project_root}/{bmad_folder}/core/tasks/workflow.xml</critical>
|
||||
<critical>You MUST have already loaded and processed: workflow.yaml</critical>
|
||||
|
||||
<workflow>
|
||||
@@ -61,13 +61,13 @@ That's it! To execute, tell the BMAD agent: `workflow path/to/my-workflow/`
|
||||
|
||||
### Tasks vs Workflows
|
||||
|
||||
| Aspect | Task | Workflow |
|
||||
| -------------- | ------------------ | ----------------------- |
|
||||
| **Purpose** | Single operation | Multi-step process |
|
||||
| **Format** | XML | Folder with YAML config |
|
||||
| **Location** | `/src/core/tasks/` | `/bmad/*/workflows/` |
|
||||
| **User Input** | Minimal | Extensive |
|
||||
| **Output** | Variable | Usually documents |
|
||||
| Aspect | Task | Workflow |
|
||||
| -------------- | ------------------ | ----------------------------- |
|
||||
| **Purpose** | Single operation | Multi-step process |
|
||||
| **Format** | XML | Folder with YAML config |
|
||||
| **Location** | `/src/core/tasks/` | `/{bmad_folder}/*/workflows/` |
|
||||
| **User Input** | Minimal | Extensive |
|
||||
| **Output** | Variable | Usually documents |
|
||||
|
||||
### Workflow Types
|
||||
|
||||
@@ -104,7 +104,7 @@ name: 'workflow-name'
|
||||
description: 'Clear purpose statement'
|
||||
|
||||
# Paths
|
||||
installed_path: '{project-root}/bmad/module/workflows/name'
|
||||
installed_path: '{project-root}/{bmad_folder}/module/workflows/name'
|
||||
template: '{installed_path}/template.md' # or false
|
||||
instructions: '{installed_path}/instructions.md' # or false
|
||||
validation: '{installed_path}/checklist.md' # optional
|
||||
@@ -641,7 +641,7 @@ the technology stack recommendations. Please choose: web, mobile, or desktop.</a
|
||||
```markdown
|
||||
# instructions.md
|
||||
|
||||
<critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.xml</critical>
|
||||
<critical>The workflow execution engine is governed by: {project_root}/{bmad_folder}/core/tasks/workflow.xml</critical>
|
||||
<critical>You MUST have already loaded and processed: workflow.yaml</critical>
|
||||
|
||||
<workflow>
|
||||
@@ -855,7 +855,7 @@ _Generated on {{date}}_
|
||||
**Output:**
|
||||
|
||||
- `<template-output>` - Save checkpoint
|
||||
- `<invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>` - Trigger AI enhancement
|
||||
- `<invoke-task halt="true">{project-root}/{bmad_folder}/core/tasks/adv-elicit.xml</invoke-task>` - Trigger AI enhancement
|
||||
- `<critical>` - Important info
|
||||
- `<example>` - Show example
|
||||
|
||||
@@ -904,7 +904,7 @@ _Generated on {{date}}_
|
||||
<step n="2" goal="Define requirements">
|
||||
Create functional and non-functional requirements.
|
||||
<template-output>requirements</template-output>
|
||||
<invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
|
||||
<invoke-task halt="true">{project-root}/{bmad_folder}/core/tasks/adv-elicit.xml</invoke-task>
|
||||
</step>
|
||||
|
||||
<step n="3" goal="Validate">
|
||||
@@ -1194,7 +1194,7 @@ Web bundles allow workflows to be deployed as self-contained packages for web en
|
||||
1. **Self-Contained**: No external dependencies
|
||||
2. **No Config Variables**: Cannot use `{config_source}` references
|
||||
3. **Complete File List**: Every referenced file must be listed
|
||||
4. **Relative Paths**: Use `bmad/` root paths (no `{project-root}`)
|
||||
4. **Relative Paths**: Use `{bmad_folder}/` root paths (no `{project-root}`)
|
||||
|
||||
### Creating a Web Bundle
|
||||
|
||||
@@ -1206,20 +1206,20 @@ web_bundle:
|
||||
description: 'Workflow description'
|
||||
author: 'Your Name'
|
||||
|
||||
# Core files (bmad/-relative paths)
|
||||
instructions: 'bmad/module/workflows/workflow/instructions.md'
|
||||
validation: 'bmad/module/workflows/workflow/checklist.md'
|
||||
template: 'bmad/module/workflows/workflow/template.md'
|
||||
# Core files ({bmad_folder}/-relative paths)
|
||||
instructions: '{bmad_folder}/module/workflows/workflow/instructions.md'
|
||||
validation: '{bmad_folder}/module/workflows/workflow/checklist.md'
|
||||
template: '{bmad_folder}/module/workflows/workflow/template.md'
|
||||
|
||||
# Data files (no config_source allowed)
|
||||
data_file: 'bmad/module/workflows/workflow/data.csv'
|
||||
data_file: '{bmad_folder}/module/workflows/workflow/data.csv'
|
||||
|
||||
# Complete file list - CRITICAL!
|
||||
web_bundle_files:
|
||||
- 'bmad/module/workflows/workflow/instructions.md'
|
||||
- 'bmad/module/workflows/workflow/checklist.md'
|
||||
- 'bmad/module/workflows/workflow/template.md'
|
||||
- 'bmad/module/workflows/workflow/data.csv'
|
||||
- '{bmad_folder}/module/workflows/workflow/instructions.md'
|
||||
- '{bmad_folder}/module/workflows/workflow/checklist.md'
|
||||
- '{bmad_folder}/module/workflows/workflow/template.md'
|
||||
- '{bmad_folder}/module/workflows/workflow/data.csv'
|
||||
# Include ALL referenced files
|
||||
```
|
||||
|
||||
@@ -1227,7 +1227,7 @@ web_bundle:
|
||||
|
||||
1. **Remove Config Dependencies**:
|
||||
- Replace `{config_source}:variable` with hardcoded values
|
||||
- Convert `{project-root}/bmad/` to `bmad/`
|
||||
- Convert `{project-root}/{bmad_folder}/` to `{bmad_folder}/`
|
||||
|
||||
2. **Inventory All Files**:
|
||||
- Scan instructions.md for file references
|
||||
@@ -1236,7 +1236,7 @@ web_bundle:
|
||||
|
||||
3. **Test Completeness**:
|
||||
- Ensure no missing file references
|
||||
- Verify all paths are relative to bmad/
|
||||
- Verify all paths are relative to {bmad_folder}/
|
||||
|
||||
### Example: Complete Web Bundle
|
||||
|
||||
@@ -1246,37 +1246,37 @@ web_bundle:
|
||||
description: 'Requirements analysis workflow'
|
||||
author: 'BMad Team'
|
||||
|
||||
instructions: 'bmad/bmm/workflows/analyze-requirements/instructions.md'
|
||||
validation: 'bmad/bmm/workflows/analyze-requirements/checklist.md'
|
||||
template: 'bmad/bmm/workflows/analyze-requirements/template.md'
|
||||
instructions: '{bmad_folder}/bmm/workflows/analyze-requirements/instructions.md'
|
||||
validation: '{bmad_folder}/bmm/workflows/analyze-requirements/checklist.md'
|
||||
template: '{bmad_folder}/bmm/workflows/analyze-requirements/template.md'
|
||||
|
||||
# Data files
|
||||
techniques_data: 'bmad/bmm/workflows/analyze-requirements/techniques.csv'
|
||||
patterns_data: 'bmad/bmm/workflows/analyze-requirements/patterns.json'
|
||||
techniques_data: '{bmad_folder}/bmm/workflows/analyze-requirements/techniques.csv'
|
||||
patterns_data: '{bmad_folder}/bmm/workflows/analyze-requirements/patterns.json'
|
||||
|
||||
# Sub-workflow reference
|
||||
validation_workflow: 'bmad/bmm/workflows/validate-requirements/workflow.yaml'
|
||||
validation_workflow: '{bmad_folder}/bmm/workflows/validate-requirements/workflow.yaml'
|
||||
|
||||
standalone: true
|
||||
|
||||
web_bundle_files:
|
||||
# Core workflow files
|
||||
- 'bmad/bmm/workflows/analyze-requirements/instructions.md'
|
||||
- 'bmad/bmm/workflows/analyze-requirements/checklist.md'
|
||||
- 'bmad/bmm/workflows/analyze-requirements/template.md'
|
||||
- '{bmad_folder}/bmm/workflows/analyze-requirements/instructions.md'
|
||||
- '{bmad_folder}/bmm/workflows/analyze-requirements/checklist.md'
|
||||
- '{bmad_folder}/bmm/workflows/analyze-requirements/template.md'
|
||||
|
||||
# Data files
|
||||
- 'bmad/bmm/workflows/analyze-requirements/techniques.csv'
|
||||
- 'bmad/bmm/workflows/analyze-requirements/patterns.json'
|
||||
- '{bmad_folder}/bmm/workflows/analyze-requirements/techniques.csv'
|
||||
- '{bmad_folder}/bmm/workflows/analyze-requirements/patterns.json'
|
||||
|
||||
# Sub-workflow and its files
|
||||
- 'bmad/bmm/workflows/validate-requirements/workflow.yaml'
|
||||
- 'bmad/bmm/workflows/validate-requirements/instructions.md'
|
||||
- 'bmad/bmm/workflows/validate-requirements/checklist.md'
|
||||
- '{bmad_folder}/bmm/workflows/validate-requirements/workflow.yaml'
|
||||
- '{bmad_folder}/bmm/workflows/validate-requirements/instructions.md'
|
||||
- '{bmad_folder}/bmm/workflows/validate-requirements/checklist.md'
|
||||
|
||||
# Shared templates referenced in instructions
|
||||
- 'bmad/bmm/templates/requirement-item.md'
|
||||
- 'bmad/bmm/templates/validation-criteria.md'
|
||||
- '{bmad_folder}/bmm/templates/requirement-item.md'
|
||||
- '{bmad_folder}/bmm/templates/validation-criteria.md'
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
@@ -1305,4 +1305,4 @@ web_bundle:
|
||||
_For implementation details, see:_
|
||||
|
||||
- `/src/core/tasks/workflow.xml` - Execution engine
|
||||
- `/bmad/bmm/workflows/` - Production examples
|
||||
- `/{bmad_folder}/bmm/workflows/` - Production examples
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# PRD Workflow Instructions
|
||||
|
||||
<critical>The workflow execution engine is governed by: {project-root}/bmad/core/tasks/workflow.xml</critical>
|
||||
<critical>You MUST have already loaded and processed: {project-related}/bmad/{module-code}/workflows/{workflow}/workflow.yaml</critical>
|
||||
<critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
|
||||
<critical>You MUST have already loaded and processed: {project-related}/{bmad_folder}/{module-code}/workflows/{workflow}/workflow.yaml</critical>
|
||||
<critical>Communicate in {communication_language} throughout the workflow process</critical>
|
||||
|
||||
<workflow>
|
||||
|
||||
@@ -20,7 +20,7 @@ recommended_inputs: # optional, can be omitted
|
||||
- example_input: "{project-root}/{path/to/file.md}"
|
||||
|
||||
# Module path and component files
|
||||
installed_path: "{project-root}/bmad/{module-code}/workflows/{workflow-code}"
|
||||
installed_path: "{project-root}/{bmad_folder}/{module-code}/workflows/{workflow-code}"
|
||||
template: "{installed_path}/template.md" # optional, can be omitted
|
||||
instructions: "{installed_path}/instructions.md" # optional, can be omitted
|
||||
validation: "{installed_path}/checklist.md" # optional, can be omitted
|
||||
@@ -43,23 +43,23 @@ web_bundle: #optional, can be omitted
|
||||
description: "{WORKFLOW_DESCRIPTION}"
|
||||
author: "BMad"
|
||||
|
||||
# Core workflow files (paths relative to bmad/ root)
|
||||
instructions: "bmad/{module-code}/workflows/{workflow-code}/instructions.md"
|
||||
validation: "bmad/{module-code}/workflows/{workflow-code}/checklist.md"
|
||||
template: "bmad/{module-code}/workflows/{workflow-code}/template.md" # if document workflow
|
||||
# Core workflow files (paths relative to {bmad_folder}/ root)
|
||||
instructions: "{bmad_folder}/{module-code}/workflows/{workflow-code}/instructions.md"
|
||||
validation: "{bmad_folder}/{module-code}/workflows/{workflow-code}/checklist.md"
|
||||
template: "{bmad_folder}/{module-code}/workflows/{workflow-code}/template.md" # if document workflow
|
||||
|
||||
# Reference any data files or additional workflows (no config_source allowed)
|
||||
# brain_techniques: "bmad/{module-code}/workflows/{workflow-code}/data-file.csv"
|
||||
# sub_workflow: "bmad/{module-code}/workflows/other-workflow/workflow.yaml"
|
||||
# brain_techniques: "{bmad_folder}/{module-code}/workflows/{workflow-code}/data-file.csv"
|
||||
# sub_workflow: "{bmad_folder}/{module-code}/workflows/other-workflow/workflow.yaml"
|
||||
|
||||
# CRITICAL: List ALL files used by this workflow
|
||||
# This includes instructions, validation, templates, data files,
|
||||
# and any files referenced within those files
|
||||
web_bundle_files:
|
||||
- "bmad/{module-code}/workflows/{workflow-code}/instructions.md"
|
||||
- "bmad/{module-code}/workflows/{workflow-code}/checklist.md"
|
||||
- "bmad/{module-code}/workflows/{workflow-code}/template.md"
|
||||
- "{bmad_folder}/{module-code}/workflows/{workflow-code}/instructions.md"
|
||||
- "{bmad_folder}/{module-code}/workflows/{workflow-code}/checklist.md"
|
||||
- "{bmad_folder}/{module-code}/workflows/{workflow-code}/template.md"
|
||||
# Add ALL referenced files here - examine instructions.md and template.md
|
||||
# for any file paths and include them all
|
||||
# - "bmad/{module-code}/workflows/{workflow-code}/data/example.csv"
|
||||
# - "bmad/{module-code}/templates/shared-template.md"
|
||||
# - "{bmad_folder}/{module-code}/workflows/{workflow-code}/data/example.csv"
|
||||
# - "{bmad_folder}/{module-code}/templates/shared-template.md"
|
||||
|
||||
@@ -4,7 +4,7 @@ description: "Interactive workflow builder that guides creation of new BMAD work
|
||||
author: "BMad Builder"
|
||||
|
||||
# Critical variables
|
||||
config_source: "{project-root}/bmad/bmb/config.yaml"
|
||||
config_source: "{project-root}/{bmad_folder}/bmb/config.yaml"
|
||||
custom_workflow_location: "{config_source}:custom_workflow_location"
|
||||
user_name: "{config_source}:user_name"
|
||||
communication_language: "{config_source}:communication_language"
|
||||
@@ -17,11 +17,11 @@ template_checklist: "{workflow_template_path}/checklist.md"
|
||||
|
||||
# Optional input docs
|
||||
recommended_inputs:
|
||||
- existing_workflows: "{project-root}/bmad/*/workflows/"
|
||||
- bmm_workflows: "{project-root}/bmad/bmm/workflows/"
|
||||
- existing_workflows: "{project-root}/{bmad_folder}/*/workflows/"
|
||||
- bmm_workflows: "{project-root}/{bmad_folder}/bmm/workflows/"
|
||||
|
||||
# Module path and component files
|
||||
installed_path: "{project-root}/bmad/bmb/workflows/create-workflow"
|
||||
installed_path: "{project-root}/{bmad_folder}/bmb/workflows/create-workflow"
|
||||
template: false # This is an action workflow - no template needed
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
validation: "{installed_path}/checklist.md"
|
||||
@@ -33,7 +33,7 @@ workflow_template_path: "{installed_path}/workflow-template"
|
||||
# Output configuration - Creates the new workflow folder with all files
|
||||
# If workflow belongs to a module: Save to module's workflows folder
|
||||
# If standalone workflow: Save to custom_workflow_location/{{workflow_name}}
|
||||
module_output_folder: "{project-root}/bmad/{{target_module}}/workflows/{{workflow_name}}"
|
||||
module_output_folder: "{project-root}/{bmad_folder}/{{target_module}}/workflows/{{workflow_name}}"
|
||||
standalone_output_folder: "{custom_workflow_location}/{{workflow_name}}"
|
||||
|
||||
standalone: true
|
||||
|
||||
@@ -46,7 +46,7 @@ Use this checklist to validate agent edits meet BMAD Core standards.
|
||||
## Menu Handler Validation
|
||||
|
||||
- [ ] menu-handlers section is present
|
||||
- [ ] Workflow handler loads {project-root}/bmad/core/tasks/workflow.xml
|
||||
- [ ] Workflow handler loads {project-root}/{bmad_folder}/core/tasks/workflow.xml
|
||||
- [ ] Workflow handler passes yaml path as 'workflow-config' parameter
|
||||
- [ ] Handlers check for attributes (workflow, exec, tmpl, data, action)
|
||||
- [ ] Handler logic is complete and follows patterns
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# Edit Agent - Agent Editor Instructions
|
||||
|
||||
<critical>The workflow execution engine is governed by: {project-root}/bmad/core/tasks/workflow.xml</critical>
|
||||
<critical>You MUST have already loaded and processed: {project-root}/bmad/bmb/workflows/edit-agent/workflow.yaml</critical>
|
||||
<critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
|
||||
<critical>You MUST have already loaded and processed: {project-root}/{bmad_folder}/bmb/workflows/edit-agent/workflow.yaml</critical>
|
||||
<critical>This workflow uses ADAPTIVE FACILITATION - adjust your communication based on context and user needs</critical>
|
||||
<critical>The goal is COLLABORATIVE IMPROVEMENT - work WITH the user, not FOR them</critical>
|
||||
<critical>Communicate all responses in {communication_language}</critical>
|
||||
|
||||
@@ -4,27 +4,27 @@ description: "Edit existing BMAD agents while following all best practices and c
|
||||
author: "BMad"
|
||||
|
||||
# Critical variables load from config_source
|
||||
config_source: "{project-root}/bmad/bmb/config.yaml"
|
||||
config_source: "{project-root}/{bmad_folder}/bmb/config.yaml"
|
||||
communication_language: "{config_source}:communication_language"
|
||||
user_name: "{config_source}:user_name"
|
||||
|
||||
# Required Data Files - Critical for understanding agent conventions
|
||||
agent_types: "{project-root}/bmad/bmb/workflows/create-agent/agent-types.md"
|
||||
agent_architecture: "{project-root}/bmad/bmb/workflows/create-agent/agent-architecture.md"
|
||||
agent_commands: "{project-root}/bmad/bmb/workflows/create-agent/agent-command-patterns.md"
|
||||
communication_styles: "{project-root}/bmad/bmb/workflows/create-agent/communication-styles.md"
|
||||
agent_types: "{project-root}/{bmad_folder}/bmb/workflows/create-agent/agent-types.md"
|
||||
agent_architecture: "{project-root}/{bmad_folder}/bmb/workflows/create-agent/agent-architecture.md"
|
||||
agent_commands: "{project-root}/{bmad_folder}/bmb/workflows/create-agent/agent-command-patterns.md"
|
||||
communication_styles: "{project-root}/{bmad_folder}/bmb/workflows/create-agent/communication-styles.md"
|
||||
|
||||
# Workflow execution engine reference
|
||||
workflow_execution_engine: "{project-root}/bmad/core/tasks/workflow.xml"
|
||||
workflow_execution_engine: "{project-root}/{bmad_folder}/core/tasks/workflow.xml"
|
||||
|
||||
# Optional docs that can be used to understand the target agent
|
||||
recommended_inputs:
|
||||
- target_agent: "Path to the agent.yaml or agent.md file to edit"
|
||||
- example_agents: "{project-root}/bmad/bmm/agents/"
|
||||
- example_agents: "{project-root}/{bmad_folder}/bmm/agents/"
|
||||
- agent_activation_rules: "{project-root}/src/utility/models/agent-activation-ide.xml"
|
||||
|
||||
# Module path and component files
|
||||
installed_path: "{project-root}/bmad/bmb/workflows/edit-agent"
|
||||
installed_path: "{project-root}/{bmad_folder}/bmb/workflows/edit-agent"
|
||||
template: false # This is an action workflow - no template needed
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
validation: "{installed_path}/checklist.md"
|
||||
|
||||
@@ -106,7 +106,7 @@ Modules can share workflows:
|
||||
|
||||
```yaml
|
||||
# In agent menu item:
|
||||
workflow: '{project-root}/bmad/other-module/workflows/shared-workflow/workflow.yaml'
|
||||
workflow: '{project-root}/{bmad_folder}/other-module/workflows/shared-workflow/workflow.yaml'
|
||||
```
|
||||
|
||||
Common patterns:
|
||||
@@ -151,7 +151,7 @@ Changes are reviewed and approved by you before being applied.
|
||||
- Can configure web bundles
|
||||
- Are the development source of truth
|
||||
|
||||
**Installed modules** (in bmad/):
|
||||
**Installed modules** (in {bmad_folder}/):
|
||||
|
||||
- Are deployed to target projects
|
||||
- Use config.yaml for user customization
|
||||
|
||||
@@ -5,7 +5,7 @@ Use this checklist to validate module edits meet BMAD Core standards.
|
||||
## Module Structure Validation
|
||||
|
||||
- [ ] Module has clear 3-letter code (bmm, bmb, cis, etc.)
|
||||
- [ ] Module is in correct location (src/modules/ for source, bmad/ for installed)
|
||||
- [ ] Module is in correct location (src/modules/ for source, {bmad_folder}/ for installed)
|
||||
- [ ] agents/ directory exists
|
||||
- [ ] workflows/ directory exists
|
||||
- [ ] config.yaml exists in module root
|
||||
@@ -128,7 +128,7 @@ Use this checklist to validate module edits meet BMAD Core standards.
|
||||
|
||||
- [ ] Web bundles configured in workflow.yaml files
|
||||
- [ ] All referenced files included in web_bundle_files
|
||||
- [ ] Paths are bmad/-relative (not project-root)
|
||||
- [ ] Paths are {bmad_folder}/-relative (not project-root)
|
||||
- [ ] No config_source references in web bundles
|
||||
- [ ] Invoked workflows included in dependencies
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# Edit Module - Module Editor Instructions
|
||||
|
||||
<critical>The workflow execution engine is governed by: {project-root}/bmad/core/tasks/workflow.xml</critical>
|
||||
<critical>You MUST have already loaded and processed: {project-root}/bmad/bmb/workflows/edit-module/workflow.yaml</critical>
|
||||
<critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
|
||||
<critical>You MUST have already loaded and processed: {project-root}/{bmad_folder}/bmb/workflows/edit-module/workflow.yaml</critical>
|
||||
<critical>This workflow uses ADAPTIVE FACILITATION - adjust your communication based on context and user needs</critical>
|
||||
<critical>The goal is COLLABORATIVE IMPROVEMENT - work WITH the user, not FOR them</critical>
|
||||
<critical>Communicate all responses in {communication_language}</critical>
|
||||
@@ -9,7 +9,7 @@
|
||||
<workflow>
|
||||
|
||||
<step n="1" goal="Load and deeply understand the target module">
|
||||
<ask>What is the path to the module you want to edit? (provide path to module directory like bmad/bmm/ or src/modules/bmm/)</ask>
|
||||
<ask>What is the path to the module you want to edit? (provide path to module directory like {bmad_folder}/bmm/ or src/modules/bmm/)</ask>
|
||||
|
||||
<action>Load the module directory structure completely:
|
||||
|
||||
@@ -185,7 +185,7 @@ Let the conversation flow naturally. Build a shared vision of what "better" look
|
||||
**If setting up cross-module integration:**
|
||||
|
||||
- Identify which workflows from other modules are needed
|
||||
- Show how to reference workflows properly: {project-root}/bmad/{{module}}/workflows/{{workflow}}/workflow.yaml
|
||||
- Show how to reference workflows properly: {project-root}/{bmad_folder}/{{module}}/workflows/{{workflow}}/workflow.yaml
|
||||
- Document the integration in README
|
||||
- Ensure dependencies are clear
|
||||
- Consider adding example usage
|
||||
|
||||
@@ -4,28 +4,28 @@ description: "Edit existing BMAD modules (structure, agents, workflows, document
|
||||
author: "BMad"
|
||||
|
||||
# Critical variables load from config_source
|
||||
config_source: "{project-root}/bmad/bmb/config.yaml"
|
||||
config_source: "{project-root}/{bmad_folder}/bmb/config.yaml"
|
||||
communication_language: "{config_source}:communication_language"
|
||||
user_name: "{config_source}:user_name"
|
||||
|
||||
# Required Data Files - Critical for understanding module conventions
|
||||
module_structure_guide: "{project-root}/bmad/bmb/workflows/create-module/module-structure.md"
|
||||
module_structure_guide: "{project-root}/{bmad_folder}/bmb/workflows/create-module/module-structure.md"
|
||||
|
||||
# Related workflow editors
|
||||
agent_editor: "{project-root}/bmad/bmb/workflows/edit-agent/workflow.yaml"
|
||||
workflow_editor: "{project-root}/bmad/bmb/workflows/edit-workflow/workflow.yaml"
|
||||
agent_editor: "{project-root}/{bmad_folder}/bmb/workflows/edit-agent/workflow.yaml"
|
||||
workflow_editor: "{project-root}/{bmad_folder}/bmb/workflows/edit-workflow/workflow.yaml"
|
||||
|
||||
# Optional docs that can be used to understand the target module
|
||||
recommended_inputs:
|
||||
- target_module: "Path to the module directory to edit"
|
||||
- bmm_module: "{project-root}/bmad/bmm/"
|
||||
- bmb_module: "{project-root}/bmad/bmb/"
|
||||
- cis_module: "{project-root}/bmad/cis/"
|
||||
- existing_agents: "{project-root}/bmad/*/agents/"
|
||||
- existing_workflows: "{project-root}/bmad/*/workflows/"
|
||||
- bmm_module: "{project-root}/{bmad_folder}/bmm/"
|
||||
- bmb_module: "{project-root}/{bmad_folder}/bmb/"
|
||||
- cis_module: "{project-root}/{bmad_folder}/cis/"
|
||||
- existing_agents: "{project-root}/{bmad_folder}/*/agents/"
|
||||
- existing_workflows: "{project-root}/{bmad_folder}/*/workflows/"
|
||||
|
||||
# Module path and component files
|
||||
installed_path: "{project-root}/bmad/bmb/workflows/edit-module"
|
||||
installed_path: "{project-root}/{bmad_folder}/bmb/workflows/edit-module"
|
||||
template: false # This is an action workflow - no template needed
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
validation: "{installed_path}/checklist.md"
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# Edit Workflow - Workflow Editor Instructions
|
||||
|
||||
<critical>The workflow execution engine is governed by: {project-root}/bmad/core/tasks/workflow.xml</critical>
|
||||
<critical>You MUST have already loaded and processed: {project-root}/bmad/bmb/workflows/edit-workflow/workflow.yaml</critical>
|
||||
<critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
|
||||
<critical>You MUST have already loaded and processed: {project-root}/{bmad_folder}/bmb/workflows/edit-workflow/workflow.yaml</critical>
|
||||
<critical>This workflow uses ADAPTIVE FACILITATION - adjust your communication based on context and user needs</critical>
|
||||
<critical>The goal is COLLABORATIVE IMPROVEMENT - work WITH the user, not FOR them</critical>
|
||||
<critical>Communicate all responses in {communication_language}</critical>
|
||||
@@ -24,7 +24,7 @@
|
||||
|
||||
- Workflow creation guide: {workflow_creation_guide}
|
||||
- Workflow execution engine: {workflow_execution_engine}
|
||||
- Study example workflows from: {project-root}/bmad/bmm/workflows/
|
||||
- Study example workflows from: {project-root}/{bmad_folder}/bmm/workflows/
|
||||
</action>
|
||||
|
||||
<action>Analyze the workflow deeply:
|
||||
@@ -205,7 +205,7 @@ Let the conversation flow naturally. Build a shared vision of what "better" look
|
||||
|
||||
- Identify all files the workflow depends on
|
||||
- Check for invoked workflows (must be included)
|
||||
- Verify paths are bmad/-relative
|
||||
- Verify paths are {bmad_folder}/-relative
|
||||
- Remove config_source dependencies
|
||||
- Build complete file list
|
||||
|
||||
|
||||
@@ -4,21 +4,21 @@ description: "Edit existing BMAD workflows while following all best practices an
|
||||
author: "BMad"
|
||||
|
||||
# Critical variables load from config_source
|
||||
config_source: "{project-root}/bmad/bmb/config.yaml"
|
||||
config_source: "{project-root}/{bmad_folder}/bmb/config.yaml"
|
||||
communication_language: "{config_source}:communication_language"
|
||||
user_name: "{config_source}:user_name"
|
||||
|
||||
# Required Data Files - Critical for understanding workflow conventions
|
||||
workflow_creation_guide: "{project-root}/bmad/bmb/workflows/create-workflow/workflow-creation-guide.md"
|
||||
workflow_execution_engine: "{project-root}/bmad/core/tasks/workflow.xml"
|
||||
workflow_creation_guide: "{project-root}/{bmad_folder}/bmb/workflows/create-workflow/workflow-creation-guide.md"
|
||||
workflow_execution_engine: "{project-root}/{bmad_folder}/core/tasks/workflow.xml"
|
||||
|
||||
# Optional docs that can be used to understand the target workflow
|
||||
recommended_inputs:
|
||||
- target_workflow: "Path to the workflow.yaml file to edit"
|
||||
- workflow_examples: "{project-root}/bmad/bmm/workflows/"
|
||||
- workflow_examples: "{project-root}/{bmad_folder}/bmm/workflows/"
|
||||
|
||||
# Module path and component files
|
||||
installed_path: "{project-root}/bmad/bmb/workflows/edit-workflow"
|
||||
installed_path: "{project-root}/{bmad_folder}/bmb/workflows/edit-workflow"
|
||||
template: false # This is an action workflow - no template needed
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
validation: "{installed_path}/checklist.md"
|
||||
|
||||
@@ -254,8 +254,8 @@ To customize this workflow:
|
||||
|
||||
For issues or questions:
|
||||
|
||||
- Review the workflow creation guide at `/bmad/bmb/workflows/create-workflow/workflow-creation-guide.md`
|
||||
- Study existing module examples in `/bmad/` for patterns and inspiration
|
||||
- Review the workflow creation guide at `/{bmad_folder}/bmb/workflows/create-workflow/workflow-creation-guide.md`
|
||||
- Study existing module examples in `/{bmad_folder}/` for patterns and inspiration
|
||||
- Validate output using `checklist.md`
|
||||
- Consult module structure guide at `create-module/module-structure.md`
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# Module Brief Instructions
|
||||
|
||||
<critical>The workflow execution engine is governed by: {project-root}/bmad/core/tasks/workflow.xml</critical>
|
||||
<critical>You MUST have already loaded and processed: {project-root}/bmad/bmb/workflows/module-brief/workflow.yaml</critical>
|
||||
<critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
|
||||
<critical>You MUST have already loaded and processed: {project-root}/{bmad_folder}/bmb/workflows/module-brief/workflow.yaml</critical>
|
||||
<critical>Communicate in {communication_language} throughout the module brief creation process</critical>
|
||||
|
||||
<workflow>
|
||||
|
||||
@@ -4,7 +4,7 @@ description: "Create a comprehensive Module Brief that serves as the blueprint f
|
||||
author: "BMad Builder"
|
||||
|
||||
# Critical variables
|
||||
config_source: "{project-root}/bmad/bmb/config.yaml"
|
||||
config_source: "{project-root}/{bmad_folder}/bmb/config.yaml"
|
||||
output_folder: "{config_source}:output_folder"
|
||||
user_name: "{config_source}:user_name"
|
||||
communication_language: "{config_source}:communication_language"
|
||||
@@ -13,11 +13,11 @@ date: system-generated
|
||||
# Optional input docs that enhance module planning
|
||||
recommended_inputs:
|
||||
- brainstorming_results: "{output_folder}/brainstorming-*.md"
|
||||
- existing_modules: "{project-root}/bmad/"
|
||||
- module_examples: "{project-root}/bmad/bmb/workflows/create-module/module-structure.md"
|
||||
- existing_modules: "{project-root}/{bmad_folder}/"
|
||||
- module_examples: "{project-root}/{bmad_folder}/bmb/workflows/create-module/module-structure.md"
|
||||
|
||||
# Module path and component files
|
||||
installed_path: "{project-root}/bmad/bmb/workflows/module-brief"
|
||||
installed_path: "{project-root}/{bmad_folder}/bmb/workflows/module-brief"
|
||||
template: "{installed_path}/template.md"
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
validation: "{installed_path}/checklist.md"
|
||||
|
||||
@@ -28,11 +28,11 @@ workflow redoc
|
||||
|
||||
When prompted, provide one of:
|
||||
|
||||
- **Module path**: `bmad/bmm` (documents entire module: root, workflows, agents)
|
||||
- **Workflows folder**: `bmad/bmm/workflows` (documents all workflows)
|
||||
- **Agents folder**: `bmad/bmm/agents` (documents all agents)
|
||||
- **Single workflow**: `bmad/bmm/workflows/product-brief` (documents one workflow)
|
||||
- **Single agent**: `bmad/bmm/agents/prd-agent.md` (documents one agent)
|
||||
- **Module path**: `{bmad_folder}/bmm` (documents entire module: root, workflows, agents)
|
||||
- **Workflows folder**: `{bmad_folder}/bmm/workflows` (documents all workflows)
|
||||
- **Agents folder**: `{bmad_folder}/bmm/agents` (documents all agents)
|
||||
- **Single workflow**: `{bmad_folder}/bmm/workflows/product-brief` (documents one workflow)
|
||||
- **Single agent**: `{bmad_folder}/bmm/agents/prd-agent.md` (documents one agent)
|
||||
|
||||
## Inputs
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# ReDoc Workflow Instructions
|
||||
|
||||
<critical>The workflow execution engine is governed by: {project-root}/bmad/core/tasks/workflow.xml</critical>
|
||||
<critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
|
||||
<critical>You MUST have already loaded and processed: {project-root}/src/modules/bmb/workflows/redoc/workflow.yaml</critical>
|
||||
<critical>Communicate in {communication_language} throughout the documentation process</critical>
|
||||
<critical>This is an AUTONOMOUS workflow - minimize user interaction unless clarification is absolutely required</critical>
|
||||
|
||||
@@ -4,7 +4,7 @@ description: "Autonomous documentation system that maintains module, workflow, a
|
||||
author: "BMad"
|
||||
|
||||
# Critical variables
|
||||
config_source: "{project-root}/bmad/bmb/config.yaml"
|
||||
config_source: "{project-root}/{bmad_folder}/bmb/config.yaml"
|
||||
user_name: "{config_source}:user_name"
|
||||
communication_language: "{config_source}:communication_language"
|
||||
|
||||
|
||||
Reference in New Issue
Block a user