← knowledge.oriz.in

Always review in fresh context, never inline after implementation

rule rulesagentreviewcontextsubagents

Review in fresh context

Failure mode

60K-token impl session ends. User: "now review changes." Reviewer runs in already-degraded context. Context cliff hit. Standards forgotten. Bugs missed.

Reviewer inherits impl session's:

Fix — ranked

Rank Fix When
1 Delegate to subagent (fresh context) Default. Per [[delegate-to-subagents-by-default]]
2 /clear + reload standards + re-open diff If subagent unavailable
Never Continue inline after impl Always wrong

Yardstick

Reviewer measures diff against STANDARDS, not conversation history. History is noise. Standards from knowledge/ are signal.

Combine with [[coding-standards-push-pull]] — reviewer's fresh context gets standards pushed in explicitly.

Concrete pattern

After impl completes, spawn Explore/Plan/reviewer subagent with exactly:

  1. The diffgit diff main...HEAD or working tree
  2. Relevant standards — file paths from knowledge/rules/ + knowledge/decisions/
  3. Nothing else — no impl session transcript, no rationalizations, no "we decided X because Y"

Subagent prompt shape:

Review this diff against these standards.
Diff: <paste or path>
Standards: knowledge/rules/development/*, knowledge/rules/security/*
Return: findings only. Terse. No praise.

Why subagent > /clear

Anti-patterns

Source

Matt Pocock workshop 2026-07-03.

Cross-refs