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.
More from coding & agent
- A copy-paste 'reporting contract' for AGENTS.md to fix GPT-6.2's poor interface — daniel_mac8 · 2026-11-20
- Florian Roth: open source vulnerability surge reflects LLM-driven scrutiny, not worse code — cyb3rops · 2026-11-20
- lattedit turns your browser into a LaTeX editor that shows Claude Code, Codex and Cursor editing live — cneuralnetwork · 2026-11-20
- Fable 5.2 filmmaking playbook plus 12 repos that give coding agents design taste — GCWebDesigner · 2026-11-20
- Bolna's Symphony event breaks down India's voice-agent stack: telephony, voice models, ASR — prasanna_says · 2026-11-20
- Which AI agent sandbox is best? Daytona vs e2b for dev and scale — Ill_Acanthaceae_2618 · 2026-11-20