diff --git a/CLAUDE.md b/CLAUDE.md
index 87dc448..19fd5e4 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -11,8 +11,8 @@ oci-archive`/modern `docker save`) using `containers-storage` and `fuse-overlayf
 target is Android with a stock kernel, where `podman`/`docker` don't run (missing
 namespace support) and there's no kernel overlayfs (hence `fuse-overlayfs`); `bwrap` is
 invoked in "degraded mode" using only whichever `--unshare-xxx` namespaces the running
-kernel actually supports. There is no README or broader architecture doc yet — treat
-this repo as still early-stage.
+kernel actually supports. See `README.md` for the human-facing overview (build/usage/
+status); this file stays the dense, file-by-file reference. Still early-stage.
 
 Source layout (all under `src/`):
 - `main.cpp` — CLI entry point, dependency checks, orchestration (`mount_image()`,