Backlog Manager Skill

Overview

The backlog manager provides a unified interface for tracking work items across different task management systems. Choose your backend based on team preferences and existing tooling.

Supported Backends:

Configuration

Configure your preferred backend in your project's CLAUDE.md:

## Task Management

backend: files  # Options: files, github, linear, beads

# GitHub configuration (when backend: github)
# github_labels: ["backlog"]
# github_assignee: "@me"

# Linear configuration (when backend: linear)
# linear_team_id: TEAM-123
# linear_project_id: PROJECT-456

# Beads configuration (when backend: beads)
# beads_prefix: myapp               # Optional: custom issue prefix

Default: If no configuration is found, uses file-based backend.

When to Use This Skill

Create a backlog item when:

• Work requires more than 15-20 minutes
• Needs research, planning, or multiple approaches considered
• Has dependencies on other work
• Requires approval or prioritization
• Part of larger feature or refactor
• Technical debt needing documentation

Act immediately instead when:

• Issue is trivial (< 15 minutes)
• Complete context available now
• No planning needed
• User explicitly requests immediate action
• Simple bug fix with obvious solution

Core Concepts

Status Lifecycle

All backends follow this status workflow:

pending → ready → complete

Priority Levels

Core Operations

Each backend implements these operations:

Backend Selection

When this skill is invoked:

1. Read configuration from project CLAUDE.md
2. Load appropriate reference based on backend setting:
   • files → references/file-backend.md
   • github → references/github-backend.md
   • linear → references/linear-backend.md
   • beads → references/beads-backend.md
3. Follow backend-specific instructions for operations

Fallback Behavior

If the configured backend is unavailable:

• GitHub unavailable (gh not authenticated): Fall back to files
• Linear unavailable (MCP not configured): Fall back to files
• Beads unavailable (bd not installed or not initialized): Fall back to files
• Warn user about the fallback

Integration with Development Workflows

Key Distinctions

Backlog manager (this skill):

• Persisted tracking across sessions
• Multiple backend options
• Team collaboration
• Project/sprint planning

TodoWrite tool:

• In-memory task tracking during single session
• Temporary progress tracking
• Not persisted to disk
• Different purpose from backlog management