From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.remote-ip=18.9.28.11 ARC-Seal: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; cv=none; t=1794438065; b=dFO5QJ8tkl7RBZNYe1R7m5XOPD9ZuimJ56QNHBArwIiD8k4edsi41OK6IQpjAqCqrRZH 2PWucBhJK7xq0dXVcoICAvfWmUL7CH7cGyDkAUixikPYQ+4+wMgnQK2mzlJao8nD6mcgD Ji53Pl3R82aCopuQ9Io1tcPZRhrXx4Nj8AP3AK9+ERyWY4i+Ct8MOq4lWHp6PPXc5qgz4 Ea+nSGNZ3ZCKKkM1OUVaQHCHlV9S+n7JstncVIuc3Fi3pjYxdwUOrRqL0cCRrC+QiFssN cXV199vNdLEk7wGW036qxQx7Kbine7CBJNSTO/M39DmRn1Rgycxh1PYIAQFGp/NVomg== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1794438065; h=DMARC-Filter:Received:DKIM-Signature:Received:From:To:Cc:Subject: Date:Message-ID:X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; bh=lV6OqA+4ssaJDj1S+Y5UN2saHZp4EROsxBke/tNAscs=; b=eSB7uXqrsZExCZ/oMhWMYaBEsHrQ/NSIIy5DEncB3S8+bXdJkjw6LWf1EmkZ7t9RSrs5 iR4YDIhAPpkszGsNgwvRfO+ThS/RXHPX7smTql/QLr8kUHJqNw4CaT/JluWtv6+jYIhL2 RBPAS5b+OmjsiA4Lp27/AGWdWB2FDBZr/QyzJh2mP0Ul8IJSXon0YPwPbZ5eQx9Lyog0W tepCHQUaL9a5pS4t3cIpzTSQLN4EPVPPqyfBFhCg9lXDAicIQlpyefT/zuwksS+2cANTL BTN52ZwlLMF80qd+L8GUjs37RrkuPGn2lxvAhTx3HdlLDo8rDJfj94Z1r8F1j6uebTQ== ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass header.from=mit.edu; spf=pass smtp.mailfrom=mit.edu; dkim=pass header.d=mit.edu header.i=@mit.edu header.a=rsa-sha256 header.s=outgoing header.b=LYrGQI6K; arc=none smtp.remote-ip=18.9.28.11 Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) (using TLSv1.2 with cipher ECDHE-ECDSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 19A6260A261B for ; Wed, 11 Nov 2026 23:01:05 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org 19A6260A261B Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=mit.edu Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=mit.edu Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=mit.edu header.i=@mit.edu header.a=rsa-sha256 header.s=outgoing header.b=LYrGQI6K Received: from trampoline.thunk.org (pool-173-48-111-191.bstnma.fios.verizon.net [173.48.111.191]) (authenticated bits=0) (User authenticated as tytso@ATHENA.MIT.EDU) by outgoing.mit.edu (8.14.7/8.12.4) with ESMTP id 6ABMxiEx026971 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Wed, 11 Nov 2026 17:59:45 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=mit.edu; s=outgoing; t=1794437992; bh=lV6OqA+4ssaJDj1S+Y5UN2saHZp4EROsxBke/tNAscs=; h=From:Subject:Date:Message-ID:MIME-Version; b=LYrGQI6KyZ0v7IacPJVabY7VNXZz6g8SsTnLCmtrBPbhtr26mxv9spfoKiPLRqrBm Xwj3f0rcqeFvO3zKsey8HhQkNp5aDF7lQYPe19ltzz5+SmlQCKbiXBDsk8hGDD46qn kRl+HQNCqjfTBwv3dL+NiW4oWxoNP5HpyDYikHPkhNVSyDQ71sVDPU5MQVaVossUh9 VUtB+ivZJmh8/1pZdqsM9g062zNEVNTY5f4YOzrCiUBDClWIQ0SxCy/vP6xdqQoBLX NIdpmZ+He5Y4lTYq3FqydzDSiDNEbNFi2/bOc5VuvTC1gTPqn2HAwVOudpRCRlzwEn 8ZARmrwUR5suQ== Received: by trampoline.thunk.org (Postfix, from userid 15806) id BC1812E00BC; Wed, 11 Nov 2026 17:59:44 -0500 (EST) From: "Theodore Ts'o" To: workflows@vger.kernel.org, ksummit@lists.linux.dev Cc: Sasha Levin , Bradley Morgan , "Theodore Ts'o" , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Jonathan Corbet , Shuah Khan , Randy Dunlap , Mark Brown , Laurent Pinchart , Greg Kroah-Hartman , Leon Romanovsky , Konstantin Ryabitsev , Thorsten Leemhuis , "Michael S. Tsirkin" , Kees Cook , Geert Uytterhoeven , Dan Carpenter , Miguel Ojeda , Alexei Starovoitov , Julia Lawall , SJ Park , stable@vger.kernel.org Subject: [PATCH v5 1/6] agents: add infrastructure for agent resources Date: Wed, 11 Nov 2026 17:59:33 -0500 Message-ID: <20261111225940.1573565-2-tytso@mit.edu> X-Mailer: git-send-email 2.53.0 In-Reply-To: <20261111225940.1573565-1-tytso@mit.edu> References: <20261111225940.1573565-1-tytso@mit.edu> X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Transfer-Encoding: 8bit From: Sasha Levin Add agents/ as a home for skills and other resources for coding assistants. Describe the skill layout in coding-assistants.rst, together with the rule that skills only inspect and report, and add a MAINTAINERS entry covering the directory. Signed-off-by: Sasha Levin Reviewed-by: Bradley Morgan Link: https://patch.msgid.link/20261020161642.3713052-2-sashal@kernel.org Signed-off-by: Theodore Ts'o --- Documentation/process/coding-assistants.rst | 14 ++++++++++++++ MAINTAINERS | 6 ++++++ 2 files changed, 20 insertions(+) diff --git a/Documentation/process/coding-assistants.rst b/Documentation/process/coding-assistants.rst index 509dbf23a099..b8f2c74e46fc 100644 --- a/Documentation/process/coding-assistants.rst +++ b/Documentation/process/coding-assistants.rst @@ -19,6 +19,20 @@ For guidelines on content generated by AI coding assistants see: * Documentation/process/generated-content.rst +Agent resources +=============== + +Skills for coding assistants live under ``agents/skills/``, one directory per +skill with a ``SKILL.md`` entry point in the `Agent Skills format +`_. Each skill points at the process +documents that apply to its task and adds only what assistants tend to get +wrong. + +Skills inspect and report. They do not change files, create commits or tags, +or send mail. A skill returns its result with the evidence for it, or says what +is missing. Do not fill a missing result with a guess or a placeholder, and do +not finalize the work until it is resolved. + Licensing and Legal Requirements ================================ diff --git a/MAINTAINERS b/MAINTAINERS index 222b7fc2c3aa..eb348cc9588f 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -734,6 +734,12 @@ F: Documentation/filesystems/afs.rst F: fs/afs/ F: include/trace/events/afs.h +AGENT RESOURCES +M: Sasha Levin +L: workflows@vger.kernel.org +S: Maintained +F: agents/ + AGPGART DRIVER M: David Airlie L: dri-devel@lists.freedesktop.org -- 2.53.0