AGENTS.md tells agents how to work on your repo. Nothing told mine how to work with me.
So I drafted HUMANS.md: one file, ~/.humans/HUMANS.md, that agents read before they spend your attention. How to write to you, what they may decide alone, when to interrupt.
Why: I run…
HUMANS.mdAGENTS.md is for your codebase. HUMANS.md is for you.A file for your agents, and your colleagues’ agents, to read before they spend your attention: how to write to you, when to ask you to decide, and when to interrupt you. An open format: AGENTS.md is for your codebase, HUMANS.md is read by agents and is about you.