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 · 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.

A developer revises a spacious README page beside a denser sheet of coding-agent instructions.

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.

Reader comments

Conversation for this story loads after sign-in.