## What

<!-- Brief summary of WHAT this PR does. -->

## Why

<!-- WHY is this change needed? Link to spec if applicable. -->

**Spec:** <!-- https://github.com/arcasilesgroup/ai-engineering/blob/main/.ai-engineering/specs/spec.md -->

## How

<!-- HOW does it work? Key implementation details. -->

## Tasks Completed

<!-- List issue/task IDs closed by this PR. -->
<!-- Closes #XX, Closes #YY -->

## Verification

- [ ] `ruff check` passes
- [ ] `ruff format --check` passes
- [ ] `ty check` passes
- [ ] `uv run pytest` passes
- [ ] `gitleaks detect` — no leaks
- [ ] No `--no-verify` used in any git command
- [ ] CHANGELOG.md updated (if user-facing)
