# bd Issue Tracking Skill

A Claude Code skill for effective beads (bd) issue tracking across multi-session coding workflows.

## What This Skill Provides

- Decision framework for when to use bd vs TodoWrite
- Session protocols for starting and ending work
- Compaction survival strategies
- Issue creation guidelines
- Dependency management patterns

## Installation

This skill is deployed via the ai-skills Home Manager module. Add `"bd-issue-tracking"` to your `claudeCodeSkills` list.

## Source

Based on the upstream beads Claude Code skill:
https://github.com/steveyegge/beads/tree/main/examples/claude-code-skill

## Philosophy

This skill teaches **temporal layering** - using both TodoWrite and bd for different time horizons:

- **TodoWrite**: Single-session micro-tasks (visible progress, ephemeral)
- **bd**: Multi-session strategic work (persistent, survives compaction)

The key insight: bd provides structured context that persists across long gaps, while TodoWrite excels at immediate session tracking.

## Contents

- `SKILL.md` - Main skill instructions for Claude
- `references/` - Detailed documentation:
  - `BOUNDARIES.md` - When to use bd vs TodoWrite
  - `CLI_REFERENCE.md` - Complete command reference
  - `DEPENDENCIES.md` - Dependency types guide
  - `WORKFLOWS.md` - Step-by-step procedures
  - `ISSUE_CREATION.md` - Issue quality guidelines
  - `RESUMABILITY.md` - Cross-session patterns
  - `STATIC_DATA.md` - Reference database usage
