# <Topic> — handoff & changelog (<YYYY-MM-DD>)

One-to-two sentences: what this session set out to do and where it ended.

---

## Changelog — what changed

| Area | Change | PR / files |
|---|---|---|
| <area> | <what changed> | #<n> · `path/to/file` |

<Or bullets per area. Include PR numbers, file paths, and what each does.>

---

## Current state (verified)

What is true **now** — merged, deployed, passing. Note how each was verified.

- ✅ <thing> — <how confirmed: PR merged / curl 200 / tsc clean / test passing>
- ⏳ <thing> — open PR #<n> / awaiting deploy

---

## Open items

### For the human (you)
1. <action only a person can do: add secret X, merge PR #n, click deploy, submit for review>

### For the next agent / session
1. <next build/fix, with enough context to start>

---

## Gotchas & non-obvious context

The highest-value section — what a fresh agent can't infer from the diff.

- <why an approach was chosen over the obvious alternative>
- <data quirk / thing that looks wrong but isn't>
- <race condition / concurrency / branch hygiene note>
- <deliberately NOT done, and why — so it isn't redone>

---

## How to continue / reproduce

Exact entry points and commands.

```bash
# where the next agent picks up
```

- Key files: `<path>` — <what it is>
- Data sources / creds: <where they live, e.g. `repo/.env.local` — never paste secrets>

---

## Honest limitations

- <what's incomplete, approximate, or assumed — so no one over-trusts it>

---

## Where things live

- PRs: #<n> (<state>), …
- Docs: `<path>`
- Secrets: `<location>` (values not reprinted)
- Related memory: `[[memory-name]]`