Skip to main content

backlog

Manage backlog items — ideas not ready for active planning. Add, review, promote, or remove.

Stars
17
Source
SienkLogic/plan-build-run
Updated
2026-04-03
Slug
SienkLogic--plan-build-run--backlog
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/SienkLogic/plan-build-run/HEAD/plugins/pbr/skills/backlog/SKILL.md -o .claude/skills/backlog.md

Drops the SKILL.md into .claude/skills/backlog.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

STOP — DO NOT READ THIS FILE. You are already reading it.

/pbr:backlog — Backlog Parking Lot

Manage ideas that aren't ready for active planning. Backlog items use 999.x numbering to stay outside the active phase sequence. They can be promoted to active phases when ready.

Step 0 — Banner

╔══════════════════════════════════════════════════════════════╗
║  PLAN-BUILD-RUN ► BACKLOG                                    ║
╚══════════════════════════════════════════════════════════════╝

Subcommands

/pbr:backlog add <description>

  1. Create .planning/phases/ directory if needed
  2. Find next 999.x number: scan for existing 999.* dirs, increment
  3. Generate slug from description
  4. Create .planning/phases/999.{x}-{slug}/
  5. Write a minimal PLAN.md with just the description as objective (no tasks — this is a placeholder)
  6. Display: Backlog item 999.{x}: {description}

/pbr:backlog review

  1. Scan .planning/phases/999.* directories
  2. If none found: display "No backlog items." and exit
  3. For each item, read its PLAN.md objective
  4. Display all items in a numbered list
  5. Use AskUserQuestion for each item:
    • Promote — Move to active milestone (renumber into current sequence)
    • Keep — Leave in backlog
    • Remove — Delete the directory

/pbr:backlog promote <N>

  1. Find the 999.{N} directory
  2. Determine next active phase number (highest non-999 phase + 1)
  3. Rename directory from 999.{N}-{slug} to {next}-{slug}
  4. Update ROADMAP.md to include the new phase
  5. Display: Promoted backlog item to Phase {next}: {slug}

Anti-Patterns

  1. DO NOT create backlog items for work that should be a todo — backlog is for phase-level ideas
  2. DO NOT auto-promote items — always require user decision
  3. DO NOT renumber existing active phases when promoting