bd-issue-tracking

Multi-session issue tracking with beads preserves memory across compaction cycles by storing decisions, outcomes, and dependencies as persistent bead issues. Claude resumes work with full context after gaps, enabling reliable continuity for projects spanning days or weeks.

Beads are long-lived issues suited for complex, multi-session work with dependencies and blockers. TodoWrite is for single-session checklists. Use beads when work spans multiple sessions and requires proactive dependency graphing and lifecycle management across compaction.

Dependency graphs in beads track blocks, related, parent-child, and discovered-from relationships. This surfaces blockers and context needed for knowledge-work tasks, enabling Claude to prioritize work and understand how issues connect across complex projects.

Start a beads workflow for knowledge-work tasks spanning days or weeks involving complex dependencies, side quests, and project memory. Beads satisfy session start checks, readiness discovery, and notes-based resumability with explicit dependency relationships preserved across compaction.

Yes, beads integrate with the MCP tools plugin for quick operations and persistence. The plugin enables rapid issue creation, linking, and dependency updates while beads handle session memory preservation and compaction survival.