docs(claude): stop claiming a model tier the repo no longer pins - #648
Merged
Conversation
Dropping the model-policy marker from code-reviewer.md left CLAUDE.md asserting the opposite of the frontmatter: that agents run on Opus 5 at high effort and that this repo's frontmatter gets stamped from a central policy file. Neither is true for a clone any more — the agent carries model: inherit, and the maintainer's pin lives outside the repo. The "frontmatter wins" escape hatch kept it harmless, but a rule nobody can trust is worse than no rule. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017UPfL1CDdfcVaNaYiYGonH
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.
Re-cut of #646, which could not be rebased.
Why a new branch
#643 was squash-merged to main from
chore/prune-public-claude-surface(b0f79c4). The next commit went onto that same branch and #646 was opened from it again, so the branch still held the five pre-squash commits whose content is already on main in squashed form. A rebase therefore conflicts by construction, and the branch had also fallen behind #637, #644, #645 and #647 — merging it would have reverted them. This branch carries the one commit that was actually new.What changes
Dropping the model-policy marker from
.claude/agents/code-reviewer.mdin #643 left CLAUDE.md asserting the opposite of the frontmatter: that agents run on Opus 5 at high effort, and that this repo's frontmatter is stamped from a central policy file. Neither is true for a clone any more — the agent carriesmodel: inherit, and the maintainer's pin lives outside the repo. The "frontmatter wins" escape hatch kept the contradiction harmless, but a rule nobody can trust is worse than no rule.The bullet now says agents inherit the session's model and effort, keeps the churn history that motivated the rule, and states plainly that the maintainer's own tier is pinned machine-locally and is not something a clone inherits.
Verification
One file, docs only — no production code, no test code, no build input. Nothing else in the diff.
🤖 Generated with Claude Code
https://claude.ai/code/session_017UPfL1CDdfcVaNaYiYGonH