Re: [PATCH] docs: add AGENTS.md as a symlink to README

From: Jonathan Corbet

Date: Wed Oct 14 2026 - 13:54:31 EST


Sasha Levin <sashal@xxxxxxxxxx> writes:

> Most coding agents have standardized on AGENTS.md as the file they load
> automatically from the root of a repository. README already tells AI
> tools to read and follow Documentation/process/coding-assistants.rst,
> but that only helps if the agent decides to read README before acting,
> which in practice it often doesn't.
>
> Add a top-level AGENTS.md symlink to README, so agents load it on their
> own and follow its pointer to the AI guidelines. This keeps a single
> entry point for every reader, and avoids adding a separate copy of the
> policy that could drift from the RST.

I'm still not fully thrilled by this change, I must admit. But I have
gone ahead and applied it; hopefully it will help to improve the quality
of the patch flood some.

Thanks,

jon