AGENTS.md@skills/testing/maintainable-tests git:20260912.938fe03A

Immutable. This exact content is served forever at /api/v1/blob/568bca23f258f86b.

# maintainable-tests

Use this skill passively whenever writing, editing, refactoring, reviewing, or planning tests. It keeps tests readable as living documentation, onboarding material, and explicit coverage for edge cases, regressions, and legacy behavior.

Keep `SKILL.md` authoritative. The wrapper files only describe packaging.

Core references:

- `references/principles.md`
- `references/naming-and-intent.md`
- `references/structure-and-fixtures.md`
- `references/doubles-and-boundaries.md`
- `references/legacy-and-characterization.md`
- `references/side-effects-and-compatibility.md`
- `references/review-rubric.md`
- `references/gotchas.md`

Primary helper:

- `scripts/analyze_maintainable_tests.py`