bytelyst-devops-tools/CLAUDE.md

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. 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

./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
• AGENTS.md if agent navigation is affected