linux-kernel - Re: [PATCH 1/4] agents: add unified agent coding assistant configuration

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <202507271934.68E1F0C728@keescook>
Date: Sun, 27 Jul 2025 19:37:31 -0700
From: Kees Cook <kees@...nel.org>
To: Sasha Levin <sashal@...nel.org>
Cc: corbet@....net, linux-doc@...r.kernel.org, workflows@...r.kernel.org,
	josh@...htriplett.org, konstantin@...uxfoundation.org,
	linux-kernel@...r.kernel.org, rostedt@...dmis.org
Subject: Re: [PATCH 1/4] agents: add unified agent coding assistant
 configuration

On Sun, Jul 27, 2025 at 03:57:59PM -0400, Sasha Levin wrote:
> Create a single source of truth for agent instructions in
> Documentation/AI/main.md with symlinks for all major coding
> agents:
> - CLAUDE.md (Claude Code)
> - .github/copilot-instructions.md (GitHub Copilot)
> - .cursorrules (Cursor)
> - .codeium/instructions.md (Codeium)
> - .continue/context.md (Continue)
> - .windsurfrules (Windsurf)
> - .aider.conf.yml (Aider)

I *really* don't like this. I use the CLAUDE.md file as my instructions
for my agent. I think all of these should be .gitignore entries.

> diff --git a/Documentation/agents/index.rst b/Documentation/agents/index.rst
> new file mode 100644
> index 000000000000..109266ca91ec
> --- /dev/null
> +++ b/Documentation/agents/index.rst
> @@ -0,0 +1,10 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +======
> +Agents
> +======
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +   main
> \ No newline at end of file
> diff --git a/Documentation/agents/main.rst b/Documentation/agents/main.rst
> new file mode 100644
> index 000000000000..98aa8250be9d
> --- /dev/null
> +++ b/Documentation/agents/main.rst
> @@ -0,0 +1,7 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +=====================================
> +Linux Kernel Development Agent Instructions
> +=====================================
> +
> +This is the Linux kernel repository. When working with this codebase, you must follow the Linux kernel development processes and coding standards.

And now I start my "this is redundant, why do we have to repeat it in a
new place?" part of my review comments. :)

I *really* think Agent instructions should only be about stuff specific
to the agent. It is _supposed_ to be able to find the rest of it on its
own.

-- 
Kees Cook