flow

After brainstorming/design phase (links design doc to task)

After planning phase (links implementation plan document to task)

Fast return to active task (finds in_progress task, resolves branch/worktree, shows context)

Decompose task into subtasks based on design document (approach discussion, preview, merge, create)

Complete and verify task (checks git branch, closes task, handles parent tasks, syncs)

Use after completing and verifying a task. Checks git branch (feature → suggests finishing-a-development-branch), closes task, cleans up implementation plan files, recursively checks parents with confirmation, runs bd sync. Handles task completion workflow for beads.

Use when returning to work after /clear or new session. Fast return to an active in_progress task — finds task, resolves branch/worktree, shows task card. Use flow:start for new task selection.

Use when user wants to break down a beads task into subtasks based on a design document. Triggered by /flow:decompose or when user says "decompose", "break down task", "create subtasks from design".

Initialize project environment after worktree creation. Detects project type from config files and CLAUDE.md, proposes setup commands with confirmation. Used by flow:start and flow:continue after new worktree creation.

Use after completing brainstorming/design phase. Links design document to task. Simple operation — save the link, nothing else. Suggests /flow:decompose for subtask creation.