Skip to content

docs: remove redundant CLAUDE.md imports - #4287

Merged
max-sixty merged 1 commit into
mainfrom
codex/remove-claude-shims
Sep 27, 2026
Merged

max-sixty merged 1 commit into
mainfrom
codex/remove-claude-shims

Conversation

@max-sixty

Copy link
Copy Markdown
Owner

Claude Code reads the existing AGENTS.md files directly, so remove the nine one-line CLAUDE.md imports that duplicate them.

This was written by Codex on behalf of max-sixty

@worktrunk-bot worktrunk-bot left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Without these shims, a contributor who has a CLAUDE.local.md in the checkout loses every repo instruction, with no warning. Per Claude Code's AGENTS.md docs, a CLAUDE.local.md in the working directory or above it counts as a CLAUDE.md, and that turns off the AGENTS.md fallback. The imports protected against this. The same docs say Claude Code before v2.1.277 (released 2026-09-18), or with the built-in agents-md plugin disabled, reads only CLAUDE.md. They suggest keeping an import-only CLAUDE.md "if some of your sessions can't load AGENTS.md directly". The repo can't choose a mode for contributors, because instructionFiles is ignored in project settings.

This is all or nothing. In the default mode, an AGENTS.md is read directly only when no CLAUDE.md exists in that directory or any directory above it. Keeping just the root CLAUDE.md would therefore stop the nested AGENTS.md files from loading. The options are to merge this PR as it is, accepting the gap above, or to keep all nine shims. Keeping them costs nothing: the docs say an import never loads AGENTS.md twice.

@max-sixty
max-sixty merged commit ebb27e3 into main Sep 27, 2026
38 checks passed
@max-sixty
max-sixty deleted the codex/remove-claude-shims branch September 27, 2026 00:54
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.

2 participants