Plan Docs

Each file in this folder is a specific implementation plan — detailed enough for the night agent to act on. Plans reference their spec, carry a status, and are sized by category.

Idea/research backlog (features not yet ready to implement) lives in docs/spec/ alongside the feature specs they relate to.

Template

---
status: draft | in-progress | done | deferred
spec: docs/spec/<file>.md | —
category: S | M | L | XL
---

# [Feature Name] — Plan

## Motivation
Why we are building this. One paragraph.

## Scope
What is in scope and explicitly what is out of scope.

## Approach
Step-by-step implementation plan. Use a numbered list. Include file paths and function names where known.

## Open Questions
Unresolved decisions that block or affect implementation.

Category sizes

Category	Effort
S	< 1 day
M	1–3 days
L	3–7 days
XL	> 1 week