This pattern focuses on reducing blast radius while agents modify many files.
Recommended workflow
- Split work by path namespace and assign ownership per agent.
- Require
list_changes snapshots at each milestone.
- Diff critical files before merge using
get_diff.
- Restore only the failed path segments when regressions appear.
list_changes(agentId="key:abc:refactorer", since="2026-04-01T00:00:00Z")
get_diff(path="src/router.ts", from_version="ver_a", to_version="ver_b")
restore_version(path="src/router.ts", version_id="ver_a")
Guardrails
- Enforce path ACLs for each refactor domain.
- Keep rollback runbooks next to deployment procedures.
- Capture audit artifacts for post-change review.
Coming soon: reference branch policies and reusable PR checklists for common refactor classes.
