Daniel Mac shares an AGENTS.md reporting contract to fix agents' flawed human interface

daniel_mac8 · x · 2026-11-20

Daniel Mac argues GPT-6.2 Astra is top-tier at raw intelligence but poor at interfacing with its human operator — a flawed "attention interface." His fix: put a "reporting contract" in AGENTS.md. The template mandates a fixed final-message structure: Outcome first (1-2 sentences); What I need from you (numbered decisions with recommendations, or "nothing"); What to do first (numbered next steps that need no follow-up); What changed or was learned (only actionable detail, no dead ends); How sure we are (three short lists: what was checked against which file, what is inferred, what nobody has tested). Premise: the reader is switching in from other work, sees only the first lines, and cannot see your commands or output.

Related event: Developer shares reporting contract for AGENTS.md to fix GPT-6.2's operator handoff(2 posts)→

Original post →

More from coding & agent

coding & agent channel →