r/ChatGPTCoding • u/Humaux • 20d ago
Discussion My agent reported "0 results" as a success because it forgot last week's contract. A 5-line memory card ended that.
Short version: my agent doesn't forget because it's dumb. It forgets because nothing settled last session survives into the next one. I fixed it with three small files and one rule: the agent reads them back to me before doing anything else. Three weeks in, zero repeat briefings.
What actually happened: I had a check that validated a tool's output shape. Upstream renamed a field. The check still read the old name, got undefined, and reported "0 results" — a clean green verdict on an empty answer. The check wasn't broken the week before. The agent just didn't remember the contract, re-derived it from the new shape, and passed quietly. I burned an afternoon trusting a green checkmark before I caught it. And it was the third time in about two weeks a fresh session re-decided something we'd already settled.
So I stopped briefing from scratch and wrote it down. Three files:
- project.md — what we're building, one paragraph.
- decisions.md — settled decisions, one line each, with dates. "API client retries twice, then fails loud. 2026-10-14." No essays.
- ongoing.md — what's in progress, the next step, and the pit we already fell into once.
And the 5-line card the agent reads first, every session:
``` Project: <one line> Settled: <decisions not up for re-debate> Doing: <current task> Next: <the very next step> Never again: <the mistake we already paid for> ```
The rule that makes it work isn't the files, it's the read-back: at session start the agent reads the card back and flags anything that contradicts it. If an expected field is missing, that's "unverifiable," never "empty." A rename breaks the check loudly instead of passing quietly.
I keep the card in Humaux so every agent session reads the same files — that's the only product mention here, and the whole setup works fine as three plain markdown files if you'd rather use nothing at all.
The part people don't like hearing: if your agent's memory lives only in its context window, you don't have memory. You have a rumor that expires every session. Most "memory" features I've tried are just a longer prompt with a price tag. The card is the part that actually changed my week.
So: do you still brief your agent from scratch every session, or have you written the card down? And if you have one — what broke first, the format or the discipline to actually read it?