Skip to content

Commit 70231ef

Browse files
committed
docs(claude-md): compact preamble to keep under 40 KB
CLAUDE.md was 41081 bytes (121 over cap). Condensed the multi-line preamble to one paragraph + the per-section cap reference. Now 40354 bytes (606 free). Preamble is repo-owned; no fleet-canonical change.
1 parent 3351b81 commit 70231ef

1 file changed

Lines changed: 1 addition & 14 deletions

File tree

CLAUDE.md

Lines changed: 1 addition & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2,20 +2,7 @@
22

33
**MANDATORY**: Act as principal-level engineer. Follow these guidelines exactly.
44

5-
This file has two parts:
6-
7-
1. **📚 Wheelhouse Standards** — content between the `BEGIN FLEET-CANONICAL` /
8-
`END FLEET-CANONICAL` markers below is the wheelhouse-owned ruleset, distributed byte-identical to every
9-
fleet repo (`socket-*` and `ultrathink`). Wheelhouse controls; fleet
10-
members consume. **Do not edit in a downstream (fleet) repo**
11-
edit `socket-wheelhouse/template/CLAUDE.md` and run
12-
`node scripts/sync-scaffolding.mts --all --fix`.
13-
2. **🏗️ Project-Specific** — everything _outside_ the fleet markers is
14-
owned by the host repo. Architecture, commands, build pipelines,
15-
domain rules, etc. live there.
16-
17-
The fleet block comes first because it changes most often (centrally
18-
curated), and it never interweaves with project content. Fleet-block size is capped at 40 KB (enforced by `.claude/hooks/claude-md-size-guard/`) — every byte costs N copies of fleet-wide in-context tokens. Individual `###` sections inside the fleet block are also capped at 8 body lines; past that, outsource detail to `docs/claude.md/fleet/<topic>.md` (enforced by `.claude/hooks/claude-md-section-size-guard/`).
5+
Two parts: **📚 Wheelhouse Standards** between the `BEGIN/END FLEET-CANONICAL` markers (byte-identical across the fleet; edit only in `socket-wheelhouse/template/CLAUDE.md` + cascade), and **🏗️ Project-Specific** after the markers. 40 KB whole-file cap (enforced by `.claude/hooks/claude-md-size-guard/`); per-`###` section cap 8 lines (enforced by `.claude/hooks/claude-md-section-size-guard/`).
196

207
<!-- BEGIN FLEET-CANONICAL — sync via socket-wheelhouse/scripts/sync-scaffolding.mts. Do not edit downstream. -->
218

0 commit comments

Comments
 (0)