fix

TARGETED FIX — reads an audit document's "Actionable Errors" section and fixes each error. Can be used standalone or invoked by the pipeline.

The user's request is: $ARGUMENTS

---

Phase 1 — Find Inputs

Search Working Logs/ for an audit document whose filename starts with audit-impl-- and contains the argument (case-insensitive).

• If multiple matches: list them and ask the user to pick one.
• If no match and argument looks like a file path: try reading it directly.
• If no match: tell the user no audit found and exit.
• If no argument: use the most recently modified file in Working Logs/ whose name starts with audit-impl--.

Read the audit document in full.

Parse the "Actionable Errors" section. If no such section exists: tell the user "This audit does not have a structured Actionable Errors section. Run /audit-implementation with the latest skill version to generate one." and exit.

From the audit header, read:

• The referenced impl plan from Implementation Plans/
• The referenced working log from Working Logs/ (if it exists)

---

Phase 2 — Read Context

For each actionable error entry, read every file listed in its File(s) field.

If the audit references a worktree in its header, resolve and use that worktree as the working root for file reads and edits.

---

Phase 3 — Fix Each Error

For each actionable error (skip entries under "Not actionable"):

1. Read the relevant file(s) fresh (they may have changed since the audit)
2. Apply the suggested fix using Edit/Write
3. After each fix: verify no errors were introduced by running the project's build/lint/test command as appropriate
4. If a fix introduces new errors:
   • Revert the change
   • Try a different approach (max 2 attempts per error)
   • If both attempts fail: mark as "fix failed" with explanation
5. If the suggested fix doesn't apply (file changed, method renamed, etc.): mark as "deferred to user" with explanation

Log each fix result as you go — do not batch.

---