diff --git a/CLAUDE.md b/CLAUDE.md
index fc56b827..3dd9e30f 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -573,7 +573,7 @@ Wiring a new bundling step:
 | `current/PLAN-ERR.md` | **Active** ERR implementation plan (`!` errors, `try` / `catch` / `or` / `onfail`, return traces). |
 | `current/CHECKPOINT-ERR.md` | **Active** ERR progress tracker. Update after every step. |
 | `implementation_plan.md` | Archive of completed work (closures, protocols, etc.). Do not pick up tasks from here. |
-| `readme.md` | Original syntax sketches. Do not modify. |
+| `readme.md` | User-facing language overview — **maintained**. Update it whenever a user-facing sx change lands (new/changed syntax, semantics, gating diagnostics, language behavior), per the docs-track-changes rule. |
 | `CLAUDE.md` | This file. Session instructions. |
 | `library/modules/platform/bundle.sx` | sx-side `.app` / `.apk` bundler. See "Bundling lives in sx" above. |
 | `library/modules/fs.sx`, `library/modules/process.sx` | POSIX stdlib for the bundler + general consumer use. |