Beads (bd) Issue Tracking

This project uses Beads (bd) for issue tracking.

Core rules

• Track ALL work in bd (never use markdown TODOs or comment-based task lists).
• Use bd ready to find available work.
• Use bd create to track new issues/tasks/bugs.
• Use bd sync at end of session to sync with git remote.
• Git hooks auto-sync on commit/merge.

Quick reference

bash
1bd onboard                              # Get started / load workflow context
2bd prime                                # Load complete workflow docs (AI-optimized)
3bd ready                                # Show issues ready to work (no blockers)
4bd list --status=open                   # List all open issues
5bd create --title="..." --type=task     # Create new issue
6bd show <id>                            # View issue details
7bd update <id> --status=in_progress     # Claim work
8bd close <id>                           # Mark complete
9bd dep add <issue> <depends-on>         # Add dependency
10bd sync                                 # Sync with git remote

Workflow

1. Check for ready work: bd ready
2. Claim an issue: bd update <id> --status=in_progress
3. Do the work
4. Mark complete: bd close <id>
5. Sync: bd sync (or let git hooks handle it)

Context loading

• New to project: run bd onboard
• Full workflow docs: run bd prime for AI-optimized context (~1–2k tokens)

For more: see AGENTS.md or bd --help.