What problem does it solve?
This skill enables Claude to orchestrate long-running, multi-session work by using beads (bd) to persist context, relationships, and decisions across compaction cycles. It guides how to choose between long-term tracking and lightweight execution, and how to structure work using dependency graphs and issue lifecycles.
Core Features & Use Cases
- Proactive discovery and issue creation: Capture new work during implementation and link it back to current tasks with discovered-from.
- Persistent context across sessions: Use the beads database to preserve memory, decisions, and dependencies beyond a single session.
- Dependency-driven planning: Create blocks, related, parent-child, and discovered-from relationships to model complex workflows and unblock work automatically.
- Integration with TodoWrite: Complement long-term planning with short-term, visible execution steps.
Quick Start
- Ensure a
.beads/ directory exists in the project or a global beads database is available.
- Start a session and surface ready work: bd ready --json
- Create an epic and link child tasks to illustrate multi-session planning:
- bd create "Implement user authentication" -t epic -d "OAuth integration"
- bd create "Set up credentials" -t task
- bd dep add oauth-epic oauth-credentials --type parent-child
- bd ready --json to see what can begin now
