diff --git a/CLAUDE.md b/CLAUDE.md
index e4bb4d1..963a1bc 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -34,6 +34,12 @@ Do not assume a single dependency graph or runtime model across the whole repo.
 - `remove_user_from_repos.sh`
 - `git-work-safety-tools/*.sh`
 
+## Cutting Tracker Items
+
+When asked to "cut items to track", use `scripts/tracker-seed/` (seeds the
+ByteLyst tracker via platform-service `POST /api/items`). Do not hand-roll API
+calls. Full procedure is in the "Cutting Tracker Items" section of `AGENTS.md`.
+
 ## Safety Notes
 
 - Treat `accounts.json`, account snapshot JSON files, `.env` files, and generated contributor/output data as sensitive.
diff --git a/README.md b/README.md
index 64b8c46..9f83d92 100644
--- a/README.md
+++ b/README.md
@@ -42,6 +42,14 @@ If you are new to the repo, read these in order:
 
 These are for scanning many repositories, checking dirty state, and performing safer batch git workflows.
 
+### Work Tracking ("cut items to track")
+
+- `scripts/tracker-seed/seed-tracker-items.mjs`
+  - Files feature/bug/task items into the ByteLyst tracker (platform-service `POST /api/items`, viewed in tracker-web), scoped per `productId`.
+  - Preview safely: `node scripts/tracker-seed/seed-tracker-items.mjs --dry-run`
+  - Create (stack up): `JWT_SECRET=<secret> PLATFORM_API_URL=http://localhost:4003 node scripts/tracker-seed/seed-tracker-items.mjs`
+  - See [scripts/tracker-seed/README.md](scripts/tracker-seed/README.md) and the "Cutting Tracker Items" section in [AGENTS.md](AGENTS.md).
+
 ### Deployment Operations
 
 - `./deployment-status.sh`