25 KiB
Project Agents
This file provides guidance and memory for your coding CLI.
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
opencodein this project. OpenCode will readAGENTS.mdand 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-coreandAGENTS.mdif 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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)