diff --git a/templates/CLAUDE.md b/templates/CLAUDE.md
index 120e15d..84d6dfb 100644
--- a/templates/CLAUDE.md
+++ b/templates/CLAUDE.md
@@ -6,6 +6,14 @@ Apps are server-rendered TypeScript using **Hype** (wraps Hono) and **Forge** (C
 
 Runtime is **Bun**.
 
+## Required Components
+
+Every toes app/tool must have:
+
+1. **`.npmrc`** pointing to `registry=https://npm.nose.space` (the private registry for `@because/*` packages)
+2. **`package.json`** with a `scripts.toes` entry (this is how toes discovers and runs apps)
+3. **HTTP `GET /ok`** returning 200 (health check endpoint — toes polls this every 30s and restarts unresponsive apps)
+
 ## App vs Tool
 
 An **app** shows in the sidebar and opens in its own browser tab.