# Test Generator Reference Guide

Quick-lookup patterns and best practices for test generation across technologies.

## Files in This Directory

### [testing-patterns.md](testing-patterns.md)
Comprehensive patterns for Vitest (TypeScript) and pytest (Python) - from basic unit tests to advanced mocking strategies.

**When to use**: Writing tests, reviewing test code, establishing patterns
**Key topics**: AAA pattern, fixtures, mocking, async testing, TanStack Query patterns

### [test-structure-guide.md](test-structure-guide.md)
How to organize test files, naming conventions, test suite structure, and file organization for maximum maintainability.

**When to use**: Organizing test suites, structuring new projects
**Key topics**: File naming, directory structure, test grouping with describe blocks

### [mocking-strategies.md](mocking-strategies.md)
Complete guide to mocking - when to mock, how to mock, mock verification, and avoiding over-mocking.

**When to use**: Testing code with external dependencies
**Key topics**: API mocking, database mocking, module mocking, spy vs stub vs mock

### [coverage-standards.md](coverage-standards.md)
What different coverage percentages mean, when to aim for different levels, and how to interpret coverage reports.

**When to use**: Setting coverage goals, interpreting coverage gaps
**Key topics**: 80% rule, critical path coverage, diminishing returns

## Navigation

**Parent**: [Test Generator Agent](../test-generator.md)
**Examples**: [Examples Index](../examples/INDEX.md)
**Templates**: [Templates Index](../templates/INDEX.md)

---

Return to [agent documentation](../test-generator.md)