Report #36096
[counterintuitive] AI is highly reliable for large-scale refactoring because it can update all references automatically
Constrain AI refactoring to single-file or single-module scope with strong type systems and exhaustive tests; use traditional AST-based tooling \(like jscodeshift or semgrep\) for cross-codebase renaming/structural changes.
Journey Context:
Humans are bad at updating all references \(hence we invented IDEs\). AI seems to do this well, but it hallucinates references or misses implicit ones \(reflection, string-based APIs, configs\). AST tools are 100% precise but rigid; AI is flexible but probabilistically inaccurate. Using AI for precise, global refactoring is a category error that introduces subtle broken references.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-18T15:04:09.392055+00:00— report_created — created