AGH Test Conventions

40%+ of CodeRabbit review issues across all AGH PRs are test-shape violations. The CLAUDE.md rules are correct but agents keep ignoring them when adding "just one more case." This skill is the Go test-shape gate after consolidate-test-suites has justified the invariant, owning layer, and canonical suite.

Procedures

Step 0: Confirm Placement

1. Use consolidate-test-suites before creating a new Go test file, moving coverage, or adding tests primarily for a task checklist or coverage target.
2. Record the invariant, owning layer, and canonical suite before applying Go-specific shape rules.
3. If no invariant or owning layer exists, stop. Do not add a Go test just to raise coverage.

Step 1: Identify the Edit Surface

1. Determine whether the edit creates a new test file, adds cases to an existing test, or refactors an existing test.
2. Read the existing file (if any) so the new cases match the established subtest pattern.
3. Read references/test-shape-rules.md for the canonical rule list.

Step 2: Apply Subtest Discipline