From 50d6424b852ae31b2dd536cc55929b3ff8b3ab02 Mon Sep 17 00:00:00 2001 From: saravanakumardb1 Date: Sat, 30 May 2026 21:22:43 -0700 Subject: [PATCH] docs: surface "cut tracker items" workflow in README + CLAUDE Add a Work Tracking entry to README Primary Entry Points and a short pointer in CLAUDE.md, both routing to scripts/tracker-seed/ and the AGENTS.md section. Generated with [Devin](https://cli.devin.ai/docs) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- CLAUDE.md | 6 ++++++ README.md | 8 ++++++++ 2 files changed, 14 insertions(+) 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= 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`