/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.