bd (beads)

Workflow guidance for bd, a lightweight issue tracker with git-based sync and dependency support.

When to Use bd vs TodoWrite

Use bd for:

• Multi-session work that persists beyond current conversation
• Work discovered during development that should be tracked
• Issues with dependencies or blocking relationships
• Coordination with other developers
• Work that needs git history and audit trail

Use TodoWrite for:

• Simple single-session execution tracking
• Ephemeral task lists for current session only
• Breaking down immediate work into steps

Rule of thumb: When in doubt, prefer bd—persistence you don't need beats lost context.