gopherstack: Skill for Claude Code

gopherstack tests

Canonical template

Real example, trimmed from services/grafana/workspaces_test.go:73-116:

func TestCreateWorkspace_Validation(t *testing.T) {
	t.Parallel()

	_, client := newTestHandlerAndClient(t)

	tests := []struct {
		mutate func(*grafanasdk.CreateWorkspaceInput)
		name   string
	}{
		{
			name: "invalid accountAccessType",
			mutate: func(in *grafanasdk.CreateWorkspaceInput) {
				in.AccountAccessType = "BOGUS"
			},
		},
		{
			name: "ORGANIZATION without organizational units",
			mutate: func(in *grafanasdk.CreateWorkspaceInput) {
				in.AccountAccessType = types.AccountAccessTypeOrganization
			},
		},
	}

	for _, tc := range tests {
		t.Run(tc.name, func(t *testing.T) {
			t.Parallel()

			in := minimalCreateWorkspaceInput()
			tc.mutate(in)

			_, err := client.CreateWorkspace(t.Context(), in)
			require.Error(t, err)

			var ve *types.ValidationException
			require.ErrorAs(t, err, &ve, "expected a real ValidationException from the SDK deserializer")
		})
	}
}

Shape: anonymous []struct{...} (not a named type, not map[string]struct), loop var tc or tt, t.Run(tc.name, ...), t.Parallel() in the outer func and inside each subtest closure.

Naming: do / don't

The subtest name: field is a short lowercase phrase, not a sentence and not the test's own restated purpose.

Data: across ~32k table-case names in services/, 73% are a single word, 92% are three words or fewer. Longer ones exist mostly as "<Operation> <condition>" (e.g. "DeleteTask unknown ARN returns 404") when the case needs to name which SDK op it targets — still one clause, no filler.