| name | test-quality-maintenance |
| description | Generates, repairs, and improves tests and coverage. Use when writing unit tests, fixing failures, improving meaningful coverage, testing error handling, adding Playwright E2E tests, or creating focused benchmarks. |
Test Quality Maintenance
Use this skill for test work where the goal is behavior confidence, not line-count padding.
Shared Workflow
- Inspect the implementation, public API, existing tests, fixtures, mocks, helpers, and project conventions.
- Reproduce failing output when available.
- Fix root causes rather than updating assertions to match broken behavior.
- Add tests for real behavior: normal cases, edge cases, invalid input, async paths, failure paths, cleanup/rollback, integration boundaries, fixers, public API contracts, and user-facing messages.
- Keep mocks faithful to real behavior and avoid brittle sleeps or snapshots unless the project intentionally uses them.
- Run targeted tests first, then broader test, coverage, lint, typecheck, or build commands when warranted.
Coverage Work
Use coverage reports to prioritize high-risk and under-tested files. Aim for configured thresholds, but do not add empty assertions or tests that only execute lines. Document any intentional untested paths with a clear reason.
Playwright E2E
Inspect app structure, existing Playwright config, fixtures, selectors, auth helpers, and CI constraints. Cover the user journey end to end with stable selectors and deterministic setup. Include meaningful failure, loading, permission, and responsive states when they are part of the workflow.
Error Handling
Cover validation errors, external service failures, filesystem or network failures, auth failures, cleanup/rollback, retry behavior, logging, UI error boundaries, and user-facing messages. Assert that sensitive data is not logged or exposed.
Performance
Only add benchmarks when the project already supports them or the user explicitly wants a benchmark harness. Reuse existing thresholds and CI patterns. Measure latency, allocation, scaling, render time, I/O count, or query count as appropriate. Avoid noisy CI blockers unless the project already has stable budgets.
Output
Finish with scenarios covered, bugs fixed, files changed, commands run, coverage result when relevant, and any remaining test gaps.
