# CLAUDE.md

Claude-specific working notes for this repository.

## Read First

Use these as the canonical orientation docs:

1. `README.md`
2. `docs/getting-started.md`
3. `docs/repo-map.md`
4. `docs/tooling-status.md`
5. `scripts/README.md`
6. `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

```bash
./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
