Convert a superpowers implementation plan into a beads epic with properly structured tasks, acceptance criteria, and inferred dependencies
Convert implementation plans (from superpowers:writing-plans) and design documents (from superpowers:brainstorming) into beads epics ready for epic-executor.
/plan-to-epic <path-to-plan.md>
/plan-to-epic docs/plans/2026-01-01-feature-plan.md
/plan-to-epic docs/plans/2026-01-01-feature-plan.md --design docs/plans/2026-01-01-feature-design.md
/plan-to-epic docs/plans/2026-01-01-feature-plan.md --epic-id platform-xyz
Flags:
--design <path> - Include design document for additional context (architecture, data flow, decisions)--epic-id <id> - Add tasks to existing epic instead of creating new oneRead the plan file and extract:
From header:
From each task section:
If --design provided, also extract:
Store this as design_context for inclusion in tasks.
If --epic-id not provided, create new epic:
bd create --type=epic --priority=0 --json \\
--title="<Plan Title>" \\
--body-file=/tmp/epic-body.md
File overlap detection:
Explicit references:
For each task, create content for three separate fields:
Description (--body-file): Implementation-focused content - what to do:
Design (--design): Context and rationale - why and how it fits:
Notes (--notes): Source document references as fallback:
Build from multiple sources:
bd create --type=task --priority=0 --json \\
--parent=<epic-id> \\
--title="<Task Title>" \\
--acceptance="<acceptance criteria>" \\
--body-file=/tmp/task-N-body.md \\
--design "$(cat /tmp/task-N-design.md)" \\
--notes "Source: Plan <path> (lines N-M); Design <path>"
bd dep add <dependent-task-id> <dependency-task-id> --json
Created epic: platform-abc "Feature Name"
Source documents:
Plan: docs/plans/2026-01-01-feature-plan.md
Design: docs/plans/2026-01-01-feature-design.md
Tasks (9):
platform-abc.1: Task 1 Title [no dependencies]
- Description: 847 words (implementation)
- Design: 156 words (context)
platform-abc.2: Task 2 Title [depends on: .1]
...
Ready to execute:
/epic-executor platform-abc
bd commands use --json for reliable parsing