bmad-loop-sweep

Triages deferred-work ledger entries into a machine-readable partition for the bmad-loop orchestrator.

Updated Jul 9, 2026
One-click install
npx skills add https://github.com/unbakedcosmos/thumbnailer --skill bmad-loop-sweep-unbakedcosmos
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-loop-sweep
Source: https://github.com/unbakedcosmos/thumbnailer/tree/main/.claude/skills/bmad-loop-sweep
Command: npx skills add https://github.com/unbakedcosmos/thumbnailer --skill bmad-loop-sweep-unbakedcosmos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Deferred-work ledgers accumulate stale, unreliable entries over time: items marked open are often already fixed, blocked, or moot, and no one verifies them against the actual code. This Skill automates that triage inside bmad-loop sweep runs, verifying every open entry against the codebase and emitting a validated result.json the orchestrator can act on deterministically. ## Core Features & Use Cases - Code-Verified Triage: Reads each open DW entry's location, greps for the symptom, and checks git history to classify entries as already_resolved (with file:line or commit evidence), bundles, blocked, skip, or human decisions. - Machine-Readable Output: Writes a strictly validated result.json with partition rules enforced by the orchestrator — every open id in exactly one category, kebab-case bundle names, and structured decision options with recommendations. - Legacy Ledger Migration: A --migrate mode rewrites freeform pre-DW-format ledgers into canonical DW-<n> entries, preserving existing entries byte-identically and emitting a key-to-DW-id mapping. - Use Case: During a bmad-loop sweep, the orchestrator spawns this Skill to triage 15 open deferred-work entries; it returns 4 already-resolved with evidence, 2 buildable bundles, 1 blocked entry, and 2 human decisions — all without touching code or asking questions. ## Quick Start Run a bmad-loop sweep so the orchestrator invokes this Skill to triage the open entries in deferred-work.md and produce a validated result.json.

Frequently Asked Questions about bmad-loop-sweep

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

FAQPage Schema
How do I triage a deferred-work ledger automatically?▼

Run a bmad-loop sweep, which spawns this Skill in automation mode. It reads deferred-work.md, verifies every open entry against the code and git history, and writes a result.json partitioning entries into already_resolved, bundles, blocked, skip, and decisions.

How does the sweep verify that a deferred item is already fixed?▼

It reads the entry's location in the current tree, greps for the described symptom, and checks git log for commits touching the area since the entry's origin date. Only concrete evidence like a file:line or commit hash qualifies an entry as already_resolved.

Can I run bmad-loop-sweep manually outside a sweep session?▼

No. The Skill checks the BMAD_LOOP_MODE environment variable and exits unless it equals 1. It is automation-only, designed to be invoked by the bmad-loop orchestrator, which validates its result.json deterministically.

How do I migrate a legacy freeform deferred-work.md to the DW format?▼

Invoke the Skill with --migrate and a manifest path. It rewrites every legacy item into canonical DW-<n> entries, keeps pre-existing DW entries byte-identical, and outputs a mapping from manifest keys to DW ids for orchestrator validation.

What happens if the triage result.json fails validation?▼

The orchestrator rejects the result and retries with a --feedback file listing the exact validation errors, such as missed or double-counted open ids, invalid bundle names, or missing evidence. The next attempt must fix exactly those defects.

When are deferred items treated as human decisions instead of bundles?▼

Frozen-block renegotiations, reversals of human-approved scope decisions, API-shape changes affecting unbuilt consumers, and entries deferred for human decision always become decisions with 2-4 options and a recommendation, never bundles.