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

fix: build web bundles with new file extension includsion

Browse Source
This commit is contained in:
Brian Madison
2025-07-06 19:39:34 -05:00
parent 97590e5e1d
commit 92201ae7ed
30 changed files with 32656 additions and 29677 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
bmad-core/agent-teams/team-all.yaml
View File

@@ -6,9 +6,9 @@ agents:
- bmad-orchestrator - bmad-orchestrator
- '*' - '*'
workflows: workflows:
- brownfield-fullstack - brownfield-fullstack.yaml
- brownfield-service - brownfield-service.yaml
- brownfield-ui - brownfield-ui.yaml
- greenfield-fullstack - greenfield-fullstack.yaml
- greenfield-service - greenfield-service.yaml
- greenfield-ui - greenfield-ui.yaml

12
bmad-core/agent-teams/team-fullstack.yaml
View File

@@ -10,9 +10,9 @@ agents:
- architect - architect
- po - po
workflows: workflows:
- brownfield-fullstack - brownfield-fullstack.yaml
- brownfield-service - brownfield-service.yaml
- brownfield-ui - brownfield-ui.yaml
- greenfield-fullstack - greenfield-fullstack.yaml
- greenfield-service - greenfield-service.yaml
- greenfield-ui - greenfield-ui.yaml

4
bmad-core/agent-teams/team-no-ui.yaml
View File

@@ -9,5 +9,5 @@ agents:
- architect - architect
- po - po
workflows: workflows:
- greenfield-service - greenfield-service.yaml
- brownfield-service - brownfield-service.yaml

12
bmad-core/agents/analyst.md
View File

@@ -51,16 +51,16 @@ commands:
dependencies: dependencies:
tasks: tasks:
- facilitate-brainstorming-session.md - facilitate-brainstorming-session.md
- create-deep-research-prompt - create-deep-research-prompt.md
- create-doc - create-doc.md
- advanced-elicitation - advanced-elicitation.md
- document-project - document-project.md
templates: templates:
- project-brief-tmpl.yaml - project-brief-tmpl.yaml
- market-research-tmpl.yaml - market-research-tmpl.yaml
- competitor-analysis-tmpl.yaml - competitor-analysis-tmpl.yaml
- brainstorming-output-tmpl.yaml - brainstorming-output-tmpl.yaml
data: data:
- bmad-kb - bmad-kb.md
- brainstorming-techniques - brainstorming-techniques.md
``` ```

6
bmad-core/agents/dev.md
View File

@@ -50,8 +50,8 @@ develop-story:
dependencies: dependencies:
tasks: tasks:
- execute-checklist - execute-checklist.md
- validate-next-story - validate-next-story.md
checklists: checklists:
- story-dod-checklist - story-dod-checklist.md
``` ```

14
bmad-core/agents/ux-expert.md
View File

@@ -43,14 +43,12 @@ commands:
- exit: Say goodbye as the UX Expert, and then abandon inhabiting this persona - exit: Say goodbye as the UX Expert, and then abandon inhabiting this persona
dependencies: dependencies:
tasks: tasks:
- generate-ai-frontend-prompt - generate-ai-frontend-prompt.md
- create-deep-research-prompt - create-deep-research-prompt.md
- create-doc - create-doc.md
- execute-checklist - execute-checklist.md
templates: templates:
- front-end-spec-tmpl - front-end-spec-tmpl.yaml
data: data:
- technical-preferences - technical-preferences.md
utils:
- template-format
``` ```

2065
dist/agents/analyst.txt vendored
View File

File diff suppressed because it is too large Load Diff

4638
dist/agents/architect.txt vendored
View File

File diff suppressed because it is too large Load Diff

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

File diff suppressed because it is too large Load Diff

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

@@ -45,6 +45,15 @@ These references map directly to bundle sections:
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode: CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
```yaml ```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
- Load resources only when needed - never pre-load
agent: agent:
name: BMad Orchestrator name: BMad Orchestrator
id: bmad-orchestrator id: bmad-orchestrator
@@ -66,17 +75,6 @@ persona:
- Always use numbered lists for choices - Always use numbered lists for choices
- Process commands starting with * immediately - Process commands starting with * immediately
- Always remind users that commands require * prefix - Always remind users that commands require * prefix
startup:
- Announce: Introduce yourself as the BMad Orchestrator, explain you can coordinate agents and workflows
- IMPORTANT: Tell users that all commands start with * (e.g., *help, *agent, *workflow)
- 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
- Load resources only when needed - never pre-load
commands: commands:
help: Show this guide with available agents and workflows help: Show this guide with available agents and workflows
chat-mode: Start conversational mode for detailed assistance chat-mode: Start conversational mode for detailed assistance
@@ -164,17 +162,18 @@ workflow-guidance:
- When *workflow-guidance is called, start an interactive session and list all available workflows with brief descriptions - When *workflow-guidance is called, start an interactive session and list all available workflows with brief descriptions
dependencies: dependencies:
tasks: tasks:
- advanced-elicitation - advanced-elicitation.md
- create-doc - create-doc.md
- create-workflow-plan - create-workflow-plan.md
- kb-mode-interaction - kb-mode-interaction.md
- update-workflow-plan - update-workflow-plan.md
data: data:
- bmad-kb - bmad-kb.md
- elicitation-methods.md
utils: utils:
- plan-management - plan-management.md
- workflow-management - workflow-management.md
- template-format - template-format.md
``` ```
==================== END: .bmad-core/agents/bmad-orchestrator.md ==================== ==================== END: .bmad-core/agents/bmad-orchestrator.md ====================
@@ -299,97 +298,85 @@ Choose a number (0-8) or 9 to proceed:
==================== END: .bmad-core/tasks/advanced-elicitation.md ==================== ==================== END: .bmad-core/tasks/advanced-elicitation.md ====================
==================== START: .bmad-core/tasks/create-doc.md ==================== ==================== START: .bmad-core/tasks/create-doc.md ====================
# Create Document from Template Task # Create Document from Template (YAML Driven)
## Purpose ## CRITICAL: Mandatory Elicitation Format
Generate documents from templates by EXECUTING (not just reading) embedded instructions from the perspective of the selected agent persona. **When `elicit: true`, ALWAYS use this exact format:**
## CRITICAL RULES 1. Present section content
2. Provide detailed rationale (explain trade-offs, assumptions, decisions made)
3. Present numbered options 1-9:
- **Option 1:** Always "Proceed to next section"
- **Options 2-9:** Select 8 methods from data/elicitation-methods
- End with: "Select 1-9 or just type your question/feedback:"
1. **Templates are PROGRAMS** - Execute every [[LLM:]] instruction exactly as written **NEVER ask yes/no questions or use any other format.**
2. **NEVER show markup** - Hide all [[LLM:]], {{placeholders}}, @{examples}, and template syntax
3. **STOP and EXECUTE** - When you see "apply tasks#" or "execute tasks#", STOP and run that task immediately
4. **WAIT for user input** - At review points and after elicitation tasks
## Execution Flow ## Processing Flow
### 0. Check Workflow Plan (if configured) 1. **Parse YAML template** - Load template metadata and sections
2. **Set preferences** - Show current mode (Interactive), confirm output file
3. **Process each section:**
- Skip if condition unmet
- Check agent permissions (owner/editors) - note if section is restricted to specific agents
- Draft content using section instruction
- Present content + detailed rationale
- **IF elicit: true** → MANDATORY 1-9 options format
- Save to file if possible
4. **Continue until complete**
[[LLM: Check if plan tracking is enabled in core-config.yaml]] ## Detailed Rationale Requirements
- If `workflow.trackProgress: true`, check for active plan using .bmad-core/utils/plan-management.md When presenting section content, ALWAYS include rationale that explains:
- If plan exists and this document creation is part of the plan:
- Verify this is the expected next step
- If out of sequence and `enforceSequence: true`, warn user and halt without user override
- If out of sequence and `enforceSequence: false`, ask for confirmation
- Continue with normal execution after plan check
### 1. Identify Template - Trade-offs and choices made (what was chosen over alternatives and why)
- Key assumptions made during drafting
- Interesting or questionable decisions that need user attention
- Areas that might need validation
- Load from `.bmad-core/templates/*.md` or `.bmad-core/templates directory` ## Elicitation Results Flow
- Agent-specific templates are listed in agent's dependencies
- If agent has `templates: [prd-tmpl, architecture-tmpl]` for example, then offer to create "PRD" and "Architecture" documents
### 2. Ask Interaction Mode After user selects elicitation method (2-9):
> 1. **Incremental** - Section by section with reviews 1. Execute method from data/elicitation-methods
> 2. **YOLO Mode** - Complete draft then review (user can type `/yolo` anytime to switch) 2. Present results with insights
3. Offer options:
- **1. Apply changes and update section**
- **2. Return to elicitation menu**
- **3. Ask any questions or engage further with this elicitation**
### 3. Execute Template ## Agent Permissions
- Replace {{placeholders}} with real content When processing sections with agent permission fields:
- Execute [[LLM:]] instructions as you encounter them
- Process <<REPEAT>> loops and ^^CONDITIONS^^
- Use @{examples} for guidance but never output them
### 4. Key Execution Patterns - **owner**: Note which agent role initially creates/populates the section
- **editors**: List agent roles allowed to modify the section
- **readonly**: Mark sections that cannot be modified after creation
**When you see:** `[[LLM: Draft X and immediately execute .bmad-core/tasks/advanced-elicitation.md]]` **For sections with restricted access:**
- Draft the content - Include a note in the generated document indicating the responsible agent
- Present it to user - Example: "_(This section is owned by dev-agent and can only be modified by dev-agent)_"
- IMMEDIATELY execute the task
- Wait for completion before continuing
**When you see:** `[[LLM: After section completion, apply .bmad-core/tasks/Y.md]]` ## YOLO Mode
- Finish the section User can type `#yolo` to toggle to YOLO mode (process all sections at once).
- STOP and execute the task
- Wait for user input
### 5. Validation & Final Presentation ## CRITICAL REMINDERS
- Run any specified checklists **❌ NEVER:**
- Present clean, formatted content only
- No truncation or summarization
- Begin directly with content (no preamble)
- Include any handoff prompts from template
### 6. Update Workflow Plan (if applicable) - Ask yes/no questions for elicitation
- Use any format other than 1-9 numbered options
- Create new elicitation methods
[[LLM: After successful document creation]] **✅ ALWAYS:**
- If plan tracking is enabled and document was part of plan: - Use exact 1-9 format when elicit: true
- Call update-workflow-plan task to mark step complete - Select options 2-9 from data/elicitation-methods only
- Parameters: task: create-doc, step_id: {from plan}, status: complete - Provide detailed rationale explaining decisions
- Show next recommended step from plan - End with "Select 1-9 or just type your question/feedback:"
## Common Mistakes to Avoid
❌ Skipping elicitation tasks
❌ Showing template markup to users
❌ Continuing past STOP signals
❌ Combining multiple review points
✅ Execute ALL instructions in sequence
✅ Present only clean, formatted content
✅ Stop at every elicitation point
✅ Wait for user confirmation when instructed
## Remember
Templates contain precise instructions for a reason. Follow them exactly to ensure document quality and completeness.
==================== END: .bmad-core/tasks/create-doc.md ==================== ==================== END: .bmad-core/tasks/create-doc.md ====================
==================== START: .bmad-core/tasks/create-workflow-plan.md ==================== ==================== START: .bmad-core/tasks/create-workflow-plan.md ====================
@@ -1821,6 +1808,143 @@ Use the **expansion-creator** pack to build your own:
- **Contributing**: See `CONTRIBUTING.md` for full guidelines - **Contributing**: See `CONTRIBUTING.md` for full guidelines
==================== END: .bmad-core/data/bmad-kb.md ==================== ==================== END: .bmad-core/data/bmad-kb.md ====================
==================== START: .bmad-core/data/elicitation-methods.md ====================
# Elicitation Methods Data
## Core Reflective Methods
**Expand or Contract for Audience**
- Ask whether to 'expand' (add detail, elaborate) or 'contract' (simplify, clarify)
- Identify specific target audience if relevant
- Tailor content complexity and depth accordingly
**Explain Reasoning (CoT Step-by-Step)**
- Walk through the step-by-step thinking process
- Reveal underlying assumptions and decision points
- Show how conclusions were reached from current role's perspective
**Critique and Refine**
- Review output for flaws, inconsistencies, or improvement areas
- Identify specific weaknesses from role's expertise
- Suggest refined version reflecting domain knowledge
## Structural Analysis Methods
**Analyze Logical Flow and Dependencies**
- Examine content structure for logical progression
- Check internal consistency and coherence
- Identify and validate dependencies between elements
- Confirm effective ordering and sequencing
**Assess Alignment with Overall Goals**
- Evaluate content contribution to stated objectives
- Identify any misalignments or gaps
- Interpret alignment from specific role's perspective
- Suggest adjustments to better serve goals
## Risk and Challenge Methods
**Identify Potential Risks and Unforeseen Issues**
- Brainstorm potential risks from role's expertise
- Identify overlooked edge cases or scenarios
- Anticipate unintended consequences
- Highlight implementation challenges
**Challenge from Critical Perspective**
- Adopt critical stance on current content
- Play devil's advocate from specified viewpoint
- Argue against proposal highlighting weaknesses
- Apply YAGNI principles when appropriate (scope trimming)
## Creative Exploration Methods
**Tree of Thoughts Deep Dive**
- Break problem into discrete "thoughts" or intermediate steps
- Explore multiple reasoning paths simultaneously
- Use self-evaluation to classify each path as "sure", "likely", or "impossible"
- Apply search algorithms (BFS/DFS) to find optimal solution paths
**Hindsight is 20/20: The 'If Only...' Reflection**
- Imagine retrospective scenario based on current content
- Identify the one "if only we had known/done X..." insight
- Describe imagined consequences humorously or dramatically
- Extract actionable learnings for current context
## Multi-Persona Collaboration Methods
**Agile Team Perspective Shift**
- Rotate through different Scrum team member viewpoints
- Product Owner: Focus on user value and business impact
- Scrum Master: Examine process flow and team dynamics
- Developer: Assess technical implementation and complexity
- QA: Identify testing scenarios and quality concerns
**Stakeholder Round Table**
- Convene virtual meeting with multiple personas
- Each persona contributes unique perspective on content
- Identify conflicts and synergies between viewpoints
- Synthesize insights into actionable recommendations
**Meta-Prompting Analysis**
- Step back to analyze the structure and logic of current approach
- Question the format and methodology being used
- Suggest alternative frameworks or mental models
- Optimize the elicitation process itself
## Advanced 2025 Techniques
**Self-Consistency Validation**
- Generate multiple reasoning paths for same problem
- Compare consistency across different approaches
- Identify most reliable and robust solution
- Highlight areas where approaches diverge and why
**ReWOO (Reasoning Without Observation)**
- Separate parametric reasoning from tool-based actions
- Create reasoning plan without external dependencies
- Identify what can be solved through pure reasoning
- Optimize for efficiency and reduced token usage
**Persona-Pattern Hybrid**
- Combine specific role expertise with elicitation pattern
- Architect + Risk Analysis: Deep technical risk assessment
- UX Expert + User Journey: End-to-end experience critique
- PM + Stakeholder Analysis: Multi-perspective impact review
**Emergent Collaboration Discovery**
- Allow multiple perspectives to naturally emerge
- Identify unexpected insights from persona interactions
- Explore novel combinations of viewpoints
- Capture serendipitous discoveries from multi-agent thinking
## Game-Based Elicitation Methods
**Red Team vs Blue Team**
- Red Team: Attack the proposal, find vulnerabilities
- Blue Team: Defend and strengthen the approach
- Competitive analysis reveals blind spots
- Results in more robust, battle-tested solutions
**Innovation Tournament**
- Pit multiple alternative approaches against each other
- Score each approach across different criteria
- Crowd-source evaluation from different personas
- Identify winning combination of features
**Escape Room Challenge**
- Present content as constraints to work within
- Find creative solutions within tight limitations
- Identify minimum viable approach
- Discover innovative workarounds and optimizations
## Process Control
**Proceed / No Further Actions**
- Acknowledge choice to finalize current work
- Accept output as-is or move to next step
- Prepare to continue without additional elicitation
==================== END: .bmad-core/data/elicitation-methods.md ====================
==================== START: .bmad-core/utils/plan-management.md ==================== ==================== START: .bmad-core/utils/plan-management.md ====================
# Plan Management Utility # Plan Management Utility

12
dist/agents/dev.txt vendored
View File

@@ -45,6 +45,7 @@ These references map directly to bundle sections:
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode: CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
```yaml ```yaml
activation-instructions: []
agent: agent:
name: James name: James
id: dev id: dev
@@ -52,11 +53,6 @@ agent:
icon: 💻 icon: 💻
whenToUse: Use for code implementation, debugging, refactoring, and development best practices whenToUse: Use for code implementation, debugging, refactoring, and development best practices
customization: null customization: null
startup:
- Announce: Greet the user with your name and role, and inform of the *help command.
- CRITICAL: Read the following full files as these are your explicit rules for development standards for this project - .bmad-core/core-config.yaml devLoadAlwaysFiles list
- CRITICAL: Do NOT load any other files during startup aside from the assigned story and devLoadAlwaysFiles items, unless user requested you do or the following contradicts
- CRITICAL: Do NOT begin development until a story is not in draft mode and you are told to proceed
persona: persona:
role: Expert Senior Software Engineer & Implementation Specialist role: Expert Senior Software Engineer & Implementation Specialist
style: Extremely concise, pragmatic, detail-oriented, solution-focused style: Extremely concise, pragmatic, detail-oriented, solution-focused
@@ -83,10 +79,10 @@ develop-story:
completion: 'All Tasks and Subtasks marked [x] and have tests→Validations and full regression passes (DON''T BE LAZY, EXECUTE ALL TESTS and CONFIRM)→Ensure File List is Complete→run the task execute-checklist for the checklist story-dod-checklist→set story status: ''Ready for Review''→HALT' completion: 'All Tasks and Subtasks marked [x] and have tests→Validations and full regression passes (DON''T BE LAZY, EXECUTE ALL TESTS and CONFIRM)→Ensure File List is Complete→run the task execute-checklist for the checklist story-dod-checklist→set story status: ''Ready for Review''→HALT'
dependencies: dependencies:
tasks: tasks:
- execute-checklist - execute-checklist.md
- validate-next-story - validate-next-story.md
checklists: checklists:
- story-dod-checklist - story-dod-checklist.md
``` ```
==================== END: .bmad-core/agents/dev.md ==================== ==================== END: .bmad-core/agents/dev.md ====================

1144
dist/agents/pm.txt vendored
View File

File diff suppressed because it is too large Load Diff

219
dist/agents/po.txt vendored
View File

@@ -50,6 +50,7 @@ activation-instructions:
- Only read the files/tasks listed here when user selects them for execution to minimize context usage - Only read the files/tasks listed here when user selects them for execution to minimize context usage
- The customization field ALWAYS takes precedence over any conflicting instructions - The customization field ALWAYS takes precedence over any conflicting instructions
- When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
- Greet the user with your name and role, and inform of the *help command.
agent: agent:
name: Sarah name: Sarah
id: po id: po
@@ -73,8 +74,6 @@ persona:
- User Collaboration for Validation - Seek input at critical checkpoints - User Collaboration for Validation - Seek input at critical checkpoints
- Focus on Executable & Value-Driven Increments - Ensure work aligns with MVP goals - Focus on Executable & Value-Driven Increments - Ensure work aligns with MVP goals
- Documentation Ecosystem Integrity - Maintain consistency across all documents - Documentation Ecosystem Integrity - Maintain consistency across all documents
startup:
- Greet the user with your name and role, and inform of the *help command.
commands: commands:
- help: Show numbered list of the following commands to allow selection - help: Show numbered list of the following commands to allow selection
- create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below) - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
@@ -89,19 +88,17 @@ commands:
- exit: Exit (confirm) - exit: Exit (confirm)
dependencies: dependencies:
tasks: tasks:
- execute-checklist - execute-checklist.md
- shard-doc - shard-doc.md
- correct-course - correct-course.md
- brownfield-create-epic - brownfield-create-epic.md
- brownfield-create-story - brownfield-create-story.md
- validate-next-story - validate-next-story.md
templates: templates:
- story-tmpl - story-tmpl.yaml
checklists: checklists:
- po-master-checklist - po-master-checklist.md
- change-checklist - change-checklist.md
utils:
- template-format
``` ```
==================== END: .bmad-core/agents/po.md ==================== ==================== END: .bmad-core/agents/po.md ====================
@@ -921,66 +918,145 @@ Provide a structured validation report including:
- **Confidence Level**: High/Medium/Low for successful implementation - **Confidence Level**: High/Medium/Low for successful implementation
==================== END: .bmad-core/tasks/validate-next-story.md ==================== ==================== END: .bmad-core/tasks/validate-next-story.md ====================
==================== START: .bmad-core/templates/story-tmpl.md ==================== ==================== START: .bmad-core/templates/story-tmpl.yaml ====================
--- template:
defaultOutput: docs/stories/{{EpicNum}}.{{StoryNum}}.{{Short Title Copied from Epic File specific story}}.md id: story-template-v2
smAgent: name: Story Document
editableSections: Status, Story, Acceptance Criteria, Tasks / Subtasks, Dev Notes, Testing, Change Log version: 2.0
sectionSpecificInstructions: output:
"Dev Notes": format: markdown
- Populate relevant information, only what was pulled from actual artifacts from docs folder, relevant to this story filename: docs/stories/{{epic_num}}.{{story_num}}.{{story_title_short}}.md
- Do not invent information. title: "Story {{epic_num}}.{{story_num}}: {{story_title_short}}"
- If known add Relevant Source Tree info that relates to this story.
- If there were important notes from previous story that are relevant to this one, include them here.
- Put enough information in this section so that the dev agent should NEVER need to read the architecture documents, these notes along with the tasks and subtasks must give the Dev Agent the complete context it needs to comprehend with the least amount of overhead the information to complete the story, meeting all AC and completing all tasks+subtasks.
Testing:
- List Relevant Testing Standards from Architecture the Developer needs to conform to (test file location, test standards, etc)
---
# Story {{EpicNum}}.{{StoryNum}}: {{Short Title Copied from Epic File specific story}} workflow:
mode: interactive
elicitation: advanced-elicitation
## Status: {{ Draft | Approved | InProgress | Review | Done }} agent_config:
editable_sections:
- Status
- Story
- Acceptance Criteria
- Tasks / Subtasks
- Dev Notes
- Testing
- Change Log
## Story sections:
- id: status
title: Status
type: choice
choices: [Draft, Approved, InProgress, Review, Done]
instruction: Select the current status of the story
owner: scrum-master
editors: [scrum-master, dev-agent]
**As a** {{role}},\ - id: story
**I want** {{action}},\ title: Story
**so that** {{benefit}} type: template-text
template: |
**As a** {{role}},
**I want** {{action}},
**so that** {{benefit}}
instruction: Define the user story using the standard format with role, action, and benefit
elicit: true
owner: scrum-master
editors: [scrum-master]
## Acceptance Criteria - id: acceptance-criteria
title: Acceptance Criteria
type: numbered-list
instruction: Copy the acceptance criteria numbered list from the epic file
elicit: true
owner: scrum-master
editors: [scrum-master]
{{ Copy of Acceptance Criteria numbered list }} - id: tasks-subtasks
title: Tasks / Subtasks
## Tasks / Subtasks type: bullet-list
instruction: |
- [ ] Task 1 (AC: # if applicable) Break down the story into specific tasks and subtasks needed for implementation.
Reference applicable acceptance criteria numbers where relevant.
template: |
- [ ] Task 1 (AC: # if applicable)
- [ ] Subtask1.1... - [ ] Subtask1.1...
- [ ] Task 2 (AC: # if applicable) - [ ] Task 2 (AC: # if applicable)
- [ ] Subtask 2.1... - [ ] Subtask 2.1...
- [ ] Task 3 (AC: # if applicable) - [ ] Task 3 (AC: # if applicable)
- [ ] Subtask 3.1... - [ ] Subtask 3.1...
elicit: true
owner: scrum-master
editors: [scrum-master, dev-agent]
## Dev Notes - id: dev-notes
title: Dev Notes
instruction: |
Populate relevant information, only what was pulled from actual artifacts from docs folder, relevant to this story:
- Do not invent information
- If known add Relevant Source Tree info that relates to this story
- If there were important notes from previous story that are relevant to this one, include them here
- Put enough information in this section so that the dev agent should NEVER need to read the architecture documents, these notes along with the tasks and subtasks must give the Dev Agent the complete context it needs to comprehend with the least amount of overhead the information to complete the story, meeting all AC and completing all tasks+subtasks
elicit: true
owner: scrum-master
editors: [scrum-master]
sections:
- id: testing-standards
title: Testing
instruction: |
List Relevant Testing Standards from Architecture the Developer needs to conform to:
- Test file location
- Test standards
- Testing frameworks and patterns to use
- Any specific testing requirements for this story
elicit: true
owner: scrum-master
editors: [scrum-master]
### Testing - id: change-log
title: Change Log
type: table
columns: [Date, Version, Description, Author]
instruction: Track changes made to this story document
owner: scrum-master
editors: [scrum-master, dev-agent, qa-agent]
## Change Log - id: dev-agent-record
title: Dev Agent Record
instruction: This section is populated by the development agent during implementation
owner: dev-agent
editors: [dev-agent]
sections:
- id: agent-model
title: Agent Model Used
template: "{{agent_model_name_version}}"
instruction: Record the specific AI agent model and version used for development
owner: dev-agent
editors: [dev-agent]
| Date | Version | Description | Author | - id: debug-log-references
| :--- | :------ | :---------- | :----- | title: Debug Log References
instruction: Reference any debug logs or traces generated during development
owner: dev-agent
editors: [dev-agent]
## Dev Agent Record - id: completion-notes
title: Completion Notes List
instruction: Notes about the completion of tasks and any issues encountered
owner: dev-agent
editors: [dev-agent]
### Agent Model Used: {{Agent Model Name/Version}} - id: file-list
title: File List
instruction: List all files created, modified, or affected during story implementation
owner: dev-agent
editors: [dev-agent]
### Debug Log References - id: qa-results
title: QA Results
### Completion Notes List instruction: Results from QA Agent QA review of the completed story implementation
owner: qa-agent
### File List editors: [qa-agent]
==================== END: .bmad-core/templates/story-tmpl.yaml ====================
## QA Results
==================== END: .bmad-core/templates/story-tmpl.md ====================
==================== START: .bmad-core/checklists/po-master-checklist.md ==================== ==================== START: .bmad-core/checklists/po-master-checklist.md ====================
# Product Owner (PO) Master Validation Checklist # Product Owner (PO) Master Validation Checklist
@@ -1610,32 +1686,3 @@ Keep it action-oriented and forward-looking.]]
--- ---
==================== END: .bmad-core/checklists/change-checklist.md ==================== ==================== END: .bmad-core/checklists/change-checklist.md ====================
==================== START: .bmad-core/utils/template-format.md ====================
# Template Format Conventions
Templates in the BMad method use standardized markup for AI processing. These conventions ensure consistent document generation.
## Template Markup Elements
- **{{placeholders}}**: Variables to be replaced with actual content
- **[[LLM: instructions]]**: Internal processing instructions for AI agents (never shown to users)
- **REPEAT** sections: Content blocks that may be repeated as needed
- **^^CONDITION^^** blocks: Conditional content included only if criteria are met
- **@{examples}**: Example content for guidance (never output to users)
## Processing Rules
- Replace all {{placeholders}} with project-specific content
- Execute all [[LLM: instructions]] internally without showing users
- Process conditional and repeat blocks as specified
- Use examples for guidance but never include them in final output
- Present only clean, formatted content to users
## Critical Guidelines
- **NEVER display template markup, LLM instructions, or examples to users**
- Template elements are for AI processing only
- Focus on faithful template execution and clean output
- All template-specific instructions are embedded within templates
==================== END: .bmad-core/utils/template-format.md ====================

180
dist/agents/qa.txt vendored
View File

@@ -50,6 +50,7 @@ activation-instructions:
- Only read the files/tasks listed here when user selects them for execution to minimize context usage - Only read the files/tasks listed here when user selects them for execution to minimize context usage
- The customization field ALWAYS takes precedence over any conflicting instructions - The customization field ALWAYS takes precedence over any conflicting instructions
- When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
- Greet the user with your name and role, and inform of the *help command.
agent: agent:
name: Quinn name: Quinn
id: qa id: qa
@@ -73,8 +74,6 @@ persona:
- Risk-Based Testing - Prioritize testing based on risk and critical areas - Risk-Based Testing - Prioritize testing based on risk and critical areas
- Continuous Improvement - Balance perfection with pragmatism - Continuous Improvement - Balance perfection with pragmatism
- Architecture & Design Patterns - Ensure proper patterns and maintainable code structure - Architecture & Design Patterns - Ensure proper patterns and maintainable code structure
startup:
- Greet the user with your name and role, and inform of the *help command.
story-file-permissions: story-file-permissions:
- CRITICAL: When reviewing stories, you are ONLY authorized to update the "QA Results" section of story files - CRITICAL: When reviewing stories, you are ONLY authorized to update the "QA Results" section of story files
- CRITICAL: DO NOT modify any other sections including Status, Story, Acceptance Criteria, Tasks/Subtasks, Dev Notes, Testing, Dev Agent Record, Change Log, or any other sections - CRITICAL: DO NOT modify any other sections including Status, Story, Acceptance Criteria, Tasks/Subtasks, Dev Notes, Testing, Dev Agent Record, Change Log, or any other sections
@@ -86,11 +85,11 @@ commands:
- exit: Say goodbye as the QA Engineer, and then abandon inhabiting this persona - exit: Say goodbye as the QA Engineer, and then abandon inhabiting this persona
dependencies: dependencies:
tasks: tasks:
- review-story - review-story.md
data: data:
- technical-preferences - technical-preferences.md
utils: templates:
- template-format - story-tmpl.yaml
``` ```
==================== END: .bmad-core/agents/qa.md ==================== ==================== END: .bmad-core/agents/qa.md ====================
@@ -242,37 +241,148 @@ After review:
3. Always provide constructive feedback and explanations for learning 3. Always provide constructive feedback and explanations for learning
==================== END: .bmad-core/tasks/review-story.md ==================== ==================== END: .bmad-core/tasks/review-story.md ====================
==================== START: .bmad-core/templates/story-tmpl.yaml ====================
template:
id: story-template-v2
name: Story Document
version: 2.0
output:
format: markdown
filename: docs/stories/{{epic_num}}.{{story_num}}.{{story_title_short}}.md
title: "Story {{epic_num}}.{{story_num}}: {{story_title_short}}"
workflow:
mode: interactive
elicitation: advanced-elicitation
agent_config:
editable_sections:
- Status
- Story
- Acceptance Criteria
- Tasks / Subtasks
- Dev Notes
- Testing
- Change Log
sections:
- id: status
title: Status
type: choice
choices: [Draft, Approved, InProgress, Review, Done]
instruction: Select the current status of the story
owner: scrum-master
editors: [scrum-master, dev-agent]
- id: story
title: Story
type: template-text
template: |
**As a** {{role}},
**I want** {{action}},
**so that** {{benefit}}
instruction: Define the user story using the standard format with role, action, and benefit
elicit: true
owner: scrum-master
editors: [scrum-master]
- id: acceptance-criteria
title: Acceptance Criteria
type: numbered-list
instruction: Copy the acceptance criteria numbered list from the epic file
elicit: true
owner: scrum-master
editors: [scrum-master]
- id: tasks-subtasks
title: Tasks / Subtasks
type: bullet-list
instruction: |
Break down the story into specific tasks and subtasks needed for implementation.
Reference applicable acceptance criteria numbers where relevant.
template: |
- [ ] Task 1 (AC: # if applicable)
- [ ] Subtask1.1...
- [ ] Task 2 (AC: # if applicable)
- [ ] Subtask 2.1...
- [ ] Task 3 (AC: # if applicable)
- [ ] Subtask 3.1...
elicit: true
owner: scrum-master
editors: [scrum-master, dev-agent]
- id: dev-notes
title: Dev Notes
instruction: |
Populate relevant information, only what was pulled from actual artifacts from docs folder, relevant to this story:
- Do not invent information
- If known add Relevant Source Tree info that relates to this story
- If there were important notes from previous story that are relevant to this one, include them here
- Put enough information in this section so that the dev agent should NEVER need to read the architecture documents, these notes along with the tasks and subtasks must give the Dev Agent the complete context it needs to comprehend with the least amount of overhead the information to complete the story, meeting all AC and completing all tasks+subtasks
elicit: true
owner: scrum-master
editors: [scrum-master]
sections:
- id: testing-standards
title: Testing
instruction: |
List Relevant Testing Standards from Architecture the Developer needs to conform to:
- Test file location
- Test standards
- Testing frameworks and patterns to use
- Any specific testing requirements for this story
elicit: true
owner: scrum-master
editors: [scrum-master]
- id: change-log
title: Change Log
type: table
columns: [Date, Version, Description, Author]
instruction: Track changes made to this story document
owner: scrum-master
editors: [scrum-master, dev-agent, qa-agent]
- id: dev-agent-record
title: Dev Agent Record
instruction: This section is populated by the development agent during implementation
owner: dev-agent
editors: [dev-agent]
sections:
- id: agent-model
title: Agent Model Used
template: "{{agent_model_name_version}}"
instruction: Record the specific AI agent model and version used for development
owner: dev-agent
editors: [dev-agent]
- id: debug-log-references
title: Debug Log References
instruction: Reference any debug logs or traces generated during development
owner: dev-agent
editors: [dev-agent]
- id: completion-notes
title: Completion Notes List
instruction: Notes about the completion of tasks and any issues encountered
owner: dev-agent
editors: [dev-agent]
- id: file-list
title: File List
instruction: List all files created, modified, or affected during story implementation
owner: dev-agent
editors: [dev-agent]
- id: qa-results
title: QA Results
instruction: Results from QA Agent QA review of the completed story implementation
owner: qa-agent
editors: [qa-agent]
==================== END: .bmad-core/templates/story-tmpl.yaml ====================
==================== START: .bmad-core/data/technical-preferences.md ==================== ==================== START: .bmad-core/data/technical-preferences.md ====================
# User-Defined Preferred Patterns and Preferences # User-Defined Preferred Patterns and Preferences
None Listed None Listed
==================== END: .bmad-core/data/technical-preferences.md ==================== ==================== END: .bmad-core/data/technical-preferences.md ====================
==================== START: .bmad-core/utils/template-format.md ====================
# Template Format Conventions
Templates in the BMad method use standardized markup for AI processing. These conventions ensure consistent document generation.
## Template Markup Elements
- **{{placeholders}}**: Variables to be replaced with actual content
- **[[LLM: instructions]]**: Internal processing instructions for AI agents (never shown to users)
- **REPEAT** sections: Content blocks that may be repeated as needed
- **^^CONDITION^^** blocks: Conditional content included only if criteria are met
- **@{examples}**: Example content for guidance (never output to users)
## Processing Rules
- Replace all {{placeholders}} with project-specific content
- Execute all [[LLM: instructions]] internally without showing users
- Process conditional and repeat blocks as specified
- Use examples for guidance but never include them in final output
- Present only clean, formatted content to users
## Critical Guidelines
- **NEVER display template markup, LLM instructions, or examples to users**
- Template elements are for AI processing only
- Focus on faithful template execution and clean output
- All template-specific instructions are embedded within templates
==================== END: .bmad-core/utils/template-format.md ====================

213
dist/agents/sm.txt vendored
View File

@@ -49,6 +49,7 @@ activation-instructions:
- Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER! - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
- The customization field ALWAYS takes precedence over any conflicting instructions - The customization field ALWAYS takes precedence over any conflicting instructions
- When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
- Greet the user with your name and role, and inform of the *help command and then HALT to await instruction if not given already.
agent: agent:
name: Bob name: Bob
id: sm id: sm
@@ -65,10 +66,6 @@ persona:
- Rigorously follow `create-next-story` procedure to generate the detailed user story - Rigorously follow `create-next-story` procedure to generate the detailed user story
- Will ensure all information comes from the PRD and Architecture to guide the dumb dev agent - Will ensure all information comes from the PRD and Architecture to guide the dumb dev agent
- You are NOT allowed to implement stories or modify code EVER! - You are NOT allowed to implement stories or modify code EVER!
startup:
- Greet the user with your name and role, and inform of the *help command and then HALT to await instruction if not given already.
- Offer to help with story preparation but wait for explicit user confirmation
- Only execute tasks when user explicitly requests them
commands: commands:
- help: Show numbered list of the following commands to allow selection - help: Show numbered list of the following commands to allow selection
- draft: Execute task create-next-story - draft: Execute task create-next-story
@@ -77,15 +74,13 @@ commands:
- exit: Say goodbye as the Scrum Master, and then abandon inhabiting this persona - exit: Say goodbye as the Scrum Master, and then abandon inhabiting this persona
dependencies: dependencies:
tasks: tasks:
- create-next-story - create-next-story.md
- execute-checklist - execute-checklist.md
- correct-course - correct-course.md
templates: templates:
- story-tmpl - story-tmpl.yaml
checklists: checklists:
- story-draft-checklist - story-draft-checklist.md
utils:
- template-format
``` ```
==================== END: .bmad-core/agents/sm.md ==================== ==================== END: .bmad-core/agents/sm.md ====================
@@ -378,66 +373,145 @@ The LLM will:
- **Implicit:** An annotated `change-checklist` (or the record of its completion) reflecting the discussions, findings, and decisions made during the process. - **Implicit:** An annotated `change-checklist` (or the record of its completion) reflecting the discussions, findings, and decisions made during the process.
==================== END: .bmad-core/tasks/correct-course.md ==================== ==================== END: .bmad-core/tasks/correct-course.md ====================
==================== START: .bmad-core/templates/story-tmpl.md ==================== ==================== START: .bmad-core/templates/story-tmpl.yaml ====================
--- template:
defaultOutput: docs/stories/{{EpicNum}}.{{StoryNum}}.{{Short Title Copied from Epic File specific story}}.md id: story-template-v2
smAgent: name: Story Document
editableSections: Status, Story, Acceptance Criteria, Tasks / Subtasks, Dev Notes, Testing, Change Log version: 2.0
sectionSpecificInstructions: output:
"Dev Notes": format: markdown
- Populate relevant information, only what was pulled from actual artifacts from docs folder, relevant to this story filename: docs/stories/{{epic_num}}.{{story_num}}.{{story_title_short}}.md
- Do not invent information. title: "Story {{epic_num}}.{{story_num}}: {{story_title_short}}"
- If known add Relevant Source Tree info that relates to this story.
- If there were important notes from previous story that are relevant to this one, include them here.
- Put enough information in this section so that the dev agent should NEVER need to read the architecture documents, these notes along with the tasks and subtasks must give the Dev Agent the complete context it needs to comprehend with the least amount of overhead the information to complete the story, meeting all AC and completing all tasks+subtasks.
Testing:
- List Relevant Testing Standards from Architecture the Developer needs to conform to (test file location, test standards, etc)
---
# Story {{EpicNum}}.{{StoryNum}}: {{Short Title Copied from Epic File specific story}} workflow:
mode: interactive
elicitation: advanced-elicitation
## Status: {{ Draft | Approved | InProgress | Review | Done }} agent_config:
editable_sections:
- Status
- Story
- Acceptance Criteria
- Tasks / Subtasks
- Dev Notes
- Testing
- Change Log
## Story sections:
- id: status
title: Status
type: choice
choices: [Draft, Approved, InProgress, Review, Done]
instruction: Select the current status of the story
owner: scrum-master
editors: [scrum-master, dev-agent]
**As a** {{role}},\ - id: story
**I want** {{action}},\ title: Story
**so that** {{benefit}} type: template-text
template: |
**As a** {{role}},
**I want** {{action}},
**so that** {{benefit}}
instruction: Define the user story using the standard format with role, action, and benefit
elicit: true
owner: scrum-master
editors: [scrum-master]
## Acceptance Criteria - id: acceptance-criteria
title: Acceptance Criteria
type: numbered-list
instruction: Copy the acceptance criteria numbered list from the epic file
elicit: true
owner: scrum-master
editors: [scrum-master]
{{ Copy of Acceptance Criteria numbered list }} - id: tasks-subtasks
title: Tasks / Subtasks
## Tasks / Subtasks type: bullet-list
instruction: |
- [ ] Task 1 (AC: # if applicable) Break down the story into specific tasks and subtasks needed for implementation.
Reference applicable acceptance criteria numbers where relevant.
template: |
- [ ] Task 1 (AC: # if applicable)
- [ ] Subtask1.1... - [ ] Subtask1.1...
- [ ] Task 2 (AC: # if applicable) - [ ] Task 2 (AC: # if applicable)
- [ ] Subtask 2.1... - [ ] Subtask 2.1...
- [ ] Task 3 (AC: # if applicable) - [ ] Task 3 (AC: # if applicable)
- [ ] Subtask 3.1... - [ ] Subtask 3.1...
elicit: true
owner: scrum-master
editors: [scrum-master, dev-agent]
## Dev Notes - id: dev-notes
title: Dev Notes
instruction: |
Populate relevant information, only what was pulled from actual artifacts from docs folder, relevant to this story:
- Do not invent information
- If known add Relevant Source Tree info that relates to this story
- If there were important notes from previous story that are relevant to this one, include them here
- Put enough information in this section so that the dev agent should NEVER need to read the architecture documents, these notes along with the tasks and subtasks must give the Dev Agent the complete context it needs to comprehend with the least amount of overhead the information to complete the story, meeting all AC and completing all tasks+subtasks
elicit: true
owner: scrum-master
editors: [scrum-master]
sections:
- id: testing-standards
title: Testing
instruction: |
List Relevant Testing Standards from Architecture the Developer needs to conform to:
- Test file location
- Test standards
- Testing frameworks and patterns to use
- Any specific testing requirements for this story
elicit: true
owner: scrum-master
editors: [scrum-master]
### Testing - id: change-log
title: Change Log
type: table
columns: [Date, Version, Description, Author]
instruction: Track changes made to this story document
owner: scrum-master
editors: [scrum-master, dev-agent, qa-agent]
## Change Log - id: dev-agent-record
title: Dev Agent Record
instruction: This section is populated by the development agent during implementation
owner: dev-agent
editors: [dev-agent]
sections:
- id: agent-model
title: Agent Model Used
template: "{{agent_model_name_version}}"
instruction: Record the specific AI agent model and version used for development
owner: dev-agent
editors: [dev-agent]
| Date | Version | Description | Author | - id: debug-log-references
| :--- | :------ | :---------- | :----- | title: Debug Log References
instruction: Reference any debug logs or traces generated during development
owner: dev-agent
editors: [dev-agent]
## Dev Agent Record - id: completion-notes
title: Completion Notes List
instruction: Notes about the completion of tasks and any issues encountered
owner: dev-agent
editors: [dev-agent]
### Agent Model Used: {{Agent Model Name/Version}} - id: file-list
title: File List
instruction: List all files created, modified, or affected during story implementation
owner: dev-agent
editors: [dev-agent]
### Debug Log References - id: qa-results
title: QA Results
### Completion Notes List instruction: Results from QA Agent QA review of the completed story implementation
owner: qa-agent
### File List editors: [qa-agent]
==================== END: .bmad-core/templates/story-tmpl.yaml ====================
## QA Results
==================== END: .bmad-core/templates/story-tmpl.md ====================
==================== START: .bmad-core/checklists/story-draft-checklist.md ==================== ==================== START: .bmad-core/checklists/story-draft-checklist.md ====================
# Story Draft Checklist # Story Draft Checklist
@@ -597,32 +671,3 @@ Be pragmatic - perfect documentation doesn't exist, but it must be enough to pro
- NEEDS REVISION: The story requires updates (see issues) - NEEDS REVISION: The story requires updates (see issues)
- BLOCKED: External information required (specify what information) - BLOCKED: External information required (specify what information)
==================== END: .bmad-core/checklists/story-draft-checklist.md ==================== ==================== END: .bmad-core/checklists/story-draft-checklist.md ====================
==================== START: .bmad-core/utils/template-format.md ====================
# Template Format Conventions
Templates in the BMad method use standardized markup for AI processing. These conventions ensure consistent document generation.
## Template Markup Elements
- **{{placeholders}}**: Variables to be replaced with actual content
- **[[LLM: instructions]]**: Internal processing instructions for AI agents (never shown to users)
- **REPEAT** sections: Content blocks that may be repeated as needed
- **^^CONDITION^^** blocks: Conditional content included only if criteria are met
- **@{examples}**: Example content for guidance (never output to users)
## Processing Rules
- Replace all {{placeholders}} with project-specific content
- Execute all [[LLM: instructions]] internally without showing users
- Process conditional and repeat blocks as specified
- Use examples for guidance but never include them in final output
- Present only clean, formatted content to users
## Critical Guidelines
- **NEVER display template markup, LLM instructions, or examples to users**
- Template elements are for AI processing only
- Focus on faithful template execution and clean output
- All template-specific instructions are embedded within templates
==================== END: .bmad-core/utils/template-format.md ====================

901
dist/agents/ux-expert.txt vendored
View File

@@ -50,6 +50,7 @@ activation-instructions:
- Only read the files/tasks listed here when user selects them for execution to minimize context usage - Only read the files/tasks listed here when user selects them for execution to minimize context usage
- The customization field ALWAYS takes precedence over any conflicting instructions - The customization field ALWAYS takes precedence over any conflicting instructions
- When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
- Greet the user with your name and role, and inform of the *help command.
agent: agent:
name: Sally name: Sally
id: ux-expert id: ux-expert
@@ -71,9 +72,6 @@ persona:
- You have a keen eye for detail and a deep empathy for users. - You have a keen eye for detail and a deep empathy for users.
- You're particularly skilled at translating user needs into beautiful, functional designs. - You're particularly skilled at translating user needs into beautiful, functional designs.
- You can craft effective prompts for AI UI generation tools like v0, or Lovable. - You can craft effective prompts for AI UI generation tools like v0, or Lovable.
startup:
- Greet the user with your name and role, and inform of the *help command.
- Always start by understanding the user's context, goals, and constraints before proposing solutions.
commands: commands:
- help: Show numbered list of the following commands to allow selection - help: Show numbered list of the following commands to allow selection
- create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below) - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
@@ -83,16 +81,14 @@ commands:
- exit: Say goodbye as the UX Expert, and then abandon inhabiting this persona - exit: Say goodbye as the UX Expert, and then abandon inhabiting this persona
dependencies: dependencies:
tasks: tasks:
- generate-ai-frontend-prompt - generate-ai-frontend-prompt.md
- create-deep-research-prompt - create-deep-research-prompt.md
- create-doc - create-doc.md
- execute-checklist - execute-checklist.md
templates: templates:
- front-end-spec-tmpl - front-end-spec-tmpl.yaml
data: data:
- technical-preferences - technical-preferences.md
utils:
- template-format
``` ```
==================== END: .bmad-core/agents/ux-expert.md ==================== ==================== END: .bmad-core/agents/ux-expert.md ====================
@@ -455,97 +451,85 @@ Present these numbered options to the user:
==================== END: .bmad-core/tasks/create-deep-research-prompt.md ==================== ==================== END: .bmad-core/tasks/create-deep-research-prompt.md ====================
==================== START: .bmad-core/tasks/create-doc.md ==================== ==================== START: .bmad-core/tasks/create-doc.md ====================
# Create Document from Template Task # Create Document from Template (YAML Driven)
## Purpose ## CRITICAL: Mandatory Elicitation Format
Generate documents from templates by EXECUTING (not just reading) embedded instructions from the perspective of the selected agent persona. **When `elicit: true`, ALWAYS use this exact format:**
## CRITICAL RULES 1. Present section content
2. Provide detailed rationale (explain trade-offs, assumptions, decisions made)
3. Present numbered options 1-9:
- **Option 1:** Always "Proceed to next section"
- **Options 2-9:** Select 8 methods from data/elicitation-methods
- End with: "Select 1-9 or just type your question/feedback:"
1. **Templates are PROGRAMS** - Execute every [[LLM:]] instruction exactly as written **NEVER ask yes/no questions or use any other format.**
2. **NEVER show markup** - Hide all [[LLM:]], {{placeholders}}, @{examples}, and template syntax
3. **STOP and EXECUTE** - When you see "apply tasks#" or "execute tasks#", STOP and run that task immediately
4. **WAIT for user input** - At review points and after elicitation tasks
## Execution Flow ## Processing Flow
### 0. Check Workflow Plan (if configured) 1. **Parse YAML template** - Load template metadata and sections
2. **Set preferences** - Show current mode (Interactive), confirm output file
3. **Process each section:**
- Skip if condition unmet
- Check agent permissions (owner/editors) - note if section is restricted to specific agents
- Draft content using section instruction
- Present content + detailed rationale
- **IF elicit: true** → MANDATORY 1-9 options format
- Save to file if possible
4. **Continue until complete**
[[LLM: Check if plan tracking is enabled in core-config.yaml]] ## Detailed Rationale Requirements
- If `workflow.trackProgress: true`, check for active plan using .bmad-core/utils/plan-management.md When presenting section content, ALWAYS include rationale that explains:
- If plan exists and this document creation is part of the plan:
- Verify this is the expected next step
- If out of sequence and `enforceSequence: true`, warn user and halt without user override
- If out of sequence and `enforceSequence: false`, ask for confirmation
- Continue with normal execution after plan check
### 1. Identify Template - Trade-offs and choices made (what was chosen over alternatives and why)
- Key assumptions made during drafting
- Interesting or questionable decisions that need user attention
- Areas that might need validation
- Load from `.bmad-core/templates/*.md` or `.bmad-core/templates directory` ## Elicitation Results Flow
- Agent-specific templates are listed in agent's dependencies
- If agent has `templates: [prd-tmpl, architecture-tmpl]` for example, then offer to create "PRD" and "Architecture" documents
### 2. Ask Interaction Mode After user selects elicitation method (2-9):
> 1. **Incremental** - Section by section with reviews 1. Execute method from data/elicitation-methods
> 2. **YOLO Mode** - Complete draft then review (user can type `/yolo` anytime to switch) 2. Present results with insights
3. Offer options:
- **1. Apply changes and update section**
- **2. Return to elicitation menu**
- **3. Ask any questions or engage further with this elicitation**
### 3. Execute Template ## Agent Permissions
- Replace {{placeholders}} with real content When processing sections with agent permission fields:
- Execute [[LLM:]] instructions as you encounter them
- Process <<REPEAT>> loops and ^^CONDITIONS^^
- Use @{examples} for guidance but never output them
### 4. Key Execution Patterns - **owner**: Note which agent role initially creates/populates the section
- **editors**: List agent roles allowed to modify the section
- **readonly**: Mark sections that cannot be modified after creation
**When you see:** `[[LLM: Draft X and immediately execute .bmad-core/tasks/advanced-elicitation.md]]` **For sections with restricted access:**
- Draft the content - Include a note in the generated document indicating the responsible agent
- Present it to user - Example: "_(This section is owned by dev-agent and can only be modified by dev-agent)_"
- IMMEDIATELY execute the task
- Wait for completion before continuing
**When you see:** `[[LLM: After section completion, apply .bmad-core/tasks/Y.md]]` ## YOLO Mode
- Finish the section User can type `#yolo` to toggle to YOLO mode (process all sections at once).
- STOP and execute the task
- Wait for user input
### 5. Validation & Final Presentation ## CRITICAL REMINDERS
- Run any specified checklists **❌ NEVER:**
- Present clean, formatted content only
- No truncation or summarization
- Begin directly with content (no preamble)
- Include any handoff prompts from template
### 6. Update Workflow Plan (if applicable) - Ask yes/no questions for elicitation
- Use any format other than 1-9 numbered options
- Create new elicitation methods
[[LLM: After successful document creation]] **✅ ALWAYS:**
- If plan tracking is enabled and document was part of plan: - Use exact 1-9 format when elicit: true
- Call update-workflow-plan task to mark step complete - Select options 2-9 from data/elicitation-methods only
- Parameters: task: create-doc, step_id: {from plan}, status: complete - Provide detailed rationale explaining decisions
- Show next recommended step from plan - End with "Select 1-9 or just type your question/feedback:"
## Common Mistakes to Avoid
❌ Skipping elicitation tasks
❌ Showing template markup to users
❌ Continuing past STOP signals
❌ Combining multiple review points
✅ Execute ALL instructions in sequence
✅ Present only clean, formatted content
✅ Stop at every elicitation point
✅ Wait for user confirmation when instructed
## Remember
Templates contain precise instructions for a reason. Follow them exactly to ensure document quality and completeness.
==================== END: .bmad-core/tasks/create-doc.md ==================== ==================== END: .bmad-core/tasks/create-doc.md ====================
==================== START: .bmad-core/tasks/execute-checklist.md ==================== ==================== START: .bmad-core/tasks/execute-checklist.md ====================
@@ -644,93 +628,90 @@ The LLM will:
- Offer to provide detailed analysis of any section, especially those with warnings or failures - Offer to provide detailed analysis of any section, especially those with warnings or failures
==================== END: .bmad-core/tasks/execute-checklist.md ==================== ==================== END: .bmad-core/tasks/execute-checklist.md ====================
==================== START: .bmad-core/templates/front-end-spec-tmpl.md ==================== ==================== START: .bmad-core/templates/front-end-spec-tmpl.yaml ====================
# {{Project Name}} UI/UX Specification template:
id: frontend-spec-template-v2
name: UI/UX Specification
version: 2.0
output:
format: markdown
filename: docs/front-end-spec.md
title: "{{project_name}} UI/UX Specification"
[[LLM: The default path and filename unless specified is docs/front-end-spec.md]] workflow:
mode: interactive
elicitation: advanced-elicitation
[[LLM: Review provided documents including Project Brief, PRD, and any user research to gather context. Focus on understanding user needs, pain points, and desired outcomes before beginning the specification.]] sections:
- id: introduction
title: Introduction
instruction: |
Review provided documents including Project Brief, PRD, and any user research to gather context. Focus on understanding user needs, pain points, and desired outcomes before beginning the specification.
## Introduction Establish the document's purpose and scope. Keep the content below but ensure project name is properly substituted.
content: |
This document defines the user experience goals, information architecture, user flows, and visual design specifications for {{project_name}}'s user interface. It serves as the foundation for visual design and frontend development, ensuring a cohesive and user-centered experience.
sections:
- id: ux-goals-principles
title: Overall UX Goals & Principles
instruction: |
Work with the user to establish and document the following. If not already defined, facilitate a discussion to determine:
[[LLM: Establish the document's purpose and scope. Keep the content below but ensure project name is properly substituted.]] 1. Target User Personas - elicit details or confirm existing ones from PRD
2. Key Usability Goals - understand what success looks like for users
3. Core Design Principles - establish 3-5 guiding principles
elicit: true
sections:
- id: user-personas
title: Target User Personas
template: "{{persona_descriptions}}"
examples:
- "**Power User:** Technical professionals who need advanced features and efficiency"
- "**Casual User:** Occasional users who prioritize ease of use and clear guidance"
- "**Administrator:** System managers who need control and oversight capabilities"
- id: usability-goals
title: Usability Goals
template: "{{usability_goals}}"
examples:
- "Ease of learning: New users can complete core tasks within 5 minutes"
- "Efficiency of use: Power users can complete frequent tasks with minimal clicks"
- "Error prevention: Clear validation and confirmation for destructive actions"
- "Memorability: Infrequent users can return without relearning"
- id: design-principles
title: Design Principles
template: "{{design_principles}}"
type: numbered-list
examples:
- "**Clarity over cleverness** - Prioritize clear communication over aesthetic innovation"
- "**Progressive disclosure** - Show only what's needed, when it's needed"
- "**Consistent patterns** - Use familiar UI patterns throughout the application"
- "**Immediate feedback** - Every action should have a clear, immediate response"
- "**Accessible by default** - Design for all users from the start"
- id: changelog
title: Change Log
type: table
columns: [Date, Version, Description, Author]
instruction: Track document versions and changes
This document defines the user experience goals, information architecture, user flows, and visual design specifications for {{Project Name}}'s user interface. It serves as the foundation for visual design and frontend development, ensuring a cohesive and user-centered experience. - id: information-architecture
title: Information Architecture (IA)
instruction: |
Collaborate with the user to create a comprehensive information architecture:
### Overall UX Goals & Principles 1. Build a Site Map or Screen Inventory showing all major areas
2. Define the Navigation Structure (primary, secondary, breadcrumbs)
[[LLM: Work with the user to establish and document the following. If not already defined, facilitate a discussion to determine: 3. Use Mermaid diagrams for visual representation
4. Consider user mental models and expected groupings
1. Target User Personas - elicit details or confirm existing ones from PRD elicit: true
2. Key Usability Goals - understand what success looks like for users sections:
3. Core Design Principles - establish 3-5 guiding principles - id: sitemap
title: Site Map / Screen Inventory
After presenting this section, apply `tasks#advanced-elicitation` protocol]] type: mermaid
mermaid_type: graph
### Target User Personas template: "{{sitemap_diagram}}"
examples:
{{persona_descriptions}} - |
graph TD
@{example: personas}
- **Power User:** Technical professionals who need advanced features and efficiency
- **Casual User:** Occasional users who prioritize ease of use and clear guidance
- **Administrator:** System managers who need control and oversight capabilities
@{/example}
### Usability Goals
{{usability_goals}}
@{example: usability_goals}
- Ease of learning: New users can complete core tasks within 5 minutes
- Efficiency of use: Power users can complete frequent tasks with minimal clicks
- Error prevention: Clear validation and confirmation for destructive actions
- Memorability: Infrequent users can return without relearning
@{/example}
### Design Principles
{{design_principles}}
@{example: design_principles}
1. **Clarity over cleverness** - Prioritize clear communication over aesthetic innovation
2. **Progressive disclosure** - Show only what's needed, when it's needed
3. **Consistent patterns** - Use familiar UI patterns throughout the application
4. **Immediate feedback** - Every action should have a clear, immediate response
5. **Accessible by default** - Design for all users from the start
@{/example}
### Change Log
[[LLM: Track document versions and changes]]
| Date | Version | Description | Author |
| :--- | :------ | :---------- | :----- |
## Information Architecture (IA)
[[LLM: Collaborate with the user to create a comprehensive information architecture:
1. Build a Site Map or Screen Inventory showing all major areas
2. Define the Navigation Structure (primary, secondary, breadcrumbs)
3. Use Mermaid diagrams for visual representation
4. Consider user mental models and expected groupings
After presenting this section, apply `tasks#advanced-elicitation` protocol]]
### Site Map / Screen Inventory
```mermaid
{{sitemap_diagram}}
```
@{example: sitemap}
```mermaid
graph TD
A[Homepage] --> B[Dashboard] A[Homepage] --> B[Dashboard]
A --> C[Products] A --> C[Products]
A --> D[Account] A --> D[Account]
@@ -742,355 +723,265 @@ graph TD
D --> D1[Profile] D --> D1[Profile]
D --> D2[Settings] D --> D2[Settings]
D --> D3[Billing] D --> D3[Billing]
``` - id: navigation-structure
title: Navigation Structure
@{/example} template: |
**Primary Navigation:** {{primary_nav_description}}
### Navigation Structure
**Secondary Navigation:** {{secondary_nav_description}}
**Primary Navigation:** {{primary_nav_description}}
**Breadcrumb Strategy:** {{breadcrumb_strategy}}
**Secondary Navigation:** {{secondary_nav_description}}
- id: user-flows
**Breadcrumb Strategy:** {{breadcrumb_strategy}} title: User Flows
instruction: |
## User Flows For each critical user task identified in the PRD:
[[LLM: For each critical user task identified in the PRD: 1. Define the user's goal clearly
2. Map out all steps including decision points
1. Define the user's goal clearly 3. Consider edge cases and error states
2. Map out all steps including decision points 4. Use Mermaid flow diagrams for clarity
3. Consider edge cases and error states 5. Link to external tools (Figma/Miro) if detailed flows exist there
4. Use Mermaid flow diagrams for clarity
5. Link to external tools (Figma/Miro) if detailed flows exist there Create subsections for each major flow.
elicit: true
Create subsections for each major flow. After presenting all flows, apply `tasks#advanced-elicitation` protocol]] repeatable: true
sections:
<<REPEAT: user_flow>> - id: flow
title: "{{flow_name}}"
### {{flow_name}} template: |
**User Goal:** {{flow_goal}}
**User Goal:** {{flow_goal}}
**Entry Points:** {{entry_points}}
**Entry Points:** {{entry_points}}
**Success Criteria:** {{success_criteria}}
**Success Criteria:** {{success_criteria}} sections:
- id: flow-diagram
#### Flow Diagram title: Flow Diagram
type: mermaid
```mermaid mermaid_type: graph
{{flow_diagram}} template: "{{flow_diagram}}"
``` - id: edge-cases
title: "Edge Cases & Error Handling:"
**Edge Cases & Error Handling:** type: bullet-list
template: "- {{edge_case}}"
- {{edge_case_1}} - id: notes
- {{edge_case_2}} template: "**Notes:** {{flow_notes}}"
**Notes:** {{flow_notes}} - id: wireframes-mockups
<</REPEAT>> title: Wireframes & Mockups
instruction: |
@{example: user_flow} Clarify where detailed visual designs will be created (Figma, Sketch, etc.) and how to reference them. If low-fidelity wireframes are needed, offer to help conceptualize layouts for key screens.
elicit: true
### User Registration sections:
- id: design-files
**User Goal:** Create a new account to access the platform template: "**Primary Design Files:** {{design_tool_link}}"
- id: key-screen-layouts
**Entry Points:** Homepage CTA, Login page link, Marketing landing pages title: Key Screen Layouts
repeatable: true
**Success Criteria:** User successfully creates account and reaches dashboard sections:
- id: screen
#### Flow Diagram title: "{{screen_name}}"
template: |
```mermaid **Purpose:** {{screen_purpose}}
graph TD
Start[Landing Page] --> Click[Click Sign Up] **Key Elements:**
Click --> Form[Registration Form] - {{element_1}}
Form --> Fill[Fill Required Fields] - {{element_2}}
Fill --> Submit[Submit Form] - {{element_3}}
Submit --> Validate{Valid?}
Validate -->|No| Error[Show Errors] **Interaction Notes:** {{interaction_notes}}
Error --> Form
Validate -->|Yes| Verify[Email Verification] **Design File Reference:** {{specific_frame_link}}
Verify --> Complete[Account Created]
Complete --> Dashboard[Redirect to Dashboard] - id: component-library
``` title: Component Library / Design System
instruction: |
**Edge Cases & Error Handling:** Discuss whether to use an existing design system or create a new one. If creating new, identify foundational components and their key states. Note that detailed technical specs belong in front-end-architecture.
elicit: true
- Duplicate email: Show inline error with password recovery option sections:
- Weak password: Real-time feedback on password strength - id: design-system-approach
- Network error: Preserve form data and show retry option template: "**Design System Approach:** {{design_system_approach}}"
@{/example} - id: core-components
title: Core Components
## Wireframes & Mockups repeatable: true
sections:
[[LLM: Clarify where detailed visual designs will be created (Figma, Sketch, etc.) and how to reference them. If low-fidelity wireframes are needed, offer to help conceptualize layouts for key screens. - id: component
title: "{{component_name}}"
After presenting this section, apply `tasks#advanced-elicitation` protocol]] template: |
**Purpose:** {{component_purpose}}
**Primary Design Files:** {{design_tool_link}}
**Variants:** {{component_variants}}
### Key Screen Layouts
**States:** {{component_states}}
<<REPEAT: screen_layout>>
**Usage Guidelines:** {{usage_guidelines}}
#### {{screen_name}}
- id: branding-style
**Purpose:** {{screen_purpose}} title: Branding & Style Guide
instruction: Link to existing style guide or define key brand elements. Ensure consistency with company brand guidelines if they exist.
**Key Elements:** elicit: true
sections:
- {{element_1}} - id: visual-identity
- {{element_2}} title: Visual Identity
- {{element_3}} template: "**Brand Guidelines:** {{brand_guidelines_link}}"
- id: color-palette
**Interaction Notes:** {{interaction_notes}} title: Color Palette
type: table
**Design File Reference:** {{specific_frame_link}} columns: ["Color Type", "Hex Code", "Usage"]
<</REPEAT>> rows:
- ["Primary", "{{primary_color}}", "{{primary_usage}}"]
## Component Library / Design System - ["Secondary", "{{secondary_color}}", "{{secondary_usage}}"]
- ["Accent", "{{accent_color}}", "{{accent_usage}}"]
[[LLM: Discuss whether to use an existing design system or create a new one. If creating new, identify foundational components and their key states. Note that detailed technical specs belong in front-end-architecture. - ["Success", "{{success_color}}", "Positive feedback, confirmations"]
- ["Warning", "{{warning_color}}", "Cautions, important notices"]
After presenting this section, apply `tasks#advanced-elicitation` protocol]] - ["Error", "{{error_color}}", "Errors, destructive actions"]
- ["Neutral", "{{neutral_colors}}", "Text, borders, backgrounds"]
**Design System Approach:** {{design_system_approach}} - id: typography
title: Typography
### Core Components sections:
- id: font-families
<<REPEAT: component>> title: Font Families
template: |
#### {{component_name}} - **Primary:** {{primary_font}}
- **Secondary:** {{secondary_font}}
**Purpose:** {{component_purpose}} - **Monospace:** {{mono_font}}
- id: type-scale
**Variants:** {{component_variants}} title: Type Scale
type: table
**States:** {{component_states}} columns: ["Element", "Size", "Weight", "Line Height"]
rows:
**Usage Guidelines:** {{usage_guidelines}} - ["H1", "{{h1_size}}", "{{h1_weight}}", "{{h1_line}}"]
<</REPEAT>> - ["H2", "{{h2_size}}", "{{h2_weight}}", "{{h2_line}}"]
- ["H3", "{{h3_size}}", "{{h3_weight}}", "{{h3_line}}"]
@{example: component} - ["Body", "{{body_size}}", "{{body_weight}}", "{{body_line}}"]
- ["Small", "{{small_size}}", "{{small_weight}}", "{{small_line}}"]
#### Button - id: iconography
title: Iconography
**Purpose:** Primary interaction element for user actions template: |
**Icon Library:** {{icon_library}}
**Variants:** Primary, Secondary, Tertiary, Destructive
**Usage Guidelines:** {{icon_guidelines}}
**States:** Default, Hover, Active, Disabled, Loading - id: spacing-layout
title: Spacing & Layout
**Usage Guidelines:** template: |
**Grid System:** {{grid_system}}
- Use Primary for main CTAs (one per view)
- Secondary for supporting actions **Spacing Scale:** {{spacing_scale}}
- Destructive only for permanent deletions with confirmation
@{/example} - id: accessibility
title: Accessibility Requirements
## Branding & Style Guide instruction: Define specific accessibility requirements based on target compliance level and user needs. Be comprehensive but practical.
elicit: true
[[LLM: Link to existing style guide or define key brand elements. Ensure consistency with company brand guidelines if they exist. sections:
- id: compliance-target
After presenting this section, apply `tasks#advanced-elicitation` protocol]] title: Compliance Target
template: "**Standard:** {{compliance_standard}}"
### Visual Identity - id: key-requirements
title: Key Requirements
**Brand Guidelines:** {{brand_guidelines_link}} template: |
**Visual:**
### Color Palette - Color contrast ratios: {{contrast_requirements}}
- Focus indicators: {{focus_requirements}}
| Color Type | Hex Code | Usage | - Text sizing: {{text_requirements}}
| :------------ | :------------------ | :------------------------------- |
| **Primary** | {{primary_color}} | {{primary_usage}} | **Interaction:**
| **Secondary** | {{secondary_color}} | {{secondary_usage}} | - Keyboard navigation: {{keyboard_requirements}}
| **Accent** | {{accent_color}} | {{accent_usage}} | - Screen reader support: {{screen_reader_requirements}}
| **Success** | {{success_color}} | Positive feedback, confirmations | - Touch targets: {{touch_requirements}}
| **Warning** | {{warning_color}} | Cautions, important notices |
| **Error** | {{error_color}} | Errors, destructive actions | **Content:**
| **Neutral** | {{neutral_colors}} | Text, borders, backgrounds | - Alternative text: {{alt_text_requirements}}
- Heading structure: {{heading_requirements}}
### Typography - Form labels: {{form_requirements}}
- id: testing-strategy
**Font Families:** title: Testing Strategy
template: "{{accessibility_testing}}"
- **Primary:** {{primary_font}}
- **Secondary:** {{secondary_font}} - id: responsiveness
- **Monospace:** {{mono_font}} title: Responsiveness Strategy
instruction: Define breakpoints and adaptation strategies for different device sizes. Consider both technical constraints and user contexts.
**Type Scale:** elicit: true
| Element | Size | Weight | Line Height | sections:
|:--------|:-----|:-------|:------------| - id: breakpoints
| H1 | {{h1_size}} | {{h1_weight}} | {{h1_line}} | title: Breakpoints
| H2 | {{h2_size}} | {{h2_weight}} | {{h2_line}} | type: table
| H3 | {{h3_size}} | {{h3_weight}} | {{h3_line}} | columns: ["Breakpoint", "Min Width", "Max Width", "Target Devices"]
| Body | {{body_size}} | {{body_weight}} | {{body_line}} | rows:
| Small | {{small_size}} | {{small_weight}} | {{small_line}} | - ["Mobile", "{{mobile_min}}", "{{mobile_max}}", "{{mobile_devices}}"]
- ["Tablet", "{{tablet_min}}", "{{tablet_max}}", "{{tablet_devices}}"]
### Iconography - ["Desktop", "{{desktop_min}}", "{{desktop_max}}", "{{desktop_devices}}"]
- ["Wide", "{{wide_min}}", "-", "{{wide_devices}}"]
**Icon Library:** {{icon_library}} - id: adaptation-patterns
title: Adaptation Patterns
**Usage Guidelines:** {{icon_guidelines}} template: |
**Layout Changes:** {{layout_adaptations}}
### Spacing & Layout
**Navigation Changes:** {{nav_adaptations}}
**Grid System:** {{grid_system}}
**Content Priority:** {{content_adaptations}}
**Spacing Scale:** {{spacing_scale}}
**Interaction Changes:** {{interaction_adaptations}}
## Accessibility Requirements
- id: animation
[[LLM: Define specific accessibility requirements based on target compliance level and user needs. Be comprehensive but practical. title: Animation & Micro-interactions
instruction: Define motion design principles and key interactions. Keep performance and accessibility in mind.
After presenting this section, apply `tasks#advanced-elicitation` protocol]] elicit: true
sections:
### Compliance Target - id: motion-principles
title: Motion Principles
**Standard:** {{compliance_standard}} template: "{{motion_principles}}"
- id: key-animations
### Key Requirements title: Key Animations
repeatable: true
**Visual:** template: "- **{{animation_name}}:** {{animation_description}} (Duration: {{duration}}, Easing: {{easing}})"
- Color contrast ratios: {{contrast_requirements}} - id: performance
- Focus indicators: {{focus_requirements}} title: Performance Considerations
- Text sizing: {{text_requirements}} instruction: Define performance goals and strategies that impact UX design decisions.
sections:
**Interaction:** - id: performance-goals
title: Performance Goals
- Keyboard navigation: {{keyboard_requirements}} template: |
- Screen reader support: {{screen_reader_requirements}} - **Page Load:** {{load_time_goal}}
- Touch targets: {{touch_requirements}} - **Interaction Response:** {{interaction_goal}}
- **Animation FPS:** {{animation_goal}}
**Content:** - id: design-strategies
title: Design Strategies
- Alternative text: {{alt_text_requirements}} template: "{{performance_strategies}}"
- Heading structure: {{heading_requirements}}
- Form labels: {{form_requirements}} - id: next-steps
title: Next Steps
### Testing Strategy instruction: |
After completing the UI/UX specification:
{{accessibility_testing}}
1. Recommend review with stakeholders
## Responsiveness Strategy 2. Suggest creating/updating visual designs in design tool
3. Prepare for handoff to Design Architect for frontend architecture
[[LLM: Define breakpoints and adaptation strategies for different device sizes. Consider both technical constraints and user contexts. 4. Note any open questions or decisions needed
sections:
After presenting this section, apply `tasks#advanced-elicitation` protocol]] - id: immediate-actions
title: Immediate Actions
### Breakpoints type: numbered-list
template: "{{action}}"
| Breakpoint | Min Width | Max Width | Target Devices | - id: design-handoff-checklist
| :--------- | :-------------- | :-------------- | :------------------ | title: Design Handoff Checklist
| Mobile | {{mobile_min}} | {{mobile_max}} | {{mobile_devices}} | type: checklist
| Tablet | {{tablet_min}} | {{tablet_max}} | {{tablet_devices}} | items:
| Desktop | {{desktop_min}} | {{desktop_max}} | {{desktop_devices}} | - "All user flows documented"
| Wide | {{wide_min}} | - | {{wide_devices}} | - "Component inventory complete"
- "Accessibility requirements defined"
### Adaptation Patterns - "Responsive strategy clear"
- "Brand guidelines incorporated"
**Layout Changes:** {{layout_adaptations}} - "Performance goals established"
**Navigation Changes:** {{nav_adaptations}} - id: checklist-results
title: Checklist Results
**Content Priority:** {{content_adaptations}} instruction: If a UI/UX checklist exists, run it against this document and report results here.
==================== END: .bmad-core/templates/front-end-spec-tmpl.yaml ====================
**Interaction Changes:** {{interaction_adaptations}}
## Animation & Micro-interactions
[[LLM: Define motion design principles and key interactions. Keep performance and accessibility in mind.
After presenting this section, apply `tasks#advanced-elicitation` protocol]]
### Motion Principles
{{motion_principles}}
### Key Animations
<<REPEAT: animation>>
- **{{animation_name}}:** {{animation_description}} (Duration: {{duration}}, Easing: {{easing}})
<</REPEAT>>
## Performance Considerations
[[LLM: Define performance goals and strategies that impact UX design decisions.]]
### Performance Goals
- **Page Load:** {{load_time_goal}}
- **Interaction Response:** {{interaction_goal}}
- **Animation FPS:** {{animation_goal}}
### Design Strategies
{{performance_strategies}}
## Next Steps
[[LLM: After completing the UI/UX specification:
1. Recommend review with stakeholders
2. Suggest creating/updating visual designs in design tool
3. Prepare for handoff to Design Architect for frontend architecture
4. Note any open questions or decisions needed]]
### Immediate Actions
1. {{next_step_1}}
2. {{next_step_2}}
3. {{next_step_3}}
### Design Handoff Checklist
- [ ] All user flows documented
- [ ] Component inventory complete
- [ ] Accessibility requirements defined
- [ ] Responsive strategy clear
- [ ] Brand guidelines incorporated
- [ ] Performance goals established
## Checklist Results
[[LLM: If a UI/UX checklist exists, run it against this document and report results here.]]
==================== END: .bmad-core/templates/front-end-spec-tmpl.md ====================
==================== START: .bmad-core/data/technical-preferences.md ==================== ==================== START: .bmad-core/data/technical-preferences.md ====================
# User-Defined Preferred Patterns and Preferences # User-Defined Preferred Patterns and Preferences
None Listed None Listed
==================== END: .bmad-core/data/technical-preferences.md ==================== ==================== END: .bmad-core/data/technical-preferences.md ====================
==================== START: .bmad-core/utils/template-format.md ====================
# Template Format Conventions
Templates in the BMad method use standardized markup for AI processing. These conventions ensure consistent document generation.
## Template Markup Elements
- **{{placeholders}}**: Variables to be replaced with actual content
- **[[LLM: instructions]]**: Internal processing instructions for AI agents (never shown to users)
- **REPEAT** sections: Content blocks that may be repeated as needed
- **^^CONDITION^^** blocks: Conditional content included only if criteria are met
- **@{examples}**: Example content for guidance (never output to users)
## Processing Rules
- Replace all {{placeholders}} with project-specific content
- Execute all [[LLM: instructions]] internally without showing users
- Process conditional and repeat blocks as specified
- Use examples for guidance but never include them in final output
- Present only clean, formatted content to users
## Critical Guidelines
- **NEVER display template markup, LLM instructions, or examples to users**
- Template elements are for AI processing only
- Focus on faithful template execution and clean output
- All template-specific instructions are embedded within templates
==================== END: .bmad-core/utils/template-format.md ====================

2378
dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt vendored
View File

File diff suppressed because it is too large Load Diff

1134
dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt vendored
View File

File diff suppressed because it is too large Load Diff

377
dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt vendored
View File

@@ -50,6 +50,10 @@ activation-instructions:
- Only read the files/tasks listed here when user selects them for execution to minimize context usage - Only read the files/tasks listed here when user selects them for execution to minimize context usage
- The customization field ALWAYS takes precedence over any conflicting instructions - The customization field ALWAYS takes precedence over any conflicting instructions
- When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
- Greet the user with your name and role, and inform of the *help command
- Offer to help with game story preparation but wait for explicit user confirmation
- Only execute tasks when user explicitly requests them
- 'CRITICAL RULE: You are ONLY allowed to create/modify story files - NEVER implement! If asked to implement, tell user they MUST switch to Game Developer Agent'
agent: agent:
name: Jordan name: Jordan
id: game-sm id: game-sm
@@ -69,13 +73,6 @@ core_principles:
- Focus on One Story at a Time - Complete one before starting next - Focus on One Story at a Time - Complete one before starting next
- Game-Specific Context - Understand Phaser 3, game mechanics, and performance requirements - Game-Specific Context - Understand Phaser 3, game mechanics, and performance requirements
- Numbered Options Protocol - Always use numbered lists for selections - Numbered Options Protocol - Always use numbered lists for selections
startup:
- Greet the user with your name and role, and inform of the *help command
- CRITICAL: Do NOT automatically execute create-game-story tasks during startup
- CRITICAL: Do NOT create or modify any files during startup
- Offer to help with game story preparation but wait for explicit user confirmation
- Only execute tasks when user explicitly requests them
- 'CRITICAL RULE: You are ONLY allowed to create/modify story files - NEVER implement! If asked to implement, tell user they MUST switch to Game Developer Agent'
commands: commands:
- '*help" - Show numbered list of available commands for selection' - '*help" - Show numbered list of available commands for selection'
- '*chat-mode" - Conversational mode with advanced-elicitation for game dev advice' - '*chat-mode" - Conversational mode with advanced-elicitation for game dev advice'
@@ -84,12 +81,12 @@ commands:
- '*exit" - Say goodbye as the Game Scrum Master, and then abandon inhabiting this persona' - '*exit" - Say goodbye as the Game Scrum Master, and then abandon inhabiting this persona'
dependencies: dependencies:
tasks: tasks:
- create-game-story - create-game-story.md
- execute-checklist - execute-checklist.md
templates: templates:
- game-story-tmpl - game-story-tmpl.yaml
checklists: checklists:
- game-story-dod-checklist - game-story-dod-checklist.md
``` ```
==================== END: .bmad-2d-phaser-game-dev/agents/game-sm.md ==================== ==================== END: .bmad-2d-phaser-game-dev/agents/game-sm.md ====================
@@ -408,84 +405,101 @@ The LLM will:
- Offer to provide detailed analysis of any section, especially those with warnings or failures - Offer to provide detailed analysis of any section, especially those with warnings or failures
==================== END: .bmad-2d-phaser-game-dev/tasks/execute-checklist.md ==================== ==================== END: .bmad-2d-phaser-game-dev/tasks/execute-checklist.md ====================
==================== START: .bmad-2d-phaser-game-dev/templates/game-story-tmpl.md ==================== ==================== START: .bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml ====================
# Story: {{Story Title}} template:
id: game-story-template-v2
name: Game Development Story
version: 2.0
output:
format: markdown
filename: "stories/{{epic_name}}/{{story_id}}-{{story_name}}.md"
title: "Story: {{story_title}}"
**Epic:** {{Epic Name}} workflow:
**Story ID:** {{ID}} mode: interactive
**Priority:** {{High|Medium|Low}}
**Points:** {{Story Points}}
**Status:** Draft
[[LLM: This template creates detailed game development stories that are immediately actionable by game developers. Each story should focus on a single, implementable feature that contributes to the overall game functionality. sections:
- id: initial-setup
instruction: |
This template creates detailed game development stories that are immediately actionable by game developers. Each story should focus on a single, implementable feature that contributes to the overall game functionality.
Before starting, ensure you have access to: Before starting, ensure you have access to:
- Game Design Document (GDD) - Game Design Document (GDD)
- Game Architecture Document - Game Architecture Document
- Any existing stories in this epic - Any existing stories in this epic
The story should be specific enough that a developer can implement it without requiring additional design decisions.]] The story should be specific enough that a developer can implement it without requiring additional design decisions.
## Description - id: story-header
content: |
**Epic:** {{epic_name}}
**Story ID:** {{story_id}}
**Priority:** {{High|Medium|Low}}
**Points:** {{story_points}}
**Status:** Draft
[[LLM: Provide a clear, concise description of what this story implements. Focus on the specific game feature or system being built. Reference the GDD section that defines this feature.]] - id: description
title: Description
instruction: Provide a clear, concise description of what this story implements. Focus on the specific game feature or system being built. Reference the GDD section that defines this feature.
template: "{{clear_description_of_what_needs_to_be_implemented}}"
{{clear_description_of_what_needs_to_be_implemented}} - id: acceptance-criteria
title: Acceptance Criteria
instruction: Define specific, testable conditions that must be met for the story to be considered complete. Each criterion should be verifiable and directly related to gameplay functionality.
sections:
- id: functional-requirements
title: Functional Requirements
type: checklist
items:
- "{{specific_functional_requirement}}"
- id: technical-requirements
title: Technical Requirements
type: checklist
items:
- "Code follows TypeScript strict mode standards"
- "Maintains 60 FPS on target devices"
- "No memory leaks or performance degradation"
- "{{specific_technical_requirement}}"
- id: game-design-requirements
title: Game Design Requirements
type: checklist
items:
- "{{gameplay_requirement_from_gdd}}"
- "{{balance_requirement_if_applicable}}"
- "{{player_experience_requirement}}"
## Acceptance Criteria - id: technical-specifications
title: Technical Specifications
instruction: Provide specific technical details that guide implementation. Include class names, file locations, and integration points based on the game architecture.
sections:
- id: files-to-modify
title: Files to Create/Modify
template: |
**New Files:**
[[LLM: Define specific, testable conditions that must be met for the story to be considered complete. Each criterion should be verifiable and directly related to gameplay functionality.]] - `{{file_path_1}}` - {{purpose}}
- `{{file_path_2}}` - {{purpose}}
### Functional Requirements **Modified Files:**
- [ ] {{specific_functional_requirement_1}} - `{{existing_file_1}}` - {{changes_needed}}
- [ ] {{specific_functional_requirement_2}} - `{{existing_file_2}}` - {{changes_needed}}
- [ ] {{specific_functional_requirement_3}} - id: class-interface-definitions
title: Class/Interface Definitions
### Technical Requirements instruction: Define specific TypeScript interfaces and class structures needed
type: code
- [ ] Code follows TypeScript strict mode standards language: typescript
- [ ] Maintains 60 FPS on target devices template: |
- [ ] No memory leaks or performance degradation // {{interface_name}}
- [ ] {{specific_technical_requirement}} interface {{interface_name}} {
### Game Design Requirements
- [ ] {{gameplay_requirement_from_gdd}}
- [ ] {{balance_requirement_if_applicable}}
- [ ] {{player_experience_requirement}}
## Technical Specifications
[[LLM: Provide specific technical details that guide implementation. Include class names, file locations, and integration points based on the game architecture.]]
### Files to Create/Modify
**New Files:**
- `{{file_path_1}}` - {{purpose}}
- `{{file_path_2}}` - {{purpose}}
**Modified Files:**
- `{{existing_file_1}}` - {{changes_needed}}
- `{{existing_file_2}}` - {{changes_needed}}
### Class/Interface Definitions
[[LLM: Define specific TypeScript interfaces and class structures needed]]
```typescript
// {{interface_name}}
interface {{InterfaceName}} {
{{property_1}}: {{type}}; {{property_1}}: {{type}};
{{property_2}}: {{type}}; {{property_2}}: {{type}};
{{method_1}}({{params}}): {{return_type}}; {{method_1}}({{params}}): {{return_type}};
} }
// {{class_name}} // {{class_name}}
class {{ClassName}} extends {{PhaseClass}} { class {{class_name}} extends {{phaser_class}} {
private {{property}}: {{type}}; private {{property}}: {{type}};
constructor({{params}}) { constructor({{params}}) {
@@ -495,156 +509,157 @@ class {{ClassName}} extends {{PhaseClass}} {
public {{method}}({{params}}): {{return_type}} { public {{method}}({{params}}): {{return_type}} {
// Method requirements // Method requirements
} }
} }
``` - id: integration-points
title: Integration Points
instruction: Specify how this feature integrates with existing systems
template: |
**Scene Integration:**
### Integration Points - {{scene_name}}: {{integration_details}}
[[LLM: Specify how this feature integrates with existing systems]] **System Dependencies:**
**Scene Integration:** - {{system_name}}: {{dependency_description}}
- {{scene_name}}: {{integration_details}} **Event Communication:**
**System Dependencies:** - Emits: `{{event_name}}` when {{condition}}
- Listens: `{{event_name}}` to {{response}}
- {{system_name}}: {{dependency_description}} - id: implementation-tasks
title: Implementation Tasks
instruction: Break down the implementation into specific, ordered tasks. Each task should be completable in 1-4 hours.
sections:
- id: dev-agent-record
title: Dev Agent Record
template: |
**Tasks:**
**Event Communication:** - [ ] {{task_1_description}}
- [ ] {{task_2_description}}
- [ ] {{task_3_description}}
- [ ] {{task_4_description}}
- [ ] Write unit tests for {{component}}
- [ ] Integration testing with {{related_system}}
- [ ] Performance testing and optimization
- Emits: `{{event_name}}` when {{condition}} **Debug Log:**
- Listens: `{{event_name}}` to {{response}} | Task | File | Change | Reverted? |
|------|------|--------|-----------|
| | | | |
## Implementation Tasks **Completion Notes:**
[[LLM: Break down the implementation into specific, ordered tasks. Each task should be completable in 1-4 hours.]] <!-- Only note deviations from requirements, keep under 50 words -->
### Dev Agent Record **Change Log:**
**Tasks:** <!-- Only requirement changes during implementation -->
- [ ] {{task_1_description}} - id: game-design-context
- [ ] {{task_2_description}} title: Game Design Context
- [ ] {{task_3_description}} instruction: Reference the specific sections of the GDD that this story implements
- [ ] {{task_4_description}} template: |
- [ ] Write unit tests for {{component}} **GDD Reference:** {{section_name}} ({{page_or_section_number}})
- [ ] Integration testing with {{related_system}}
- [ ] Performance testing and optimization
**Debug Log:** **Game Mechanic:** {{mechanic_name}}
| Task | File | Change | Reverted? |
|------|------|--------|-----------|
| | | | |
**Completion Notes:** **Player Experience Goal:** {{experience_description}}
<!-- Only note deviations from requirements, keep under 50 words --> **Balance Parameters:**
**Change Log:** - {{parameter_1}}: {{value_or_range}}
- {{parameter_2}}: {{value_or_range}}
<!-- Only requirement changes during implementation --> - id: testing-requirements
title: Testing Requirements
instruction: Define specific testing criteria for this game feature
sections:
- id: unit-tests
title: Unit Tests
template: |
**Test Files:**
## Game Design Context - `tests/{{component_name}}.test.ts`
[[LLM: Reference the specific sections of the GDD that this story implements]] **Test Scenarios:**
**GDD Reference:** {{section_name}} ({{page_or_section_number}}) - {{test_scenario_1}}
- {{test_scenario_2}}
- {{edge_case_test}}
- id: game-testing
title: Game Testing
template: |
**Manual Test Cases:**
**Game Mechanic:** {{mechanic_name}} 1. {{test_case_1_description}}
**Player Experience Goal:** {{experience_description}}
**Balance Parameters:**
- {{parameter_1}}: {{value_or_range}}
- {{parameter_2}}: {{value_or_range}}
## Testing Requirements
[[LLM: Define specific testing criteria for this game feature]]
### Unit Tests
**Test Files:**
- `tests/{{component_name}}.test.ts`
**Test Scenarios:**
- {{test_scenario_1}}
- {{test_scenario_2}}
- {{edge_case_test}}
### Game Testing
**Manual Test Cases:**
1. {{test_case_1_description}}
- Expected: {{expected_behavior}} - Expected: {{expected_behavior}}
- Performance: {{performance_expectation}} - Performance: {{performance_expectation}}
2. {{test_case_2_description}} 2. {{test_case_2_description}}
- Expected: {{expected_behavior}} - Expected: {{expected_behavior}}
- Edge Case: {{edge_case_handling}} - Edge Case: {{edge_case_handling}}
- id: performance-tests
title: Performance Tests
template: |
**Metrics to Verify:**
### Performance Tests - Frame rate maintains {{fps_target}} FPS
- Memory usage stays under {{memory_limit}}MB
- {{feature_specific_performance_metric}}
**Metrics to Verify:** - id: dependencies
title: Dependencies
instruction: List any dependencies that must be completed before this story can be implemented
template: |
**Story Dependencies:**
- Frame rate maintains {{fps_target}} FPS - {{story_id}}: {{dependency_description}}
- Memory usage stays under {{memory_limit}}MB
- {{feature_specific_performance_metric}}
## Dependencies **Technical Dependencies:**
[[LLM: List any dependencies that must be completed before this story can be implemented]] - {{system_or_file}}: {{requirement}}
**Story Dependencies:** **Asset Dependencies:**
- {{story_id}}: {{dependency_description}} - {{asset_type}}: {{asset_description}}
- Location: `{{asset_path}}`
**Technical Dependencies:** - id: definition-of-done
title: Definition of Done
instruction: Checklist that must be completed before the story is considered finished
type: checklist
items:
- "All acceptance criteria met"
- "Code reviewed and approved"
- "Unit tests written and passing"
- "Integration tests passing"
- "Performance targets met"
- "No linting errors"
- "Documentation updated"
- "{{game_specific_dod_item}}"
- {{system_or_file}}: {{requirement}} - id: notes
title: Notes
instruction: Any additional context, design decisions, or implementation notes
template: |
**Implementation Notes:**
**Asset Dependencies:** - {{note_1}}
- {{note_2}}
- {{asset_type}}: {{asset_description}} **Design Decisions:**
- Location: `{{asset_path}}`
## Definition of Done - {{decision_1}}: {{rationale}}
- {{decision_2}}: {{rationale}}
[[LLM: Checklist that must be completed before the story is considered finished]] **Future Considerations:**
- [ ] All acceptance criteria met - {{future_enhancement_1}}
- [ ] Code reviewed and approved - {{future_optimization_1}}
- [ ] Unit tests written and passing ==================== END: .bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml ====================
- [ ] Integration tests passing
- [ ] Performance targets met
- [ ] No linting errors
- [ ] Documentation updated
- [ ] {{game_specific_dod_item}}
## Notes
[[LLM: Any additional context, design decisions, or implementation notes]]
**Implementation Notes:**
- {{note_1}}
- {{note_2}}
**Design Decisions:**
- {{decision_1}}: {{rationale}}
- {{decision_2}}: {{rationale}}
**Future Considerations:**
- {{future_enhancement_1}}
- {{future_optimization_1}}
==================== END: .bmad-2d-phaser-game-dev/templates/game-story-tmpl.md ====================
==================== START: .bmad-2d-phaser-game-dev/checklists/game-story-dod-checklist.md ==================== ==================== START: .bmad-2d-phaser-game-dev/checklists/game-story-dod-checklist.md ====================
# Game Development Story Definition of Done Checklist # Game Development Story Definition of Done Checklist

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

File diff suppressed because it is too large Load Diff

371
dist/expansion-packs/bmad-creator-tools/agents/bmad-the-creator.txt vendored
View File

@@ -50,6 +50,9 @@ activation-instructions:
- Only read the files/tasks listed here when user selects them for execution to minimize context usage - Only read the files/tasks listed here when user selects them for execution to minimize context usage
- The customization field ALWAYS takes precedence over any conflicting instructions - The customization field ALWAYS takes precedence over any conflicting instructions
- When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
- Greet the user with your name and role, and inform of the *help command
- Offer to help with BMad framework extensions but wait for explicit user confirmation
- Only execute tasks when user explicitly requests them
agent: agent:
name: The Creator name: The Creator
id: bmad-the-creator id: bmad-the-creator
@@ -69,12 +72,6 @@ core_principles:
- Convention Over Configuration - Follow BMad naming and structure patterns - Convention Over Configuration - Follow BMad naming and structure patterns
- Extensibility First - Design for future expansion and customization - Extensibility First - Design for future expansion and customization
- Numbered Options Protocol - Always use numbered lists for user selections - Numbered Options Protocol - Always use numbered lists for user selections
startup:
- Greet the user with your name and role, and inform of the *help command
- CRITICAL: Do NOT automatically create documents or execute tasks during startup
- CRITICAL: Do NOT create or modify any files during startup
- Offer to help with BMad framework extensions but wait for explicit user confirmation
- Only execute tasks when user explicitly requests them
commands: commands:
- '*help" - Show numbered list of available commands for selection' - '*help" - Show numbered list of available commands for selection'
- '*chat-mode" - Conversational mode with advanced-elicitation for framework design advice' - '*chat-mode" - Conversational mode with advanced-elicitation for framework design advice'
@@ -85,13 +82,13 @@ commands:
- '*exit" - Say goodbye as The Creator, and then abandon inhabiting this persona' - '*exit" - Say goodbye as The Creator, and then abandon inhabiting this persona'
dependencies: dependencies:
tasks: tasks:
- create-agent - create-agent.md
- generate-expansion-pack - generate-expansion-pack.md
- advanced-elicitation - advanced-elicitation.md
- create-deep-research-prompt - create-deep-research-prompt.md
templates: templates:
- agent-tmpl - agent-tmpl.yaml
- expansion-pack-plan-tmpl - expansion-pack-plan-tmpl.yaml
``` ```
==================== END: .bmad-creator-tools/agents/bmad-the-creator.md ==================== ==================== END: .bmad-creator-tools/agents/bmad-the-creator.md ====================
@@ -1745,110 +1742,122 @@ Present these numbered options to the user:
- Plan for iterative refinement based on initial findings - Plan for iterative refinement based on initial findings
==================== END: .bmad-creator-tools/tasks/create-deep-research-prompt.md ==================== ==================== END: .bmad-creator-tools/tasks/create-deep-research-prompt.md ====================
==================== START: .bmad-creator-tools/templates/agent-tmpl.md ==================== ==================== START: .bmad-creator-tools/templates/agent-tmpl.yaml ====================
# [AGENT_ID] template:
id: agent-template-v2
name: Agent Definition
version: 2.0
output:
format: markdown
filename: "agents/{{agent_id}}.md"
title: "{{agent_id}}"
[[LLM: This is an agent definition template. When creating a new agent: workflow:
mode: interactive
1. ALL dependencies (tasks, templates, checklists, data) MUST exist or be created sections:
2. For output generation, use the create-doc pattern with appropriate templates - id: header
3. Templates should include LLM instructions for guiding users through content creation title: "{{agent_id}}"
4. Character personas should be consistent and domain-appropriate instruction: |
5. Follow the numbered options protocol for all user interactions]] This is an agent definition template. When creating a new agent:
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode: 1. ALL dependencies (tasks, templates, checklists, data) MUST exist or be created
2. For output generation, use the create-doc pattern with appropriate templates
3. Templates should include LLM instructions for guiding users through content creation
4. Character personas should be consistent and domain-appropriate
5. Follow the numbered options protocol for all user interactions
```yaml - id: agent-definition
activation-instructions: content: |
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
sections:
- id: yaml-definition
type: code
language: yaml
template: |
activation-instructions:
- Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER! - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
- Only read the files/tasks listed here when user selects them for execution to minimize context usage - Only read the files/tasks listed here when user selects them for execution to minimize context usage
- The customization field ALWAYS takes precedence over any conflicting instructions - The customization field ALWAYS takes precedence over any conflicting instructions
- When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
- Command - Command
agent: agent:
name: [AGENT_NAME] name: {{agent_name}}
id: [AGENT_ID] id: {{agent_id}}
title: [AGENT_TITLE] title: {{agent_title}}
customization: [OPTIONAL_CUSTOMIZATION] customization: {{optional_customization}}
persona: persona:
role: [AGENT_ROLE_DESCRIPTION] role: {{agent_role_description}}
style: [COMMUNICATION_STYLE] style: {{communication_style}}
identity: [AGENT_IDENTITY_DESCRIPTION] identity: {{agent_identity_description}}
focus: [PRIMARY_FOCUS_AREAS] focus: {{primary_focus_areas}}
core_principles: core_principles:
- [PRINCIPLE_1] - {{principle_1}}
- [PRINCIPLE_2] - {{principle_2}}
- [PRINCIPLE_3] - {{principle_3}}
# Add more principles as needed # Add more principles as needed
startup: startup:
- Greet the user with your name and role, and inform of the *help command. - Greet the user with your name and role, and inform of the *help command.
- [STARTUP_INSTRUCTION] - {{startup_instruction_1}}
- [STARTUP_INSTRUCTION]... - {{startup_instruction_2}}
commands: commands:
- "*help" - Show: numbered list of the following commands to allow selection - "*help" - Show: numbered list of the following commands to allow selection
- "*chat-mode" - (Default) [DEFAULT_MODE_DESCRIPTION] - "*chat-mode" - (Default) {{default_mode_description}}
- "*create-doc {template}" - Create doc (no template = show available templates) - "*create-doc {template}" - Create doc (no template = show available templates)
[[LLM: For output generation tasks, always use create-doc with templates rather than custom tasks. {{custom_commands}}
Example: Instead of a "create-blueprint" task, use "*create-doc blueprint-tmpl" - "*exit" - Say goodbye as the {{agent_title}}, and then abandon inhabiting this persona
The template should contain LLM instructions for guiding users through the creation process]]
- [tasks] specific to the agent that are not covered by a template
[[LLM: Only create custom tasks for actions that don't produce documents, like analysis, validation, or process execution]]
- "*exit" - Say goodbye as the [AGENT_TITLE], and then abandon inhabiting this persona
dependencies: dependencies:
[[LLM: CRITICAL - All dependencies listed here MUST exist in the expansion pack or be created: tasks:
- create-doc # Required if agent creates documents from templates
{{task_list}}
templates:
{{template_list}}
checklists:
{{checklist_list}}
data:
{{data_list}}
utils:
- template-format # Required if using templates
{{util_list}}
instruction: |
For output generation tasks, always use create-doc with templates rather than custom tasks.
Example: Instead of a "create-blueprint" task, use "*create-doc blueprint-tmpl"
The template should contain LLM instructions for guiding users through the creation process
Only create custom tasks for actions that don't produce documents, like analysis, validation, or process execution
CRITICAL - All dependencies listed here MUST exist in the expansion pack or be created:
- Tasks: Must exist in tasks/ directory (include create-doc if using templates) - Tasks: Must exist in tasks/ directory (include create-doc if using templates)
- Templates: Must exist in templates/ directory with proper LLM instructions - Templates: Must exist in templates/ directory with proper LLM instructions
- Checklists: Must exist in checklists/ directory for quality validation - Checklists: Must exist in checklists/ directory for quality validation
- Data: Must exist in data/ directory or be documented as user-required - Data: Must exist in data/ directory or be documented as user-required
- Utils: Must exist in utils/ directory (include template-format if using templates)]] - Utils: Must exist in utils/ directory (include template-format if using templates)
tasks: - id: example
- create-doc # Required if agent creates documents from templates title: Example: Construction Contractor Agent
- [TASK_1] # Custom task for non-document operations type: code
- [TASK_2] # Another custom task language: yaml
[[LLM: Example tasks: validate-design, analyze-requirements, execute-tests]] template: |
activation-instructions:
templates:
- [TEMPLATE_1] # Template with LLM instructions for guided creation
- [TEMPLATE_2] # Another template for different document type
[[LLM: Example: blueprint-tmpl, contract-tmpl, report-tmpl
Each template should include [[LLM: guidance]] and other conventions from `template-format.md` sections for user interaction]]
checklists:
- [CHECKLIST_1] # Quality validation for template outputs
[[LLM: Example: blueprint-checklist, contract-checklist
Checklists validate documents created from templates]]
data:
- [DATA_1] # Domain knowledge files
[[LLM: Example: building-codes.md, legal-terminology.md
Can be embedded in pack or required from user]]
utils:
- template-format # Required if using templates
- [UTIL_1] # Other utilities as needed
[[LLM: Include workflow-management if agent participates in workflows]]
```
@{example: Construction Contractor Agent}
```yaml
activation-instructions:
- Follow all instructions in this file - Follow all instructions in this file
- Stay in character as Marcus Thompson, Construction Manager - Stay in character as Marcus Thompson, Construction Manager
- Use numbered options for all interactions - Use numbered options for all interactions
agent: agent:
name: Marcus Thompson name: Marcus Thompson
id: construction-contractor id: construction-contractor
title: Construction Project Manager title: Construction Project Manager
customization: null customization: null
persona: persona:
role: Licensed general contractor with 20 years experience role: Licensed general contractor with 20 years experience
style: Professional, detail-oriented, safety-conscious style: Professional, detail-oriented, safety-conscious
identity: Former site foreman who worked up to project management identity: Former site foreman who worked up to project management
@@ -1857,12 +1866,12 @@ persona:
- Safety first - all designs must prioritize worker and occupant safety - Safety first - all designs must prioritize worker and occupant safety
- Code compliance - ensure all work meets local building codes - Code compliance - ensure all work meets local building codes
- Quality craftsmanship - no shortcuts on structural integrity - Quality craftsmanship - no shortcuts on structural integrity
startup: startup:
- Greet as Marcus Thompson, Construction Project Manager - Greet as Marcus Thompson, Construction Project Manager
- Briefly mention your experience and readiness to help - Briefly mention your experience and readiness to help
- Ask what type of construction project they're planning - Ask what type of construction project they're planning
- DO NOT auto-execute any commands - DO NOT auto-execute any commands
commands: commands:
- '*help" - Show numbered list of available commands' - '*help" - Show numbered list of available commands'
- '*chat-mode" - Discuss construction projects and provide expertise' - '*chat-mode" - Discuss construction projects and provide expertise'
- '*create-doc blueprint-tmpl" - Create architectural blueprints' - '*create-doc blueprint-tmpl" - Create architectural blueprints'
@@ -1871,7 +1880,7 @@ commands:
- '*validate-plans" - Review plans for code compliance' - '*validate-plans" - Review plans for code compliance'
- '*safety-assessment" - Evaluate safety considerations' - '*safety-assessment" - Evaluate safety considerations'
- '*exit" - Say goodbye as Marcus and exit' - '*exit" - Say goodbye as Marcus and exit'
dependencies: dependencies:
tasks: tasks:
- create-doc - create-doc
- validate-plans - validate-plans
@@ -1888,99 +1897,127 @@ dependencies:
- materials-guide.md - materials-guide.md
utils: utils:
- template-format - template-format
``` ==================== END: .bmad-creator-tools/templates/agent-tmpl.yaml ====================
==================== END: .bmad-creator-tools/templates/agent-tmpl.md ====================
==================== START: .bmad-creator-tools/templates/expansion-pack-plan-tmpl.md ==================== ==================== START: .bmad-creator-tools/templates/expansion-pack-plan-tmpl.yaml ====================
# {Pack Name} Expansion Pack Plan template:
id: expansion-pack-plan-template-v2
name: Expansion Pack Plan
version: 2.0
output:
format: markdown
filename: "{{pack_name}}-expansion-pack-plan.md"
title: "{{pack_display_name}} Expansion Pack Plan"
## Overview workflow:
mode: interactive
- **Pack Name**: {pack-identifier} sections:
- **Display Name**: {Full Expansion Pack Name} - id: overview
- **Description**: {Brief description of what this pack does} title: Overview
- **Target Domain**: {Industry/domain this serves} template: |
- **Author**: {Your name/organization} - **Pack Name**: {{pack_identifier}}
- **Display Name**: {{full_expansion_pack_name}}
- **Description**: {{brief_description}}
- **Target Domain**: {{industry_domain}}
- **Author**: {{author_name_organization}}
## Problem Statement - id: problem-statement
title: Problem Statement
instruction: What specific challenges does this expansion pack solve?
template: "{{problem_description}}"
{What specific challenges does this expansion pack solve?} - id: target-users
title: Target Users
instruction: Who will benefit from this expansion pack?
template: "{{target_user_description}}"
## Target Users - id: components
title: Components to Create
sections:
- id: agents
title: Agents
type: checklist
instruction: List all agents to be created with their roles and dependencies
items:
- id: orchestrator
template: |
`{{pack_name}}-orchestrator` - **REQUIRED**: Master orchestrator for {{domain}} workflows
- Key commands: {{command_list}}
- Manages: {{orchestration_scope}}
- id: agent-list
repeatable: true
template: |
`{{agent_name}}` - {{role_description}}
- Tasks used: {{task_list}}
- Templates used: {{template_list}}
- Data required: {{data_requirements}}
{Who will benefit from this expansion pack?} - id: tasks
title: Tasks
type: checklist
instruction: List all tasks to be created
repeatable: true
template: "`{{task_name}}.md` - {{purpose}} (used by: {{using_agents}})"
## Components to Create - id: templates
title: Templates
type: checklist
instruction: List all templates to be created
repeatable: true
template: "`{{template_name}}-tmpl.md` - {{document_type}} (used by: {{using_components}})"
### Agents - id: checklists
title: Checklists
type: checklist
instruction: List all checklists to be created
repeatable: true
template: "`{{checklist_name}}-checklist.md` - {{validation_purpose}}"
- [ ] `{pack-name}-orchestrator` - **REQUIRED**: Master orchestrator for {domain} workflows - id: data-files
- Key commands: {list main commands} title: Data Files Required from User
- Manages: {what it orchestrates} instruction: |
- [ ] `{agent-1-name}` - {Role description} Users must add these files to `bmad-core/data/`:
- Tasks used: {task-1}, {task-2} type: checklist
- Templates used: {template-1} repeatable: true
- Data required: {data-file-1} template: |
- [ ] `{agent-2-name}` - {Role description} `{{data_filename}}.{{extension}}` - {{content_description}}
- Tasks used: {task-3} - Format: {{file_format}}
- Templates used: {template-2} - Purpose: {{why_needed}}
- Data required: {data-file-2} - Example: {{brief_example}}
### Tasks - id: workflow-overview
title: Workflow Overview
type: numbered-list
instruction: Describe the typical workflow steps
template: "{{workflow_step}}"
- [ ] `{task-1}.md` - {Purpose} (used by: {agent}) - id: integration-points
- [ ] `{task-2}.md` - {Purpose} (used by: {agent}) title: Integration Points
- [ ] `{task-3}.md` - {Purpose} (used by: {agent}) template: |
- Depends on core agents: {{core_agent_dependencies}}
- Extends teams: {{team_updates}}
### Templates - id: success-criteria
title: Success Criteria
type: checklist
items:
- "All components created and cross-referenced"
- "No orphaned task/template references"
- "Data requirements clearly documented"
- "Orchestrator provides clear workflow"
- "README includes setup instructions"
- [ ] `{template-1}-tmpl.md` - {Document type} (used by: {agent/task}) - id: user-approval
- [ ] `{template-2}-tmpl.md` - {Document type} (used by: {agent/task}) title: User Approval
type: checklist
items:
- "Plan reviewed by user"
- "Approval to proceed with implementation"
### Checklists - id: next-steps
content: |
---
- [ ] `{checklist-1}-checklist.md` - {What it validates} **Next Steps**: Once approved, proceed with Phase 3 implementation starting with the orchestrator agent.
- [ ] `{checklist-2}-checklist.md` - {What it validates} ==================== END: .bmad-creator-tools/templates/expansion-pack-plan-tmpl.yaml ====================
### Data Files Required from User
Users must add these files to `bmad-core/data/`:
- [ ] `{data-file-1}.{ext}` - {Description of required content}
- Format: {file format}
- Purpose: {why needed}
- Example: {brief example}
- [ ] `{data-file-2}.{ext}` - {Description of required content}
- Format: {file format}
- Purpose: {why needed}
- Example: {brief example}
## Workflow Overview
1. {Step 1 - typically starts with orchestrator}
2. {Step 2}
3. {Step 3}
4. {Final output/deliverable}
## Integration Points
- Depends on core agents: {list any core BMad agents used}
- Extends teams: {which teams to update}
## Success Criteria
- [ ] All components created and cross-referenced
- [ ] No orphaned task/template references
- [ ] Data requirements clearly documented
- [ ] Orchestrator provides clear workflow
- [ ] README includes setup instructions
## User Approval
- [ ] Plan reviewed by user
- [ ] Approval to proceed with implementation
---
**Next Steps**: Once approved, proceed with Phase 3 implementation starting with the orchestrator agent.
==================== END: .bmad-creator-tools/templates/expansion-pack-plan-tmpl.md ====================

2042
dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt vendored
View File

File diff suppressed because it is too large Load Diff

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

File diff suppressed because it is too large Load Diff

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

File diff suppressed because it is too large Load Diff

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

@@ -58,6 +58,15 @@ workflows: null
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode: CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
```yaml ```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
- Load resources only when needed - never pre-load
agent: agent:
name: BMad Orchestrator name: BMad Orchestrator
id: bmad-orchestrator id: bmad-orchestrator
@@ -79,17 +88,6 @@ persona:
- Always use numbered lists for choices - Always use numbered lists for choices
- Process commands starting with * immediately - Process commands starting with * immediately
- Always remind users that commands require * prefix - Always remind users that commands require * prefix
startup:
- Announce: Introduce yourself as the BMad Orchestrator, explain you can coordinate agents and workflows
- IMPORTANT: Tell users that all commands start with * (e.g., *help, *agent, *workflow)
- 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
- Load resources only when needed - never pre-load
commands: commands:
help: Show this guide with available agents and workflows help: Show this guide with available agents and workflows
chat-mode: Start conversational mode for detailed assistance chat-mode: Start conversational mode for detailed assistance
@@ -177,17 +175,18 @@ workflow-guidance:
- When *workflow-guidance is called, start an interactive session and list all available workflows with brief descriptions - When *workflow-guidance is called, start an interactive session and list all available workflows with brief descriptions
dependencies: dependencies:
tasks: tasks:
- advanced-elicitation - advanced-elicitation.md
- create-doc - create-doc.md
- create-workflow-plan - create-workflow-plan.md
- kb-mode-interaction - kb-mode-interaction.md
- update-workflow-plan - update-workflow-plan.md
data: data:
- bmad-kb - bmad-kb.md
- elicitation-methods.md
utils: utils:
- plan-management - plan-management.md
- workflow-management - workflow-management.md
- template-format - template-format.md
``` ```
==================== END: .bmad-core/agents/bmad-orchestrator.md ==================== ==================== END: .bmad-core/agents/bmad-orchestrator.md ====================
@@ -202,6 +201,7 @@ activation-instructions:
- Only read the files/tasks listed here when user selects them for execution to minimize context usage - Only read the files/tasks listed here when user selects them for execution to minimize context usage
- The customization field ALWAYS takes precedence over any conflicting instructions - The customization field ALWAYS takes precedence over any conflicting instructions
- When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
- Greet the user with your name and role, and inform of the *help command.
agent: agent:
name: Sarah name: Sarah
id: po id: po
@@ -225,8 +225,6 @@ persona:
- User Collaboration for Validation - Seek input at critical checkpoints - User Collaboration for Validation - Seek input at critical checkpoints
- Focus on Executable & Value-Driven Increments - Ensure work aligns with MVP goals - Focus on Executable & Value-Driven Increments - Ensure work aligns with MVP goals
- Documentation Ecosystem Integrity - Maintain consistency across all documents - Documentation Ecosystem Integrity - Maintain consistency across all documents
startup:
- Greet the user with your name and role, and inform of the *help command.
commands: commands:
- help: Show numbered list of the following commands to allow selection - help: Show numbered list of the following commands to allow selection
- create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below) - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
@@ -241,19 +239,17 @@ commands:
- exit: Exit (confirm) - exit: Exit (confirm)
dependencies: dependencies:
tasks: tasks:
- execute-checklist - execute-checklist.md
- shard-doc - shard-doc.md
- correct-course - correct-course.md
- brownfield-create-epic - brownfield-create-epic.md
- brownfield-create-story - brownfield-create-story.md
- validate-next-story - validate-next-story.md
templates: templates:
- story-tmpl - story-tmpl.yaml
checklists: checklists:
- po-master-checklist - po-master-checklist.md
- change-checklist - change-checklist.md
utils:
- template-format
``` ```
==================== END: .bmad-core/agents/po.md ==================== ==================== END: .bmad-core/agents/po.md ====================
@@ -267,6 +263,7 @@ activation-instructions:
- Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER! - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
- The customization field ALWAYS takes precedence over any conflicting instructions - The customization field ALWAYS takes precedence over any conflicting instructions
- When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
- Greet the user with your name and role, and inform of the *help command and then HALT to await instruction if not given already.
agent: agent:
name: Bob name: Bob
id: sm id: sm
@@ -283,10 +280,6 @@ persona:
- Rigorously follow `create-next-story` procedure to generate the detailed user story - Rigorously follow `create-next-story` procedure to generate the detailed user story
- Will ensure all information comes from the PRD and Architecture to guide the dumb dev agent - Will ensure all information comes from the PRD and Architecture to guide the dumb dev agent
- You are NOT allowed to implement stories or modify code EVER! - You are NOT allowed to implement stories or modify code EVER!
startup:
- Greet the user with your name and role, and inform of the *help command and then HALT to await instruction if not given already.
- Offer to help with story preparation but wait for explicit user confirmation
- Only execute tasks when user explicitly requests them
commands: commands:
- help: Show numbered list of the following commands to allow selection - help: Show numbered list of the following commands to allow selection
- draft: Execute task create-next-story - draft: Execute task create-next-story
@@ -295,15 +288,13 @@ commands:
- exit: Say goodbye as the Scrum Master, and then abandon inhabiting this persona - exit: Say goodbye as the Scrum Master, and then abandon inhabiting this persona
dependencies: dependencies:
tasks: tasks:
- create-next-story - create-next-story.md
- execute-checklist - execute-checklist.md
- correct-course - correct-course.md
templates: templates:
- story-tmpl - story-tmpl.yaml
checklists: checklists:
- story-draft-checklist - story-draft-checklist.md
utils:
- template-format
``` ```
==================== END: .bmad-core/agents/sm.md ==================== ==================== END: .bmad-core/agents/sm.md ====================
@@ -313,6 +304,7 @@ dependencies:
CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode: CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
```yaml ```yaml
activation-instructions: []
agent: agent:
name: James name: James
id: dev id: dev
@@ -320,11 +312,6 @@ agent:
icon: 💻 icon: 💻
whenToUse: Use for code implementation, debugging, refactoring, and development best practices whenToUse: Use for code implementation, debugging, refactoring, and development best practices
customization: null customization: null
startup:
- Announce: Greet the user with your name and role, and inform of the *help command.
- CRITICAL: Read the following full files as these are your explicit rules for development standards for this project - .bmad-core/core-config.yaml devLoadAlwaysFiles list
- CRITICAL: Do NOT load any other files during startup aside from the assigned story and devLoadAlwaysFiles items, unless user requested you do or the following contradicts
- CRITICAL: Do NOT begin development until a story is not in draft mode and you are told to proceed
persona: persona:
role: Expert Senior Software Engineer & Implementation Specialist role: Expert Senior Software Engineer & Implementation Specialist
style: Extremely concise, pragmatic, detail-oriented, solution-focused style: Extremely concise, pragmatic, detail-oriented, solution-focused
@@ -351,10 +338,10 @@ develop-story:
completion: 'All Tasks and Subtasks marked [x] and have tests→Validations and full regression passes (DON''T BE LAZY, EXECUTE ALL TESTS and CONFIRM)→Ensure File List is Complete→run the task execute-checklist for the checklist story-dod-checklist→set story status: ''Ready for Review''→HALT' completion: 'All Tasks and Subtasks marked [x] and have tests→Validations and full regression passes (DON''T BE LAZY, EXECUTE ALL TESTS and CONFIRM)→Ensure File List is Complete→run the task execute-checklist for the checklist story-dod-checklist→set story status: ''Ready for Review''→HALT'
dependencies: dependencies:
tasks: tasks:
- execute-checklist - execute-checklist.md
- validate-next-story - validate-next-story.md
checklists: checklists:
- story-dod-checklist - story-dod-checklist.md
``` ```
==================== END: .bmad-core/agents/dev.md ==================== ==================== END: .bmad-core/agents/dev.md ====================
@@ -369,6 +356,7 @@ activation-instructions:
- Only read the files/tasks listed here when user selects them for execution to minimize context usage - Only read the files/tasks listed here when user selects them for execution to minimize context usage
- The customization field ALWAYS takes precedence over any conflicting instructions - The customization field ALWAYS takes precedence over any conflicting instructions
- When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
- Greet the user with your name and role, and inform of the *help command.
agent: agent:
name: Quinn name: Quinn
id: qa id: qa
@@ -392,8 +380,6 @@ persona:
- Risk-Based Testing - Prioritize testing based on risk and critical areas - Risk-Based Testing - Prioritize testing based on risk and critical areas
- Continuous Improvement - Balance perfection with pragmatism - Continuous Improvement - Balance perfection with pragmatism
- Architecture & Design Patterns - Ensure proper patterns and maintainable code structure - Architecture & Design Patterns - Ensure proper patterns and maintainable code structure
startup:
- Greet the user with your name and role, and inform of the *help command.
story-file-permissions: story-file-permissions:
- CRITICAL: When reviewing stories, you are ONLY authorized to update the "QA Results" section of story files - CRITICAL: When reviewing stories, you are ONLY authorized to update the "QA Results" section of story files
- CRITICAL: DO NOT modify any other sections including Status, Story, Acceptance Criteria, Tasks/Subtasks, Dev Notes, Testing, Dev Agent Record, Change Log, or any other sections - CRITICAL: DO NOT modify any other sections including Status, Story, Acceptance Criteria, Tasks/Subtasks, Dev Notes, Testing, Dev Agent Record, Change Log, or any other sections
@@ -405,11 +391,11 @@ commands:
- exit: Say goodbye as the QA Engineer, and then abandon inhabiting this persona - exit: Say goodbye as the QA Engineer, and then abandon inhabiting this persona
dependencies: dependencies:
tasks: tasks:
- review-story - review-story.md
data: data:
- technical-preferences - technical-preferences.md
utils: templates:
- template-format - story-tmpl.yaml
``` ```
==================== END: .bmad-core/agents/qa.md ==================== ==================== END: .bmad-core/agents/qa.md ====================
@@ -534,97 +520,85 @@ Choose a number (0-8) or 9 to proceed:
==================== END: .bmad-core/tasks/advanced-elicitation.md ==================== ==================== END: .bmad-core/tasks/advanced-elicitation.md ====================
==================== START: .bmad-core/tasks/create-doc.md ==================== ==================== START: .bmad-core/tasks/create-doc.md ====================
# Create Document from Template Task # Create Document from Template (YAML Driven)
## Purpose ## CRITICAL: Mandatory Elicitation Format
Generate documents from templates by EXECUTING (not just reading) embedded instructions from the perspective of the selected agent persona. **When `elicit: true`, ALWAYS use this exact format:**
## CRITICAL RULES 1. Present section content
2. Provide detailed rationale (explain trade-offs, assumptions, decisions made)
3. Present numbered options 1-9:
- **Option 1:** Always "Proceed to next section"
- **Options 2-9:** Select 8 methods from data/elicitation-methods
- End with: "Select 1-9 or just type your question/feedback:"
1. **Templates are PROGRAMS** - Execute every [[LLM:]] instruction exactly as written **NEVER ask yes/no questions or use any other format.**
2. **NEVER show markup** - Hide all [[LLM:]], {{placeholders}}, @{examples}, and template syntax
3. **STOP and EXECUTE** - When you see "apply tasks#" or "execute tasks#", STOP and run that task immediately
4. **WAIT for user input** - At review points and after elicitation tasks
## Execution Flow ## Processing Flow
### 0. Check Workflow Plan (if configured) 1. **Parse YAML template** - Load template metadata and sections
2. **Set preferences** - Show current mode (Interactive), confirm output file
3. **Process each section:**
- Skip if condition unmet
- Check agent permissions (owner/editors) - note if section is restricted to specific agents
- Draft content using section instruction
- Present content + detailed rationale
- **IF elicit: true** → MANDATORY 1-9 options format
- Save to file if possible
4. **Continue until complete**
[[LLM: Check if plan tracking is enabled in core-config.yaml]] ## Detailed Rationale Requirements
- If `workflow.trackProgress: true`, check for active plan using .bmad-core/utils/plan-management.md When presenting section content, ALWAYS include rationale that explains:
- If plan exists and this document creation is part of the plan:
- Verify this is the expected next step
- If out of sequence and `enforceSequence: true`, warn user and halt without user override
- If out of sequence and `enforceSequence: false`, ask for confirmation
- Continue with normal execution after plan check
### 1. Identify Template - Trade-offs and choices made (what was chosen over alternatives and why)
- Key assumptions made during drafting
- Interesting or questionable decisions that need user attention
- Areas that might need validation
- Load from `.bmad-core/templates/*.md` or `.bmad-core/templates directory` ## Elicitation Results Flow
- Agent-specific templates are listed in agent's dependencies
- If agent has `templates: [prd-tmpl, architecture-tmpl]` for example, then offer to create "PRD" and "Architecture" documents
### 2. Ask Interaction Mode After user selects elicitation method (2-9):
> 1. **Incremental** - Section by section with reviews 1. Execute method from data/elicitation-methods
> 2. **YOLO Mode** - Complete draft then review (user can type `/yolo` anytime to switch) 2. Present results with insights
3. Offer options:
- **1. Apply changes and update section**
- **2. Return to elicitation menu**
- **3. Ask any questions or engage further with this elicitation**
### 3. Execute Template ## Agent Permissions
- Replace {{placeholders}} with real content When processing sections with agent permission fields:
- Execute [[LLM:]] instructions as you encounter them
- Process <<REPEAT>> loops and ^^CONDITIONS^^
- Use @{examples} for guidance but never output them
### 4. Key Execution Patterns - **owner**: Note which agent role initially creates/populates the section
- **editors**: List agent roles allowed to modify the section
- **readonly**: Mark sections that cannot be modified after creation
**When you see:** `[[LLM: Draft X and immediately execute .bmad-core/tasks/advanced-elicitation.md]]` **For sections with restricted access:**
- Draft the content - Include a note in the generated document indicating the responsible agent
- Present it to user - Example: "_(This section is owned by dev-agent and can only be modified by dev-agent)_"
- IMMEDIATELY execute the task
- Wait for completion before continuing
**When you see:** `[[LLM: After section completion, apply .bmad-core/tasks/Y.md]]` ## YOLO Mode
- Finish the section User can type `#yolo` to toggle to YOLO mode (process all sections at once).
- STOP and execute the task
- Wait for user input
### 5. Validation & Final Presentation ## CRITICAL REMINDERS
- Run any specified checklists **❌ NEVER:**
- Present clean, formatted content only
- No truncation or summarization
- Begin directly with content (no preamble)
- Include any handoff prompts from template
### 6. Update Workflow Plan (if applicable) - Ask yes/no questions for elicitation
- Use any format other than 1-9 numbered options
- Create new elicitation methods
[[LLM: After successful document creation]] **✅ ALWAYS:**
- If plan tracking is enabled and document was part of plan: - Use exact 1-9 format when elicit: true
- Call update-workflow-plan task to mark step complete - Select options 2-9 from data/elicitation-methods only
- Parameters: task: create-doc, step_id: {from plan}, status: complete - Provide detailed rationale explaining decisions
- Show next recommended step from plan - End with "Select 1-9 or just type your question/feedback:"
## Common Mistakes to Avoid
❌ Skipping elicitation tasks
❌ Showing template markup to users
❌ Continuing past STOP signals
❌ Combining multiple review points
✅ Execute ALL instructions in sequence
✅ Present only clean, formatted content
✅ Stop at every elicitation point
✅ Wait for user confirmation when instructed
## Remember
Templates contain precise instructions for a reason. Follow them exactly to ensure document quality and completeness.
==================== END: .bmad-core/tasks/create-doc.md ==================== ==================== END: .bmad-core/tasks/create-doc.md ====================
==================== START: .bmad-core/tasks/create-workflow-plan.md ==================== ==================== START: .bmad-core/tasks/create-workflow-plan.md ====================
@@ -2056,6 +2030,143 @@ Use the **expansion-creator** pack to build your own:
- **Contributing**: See `CONTRIBUTING.md` for full guidelines - **Contributing**: See `CONTRIBUTING.md` for full guidelines
==================== END: .bmad-core/data/bmad-kb.md ==================== ==================== END: .bmad-core/data/bmad-kb.md ====================
==================== START: .bmad-core/data/elicitation-methods.md ====================
# Elicitation Methods Data
## Core Reflective Methods
**Expand or Contract for Audience**
- Ask whether to 'expand' (add detail, elaborate) or 'contract' (simplify, clarify)
- Identify specific target audience if relevant
- Tailor content complexity and depth accordingly
**Explain Reasoning (CoT Step-by-Step)**
- Walk through the step-by-step thinking process
- Reveal underlying assumptions and decision points
- Show how conclusions were reached from current role's perspective
**Critique and Refine**
- Review output for flaws, inconsistencies, or improvement areas
- Identify specific weaknesses from role's expertise
- Suggest refined version reflecting domain knowledge
## Structural Analysis Methods
**Analyze Logical Flow and Dependencies**
- Examine content structure for logical progression
- Check internal consistency and coherence
- Identify and validate dependencies between elements
- Confirm effective ordering and sequencing
**Assess Alignment with Overall Goals**
- Evaluate content contribution to stated objectives
- Identify any misalignments or gaps
- Interpret alignment from specific role's perspective
- Suggest adjustments to better serve goals
## Risk and Challenge Methods
**Identify Potential Risks and Unforeseen Issues**
- Brainstorm potential risks from role's expertise
- Identify overlooked edge cases or scenarios
- Anticipate unintended consequences
- Highlight implementation challenges
**Challenge from Critical Perspective**
- Adopt critical stance on current content
- Play devil's advocate from specified viewpoint
- Argue against proposal highlighting weaknesses
- Apply YAGNI principles when appropriate (scope trimming)
## Creative Exploration Methods
**Tree of Thoughts Deep Dive**
- Break problem into discrete "thoughts" or intermediate steps
- Explore multiple reasoning paths simultaneously
- Use self-evaluation to classify each path as "sure", "likely", or "impossible"
- Apply search algorithms (BFS/DFS) to find optimal solution paths
**Hindsight is 20/20: The 'If Only...' Reflection**
- Imagine retrospective scenario based on current content
- Identify the one "if only we had known/done X..." insight
- Describe imagined consequences humorously or dramatically
- Extract actionable learnings for current context
## Multi-Persona Collaboration Methods
**Agile Team Perspective Shift**
- Rotate through different Scrum team member viewpoints
- Product Owner: Focus on user value and business impact
- Scrum Master: Examine process flow and team dynamics
- Developer: Assess technical implementation and complexity
- QA: Identify testing scenarios and quality concerns
**Stakeholder Round Table**
- Convene virtual meeting with multiple personas
- Each persona contributes unique perspective on content
- Identify conflicts and synergies between viewpoints
- Synthesize insights into actionable recommendations
**Meta-Prompting Analysis**
- Step back to analyze the structure and logic of current approach
- Question the format and methodology being used
- Suggest alternative frameworks or mental models
- Optimize the elicitation process itself
## Advanced 2025 Techniques
**Self-Consistency Validation**
- Generate multiple reasoning paths for same problem
- Compare consistency across different approaches
- Identify most reliable and robust solution
- Highlight areas where approaches diverge and why
**ReWOO (Reasoning Without Observation)**
- Separate parametric reasoning from tool-based actions
- Create reasoning plan without external dependencies
- Identify what can be solved through pure reasoning
- Optimize for efficiency and reduced token usage
**Persona-Pattern Hybrid**
- Combine specific role expertise with elicitation pattern
- Architect + Risk Analysis: Deep technical risk assessment
- UX Expert + User Journey: End-to-end experience critique
- PM + Stakeholder Analysis: Multi-perspective impact review
**Emergent Collaboration Discovery**
- Allow multiple perspectives to naturally emerge
- Identify unexpected insights from persona interactions
- Explore novel combinations of viewpoints
- Capture serendipitous discoveries from multi-agent thinking
## Game-Based Elicitation Methods
**Red Team vs Blue Team**
- Red Team: Attack the proposal, find vulnerabilities
- Blue Team: Defend and strengthen the approach
- Competitive analysis reveals blind spots
- Results in more robust, battle-tested solutions
**Innovation Tournament**
- Pit multiple alternative approaches against each other
- Score each approach across different criteria
- Crowd-source evaluation from different personas
- Identify winning combination of features
**Escape Room Challenge**
- Present content as constraints to work within
- Find creative solutions within tight limitations
- Identify minimum viable approach
- Discover innovative workarounds and optimizations
## Process Control
**Proceed / No Further Actions**
- Acknowledge choice to finalize current work
- Accept output as-is or move to next step
- Prepare to continue without additional elicitation
==================== END: .bmad-core/data/elicitation-methods.md ====================
==================== START: .bmad-core/utils/plan-management.md ==================== ==================== START: .bmad-core/utils/plan-management.md ====================
# Plan Management Utility # Plan Management Utility
@@ -3195,66 +3306,145 @@ Provide a structured validation report including:
- **Confidence Level**: High/Medium/Low for successful implementation - **Confidence Level**: High/Medium/Low for successful implementation
==================== END: .bmad-core/tasks/validate-next-story.md ==================== ==================== END: .bmad-core/tasks/validate-next-story.md ====================
==================== START: .bmad-core/templates/story-tmpl.md ==================== ==================== START: .bmad-core/templates/story-tmpl.yaml ====================
--- template:
defaultOutput: docs/stories/{{EpicNum}}.{{StoryNum}}.{{Short Title Copied from Epic File specific story}}.md id: story-template-v2
smAgent: name: Story Document
editableSections: Status, Story, Acceptance Criteria, Tasks / Subtasks, Dev Notes, Testing, Change Log version: 2.0
sectionSpecificInstructions: output:
"Dev Notes": format: markdown
- Populate relevant information, only what was pulled from actual artifacts from docs folder, relevant to this story filename: docs/stories/{{epic_num}}.{{story_num}}.{{story_title_short}}.md
- Do not invent information. title: "Story {{epic_num}}.{{story_num}}: {{story_title_short}}"
- If known add Relevant Source Tree info that relates to this story.
- If there were important notes from previous story that are relevant to this one, include them here.
- Put enough information in this section so that the dev agent should NEVER need to read the architecture documents, these notes along with the tasks and subtasks must give the Dev Agent the complete context it needs to comprehend with the least amount of overhead the information to complete the story, meeting all AC and completing all tasks+subtasks.
Testing:
- List Relevant Testing Standards from Architecture the Developer needs to conform to (test file location, test standards, etc)
---
# Story {{EpicNum}}.{{StoryNum}}: {{Short Title Copied from Epic File specific story}} workflow:
mode: interactive
elicitation: advanced-elicitation
## Status: {{ Draft | Approved | InProgress | Review | Done }} agent_config:
editable_sections:
- Status
- Story
- Acceptance Criteria
- Tasks / Subtasks
- Dev Notes
- Testing
- Change Log
## Story sections:
- id: status
title: Status
type: choice
choices: [Draft, Approved, InProgress, Review, Done]
instruction: Select the current status of the story
owner: scrum-master
editors: [scrum-master, dev-agent]
**As a** {{role}},\ - id: story
**I want** {{action}},\ title: Story
**so that** {{benefit}} type: template-text
template: |
**As a** {{role}},
**I want** {{action}},
**so that** {{benefit}}
instruction: Define the user story using the standard format with role, action, and benefit
elicit: true
owner: scrum-master
editors: [scrum-master]
## Acceptance Criteria - id: acceptance-criteria
title: Acceptance Criteria
type: numbered-list
instruction: Copy the acceptance criteria numbered list from the epic file
elicit: true
owner: scrum-master
editors: [scrum-master]
{{ Copy of Acceptance Criteria numbered list }} - id: tasks-subtasks
title: Tasks / Subtasks
## Tasks / Subtasks type: bullet-list
instruction: |
- [ ] Task 1 (AC: # if applicable) Break down the story into specific tasks and subtasks needed for implementation.
Reference applicable acceptance criteria numbers where relevant.
template: |
- [ ] Task 1 (AC: # if applicable)
- [ ] Subtask1.1... - [ ] Subtask1.1...
- [ ] Task 2 (AC: # if applicable) - [ ] Task 2 (AC: # if applicable)
- [ ] Subtask 2.1... - [ ] Subtask 2.1...
- [ ] Task 3 (AC: # if applicable) - [ ] Task 3 (AC: # if applicable)
- [ ] Subtask 3.1... - [ ] Subtask 3.1...
elicit: true
owner: scrum-master
editors: [scrum-master, dev-agent]
## Dev Notes - id: dev-notes
title: Dev Notes
instruction: |
Populate relevant information, only what was pulled from actual artifacts from docs folder, relevant to this story:
- Do not invent information
- If known add Relevant Source Tree info that relates to this story
- If there were important notes from previous story that are relevant to this one, include them here
- Put enough information in this section so that the dev agent should NEVER need to read the architecture documents, these notes along with the tasks and subtasks must give the Dev Agent the complete context it needs to comprehend with the least amount of overhead the information to complete the story, meeting all AC and completing all tasks+subtasks
elicit: true
owner: scrum-master
editors: [scrum-master]
sections:
- id: testing-standards
title: Testing
instruction: |
List Relevant Testing Standards from Architecture the Developer needs to conform to:
- Test file location
- Test standards
- Testing frameworks and patterns to use
- Any specific testing requirements for this story
elicit: true
owner: scrum-master
editors: [scrum-master]
### Testing - id: change-log
title: Change Log
type: table
columns: [Date, Version, Description, Author]
instruction: Track changes made to this story document
owner: scrum-master
editors: [scrum-master, dev-agent, qa-agent]
## Change Log - id: dev-agent-record
title: Dev Agent Record
instruction: This section is populated by the development agent during implementation
owner: dev-agent
editors: [dev-agent]
sections:
- id: agent-model
title: Agent Model Used
template: "{{agent_model_name_version}}"
instruction: Record the specific AI agent model and version used for development
owner: dev-agent
editors: [dev-agent]
| Date | Version | Description | Author | - id: debug-log-references
| :--- | :------ | :---------- | :----- | title: Debug Log References
instruction: Reference any debug logs or traces generated during development
owner: dev-agent
editors: [dev-agent]
## Dev Agent Record - id: completion-notes
title: Completion Notes List
instruction: Notes about the completion of tasks and any issues encountered
owner: dev-agent
editors: [dev-agent]
### Agent Model Used: {{Agent Model Name/Version}} - id: file-list
title: File List
instruction: List all files created, modified, or affected during story implementation
owner: dev-agent
editors: [dev-agent]
### Debug Log References - id: qa-results
title: QA Results
### Completion Notes List instruction: Results from QA Agent QA review of the completed story implementation
owner: qa-agent
### File List editors: [qa-agent]
==================== END: .bmad-core/templates/story-tmpl.yaml ====================
## QA Results
==================== END: .bmad-core/templates/story-tmpl.md ====================
==================== START: .bmad-core/checklists/po-master-checklist.md ==================== ==================== START: .bmad-core/checklists/po-master-checklist.md ====================
# Product Owner (PO) Master Validation Checklist # Product Owner (PO) Master Validation Checklist

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

File diff suppressed because it is too large Load Diff

4
expansion-packs/bmad-2d-phaser-game-dev/agent-teams/phaser-2d-nodejs-game-team.yaml
View File

@@ -9,5 +9,5 @@ agents:
- game-developer - game-developer
- game-sm - game-sm
workflows: workflows:
- game-dev-greenfield - game-dev-greenfield.md
- game-prototype - game-prototype.md

1
expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.md
View File

@@ -6,7 +6,6 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
root: .bmad-2d-phaser-game-dev root: .bmad-2d-phaser-game-dev
IDE-FILE-RESOLUTION: Dependencies map to files as {root}/{type}/{name} where root=".bmad-core", type=folder (tasks/templates/checklists/utils), name=dependency name. IDE-FILE-RESOLUTION: Dependencies map to files as {root}/{type}/{name} where root=".bmad-core", type=folder (tasks/templates/checklists/utils), name=dependency name.
REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (e.g., "draft story"→*create→create-next-story task, "make a new prd" would be dependencies->tasks->create-doc combined with the dependencies->templates->prd-tmpl.md), or ask for clarification if ambiguous. REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (e.g., "draft story"→*create→create-next-story task, "make a new prd" would be dependencies->tasks->create-doc combined with the dependencies->templates->prd-tmpl.md), or ask for clarification if ambiguous.
activation-instructions:
activation-instructions: activation-instructions:
- Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER! - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
- Only read the files/tasks listed here when user selects them for execution to minimize context usage - Only read the files/tasks listed here when user selects them for execution to minimize context usage

36
tools/builders/web-builder.js
View File

@@ -211,6 +211,7 @@ These references map directly to bundle sections:
parsed["activation-instructions"] = parsed["activation-instructions"].filter( parsed["activation-instructions"] = parsed["activation-instructions"].filter(
(instruction) => { (instruction) => {
return ( return (
typeof instruction === 'string' &&
!instruction.startsWith("IDE-FILE-RESOLUTION:") && !instruction.startsWith("IDE-FILE-RESOLUTION:") &&
!instruction.startsWith("REQUEST-RESOLUTION:") !instruction.startsWith("REQUEST-RESOLUTION:")
); );
@@ -393,11 +394,9 @@ These references map directly to bundle sections:
if (Array.isArray(resources)) { if (Array.isArray(resources)) {
for (const resourceName of resources) { for (const resourceName of resources) {
let found = false; let found = false;
const extensions = [".md", ".yaml"];
// Try expansion pack first // Try expansion pack first
for (const ext of extensions) { const resourcePath = path.join(packDir, resourceType, resourceName);
const resourcePath = path.join(packDir, resourceType, `${resourceName}${ext}`);
try { try {
const resourceContent = await fs.readFile(resourcePath, "utf8"); const resourceContent = await fs.readFile(resourcePath, "utf8");
const resourceWebPath = this.convertToWebPath(resourcePath, packName); const resourceWebPath = this.convertToWebPath(resourcePath, packName);
@@ -405,20 +404,17 @@ These references map directly to bundle sections:
this.formatSection(resourceWebPath, resourceContent, packName) this.formatSection(resourceWebPath, resourceContent, packName)
); );
found = true; found = true;
break;
} catch (error) { } catch (error) {
// Not in expansion pack, continue // Not in expansion pack, continue
} }
}
// If not found in expansion pack, try core // If not found in expansion pack, try core
if (!found) { if (!found) {
for (const ext of extensions) {
const corePath = path.join( const corePath = path.join(
this.rootDir, this.rootDir,
"bmad-core", "bmad-core",
resourceType, resourceType,
`${resourceName}${ext}` resourceName
); );
try { try {
const coreContent = await fs.readFile(corePath, "utf8"); const coreContent = await fs.readFile(corePath, "utf8");
@@ -427,21 +423,18 @@ These references map directly to bundle sections:
this.formatSection(coreWebPath, coreContent, packName) this.formatSection(coreWebPath, coreContent, packName)
); );
found = true; found = true;
break;
} catch (error) { } catch (error) {
// Not in core either, continue // Not in core either, continue
} }
} }
}
// If not found in core, try common folder // If not found in core, try common folder
if (!found) { if (!found) {
for (const ext of extensions) {
const commonPath = path.join( const commonPath = path.join(
this.rootDir, this.rootDir,
"common", "common",
resourceType, resourceType,
`${resourceName}${ext}` resourceName
); );
try { try {
const commonContent = await fs.readFile(commonPath, "utf8"); const commonContent = await fs.readFile(commonPath, "utf8");
@@ -450,12 +443,10 @@ These references map directly to bundle sections:
this.formatSection(commonWebPath, commonContent, packName) this.formatSection(commonWebPath, commonContent, packName)
); );
found = true; found = true;
break;
} catch (error) { } catch (error) {
// Not in common either, continue // Not in common either, continue
} }
} }
}
if (!found) { if (!found) {
console.warn( console.warn(
@@ -509,8 +500,7 @@ These references map directly to bundle sections:
for (const resourceFile of resourceFiles.filter( for (const resourceFile of resourceFiles.filter(
(f) => f.endsWith(".md") || f.endsWith(".yaml") (f) => f.endsWith(".md") || f.endsWith(".yaml")
)) { )) {
const fileName = resourceFile.replace(/\.(md|yaml)$/, ""); expansionResources.set(`${resourceDir}#${resourceFile}`, true);
expansionResources.set(`${resourceDir}#${fileName}`, true);
} }
} catch (error) { } catch (error) {
// Directory might not exist, that's fine // Directory might not exist, that's fine
@@ -597,57 +587,47 @@ These references map directly to bundle sections:
// Always prefer expansion pack versions if they exist // Always prefer expansion pack versions if they exist
for (const [key, dep] of allDependencies) { for (const [key, dep] of allDependencies) {
let found = false; let found = false;
const extensions = [".md", ".yaml"];
// Always check expansion pack first, even if the dependency came from a core agent // Always check expansion pack first, even if the dependency came from a core agent
if (expansionResources.has(key)) { if (expansionResources.has(key)) {
// We know it exists in expansion pack, find and load it // We know it exists in expansion pack, find and load it
for (const ext of extensions) { const expansionPath = path.join(packDir, dep.type, dep.name);
const expansionPath = path.join(packDir, dep.type, `${dep.name}${ext}`);
try { try {
const content = await fs.readFile(expansionPath, "utf8"); const content = await fs.readFile(expansionPath, "utf8");
const expansionWebPath = this.convertToWebPath(expansionPath, packName); const expansionWebPath = this.convertToWebPath(expansionPath, packName);
sections.push(this.formatSection(expansionWebPath, content, packName)); sections.push(this.formatSection(expansionWebPath, content, packName));
console.log(` ✓ Using expansion override for ${key}`); console.log(` ✓ Using expansion override for ${key}`);
found = true; found = true;
break;
} catch (error) { } catch (error) {
// Try next extension // Try next extension
} }
} }
}
// If not found in expansion pack (or doesn't exist there), try core // If not found in expansion pack (or doesn't exist there), try core
if (!found) { if (!found) {
for (const ext of extensions) { const corePath = path.join(this.rootDir, "bmad-core", dep.type, dep.name);
const corePath = path.join(this.rootDir, "bmad-core", dep.type, `${dep.name}${ext}`);
try { try {
const content = await fs.readFile(corePath, "utf8"); const content = await fs.readFile(corePath, "utf8");
const coreWebPath = this.convertToWebPath(corePath, packName); const coreWebPath = this.convertToWebPath(corePath, packName);
sections.push(this.formatSection(coreWebPath, content, packName)); sections.push(this.formatSection(coreWebPath, content, packName));
found = true; found = true;
break;
} catch (error) { } catch (error) {
// Not in core either, continue // Not in core either, continue
} }
} }
}
// If not found in core, try common folder // If not found in core, try common folder
if (!found) { if (!found) {
for (const ext of extensions) { const commonPath = path.join(this.rootDir, "common", dep.type, dep.name);
const commonPath = path.join(this.rootDir, "common", dep.type, `${dep.name}${ext}`);
try { try {
const content = await fs.readFile(commonPath, "utf8"); const content = await fs.readFile(commonPath, "utf8");
const commonWebPath = this.convertToWebPath(commonPath, packName); const commonWebPath = this.convertToWebPath(commonPath, packName);
sections.push(this.formatSection(commonWebPath, content, packName)); sections.push(this.formatSection(commonWebPath, content, packName));
found = true; found = true;
break;
} catch (error) { } catch (error) {
// Not in common either, continue // Not in common either, continue
} }
} }
}
if (!found) { if (!found) {
console.warn(` ⚠ Dependency ${key} not found in expansion pack or core`); console.warn(` ⚠ Dependency ${key} not found in expansion pack or core`);

19
tools/lib/dependency-resolver.js
View File

@@ -116,31 +116,20 @@ class DependencyResolver {
} }
try { try {
const extensions = ['.md', '.yaml'];
let content = null; let content = null;
let filePath = null; let filePath = null;
// First try bmad-core // First try bmad-core
for (const ext of extensions) {
try { try {
filePath = path.join(this.bmadCore, type, `${id}${ext}`); filePath = path.join(this.bmadCore, type, id);
content = await fs.readFile(filePath, 'utf8'); content = await fs.readFile(filePath, 'utf8');
break;
} catch (e) { } catch (e) {
// Try next extension
}
}
// If not found in bmad-core, try common folder // If not found in bmad-core, try common folder
if (!content) {
for (const ext of extensions) {
try { try {
filePath = path.join(this.common, type, `${id}${ext}`); filePath = path.join(this.common, type, id);
content = await fs.readFile(filePath, 'utf8'); content = await fs.readFile(filePath, 'utf8');
break; } catch (e2) {
} catch (e) { // File not found in either location
// Try next extension
}
} }
} }