# Tech Spec — {{STORY_ID}} {{STORY_NAME}}

**Story:** stories/{{STORY_SLUG}}/story.md
**Story ID:** {{STORY_ID}}
**Date:** {{DATE}}
**Status:** Draft

---

## Overview

> 2–3 sentences: what's being built and key design decision.

## Architecture

- **Layers:** ...
- **Data flow:** `[Client] → [API] → [Service] → [DB]`

## Data Model

See [changes/data-model.md](changes/data-model.md) *(if applicable)*

## API Changes

| Method | Path | File |
|--------|------|------|
| POST | /api/v1/... | [changes/POST-...md](changes/POST-....md) |

## AC Mapping

| AC | Technical approach |
|----|--------------------|
| AC-01 | ... |

## Edge Cases

| EC | Handling |
|----|----------|
| EC-01 | ... |

## Out of Scope

- ...

## Open Questions

- [ ] Q1 — Owner: — Due: