★ Latest
Documentation as a Hierarchy, Not a Pile →
A big instructions file is a bad interface for an agent, because an agent can't skim. How I turned one junk-drawer AGENTS.md into a table of contents with a docs tree underneath.
posts
I'm a web developer figuring out what AI agents are actually good for - at Actual AI by day, and in a pile of side projects the rest of the time. I'm a longtime member of the Drupal community and I often present at tech events. I live with a super awesome family in the Chicago suburbs and I'm really into Nintendo.
A big instructions file is a bad interface for an agent, because an agent can't skim. How I turned one junk-drawer AGENTS.md into a table of contents with a docs tree underneath.
A document is a description of intent. It doesn't stop anything. How to turn architectural rules into checks that fail the build.