Review Packs
Review packs make agent output auditable.
They answer the questions reviewers always need answered:
- what changed
- where it changed
- how it was verified
- what risk remains
- how to roll it back
- what a human must decide
Template
Section titled “Template”## Review PackRepo:Branch:PR:Task:Status: done / blocked / needs reviewSummary:Commits:Files changed:Verification:Risk level:Rollback plan:Human decision needed:Next recommended task:Good Summary
Section titled “Good Summary”Summary:Added a repository-level AGENTS.md with branch policy, atomic commit rules, risk escalation, and review pack format. Linked CLAUDE.md to the new source of truth.Weak Summary
Section titled “Weak Summary”Summary:Cleaned up docs and improved workflow.The weak version hides the actual work.