diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 67fd0f1..fd40888 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "analysis-workflow",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Conventions for analysis repos where humans (notebooks) and coding agents (scripts) work side by side: one task per session, worktree and directory; worktree-safe output paths; additive write-back to AnnData zarr working objects. Ships a skill, guard hooks and the analysis_workflow Python package.",
   "author": {
     "name": "quadbio"
diff --git a/skills/analysis-workflow/references/repos.md b/skills/analysis-workflow/references/repos.md
index 369cb1d..7c248bc 100644
--- a/skills/analysis-workflow/references/repos.md
+++ b/skills/analysis-workflow/references/repos.md
@@ -33,5 +33,7 @@ their other repos). Then:
    match inside every task directory, and their re-includes keep READMEs, placeholders and task evidence tracked.
 4. Remove any notebook-output stripping (`nbstripout` in `.gitattributes`, its install step, its CI check).
 5. Copy `assets/REVIEW_GUIDE.md`, adding the repo's own rules under its last heading.
-6. In `AGENTS.md`, one short section naming the plugin and where the working objects live; delete restated rules.
+6. The repo's instructions live in one `AGENTS.md`: rename a `CLAUDE.md` to it, or merge one in, since Claude Code
+   reads `AGENTS.md` only when there is no `CLAUDE.md`. In it, one short section naming the plugin and where the
+   working objects live; delete restated rules.
 7. Optionally `uvx cruft link https://github.com/quadbio/analysis_template` to receive template updates.