← ClaudeAtlas

diagnoselisted

Use when a bug, regression, crash, flaky test, or a report that "X is broken / throwing / failing / slow", "why is prod down", or "make it faster" needs root-causing before any fix - the fix-side entry into the work-item loop, where a symptom becomes a reproducible red signal and a root cause.
yoelgal/agent-tools · ★ 1 · AI & Automation · score 68
Install: claude install-skill yoelgal/agent-tools
# Diagnose a bug into a fix-contract The front-end for a `fix/` work item. Turn a bug report into two things the loop can drive: a **red-capable signal** (a command that already fails on this bug) and a **falsifiable root cause**. Package them as a fix-contract in the ledger and hand off to `/autonomous-loop`, which drives the same red→green loop a feature does. One job: **make the bug reproducible and explained before anyone touches a fix.** Read `.better-dev/overrides.md` first - a project override (a repro command, a test seam convention, a "we never instrument prod" rule) wins over anything here. Locate the repo's contribution guide in the same setup read: an override may pin its path; else look for `CONTRIBUTING.md` or a coding-standards file at the root, under `docs/`, or under `.github/`. If present, read it - documented test requirements feed the fix-contract's done-criteria, PR-size and process rules feed the fix scope, and branch/commit conventions ride the contract as premises. The fix-contract carries one census line - "contribution guide: `CONTRIBUTING.md`" or "no contribution guide found" - so a missed guide is a visible miss, not a silent one. Before you re-derive anything about this area, spend one recall on it (`.better-dev/bin/bd-mem recall "<area>"`) and cite what it returned, or an explicit "recall empty" - a lesson you already paid for is cheaper than the mistake it prevents. A recalled lesson is a prior claim, not a current fact - verify it against t