Add Codex repository guidance and validation

2026-05-10 11:11:03 +00:00
parent 0d3905b8a1
commit a527022518
17 changed files with 935 additions and 23 deletions
@@ -21,3 +21,4 @@ flowchart TD

 - The repository currently emphasizes Bash because it maps directly to day-to-day Linux operations.
 - The structure leaves room for higher-level helpers without mixing concerns.
+- Bash tooling should remain safe by default, readable, and validated with `../../scripts/check-bash.sh` from the repository root.
@@ -39,6 +39,14 @@ cd infra-run/scripts/bash/os-healthcheck
 ./network_troubleshoot.sh google.com
 ```

+## Standards
+
+- Scripts use Bash and should keep `#!/usr/bin/env bash` plus strict mode.
+- Read-only checks should report missing tools without hiding the problem.
+- Change-capable scripts must default to dry-run behavior and require explicit `--execute`.
+- Output should use `OK`, `WARNING`, and `CRITICAL` where practical.
+- Validate changed scripts with `./scripts/check-bash.sh` from the repository root.
+
 ## Exit Codes

 `disk_check.sh`: