product:bmad

Execute BMAD framework-based workflow

항목	내용
Invoke	/product:bmad
Category	workflow
Complexity	high
MCP Servers	zenhub

/product:bmad — 7명의 전문가가 검토하는 작업 절차#

한마디로#

중요한 작업을 시작할 때, 7명의 가상 전문가(분석가·기획자·아키텍트·디자이너 등)가 차례로 검토 도장을 찍어야 다음 단계로 넘어가는 작업 방식입니다. 공장의 품질 검사 라인처럼, 각 관문(Gate)을 통과하지 못하면 통과할 때까지 다시 고칩니다.

누가·언제 쓰나요#

새 기능, 버그 수정, 리팩터링 같은 작업을 처음 시작할 때
여러 전문가 관점의 검토가 꼭 필요한 복잡한 작업일 때
품질을 반드시 보장해야 하는 중요한 작업일 때

무엇을 해주나요#

작업을 4개 단계(분석 → 기획 → 설계 → 구현)로 나눠 진행하고, 각 단계마다 검토 관문을 통과시킵니다. 결과적으로:

ZenHub에 이슈(Issue) 가 자동으로 만들어지고 스토리 포인트·라벨이 붙습니다.
작업용 브랜치가 만들어지고, 구현·테스트·린트·PR·리뷰·머지까지 진행됩니다.
진행 상황을 진행 현황판으로 보여주고, 관문에서 막히면 에러 코드(예: BMAD_003)와 함께 무엇을 고쳐야 할지 알려줍니다.
마지막에는 7명의 전문가 검토 결과, 통과한 관문 수, 테스트 결과를 정리한 완료 리포트가 나옵니다.

어떻게 쓰나요#

# 기본 사용 — 작업 내용을 적어 시작
/product:bmad  " Add author list screen " 

 # 기존 워크플로(/dev:run)에 BMAD를 끼워 실행
/dev:run --bmad  " Add author list screen " 

 # 특정 관문만 활성화 (예: 분석·기획만)
/product:bmad --gates analysis,planning  " Simple task " 

 # 긴급 모드 (사용자 승인 필요, 관문 간소화)
/product:bmad --emergency  " Production emergency fix "

--gates : 원하는 관문만 골라 실행합니다.
--emergency : 운영 장애 같은 긴급 상황에서 관문을 간소화합니다(완전 생략은 아니며, 완료 후 48시간 내 사후 리뷰가 필수).
--no-parallel : 병렬 실행을 끕니다.
--skip-persona : 특정 전문가 검토를 건너뜁니다.

안에서 무슨 일이 벌어지나요#

작업은 정해진 순서대로 4단계를 거치며, 각 단계의 검토를 통과해야만 다음으로 넘어갑니다.

분석(Analysis) — 분석가 관점에서 요구사항이 명확한지, 작업 범위가 적절한지, 합격 기준이 검증 가능한지 확인합니다.
기획(Planning) — 기획자 관점에서 Epic/Story 구조를 잡고 ZenHub에 이슈를 만들며, 스토리 포인트와 라벨을 붙입니다.
설계(Solutioning) — 아키텍트와 UX 디자이너가 동시에 검토합니다. 둘 다 통과해야 다음으로 갑니다.
구현(Implementation) — 브랜치를 만들고 이슈를 진행 중으로 옮긴 뒤, 구현·테스트·린트·PR·리뷰·머지를 진행합니다. (린트와 테스트 관문은 항상 필수입니다.)

⚙️ 상세 옵션·실행 명세 (개발자 / AI 에이전트용)

Required Execution Protocol#

Important: BMAD workflows must pass mandatory gates across 4 phases.

Phase Execution Order#

Phase 1: ANALYSIS     → Analyst review
Phase 2: PLANNING     → PM review
Phase 3: SOLUTIONING  → Architect + UX Designer review (parallel)
Phase 4: IMPLEMENTATION → Flutter/Backend Dev + Scrum Master

Execution by Phase#

Phase 1: Analysis

// 💡 Conceptual pseudocode (Claude actually performs review as the Analyst persona)
const analysisResult = await analyzeRequirements({
  input: workContent,
  checks: [ " requirementClarity " ,  " scopeAppropriateness " ,  " acTestability " ],
});

if (!analysisResult.pass) {
  // Provide feedback and request revision
  return requestRevision(analysisResult.feedback);
}

Phase 2: Planning

// 💡 Actual MCP tool call example (Claude executes as the PM persona)
// Dynamic workspace info lookup
const workspace = await mcp__zenhub__getWorkspacePipelinesAndRepositories();
const repoId = workspace.githubRepositories.find(r = >   /* GitHub repo selection */)?.id;  // 필드명: githubRepositories
const issueTypes = await mcp__zenhub__getIssueTypes();
const backlog = workspace.pipelines.find(p = >   p.name ===  " Product Backlog " );

const issue = await mcp__zenhub__createGitHubIssue({
  repositoryId: repoId,
  title: `${type}(${scope}): ${gitmoji} ${description}`,
  body: generateIssueBody(analysisResult),
  issueTypeId: issueTypes.find(t = >   t.name === type).id,
  labels: [type, scope],
});

await mcp__zenhub__setIssueEstimate({
  issueId: issue.id,
  estimate: storyPoint,
});

await mcp__zenhub__moveIssueToPipeline({
  issueId: issue.graphqlId,
  pipelineId: backlog.id,
});

Phase 3: Solutioning (parallel)

architect-review / ux-designer-review 는 호스트 프로젝트 .claude/personas/ 가 공급하는 런타임 페르소나다(이 플러그인 미배포). 부재 시 cc-product SKILL(architect, ux-designer)로 degrade — 미존재 Task 결과를 PASS 로 간주 금지. (bmad-orchestrator.md 참조)

// 💡 Conceptual pseudocode (Claude actually calls Task tool in parallel)
const [architectResult, uxResult] = await Promise.all([
  Task({
    subagent_type:  " architect-review " ,
    prompt: `Architecture review: ${issue.title}`,
  }),
  Task({
    subagent_type:  " ux-designer-review " ,
    prompt: `UX review: ${issue.title}`,
  }),
]);

// All reviews must pass
if (!architectResult.pass || !uxResult.pass) {
  return requestRevision(combineFeedback(architectResult, uxResult));
}

Phase 4: Implementation

# Execute existing workflow Steps 4-12
# Create branch
git checkout development  & &   git pull origin development
git checkout -b feature/issue-${issue.number}-${slug}

# Move to In Progress
mcp__zenhub__moveIssueToPipeline(...)

# Implement, test, lint, PR, review, merge
# (same flow as the existing workflow)

Triggers#

When starting a new feature/bug/refactoring task
For complex tasks requiring persona-based review
For critical tasks requiring quality gates

Usage#

Basic Usage#

# Start BMAD workflow
/product:bmad  " Add author list screen "

Integration with Existing Workflow#

# Activate with --bmad option
/dev:run --bmad  " Add author list screen "

Activate Specific Gates Only#

# Analysis and Planning gates only
/product:bmad --gates analysis,planning  " Simple task "

Emergency Mode#

# Streamlined gates (requires user approval)
/product:bmad --emergency  " Production emergency fix "

Emergency Mode Approval Procedure:

// Claude requests explicit approval via AskUserQuestion tool
AskUserQuestion({
  questions: [{
    header:  " Emergency " ,
    question:  " Do you want to activate emergency mode? This will streamline the Analysis/Planning gates. " ,
    options: [
      { label:  " Yes, approved " , description:  " Activate emergency mode (post-review required within 48 hours) "   },
      { label:  " No " , description:  " Proceed in normal mode "   }
    ],
    multiSelect: false
  }]
});

Approval Request: Claude requests explicit approval via AskUserQuestion tool
User Selection: Proceed only when "Yes, approved" is selected
Gate Streamlining: Analysis, Planning gates are streamlined (not fully skipped)
Mandatory Gates: Implementation gate is always mandatory (lint, tests)
Post-Review: Post-review is required within 48 hours of completion (see BMAD_020 error code)

Parameters#

Parameter	Required	Description	Example
`task description`	✅	Description of the task	`"Add author list screen"`

Options#

Option	Default	Description
`--gates`	All gates	Activate specific gates only
`--emergency`	false	Emergency mode (streamlined gates)
`--no-parallel`	false	Disable parallel execution
`--skip-persona`	-	Skip specific persona

Output Format#

Progress#

╔════════════════════════════════════════════════════════════════╗
║  BMAD Workflow:  " Add author list screen "                             ║
╠════════════════════════════════════════════════════════════════╣
║                                                                ║
║  Phase 1: ANALYSIS ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ✅         ║
║  ├── 🔍 Analyst review                                           ║
║  │   ├── ✅ Requirements clarity                                     ║
║  │   ├── ✅ Scope appropriateness                                       ║
║  │   └── ✅ Acceptance Criteria testability                    ║
║  └── 📋 Result: Approved (3 Acceptance Criteria confirmed)               ║
║                                                                ║
║  Phase 2: PLANNING ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ✅          ║
║  ├── 📝 PM review                                                ║
║  │   ├── ✅ Epic/Story structure                                    ║
║  │   ├── ✅ Story Point: 5                                     ║
║  │   └── ✅ Dependencies: None                                       ║
║  └── 📋 Result: Issue #1810 created                                 ║
║                                                                ║
║  Phase 3: SOLUTIONING ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🔄         ║
║  ├── 🏗️ Architect review (parallel)                                  ║
║  │   └── 🔄 Reviewing...                                         ║
║  └── 🎨 UX Designer review (parallel)                                ║
║      └── ✅ Complete                                                ║
║                                                                ║
║  Phase 4: IMPLEMENTATION ━━━━━━━━━━━━━━━━━━━━━━━━━━ ⏳         ║
║  └── Waiting                                                   ║
║                                                                ║
╚════════════════════════════════════════════════════════════════╝

Gate Failure (with error code)#

╔════════════════════════════════════════════════════════════════╗
║  BMAD Gate Failed: BMAD_003                                    ║
╠════════════════════════════════════════════════════════════════╣
║                                                                ║
║  Phase 3: SOLUTIONING ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ❌         ║
║  ├── 🏗️ Architect review: ❌ FAILED                            ║
║  │   ├── ❌ DI structure: BLoC directly accesses Repository    ║
║  │   ├── 📋 Required action: Create UseCase, change dependency ║
║  │   └── 🔄 Retry: 1/3                                        ║
║  └── 🎨 UX Designer review: ✅ PASSED                          ║
║                                                                ║
║  💡 Fix: Apply feedback, then `/product:review --persona architect`║
║                                                                ║
╚════════════════════════════════════════════════════════════════╝

Completion#

╔════════════════════════════════════════════════════════════════╗
║  BMAD Workflow Complete:  " Add author list screen "                    ║
╠════════════════════════════════════════════════════════════════╣
║                                                                ║
║  📋 Issue: #1810 - Add author list screen                         ║
║  🔀 PR: #1815                                                  ║
║  🌿 Branch: feature/1810-author-list (deleted)                 ║
║                                                                ║
║  ✅ Persona review: 7/7 passed                                     ║
║  ✅ Gates passed: 4/4 phases                                     ║
║  ✅ Tests: 25/25 passed                                         ║
║                                                                ║
║  🏁 Final State: CLOSED                                        ║
║                                                                ║
╚════════════════════════════════════════════════════════════════╝

Self-Verification Checklist#

Phase	Gate	Done
Analysis	Requirements clarity	⬜
Analysis	Scope appropriateness	⬜
Analysis	Acceptance Criteria testability	⬜
Planning	Epic/Story structure	⬜
Planning	Story Point (1-8)	⬜
Planning	Labeling	⬜
Planning	Dependencies	⬜
Solutioning	Clean Architecture	⬜
Solutioning	DI structure	⬜
Solutioning	CoUI compliance	⬜
Implementation	Branch rules	⬜
Implementation	Lint pass	⬜
Implementation	Test pass	⬜
Implementation	Code review	⬜

/product:review - Persona-specific review
/product:bmad-status - Status check
/product:gate - Gate verification
/dev:run - Existing workflow (without BMAD)
/dev:run --bmad - BMAD integrated workflow

.claude/orchestrators/bmad-orchestrator.md - Orchestrator
.claude/orchestrators/phase-gates.md - Gate definitions
.claude/personas/ - Persona definitions
.claude/skills/bmad/SKILL.md - Skill details