# Benchmark Results Directory

This directory stores benchmark results and performance tracking data.

## Structure

```
.benchmarks/
├── .gitkeep                    # This file
├── results/                    # Benchmark result JSON files
├── history/                    # Historical comparison data
└── README.md                   # Benchmark documentation
```

## Retention Policy

- Recent results: Keep last 30 days
- Historical data: Archive quarterly summaries
- Comparison baselines: Keep major version baselines indefinitely

## Usage

Run benchmarks with:
```bash
uv run pytest tests/benchmarks/ --benchmark-only --benchmark-json=.benchmarks/results/$(date +%Y%m%d-%H%M%S).json
```

View results:
```bash
uv run pytest tests/benchmarks/ --benchmark-only --benchmark-compare
```
