beads-task-management

Manage tasks, bugs, features, and epics with recovery cards and auto-sync.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/aesirsystems/claude-beads-skill --skill beads-task-management
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beads-task-management
Source: https://github.com/aesirsystems/claude-beads-skill/tree/main/.
Command: npx skills add https://github.com/aesirsystems/claude-beads-skill --skill beads-task-management

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bd, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill eliminates the frustration of losing work context when Claude Code compacts or restarts, ensuring seamless continuation of complex projects.

Core Features & Use Cases

  • Recovery Card Pattern: Automatically preserve session state with standardized context documentation for instant recovery.
  • Structured Task Management: Create and manage tasks, bugs, features, and epics with hierarchical dependencies and priority tracking.
  • Auto-Sync Integration: Automatically sync task changes with git commits and verify context before compacts.
  • Use Case: Imagine working on a multi-week software project. Use this Skill to maintain full context across sessions, track dependencies between tasks, and pick up exactly where you left off after days or weeks away.

Quick Start

In your project directory, initialize beads and create a recovery card to preserve your current work context.

Frequently Asked Questions about beads-task-management

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

FAQPage Schema
How do I recover my work context when Claude Code sessions restart or compact?

Recovery cards automatically preserve your session state with standardized context documentation. Initialize beads in your project directory and create a recovery card to save your current work, enabling instant continuation after restarts without losing progress or task dependencies.

Can I track task dependencies and priorities across multiple development sessions?

Yes. This Skill structures tasks, bugs, features, and epics with hierarchical dependencies, blockers, and priority levels (P0-P4). Changes auto-sync with git commits, ensuring your task graph remains consistent and recoverable across sessions.

What's the best way to maintain project context in long-running multi-week development workflows?

Use beads-backed task management with auto-sync hooks to protect against data loss. Create recovery cards that capture your current state, track task hierarchies and blockers, and verify context before each session compact so you pick up exactly where you left off.

Do I need git integration to use task management and recovery tracking?

Git integration is part of the beads-backed approach. Auto-sync hooks tie task changes to git commits, providing a versioned audit trail. This ensures your task state aligns with your code history for seamless recovery across sessions.

What happens to task dependencies and blockers if my session ends unexpectedly?

Standardized recovery cards preserve your full task graph, including dependencies, blockers, and priority metadata. On session restart, beads restores your task state automatically, eliminating re-entry work and keeping your project structure intact.