59 lines
1.5 KiB
Markdown
59 lines
1.5 KiB
Markdown
# 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`
|
|
|
|
## 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
|