Instead of tools for humans, and a separate set of tools for machines, we should just make tools for humans+machines.

The agent should look at my README.md, not a custom human-like text that is meant to be read by machines only.

It also should look at `Makefile`, my bash aliases and so on, and just use that.

In fact, many agents are quite good at this (Code Fast 1, Sonnet).

Issue is, we have a LONG debt around those. READMEs often suck, and build files often suck. We just need to make them better.

I see agents as an opportunity for making friendlier repos. The agent is a free usability tester in some sense. If it can't figure out by reading the human docs, then either the agent is not good enough or your docs aren't good enough.