x-testing-conventions

What problem does it solve?

Skill helps prevent slow or flaky test runs by standardizing how tests are organized by layer, how they are marked for parallelism, and how they follow a consistent AAA structure with reliable cleanup.

Core Features & Use Cases

• Test Layer Selection & Placement: Ensures tests live in the correct directory/lifecycle layer (unit/features/api-bdd/browser-bdd/smoke) so the right runner is used.
• Parallelism and Safety Guards: Recommends when to use t.Parallel() and when to avoid it for process-wide state changes (env/cwd/OpenTelemetry/global mutable fixtures).
• AAA Structure and Cleanup Rules: Enforces Arrange/Act/Assert readability and encourages t.Cleanup-based resource management.
• Naming and Maintenance Conventions: Promotes consistent case naming and discourages patterns that hide failures (e.g., improper skips).

Quick Start

Apply the x-testing-conventions skill when you add or refactor a Go test so it uses the correct test layer marker and follows AAA with safe isolation.