Add CLAUDE.md for repository navigation#29363
Open
xml wants to merge 2 commits intoanthropics:mainfrom
Open
Conversation
The plugin repo had no CLAUDE.md or SessionStart hook providing repo-level context. The two existing SessionStart hooks (explanatory and learning output styles) only inject communication style instructions, not repository structure or conventions. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This was referenced Feb 28, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Motivation
Shouldn't the repo called
claude-codereally include a CLAUDE.md?! You know youwant to! And besides — since humans never bother to read docs and source, let's
make it easy for Claude to navigate for them.
The repo has great plugin READMEs, but nothing tying it all together at the top
level. The two existing SessionStart hooks inject communication style instructions,
not repository context — so nothing currently fills the role a CLAUDE.md would.
Prior art
PR #20824 is a draft CLAUDE.md from January 25 (zero reviews, zero comments). It
takes a different approach — 261 lines oriented toward AI assistant best practices,
including installation methods, platform support, and model selection that duplicate
the README.
This PR is 124 lines, leads with what the repo actually contains, and avoids
duplicating content from existing READMEs.
Test plan
🤖 Generated collaboratively by Claude Code and this human.