Skip to content

docs: trim derivable content from CLAUDE.md - #21

Merged
btravers merged 1 commit into
mainfrom
chore/trim-claude-md
Aug 7, 2026
Merged

docs: trim derivable content from CLAUDE.md#21
btravers merged 1 commit into
mainfrom
chore/trim-claude-md

Conversation

@btravers

@btravers btravers commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

From a /doctor pass. CLAUDE.md loads into every session, so anything a
session could reconstruct with a couple of tool calls is paid for on every
turn and gives nothing back.

6,867 → 6,457 chars (~1,716 → ~1,614 est. tokens).

Cut — derivable from the repo

The pnpm build|test|typecheck|test:types|lint|format|knip table (those are
package.json scripts), the standard pnpm vitest run <file> / -t
invocations, and the Node/pnpm pin line (.node-version and packageManager
already say it).

Kept, because it is not derivable

The two facts that block came with which nothing in the repo states:

Not cut

The Architecture section stays whole despite reading like a repo tour. Its
value is rationale rather than inventory — why only two zod slots and never
the full ZodType, why the union dispatches instead of trying each branch,
why computed re-derives — and none of that is recoverable from the code. The
Binding conventions stay for the same reason.

Also

A staleness fix, not a trim: the type-level-tests bullet still said add's
contextual typing. add became computed in #10.

Gate

format --check clean. No source touched.

Copilot AI lite review requested due to automatic review settings August 7, 2026 01:29
@btravers
btravers merged commit 6ddd491 into main Aug 7, 2026
14 checks passed
@btravers
btravers deleted the chore/trim-claude-md branch August 7, 2026 01:30

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Reduces the size of CLAUDE.md by removing command/script details that can be re-derived from the repository, while keeping non-derivable operational facts (CI gate order and the multi-pass typecheck detail) to minimize recurring context cost in agent sessions.

Changes:

  • Removed the “Commands” shell snippet and other derivable operational details (script list, common vitest invocations, Node/pnpm pin note).
  • Kept and reformulated the two non-derivable facts: CI gate order (including typecheck’s three passes) and the “run single test from inside packages/entity” note.
  • Updated a staleness reference from add to computed in the type-level tests bullet.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

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.

2 participants