---
task_id: {task_id}
requirement: {requirement}
agent: {agent}
model: {model}
session: {session}
date: {date}
files_modified:
  - {file}
ai_generated:
  - {file}
---

## What Was Done

<!-- Describe what was implemented — be specific about files, functions, and behavior changed. -->

## Why This Approach

<!-- Explain the reasoning behind the chosen implementation. What constraints shaped this decision?
     What made this approach the right fit for the existing codebase and requirements? -->

## Alternatives Considered

<!-- List alternatives that were genuinely evaluated and why they were not chosen.
     Be honest — if an alternative was dismissed quickly, say why. -->

| Alternative | Reason Not Chosen |
|---|---|
| | |

## Risks / Known Limitations

<!-- What could go wrong? What edge cases are not handled? What technical debt was introduced?
     Be specific — "none" is rarely accurate. -->
