kevinveenbirkenbachandClaude Opus 4.7
c02229b4be
Apply a consistent naming convention to the Make target inventory so
every target is grouped by its domain:
- compose-* (compose-up/down/restart/stop/exec/inner-run)
- network-* (network-dns-setup/remove, network-ipv6-disable/restore,
network-refresh, network-trust-ca)
- security-* (security-apparmor-restore/teardown)
- diagnose-* (diagnose-network, diagnose-disk-usage)
- fix-* (fix-chmod, fix-dockerignore)
- clean-* (clean-cache, clean-pycache-dirs)
- install-* (install-agent)
- meta-* (meta-list, meta-tree, meta-mig)
Drop the stale debug-network target and reintroduce its functionality
as diagnose-network. Cascade renames through:
- Makefile (.PHONY entries, prereqs, recursive $(MAKE) calls)
- contributor docs, agent-iteration docs, role-level docs
- bundle README, environment scripts, install/lint/test wrappers
- AGENTS.md, CLAUDE.md, compose/cache.override.yml, .github/workflows
Historical entries under docs/requirements/ and changelog/ stay
untouched as audit logs.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1.3 KiB
Makefile Commands 🛠️
Use these commands from the repository root.
make help
prints the full list of targets, one row per target with a one-line description. Treat its output as the authoritative target list.
For rules on how to write and structure the Makefile itself, see makefile.md.
Focused guides 📋
These pages drill into a single workflow rather than enumerate every target. make help is the authoritative list of available targets:
- Network debugging:
make diagnose-network(DNS / TCP / TLS / PMTU diagnostics inside the dev container) plus MTU / IPv6 / connectivity troubleshooting. - For app-level local deploy flows and end-to-end checks, see Development & Testing.
Git 🔐
Remote setup and signed pushes are handled by git-maintainer-tools, installed through make install-python-dev (see remotes.md). The tool's git-setup-remotes and git-sign-push CLIs MUST be invoked directly; there are no make wrappers in this repo. Direct git push is denied in settings.json, and agents MUST instruct the operator to run git-sign-push outside the Claude sandbox.