Skip to content

Adopting a repo: one AGENTS.md; release 0.2.3 - #10

Closed
Marius1311 wants to merge 1 commit into
mainfrom
docs/adopt-agents-md
Closed

Marius1311 wants to merge 1 commit into
mainfrom
docs/adopt-agents-md

Conversation

@Marius1311

Copy link
Copy Markdown
Member

The adoption checklist said to edit AGENTS.md but never covered a repo that has a CLAUDE.md. Claude Code then reads only the CLAUDE.md (docs), so an AGENTS.md added next to it goes unread. Step 6 now says to rename the CLAUDE.md to AGENTS.md or merge it in, as quadbio/claude-plugins#13 asks. quadbio/analysis_template#19 drops the template's CLAUDE.md, which only imported AGENTS.md.

Releases 0.2.3.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Cu5AYoH46bk3rW3qivyPZ5

…; release 0.2.3

Claude Code reads AGENTS.md only when there is no CLAUDE.md, so an
AGENTS.md added next to one goes unread.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Cu5AYoH46bk3rW3qivyPZ5
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 14, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-14T09:47:09.561335Z b853573 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: b853573bd2

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +36 to +37
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

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Keep instructions loadable in every supported Claude session

When an adopter uses Claude Code before v2.1.277, has a CLAUDE.local.md, or launches beneath another project-level CLAUDE.md, replacing the repository's CLAUDE.md with only AGENTS.md silently leaves the new dataset and working-object instructions unloaded. Claude's instruction-loading documentation identifies these version and file-presence limitations, but this plugin declares no minimum Claude version and the checklist does not ask adopters to audit the other blockers; retain an @AGENTS.md loader or explicitly cover/version-gate these cases.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agreed that the import must stay. Rather than fix the step, I am closing this PR: the instruction-file layout (AGENTS.md plus a CLAUDE.md importing it) belongs to analysis_template and the marketplace conventions (quadbio/claude-plugins#14), so this checklist should not restate it. Step 6 stays as on main.

@Marius1311

Copy link
Copy Markdown
Member Author

Closing: the instruction-file layout belongs to analysis_template and quadbio/claude-plugins#14; restating it here would make a second source.

@Marius1311 Marius1311 closed this Oct 14, 2026
@Marius1311
Marius1311 deleted the docs/adopt-agents-md branch October 14, 2026 10:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant