Plan to Beads
Converts a Claude Code plan file into a beads epic with subtasks.
Instructions
When this command is invoked:
- •
Ensure stealth mode is initialized: Check if beads is already initialized for the project. If not, run:
bashbd init --stealth
- •
Locate the most recent (active) plan file: Read the current plan file from the plans directory
- •
Extract the plan content: Get the ENTIRE TEXT of the plan
- •
Create a beads epic: Use
bd create -t epicto create an epic with:- •A descriptive title based on the plan's goal
- •The complete plan text in the description
- •
Create subtasks: Analyze the plan and create subtasks for each major work item or implementation step using
bd createwith:- •Clear, actionable titles
- •Parent reference to the epic
- •Appropriate status and labels
- •
Link dependencies: If the plan has sequential steps, link the subtasks with appropriate dependencies
- •
Sync to git: Run
bd syncto persist the changes - •
Copy the plan id: Put the epic id on the clipboard
- •echo <plan id> | bpcopy
Expected Workflow
# User runs: /plan-to-beads # Agent should: # 1. Read the plan file # 2. Create epic with full plan text # 3. Create subtasks for each work item # 4. Link dependencies as needed # 5. Sync to git
Notes
- •The epic description should contain the COMPLETE plan text for reference
- •Subtasks should capture all trackable work items from the plan
- •Use clear, descriptive titles for easy identification
- •Preserve any dependencies or sequential ordering from the plan