Name: Bash Standards Enforcer
Author: XIIIVI

Core Principles

VAR-001 — All script-level variables use UPPERCASE_UNDERSCORE. Lowercase only for for loop iterators.
VAR-002 — All variable expansions use ${VAR} syntax. No bare $VAR.
FNC-001 — Function parameters captured into locals must use _ARG suffix (FILE_ARG, MODE_ARG).
FNC-003 — local declarations are always on a separate line from assignments to preserve exit codes.
DEP-002/003 — All external commands declared in REQUIRED_DEPS and validated via validate_dependencies().
EOF-001 — Each heredoc marker is unique within the script (no duplicate EOF).
CMT-001 — Every function has a documentation comment block (purpose, Arguments, Returns).

Reference Files

Load these files on demand based on the task:

VAR-001 — All script-level variables use UPPERCASE_UNDERSCORE. Lowercase only for for loop iterators.
VAR-002 — All variable expansions use ${VAR} syntax. No bare $VAR.
FNC-001 — Function parameters captured into locals must use _ARG suffix (FILE_ARG, MODE_ARG).
FNC-003 — local declarations are always on a separate line from assignments to preserve exit codes.
DEP-002/003 — All external commands declared in REQUIRED_DEPS and validated via validate_dependencies().
EOF-001 — Each heredoc marker is unique within the script (no duplicate EOF).
CMT-001 — Every function has a documentation comment block (purpose, Arguments, Returns).

Load these files on demand based on the task:

Rule	What to check	Severity
VAR-001	Variable names are UPPERCASE_UNDERSCORE	WARNING
VAR-002	All expansions use `${VAR}`	WARNING
FNC-001	Parameter locals have `_ARG` suffix	WARNING
FNC-003	`local` separate from assignment	ERROR
DEP-002	All external commands in REQUIRED_DEPS	ERROR
DEP-003	`validate_dependencies` called in `main()`	ERROR
EOF-001	Heredoc markers are unique	WARNING
CMT-001	Every function has a doc comment	INFO