docs: CLAUDE.md is a goal and a table of contents, so a context pays for what it reads

Browse Source

The file was 1967 lines and is auto-loaded into every context, so every
session paid for the whole of it to reach one invariant. It now carries the
project's goal, the three facts that are always relevant, and a table of
contents; the body is fourteen files under docs/claude/ reached by link
rather than by import, so nothing is loaded until it is asked for.

The content is moved verbatim -- the only edits are each file's own header
and the cross-references that became cross-file ("see the invariant below"
is now a link to the file that owns it).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

...

This commit is contained in:

Martino FerrariandClaude Opus 4.6 committed 2026-10-07 01:49:28 +02:00

1 parent 0b5ace9585

commit a7702acb63

15 files changed

+2085 -1949

Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL

Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

CLAUDE.md

+45 -1949

File diff suppressed because it is too large. Load diff