What problem does it solve?
The BD issue-tracking skill provides a persistent memory model for managing complex, multi-session work by using beads (bd) to create issues, dependencies, and notes that survive compaction and session boundaries. It helps teams avoid losing context when conversations end, sessions are paused, or long-running work spans days or weeks.
Core Features & Use Cases
- Proactive discovery: capture new work and link it to ongoing tasks with discovered-from dependencies.
- Dependency graph: model blockers, related work, epic/subtask relationships, and provenance to organize work.
- Session start and handoff: read notes to resume work across sessions and ensure smooth handoffs.
- Beads memory vs TodoWrite: combine long-term persistence with short-term task visibility.
- Robust recovery after compaction: reconstruct context from the beads notes and dependencies.
Quick Start
Start by enabling a session: ensure your project has a .beads directory, run bd ready to reveal work, pick an issue and set its status to in_progress, then begin working while beads capture your decisions. You can also create new discovered-from issues during exploration and let the system automatically unblock follow-on work.
