← ClaudeAtlas

anneallisted

Debugging: reproduce → read-only RCA → approved minimal fix + regression test (always TDD). Triggers: 'anneal', 'debug', 'why is this broken'.
dyasnurhakim/smithy-claude · ★ 0 · Code & Development · score 67
Install: claude install-skill dyasnurhakim/smithy-claude
# Anneal — Debug via Root Cause Read `${CLAUDE_PLUGIN_ROOT}/references/creed.md`, `${CLAUDE_PLUGIN_ROOT}/references/memory.md`, and `${CLAUDE_PLUGIN_ROOT}/references/dispatch.md` first. Resolve memory first: `export SMITHY_MEM="$(bash ${CLAUDE_PLUGIN_ROOT}/scripts/paths.sh mem)"` — every smithy path below is relative to it, and it need NOT be inside the repo. If that dir does not exist, bootstrap per `${CLAUDE_PLUGIN_ROOT}/references/memory.md` § Location. Job slug: the active job from STATE.md, or `adhoc-<YYYY-MM-DD>` for standalone use. Log: `bash ${CLAUDE_PLUGIN_ROOT}/scripts/ledger.sh append anneal <slug> rca STARTED -` **Iron law: RCA before fix. Always.** No fix is written, suggested-as-final, or dispatched until a reproduced root cause exists. A fix without a root cause is a guess wearing a fix's clothes. ## Checklist (create a todo per item) 1. Capture symptom + repro command; write the failure-context file 2. Dispatch the annealer (read-only RCA) 3. Handle RCA status; never proceed without ROOT_CAUSE_FOUND 4. Present root cause + fix; get the user's approval 5. Apply via jigsmith (regression test IS the RED); review 6. Original repro passes; regression test committed; decisions logged ## Process 1. **Collect the failure.** From the user or the failing report: symptom, exact repro command, expected vs actual. **No repro command → get one first** — ask the user or derive it from the failing test. "It sometimes breaks" is not a symptom; "this command prod