Skip to content

docs: debloat CLAUDE.md - #167

Open
benbaarber wants to merge 1 commit into
mainfrom
ben/claude-md-debloat
Open

docs: debloat CLAUDE.md#167
benbaarber wants to merge 1 commit into
mainfrom
ben/claude-md-debloat

Conversation

@benbaarber

@benbaarber benbaarber commented Aug 10, 2026

Copy link
Copy Markdown
Collaborator

CLAUDE.md had grown to ~46KB, much of it functioning as a changelog rather than working guidance. This cuts it to ~24KB (74 insertions, 130 deletions) while keeping everything sessions actually use.

Removed:

  • The per-crate test-count inventory. Checking past agent sessions in this repo: 13 of the 14 sessions that mention test counts were updating them, not using them — the block generated maintenance chores, not answers.
  • The copilot 1.0.67 verification narrative, which appeared twice (dependency-graph section and a ~3,900-char Things-to-know bullet). The durable part — the loader's writer contract — lives in docs/agents/formats/copilot-cli/writing-compatible.md, which stays pointed at.
  • Historical narration in Things to know ("used to emit", "now observed at 1.0.68", issue links) — the rules those stories justified are kept as rules; the stories belong to CHANGELOG.md and git history.
  • Formulaic CLI variants derivable from --help (per-provider import/list/export lines), the duplicated cross-dependency and desktop-app paragraphs, and two zero-evidence one-liners (externally-tagged Document note, ExecStrategy clause).

Kept intact: the release checklist (the most-consulted section — referenced in 18 of the 57 sessions in this repo), key conventions, every correctness invariant (token accounting, breakdowns, sync semantics, planner never changes an answer), the operational gotchas (TOOLPATH_CONFIG_DIR, TOOLPATH_QUERY_EXPLAIN, shim --manifest-path, missing redeem operation, plugin $PWD rule), and the docs/agents/formats/ pointers. Things to know is now organized under subheadings so future additions have a place to land.

Note: #138's parallel-execution sentence in the query bullet is deliberately absent here since it describes unmerged work; that branch re-adds it when it lands.


View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.

Cut the changelog-style content: the per-crate test-count inventory,
the duplicated copilot verification narrative, and historical narration
in Things to know. Keep commands, conventions, invariants, and the
release checklist; point provider detail at docs/agents/formats/.
Reorganize Things to know under subheadings.
@github-actions

Copy link
Copy Markdown

🔍 Preview deployed: https://aff0cff6.toolpath.pages.dev

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