/triage — Bead state hygiene

Audit bead populations and update JSONL state with lifecycle decisions.

8|1|Updated Jan 21, 2024
One-click install
npx skills add https://github.com/azigler/dotfiles --skill triage-bead-state-hygiene
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: /triage — Bead state hygiene
Source: https://github.com/azigler/dotfiles/tree/main/agents/skills/triage
Command: npx skills add https://github.com/azigler/dotfiles --skill triage-bead-state-hygiene

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It fixes stale, orphaned, blocked, and abandoned bead states so that br ready remains a reliable “what’s next” source of truth.

Core Features & Use Cases

  • Snapshot and prioritize bead populations (ready, stale, orphans, blocked, in-progress, and epic close-eligibility) to identify where state drift and backlog noise are coming from.
  • Per-bead decisioning to close true orphans/stale work, defer items that are relevant later, escalate or update dependency claims, and demote zombies back to claimable open.
  • Documentation and cleanup discipline by applying a commit-based summary (JSONL flush + git commit) so triage results persist and are measurable.

Quick Start

Run the triage workflow for your bead system and then commit the updated .beads/issues.jsonl after closing, deferring, and reopening items as appropriate.

Frequently Asked Questions about /triage — Bead state hygiene

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

FAQPage Schema
How do I clean up stale and blocked issues in my backlog triage workflow?▼

Backlog triage for stale and blocked issues requires auditing each bead population, making per-bead lifecycle decisions to close, defer, or reopen items, and flushing state updates to a committed JSONL file. This restores reliable release readiness.

What is the best way to handle orphaned items causing project hygiene issues?▼

Handling orphaned items causing project hygiene issues involves snapshotting bead populations to identify state drift, then applying per-bead decisions to close true orphans or demote zombies back to claimable open states.

How does bead state triage improve release readiness?▼

Bead state triage improves release readiness by fixing abandoned and blocked workflow states so that ready items remain a reliable source of truth. It prioritizes populations and applies per-bead dependency de-blocking actions during pre-release hardening.

When do I need to run issue lifecycle housekeeping on my workflow state?▼

Issue lifecycle housekeeping on workflow state is needed during onboarding, pre-release hardening, or weekly cycles when backlog state becomes noisy and ready items are difficult to scan. It flushes state updates via a git commit.

Can I update dependency claims and escalate blockers during backlog triage?▼

You can update dependency claims and escalate blockers during backlog triage by applying per-bead lifecycle decisions. The workflow audits blocked populations and executes dependency de-blocking actions before syncing the JSONL update.

What are the limitations of using bead state triage for epic close-eligibility?▼

A limitation of bead state triage for epic close-eligibility is that it requires auditing each population manually to make per-bead decisions. It does not automatically close epics; it identifies eligible items and requires a committed JSONL update to persist changes.