bmad-integration Reference

gate: analysis
persona: analyst
required_checks:
  - requirement_clarity:
      description: "Are requirements specific and measurable?"
      failure_action: "Redefine requirements"
  - scope_appropriateness:
      description: "Is it an appropriate size for a single issue?"
      failure_action: "Split or adjust"
  - ac_testability:
      description: "Are Acceptance Criteria automatable for testing?"
      failure_action: "Revise Acceptance Criteria"

gate: planning
persona: product-manager
required_checks:
  - issue_hierarchy_structure:
      description: "Is the hierarchy structure appropriate for the request scale (Initiative/Project/Epic/Feature/Bug/Task)?"
      failure_action: "Redesign structure"
  - story_point:
      description: "Is it within 1-8 SP range?"
      failure_action: "Re-estimate or split"
      threshold:
        min: 1
        max: 8
        split_required: 13
  - labeling:
      description: "Are Type and Scope labels present?"
      required_labels: ["type", "scope"]
      failure_action: "Add labels"
  - dependencies:
      description: "Are blockers resolvable?"
      failure_action: "Resolve dependencies"

gate: solutioning
personas: [architect, ux-designer]
execution: parallel
required_checks:
  architect:
    - clean_architecture:
        description: "Is layer separation correct?"
        layers: [presentation, domain, data]
    - di_structure:
        description: "Is Injectable registration complete?"
    - api_design:
        description: "Are naming/error handling standardized?"
        condition: "when backend changes"
    - security:
        description: "Is authentication/authorization appropriate?"
  ux_designer:
    - coui_compliance:
        description: "Are Co<X> design-system components preferred over raw widgets? Recommended when CoUI is in use; see the cc-coui skill for component APIs."
        required: false  # recommended, not a hard block (skip when CoUI is not adopted)
    - layout:
        description: "Is spacing/alignment consistent?"
    - interaction:
        description: "Are loading/error/empty states handled?"
    - accessibility:
        description: "Does it meet WCAG 2.1 AA standards?"
        required: false  # recommended

gate: implementation
personas: [flutter-developer, backend-developer, scrum-master]
sub_gates:
  - step_4_branch:
      description: "Is it a feature branch?"
      pattern: "^(feature|fix|refactor|chore)/[0-9]+"
      blocked_branches: [development, main]
  - step_8_5_lint:
      description: "dart analyze pass?"
      commands:
        - "dart format"
        - "dart fix --apply"
        - "dart analyze --fatal-infos"
  - step_9_pr:
      description: "PR creation conditions met?"
      checks:
        - branch_format
        - issue_linked
        - commits_exist
        - lint_passed

// Dynamic workspace info query (once per session)
const workspace = await mcp__zenhub__getWorkspacePipelinesAndRepositories();
const repoId = workspace.githubRepositories.find(r => /* select GitHub repo */)?.id;  // 필드명: githubRepositories
const issueTypes = await mcp__zenhub__getIssueTypes();

// Issue creation
mcp__zenhub__createGitHubIssue({
  repositoryId: repoId,
  title: "{type}({scope}): {gitmoji} {description}",
  body: "## Summary\n{2~3줄 요약}\n\n## Acceptance Criteria\n- [ ] ...",
  // 계약 블록·짧은 요약은 본문에 유지, 긴 서술(20행 초과)은 이슈를 만든 뒤 로컬 HTML 로 —
  // 작업 브랜치가 생길 때 커밋되고 `## 📄 상세 기획` 링크가 붙는다
  // SoT: cc-dev/rules/zenhub-conventions.md → Issue Body HTML Contract
  issueTypeId: issueTypes.find(t => t.name === "Feature").id,
  labels: ["{type}", "{scope}"],
})

// Pipeline movement
const inProgress = workspace.pipelines.find(p => p.name === "In Progress");
if (!inProgress) throw new Error(`'In Progress' 파이프라인 없음. 라이브: ${workspace.pipelines.map(p => p.name).join(", ")}`);
mcp__zenhub__moveIssueToPipeline({
  issueId: "{issue.graphqlId}",
  pipelineId: inProgress.id,
})

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

// Dependency setting
mcp__zenhub__createBlockage({
  blockedIssueId: "{blocked_id}",
  blockingIssueId: "{blocking_id}",
})

const workspace = await mcp__zenhub__getWorkspacePipelinesAndRepositories();
// workspace.pipelines → [{ id, name }, ...]
// Find by name (라이브 6종): "New Issues", "Icebox", "Product Backlog", "Sprint Backlog", "In Progress", "Review/QA"
//   ⚠️ "Done"/"Closed" 컬럼은 없음 — Done 미사용, Closed 는 GitHub state(컬럼 아님). close 는 gh issue close + updateIssue(state:CLOSED) 로.

{
  "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
  }
}

{
  "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"]
    }
  }
}