saravanakumardb1 50d6424b85 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>

2026-05-30 21:22:43 -07:00

1.8 KiB

Raw Blame History

CLAUDE.md

Claude-specific working notes for this repository.

Read First

Use these as the canonical orientation docs:

README.md
docs/getting-started.md
docs/repo-map.md
docs/tooling-status.md
scripts/README.md
AGENTS.md

This file is intentionally short and should not become a second full repo README.

Repository Shape

The repo is a mixed workspace:

root Bash scripts for GitHub administration and maintenance
git-work-safety-tools/ for multi-repo git workflows
github_access_scripts/ and github_repo_scanners/ for access scanning
self-contained Python utilities in Slack Message/, youtube/, and supabase monitor/

Do not assume a single dependency graph or runtime model across the whole repo.

High-Value Files

bytelyst-cli.sh
remove_user_interactive.sh
remove_user_guided.sh
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.
Avoid echoing secret-bearing file contents unless the task requires it.
Many scripts are operational and potentially destructive. Preserve prompts, dry-run behavior, and confirmations unless asked to change them.

Developer Commands

./setup.sh
pre-commit run --all-files
./test.sh

Documentation Rule

If you change repo structure, onboarding, or navigation, update:

README.md
docs/repo-map.md
docs/tooling-status.md
AGENTS.md if agent navigation is affected

1.8 KiB Raw Blame History