diff --git a/AGENTS.md b/AGENTS.md
index 38df85014..3c38f1ab0 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -41,6 +41,11 @@
- Aim to keep files under ~700 LOC; guideline only (not a hard guardrail). Split/refactor when it improves clarity or testability.
- Naming: use **Clawdbot** for product/app/docs headings; use `clawdbot` for CLI command, package/binary, paths, and config keys.
+## Release Channels (Naming)
+- stable: tagged releases only (e.g. `vYYYY.M.D`), npm dist-tag `latest`.
+- beta: prerelease tags `vYYYY.M.D-beta.N`, npm dist-tag `beta` (may ship without macOS app).
+- dev: moving head on `main` (no tag; git checkout main).
+
## Testing Guidelines
- Framework: Vitest with V8 coverage thresholds (70% lines/branches/functions/statements).
- Naming: match source names with `*.test.ts`; e2e in `*.e2e.test.ts`.
diff --git a/README.md b/README.md
index e00703956..925246417 100644
--- a/README.md
+++ b/README.md
@@ -492,5 +492,5 @@ Thanks to all clawtributors:
-
+