Your Wiki Is Lying. Git Isn’t.
Move 1 is Context. Your Confluence page and migration guide drifted from production years ago. Git didn't. Before the agent touches a file, feed it all four sources at once: commit history, prior merged pull requests, the live production code, and the team wiki.
When you cross-check all four on a legacy payments service, the agent immediately flags where the wiki lies: the 2022 doc says European invoices wait two days, while production switched to next-day payouts two years ago; the doc says failed payouts retry three times, while production retries five; the doc claims standard cent rounding, while production runs a custom 2019 banker’s rounding rule (ROUND_HALF_EVEN) on cross-border FX.
Move 2 is Collaboration—and it flips the direction of the prompt. Don't write a 2,000-word prompt guessing what the agent needs. Type /grill-me and let the agent interview you in plain English about every contradiction it found:
“There’s a custom currency rounding rule from 2019. Is that a bug to fix, or does Finance depend on it?”
That second question is the load-bearing quirk. A naive agent would have “cleaned it up” and broken month-end close. Answering three plain-English questions kills the ambiguity before a single line of code is written.
Still in collaboration, type /plan. The agent writes MIGRATION_PLAN.md—mapping the blast radius across services, the order of operations, and the parity harness—while Code edits: 0. You review one page of plan instead of ten thousand lines of diff.
In Production · Payments Gateway Migration
“For a payments gateway migration spanning 49 RPC methods, we pointed Antigravity at our migration guide, code generators, and 18 prior pull requests. It first flagged 10 undocumented edge cases in the guide, and then helped us run a repeatable workflow that produced 47 tested pull requests across three microservices over two days.”