Skip to content

Project Commands (/project:) ​

← All command namespaces

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>) ​

CommandDescription
/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 epicList all EPICs
/bear-project:backlog list storyList User Stories
/bear-project:backlog list taskList 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 ​

CommandDescription
/bear-project:migrate --analyzeAnalyze current backlog structure
/bear-project:migrateConvert backlog to BMAD v6 format
/bear-project:migrate --storiesAdd missing BMAD fields to stories
/bear-project:migrate --resyncSynchronize backlog files and YAML
/bear-project:migrate --dry-runPreview the migration without writing

SDD v2.0 Commands ​

CommandDescription
/bear-project:trace [--scope] [--id]Display bidirectional traceability matrix
/bear-project:trace --gapsAnalyze requirement coverage gaps
/bear-project:trace --by-priorityCoverage map grouped by priority
/bear-project:reverse scan [--scope]Analyze codebase and generate structured inventory
/bear-project:reverse prdGenerate PRD from existing codebase (brownfield)
/bear-project:reverse storiesGenerate user stories from existing features
/bear-project:reverse gapsCompare specifications with actual code
/bear-project:reverse allRun 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) ​

CommandDescription
/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:

  1. Load sprint and display board
  2. For each User Story (by priority):
    • Mark US → In Progress
    • Display acceptance criteria (Gherkin)
  3. 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
  4. When all tasks done → Mark US → Done
  5. When all US done → Generate sprint review/retro

Control commands during execution:

CommandAction
continueValidate plan and implement
skipSkip this task
block [reason]Mark as blocked
stopStop (saves state)