Project Commands (/project:)
Available with Project installation. Since Phase 2 of the PM simplification, the many per-entity commands were merged into five commands with subcommands (backlog, reverse, trace, report, migrate); the old names are listed in MIGRATION-v9.md.
Backlog (/bear-project:backlog <action> <entity>)
| Command | Description |
|---|---|
/bear-project:backlog add epic <Name> | Create a new EPIC |
/bear-project:backlog add story <Epic> <Name> | Create a User Story |
/bear-project:backlog add task <US> <Desc> <Est> | Create a task |
/bear-project:backlog list epic | List all EPICs |
/bear-project:backlog list story | List User Stories |
/bear-project:backlog list task | List tasks |
/bear-project:backlog edit epic <Epic> | Update an EPIC |
/bear-project:backlog edit story <US> | Update a User Story |
/bear-project:backlog move task <Task> <Status> | Change task status |
/bear-project:backlog move story <US> <Status> | Transition a story (also next story, move story --auto) |
Backlog generation, sprint breakdown and the Kanban board are workflow commands:
/bear-workflow:plan --only=backlog,/bear-workflow:start <N>,/bear-workflow:status --board. PRD, tech spec, batch queue and constitution:/bear-workflow:plan --only=prd,/bear-workflow:design,/bear-workflow:implement --queue,/bear-workflow:design --constitution(see Workflow Commands).
BMAD v6 Commands
| Command | Description |
|---|---|
/bear-project:migrate --analyze | Analyze current backlog structure |
/bear-project:migrate | Convert backlog to BMAD v6 format |
/bear-project:migrate --stories | Add missing BMAD fields to stories |
/bear-project:migrate --resync | Synchronize backlog files and YAML |
/bear-project:migrate --dry-run | Preview the migration without writing |
SDD v2.0 Commands
| Command | Description |
|---|---|
/bear-project:trace [--scope] [--id] | Display bidirectional traceability matrix |
/bear-project:trace --gaps | Analyze requirement coverage gaps |
/bear-project:trace --by-priority | Coverage map grouped by priority |
/bear-project:reverse scan [--scope] | Analyze codebase and generate structured inventory |
/bear-project:reverse prd | Generate PRD from existing codebase (brownfield) |
/bear-project:reverse stories | Generate user stories from existing features |
/bear-project:reverse gaps | Compare specifications with actual code |
/bear-project:reverse all | Run scan, prd, stories and gaps in sequence |
/bear-gate:check --phase=<phase> | Run spec verification checkpoints (pre-sprint, pre-impl, post-impl, pre-merge) |
Reports (/bear-project:report)
| Command | Description |
|---|---|
/bear-project:report burndown [--sprint] | Generate sprint burndown chart (Mermaid) |
/bear-project:report metrics [--sprint] | Generate project metrics dashboard |
/bear-project:report deps [--sprint] | Generate story dependency graph (Mermaid) |
/bear-project:report deps --critical [--sprint] | Identify critical path for sprint optimization |
Sprint Development (/bear-workflow:implement, part of the workflow path)
Orchestrates complete sprint development in TDD/BDD mode:
bash
/bear-workflow:implement 1 # Sprint 1
/bear-workflow:implement next # Next incomplete sprint
/bear-workflow:implement current # Currently active sprint
/bear-workflow:implement --story US-003 # One story
/bear-workflow:implement --epic EPIC-002 # All stories of an epic
/bear-workflow:implement --queue [--resume] # Batch queue (.bmad/batch-queue.yaml)
/bear-workflow:implement --parallel 3 # Parallel engine (/bear-team:delivery --phase=implementation)Features:
- Mandatory plan mode before each task implementation
- TDD cycle (RED → GREEN → REFACTOR)
- Automatic status updates (Task → User Story → Sprint)
- Progress tracking with metrics
Workflow:
- Load sprint and display board
- For each User Story (by priority):
- Mark US → In Progress
- Display acceptance criteria (Gherkin)
- For each Task (by type: DB → BE → FE → TEST → DOC → REV):
- Plan Mode (mandatory): Analyze code, propose implementation
- TDD Cycle: Write failing tests → Implement → Refactor
- Definition of Done check
- Mark Task → Done with time tracking
- Conventional commit
- When all tasks done → Mark US → Done
- When all US done → Generate sprint review/retro
Control commands during execution:
| Command | Action |
|---|---|
continue | Validate plan and implement |
skip | Skip this task |
block [reason] | Mark as blocked |
stop | Stop (saves state) |