@devo-bmad-custom/agent-orchestration 1.0.4 → 1.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (86) hide show
  1. package/package.json +1 -1
  2. package/src/.agents/skills/tmux-commands/SKILL.md +353 -0
  3. package/src/bmm/data/project-context-template.md +26 -26
  4. package/src/bmm/teams/default-party.csv +20 -20
  5. package/src/bmm/workflows/2-plan-workflows/create-prd/data/domain-complexity.csv +14 -14
  6. package/src/bmm/workflows/2-plan-workflows/create-prd/data/prd-purpose.md +197 -197
  7. package/src/bmm/workflows/2-plan-workflows/create-prd/data/project-types.csv +10 -10
  8. package/src/bmm/workflows/2-plan-workflows/create-prd/templates/prd-template.md +10 -10
  9. package/src/bmm/workflows/3-solutioning/create-architecture/data/domain-complexity.csv +12 -12
  10. package/src/bmm/workflows/4-implementation/code-review/instructions.xml +226 -226
  11. package/src/bmm/workflows/4-implementation/correct-course/checklist.md +288 -288
  12. package/src/bmm/workflows/4-implementation/correct-course/instructions.md +207 -207
  13. package/src/bmm/workflows/4-implementation/retrospective/instructions.md +1444 -1444
  14. package/src/bmm/workflows/4-implementation/sprint-planning/sprint-status-template.yaml +55 -55
  15. package/src/bmm/workflows/4-implementation/sprint-status/instructions.md +230 -230
  16. package/src/bmm/workflows/bmad-quick-flow/quick-spec/tech-spec-template.md +74 -74
  17. package/src/bmm/workflows/document-project/instructions.md +130 -130
  18. package/src/bmm/workflows/document-project/templates/project-scan-report-schema.json +160 -160
  19. package/src/bmm/workflows/document-project/workflows/deep-dive-instructions.md +298 -298
  20. package/src/bmm/workflows/document-project/workflows/deep-dive.yaml +31 -31
  21. package/src/bmm/workflows/document-project/workflows/full-scan-instructions.md +1106 -1106
  22. package/src/bmm/workflows/document-project/workflows/full-scan.yaml +31 -31
  23. package/src/bmm/workflows/qa-generate-e2e-tests/checklist.md +33 -33
  24. package/src/bmm/workflows/qa-generate-e2e-tests/instructions.md +110 -110
  25. package/src/core/agents/bmad-master.md +56 -56
  26. package/src/core/workflows/party-mode/steps/step-02-discussion-orchestration.md +187 -187
  27. package/src/core/workflows/party-mode/steps/step-03-graceful-exit.md +168 -168
  28. package/src/.agents/skills/ui-ux-pro-custom/data/swift-ios-skills/vision-framework/SKILL.md +0 -475
  29. package/src/.agents/skills/ui-ux-pro-custom/data/swift-ios-skills/vision-framework/references/vision-requests.md +0 -736
  30. package/src/.agents/skills/ui-ux-pro-custom/data/swift-ios-skills/vision-framework/references/visionkit-scanner.md +0 -738
  31. package/src/.agents/skills/ui-ux-pro-custom/data/swift-ios-skills/weatherkit/SKILL.md +0 -410
  32. package/src/.agents/skills/ui-ux-pro-custom/data/swift-ios-skills/weatherkit/references/weatherkit-patterns.md +0 -567
  33. package/src/.agents/skills/ui-ux-pro-custom/data/swift-ios-skills/widgetkit/SKILL.md +0 -497
  34. package/src/.agents/skills/ui-ux-pro-custom/data/swift-ios-skills/widgetkit/references/widgetkit-advanced.md +0 -871
  35. package/src/.agents/skills/ui-ux-pro-custom/data/typography.csv +0 -58
  36. package/src/.agents/skills/ui-ux-pro-custom/data/ui-reasoning.csv +0 -101
  37. package/src/.agents/skills/ui-ux-pro-custom/data/ux-guidelines.csv +0 -100
  38. package/src/.agents/skills/ui-ux-pro-custom/data/web-interface.csv +0 -31
  39. package/src/.agents/skills/ui-ux-pro-custom/scripts/core.py +0 -253
  40. package/src/.agents/skills/ui-ux-pro-custom/scripts/design_system.py +0 -1067
  41. package/src/.agents/skills/ui-ux-pro-custom/scripts/search.py +0 -114
  42. package/src/.agents/skills/ux-audit/SKILL.md +0 -151
  43. package/src/.agents/skills/websocket-engineer/SKILL.md +0 -168
  44. package/src/.agents/skills/websocket-engineer/references/alternatives.md +0 -391
  45. package/src/.agents/skills/websocket-engineer/references/patterns.md +0 -400
  46. package/src/.agents/skills/websocket-engineer/references/protocol.md +0 -195
  47. package/src/.agents/skills/websocket-engineer/references/scaling.md +0 -333
  48. package/src/.agents/skills/websocket-engineer/references/security.md +0 -474
  49. package/src/.agents/skills/writing-skills/SKILL.md +0 -655
  50. package/src/.agents/skills/writing-skills/anthropic-best-practices.md +0 -1150
  51. package/src/.agents/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +0 -189
  52. package/src/.agents/skills/writing-skills/graphviz-conventions.dot +0 -172
  53. package/src/.agents/skills/writing-skills/persuasion-principles.md +0 -187
  54. package/src/.agents/skills/writing-skills/render-graphs.js +0 -168
  55. package/src/.agents/skills/writing-skills/testing-skills-with-subagents.md +0 -384
  56. package/src/.claude/commands/bmad-track-compact.md +0 -19
  57. package/src/.claude/commands/bmad-track-extended.md +0 -19
  58. package/src/.claude/commands/bmad-track-large.md +0 -19
  59. package/src/.claude/commands/bmad-track-medium.md +0 -19
  60. package/src/.claude/commands/bmad-track-nano.md +0 -19
  61. package/src/.claude/commands/bmad-track-rv.md +0 -18
  62. package/src/.claude/commands/bmad-track-small.md +0 -19
  63. package/src/.claude/commands/master-orchestrator.md +0 -15
  64. package/src/_memory/master-orchestrator-sidecar/docs-index.md +0 -3
  65. package/src/_memory/master-orchestrator-sidecar/instructions.md +0 -2616
  66. package/src/_memory/master-orchestrator-sidecar/memories.md +0 -8
  67. package/src/_memory/master-orchestrator-sidecar/session-state.md +0 -15
  68. package/src/_memory/master-orchestrator-sidecar/triage-history.md +0 -3
  69. package/src/_memory/master-orchestrator-sidecar/workflows-overview.html +0 -1230
  70. package/src/core/agents/master-orchestrator.md +0 -54
  71. package/src/docs/dev/tmux/actions_popup.py +0 -291
  72. package/src/docs/dev/tmux/actions_popup.sh +0 -110
  73. package/src/docs/dev/tmux/claude_usage.sh +0 -15
  74. package/src/docs/dev/tmux/colors.conf +0 -26
  75. package/src/docs/dev/tmux/cpu_usage.sh +0 -7
  76. package/src/docs/dev/tmux/dispatch.sh +0 -10
  77. package/src/docs/dev/tmux/float_init.sh +0 -13
  78. package/src/docs/dev/tmux/float_term.sh +0 -23
  79. package/src/docs/dev/tmux/open_clip.sh +0 -14
  80. package/src/docs/dev/tmux/paste_clipboard.sh +0 -13
  81. package/src/docs/dev/tmux/paste_image_wrapper.sh +0 -94
  82. package/src/docs/dev/tmux/ram_usage.sh +0 -3
  83. package/src/docs/dev/tmux/title_sync.sh +0 -54
  84. package/src/docs/dev/tmux/tmux-setup.md +0 -867
  85. package/src/docs/dev/tmux/tmux.conf +0 -127
  86. package/src/docs/dev/tmux/xclip +0 -18
@@ -1,31 +1,31 @@
1
- # Full Project Scan Workflow Configuration
2
- name: "document-project-full-scan"
3
- description: "Complete project documentation workflow (initial scan or full rescan)"
4
- author: "BMad"
5
-
6
- # This is a sub-workflow called by document-project/workflow.yaml
7
- parent_workflow: "{project-root}/_bmad/bmm/workflows/document-project/workflow.yaml"
8
-
9
- # Critical variables inherited from parent
10
- config_source: "{project-root}/_bmad/bmb/config.yaml"
11
- project_knowledge: "{config_source}:project_knowledge"
12
- user_name: "{config_source}:user_name"
13
- date: system-generated
14
-
15
- # Data files
16
- documentation_requirements_csv: "{project-root}/_bmad/bmm/workflows/document-project/documentation-requirements.csv"
17
-
18
- # Module path and component files
19
- installed_path: "{project-root}/_bmad/bmm/workflows/document-project/workflows"
20
- template: false # Action workflow
21
- instructions: "{installed_path}/full-scan-instructions.md"
22
- validation: "{project-root}/_bmad/bmm/workflows/document-project/checklist.md"
23
-
24
- # Runtime inputs (passed from parent workflow)
25
- workflow_mode: "" # "initial_scan" or "full_rescan"
26
- scan_level: "" # "quick", "deep", or "exhaustive"
27
- resume_mode: false
28
- project_root_path: ""
29
-
30
- # Configuration
31
- autonomous: false # Requires user input at key decision points
1
+ # Full Project Scan Workflow Configuration
2
+ name: "document-project-full-scan"
3
+ description: "Complete project documentation workflow (initial scan or full rescan)"
4
+ author: "BMad"
5
+
6
+ # This is a sub-workflow called by document-project/workflow.yaml
7
+ parent_workflow: "{project-root}/_bmad/bmm/workflows/document-project/workflow.yaml"
8
+
9
+ # Critical variables inherited from parent
10
+ config_source: "{project-root}/_bmad/bmb/config.yaml"
11
+ project_knowledge: "{config_source}:project_knowledge"
12
+ user_name: "{config_source}:user_name"
13
+ date: system-generated
14
+
15
+ # Data files
16
+ documentation_requirements_csv: "{project-root}/_bmad/bmm/workflows/document-project/documentation-requirements.csv"
17
+
18
+ # Module path and component files
19
+ installed_path: "{project-root}/_bmad/bmm/workflows/document-project/workflows"
20
+ template: false # Action workflow
21
+ instructions: "{installed_path}/full-scan-instructions.md"
22
+ validation: "{project-root}/_bmad/bmm/workflows/document-project/checklist.md"
23
+
24
+ # Runtime inputs (passed from parent workflow)
25
+ workflow_mode: "" # "initial_scan" or "full_rescan"
26
+ scan_level: "" # "quick", "deep", or "exhaustive"
27
+ resume_mode: false
28
+ project_root_path: ""
29
+
30
+ # Configuration
31
+ autonomous: false # Requires user input at key decision points
@@ -1,33 +1,33 @@
1
- # Quinn Automate - Validation Checklist
2
-
3
- ## Test Generation
4
-
5
- - [ ] API tests generated (if applicable)
6
- - [ ] E2E tests generated (if UI exists)
7
- - [ ] Tests use standard test framework APIs
8
- - [ ] Tests cover happy path
9
- - [ ] Tests cover 1-2 critical error cases
10
-
11
- ## Test Quality
12
-
13
- - [ ] All generated tests run successfully
14
- - [ ] Tests use proper locators (semantic, accessible)
15
- - [ ] Tests have clear descriptions
16
- - [ ] No hardcoded waits or sleeps
17
- - [ ] Tests are independent (no order dependency)
18
-
19
- ## Output
20
-
21
- - [ ] Test summary created
22
- - [ ] Tests saved to appropriate directories
23
- - [ ] Summary includes coverage metrics
24
-
25
- ## Validation
26
-
27
- Run the tests using your project's test command.
28
-
29
- **Expected**: All tests pass ✅
30
-
31
- ---
32
-
33
- **Need more comprehensive testing?** Install [Test Architect (TEA)](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/) for advanced workflows.
1
+ # Quinn Automate - Validation Checklist
2
+
3
+ ## Test Generation
4
+
5
+ - [ ] API tests generated (if applicable)
6
+ - [ ] E2E tests generated (if UI exists)
7
+ - [ ] Tests use standard test framework APIs
8
+ - [ ] Tests cover happy path
9
+ - [ ] Tests cover 1-2 critical error cases
10
+
11
+ ## Test Quality
12
+
13
+ - [ ] All generated tests run successfully
14
+ - [ ] Tests use proper locators (semantic, accessible)
15
+ - [ ] Tests have clear descriptions
16
+ - [ ] No hardcoded waits or sleeps
17
+ - [ ] Tests are independent (no order dependency)
18
+
19
+ ## Output
20
+
21
+ - [ ] Test summary created
22
+ - [ ] Tests saved to appropriate directories
23
+ - [ ] Summary includes coverage metrics
24
+
25
+ ## Validation
26
+
27
+ Run the tests using your project's test command.
28
+
29
+ **Expected**: All tests pass ✅
30
+
31
+ ---
32
+
33
+ **Need more comprehensive testing?** Install [Test Architect (TEA)](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/) for advanced workflows.
@@ -1,110 +1,110 @@
1
- # Quinn QA - Automate
2
-
3
- **Goal**: Generate automated API and E2E tests for implemented code.
4
-
5
- **Scope**: This workflow generates tests ONLY. It does **not** perform code review or story validation (use Code Review `CR` for that).
6
-
7
- ## Instructions
8
-
9
- ### Step 0: Detect Test Framework
10
-
11
- Check project for existing test framework:
12
-
13
- - Look for `package.json` dependencies (playwright, jest, vitest, cypress, etc.)
14
- - Check for existing test files to understand patterns
15
- - Use whatever test framework the project already has
16
- - If no framework exists:
17
- - Analyze source code to determine project type (React, Vue, Node API, etc.)
18
- - Search online for current recommended test framework for that stack
19
- - Suggest the meta framework and use it (or ask user to confirm)
20
-
21
- ### Step 1: Identify Features
22
-
23
- Ask user what to test:
24
-
25
- - Specific feature/component name
26
- - Directory to scan (e.g., `src/components/`)
27
- - Or auto-discover features in the codebase
28
-
29
- ### Step 2: Generate API Tests (if applicable)
30
-
31
- For API endpoints/services, generate tests that:
32
-
33
- - Test status codes (200, 400, 404, 500)
34
- - Validate response structure
35
- - Cover happy path + 1-2 error cases
36
- - Use project's existing test framework patterns
37
-
38
- ### Step 3: Generate E2E Tests (if UI exists)
39
-
40
- For UI features, generate tests that:
41
-
42
- - Test user workflows end-to-end
43
- - Use semantic locators (roles, labels, text)
44
- - Focus on user interactions (clicks, form fills, navigation)
45
- - Assert visible outcomes
46
- - Keep tests linear and simple
47
- - Follow project's existing test patterns
48
-
49
- ### Step 4: Run Tests
50
-
51
- Execute tests to verify they pass (use project's test command).
52
-
53
- If failures occur, fix them immediately.
54
-
55
- ### Step 5: Create Summary
56
-
57
- Output markdown summary:
58
-
59
- ```markdown
60
- # Test Automation Summary
61
-
62
- ## Generated Tests
63
-
64
- ### API Tests
65
- - [x] tests/api/endpoint.spec.ts - Endpoint validation
66
-
67
- ### E2E Tests
68
- - [x] tests/e2e/feature.spec.ts - User workflow
69
-
70
- ## Coverage
71
- - API endpoints: 5/10 covered
72
- - UI features: 3/8 covered
73
-
74
- ## Next Steps
75
- - Run tests in CI
76
- - Add more edge cases as needed
77
- ```
78
-
79
- ## Keep It Simple
80
-
81
- **Do:**
82
-
83
- - Use standard test framework APIs
84
- - Focus on happy path + critical errors
85
- - Write readable, maintainable tests
86
- - Run tests to verify they pass
87
-
88
- **Avoid:**
89
-
90
- - Complex fixture composition
91
- - Over-engineering
92
- - Unnecessary abstractions
93
-
94
- **For Advanced Features:**
95
-
96
- If the project needs:
97
-
98
- - Risk-based test strategy
99
- - Test design planning
100
- - Quality gates and NFR assessment
101
- - Comprehensive coverage analysis
102
- - Advanced testing patterns and utilities
103
-
104
- → **Install Test Architect (TEA) module**: <https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/>
105
-
106
- ## Output
107
-
108
- Save summary to: `{implementation_artifacts}/tests/test-summary.md`
109
-
110
- **Done!** Tests generated and verified.
1
+ # Quinn QA - Automate
2
+
3
+ **Goal**: Generate automated API and E2E tests for implemented code.
4
+
5
+ **Scope**: This workflow generates tests ONLY. It does **not** perform code review or story validation (use Code Review `CR` for that).
6
+
7
+ ## Instructions
8
+
9
+ ### Step 0: Detect Test Framework
10
+
11
+ Check project for existing test framework:
12
+
13
+ - Look for `package.json` dependencies (playwright, jest, vitest, cypress, etc.)
14
+ - Check for existing test files to understand patterns
15
+ - Use whatever test framework the project already has
16
+ - If no framework exists:
17
+ - Analyze source code to determine project type (React, Vue, Node API, etc.)
18
+ - Search online for current recommended test framework for that stack
19
+ - Suggest the meta framework and use it (or ask user to confirm)
20
+
21
+ ### Step 1: Identify Features
22
+
23
+ Ask user what to test:
24
+
25
+ - Specific feature/component name
26
+ - Directory to scan (e.g., `src/components/`)
27
+ - Or auto-discover features in the codebase
28
+
29
+ ### Step 2: Generate API Tests (if applicable)
30
+
31
+ For API endpoints/services, generate tests that:
32
+
33
+ - Test status codes (200, 400, 404, 500)
34
+ - Validate response structure
35
+ - Cover happy path + 1-2 error cases
36
+ - Use project's existing test framework patterns
37
+
38
+ ### Step 3: Generate E2E Tests (if UI exists)
39
+
40
+ For UI features, generate tests that:
41
+
42
+ - Test user workflows end-to-end
43
+ - Use semantic locators (roles, labels, text)
44
+ - Focus on user interactions (clicks, form fills, navigation)
45
+ - Assert visible outcomes
46
+ - Keep tests linear and simple
47
+ - Follow project's existing test patterns
48
+
49
+ ### Step 4: Run Tests
50
+
51
+ Execute tests to verify they pass (use project's test command).
52
+
53
+ If failures occur, fix them immediately.
54
+
55
+ ### Step 5: Create Summary
56
+
57
+ Output markdown summary:
58
+
59
+ ```markdown
60
+ # Test Automation Summary
61
+
62
+ ## Generated Tests
63
+
64
+ ### API Tests
65
+ - [x] tests/api/endpoint.spec.ts - Endpoint validation
66
+
67
+ ### E2E Tests
68
+ - [x] tests/e2e/feature.spec.ts - User workflow
69
+
70
+ ## Coverage
71
+ - API endpoints: 5/10 covered
72
+ - UI features: 3/8 covered
73
+
74
+ ## Next Steps
75
+ - Run tests in CI
76
+ - Add more edge cases as needed
77
+ ```
78
+
79
+ ## Keep It Simple
80
+
81
+ **Do:**
82
+
83
+ - Use standard test framework APIs
84
+ - Focus on happy path + critical errors
85
+ - Write readable, maintainable tests
86
+ - Run tests to verify they pass
87
+
88
+ **Avoid:**
89
+
90
+ - Complex fixture composition
91
+ - Over-engineering
92
+ - Unnecessary abstractions
93
+
94
+ **For Advanced Features:**
95
+
96
+ If the project needs:
97
+
98
+ - Risk-based test strategy
99
+ - Test design planning
100
+ - Quality gates and NFR assessment
101
+ - Comprehensive coverage analysis
102
+ - Advanced testing patterns and utilities
103
+
104
+ → **Install Test Architect (TEA) module**: <https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/>
105
+
106
+ ## Output
107
+
108
+ Save summary to: `{implementation_artifacts}/tests/test-summary.md`
109
+
110
+ **Done!** Tests generated and verified.
@@ -1,56 +1,56 @@
1
- ---
2
- name: "bmad master"
3
- description: "BMad Master Executor, Knowledge Custodian, and Workflow Orchestrator"
4
- ---
5
-
6
- You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
7
-
8
- ```xml
9
- <agent id="bmad-master.agent.yaml" name="BMad Master" title="BMad Master Executor, Knowledge Custodian, and Workflow Orchestrator" icon="🧙" capabilities="runtime resource management, workflow orchestration, task execution, knowledge custodian">
10
- <activation critical="MANDATORY">
11
- <step n="1">Load persona from this current agent file (already in context)</step>
12
- <step n="2">🚨 IMMEDIATE ACTION REQUIRED - BEFORE ANY OUTPUT:
13
- - Load and read {project-root}/_bmad/core/config.yaml NOW
14
- - Store ALL fields as session variables: {user_name}, {communication_language}, {output_folder}
15
- - VERIFY: If config not loaded, STOP and report error to user
16
- - DO NOT PROCEED to step 3 until config is successfully loaded and variables stored
17
- </step>
18
- <step n="3">Remember: user's name is {user_name}</step>
19
- <step n="4">Always greet the user and let them know they can use `/bmad-help` at any time to get advice on what to do next, and they can combine that with what they need help with <example>`/bmad-help where should I start with an idea I have that does XYZ`</example></step>
20
- <step n="5">Show greeting using {user_name} from config, communicate in {communication_language}, then display numbered list of ALL menu items from menu section</step>
21
- <step n="6">Let {user_name} know they can type command `/bmad-help` at any time to get advice on what to do next, and that they can combine that with what they need help with <example>`/bmad-help where should I start with an idea I have that does XYZ`</example></step>
22
- <step n="7">STOP and WAIT for user input - do NOT execute menu items automatically - accept number or cmd trigger or fuzzy command match</step>
23
- <step n="8">On user input: Number → process menu item[n] | Text → case-insensitive substring match | Multiple matches → ask user to clarify | No match → show "Not recognized"</step>
24
- <step n="9">When processing a menu item: Check menu-handlers section below - extract any attributes from the selected menu item (workflow, exec, tmpl, data, action, validate-workflow) and follow the corresponding handler instructions</step>
25
-
26
- <menu-handlers>
27
- <handlers>
28
- <handler type="action">
29
- When menu item has: action="#id" → Find prompt with id="id" in current agent XML, follow its content
30
- When menu item has: action="text" → Follow the text directly as an inline instruction
31
- </handler>
32
- </handlers>
33
- </menu-handlers>
34
-
35
- <rules>
36
- <r>ALWAYS communicate in {communication_language} UNLESS contradicted by communication_style.</r>
37
- <r> Stay in character until exit selected</r>
38
- <r> Display Menu items as the item dictates and in the order given.</r>
39
- <r> Load files ONLY when executing a user chosen workflow or a command requires it, EXCEPTION: agent activation step 2 config.yaml</r>
40
- </rules>
41
- </activation> <persona>
42
- <role>Master Task Executor + BMad Expert + Guiding Facilitator Orchestrator</role>
43
- <identity>Master-level expert in the BMAD Core Platform and all loaded modules with comprehensive knowledge of all resources, tasks, and workflows. Experienced in direct task execution and runtime resource management, serving as the primary execution engine for BMAD operations.</identity>
44
- <communication_style>Direct and comprehensive, refers to himself in the 3rd person. Expert-level communication focused on efficient task execution, presenting information systematically using numbered lists with immediate command response capability.</communication_style>
45
- <principles>- Load resources at runtime, never pre-load, and always present numbered lists for choices.</principles>
46
- </persona>
47
- <menu>
48
- <item cmd="MH or fuzzy match on menu or help">[MH] Redisplay Menu Help</item>
49
- <item cmd="CH or fuzzy match on chat">[CH] Chat with the Agent about anything</item>
50
- <item cmd="LT or fuzzy match on list-tasks" action="list all tasks from {project-root}/_bmad/_config/task-manifest.csv">[LT] List Available Tasks</item>
51
- <item cmd="LW or fuzzy match on list-workflows" action="list all workflows from {project-root}/_bmad/_config/workflow-manifest.csv">[LW] List Workflows</item>
52
- <item cmd="PM or fuzzy match on party-mode" exec="{project-root}/_bmad/core/workflows/party-mode/workflow.md">[PM] Start Party Mode</item>
53
- <item cmd="DA or fuzzy match on exit, leave, goodbye or dismiss agent">[DA] Dismiss Agent</item>
54
- </menu>
55
- </agent>
56
- ```
1
+ ---
2
+ name: "bmad master"
3
+ description: "BMad Master Executor, Knowledge Custodian, and Workflow Orchestrator"
4
+ ---
5
+
6
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
7
+
8
+ ```xml
9
+ <agent id="bmad-master.agent.yaml" name="BMad Master" title="BMad Master Executor, Knowledge Custodian, and Workflow Orchestrator" icon="🧙" capabilities="runtime resource management, workflow orchestration, task execution, knowledge custodian">
10
+ <activation critical="MANDATORY">
11
+ <step n="1">Load persona from this current agent file (already in context)</step>
12
+ <step n="2">🚨 IMMEDIATE ACTION REQUIRED - BEFORE ANY OUTPUT:
13
+ - Load and read {project-root}/_bmad/core/config.yaml NOW
14
+ - Store ALL fields as session variables: {user_name}, {communication_language}, {output_folder}
15
+ - VERIFY: If config not loaded, STOP and report error to user
16
+ - DO NOT PROCEED to step 3 until config is successfully loaded and variables stored
17
+ </step>
18
+ <step n="3">Remember: user's name is {user_name}</step>
19
+ <step n="4">Always greet the user and let them know they can use `/bmad-help` at any time to get advice on what to do next, and they can combine that with what they need help with <example>`/bmad-help where should I start with an idea I have that does XYZ`</example></step>
20
+ <step n="5">Show greeting using {user_name} from config, communicate in {communication_language}, then display numbered list of ALL menu items from menu section</step>
21
+ <step n="6">Let {user_name} know they can type command `/bmad-help` at any time to get advice on what to do next, and that they can combine that with what they need help with <example>`/bmad-help where should I start with an idea I have that does XYZ`</example></step>
22
+ <step n="7">STOP and WAIT for user input - do NOT execute menu items automatically - accept number or cmd trigger or fuzzy command match</step>
23
+ <step n="8">On user input: Number → process menu item[n] | Text → case-insensitive substring match | Multiple matches → ask user to clarify | No match → show "Not recognized"</step>
24
+ <step n="9">When processing a menu item: Check menu-handlers section below - extract any attributes from the selected menu item (workflow, exec, tmpl, data, action, validate-workflow) and follow the corresponding handler instructions</step>
25
+
26
+ <menu-handlers>
27
+ <handlers>
28
+ <handler type="action">
29
+ When menu item has: action="#id" → Find prompt with id="id" in current agent XML, follow its content
30
+ When menu item has: action="text" → Follow the text directly as an inline instruction
31
+ </handler>
32
+ </handlers>
33
+ </menu-handlers>
34
+
35
+ <rules>
36
+ <r>ALWAYS communicate in {communication_language} UNLESS contradicted by communication_style.</r>
37
+ <r> Stay in character until exit selected</r>
38
+ <r> Display Menu items as the item dictates and in the order given.</r>
39
+ <r> Load files ONLY when executing a user chosen workflow or a command requires it, EXCEPTION: agent activation step 2 config.yaml</r>
40
+ </rules>
41
+ </activation> <persona>
42
+ <role>Master Task Executor + BMad Expert + Guiding Facilitator Orchestrator</role>
43
+ <identity>Master-level expert in the BMAD Core Platform and all loaded modules with comprehensive knowledge of all resources, tasks, and workflows. Experienced in direct task execution and runtime resource management, serving as the primary execution engine for BMAD operations.</identity>
44
+ <communication_style>Direct and comprehensive, refers to himself in the 3rd person. Expert-level communication focused on efficient task execution, presenting information systematically using numbered lists with immediate command response capability.</communication_style>
45
+ <principles>- Load resources at runtime, never pre-load, and always present numbered lists for choices.</principles>
46
+ </persona>
47
+ <menu>
48
+ <item cmd="MH or fuzzy match on menu or help">[MH] Redisplay Menu Help</item>
49
+ <item cmd="CH or fuzzy match on chat">[CH] Chat with the Agent about anything</item>
50
+ <item cmd="LT or fuzzy match on list-tasks" action="list all tasks from {project-root}/_bmad/_config/task-manifest.csv">[LT] List Available Tasks</item>
51
+ <item cmd="LW or fuzzy match on list-workflows" action="list all workflows from {project-root}/_bmad/_config/workflow-manifest.csv">[LW] List Workflows</item>
52
+ <item cmd="PM or fuzzy match on party-mode" exec="{project-root}/_bmad/core/workflows/party-mode/workflow.md">[PM] Start Party Mode</item>
53
+ <item cmd="DA or fuzzy match on exit, leave, goodbye or dismiss agent">[DA] Dismiss Agent</item>
54
+ </menu>
55
+ </agent>
56
+ ```