agh-test-conventions

What problem does it solve?

This Skill prevents AGH Go tests from silently drifting into inconsistent “test shapes” that weaken review quality and break long-term maintainability.

Core Features & Use Cases

• Subtest discipline: requires every case to be its own t.Run("Should ...", ...) subtest and supports table-driven layouts with clear name fields.
• Parallelism correctness: makes t.Parallel() the default for independent subtests while forbidding t.Parallel() in tests that use t.Setenv, including transitive usage.
• Strong error handling and assertions: blocks underscore-discarded errors, discourages status-code-only assertions, enforces deterministic time/IDs, and strengthens integration/E2E expectations.
• Use Case: when adding new cases to an existing Go test under internal/ or cmd/, you use this Skill to ensure each new case matches AGH’s canonical test structure and assertion strength.

Quick Start

Use agh-test-conventions to validate your changes to any *_test.go file under internal or cmd by running the Python checker on the specific test file you edited.