diff --git a/agents.md b/agents.md
index 3017000..b647fc5 100644
--- a/agents.md
+++ b/agents.md
@@ -228,6 +228,12 @@ not free placement. Don't confuse the two.
 - CSS classes are prefixed by area: `win-` (desktop), `app-` / `kickoff` etc.
   (desktop windows), plus the editorial design-system classes (`shell`, `display`,
   `label`, `rule*`, `glass*`). Grep by prefix to find styles.
+- The editorial page reveals blocks with `.reveal` (see `Reveal` in
+  `editorial-ui.tsx`): hidden by default, `.is-in` shows. On load the first
+  screenful cascades top-to-bottom (90ms per block, in DOM order); the rest
+  reveal when they scroll in. **Wrap every content block** — anything left
+  unwrapped paints before the top and breaks the top-to-bottom order. The
+  `<noscript>` rule in `layout.tsx` keeps everything visible without JS.
 - Several places deliberately use **imperative DOM work** (e.g. the drag ghost).
   This is intentional for performance; prefer matching the existing pattern over
   "Reactifying" it.