8d047aa176
Add slash command that converts Claude Code plan files into beads epics with tasks and dependencies. Features: - Parses plan structure (title, summary, phases) - Creates epic + tasks from phases - Sets up sequential dependencies - Uses Task agent delegation for context efficiency Complements existing bd prime hooks for session start/end.
Claude Code Integration for Beads
Slash command for converting Claude Code plans to beads tasks.
Prerequisites
# Install beads
curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
# Install hooks (auto-injects workflow context on session start)
bd setup claude
Installation
cp commands/plan-to-beads.md ~/.claude/commands/
Optionally add to ~/.claude/settings.json under permissions.allow:
"Bash(bd:*)"
/plan-to-beads
Converts a Claude Code plan file into a beads epic with tasks.
/plan-to-beads # Convert most recent plan
/plan-to-beads path/to/plan.md # Convert specific plan
What it does:
- Parses plan structure (title, summary, phases)
- Creates an epic for the plan
- Creates tasks from each phase
- Sets up sequential dependencies
- Uses Task agent delegation for context efficiency
Example output:
Created from: peaceful-munching-spark.md
Epic: Standardize ID Generation (bd-abc)
├── Add dependency (bd-def) - ready
├── Create ID utility (bd-ghi) - blocked by bd-def
└── Update schema (bd-jkl) - blocked by bd-ghi
Total: 4 tasks
Run `bd ready` to start.
Related
bd prime- Workflow context (auto-injected via hooks)bd setup claude- Install/manage Claude Code hooksbd ready- Find unblocked work
License
Same as beads (see repository root).