AGENTS.md Sync

Detect when code changes make durable AGENTS.md guidance stale and produce a report with specific recommendations. Treat AGENTS.md files as operating manuals for future agents, not changelogs for recent diffs.

When to use

• Before creating a PR — check if the branch's changes warrant AGENTS.md updates
• After a PR merges to main — audit whether merged changes left AGENTS.md files outdated
• On explicit request — "are the AGENTS.md files up to date?"

Workflow

1. Determine the diff

Figure out what changed relative to the base branch. The approach depends on context: