Fix

Activate When

• /godmode:fix, "fix this", "tests failing"
• Build, lint, or test returns non-zero exit code
• Called by other skills when checks fail

Fix vs Debug Handoff

/godmode:fix assumes root cause is KNOWN. If root cause unknown: route to /godmode:debug.

Workflow

# Detect stack and run checks
build_cmd 2>&1; echo "EXIT: $?"
lint_cmd 2>&1; echo "EXIT: $?"
test_cmd 2>&1; echo "EXIT: $?"

LOOP:
  error_count = run_all_checks()
  original = error_count
  IF error_count == 0: STOP — all checks pass

  WHILE error_count > 0:
    1. TRIAGE — priority: build > type > lint > test
       Run failing check, parse errors
    2. PICK — highest priority, not in skipped_list
       Create signature: "{file}:{line}:{error_code}"
    3. ANALYZE — read FULL error output (all lines)
       Read source at file:line +/- 15 lines
       Name mismatch: "expected X, got Y because Z"
    4. FIX — change = error_count:
         git reset --hard HEAD~1
         attempt_count[signature] += 1
         IF attempt_count >= 3: skip error
       ELSE: error_count = new_count
    7. LOG — append to .godmode/fix-results.tsv

THRESHOLDS:
  Max attempts per error: 3
  Max lines changed per fix: 5
  Status report: every 5 iterations
  Consecutive reverts to stop: 5
  IF all errors skipped: recommend /godmode:debug

One Fix Per Iteration

Fix ONE error per iteration. Verify. Commit. Next. Never batch-fix multiple errors in one commit. Each fix independently verifiable and revertable.

Output Format

Triage: {build|lint|test} failing with {N} errors
Pick: Fixing [{iter}/{original}]: {type} at {file}:{line}
Analyze: Root cause: {expected} vs {actual}
Verify (kept): KEPT: count {before} → {after}
Verify (revert): REVERTED: attempt {N}/3
Status: {remaining} remaining (from {original})
Final: Fixed: {original} → {count} in {N} iters.
  Skipped: {list}.

TSV Logging

iteration	error_type	file	line	fix_description	lines_changed	status

Hard Rules

Never ask to continue. Loop autonomously until done.

1. Inherits Default Activations per SKILL.md §14. Principles prelude, pre-commit audit, terse/stdio/tokens, DispatchContext validation, Progressive Disclosure routing, discard cost hierarchy all fire by default.
2. Fix ONE error per iteration — commit before verify.
3. Never suppress errors (@ts-ignore, eslint-disable,

any cast, empty catch) — fix the root cause.

1. Max 3 attempts per unique error, then skip.
2. Priority: build > type > lint > test.
3. Read FULL error output before fixing.

Anti-Patterns

1. Suppressing errors instead of fixing them.
2. Fixing multiple errors in one commit.
3. Modifying test expectations to match broken code.
4. Guessing without reading full error output.
5. Fixing symptoms downstream instead of root cause.

Quality Targets

• Fix success rate: >80% kept vs reverted
• Lines changed per fix: 5 consecutive reverts across different errors

## Error Recovery
- build_cmd not found: detect stack, set from config.
- Same error reappears: check for codegen (prisma,
  protoc). Run generator, then re-verify.
- Error count increases after revert: git stash,
  git reset --hard HEAD to known-good state.
- Fix requires test change: only if spec changed,
  commit separately as test({module}): update.
- All errors skipped: stop loop, print full list,
  recommend /godmode:debug.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [arbazkhan971](https://github.com/arbazkhan971)
- **Source:** [arbazkhan971/godmode](https://github.com/arbazkhan971/godmode)
- **License:** MIT

Install and usage instructions live in the source repository linked above.