anneallisted
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