playbook/antigravity-awesome-skills/skills/logic-fix-all/logic-fix-all-guide.md

Logic-Lens — Logic Fix All — Guide (Navigation)

This guide drives a full-repository logic-level semi-formal tracing pipeline, orchestrating logic-health → logic-review → logic-locate → logic-explain → logic-diff until the codebase is clean.

The only hard interaction point is Phase 0 (consent gate). After approval, the pipeline runs hands-free unless Phase 8 hits the iteration cap.

This is a logic review, not a syntax/style/lint pass.

---

Pipeline at a glance

  Phase 0 — Pre-flight notice & consent gate        ← hard stop, wait for user
  Phase 1 — Scope enumeration (role + risk tier)
  Phase 2 — Health pass (module Logic Score map)
  Phase 3 — Deep review (per-file semi-formal)
  Phase 4 — Fault location (conditional)
  Phase 5 — Path clarification (conditional)
  Phase 6 — Fix queue assembly (sorted, remedied)
  Phase 7 — Apply + verify (logic-diff)
  Phase 8 — Iteration loop (until clean or capped)
  Phase 9 — Final Fix Report

Where to find each phase

Phases	File
0, 1, 2	guide-phases-0-2-consent-scope-health.md — Pre-flight consent; full-repo file walk by role and risk tier; module Logic Score map.
3, 4, 5	guide-phases-3-5-review-locate-clarify.md — Per-file Premises→Trace→Divergence (Phase 3); conditional fault localization (Phase 4); conditional path clarification (Phase 5).
6, 7, 8, 9	guide-phases-6-9-fix-iterate-report.md — Fix queue sorted by severity (Phase 6); apply + verify via logic-diff, revert on regression, retry ≤3× (Phase 7); iteration loop with state tracking (Phase 8); Final Fix Report (Phase 9).

Phase-Gated Reading

Do not read the whole pipeline before the user consents.

Before Phase 0:

• Read ../_shared/common.md only for language, scope routing, fix-all header fields, config fields, and loading budget.
• Read this file through the phase map.
• Read guide-phases-0-2-consent-scope-health.md only through Phase 0 so the consent prompt is accurate.

After consent:

• Read the active phase section when entering that phase.
• Load shared files and other skill guides only when the current phase invokes that methodology.
• Keep a small state record with phase, scanned files, findings, fixes, and unresolved signatures so later phases do not require re-reading prior phase text.

Running without git

Phase 1 uses git ls-files as the default enumerator. If .git is absent, fall back to a recursive file walk with the same ignore patterns. Report the fallback in the Scope table.

When to hand control back to the user

1. Phase 0 — always, before any scanning or editing.
2. Phase 8 iteration cap — when fix_all.max_iterations Warning/Suggestion rounds have run with remaining non-Critical findings. Three consecutive "continue"s hit a hard ceiling.
3. Phase 6 constraint-vs-code tie — when a finding could be fixed by editing either the code or a behavioral doc/config and neither side is clearly authoritative.

Output format

Fix Report layout: header fields → Findings + Summary → fix-all extensions (Scope / Skill Invocations / Iteration History / Fix Log / Resolved by Clarification / Unresolved Findings) after Summary. Render per common.md §1 language rule.