ros/BMAD-METHOD
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix: installer improvement

Browse Source
This commit is contained in:
Brian Madison
2025-07-07 22:11:32 -05:00
parent c97d76c797
commit db302309f4
36 changed files with 225 additions and 2057 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
dist/agents/analyst.txt vendored
View File

@@ -2732,7 +2732,7 @@ For full details, see `CONTRIBUTING.md`. Key points:
- Atomic commits - one logical change per commit
- Must align with guiding principles
**Core Principles** (from GUIDING-PRINCIPLES.md):
**Core Principles** (from docs/GUIDING-PRINCIPLES.md):
- **Dev Agents Must Be Lean**: Minimize dependencies, save context for code
- **Natural Language First**: Everything in markdown, no code in core
@@ -2802,8 +2802,8 @@ Use the **expansion-creator** pack to build your own:
## Getting Help
- **Commands**: Use `/help` in any environment to see available commands
- **Agent Switching**: Use `/switch agent-name` with orchestrator for role changes
- **Commands**: Use `*/*help` in any environment to see available commands
- **Agent Switching**: Use `*/*switch agent-name` with orchestrator for role changes
- **Documentation**: Check `docs/` folder for project-specific context
- **Community**: Discord and GitHub resources available for support
- **Contributing**: See `CONTRIBUTING.md` for full guidelines

331
dist/agents/bmad-master.txt vendored
View File

@@ -47,50 +47,31 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
```yaml
activation-instructions:
- Greet the user with your name and role, and inform of the *help command.
- Check for active workflow plan using the utils plan-management
agent:
name: BMad Master
id: bmad-master
title: BMad Master Task Executor
icon: 🧙
whenToUse: Use when you need comprehensive expertise across all domains or rapid context switching between multiple agent capabilities
whenToUse: Use when you need comprehensive expertise across all domains, running 1 off tasks that do not require a persona, or just wanting to use the same agent for many things.
persona:
role: Master Task Executor & BMad Method Expert
style: Efficient, direct, action-oriented. Executes any BMad task/template/util/checklist with precision
identity: Universal executor of all BMad-Method capabilities, directly runs any resource
focus: Direct execution without transformation, load resources only when needed
core_principles:
- Execute any resource directly without persona transformation
- Load resources at runtime, never pre-load
- Expert knowledge of all BMad resources
- Track execution state and guide multi-step plans
- Use numbered lists for choices
- Expert knowledge of all BMad resources if using *kb
- Always presents numbered lists for choices
- Process (*) commands immediately, All commands require * prefix when used (e.g., *help)
commands:
- help: Show these listed commands in a numbered list
- kb: Toggle KB mode off (default) or on, when on will load and reference the data/bmad-kb and converse with the user answering his questions with this informational resource
- kb: Toggle KB mode off (default) or on, when on will load and reference the data/bmad-kb.md and converse with the user answering his questions with this informational resource
- task {task}: Execute task, if not found or none specified, ONLY list available dependencies/tasks listed below
- list {task|template|util|checklist|workflow}: List resources by type ONLY from the corresponding dependencies sub item below
- create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
- create-prd-alpha: Execute task create-doc2 with .bmad-core/templates/prd-tmpl2.yaml (EXPERIMENTAL)
- execute-checklist {checklist}: Run task execute-checklist (no checklist = ONLY show available checklists listed under dependencies/checklist below)
- shard-doc {document} {destination}: run the task shard-doc against the optionally provided document to the specified destination
- plan: Execute the task Create workflow plan
- plan-status: Show current workflow plan progress
- plan-update: Update workflow plan status
- yolo: Toggle Yolo Mode
- doc-out: Output full document to current destination file
- exit: Exit (confirm)
workflow-guidance:
- When user asks about workflows, offer: (Experimental-Feature) Would you like me to create a workflow plan first? (*plan)
- For complex projects, suggest planning before execution
- Plan command maps to create-workflow-plan task
execution:
- NEVER use tools during startup - only announce and wait
- Runtime discovery ONLY when user requests specific resources
- Workflow: User request → Runtime discovery → Load resource → Execute instructions → Guide inputs → Provide feedback
- For workflow requests: Suggest *plan command first for complex projects
- Suggest related resources after completion
dependencies:
tasks:
- advanced-elicitation.md
@@ -125,9 +106,6 @@ dependencies:
- brainstorming-techniques.md
- elicitation-methods.md
- technical-preferences.md
utils:
- plan-management.md
- workflow-management.md
workflows:
- brownfield-fullstack.md
- brownfield-service.md
@@ -1805,7 +1783,6 @@ To identify the next logical story based on project progress and epic definition
- Load `.bmad-core/core-config.yaml` from the project root
- If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story creation. You can either: 1) Copy it from GITHUB bmad-core/core-config.yaml and configure it for your project OR 2) Run the BMad installer against your project to upgrade and add the file automatically. Please add and configure core-config.yaml before proceeding."
- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`, `workflow.*`
- If `workflow.trackProgress: true`, use `utils/plan-management.md` to check plan sequence and warn if out of order
### 1. Identify Next Story for Preparation
@@ -9034,7 +9011,7 @@ For full details, see `CONTRIBUTING.md`. Key points:
- Atomic commits - one logical change per commit
- Must align with guiding principles
**Core Principles** (from GUIDING-PRINCIPLES.md):
**Core Principles** (from docs/GUIDING-PRINCIPLES.md):
- **Dev Agents Must Be Lean**: Minimize dependencies, save context for code
- **Natural Language First**: Everything in markdown, no code in core
@@ -9104,8 +9081,8 @@ Use the **expansion-creator** pack to build your own:
## Getting Help
- **Commands**: Use `/help` in any environment to see available commands
- **Agent Switching**: Use `/switch agent-name` with orchestrator for role changes
- **Commands**: Use `*/*help` in any environment to see available commands
- **Agent Switching**: Use `*/*switch agent-name` with orchestrator for role changes
- **Documentation**: Check `docs/` folder for project-specific context
- **Community**: Discord and GitHub resources available for support
- **Contributing**: See `CONTRIBUTING.md` for full guidelines
@@ -9292,297 +9269,3 @@ Use the **expansion-creator** pack to build your own:
None Listed
==================== END: .bmad-core/data/technical-preferences.md ====================
==================== START: .bmad-core/utils/plan-management.md ====================
# Plan Management Utility
## Purpose
Provides utilities for agents and tasks to interact with workflow plans, check progress, update status, and ensure workflow steps are executed in the appropriate sequence.
## Core Functions
### 1. Check Plan Existence
Check for workflow plan:
1. Look for docs/workflow-plan.md (default location)
2. Return plan status to user (exists/not exists) - if not exists then HALT.
### 2. Parse Plan Status
[[LLM: Extract current progress from the plan document]]
**Plan Parsing Logic:**
1. **Identify Step Structure**:
- Look for checkbox lines: `- [ ]` or `- [x]`
- Extract step IDs from comments: `<!-- step-id: X.Y -->`
- Identify agent assignments: `<!-- agent: pm -->`
2. **Determine Current State**:
- Last completed step (highest numbered `[x]`)
- Next expected step (first `[ ]` after completed steps)
- Overall progress percentage
3. **Extract Metadata**:
- Workflow type from plan header
- Decision points and their status
- Any deviation notes
### 3. Sequence Validation
[[LLM: Check if requested action aligns with plan sequence]]
**Validation Rules:**
1. **Strict Mode** (enforceSequence: true):
- Must complete steps in exact order
- Warn and block if out of sequence
- Require explicit override justification
2. **Flexible Mode** (enforceSequence: false):
- Warn about sequence deviation
- Allow with confirmation
- Log deviation reason
**Warning Templates:**
```text
SEQUENCE WARNING:
The workflow plan shows you should complete "{expected_step}" next.
You're attempting to: "{requested_action}"
In strict mode: Block and require plan update
In flexible mode: Allow with confirmation
```
### 4. Plan Update Operations
[[LLM: Provide consistent way to update plan progress]]
**Update Actions:**
1. **Mark Step Complete**:
- Change `- [ ]` to `- [x]`
- Add completion timestamp comment
- Update any status metadata
2. **Add Deviation Note**:
- Insert note explaining why sequence changed
- Reference the deviation in plan
3. **Update Current Step Pointer**:
- Add/move `<!-- current-step -->` marker
- Update last-modified timestamp
### 5. Integration Instructions
[[LLM: How agents and tasks should use this utility]]
**For Agents (startup sequence)**:
```text
1. Check if plan exists using this utility
2. If exists:
- Parse current status
- Show user: "Active workflow plan detected. Current step: {X}"
- Suggest: "Next recommended action: {next_step}"
3. Continue with normal startup
```
**For Tasks (pre-execution)**:
```text
1. Check if plan exists
2. If exists:
- Verify this task aligns with plan
- If not aligned:
- In strict mode: Show warning and stop
- In flexible mode: Show warning and ask for confirmation
3. After task completion:
- Update plan if task was a planned step
- Add note if task was unplanned
```
### 6. Plan Status Report Format
[[LLM: Standard format for showing plan status]]
```text
📋 Workflow Plan Status
━━━━━━━━━━━━━━━━━━━━
Workflow: {workflow_name}
Progress: {X}% complete ({completed}/{total} steps)
✅ Completed:
- {completed_step_1}
- {completed_step_2}
🔄 Current Step:
- {current_step_description}
📌 Upcoming:
- {next_step_1}
- {next_step_2}
⚠️ Notes:
- {any_deviations_or_notes}
```
### 7. Decision Point Handling
[[LLM: Special handling for workflow decision points]]
When encountering a decision point in the plan:
1. **Identify Decision Marker**: `<!-- decision: {decision_id} -->`
2. **Check Decision Status**: Made/Pending
3. **If Pending**:
- Block progress until decision made
- Show options to user
- Record decision when made
4. **If Made**:
- Verify current path aligns with decision
- Warn if attempting alternate path
### 8. Plan Abandonment
[[LLM: Graceful handling when user wants to stop following plan]]
If user wants to abandon plan:
1. Confirm abandonment intent
2. Add abandonment note to plan
3. Mark plan as "Abandoned" in header
4. Stop plan checking for remainder of session
5. Suggest creating new plan if needed
## Usage Examples
### Example 1: Agent Startup Check
```text
BMad Master starting...
[Check for plan]
Found active workflow plan: brownfield-fullstack
Progress: 40% complete (4/10 steps)
Current step: Create PRD (pm agent)
Suggestion: Based on your plan, you should work with the PM agent next.
Use *agent pm to switch, or *plan-status to see full progress.
```
### Example 2: Task Sequence Warning
```text
User: *task create-next-story
[Plan check triggered]
⚠️ SEQUENCE WARNING:
Your workflow plan indicates the PRD hasn't been created yet.
Creating stories before the PRD may lead to incomplete requirements.
Would you like to:
1. Continue anyway (will note deviation in plan)
2. Switch to creating PRD first (*agent pm)
3. View plan status (*plan-status)
```
### Example 3: Automatic Plan Update
```text
[After completing create-doc task for PRD]
✅ Plan Updated: Marked "Create PRD" as complete
📍 Next step: Create Architecture Document (architect agent)
```
## Implementation Notes
- This utility should be lightweight and fast
- Plan parsing should be resilient to format variations
- Always preserve user agency - warnings not blocks (unless strict mode)
- Plan updates should be atomic to prevent corruption
- Consider plan versioning for rollback capability
## Error Handling
- Missing plan: Return null, don't error
- Malformed plan: Warn but continue, treat as no plan
- Update failures: Log but don't block task completion
- Parse errors: Fallback to basic text search
==================== END: .bmad-core/utils/plan-management.md ====================
==================== START: .bmad-core/utils/workflow-management.md ====================
# Workflow Management
Enables BMad orchestrator to manage and execute team workflows.
## Dynamic Workflow Loading
Read available workflows from current team configuration's `workflows` field. Each team bundle defines its own supported workflows.
**Key Commands**:
- `/workflows` - List workflows in current bundle or workflows folder
- `/agent-list` - Show agents in current bundle
## Workflow Commands
### /workflows
Lists available workflows with titles and descriptions.
### /workflow-start {workflow-id}
Starts workflow and transitions to first agent.
### /workflow-status
Shows current progress, completed artifacts, and next steps.
### /workflow-resume
Resumes workflow from last position. User can provide completed artifacts.
### /workflow-next
Shows next recommended agent and action.
## Execution Flow
1. **Starting**: Load definition → Identify first stage → Transition to agent → Guide artifact creation
2. **Stage Transitions**: Mark complete → Check conditions → Load next agent → Pass artifacts
3. **Artifact Tracking**: Track status, creator, timestamps in workflow_state
4. **Interruption Handling**: Analyze provided artifacts → Determine position → Suggest next step
## Context Passing
When transitioning, pass:
- Previous artifacts
- Current workflow stage
- Expected outputs
- Decisions/constraints
## Multi-Path Workflows
Handle conditional paths by asking clarifying questions when needed.
## Best Practices
1. Show progress
2. Explain transitions
3. Preserve context
4. Allow flexibility
5. Track state
## Agent Integration
Agents should be workflow-aware: know active workflow, their role, access artifacts, understand expected outputs.
==================== END: .bmad-core/utils/workflow-management.md ====================

232
dist/agents/bmad-orchestrator.txt vendored
View File

@@ -47,9 +47,6 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
```yaml
activation-instructions:
- Mention *help shows all available commands and options
- Check for active workflow plan using .bmad-core/utils/plan-management.md
- 'If plan exists: Show 📋 Active plan: {workflow} ({progress}% complete). Use *plan-status for details.'
- 'If plan exists: Suggest next action based on plan progress'
- Assess user goal against available agents and workflows in this bundle
- If clear match to an agent's expertise, suggest transformation with *agent command
- If project-oriented, suggest *workflow-guidance to explore options
@@ -171,7 +168,6 @@ dependencies:
- bmad-kb.md
- elicitation-methods.md
utils:
- plan-management.md
- workflow-management.md
```
==================== END: .bmad-core/agents/bmad-orchestrator.md ====================
@@ -1723,7 +1719,7 @@ For full details, see `CONTRIBUTING.md`. Key points:
- Atomic commits - one logical change per commit
- Must align with guiding principles
**Core Principles** (from GUIDING-PRINCIPLES.md):
**Core Principles** (from docs/GUIDING-PRINCIPLES.md):
- **Dev Agents Must Be Lean**: Minimize dependencies, save context for code
- **Natural Language First**: Everything in markdown, no code in core
@@ -1793,8 +1789,8 @@ Use the **expansion-creator** pack to build your own:
## Getting Help
- **Commands**: Use `/help` in any environment to see available commands
- **Agent Switching**: Use `/switch agent-name` with orchestrator for role changes
- **Commands**: Use `*/*help` in any environment to see available commands
- **Agent Switching**: Use `*/*switch agent-name` with orchestrator for role changes
- **Documentation**: Check `docs/` folder for project-specific context
- **Community**: Discord and GitHub resources available for support
- **Contributing**: See `CONTRIBUTING.md` for full guidelines
@@ -1937,228 +1933,6 @@ Use the **expansion-creator** pack to build your own:
- Prepare to continue without additional elicitation
==================== END: .bmad-core/data/elicitation-methods.md ====================
==================== START: .bmad-core/utils/plan-management.md ====================
# Plan Management Utility
## Purpose
Provides utilities for agents and tasks to interact with workflow plans, check progress, update status, and ensure workflow steps are executed in the appropriate sequence.
## Core Functions
### 1. Check Plan Existence
Check for workflow plan:
1. Look for docs/workflow-plan.md (default location)
2. Return plan status to user (exists/not exists) - if not exists then HALT.
### 2. Parse Plan Status
[[LLM: Extract current progress from the plan document]]
**Plan Parsing Logic:**
1. **Identify Step Structure**:
- Look for checkbox lines: `- [ ]` or `- [x]`
- Extract step IDs from comments: `<!-- step-id: X.Y -->`
- Identify agent assignments: `<!-- agent: pm -->`
2. **Determine Current State**:
- Last completed step (highest numbered `[x]`)
- Next expected step (first `[ ]` after completed steps)
- Overall progress percentage
3. **Extract Metadata**:
- Workflow type from plan header
- Decision points and their status
- Any deviation notes
### 3. Sequence Validation
[[LLM: Check if requested action aligns with plan sequence]]
**Validation Rules:**
1. **Strict Mode** (enforceSequence: true):
- Must complete steps in exact order
- Warn and block if out of sequence
- Require explicit override justification
2. **Flexible Mode** (enforceSequence: false):
- Warn about sequence deviation
- Allow with confirmation
- Log deviation reason
**Warning Templates:**
```text
SEQUENCE WARNING:
The workflow plan shows you should complete "{expected_step}" next.
You're attempting to: "{requested_action}"
In strict mode: Block and require plan update
In flexible mode: Allow with confirmation
```
### 4. Plan Update Operations
[[LLM: Provide consistent way to update plan progress]]
**Update Actions:**
1. **Mark Step Complete**:
- Change `- [ ]` to `- [x]`
- Add completion timestamp comment
- Update any status metadata
2. **Add Deviation Note**:
- Insert note explaining why sequence changed
- Reference the deviation in plan
3. **Update Current Step Pointer**:
- Add/move `<!-- current-step -->` marker
- Update last-modified timestamp
### 5. Integration Instructions
[[LLM: How agents and tasks should use this utility]]
**For Agents (startup sequence)**:
```text
1. Check if plan exists using this utility
2. If exists:
- Parse current status
- Show user: "Active workflow plan detected. Current step: {X}"
- Suggest: "Next recommended action: {next_step}"
3. Continue with normal startup
```
**For Tasks (pre-execution)**:
```text
1. Check if plan exists
2. If exists:
- Verify this task aligns with plan
- If not aligned:
- In strict mode: Show warning and stop
- In flexible mode: Show warning and ask for confirmation
3. After task completion:
- Update plan if task was a planned step
- Add note if task was unplanned
```
### 6. Plan Status Report Format
[[LLM: Standard format for showing plan status]]
```text
📋 Workflow Plan Status
━━━━━━━━━━━━━━━━━━━━
Workflow: {workflow_name}
Progress: {X}% complete ({completed}/{total} steps)
✅ Completed:
- {completed_step_1}
- {completed_step_2}
🔄 Current Step:
- {current_step_description}
📌 Upcoming:
- {next_step_1}
- {next_step_2}
⚠️ Notes:
- {any_deviations_or_notes}
```
### 7. Decision Point Handling
[[LLM: Special handling for workflow decision points]]
When encountering a decision point in the plan:
1. **Identify Decision Marker**: `<!-- decision: {decision_id} -->`
2. **Check Decision Status**: Made/Pending
3. **If Pending**:
- Block progress until decision made
- Show options to user
- Record decision when made
4. **If Made**:
- Verify current path aligns with decision
- Warn if attempting alternate path
### 8. Plan Abandonment
[[LLM: Graceful handling when user wants to stop following plan]]
If user wants to abandon plan:
1. Confirm abandonment intent
2. Add abandonment note to plan
3. Mark plan as "Abandoned" in header
4. Stop plan checking for remainder of session
5. Suggest creating new plan if needed
## Usage Examples
### Example 1: Agent Startup Check
```text
BMad Master starting...
[Check for plan]
Found active workflow plan: brownfield-fullstack
Progress: 40% complete (4/10 steps)
Current step: Create PRD (pm agent)
Suggestion: Based on your plan, you should work with the PM agent next.
Use *agent pm to switch, or *plan-status to see full progress.
```
### Example 2: Task Sequence Warning
```text
User: *task create-next-story
[Plan check triggered]
⚠️ SEQUENCE WARNING:
Your workflow plan indicates the PRD hasn't been created yet.
Creating stories before the PRD may lead to incomplete requirements.
Would you like to:
1. Continue anyway (will note deviation in plan)
2. Switch to creating PRD first (*agent pm)
3. View plan status (*plan-status)
```
### Example 3: Automatic Plan Update
```text
[After completing create-doc task for PRD]
✅ Plan Updated: Marked "Create PRD" as complete
📍 Next step: Create Architecture Document (architect agent)
```
## Implementation Notes
- This utility should be lightweight and fast
- Plan parsing should be resilient to format variations
- Always preserve user agency - warnings not blocks (unless strict mode)
- Plan updates should be atomic to prevent corruption
- Consider plan versioning for rollback capability
## Error Handling
- Missing plan: Return null, don't error
- Malformed plan: Warn but continue, treat as no plan
- Update failures: Log but don't block task completion
- Parse errors: Fallback to basic text search
==================== END: .bmad-core/utils/plan-management.md ====================
==================== START: .bmad-core/utils/workflow-management.md ====================
# Workflow Management

2
dist/agents/dev.txt vendored
View File

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

2
dist/agents/po.txt vendored
View File

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

1
dist/agents/sm.txt vendored
View File

@@ -98,7 +98,6 @@ To identify the next logical story based on project progress and epic definition
- Load `.bmad-core/core-config.yaml` from the project root
- If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story creation. You can either: 1) Copy it from GITHUB bmad-core/core-config.yaml and configure it for your project OR 2) Run the BMad installer against your project to upgrade and add the file automatically. Please add and configure core-config.yaml before proceeding."
- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`, `workflow.*`
- If `workflow.trackProgress: true`, use `utils/plan-management.md` to check plan sequence and warn if out of order
### 1. Identify Next Story for Preparation

226
dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt vendored
View File

@@ -128,9 +128,6 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
```yaml
activation-instructions:
- Mention *help shows all available commands and options
- Check for active workflow plan using .bmad-2d-phaser-game-dev/utils/plan-management.md
- 'If plan exists: Show 📋 Active plan: {workflow} ({progress}% complete). Use *plan-status for details.'
- 'If plan exists: Suggest next action based on plan progress'
- Assess user goal against available agents and workflows in this bundle
- If clear match to an agent's expertise, suggest transformation with *agent command
- If project-oriented, suggest *workflow-guidance to explore options
@@ -252,7 +249,6 @@ dependencies:
- bmad-kb.md
- elicitation-methods.md
utils:
- plan-management.md
- workflow-management.md
```
==================== END: .bmad-2d-phaser-game-dev/agents/bmad-orchestrator.md ====================
@@ -3374,228 +3370,6 @@ The update is successful when:
- Prepare to continue without additional elicitation
==================== END: .bmad-2d-phaser-game-dev/data/elicitation-methods.md ====================
==================== START: .bmad-2d-phaser-game-dev/utils/plan-management.md ====================
# Plan Management Utility
## Purpose
Provides utilities for agents and tasks to interact with workflow plans, check progress, update status, and ensure workflow steps are executed in the appropriate sequence.
## Core Functions
### 1. Check Plan Existence
Check for workflow plan:
1. Look for docs/workflow-plan.md (default location)
2. Return plan status to user (exists/not exists) - if not exists then HALT.
### 2. Parse Plan Status
[[LLM: Extract current progress from the plan document]]
**Plan Parsing Logic:**
1. **Identify Step Structure**:
- Look for checkbox lines: `- [ ]` or `- [x]`
- Extract step IDs from comments: `<!-- step-id: X.Y -->`
- Identify agent assignments: `<!-- agent: pm -->`
2. **Determine Current State**:
- Last completed step (highest numbered `[x]`)
- Next expected step (first `[ ]` after completed steps)
- Overall progress percentage
3. **Extract Metadata**:
- Workflow type from plan header
- Decision points and their status
- Any deviation notes
### 3. Sequence Validation
[[LLM: Check if requested action aligns with plan sequence]]
**Validation Rules:**
1. **Strict Mode** (enforceSequence: true):
- Must complete steps in exact order
- Warn and block if out of sequence
- Require explicit override justification
2. **Flexible Mode** (enforceSequence: false):
- Warn about sequence deviation
- Allow with confirmation
- Log deviation reason
**Warning Templates:**
```text
SEQUENCE WARNING:
The workflow plan shows you should complete "{expected_step}" next.
You're attempting to: "{requested_action}"
In strict mode: Block and require plan update
In flexible mode: Allow with confirmation
```
### 4. Plan Update Operations
[[LLM: Provide consistent way to update plan progress]]
**Update Actions:**
1. **Mark Step Complete**:
- Change `- [ ]` to `- [x]`
- Add completion timestamp comment
- Update any status metadata
2. **Add Deviation Note**:
- Insert note explaining why sequence changed
- Reference the deviation in plan
3. **Update Current Step Pointer**:
- Add/move `<!-- current-step -->` marker
- Update last-modified timestamp
### 5. Integration Instructions
[[LLM: How agents and tasks should use this utility]]
**For Agents (startup sequence)**:
```text
1. Check if plan exists using this utility
2. If exists:
- Parse current status
- Show user: "Active workflow plan detected. Current step: {X}"
- Suggest: "Next recommended action: {next_step}"
3. Continue with normal startup
```
**For Tasks (pre-execution)**:
```text
1. Check if plan exists
2. If exists:
- Verify this task aligns with plan
- If not aligned:
- In strict mode: Show warning and stop
- In flexible mode: Show warning and ask for confirmation
3. After task completion:
- Update plan if task was a planned step
- Add note if task was unplanned
```
### 6. Plan Status Report Format
[[LLM: Standard format for showing plan status]]
```text
📋 Workflow Plan Status
━━━━━━━━━━━━━━━━━━━━
Workflow: {workflow_name}
Progress: {X}% complete ({completed}/{total} steps)
✅ Completed:
- {completed_step_1}
- {completed_step_2}
🔄 Current Step:
- {current_step_description}
📌 Upcoming:
- {next_step_1}
- {next_step_2}
⚠️ Notes:
- {any_deviations_or_notes}
```
### 7. Decision Point Handling
[[LLM: Special handling for workflow decision points]]
When encountering a decision point in the plan:
1. **Identify Decision Marker**: `<!-- decision: {decision_id} -->`
2. **Check Decision Status**: Made/Pending
3. **If Pending**:
- Block progress until decision made
- Show options to user
- Record decision when made
4. **If Made**:
- Verify current path aligns with decision
- Warn if attempting alternate path
### 8. Plan Abandonment
[[LLM: Graceful handling when user wants to stop following plan]]
If user wants to abandon plan:
1. Confirm abandonment intent
2. Add abandonment note to plan
3. Mark plan as "Abandoned" in header
4. Stop plan checking for remainder of session
5. Suggest creating new plan if needed
## Usage Examples
### Example 1: Agent Startup Check
```text
BMad Master starting...
[Check for plan]
Found active workflow plan: brownfield-fullstack
Progress: 40% complete (4/10 steps)
Current step: Create PRD (pm agent)
Suggestion: Based on your plan, you should work with the PM agent next.
Use *agent pm to switch, or *plan-status to see full progress.
```
### Example 2: Task Sequence Warning
```text
User: *task create-next-story
[Plan check triggered]
⚠️ SEQUENCE WARNING:
Your workflow plan indicates the PRD hasn't been created yet.
Creating stories before the PRD may lead to incomplete requirements.
Would you like to:
1. Continue anyway (will note deviation in plan)
2. Switch to creating PRD first (*agent pm)
3. View plan status (*plan-status)
```
### Example 3: Automatic Plan Update
```text
[After completing create-doc task for PRD]
✅ Plan Updated: Marked "Create PRD" as complete
📍 Next step: Create Architecture Document (architect agent)
```
## Implementation Notes
- This utility should be lightweight and fast
- Plan parsing should be resilient to format variations
- Always preserve user agency - warnings not blocks (unless strict mode)
- Plan updates should be atomic to prevent corruption
- Consider plan versioning for rollback capability
## Error Handling
- Missing plan: Return null, don't error
- Malformed plan: Warn but continue, treat as no plan
- Update failures: Log but don't block task completion
- Parse errors: Fallback to basic text search
==================== END: .bmad-2d-phaser-game-dev/utils/plan-management.md ====================
==================== START: .bmad-2d-phaser-game-dev/utils/workflow-management.md ====================
# Workflow Management

245
dist/teams/team-all.txt vendored
View File

@@ -64,9 +64,6 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
```yaml
activation-instructions:
- Mention *help shows all available commands and options
- Check for active workflow plan using .bmad-core/utils/plan-management.md
- 'If plan exists: Show 📋 Active plan: {workflow} ({progress}% complete). Use *plan-status for details.'
- 'If plan exists: Suggest next action based on plan progress'
- Assess user goal against available agents and workflows in this bundle
- If clear match to an agent's expertise, suggest transformation with *agent command
- If project-oriented, suggest *workflow-guidance to explore options
@@ -188,7 +185,6 @@ dependencies:
- bmad-kb.md
- elicitation-methods.md
utils:
- plan-management.md
- workflow-management.md
```
==================== END: .bmad-core/agents/bmad-orchestrator.md ====================
@@ -2188,7 +2184,7 @@ For full details, see `CONTRIBUTING.md`. Key points:
- Atomic commits - one logical change per commit
- Must align with guiding principles
**Core Principles** (from GUIDING-PRINCIPLES.md):
**Core Principles** (from docs/GUIDING-PRINCIPLES.md):
- **Dev Agents Must Be Lean**: Minimize dependencies, save context for code
- **Natural Language First**: Everything in markdown, no code in core
@@ -2258,8 +2254,8 @@ Use the **expansion-creator** pack to build your own:
## Getting Help
- **Commands**: Use `/help` in any environment to see available commands
- **Agent Switching**: Use `/switch agent-name` with orchestrator for role changes
- **Commands**: Use `*/*help` in any environment to see available commands
- **Agent Switching**: Use `*/*switch agent-name` with orchestrator for role changes
- **Documentation**: Check `docs/` folder for project-specific context
- **Community**: Discord and GitHub resources available for support
- **Contributing**: See `CONTRIBUTING.md` for full guidelines
@@ -2402,228 +2398,6 @@ Use the **expansion-creator** pack to build your own:
- Prepare to continue without additional elicitation
==================== END: .bmad-core/data/elicitation-methods.md ====================
==================== START: .bmad-core/utils/plan-management.md ====================
# Plan Management Utility
## Purpose
Provides utilities for agents and tasks to interact with workflow plans, check progress, update status, and ensure workflow steps are executed in the appropriate sequence.
## Core Functions
### 1. Check Plan Existence
Check for workflow plan:
1. Look for docs/workflow-plan.md (default location)
2. Return plan status to user (exists/not exists) - if not exists then HALT.
### 2. Parse Plan Status
[[LLM: Extract current progress from the plan document]]
**Plan Parsing Logic:**
1. **Identify Step Structure**:
- Look for checkbox lines: `- [ ]` or `- [x]`
- Extract step IDs from comments: `<!-- step-id: X.Y -->`
- Identify agent assignments: `<!-- agent: pm -->`
2. **Determine Current State**:
- Last completed step (highest numbered `[x]`)
- Next expected step (first `[ ]` after completed steps)
- Overall progress percentage
3. **Extract Metadata**:
- Workflow type from plan header
- Decision points and their status
- Any deviation notes
### 3. Sequence Validation
[[LLM: Check if requested action aligns with plan sequence]]
**Validation Rules:**
1. **Strict Mode** (enforceSequence: true):
- Must complete steps in exact order
- Warn and block if out of sequence
- Require explicit override justification
2. **Flexible Mode** (enforceSequence: false):
- Warn about sequence deviation
- Allow with confirmation
- Log deviation reason
**Warning Templates:**
```text
SEQUENCE WARNING:
The workflow plan shows you should complete "{expected_step}" next.
You're attempting to: "{requested_action}"
In strict mode: Block and require plan update
In flexible mode: Allow with confirmation
```
### 4. Plan Update Operations
[[LLM: Provide consistent way to update plan progress]]
**Update Actions:**
1. **Mark Step Complete**:
- Change `- [ ]` to `- [x]`
- Add completion timestamp comment
- Update any status metadata
2. **Add Deviation Note**:
- Insert note explaining why sequence changed
- Reference the deviation in plan
3. **Update Current Step Pointer**:
- Add/move `<!-- current-step -->` marker
- Update last-modified timestamp
### 5. Integration Instructions
[[LLM: How agents and tasks should use this utility]]
**For Agents (startup sequence)**:
```text
1. Check if plan exists using this utility
2. If exists:
- Parse current status
- Show user: "Active workflow plan detected. Current step: {X}"
- Suggest: "Next recommended action: {next_step}"
3. Continue with normal startup
```
**For Tasks (pre-execution)**:
```text
1. Check if plan exists
2. If exists:
- Verify this task aligns with plan
- If not aligned:
- In strict mode: Show warning and stop
- In flexible mode: Show warning and ask for confirmation
3. After task completion:
- Update plan if task was a planned step
- Add note if task was unplanned
```
### 6. Plan Status Report Format
[[LLM: Standard format for showing plan status]]
```text
📋 Workflow Plan Status
━━━━━━━━━━━━━━━━━━━━
Workflow: {workflow_name}
Progress: {X}% complete ({completed}/{total} steps)
✅ Completed:
- {completed_step_1}
- {completed_step_2}
🔄 Current Step:
- {current_step_description}
📌 Upcoming:
- {next_step_1}
- {next_step_2}
⚠️ Notes:
- {any_deviations_or_notes}
```
### 7. Decision Point Handling
[[LLM: Special handling for workflow decision points]]
When encountering a decision point in the plan:
1. **Identify Decision Marker**: `<!-- decision: {decision_id} -->`
2. **Check Decision Status**: Made/Pending
3. **If Pending**:
- Block progress until decision made
- Show options to user
- Record decision when made
4. **If Made**:
- Verify current path aligns with decision
- Warn if attempting alternate path
### 8. Plan Abandonment
[[LLM: Graceful handling when user wants to stop following plan]]
If user wants to abandon plan:
1. Confirm abandonment intent
2. Add abandonment note to plan
3. Mark plan as "Abandoned" in header
4. Stop plan checking for remainder of session
5. Suggest creating new plan if needed
## Usage Examples
### Example 1: Agent Startup Check
```text
BMad Master starting...
[Check for plan]
Found active workflow plan: brownfield-fullstack
Progress: 40% complete (4/10 steps)
Current step: Create PRD (pm agent)
Suggestion: Based on your plan, you should work with the PM agent next.
Use *agent pm to switch, or *plan-status to see full progress.
```
### Example 2: Task Sequence Warning
```text
User: *task create-next-story
[Plan check triggered]
⚠️ SEQUENCE WARNING:
Your workflow plan indicates the PRD hasn't been created yet.
Creating stories before the PRD may lead to incomplete requirements.
Would you like to:
1. Continue anyway (will note deviation in plan)
2. Switch to creating PRD first (*agent pm)
3. View plan status (*plan-status)
```
### Example 3: Automatic Plan Update
```text
[After completing create-doc task for PRD]
✅ Plan Updated: Marked "Create PRD" as complete
📍 Next step: Create Architecture Document (architect agent)
```
## Implementation Notes
- This utility should be lightweight and fast
- Plan parsing should be resilient to format variations
- Always preserve user agency - warnings not blocks (unless strict mode)
- Plan updates should be atomic to prevent corruption
- Consider plan versioning for rollback capability
## Error Handling
- Missing plan: Return null, don't error
- Malformed plan: Warn but continue, treat as no plan
- Update failures: Log but don't block task completion
- Parse errors: Fallback to basic text search
==================== END: .bmad-core/utils/plan-management.md ====================
==================== START: .bmad-core/utils/workflow-management.md ====================
# Workflow Management
@@ -7140,7 +6914,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
### 0. Load Core Configuration and Inputs
- Load `.bmad-core/core-config.yaml` from the project root
- Load `.bmad-core/core-config.yaml`
- If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story validation."
- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`
- Identify and load the following inputs:
@@ -9750,7 +9524,6 @@ To identify the next logical story based on project progress and epic definition
- Load `.bmad-core/core-config.yaml` from the project root
- If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story creation. You can either: 1) Copy it from GITHUB bmad-core/core-config.yaml and configure it for your project OR 2) Run the BMad installer against your project to upgrade and add the file automatically. Please add and configure core-config.yaml before proceeding."
- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`, `workflow.*`
- If `workflow.trackProgress: true`, use `utils/plan-management.md` to check plan sequence and warn if out of order
### 1. Identify Next Story for Preparation
@@ -10603,7 +10376,7 @@ workflow:
All stories implemented and reviewed!
Project development phase complete.
Reference: data#bmad-kb:IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid
@@ -10849,7 +10622,7 @@ workflow:
All stories implemented and reviewed!
Project development phase complete.
Reference: data#bmad-kb:IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid
@@ -11046,7 +10819,7 @@ workflow:
All stories implemented and reviewed!
Project development phase complete.
Reference: data#bmad-kb:IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid
@@ -11271,7 +11044,7 @@ workflow:
All stories implemented and reviewed!
Project development phase complete.
Reference: data#bmad-kb:IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid
@@ -11718,7 +11491,7 @@ workflow:
All stories implemented and reviewed!
Project development phase complete.
Reference: data#bmad-kb:IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid

244
dist/teams/team-fullstack.txt vendored
View File

@@ -68,9 +68,6 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
```yaml
activation-instructions:
- Mention *help shows all available commands and options
- Check for active workflow plan using .bmad-core/utils/plan-management.md
- 'If plan exists: Show 📋 Active plan: {workflow} ({progress}% complete). Use *plan-status for details.'
- 'If plan exists: Suggest next action based on plan progress'
- Assess user goal against available agents and workflows in this bundle
- If clear match to an agent's expertise, suggest transformation with *agent command
- If project-oriented, suggest *workflow-guidance to explore options
@@ -192,7 +189,6 @@ dependencies:
- bmad-kb.md
- elicitation-methods.md
utils:
- plan-management.md
- workflow-management.md
```
==================== END: .bmad-core/agents/bmad-orchestrator.md ====================
@@ -2046,7 +2042,7 @@ For full details, see `CONTRIBUTING.md`. Key points:
- Atomic commits - one logical change per commit
- Must align with guiding principles
**Core Principles** (from GUIDING-PRINCIPLES.md):
**Core Principles** (from docs/GUIDING-PRINCIPLES.md):
- **Dev Agents Must Be Lean**: Minimize dependencies, save context for code
- **Natural Language First**: Everything in markdown, no code in core
@@ -2116,8 +2112,8 @@ Use the **expansion-creator** pack to build your own:
## Getting Help
- **Commands**: Use `/help` in any environment to see available commands
- **Agent Switching**: Use `/switch agent-name` with orchestrator for role changes
- **Commands**: Use `*/*help` in any environment to see available commands
- **Agent Switching**: Use `*/*switch agent-name` with orchestrator for role changes
- **Documentation**: Check `docs/` folder for project-specific context
- **Community**: Discord and GitHub resources available for support
- **Contributing**: See `CONTRIBUTING.md` for full guidelines
@@ -2260,228 +2256,6 @@ Use the **expansion-creator** pack to build your own:
- Prepare to continue without additional elicitation
==================== END: .bmad-core/data/elicitation-methods.md ====================
==================== START: .bmad-core/utils/plan-management.md ====================
# Plan Management Utility
## Purpose
Provides utilities for agents and tasks to interact with workflow plans, check progress, update status, and ensure workflow steps are executed in the appropriate sequence.
## Core Functions
### 1. Check Plan Existence
Check for workflow plan:
1. Look for docs/workflow-plan.md (default location)
2. Return plan status to user (exists/not exists) - if not exists then HALT.
### 2. Parse Plan Status
[[LLM: Extract current progress from the plan document]]
**Plan Parsing Logic:**
1. **Identify Step Structure**:
- Look for checkbox lines: `- [ ]` or `- [x]`
- Extract step IDs from comments: `<!-- step-id: X.Y -->`
- Identify agent assignments: `<!-- agent: pm -->`
2. **Determine Current State**:
- Last completed step (highest numbered `[x]`)
- Next expected step (first `[ ]` after completed steps)
- Overall progress percentage
3. **Extract Metadata**:
- Workflow type from plan header
- Decision points and their status
- Any deviation notes
### 3. Sequence Validation
[[LLM: Check if requested action aligns with plan sequence]]
**Validation Rules:**
1. **Strict Mode** (enforceSequence: true):
- Must complete steps in exact order
- Warn and block if out of sequence
- Require explicit override justification
2. **Flexible Mode** (enforceSequence: false):
- Warn about sequence deviation
- Allow with confirmation
- Log deviation reason
**Warning Templates:**
```text
SEQUENCE WARNING:
The workflow plan shows you should complete "{expected_step}" next.
You're attempting to: "{requested_action}"
In strict mode: Block and require plan update
In flexible mode: Allow with confirmation
```
### 4. Plan Update Operations
[[LLM: Provide consistent way to update plan progress]]
**Update Actions:**
1. **Mark Step Complete**:
- Change `- [ ]` to `- [x]`
- Add completion timestamp comment
- Update any status metadata
2. **Add Deviation Note**:
- Insert note explaining why sequence changed
- Reference the deviation in plan
3. **Update Current Step Pointer**:
- Add/move `<!-- current-step -->` marker
- Update last-modified timestamp
### 5. Integration Instructions
[[LLM: How agents and tasks should use this utility]]
**For Agents (startup sequence)**:
```text
1. Check if plan exists using this utility
2. If exists:
- Parse current status
- Show user: "Active workflow plan detected. Current step: {X}"
- Suggest: "Next recommended action: {next_step}"
3. Continue with normal startup
```
**For Tasks (pre-execution)**:
```text
1. Check if plan exists
2. If exists:
- Verify this task aligns with plan
- If not aligned:
- In strict mode: Show warning and stop
- In flexible mode: Show warning and ask for confirmation
3. After task completion:
- Update plan if task was a planned step
- Add note if task was unplanned
```
### 6. Plan Status Report Format
[[LLM: Standard format for showing plan status]]
```text
📋 Workflow Plan Status
━━━━━━━━━━━━━━━━━━━━
Workflow: {workflow_name}
Progress: {X}% complete ({completed}/{total} steps)
✅ Completed:
- {completed_step_1}
- {completed_step_2}
🔄 Current Step:
- {current_step_description}
📌 Upcoming:
- {next_step_1}
- {next_step_2}
⚠️ Notes:
- {any_deviations_or_notes}
```
### 7. Decision Point Handling
[[LLM: Special handling for workflow decision points]]
When encountering a decision point in the plan:
1. **Identify Decision Marker**: `<!-- decision: {decision_id} -->`
2. **Check Decision Status**: Made/Pending
3. **If Pending**:
- Block progress until decision made
- Show options to user
- Record decision when made
4. **If Made**:
- Verify current path aligns with decision
- Warn if attempting alternate path
### 8. Plan Abandonment
[[LLM: Graceful handling when user wants to stop following plan]]
If user wants to abandon plan:
1. Confirm abandonment intent
2. Add abandonment note to plan
3. Mark plan as "Abandoned" in header
4. Stop plan checking for remainder of session
5. Suggest creating new plan if needed
## Usage Examples
### Example 1: Agent Startup Check
```text
BMad Master starting...
[Check for plan]
Found active workflow plan: brownfield-fullstack
Progress: 40% complete (4/10 steps)
Current step: Create PRD (pm agent)
Suggestion: Based on your plan, you should work with the PM agent next.
Use *agent pm to switch, or *plan-status to see full progress.
```
### Example 2: Task Sequence Warning
```text
User: *task create-next-story
[Plan check triggered]
⚠️ SEQUENCE WARNING:
Your workflow plan indicates the PRD hasn't been created yet.
Creating stories before the PRD may lead to incomplete requirements.
Would you like to:
1. Continue anyway (will note deviation in plan)
2. Switch to creating PRD first (*agent pm)
3. View plan status (*plan-status)
```
### Example 3: Automatic Plan Update
```text
[After completing create-doc task for PRD]
✅ Plan Updated: Marked "Create PRD" as complete
📍 Next step: Create Architecture Document (architect agent)
```
## Implementation Notes
- This utility should be lightweight and fast
- Plan parsing should be resilient to format variations
- Always preserve user agency - warnings not blocks (unless strict mode)
- Plan updates should be atomic to prevent corruption
- Consider plan versioning for rollback capability
## Error Handling
- Missing plan: Return null, don't error
- Malformed plan: Warn but continue, treat as no plan
- Update failures: Log but don't block task completion
- Parse errors: Fallback to basic text search
==================== END: .bmad-core/utils/plan-management.md ====================
==================== START: .bmad-core/utils/workflow-management.md ====================
# Workflow Management
@@ -9038,7 +8812,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
### 0. Load Core Configuration and Inputs
- Load `.bmad-core/core-config.yaml` from the project root
- Load `.bmad-core/core-config.yaml`
- If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story validation."
- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`
- Identify and load the following inputs:
@@ -9933,7 +9707,7 @@ workflow:
All stories implemented and reviewed!
Project development phase complete.
Reference: data#bmad-kb:IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid
@@ -10179,7 +9953,7 @@ workflow:
All stories implemented and reviewed!
Project development phase complete.
Reference: data#bmad-kb:IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid
@@ -10376,7 +10150,7 @@ workflow:
All stories implemented and reviewed!
Project development phase complete.
Reference: data#bmad-kb:IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid
@@ -10601,7 +10375,7 @@ workflow:
All stories implemented and reviewed!
Project development phase complete.
Reference: data#bmad-kb:IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid
@@ -11048,7 +10822,7 @@ workflow:
All stories implemented and reviewed!
Project development phase complete.
Reference: data#bmad-kb:IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid

235
dist/teams/team-ide-minimal.txt vendored
View File

@@ -60,9 +60,6 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
```yaml
activation-instructions:
- Mention *help shows all available commands and options
- Check for active workflow plan using .bmad-core/utils/plan-management.md
- 'If plan exists: Show 📋 Active plan: {workflow} ({progress}% complete). Use *plan-status for details.'
- 'If plan exists: Suggest next action based on plan progress'
- Assess user goal against available agents and workflows in this bundle
- If clear match to an agent's expertise, suggest transformation with *agent command
- If project-oriented, suggest *workflow-guidance to explore options
@@ -184,7 +181,6 @@ dependencies:
- bmad-kb.md
- elicitation-methods.md
utils:
- plan-management.md
- workflow-management.md
```
==================== END: .bmad-core/agents/bmad-orchestrator.md ====================
@@ -1945,7 +1941,7 @@ For full details, see `CONTRIBUTING.md`. Key points:
- Atomic commits - one logical change per commit
- Must align with guiding principles
**Core Principles** (from GUIDING-PRINCIPLES.md):
**Core Principles** (from docs/GUIDING-PRINCIPLES.md):
- **Dev Agents Must Be Lean**: Minimize dependencies, save context for code
- **Natural Language First**: Everything in markdown, no code in core
@@ -2015,8 +2011,8 @@ Use the **expansion-creator** pack to build your own:
## Getting Help
- **Commands**: Use `/help` in any environment to see available commands
- **Agent Switching**: Use `/switch agent-name` with orchestrator for role changes
- **Commands**: Use `*/*help` in any environment to see available commands
- **Agent Switching**: Use `*/*switch agent-name` with orchestrator for role changes
- **Documentation**: Check `docs/` folder for project-specific context
- **Community**: Discord and GitHub resources available for support
- **Contributing**: See `CONTRIBUTING.md` for full guidelines
@@ -2159,228 +2155,6 @@ Use the **expansion-creator** pack to build your own:
- Prepare to continue without additional elicitation
==================== END: .bmad-core/data/elicitation-methods.md ====================
==================== START: .bmad-core/utils/plan-management.md ====================
# Plan Management Utility
## Purpose
Provides utilities for agents and tasks to interact with workflow plans, check progress, update status, and ensure workflow steps are executed in the appropriate sequence.
## Core Functions
### 1. Check Plan Existence
Check for workflow plan:
1. Look for docs/workflow-plan.md (default location)
2. Return plan status to user (exists/not exists) - if not exists then HALT.
### 2. Parse Plan Status
[[LLM: Extract current progress from the plan document]]
**Plan Parsing Logic:**
1. **Identify Step Structure**:
- Look for checkbox lines: `- [ ]` or `- [x]`
- Extract step IDs from comments: `<!-- step-id: X.Y -->`
- Identify agent assignments: `<!-- agent: pm -->`
2. **Determine Current State**:
- Last completed step (highest numbered `[x]`)
- Next expected step (first `[ ]` after completed steps)
- Overall progress percentage
3. **Extract Metadata**:
- Workflow type from plan header
- Decision points and their status
- Any deviation notes
### 3. Sequence Validation
[[LLM: Check if requested action aligns with plan sequence]]
**Validation Rules:**
1. **Strict Mode** (enforceSequence: true):
- Must complete steps in exact order
- Warn and block if out of sequence
- Require explicit override justification
2. **Flexible Mode** (enforceSequence: false):
- Warn about sequence deviation
- Allow with confirmation
- Log deviation reason
**Warning Templates:**
```text
SEQUENCE WARNING:
The workflow plan shows you should complete "{expected_step}" next.
You're attempting to: "{requested_action}"
In strict mode: Block and require plan update
In flexible mode: Allow with confirmation
```
### 4. Plan Update Operations
[[LLM: Provide consistent way to update plan progress]]
**Update Actions:**
1. **Mark Step Complete**:
- Change `- [ ]` to `- [x]`
- Add completion timestamp comment
- Update any status metadata
2. **Add Deviation Note**:
- Insert note explaining why sequence changed
- Reference the deviation in plan
3. **Update Current Step Pointer**:
- Add/move `<!-- current-step -->` marker
- Update last-modified timestamp
### 5. Integration Instructions
[[LLM: How agents and tasks should use this utility]]
**For Agents (startup sequence)**:
```text
1. Check if plan exists using this utility
2. If exists:
- Parse current status
- Show user: "Active workflow plan detected. Current step: {X}"
- Suggest: "Next recommended action: {next_step}"
3. Continue with normal startup
```
**For Tasks (pre-execution)**:
```text
1. Check if plan exists
2. If exists:
- Verify this task aligns with plan
- If not aligned:
- In strict mode: Show warning and stop
- In flexible mode: Show warning and ask for confirmation
3. After task completion:
- Update plan if task was a planned step
- Add note if task was unplanned
```
### 6. Plan Status Report Format
[[LLM: Standard format for showing plan status]]
```text
📋 Workflow Plan Status
━━━━━━━━━━━━━━━━━━━━
Workflow: {workflow_name}
Progress: {X}% complete ({completed}/{total} steps)
✅ Completed:
- {completed_step_1}
- {completed_step_2}
🔄 Current Step:
- {current_step_description}
📌 Upcoming:
- {next_step_1}
- {next_step_2}
⚠️ Notes:
- {any_deviations_or_notes}
```
### 7. Decision Point Handling
[[LLM: Special handling for workflow decision points]]
When encountering a decision point in the plan:
1. **Identify Decision Marker**: `<!-- decision: {decision_id} -->`
2. **Check Decision Status**: Made/Pending
3. **If Pending**:
- Block progress until decision made
- Show options to user
- Record decision when made
4. **If Made**:
- Verify current path aligns with decision
- Warn if attempting alternate path
### 8. Plan Abandonment
[[LLM: Graceful handling when user wants to stop following plan]]
If user wants to abandon plan:
1. Confirm abandonment intent
2. Add abandonment note to plan
3. Mark plan as "Abandoned" in header
4. Stop plan checking for remainder of session
5. Suggest creating new plan if needed
## Usage Examples
### Example 1: Agent Startup Check
```text
BMad Master starting...
[Check for plan]
Found active workflow plan: brownfield-fullstack
Progress: 40% complete (4/10 steps)
Current step: Create PRD (pm agent)
Suggestion: Based on your plan, you should work with the PM agent next.
Use *agent pm to switch, or *plan-status to see full progress.
```
### Example 2: Task Sequence Warning
```text
User: *task create-next-story
[Plan check triggered]
⚠️ SEQUENCE WARNING:
Your workflow plan indicates the PRD hasn't been created yet.
Creating stories before the PRD may lead to incomplete requirements.
Would you like to:
1. Continue anyway (will note deviation in plan)
2. Switch to creating PRD first (*agent pm)
3. View plan status (*plan-status)
```
### Example 3: Automatic Plan Update
```text
[After completing create-doc task for PRD]
✅ Plan Updated: Marked "Create PRD" as complete
📍 Next step: Create Architecture Document (architect agent)
```
## Implementation Notes
- This utility should be lightweight and fast
- Plan parsing should be resilient to format variations
- Always preserve user agency - warnings not blocks (unless strict mode)
- Plan updates should be atomic to prevent corruption
- Consider plan versioning for rollback capability
## Error Handling
- Missing plan: Return null, don't error
- Malformed plan: Warn but continue, treat as no plan
- Update failures: Log but don't block task completion
- Parse errors: Fallback to basic text search
==================== END: .bmad-core/utils/plan-management.md ====================
==================== START: .bmad-core/utils/workflow-management.md ====================
# Workflow Management
@@ -3143,7 +2917,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
### 0. Load Core Configuration and Inputs
- Load `.bmad-core/core-config.yaml` from the project root
- Load `.bmad-core/core-config.yaml`
- If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story validation."
- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`
- Identify and load the following inputs:
@@ -4052,7 +3826,6 @@ To identify the next logical story based on project progress and epic definition
- Load `.bmad-core/core-config.yaml` from the project root
- If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story creation. You can either: 1) Copy it from GITHUB bmad-core/core-config.yaml and configure it for your project OR 2) Run the BMad installer against your project to upgrade and add the file automatically. Please add and configure core-config.yaml before proceeding."
- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`, `workflow.*`
- If `workflow.trackProgress: true`, use `utils/plan-management.md` to check plan sequence and warn if out of order
### 1. Identify Next Story for Preparation

236
dist/teams/team-no-ui.txt vendored
View File

@@ -63,9 +63,6 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
```yaml
activation-instructions:
- Mention *help shows all available commands and options
- Check for active workflow plan using .bmad-core/utils/plan-management.md
- 'If plan exists: Show 📋 Active plan: {workflow} ({progress}% complete). Use *plan-status for details.'
- 'If plan exists: Suggest next action based on plan progress'
- Assess user goal against available agents and workflows in this bundle
- If clear match to an agent's expertise, suggest transformation with *agent command
- If project-oriented, suggest *workflow-guidance to explore options
@@ -187,7 +184,6 @@ dependencies:
- bmad-kb.md
- elicitation-methods.md
utils:
- plan-management.md
- workflow-management.md
```
==================== END: .bmad-core/agents/bmad-orchestrator.md ====================
@@ -1988,7 +1984,7 @@ For full details, see `CONTRIBUTING.md`. Key points:
- Atomic commits - one logical change per commit
- Must align with guiding principles
**Core Principles** (from GUIDING-PRINCIPLES.md):
**Core Principles** (from docs/GUIDING-PRINCIPLES.md):
- **Dev Agents Must Be Lean**: Minimize dependencies, save context for code
- **Natural Language First**: Everything in markdown, no code in core
@@ -2058,8 +2054,8 @@ Use the **expansion-creator** pack to build your own:
## Getting Help
- **Commands**: Use `/help` in any environment to see available commands
- **Agent Switching**: Use `/switch agent-name` with orchestrator for role changes
- **Commands**: Use `*/*help` in any environment to see available commands
- **Agent Switching**: Use `*/*switch agent-name` with orchestrator for role changes
- **Documentation**: Check `docs/` folder for project-specific context
- **Community**: Discord and GitHub resources available for support
- **Contributing**: See `CONTRIBUTING.md` for full guidelines
@@ -2202,228 +2198,6 @@ Use the **expansion-creator** pack to build your own:
- Prepare to continue without additional elicitation
==================== END: .bmad-core/data/elicitation-methods.md ====================
==================== START: .bmad-core/utils/plan-management.md ====================
# Plan Management Utility
## Purpose
Provides utilities for agents and tasks to interact with workflow plans, check progress, update status, and ensure workflow steps are executed in the appropriate sequence.
## Core Functions
### 1. Check Plan Existence
Check for workflow plan:
1. Look for docs/workflow-plan.md (default location)
2. Return plan status to user (exists/not exists) - if not exists then HALT.
### 2. Parse Plan Status
[[LLM: Extract current progress from the plan document]]
**Plan Parsing Logic:**
1. **Identify Step Structure**:
- Look for checkbox lines: `- [ ]` or `- [x]`
- Extract step IDs from comments: `<!-- step-id: X.Y -->`
- Identify agent assignments: `<!-- agent: pm -->`
2. **Determine Current State**:
- Last completed step (highest numbered `[x]`)
- Next expected step (first `[ ]` after completed steps)
- Overall progress percentage
3. **Extract Metadata**:
- Workflow type from plan header
- Decision points and their status
- Any deviation notes
### 3. Sequence Validation
[[LLM: Check if requested action aligns with plan sequence]]
**Validation Rules:**
1. **Strict Mode** (enforceSequence: true):
- Must complete steps in exact order
- Warn and block if out of sequence
- Require explicit override justification
2. **Flexible Mode** (enforceSequence: false):
- Warn about sequence deviation
- Allow with confirmation
- Log deviation reason
**Warning Templates:**
```text
SEQUENCE WARNING:
The workflow plan shows you should complete "{expected_step}" next.
You're attempting to: "{requested_action}"
In strict mode: Block and require plan update
In flexible mode: Allow with confirmation
```
### 4. Plan Update Operations
[[LLM: Provide consistent way to update plan progress]]
**Update Actions:**
1. **Mark Step Complete**:
- Change `- [ ]` to `- [x]`
- Add completion timestamp comment
- Update any status metadata
2. **Add Deviation Note**:
- Insert note explaining why sequence changed
- Reference the deviation in plan
3. **Update Current Step Pointer**:
- Add/move `<!-- current-step -->` marker
- Update last-modified timestamp
### 5. Integration Instructions
[[LLM: How agents and tasks should use this utility]]
**For Agents (startup sequence)**:
```text
1. Check if plan exists using this utility
2. If exists:
- Parse current status
- Show user: "Active workflow plan detected. Current step: {X}"
- Suggest: "Next recommended action: {next_step}"
3. Continue with normal startup
```
**For Tasks (pre-execution)**:
```text
1. Check if plan exists
2. If exists:
- Verify this task aligns with plan
- If not aligned:
- In strict mode: Show warning and stop
- In flexible mode: Show warning and ask for confirmation
3. After task completion:
- Update plan if task was a planned step
- Add note if task was unplanned
```
### 6. Plan Status Report Format
[[LLM: Standard format for showing plan status]]
```text
📋 Workflow Plan Status
━━━━━━━━━━━━━━━━━━━━
Workflow: {workflow_name}
Progress: {X}% complete ({completed}/{total} steps)
✅ Completed:
- {completed_step_1}
- {completed_step_2}
🔄 Current Step:
- {current_step_description}
📌 Upcoming:
- {next_step_1}
- {next_step_2}
⚠️ Notes:
- {any_deviations_or_notes}
```
### 7. Decision Point Handling
[[LLM: Special handling for workflow decision points]]
When encountering a decision point in the plan:
1. **Identify Decision Marker**: `<!-- decision: {decision_id} -->`
2. **Check Decision Status**: Made/Pending
3. **If Pending**:
- Block progress until decision made
- Show options to user
- Record decision when made
4. **If Made**:
- Verify current path aligns with decision
- Warn if attempting alternate path
### 8. Plan Abandonment
[[LLM: Graceful handling when user wants to stop following plan]]
If user wants to abandon plan:
1. Confirm abandonment intent
2. Add abandonment note to plan
3. Mark plan as "Abandoned" in header
4. Stop plan checking for remainder of session
5. Suggest creating new plan if needed
## Usage Examples
### Example 1: Agent Startup Check
```text
BMad Master starting...
[Check for plan]
Found active workflow plan: brownfield-fullstack
Progress: 40% complete (4/10 steps)
Current step: Create PRD (pm agent)
Suggestion: Based on your plan, you should work with the PM agent next.
Use *agent pm to switch, or *plan-status to see full progress.
```
### Example 2: Task Sequence Warning
```text
User: *task create-next-story
[Plan check triggered]
⚠️ SEQUENCE WARNING:
Your workflow plan indicates the PRD hasn't been created yet.
Creating stories before the PRD may lead to incomplete requirements.
Would you like to:
1. Continue anyway (will note deviation in plan)
2. Switch to creating PRD first (*agent pm)
3. View plan status (*plan-status)
```
### Example 3: Automatic Plan Update
```text
[After completing create-doc task for PRD]
✅ Plan Updated: Marked "Create PRD" as complete
📍 Next step: Create Architecture Document (architect agent)
```
## Implementation Notes
- This utility should be lightweight and fast
- Plan parsing should be resilient to format variations
- Always preserve user agency - warnings not blocks (unless strict mode)
- Plan updates should be atomic to prevent corruption
- Consider plan versioning for rollback capability
## Error Handling
- Missing plan: Return null, don't error
- Malformed plan: Warn but continue, treat as no plan
- Update failures: Log but don't block task completion
- Parse errors: Fallback to basic text search
==================== END: .bmad-core/utils/plan-management.md ====================
==================== START: .bmad-core/utils/workflow-management.md ====================
# Workflow Management
@@ -8574,7 +8348,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
### 0. Load Core Configuration and Inputs
- Load `.bmad-core/core-config.yaml` from the project root
- Load `.bmad-core/core-config.yaml`
- If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story validation."
- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`
- Identify and load the following inputs:
@@ -9624,7 +9398,7 @@ workflow:
All stories implemented and reviewed!
Project development phase complete.
Reference: data#bmad-kb:IDE Development Workflow
Reference: .bmad-core/data/bmad-kb.md#IDE Development Workflow
flow_diagram: |
```mermaid