Devops Scripts
Conventions
- Use simple shell scripts to wrap common devops tasks.
- We don't provide scripts when a popular native command exists.
- Locations:
scripts/,packages/*/scripts/with conventional expressive names. - Style: minimal arguments,
--help, fail fast, forward popular commands error messages, idempotent when sensible. - Avoid Makefiles/Justfiles due to whitespace sensitivity and friction.
- Avoid package.json scripts except to call bash scripts or one-liners.
Development checklist
- Syntax checks
- Dry-runs
- Manual test runs with inspection of outputs and side effects
- Document test steps in script comments
Documentation
- Include a comment header and why-comments in code.
- Put usage-level instructions in a SKILL or AGENTS.md file referencing the script.