wrought-rca-fix

name	wrought-rca-fix
description	Start an autonomous RCA bugfix loop with test verification
disable-model-invocation	false
wrought	{"version":"1.0","tools":{"capabilities":["read_file","search_content","find_files","write_file","edit_file","run_command"]},"platforms":{"claude-code":{"allowed-tools":"Read, Grep, Glob, Write, Edit, Bash","disable-model-invocation":false}},"agent":{"role":"RCA Engineer","expertise":["bug fixing","test verification"],"non_goals":["architectural redesign","feature development"]},"execution":{"default_mode":"react","stop_conditions":["Verifier passes (bug fixed)","Max iterations reached","User instructed to stop"]},"output":{"format":"markdown","template":"docs/capsules/{finding_id}/iter_{N}/run.log","required_sections":["Fix summary","Verifier result"]},"pipeline":{"track":"reactive","standalone":false,"prerequisites":["docs/RCAs/*.md"],"produces":["docs/capsules/**/run.log",".claude/wrought-loop-state.json"],"suggested_next":["forge-review"]}}

Wrought™ RCA Fix — Autonomous Bugfix Loop

You are starting a Ralph Wiggum inner loop for an RCA bugfix. A Stop hook will automatically verify your fix after each attempt to stop.

Step 1: Check for Active Loop

Read .claude/wrought-loop-state.json. If it exists and active is true:

• WARN: "An active loop already exists. Run /cancel-wrought-loop first, or continue the existing loop."
• STOP — do not proceed.

Step 2: Identify the RCA Report

The user should provide an RCA path. If not provided:

1. Use Glob to find the most recent file in docs/RCAs/*.md
2. Read it and confirm with the user: "Found RCA: {path}. Proceed?"

Step 3: Read Verifier Config

Resolve the verifier command in this order:

1. If .claude/wrought-loop-state.json exists and its verifier_command is a non-empty string, propose it for confirmation: "Reuse verifier command {command}?"
2. Otherwise ask the user: "What verifier command should I use? (e.g., uv run pytest tests/ -q)"

Ask regardless of verifier_type. Never synthesise a verifier command from verifier_type — no mapping from a type token to a command exists anywhere in Wrought, and the loop must not invent one.

Then read the .wrought marker for:

• verifier_type — advisory metadata only; it may seed the example above and gates nothing
• verifier_test_path — default test path
• verifier_max_loops — iteration budget
• verifier_timeout — per-run timeout in seconds

Step 4: Initialize Loop State

Write .claude/wrought-loop-state.json:

{
  "active": true,
  "preset": "wrought-rca-fix",
  "finding_id": "{from RCA or Findings Tracker}",
  "tracker_path": "{path to active FINDINGS_TRACKER.md}",
  "verifier_command": "{verifier command}",
  "max_iterations": {from marker},
  "current_iteration": 0,
  "started_at": "{ISO timestamp}",
  "history": []
}

Step 5: Apply Fix

1. Read the RCA report thoroughly — understand the root cause and proposed fix
2. Apply the fix as described in the RCA report
3. After applying, the Stop hook will automatically run the verifier
4. If the verifier fails, you will be blocked — analyze the error output and iterate on the fix
5. Continue until the verifier passes (bug is resolved)

Redline Escalation (max iterations exhausted on the same failing signature)

If the loop hits max_iterations still failing the same test signature:

1. First rule out a mis-specified oracle — a wrong or oversharp assertion, a flaky or environment-coupled test, or an AC the verifier cannot actually observe. A bad oracle is the common cause; fix the test, don't force the fix.
2. Only then, the operator may take ONE supervised /model fable pass on the capsule tail to generate a fresh candidate root-cause hypothesis or fix approach, then return with /model opus to evaluate and apply it. Fable generates a candidate, never grades; watch for empty/refused output (a refusal is a non-answer, not a clean pass). This is a manual, opt-in, owner/ZDR-free escalation — no committed model: pin anywhere (see CST-004).
3. A conditional cross-lab overseer pass exists at review time (/forge-review Step 4c); do NOT invoke it from inside the loop — never in Stop-hook continuations (the loop's oracle is tests).

Step 6: Completion

When the loop completes (verifier passes):

1. Read the final .claude/wrought-loop-state.json to summarize iterations
2. Report: "RCA fix applied and verified after {N} iterations. Capsule artifacts at docs/capsules/{finding_id}/"
3. Update the Findings Tracker with fix status
4. Suggest: "Fix verified. Next: run /forge-review --scope=diff to verify code quality."