chore: formalize and standardize project scripts (permissions, comments, conventions)

[wambitz]

Problem

The scripts in this repository currently exhibit inconsistencies in permissions, structure, and use of comments. This leads to confusion and can potentially affect maintainability and portability across environments.

Proposal

• Define and document a standard for script file permissions (e.g., use chmod +x for all executables)
• Adopt a consistent header comment format for every script (including author, date, purpose, usage, etc.)
• Establish best practices for scripting conventions (error handling, shebang lines, consistent indentation, etc.)
• Update or refactor all scripts in the repository to adhere to these standards
• Add documentation somewhere visible (e.g., README or CONTRIBUTING.md) describing these standards

Motivation

• More predictable behavior across environments
• Easier onboarding and understanding for new contributors
• Higher long-term maintainability and code quality

Bare minimum task to start: collect and document current patterns in use throughout the repo before enforcing or refactoring anything. Further improvements can be implemented incrementally.