BMAD-METHOD/AGENTS.md

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 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

  • 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)