apply-go-test-convention

Define an anonymous struct slice with id, name, description, Given, When, and Then fields in that order, then run one loop with t.Run using tt.id and tt.name. Use require for preconditions like NoError and assert for independent expectations like Equal.

Copy the document's BDD ID verbatim into the id field, the heading into name, and the gherkin block unmodified into a raw-string description. BDDs you choose not to test go in a trailing comment with reasons, so every document ID appears either as a case or an exclusion.

This convention requires external {pkg}_test packages so private functions and fields stay unreachable. Testing only the public API keeps tests green through internal refactors; export_test.go is explicitly disallowed.

Boolean flags like shouldFail pass on any error, including unrelated failures, and string matching breaks on message changes. Storing a sentinel error in wantErr and checking with require.ErrorIs verifies the exact expected failure.

Use setup func(t *testing.T) fixture only when Given needs t (TempDir, Cleanup, transactions) or non-serializable resources like DB handles, and only when it differs per case. Otherwise express Given as plain data fields.

It verifies five predicates: external test package, unique non-empty ids, adjacent id/name/description lines, unique names, and gherkin heading order. It cannot judge whether tests are table-driven, correct, or cover all document BDDs; that requires human review and layer-specific checks.