bd-issue-tracking

Track issues across sessions with bd operations and dependency graphs.

14|1|Updated Dec 22, 2025
One-click install
npx skills add https://github.com/specledger/specledger --skill bd-issue-tracking-specledger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bd-issue-tracking
Source: https://github.com/specledger/specledger/tree/main/.claude/skills/bd-issue-tracking
Command: npx skills add https://github.com/specledger/specledger --skill bd-issue-tracking-specledger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Beads (bd) provide persistent memory for complex, multi-session work, enabling you to capture context, decisions, and dependencies across compaction cycles and session boundaries, so work can resume seamlessly.

Core Features & Use Cases

  • Provides a structured workflow for discovery, execution, planning, and handoff across sessions.
  • Manages dependency graphs (blocks, related, parent-child, discovered-from) to keep work organized and automatically surface ready tasks.
  • Supports hybrid workflows with TodoWrite for short-term execution and bd for long-term memory, ensuring continuity and auditability.
  • Ideal for projects spanning days or weeks with blockers, side quests, and memory needs; not ideal for simple, single-session tasks.

Quick Start

Start a new multi-session beads project by running bd ready and reviewing the in_progress work to plan your next steps.

Frequently Asked Questions about bd-issue-tracking

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track project issues and dependencies across multiple sessions when context gets lost during compaction?

Persistent multi-session issue tracking uses beads to preserve context, decisions, and dependency graphs across compaction cycles. This ensures work resumes seamlessly after session boundaries by capturing blockers and complex dependencies that would otherwise be lost.

What is the best way to manage complex dependency graphs for long-term software projects spanning days or weeks?

Managing complex dependency graphs for long-term projects requires tracking relationships like blocks, related, parent-child, and discovered-from. This approach automatically surfaces ready tasks and keeps work organized across extended timeframes with blockers and side quests.

How do I start a new multi-session project and review in-progress work to plan next steps?

Start a new multi-session project by running the ready command and reviewing the in_progress work to plan your next steps. This workflow provides structured discovery, execution, planning, and handoff across session boundaries.

Can I use TodoWrite for short-term execution while preserving long-term memory for issue tracking?

Yes, hybrid workflows support TodoWrite for short-term execution alongside beads for long-term memory. This integration ensures continuity and auditability by combining immediate task management with persistent context that survives session boundaries.

When should I not use persistent issue tracking for my software engineering tasks?

Persistent issue tracking is not ideal for simple, single-session tasks. It is designed specifically for complex projects spanning days or weeks with blockers, side quests, and memory needs where work must survive compaction cycles and session boundaries.