Vercel CEO Guillermo Rauch wants human-written READMEs and agent-ready docs
His proposal separates public explanations for developers from denser instructions for coding agents, with human editing as the quality bar.
By RuntimeWire Staff · Published
Primary source: X
Why it matters
As coding agents become users of developer tools, documentation has to support both fast execution and human understanding. Rauch's proposal makes audience, rather than AI authorship, the organizing choice.

Guillermo Rauch (@rauchg), Vercel's founder and CEO, argues that public READMEs should be written for people while internal documentation can use more utilitarian language for coding agents. He laid out the distinction on October 4th.…
When you purchase through links in our articles, we may earn a small commission. This doesn’t affect our editorial independence.