Devops Scripts Authoring

Conventions

• Use simple shell/python scripts to wrap common tasks.
• Avoid scripts when a popular native command exists.
• Locations: scripts/ and packages/*/scripts/.
• Style: minimal arguments, --help, fail fast, forward common errors, idempotent when sensible.
• Avoid Makefiles/Justfiles.

During development

• Run syntax checks and dry-runs.
• Manually inspect outputs and side effects.
• Document test steps in script comments.

Documentation

• Use a brief header comment and why-comments.
• Keep usage-level instructions in onboarding docs (skills).