From 83abfbaf8d1459d20b3657d0e592a40603f2d2f0 Mon Sep 17 00:00:00 2001
From: Christopher Willis-Ford <7019101+cwillisf@users.noreply.github.com>
Date: Mon, 15 Jun 2026 09:10:14 -0700
Subject: [PATCH] chore: add CLAUDE.md bridge so Claude Code loads AGENTS.md

Claude Code reads CLAUDE.md, not AGENTS.md. Add a one-line CLAUDE.md
(@AGENTS.md import) so the existing agent guide loads, and document the
bridge in the AGENTS.md template so repos adopting the template add the
same file. Other agent tools keep reading AGENTS.md directly.
---
 AGENTS.md | 6 ++++++
 CLAUDE.md | 1 +
 2 files changed, 7 insertions(+)
 create mode 100644 CLAUDE.md

diff --git a/AGENTS.md b/AGENTS.md
index e118050..f21e1f3 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -4,6 +4,11 @@ This file is a template for `AGENTS.md` files across Scratch repositories. Copy
 replace the placeholder sections with repo-specific content. The HTML comments are standing instructions for
 whoever adapts the template — they are safe to leave in place.
 
+Claude Code reads `CLAUDE.md`, not `AGENTS.md`. So that it picks up this guide, also add a one-line `CLAUDE.md`
+next to this file whose only content is the import directive `@AGENTS.md`. Use a plain import file rather than a
+symlink — a committed symlink does not survive Windows checkouts. Other agent tools continue to read `AGENTS.md`
+directly, so this bridge adds Claude Code support without duplicating any content.
+
 When adapting this template, consider adding sections for **Repository layout** and any language- or
 framework-specific conventions (TypeScript guidelines, React patterns, testing conventions, etc.) that are
 non-obvious from the code itself.
@@ -60,6 +65,7 @@ organization. It provides org-wide GitHub defaults:
 - `CONTRIBUTING.AI.md` — Scratch's org-wide policy on AI-assisted development
 - `PULL_REQUEST_TEMPLATE.md` — default PR template
 - `AGENTS.md` (this file) — template for per-repo agent guides
+- `CLAUDE.md` — a one-line import (`@AGENTS.md`) so Claude Code, which reads `CLAUDE.md` rather than `AGENTS.md`, loads this guide
 
 There is no build step and no test suite. Changes here are prose and Markdown only.
 
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..43c994c
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+@AGENTS.md