BMAD Reference#

BMAD 프레임워크의 상세 참조 문서입니다.

페르소나 상세#

Analyst (분석가)#

파일: .claude/personas/analyst.md

Product Manager (PM)#

파일: .claude/personas/product-manager.md

Architect (아키텍트)#

파일: .claude/personas/architect.md

UX Designer (UX 디자이너)#

파일: .claude/personas/ux-designer.md

Flutter Developer (Flutter 개발자)#

파일: .claude/personas/flutter-developer.md

Backend Developer (백엔드 개발자)#

파일: .claude/personas/backend-developer.md

Scrum Master (스크럼 마스터)#

파일: .claude/personas/scrum-master.md

게이트 상세#

Analysis Gate#

gate: analysis
persona: analyst
required_checks:
  - requirement_clarity:
      description: "요구사항이 구체적이고 측정 가능한가?"
      failure_action: "요구사항 재정의"
  - scope_appropriateness:
      description: "단일 이슈로 적절한 크기인가?"
      failure_action: "분할 또는 조정"
  - ac_testability:
      description: "AC가 자동 테스트 가능한가?"
      failure_action: "AC 수정"

Planning Gate#

gate: planning
persona: product-manager
required_checks:
  - epic_story_structure:
      description: "적절한 계층 구조인가?"
      failure_action: "구조 재설계"
  - story_point:
      description: "1-8 SP 범위인가?"
      failure_action: "재산정 또는 분할"
      threshold:
        min: 1
        max: 8
        split_required: 13
  - labeling:
      description: "Type, Scope 라벨이 있는가?"
      required_labels: ["type", "scope"]
      failure_action: "라벨 추가"
  - dependencies:
      description: "블로커가 해결 가능한가?"
      failure_action: "의존성 해결"

Solutioning Gate#

gate: solutioning
personas: [architect, ux-designer]
execution: parallel
required_checks:
  architect:
    - clean_architecture:
        description: "레이어 분리가 올바른가?"
        layers: [presentation, domain, data]
    - di_structure:
        description: "Injectable 등록이 완전한가?"
    - api_design:
        description: "네이밍/에러처리가 표준인가?"
        condition: "backend 변경 시"
    - security:
        description: "인증/인가가 적절한가?"
  ux_designer:
    - coui_compliance:
        description: "표준 컴포넌트 사용인가?"
    - layout:
        description: "일관된 간격/정렬인가?"
    - interaction:
        description: "로딩/에러/빈 상태 처리인가?"
    - accessibility:
        description: "WCAG 2.1 AA 기준인가?"
        required: false  # 권장

Implementation Gate#

gate: implementation
personas: [flutter-developer, backend-developer, scrum-master]
sub_gates:
  - step_4_branch:
      description: "feature 브랜치인가?"
      pattern: "^(feature|fix|refactor|chore)/[0-9]+"
      blocked_branches: [development, main]
  - step_8_5_lint:
      description: "dart/dcm analyze 통과?"
      commands:
        - "dart format"
        - "dcm format"
        - "dart fix --apply"
        - "dart analyze --no-fatal-infos"
        - "dcm analyze --no-fatal-style"
  - step_9_pr:
      description: "PR 생성 조건 충족?"
      checks:
        - branch_format
        - issue_linked
        - commits_exist
        - lint_passed

MCP 도구 참조#

ZenHub 도구#

// 이슈 생성
mcp__zenhub__createGitHubIssue({
  repositoryId: "Z2lkOi8vcmFwdG9yL1JlcG9zaXRvcnkvMTM0NzA5MTE3",
  title: "{type}({scope}): {gitmoji} {한글 설명}",
  body: "## 요약\n{내용}",
  issueTypeId: "{issue_type_id}",
  labels: ["{type}", "{scope}"],
})

// Pipeline 이동
mcp__zenhub__moveIssueToPipeline({
  issueId: "{issue.graphqlId}",
  pipelineId: "{pipeline_id}",
})

// Story Point 설정
mcp__zenhub__setIssueEstimate({
  issueId: "{issue_id}",
  estimate: 5,
})

// 의존성 설정
mcp__zenhub__createBlockage({
  blockedIssueId: "{blocked_id}",
  blockingIssueId: "{blocking_id}",
})

Pipeline ID 참조#

pipelines:
  icebox: "Z2lkOi8vcmFwdG9yL1BpcGVsaW5lLzM0OTkyODA"
  product_backlog: "Z2lkOi8vcmFwdG9yL1BpcGVsaW5lLzM0OTkyODE"
  sprint_backlog: "Z2lkOi8vcmFwdG9yL1BpcGVsaW5lLzM0OTkyODI"
  in_progress: "Z2lkOi8vcmFwdG9yL1BpcGVsaW5lLzM0OTkyODM"
  review_qa: "Z2lkOi8vcmFwdG9yL1BpcGVsaW5lLzM0OTkyODQ"
  done: "Z2lkOi8vcmFwdG9yL1BpcGVsaW5lLzM0OTkyODU"

설정 옵션#

설정 파일 위치#

BMAD 설정은 별도의 설정 파일에서 관리됩니다:

• 설정 파일: .claude/config/bmad.json
• 스키마 파일: .claude/config/bmad-schema.json

⚠️ Claude Code의 settings.json은 스키마 검증으로 커스텀 필드를 허용하지 않습니다. BMAD 설정은 반드시 .claude/config/bmad.json을 사용하세요.

bmad.json 설정 예시#

{
  "version": "1.0.0",
  "enabled": true,
  "defaultMode": "optional",
  "gates": {
    "analysis": { "enabled": true, "mandatory": true },
    "planning": { "enabled": true, "mandatory": true },
    "solutioning": {
      "enabled": true,
      "mandatory": true,
      "parallelPersonas": ["architect", "ux-designer"]
    },
    "implementation": { "enabled": true, "mandatory": true }
  },
  "personas": {
    "analyst": { "enabled": true, "phase": "analysis" },
    "product-manager": { "enabled": true, "phase": "planning" },
    "architect": { "enabled": true, "phase": "solutioning" },
    "ux-designer": { "enabled": true, "phase": "solutioning" },
    "flutter-developer": { "enabled": true, "phase": "implementation" },
    "backend-developer": { "enabled": true, "phase": "implementation" },
    "scrum-master": { "enabled": true, "phase": "implementation" }
  },
  "emergency": {
    "allowBypass": true,
    "requireApproval": true
  },
  "parallelExecution": {
    "enabled": true,
    "maxConcurrency": 2
  }
}

옵션 설명#

Quick 모드 설정#

bmad.json Quick 모드 설정#

{
  "quickMode": {
    "enabled": true,
    "skipPhases": ["planning"],
    "simplifyPhases": ["analysis", "solutioning"],
    "prCycle": {
      "autoCreate": true,
      "autoReview": true,
      "autoFix": true,
      "autoMerge": true,
      "mergeMethod": "squash",
      "deleteSourceBranch": true
    },
    "review": {
      "categories": [
        "architecture",
        "state-management",
        "security",
        "performance",
        "testing",
        "readability",
        "i18n",
        "accessibility"
      ],
      "autoFixSeverity": ["critical", "improvements"],
      "skipSeverity": ["suggestions"]
    }
  }
}

Quick 모드 옵션 상세#

에러 코드#

모범 사례#

Do (권장)#

• ✅ 작업 시작 전 AC를 명확히 정의
• ✅ Story Point는 팀 합의에 따라 산정
• ✅ 병렬 가능한 작업은 병렬로 실행
• ✅ 게이트 실패 피드백을 꼼꼼히 확인
• ✅ 재검토 전 모든 피드백 반영

Don't (금지)#

• ❌ 게이트 강제 우회 시도
• ❌ 긴급 모드 남용
• ❌ 페르소나 검토 건너뛰기
• ❌ 피드백 무시하고 재검토 요청
• ❌ development/main 직접 커밋

관련 문서#

• .claude/config/bmad.json - BMAD 설정 파일
• .claude/config/bmad-schema.json - BMAD 설정 스키마
• .claude/orchestrators/bmad-orchestrator.md - 오케스트레이터
• .claude/orchestrators/phase-gates.md - 게이트 정의
• .claude/personas/ - 페르소나 정의
• .claude/skills/workflow/SKILL.md - 기존 워크플로우
• .claude/references/PERSONA_MATRIX.md - 페르소나 책임 매트릭스