/cc-product:bmad — 7명의 전문가가 검토하는 작업 절차#
| 항목 | 내용 |
|---|---|
| 실행 명령 | /cc-product:bmad |
| 분류 | 워크플로우 |
| 난이도 | ●●● 높음 |
| MCP 서버 | zenhub |
한마디로#
중요한 작업을 시작할 때, 7명의 가상 전문가(분석가·기획자·아키텍트·디자이너 등)가 차례로 검토 도장을 찍어야 다음 단계로 넘어가는 작업 방식입니다. 공장의 품질 검사 라인처럼, 각 관문(Gate)을 통과하지 못하면 통과할 때까지 다시 고칩니다.
누가·언제 쓰나요#
- 새 기능, 버그 수정, 리팩터링 같은 작업을 처음 시작할 때
- 여러 전문가 관점의 검토가 꼭 필요한 복잡한 작업일 때
- 품질을 반드시 보장해야 하는 중요한 작업일 때
무엇을 해주나요#
작업을 4개 단계(분석 → 기획 → 설계 → 구현)로 나눠 진행하고, 각 단계마다 검토 관문을 통과시킵니다. 결과적으로:
- ZenHub에 이슈(Issue) 가 자동으로 만들어지고 스토리 포인트·라벨이 붙습니다.
- 작업용 브랜치가 만들어지고, 구현·테스트·린트·PR·리뷰·머지까지 진행됩니다.
-
진행 상황을 진행 현황판으로 보여주고, 관문에서 막히면 에러 코드(예:
BMAD_003)와 함께 무엇을 고쳐야 할지 알려줍니다. - 마지막에는 7명의 전문가 검토 결과, 통과한 관문 수, 테스트 결과를 정리한 완료 리포트가 나옵니다.
어떻게 쓰나요#
# 기본 사용 — 작업 내용을 적어 시작
/cc-product:bmad " Add author list screen "
# 기존 워크플로(/cc-dev:run)에 BMAD를 끼워 실행
/cc-dev:run --bmad " Add author list screen "
# 특정 관문만 활성화 (예: 분석·기획만)
/cc-product:bmad --gates analysis,planning " Simple task "
# 긴급 모드 (사용자 승인 필요, 관문 간소화)
/cc-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 MasterExecution 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), // 계약 블록 + 📄 링크 블록 (서술 20행 초과 시 발행)
// 발행은 createGitHubIssue 보다 먼저. Artifact 부재 시 전량 마크다운 폴백.
// SoT: cc-dev/rules/zenhub-conventions.md → Issue Body Artifact Contract
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
/cc-product:bmad " Add author list screen "Integration with Existing Workflow#
# Activate with --bmad option
/cc-dev:run --bmad " Add author list screen "Activate Specific Gates Only#
# Analysis and Planning gates only
/cc-product:bmad --gates analysis,planning " Simple task "Emergency Mode#
# Streamlined gates (requires user approval)
/cc-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
AskUserQuestiontool - 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_020error 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 `/cc-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 | ⬜ |
Related Commands#
/cc-product:review- Persona-specific review/cc-product:bmad-status- Status check/cc-product:gate- Gate verification/cc-dev:run- Existing workflow (without BMAD)/cc-dev:run --bmad- BMAD integrated workflow
Related Documents#
.claude/orchestrators/bmad-orchestrator.md- Orchestrator.claude/orchestrators/phase-gates.md- Gate definitions.claude/personas/- Persona definitions.claude/skills/bmad/SKILL.md- Skill details