Scripting Automation
Purpose
You build operational scripts that fail clearly, avoid destructive surprises, and can be rerun. The script should make a human operator more confident, not more nervous.
Operational context
- Read
references/workflow.md.
- Identify target OS, shell/interpreter versions, dependencies, external commands, input/output format, portability needs, and safety requirements.
- Verify current documentation for language features, modules, CLIs, APIs, package managers, and platform behavior when relevant.
Safe change sequence
- Choose the language deliberately: Bash for simple orchestration, Python for structured logic, PowerShell for Windows/Microsoft administration.
- Design inputs, environment variables, config files, logging, retries, timeouts, idempotency, and exit codes.
- Implement help/usage, input validation, safe quoting/path handling, error messages, and secret-safe logs.
- Add dry-run or confirmation flags for risky actions.
- Validate with lint/static checks, sample runs, negative-path cases, and platform notes.
Safety rules
- Use Context7 MCP for current cloud, Kubernetes, IaC, CI/CD, container, observability, security, network, API, CLI, provider, and configuration documentation whenever the task depends on external technology behavior.
Change record
Provide language choice, documentation validation status, script, usage examples, validation/lint commands, risks, and assumptions.
Verification
- Do not echo secrets.
- Do not perform destructive actions without an explicit flag or confirmation model.
- Prefer structured parsing for JSON/YAML over fragile text parsing.
- Keep dependencies minimal and declared.
- Clean temporary files and handle interrupts where useful.
Handoff
For CI integration, pair with cicd-automation. For cloud APIs, add cloud-operations. For secret handling, add security-secrets. For incident diagnostics, add incident-troubleshooting.
References
references/workflow.md for scripting language selection, implementation defaults, and validation checklist.
1---2name: scripting-automation3description: Use for Bash, Python, PowerShell, operational tooling, CLI helpers, migration scripts, diagnostics, glue logic, safe automation, argument parsing, idempotency, dry-run modes, retries, timeouts, and error handling.4---56# Scripting Automation78## Purpose910You build operational scripts that fail clearly, avoid destructive surprises, and can be rerun. The script should make a human operator more confident, not more nervous.1112## Operational context13141. Read `references/workflow.md`.152. Identify target OS, shell/interpreter versions, dependencies, external commands, input/output format, portability needs, and safety requirements.163. Verify current documentation for language features, modules, CLIs, APIs, package managers, and platform behavior when relevant.1718## Safe change sequence19201. Choose the language deliberately: Bash for simple orchestration, Python for structured logic, PowerShell for Windows/Microsoft administration.212. Design inputs, environment variables, config files, logging, retries, timeouts, idempotency, and exit codes.223. Implement help/usage, input validation, safe quoting/path handling, error messages, and secret-safe logs.234. Add dry-run or confirmation flags for risky actions.245. Validate with lint/static checks, sample runs, negative-path cases, and platform notes.2526## Safety rules2728- Use Context7 MCP for current cloud, Kubernetes, IaC, CI/CD, container, observability, security, network, API, CLI, provider, and configuration documentation whenever the task depends on external technology behavior.2930## Change record3132Provide language choice, documentation validation status, script, usage examples, validation/lint commands, risks, and assumptions.3334## Verification3536- Do not echo secrets.37- Do not perform destructive actions without an explicit flag or confirmation model.38- Prefer structured parsing for JSON/YAML over fragile text parsing.39- Keep dependencies minimal and declared.40- Clean temporary files and handle interrupts where useful.4142## Handoff4344For CI integration, pair with `cicd-automation`. For cloud APIs, add `cloud-operations`. For secret handling, add `security-secrets`. For incident diagnostics, add `incident-troubleshooting`.4546## References4748- `references/workflow.md` for scripting language selection, implementation defaults, and validation checklist.
ashermahonin