/shell-idioms

What it is

Reusable shell and awk idioms for GAIA scripts and tests. Captures recurring anti-patterns (like the awk range-bug) and the canonical state-machine fixes.

Called by

• Loaded by authors writing new GAIA framework scripts and tests (contributor-facing)

What it does

Documents the awk range-bug: /start/,/end/ terminates on the start line when both patterns match the same line. Provides the state-machine fix.

Captures other recurring shell anti-patterns and their canonical fixes.

When you will see it surface

• You will not encounter this skill during normal GAIA usage. It is a reference for framework contributors writing shell scripts.

Technical notes

• All examples are POSIX-compatible unless noted.
• This skill is prose-only -- it documents conventions but does not execute anything.