feat(opencode): add OpenCode IDE integration support

- Add OpenCode to available IDE options in installer
- Implement JSON-only integration with schema compliance
- Generate compact AGENTS.md with file links (no embeds)
- Support both prefixed and non-prefixed agent names
- Ensure .bmad-core/core-config.yaml in instructions array

Enables OpenCode users to access BMAD agents through natural
language activation and configured commands.
This commit is contained in:
_rl_22_ 2025-09-16 18:15:21 -07:00
parent 007dace647
commit be8dd99ec6
2 changed files with 720 additions and 0 deletions

522
AGENTS.md Normal file
View File

@ -0,0 +1,522 @@
# Project Agents
This file provides guidance and memory for your coding CLI.
<!-- BEGIN: BMAD-AGENTS-OPENCODE -->
# BMAD-METHOD Agents and Tasks (OpenCode)
OpenCode reads AGENTS.md during initialization and uses it as part of its system prompt for the session. This section is auto-generated by BMAD-METHOD for OpenCode.
## How To Use With OpenCode
- Run `opencode` in this project. OpenCode will read `AGENTS.md` and your OpenCode config (opencode.json[c]).
- Reference a role naturally, e.g., "As dev, implement ..." or use commands defined in your BMAD tasks.
- Commit `.bmad-core` and `AGENTS.md` if you want teammates to share the same configuration.
- Refresh this section after BMAD updates: `npx bmad-method install -f -i opencode`.
### Helpful Commands
- List agents: `npx bmad-method list:agents`
- Reinstall BMAD core and regenerate this section: `npx bmad-method install -f -i opencode`
- Validate configuration: `npx bmad-method validate`
Note
- Orchestrators run as mode: primary; other agents as all.
- All agents have tools enabled: write, edit, bash.
## Agents
### Directory
| Title | ID | When To Use |
| -------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| UX Expert | ux-expert | Use for UI/UX design, wireframes, prototypes, front-end specifications, and user experience optimization |
| Scrum Master | sm | Use for story creation, epic management, retrospectives in party-mode, and agile process guidance |
| Test Architect & Quality Advisor | qa | Use for comprehensive test architecture review, quality gate decisions, and code improvement. Provides thorough analysis including requirements traceability, risk assessment, and test strategy. Advisory only - teams choose their quality bar. |
| Product Owner | po | Use for backlog management, story refinement, acceptance criteria, sprint planning, and prioritization decisions |
| Product Manager | pm | Use for creating PRDs, product strategy, feature prioritization, roadmap planning, and stakeholder communication |
| Full Stack Developer | dev | Use for code implementation, debugging, refactoring, and development best practices |
| BMad Master Orchestrator | bmad-orchestrator | Use for workflow coordination, multi-agent tasks, role switching guidance, and when unsure which specialist to consult |
| BMad Master Task Executor | bmad-master | Use when you need comprehensive expertise across all domains, running 1 off tasks that do not require a persona, or just wanting to use the same agent for many things. |
| Architect | architect | Use for system design, architecture documents, technology selection, API design, and infrastructure planning |
| Business Analyst | analyst | Use for market research, brainstorming, competitive analysis, creating project briefs, initial project discovery, and documenting existing projects (brownfield) |
### UX Expert (id: ux-expert)
Source: [.bmad-core/agents/ux-expert.md](.bmad-core/agents/ux-expert.md)
- When to use: Use for UI/UX design, wireframes, prototypes, front-end specifications, and user experience optimization
- How to activate: Mention "As ux-expert, ..." to get role-aligned behavior
- Full definition: open the source file above (content not embedded)
### Scrum Master (id: sm)
Source: [.bmad-core/agents/sm.md](.bmad-core/agents/sm.md)
- When to use: Use for story creation, epic management, retrospectives in party-mode, and agile process guidance
- How to activate: Mention "As sm, ..." to get role-aligned behavior
- Full definition: open the source file above (content not embedded)
### Test Architect & Quality Advisor (id: qa)
Source: [.bmad-core/agents/qa.md](.bmad-core/agents/qa.md)
- When to use: Use for comprehensive test architecture review, quality gate decisions, and code improvement. Provides thorough analysis including requirements traceability, risk assessment, and test strategy. Advisory only - teams choose their quality bar.
- How to activate: Mention "As qa, ..." to get role-aligned behavior
- Full definition: open the source file above (content not embedded)
### Product Owner (id: po)
Source: [.bmad-core/agents/po.md](.bmad-core/agents/po.md)
- When to use: Use for backlog management, story refinement, acceptance criteria, sprint planning, and prioritization decisions
- How to activate: Mention "As po, ..." to get role-aligned behavior
- Full definition: open the source file above (content not embedded)
### Product Manager (id: pm)
Source: [.bmad-core/agents/pm.md](.bmad-core/agents/pm.md)
- When to use: Use for creating PRDs, product strategy, feature prioritization, roadmap planning, and stakeholder communication
- How to activate: Mention "As pm, ..." to get role-aligned behavior
- Full definition: open the source file above (content not embedded)
### Full Stack Developer (id: dev)
Source: [.bmad-core/agents/dev.md](.bmad-core/agents/dev.md)
- When to use: Use for code implementation, debugging, refactoring, and development best practices
- How to activate: Mention "As dev, ..." to get role-aligned behavior
- Full definition: open the source file above (content not embedded)
### BMad Master Orchestrator (id: bmad-orchestrator)
Source: [.bmad-core/agents/bmad-orchestrator.md](.bmad-core/agents/bmad-orchestrator.md)
- When to use: Use for workflow coordination, multi-agent tasks, role switching guidance, and when unsure which specialist to consult
- How to activate: Mention "As bmad-orchestrator, ..." to get role-aligned behavior
- Full definition: open the source file above (content not embedded)
### BMad Master Task Executor (id: bmad-master)
Source: [.bmad-core/agents/bmad-master.md](.bmad-core/agents/bmad-master.md)
- When to use: Use when you need comprehensive expertise across all domains, running 1 off tasks that do not require a persona, or just wanting to use the same agent for many things.
- How to activate: Mention "As bmad-master, ..." to get role-aligned behavior
- Full definition: open the source file above (content not embedded)
### Architect (id: architect)
Source: [.bmad-core/agents/architect.md](.bmad-core/agents/architect.md)
- When to use: Use for system design, architecture documents, technology selection, API design, and infrastructure planning
- How to activate: Mention "As architect, ..." to get role-aligned behavior
- Full definition: open the source file above (content not embedded)
### Business Analyst (id: analyst)
Source: [.bmad-core/agents/analyst.md](.bmad-core/agents/analyst.md)
- When to use: Use for market research, brainstorming, competitive analysis, creating project briefs, initial project discovery, and documenting existing projects (brownfield)
- How to activate: Mention "As analyst, ..." to get role-aligned behavior
- Full definition: open the source file above (content not embedded)
## Tasks
These are reusable task briefs; use the paths to open them as needed.
### Task: validate-next-story
Source: [.bmad-core/tasks/validate-next-story.md](.bmad-core/tasks/validate-next-story.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: trace-requirements
Source: [.bmad-core/tasks/trace-requirements.md](.bmad-core/tasks/trace-requirements.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: test-design
Source: [.bmad-core/tasks/test-design.md](.bmad-core/tasks/test-design.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: shard-doc
Source: [.bmad-core/tasks/shard-doc.md](.bmad-core/tasks/shard-doc.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: risk-profile
Source: [.bmad-core/tasks/risk-profile.md](.bmad-core/tasks/risk-profile.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: review-story
Source: [.bmad-core/tasks/review-story.md](.bmad-core/tasks/review-story.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: qa-gate
Source: [.bmad-core/tasks/qa-gate.md](.bmad-core/tasks/qa-gate.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: nfr-assess
Source: [.bmad-core/tasks/nfr-assess.md](.bmad-core/tasks/nfr-assess.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: kb-mode-interaction
Source: [.bmad-core/tasks/kb-mode-interaction.md](.bmad-core/tasks/kb-mode-interaction.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: index-docs
Source: [.bmad-core/tasks/index-docs.md](.bmad-core/tasks/index-docs.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: generate-ai-frontend-prompt
Source: [.bmad-core/tasks/generate-ai-frontend-prompt.md](.bmad-core/tasks/generate-ai-frontend-prompt.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: facilitate-brainstorming-session
Source: [.bmad-core/tasks/facilitate-brainstorming-session.md](.bmad-core/tasks/facilitate-brainstorming-session.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: execute-checklist
Source: [.bmad-core/tasks/execute-checklist.md](.bmad-core/tasks/execute-checklist.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: document-project
Source: [.bmad-core/tasks/document-project.md](.bmad-core/tasks/document-project.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: create-next-story
Source: [.bmad-core/tasks/create-next-story.md](.bmad-core/tasks/create-next-story.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: create-doc
Source: [.bmad-core/tasks/create-doc.md](.bmad-core/tasks/create-doc.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: create-deep-research-prompt
Source: [.bmad-core/tasks/create-deep-research-prompt.md](.bmad-core/tasks/create-deep-research-prompt.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: create-brownfield-story
Source: [.bmad-core/tasks/create-brownfield-story.md](.bmad-core/tasks/create-brownfield-story.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: correct-course
Source: [.bmad-core/tasks/correct-course.md](.bmad-core/tasks/correct-course.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: brownfield-create-story
Source: [.bmad-core/tasks/brownfield-create-story.md](.bmad-core/tasks/brownfield-create-story.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: brownfield-create-epic
Source: [.bmad-core/tasks/brownfield-create-epic.md](.bmad-core/tasks/brownfield-create-epic.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: apply-qa-fixes
Source: [.bmad-core/tasks/apply-qa-fixes.md](.bmad-core/tasks/apply-qa-fixes.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: advanced-elicitation
Source: [.bmad-core/tasks/advanced-elicitation.md](.bmad-core/tasks/advanced-elicitation.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: validate-infrastructure
Source: [expansion-packs/bmad-infrastructure-devops/tasks/validate-infrastructure.md](expansion-packs/bmad-infrastructure-devops/tasks/validate-infrastructure.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: review-infrastructure
Source: [expansion-packs/bmad-infrastructure-devops/tasks/review-infrastructure.md](expansion-packs/bmad-infrastructure-devops/tasks/review-infrastructure.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: validate-game-story
Source: [expansion-packs/bmad-godot-game-dev/tasks/validate-game-story.md](expansion-packs/bmad-godot-game-dev/tasks/validate-game-story.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: review-game-story
Source: [expansion-packs/bmad-godot-game-dev/tasks/review-game-story.md](expansion-packs/bmad-godot-game-dev/tasks/review-game-story.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: game-test-design
Source: [expansion-packs/bmad-godot-game-dev/tasks/game-test-design.md](expansion-packs/bmad-godot-game-dev/tasks/game-test-design.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: game-risk-profile
Source: [expansion-packs/bmad-godot-game-dev/tasks/game-risk-profile.md](expansion-packs/bmad-godot-game-dev/tasks/game-risk-profile.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: game-design-brainstorming
Source: [expansion-packs/bmad-godot-game-dev/tasks/game-design-brainstorming.md](expansion-packs/bmad-godot-game-dev/tasks/game-design-brainstorming.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: game-brownfield-create-story
Source: [expansion-packs/bmad-godot-game-dev/tasks/game-brownfield-create-story.md](expansion-packs/bmad-godot-game-dev/tasks/game-brownfield-create-story.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: game-brownfield-create-epic
Source: [expansion-packs/bmad-godot-game-dev/tasks/game-brownfield-create-epic.md](expansion-packs/bmad-godot-game-dev/tasks/game-brownfield-create-epic.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: create-game-story
Source: [expansion-packs/bmad-godot-game-dev/tasks/create-game-story.md](expansion-packs/bmad-godot-game-dev/tasks/create-game-story.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: correct-course-game
Source: [expansion-packs/bmad-godot-game-dev/tasks/correct-course-game.md](expansion-packs/bmad-godot-game-dev/tasks/correct-course-game.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: workshop-dialog
Source: [expansion-packs/bmad-creative-writing/tasks/workshop-dialog.md](expansion-packs/bmad-creative-writing/tasks/workshop-dialog.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: select-next-arc
Source: [expansion-packs/bmad-creative-writing/tasks/select-next-arc.md](expansion-packs/bmad-creative-writing/tasks/select-next-arc.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: quick-feedback
Source: [expansion-packs/bmad-creative-writing/tasks/quick-feedback.md](expansion-packs/bmad-creative-writing/tasks/quick-feedback.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: publish-chapter
Source: [expansion-packs/bmad-creative-writing/tasks/publish-chapter.md](expansion-packs/bmad-creative-writing/tasks/publish-chapter.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: provide-feedback
Source: [expansion-packs/bmad-creative-writing/tasks/provide-feedback.md](expansion-packs/bmad-creative-writing/tasks/provide-feedback.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: outline-scenes
Source: [expansion-packs/bmad-creative-writing/tasks/outline-scenes.md](expansion-packs/bmad-creative-writing/tasks/outline-scenes.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: incorporate-feedback
Source: [expansion-packs/bmad-creative-writing/tasks/incorporate-feedback.md](expansion-packs/bmad-creative-writing/tasks/incorporate-feedback.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: generate-scene-list
Source: [expansion-packs/bmad-creative-writing/tasks/generate-scene-list.md](expansion-packs/bmad-creative-writing/tasks/generate-scene-list.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: generate-cover-prompts
Source: [expansion-packs/bmad-creative-writing/tasks/generate-cover-prompts.md](expansion-packs/bmad-creative-writing/tasks/generate-cover-prompts.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: generate-cover-brief
Source: [expansion-packs/bmad-creative-writing/tasks/generate-cover-brief.md](expansion-packs/bmad-creative-writing/tasks/generate-cover-brief.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: final-polish
Source: [expansion-packs/bmad-creative-writing/tasks/final-polish.md](expansion-packs/bmad-creative-writing/tasks/final-polish.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: expand-synopsis
Source: [expansion-packs/bmad-creative-writing/tasks/expand-synopsis.md](expansion-packs/bmad-creative-writing/tasks/expand-synopsis.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: expand-premise
Source: [expansion-packs/bmad-creative-writing/tasks/expand-premise.md](expansion-packs/bmad-creative-writing/tasks/expand-premise.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: develop-character
Source: [expansion-packs/bmad-creative-writing/tasks/develop-character.md](expansion-packs/bmad-creative-writing/tasks/develop-character.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: critical-review
Source: [expansion-packs/bmad-creative-writing/tasks/critical-review.md](expansion-packs/bmad-creative-writing/tasks/critical-review.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: create-draft-section
Source: [expansion-packs/bmad-creative-writing/tasks/create-draft-section.md](expansion-packs/bmad-creative-writing/tasks/create-draft-section.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: character-depth-pass
Source: [expansion-packs/bmad-creative-writing/tasks/character-depth-pass.md](expansion-packs/bmad-creative-writing/tasks/character-depth-pass.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: build-world
Source: [expansion-packs/bmad-creative-writing/tasks/build-world.md](expansion-packs/bmad-creative-writing/tasks/build-world.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: brainstorm-premise
Source: [expansion-packs/bmad-creative-writing/tasks/brainstorm-premise.md](expansion-packs/bmad-creative-writing/tasks/brainstorm-premise.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: assemble-kdp-package
Source: [expansion-packs/bmad-creative-writing/tasks/assemble-kdp-package.md](expansion-packs/bmad-creative-writing/tasks/assemble-kdp-package.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: analyze-story-structure
Source: [expansion-packs/bmad-creative-writing/tasks/analyze-story-structure.md](expansion-packs/bmad-creative-writing/tasks/analyze-story-structure.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
### Task: analyze-reader-feedback
Source: [expansion-packs/bmad-creative-writing/tasks/analyze-reader-feedback.md](expansion-packs/bmad-creative-writing/tasks/analyze-reader-feedback.md)
- How to use: Reference the task in your prompt or execute via your configured commands.
- Full brief: open the source file above (content not embedded)
<!-- END: BMAD-AGENTS-OPENCODE -->

198
opencode.jsonc Normal file
View File

@ -0,0 +1,198 @@
{
"$schema": "https://opencode.ai/config.json",
"instructions": [
".bmad-core/core-config.yaml"
],
"agent": {
"bmad-ux-expert": {
"prompt": "{file:./.bmad-core/agents/ux-expert.md}",
"mode": "all",
"tools": {
"write": true,
"edit": true,
"bash": true
},
"description": "Use for UI/UX design, wireframes, prototypes, front-end specifications, and user experience optimization"
},
"bmad-sm": {
"prompt": "{file:./.bmad-core/agents/sm.md}",
"mode": "all",
"tools": {
"write": true,
"edit": true,
"bash": true
},
"description": "Use for story creation, epic management, retrospectives in party-mode, and agile process guidance"
},
"bmad-qa": {
"prompt": "{file:./.bmad-core/agents/qa.md}",
"mode": "all",
"tools": {
"write": true,
"edit": true,
"bash": true
},
"description": "Use for comprehensive test architecture review, quality gate decisions, and code improvement. Provides thorough analysis including requirements traceability, risk assessment, and test strategy. Advisory only - teams choose their quality bar."
},
"bmad-po": {
"prompt": "{file:./.bmad-core/agents/po.md}",
"mode": "all",
"tools": {
"write": true,
"edit": true,
"bash": true
},
"description": "Use for backlog management, story refinement, acceptance criteria, sprint planning, and prioritization decisions"
},
"bmad-pm": {
"prompt": "{file:./.bmad-core/agents/pm.md}",
"mode": "all",
"tools": {
"write": true,
"edit": true,
"bash": true
},
"description": "Use for creating PRDs, product strategy, feature prioritization, roadmap planning, and stakeholder communication"
},
"bmad-dev": {
"prompt": "{file:./.bmad-core/agents/dev.md}",
"mode": "all",
"tools": {
"write": true,
"edit": true,
"bash": true
},
"description": "'Use for code implementation, debugging, refactoring, and development best practices'"
},
"bmad-orchestrator": {
"prompt": "{file:./.bmad-core/agents/bmad-orchestrator.md}",
"mode": "primary",
"tools": {
"write": true,
"edit": true,
"bash": true
},
"description": "Use for workflow coordination, multi-agent tasks, role switching guidance, and when unsure which specialist to consult"
},
"bmad-master": {
"prompt": "{file:./.bmad-core/agents/bmad-master.md}",
"mode": "all",
"tools": {
"write": true,
"edit": true,
"bash": true
},
"description": "Use when you need comprehensive expertise across all domains, running 1 off tasks that do not require a persona, or just wanting to use the same agent for many things."
},
"bmad-architect": {
"prompt": "{file:./.bmad-core/agents/architect.md}",
"mode": "all",
"tools": {
"write": true,
"edit": true,
"bash": true
},
"description": "Use for system design, architecture documents, technology selection, API design, and infrastructure planning"
},
"bmad-analyst": {
"prompt": "{file:./.bmad-core/agents/analyst.md}",
"mode": "all",
"tools": {
"write": true,
"edit": true,
"bash": true
},
"description": "Use for market research, brainstorming, competitive analysis, creating project briefs, initial project discovery, and documenting existing projects (brownfield)"
}
},
"command": {
"bmad:tasks:validate-next-story": {
"template": "{file:./.bmad-core/tasks/validate-next-story.md}",
"description": "To comprehensively validate a story draft before implementation begins, ensuring it is complete, accurate, and provides sufficient context for successful development. This task identifies issues and gaps that need to be addressed, preventing hallucinations and ensuring implementation readiness."
},
"bmad:tasks:trace-requirements": {
"template": "{file:./.bmad-core/tasks/trace-requirements.md}",
"description": "Create a requirements traceability matrix that ensures every acceptance criterion has corresponding test coverage. This task helps identify gaps in testing and ensures all requirements are validated."
},
"bmad:tasks:test-design": {
"template": "{file:./.bmad-core/tasks/test-design.md}",
"description": "Design a complete test strategy that identifies what to test, at which level (unit/integration/e2e), and why. This ensures efficient test coverage without redundancy while maintaining appropriate test boundaries."
},
"bmad:tasks:shard-doc": {
"template": "{file:./.bmad-core/tasks/shard-doc.md}",
"description": "Split a large document into multiple smaller documents based on level 2 sections Create a folder structure to organize the sharded documents Maintain all content integrity including code blocks, diagrams, and markdown formatting"
},
"bmad:tasks:risk-profile": {
"template": "{file:./.bmad-core/tasks/risk-profile.md}",
"description": "Identify, assess, and prioritize risks in the story implementation. Provide risk mitigation strategies and testing focus areas based on risk levels."
},
"bmad:tasks:review-story": {
"template": "{file:./.bmad-core/tasks/review-story.md}"
},
"bmad:tasks:qa-gate": {
"template": "{file:./.bmad-core/tasks/qa-gate.md}",
"description": "Generate a standalone quality gate file that provides a clear pass/fail decision with actionable feedback. This gate serves as an advisory checkpoint for teams to understand quality status."
},
"bmad:tasks:nfr-assess": {
"template": "{file:./.bmad-core/tasks/nfr-assess.md}",
"description": "Assess non-functional requirements for a story and generate:"
},
"bmad:tasks:kb-mode-interaction": {
"template": "{file:./.bmad-core/tasks/kb-mode-interaction.md}",
"description": "Provide a user-friendly interface to the BMad knowledge base without overwhelming users with information upfront."
},
"bmad:tasks:index-docs": {
"template": "{file:./.bmad-core/tasks/index-docs.md}",
"description": "This task maintains the integrity and completeness of the docs/index.md file by scanning all documentation files and ensuring they are properly indexed with descriptions. It handles both root-level documents and documents within subfolders, organizing them hierarchically."
},
"bmad:tasks:generate-ai-frontend-prompt": {
"template": "{file:./.bmad-core/tasks/generate-ai-frontend-prompt.md}",
"description": "To generate a masterful, comprehensive, and optimized prompt that can be used with any AI-driven frontend development tool (e.g., Vercel v0, Lovable.ai, or similar) to scaffold or generate significant portions of a frontend application."
},
"bmad:tasks:facilitate-brainstorming-session": {
"template": "{file:./.bmad-core/tasks/facilitate-brainstorming-session.md}"
},
"bmad:tasks:execute-checklist": {
"template": "{file:./.bmad-core/tasks/execute-checklist.md}"
},
"bmad:tasks:document-project": {
"template": "{file:./.bmad-core/tasks/document-project.md}",
"description": "Generate comprehensive documentation for existing projects optimized for AI development agents. This task creates structured reference materials that enable AI agents to understand project context, conventions, and patterns for effective contribution to any codebase."
},
"bmad:tasks:create-next-story": {
"template": "{file:./.bmad-core/tasks/create-next-story.md}",
"description": "To identify the next logical story based on project progress and epic definitions, and then to prepare a comprehensive, self-contained, and actionable story file using the Story Template."
},
"bmad:tasks:create-doc": {
"template": "{file:./.bmad-core/tasks/create-doc.md}"
},
"bmad:tasks:create-deep-research-prompt": {
"template": "{file:./.bmad-core/tasks/create-deep-research-prompt.md}",
"description": "Generate well-structured research prompts that:"
},
"bmad:tasks:create-brownfield-story": {
"template": "{file:./.bmad-core/tasks/create-brownfield-story.md}",
"description": "Create detailed, implementation-ready stories for brownfield projects where traditional sharded PRD/architecture documents may not exist. This task bridges the gap between various documentation formats (document-project output, brownfield PRDs, epics, or user documentation) and executable stories for the Dev agent."
},
"bmad:tasks:correct-course": {
"template": "{file:./.bmad-core/tasks/correct-course.md}",
"description": "Guide a structured response to a change trigger using the .bmad-core/checklists/change-checklist."
},
"bmad:tasks:brownfield-create-story": {
"template": "{file:./.bmad-core/tasks/brownfield-create-story.md}",
"description": "Create a single user story for very small brownfield enhancements that can be completed in one focused development session. This task is for minimal additions or bug fixes that require existing system integration awareness."
},
"bmad:tasks:brownfield-create-epic": {
"template": "{file:./.bmad-core/tasks/brownfield-create-epic.md}",
"description": "Create a single epic for smaller brownfield enhancements that don't require the full PRD and Architecture documentation process. This task is for isolated features or modifications that can be completed within a focused scope."
},
"bmad:tasks:apply-qa-fixes": {
"template": "{file:./.bmad-core/tasks/apply-qa-fixes.md}",
"description": "Read QA outputs for a story (gate YAML + assessment markdowns) Create a prioritized, deterministic fix plan Apply code and test changes to close gaps and address issues Update only the allowed story sections for the Dev agent"
},
"bmad:tasks:advanced-elicitation": {
"template": "{file:./.bmad-core/tasks/advanced-elicitation.md}",
"description": "Provide optional reflective and brainstorming actions to enhance content quality Enable deeper exploration of ideas through structured elicitation techniques Support iterative refinement through multiple analytical perspectives Usable during template-driven document creation or any chat conversation"
}
}
}