SKILL.md
Test Readability and Clarity Check Approach
The Test Readability and Clarity Check is a dual-agent validation approach that assesses whether a test suite effectively documents system behavior by reconstructing system understanding purely fro...
Instructions
The Test Readability and Clarity Check is a dual-agent validation approach that assesses whether a test suite effectively documents system behavior by reconstructing system understanding purely from test code. This approach validates that tests serve as executable specifications and identifies gaps in architectural context documentation.
Key Insight: Tests that allow accurate system reconstruction without external documentation prove their quality as living specification documents.
Principles
- Test-as-Documentation
- Separation of Concerns
- Dual Perspective
- Measurable Outcomes
- Actionable Feedback
When to Use
- Major test suite refactoring completed (validate improvement)
- New team members onboarding (generate system overview)
- Architecture documentation audit needed (find alignment gaps)
- Quality gate before major release (comprehensive validation)
- Quarterly quality reviews (track test suite evolution)