diff --git a/CLAUDE.md b/CLAUDE.md
index 397875f..7aa0589 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -48,6 +48,16 @@ just check  # lint + typecheck + test
 
 Commit after each logical change. One change = one commit. Keep commits atomic.
 
+### Code review
+
+Run code review after completing a phase or significant chunk of work:
+- Use `superpowers:code-reviewer` agent
+- Provide: what was implemented, git range (base SHA to head SHA), requirements
+- Fix critical/important issues before moving on
+- Minor issues can be noted and deferred
+
+Review loop: implement → just check → code review → fix issues → re-review if needed → pause for user.
+
 ## Bun defaults
 
 - Use `bun <file>` instead of `node <file>` or `ts-node <file>`