Holy... this one rule in AGENTS.md and Claude's long reports are suddenly easy to read.
It used to finish a long task with a wall of text. What I needed to do next was buried somewhere in the middle, so I'd keep scrolling to find it.
Now my next steps go at the top: what to do, where to do it, and what to send back.
Add this section to your AGENTS.md ๐
## 7. Start with what you need from me
When a long task is finished, or you're blocked and need my help,
put any actions I need to take at the top of your reply.
Use a numbered list with one action per item. Explain what to do,
where to do it, and what to send back when finished.
Example: "Log in to Stripe, export the September refunds CSV,
and save it in inbox/."
Put the biggest blocker first. If you need nothing from me, say so.