skill-testing-standards

Replace time.Sleep with await-based polling for asynchronous checks to reduce flaky integration tests. Await-based assertions ensure conditions are met before proceeding, eliminating timing guesswork and false failures.

Defensive testing patterns structure unit tests to cover both happy and unhappy paths, enforcing ADR-0008 requirements. Table-driven test cases with rationale fields explain why each scenario matters, ensuring comprehensive path coverage and isolation.

Use Testcontainers to set up deterministic database tests that provide repeatable, isolated environments. Containerized databases ensure each test run starts from a clean state, preventing cross-test contamination and data-dependent flakiness.

Use testify require for test setup operations that must halt on failure, and assert for verifications that should collect multiple errors. This structured assertion approach provides clear error messaging and prevents cascading test failures.

Apply table-driven tests when validating multiple scenarios against the same logic, ensuring isolation and including rationale fields explaining why each case matters. This standardizes test cases and improves coverage visibility across defensive testing paths.