bd-issue-tracking

Persist cross-session work context and decisions using beads.

247|23|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/open-constructs/cdk-terrain --skill bd-issue-tracking-open-constructs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bd-issue-tracking
Source: https://github.com/open-constructs/cdk-terrain/tree/main/.claude/skills/bd-issue-tracking
Command: npx skills add https://github.com/open-constructs/cdk-terrain --skill bd-issue-tracking-open-constructs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables AI agents to manage long-running, multi-session work by using beads as a persistent memory layer that survives compaction and session boundaries.

Core Features & Use Cases

  • Dependency-driven planning: Create, link, and visualize task dependencies to ensure correct execution order across sessions.
  • Persistent memory across sessions: Preserve context, decisions, and workflow state even after conversation history is cleared.
  • Hybrid workflows with TodoWrite: Seamlessly blend long-term beads memory with short-term TodoWrite task lists for immediate execution.
  • Session handoffs and compaction resilience: Provide structured notes for quick resume after interruptions.

Quick Start

Start by listing ready work with bd ready, then select an issue to begin and update its status to in_progress.

Frequently Asked Questions about bd-issue-tracking

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

FAQPage Schema
How do I persist context and decisions for AI agents across multiple sessions?

Multi-session work persists context and decisions by using beads as a memory layer that survives compaction and conversation boundaries. It stores structured notes, design decisions, and workflow state to maintain progress reliably.

What's the best way to manage long-running task dependencies in AI workflows?

Managing long-running task dependencies is best handled by creating, linking, and visualizing tasks to ensure correct execution order across sessions. This dependency-driven planning preserves workflow state and enables structured session handoffs.

Can I use TodoWrite alongside persistent memory for hybrid task management?

Yes, you can use TodoWrite alongside persistent memory for hybrid task management. This blends long-term beads memory for cross-session context with short-term TodoWrite lists for immediate execution tracking.

How do I resume AI agent work after a session handoff or compaction?

Resuming work after a session handoff or compaction relies on structured session notes and ready-state management. You can list ready work, select an issue, and update its status to quickly resume interrupted progress.

Do I need the bd CLI to track issues and ready-state management for AI sessions?

Yes, you need the bd CLI to track issues and manage ready-states for AI sessions. It satisfies design notes, acceptance criteria, and session notes through command-line operations like listing ready work and updating statuses.