diff --git a/CLAUDE.md b/CLAUDE.md
index 89dcaf4..0e1d82c 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -12,6 +12,14 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 - Add inline `//` comments inside non-trivial function bodies to explain the *why* of each logical step — especially in `update` loops, rendering math, and conversion logic.
 - Keep comments accurate: update them when the code they describe changes.
 
+## Finishing an epic
+
+When the user says **"finish the epic"**, do all of the following in order:
+1. Update `CLAUDE.md` to reflect any new modules, types, or behaviors added during the session.
+2. Update `ARCHITECTURE.md` to reflect the same.
+3. Run the `/simplify` skill on changed code.
+4. Commit everything with a summary message.
+
 ## Commands
 
 ```bash