From b664bc9faf42e8968acf8a3a964f15fee0f86bea Mon Sep 17 00:00:00 2001 From: Francesco Bigiarini Date: Thu, 24 Sep 2026 12:23:10 +0200 Subject: [PATCH] [Docs] Replace the prose pointer in CLAUDE.md with an @AGENTS.md import CLAUDE.md told Claude Code in words to read AGENTS.md, which only works if the session decides to open the file, and carried a /self-review bullet that duplicated what AGENTS.md already says. The file is now the single import line the Claude Code docs prescribe for this setup, so AGENTS.md is loaded at session start on every version, including those that cannot read AGENTS.md natively, and is never read twice on those that can. AGENTS.md's opening line now describes the import. Fixes #526 Co-Authored-By: Claude Fable 5.1 --- AGENTS.md | 2 +- CLAUDE.md | 8 +------- 2 files changed, 2 insertions(+), 8 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index fe4caba5..a2323cd2 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,6 +1,6 @@ # AGENTS.md -Instructions for AI coding agents working in this repository. Tool-neutral and canonical — `CLAUDE.md` points here rather than repeating it. +Instructions for AI coding agents working in this repository. Tool-neutral and canonical — `CLAUDE.md` is a one-line `@AGENTS.md` import, so Claude Code loads this file at session start whether or not it can read `AGENTS.md` on its own, and nothing is repeated there. ## Where things are, whatever agent you use diff --git a/CLAUDE.md b/CLAUDE.md index f8659c7a..43c994c2 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,7 +1 @@ -# CLAUDE.md - -Read **[AGENTS.md](AGENTS.md)** — it holds the instructions for this repository, and is written to be read by any agent. Nothing that belongs there should be duplicated here. - -Claude Code specifics only: - -- `/self-review` (`.claude/skills/self-review/SKILL.md`) is the entry point for the pre-PR review that AGENTS.md asks for. It runs the procedure in `.github/instructions/code-review.instructions.md` and dispatches the judgement pass to a subagent, so the session that wrote the change is not the one grading it. +@AGENTS.md