From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-alma10-1.taild15c8.ts.net [100.103.45.18]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 4AC424C9E01; Fri, 16 Oct 2026 15:28:33 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=100.103.45.18 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1792164514; cv=none; b=os4oSNstPm6wZW+mgWOWq9Pr9vq/E9018y0SlLZka/QM6Bkgrn9xs97Vmsw8Md1KOSgm3WDzLoK0P23nnxvprYIXZAu4QTP3U8zABGoF8Z1sRpxjPikQ8eH1T3wHDj/6xtxArWTocIvK18tr4dMKX0TXvUuaZ7DEIgiuML2Io40= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1792164514; c=relaxed/simple; bh=KBpvABpvYRL1KrCHjx8irXtk/Nzs9idsNs4hE49fj6g=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=b4RHA5LiORY9wCK/VSjTNiTQhQygwMyzsGu67ztHtzEmVeflNL8WPbThwrgYpdPBDR47r3U7Agb3+PT1uHd9V8RG0SoR8PPxQM3GNfv66tmNKGWfNcOZxfswPgKJ/+DB0MQ4n6q61K3tt9BqJwG6fMwSnIiFZj3hZn2b3SaTlbI= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=XS2GHoUx; arc=none smtp.client-ip=100.103.45.18 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="XS2GHoUx" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 4F1691F000C5; Fri, 16 Oct 2026 15:28:31 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=kernel.org; s=k20260515; t=1792164513; bh=MpptuEn13n0psYqhF3sSyJGxe3uLahgHjrvCjoi8h1U=; h=From:To:Cc:Subject:Date:In-Reply-To:References; b=XS2GHoUxu6ubvWdX3AFCa3rBydQPGRZvpI1c8jn50JMc8JZddaesgVTv3UkxiHc05 rZ+V23j6+BsFhqmWWMaFk+LuLWJHs6vT7nyH2izaDpopNF/A14KkLvTXuGkvzg6rY1 rWrEWP0ptAD2pDZB2ZqlYTBpP4spV3E7aeQPgSVL96b69eAkopqAKLLsPuBpva8Pma x2gLtbYVxIGtjeJ4d/1/qGHo6Ony0Df2AfbJhOX9WRW4PF3+o+oSLWqSXCevAlnZzX rXKM5OK4g5jKzucQJ5QuTQv6+l7xO7gOeBq+aZqKp2yxvxVp6hTtdEwMm91pBpNgqs sCOGMUH64FLyQ== From: Sasha Levin To: workflows@vger.kernel.org, ksummit@lists.linux.dev Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Jonathan Corbet , Shuah Khan , Randy Dunlap , Mark Brown , Theodore Ts'o , Laurent Pinchart , Greg Kroah-Hartman , Leon Romanovsky , Konstantin Ryabitsev , Thorsten Leemhuis , "Michael S. Tsirkin" , Kees Cook , Geert Uytterhoeven , Dan Carpenter , Miguel Ojeda , Sasha Levin Subject: [PATCH v3 1/7] agents: add infrastructure for agent resources Date: Fri, 16 Oct 2026 11:28:21 -0400 Message-ID: <20261016152828.3765695-2-sashal@kernel.org> X-Mailer: git-send-email 2.53.0 In-Reply-To: <20261016152828.3765695-1-sashal@kernel.org> References: <20261016152828.3765695-1-sashal@kernel.org> Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit 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. Assisted-by: LLM Signed-off-by: Sasha Levin --- 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 051f0d819f68e..1efc7b08f09f8 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 f53047aa8d3c1..9e522cda56f1b 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -713,6 +713,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