Context Porthole

You know everything about this project. Your agent is about to do a task for it. Count what it actually sees.

In your head — 7 things you know

…plus 3 you already wrote down — they're in the folder below, which is why they're about to go right.

The porthole — everything the agent will know

AGENTS.md
  • Money is whole cents; shares sum to the exact total
SPEC.md
  • — nothing about tips —
DECISIONS.md
  • No spreadsheet-looking grids
checks/
  • The checklist runs before anything is "done"
Your message: "Add a 'settle up' screen showing who pays whom."

This card is the whole delivery. Nothing else exists for it — not the phone call, not week one, not your face when you see a popup.

What came back

Nothing yet — send the task.

Not sent yet

You know 7 things. The porthole card shows 3 written lines and one message. That's the whole delivery.

The porthole is real — it's called the context window. The agent doesn't remember; it re-reads: each session it knows exactly what's in the folder plus what's in your message, and nothing else. So when it gets something wrong, ask first: could it have known? If the answer was in your head, the fix isn't a better scolding — it's a sentence in a file. Fix the folder, not the chat. And the thing that can't be written down? That rides along as you.