docs: move maintainer-only agent ops out of the public CLAUDE.md - #1348
Merged
Merged
Conversation
CLAUDE.md is loaded by every agent session in a public repo, so outside contributors read it too. Two sections were maintainer-private operating policy that means nothing to them and can actively mislead: - Autonomous Operation Constraints — a zero-interruption policy, a "do not ask for plan approval" rule, and escalation triggers naming personal reviewer CLIs, their model tiers and their quota state. - Model Routing — per-task model ladders, session-model switching and quota discipline for accounts a contributor does not have. Both now live in the maintainer's own global agent config. Nothing that helps someone contribute was removed: architecture, build/test/lint commands, editions, configuration, MCP protocol, security model, debugging and development guidelines are untouched. Also drops the "every Paperclip heartbeat" aside from the header — that is private fleet tooling, not something a reader of this repo can act on.
|
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
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
2 participants
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.
Pull Request
Description
CLAUDE.mdis loaded by every agent session in this repo, and this repo is public — outside contributors read it too. Two of its sections were maintainer-private operating policy that means nothing to them, and in one case can actively mislead:Both now live in the maintainer's own global agent config, outside version control. The header also dropped an aside about a private fleet scheduler ("every Paperclip heartbeat") that no reader of this repo can act on.
Net: -40 lines, one line changed, nothing added.
Nothing contributor-facing was touched. The file keeps its orientation role in full: project overview, editions (personal/server build tags), the architecture directory table, build/test/lint commands — including the two
golangci-lintinvocations CI runs and the-skipregex forinternal/server— configuration, MCP protocol, security model, key implementation details, debugging, and development guidelines.AGENTS.mdwas reviewed and already contains only contributor-facing guidance; it is unchanged.Testing
Documentation-only change — no code paths touched, so no tests were added. Verified by inspection that the remaining file contains no references to personal tooling, model quotas, or maintainer directives, and pre-commit hooks (whitespace, EOF, merge-conflict, large-file and executable checks) pass.