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 <[email protected]> --- 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 +<https://agentskills.io/specification>`_. 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 <[email protected]> +L: [email protected] +S: Maintained +F: agents/ + AGPGART DRIVER M: David Airlie <[email protected]> L: [email protected] -- 2.53.0
