Shell/Bash Coding Standards

Core Principles

1. Simplicity: Simple, understandable scripts
2. Readability: Readability over cleverness
3. Maintainability: Scripts that are easy to maintain
4. Testability: Scripts that are easy to test
5. DRY: Don't Repeat Yourself - but don't overdo it
6. Defensiveness: Fail early, fail loudly

General Rules

• Defensive Header: Always use set -euo pipefail
• Quote Variables: Always quote variables "$var"
• Descriptive Names: Meaningful names for variables and functions
• Minimal Changes: Only change relevant code parts
• No Over-Engineering: No unnecessary complexity
• ShellCheck Clean: All scripts must pass ShellCheck