# 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](.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)