| íëŠĐ | ëīėĐ |
|---|---|
| Invoke | /bmad:gate |
| Category | workflow |
| Complexity | medium |
/bmad:gate#
Manually verify BMAD phase gates.
Triggers#
- Manual gate status check
- Re-verification after gate failure
- Checking specific gate conditions
Usage#
Basic Usage#
# Verify a specific phase gate
/bmad:gate --phase analysis
/bmad:gate --phase planning
/bmad:gate --phase solutioning
/bmad:gate --phase implementation
Re-verification Request#
# Re-verify after applying feedback
/bmad:gate --phase solutioning --retry
Check All Gates#
# Check overall gate status
/bmad:gate --all
Options#
| Option | Required | Description |
|---|---|---|
--phase | â ïļ* | Phase to verify |
--all | â ïļ* | Check all gates |
--retry | â | Re-verification mode |
--verbose | â | Detailed result output |
*Either --phase or --all is required
Gate Verification Items#
Analysis Gate#
checks:
- requirement_clarity:
description: " Are requirements specific and measurable? "
- scope_appropriateness:
description: " Is it an appropriate size for a single issue? "
- ac_testability:
description: " Are AC automatable for testing? "
Planning Gate#
checks:
- epic_story_structure:
description: " Is the hierarchy structure appropriate? "
- story_point:
description: " Is it within 1-8 SP range? "
threshold: { min: 1, max: 8, split_required: 13 }
- labeling:
description: " Are Type and Scope labels present? "
- dependencies:
description: " Are blockers resolvable? "
Solutioning Gate#
checks:
architect:
- clean_architecture
- pure_di_wiring # No getIt/injectable, direct BlocProvider creation
- api_design # when backend changes
- security
ux_designer:
- coui_compliance
- layout
- interaction
- accessibility # recommended
Implementation Gate#
sub_gates:
- step_4_branch:
pattern: " ^(feature|fix|refactor|chore)/[0-9]+ "
- step_8_5_lint:
commands: [ " dart analyze " , " dcm analyze " ]
- step_9_pr:
checks: [branch_format, issue_linked, commits_exist, lint_passed]
Output Format#
Gate Passed#
ââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ
â Analysis Gate: â
PASSED â
â âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââĢ
â â
â â
Requirements clarity: PASS â
â - 3 functional requirements identified â
â - Success criteria clear â
â â
â â
Scope appropriateness: PASS â
â - Expected complexity: Medium (3-5 SP) â
â - Appropriate for a single issue â
â â
â â
Acceptance Criteria Testability: PASS â
â - 3 Acceptance Criteria defined â
â - All convertible to BDD scenarios â
â â
â â Ready to proceed to Planning phase â
â â
ââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ
Gate Failed#
ââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ
â Solutioning Gate: â FAILED â
â âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââĢ
â â
â ðïļ Architect review: â FAILED â
â âââ â
Clean Architecture â
â âââ â Dependency wiring: getIt usage found (Pure DI violation) â
â âââ â
API Design (N/A) â
â âââ â
Security â
â â
â ðĻ UX Designer review: â
PASSED â
â âââ â
CoUI compliance â
â âââ â
Layout â
â âââ â
Interaction â
â âââ â ïļ Accessibility (recommended) â
â â
â Gate result: FAILED (Architect review failed) â
â â
â Required actions: â
â 1. Change to direct creation in BlocProvider: â
â create: (_) = > AuthorBloc() â
â â
â Re-verification command: â
â /bmad:gate --phase solutioning --retry â
â â
â â ïļ Cannot proceed to Implementation phase. â
â â
ââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ
Overall Gate Status#
ââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ
â BMAD Gate Status (All) â
â âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââĢ
â â
â Analysis Gate: â
PASSED â
â Planning Gate: â
PASSED â
â Solutioning Gate: â FAILED (Architect - Pure DI violation) â
â Implementation Gate: âģ PENDING â
â â
â Current blocker: Solutioning Gate â
â Next action: /bmad:gate --phase solutioning --retry â
â â
ââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ
Mandatory Gate Policy#
â ïļ Important: All gates are mandatory.
On gate failure:
âââ Cannot proceed to next phase
âââ Feedback provided
âââ Re-verification required
Exception:
âââ Emergency mode (--emergency)
â âââ Admin approval required
âââ Post-review required
Related Commands#
/bmad- Full BMAD workflow/bmad:review- Persona-specific review/bmad:status- Status check
Related Documents#
.claude/orchestrators/phase-gates.md- Detailed gate definitions.claude/personas/- Per-persona review criteria