Decision logs

A short, append-only file that lets context survive between agent sessions.

Updated Oct 19, 20261 min read

Agents forget everything between sessions. A decision log is the cheapest fix: one Markdown file the agent reads first and appends to last.

Entry format

## 2026-10-16 Short title
- Decided: what we chose
- Because: why, including what we rejected
- Watch out: the assumption or connection this depends on

Rules

Append-only. If a decision changes, add a new entry that supersedes the old one.
Record the why. The what is visible in the code. The why isn't.
Six lines max. Long entries stop being read.

Wiring it up

Point to it from your context file:

## Memory
Read DECISIONS.md before starting. Append an entry when we decide something.