Skip to content

docs: cut CLAUDE.md to what changes behaviour - #126

Merged
bryantbiggs merged 1 commit into
mainfrom
docs/cut-claude-md
Sep 17, 2026
Merged

bryantbiggs merged 1 commit into
mainfrom
docs/cut-claude-md

Conversation

@bryantbiggs

Copy link
Copy Markdown
Member

Cuts CLAUDE.md from 1096 to 405 words (36% of the original). It keeps what an agent cannot derive and would get wrong without: commands, repo-specific constraints and gotchas. It drops rules the maintainer's global instructions already carry, history and origin stories, and detail the code or workflows already state.

Kept because other files cite it:

  • The negative-assertion test rule, cited by crates/ocync-sync/tests/sync_cache.rs.
  • The index of nested CLAUDE.md files, which bench/README.md points into.

The file carried two versions of the local gate, one without --locked. The survivor matches the commands in .github/workflows/ci.yml. No markdown lint is configured here, so none was run.

@bryantbiggs
bryantbiggs marked this pull request as ready for review September 17, 2026 12:49
@bryantbiggs
bryantbiggs merged commit 878f5c4 into main Sep 17, 2026
16 checks passed
@bryantbiggs
bryantbiggs deleted the docs/cut-claude-md branch September 17, 2026 12:49
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