gritql: AST-Based Code Transformation

Use grit for structural code rewrites. Unlike text-based find/replace, gritql understands code syntax and rewrites safely across all occurrences.

When to Use

Use gritql for:

• Renaming methods, classes, variables across many files
• API migrations (library version upgrades)
• Pattern modernization (legacy → idiomatic code)
• Any change where "find all + replace" needs syntax awareness

Don't use for:

• Single-file edits → use Edit tool
• Non-code files (YAML, JSON, MD) → use Edit tool
• Simple text substitution → use MultiEdit
• Code searching → use code-ast-grep instead

⚠️ Critical: Go Package Prefix Migrations