What was measured
4,982
lines in the boot file
220 KB
loaded every session
26
chapters
~450
lines actually needed always
Measured on the live workspace on 30 July 2026, not estimated. The file is pulled in by the last line of CLAUDE.md, so it enters the context in full before the first word of any conversation — an email to a candidate, a quick question, a coaching session, all identical.
$ wc -lc boot/operating-system.md
4982 225838 boot/operating-system.md
$ tail -1 CLAUDE.md
@boot/operating-system.mdWhy it matters: at roughly 4 characters per token, that single file is around 56,000 tokens of the preamble. It is the main reason the brain runs out of room and starts compacting mid-conversation — 61 compactions in July, one every 3.5 messages.
The split, chapter by chapter
Green rows stay in the boot. Everything else moves to the skill that uses it, and is loaded only when that skill runs.
| Chapter | Lines | Destination | |
|---|---|---|---|
| Quick-Reference Card | 32 | boot | keep |
| YONAX OS Architecture — Les 6 couches | 143 | boot, rewritten as a ~40-line index: which chapter now lives in which skill | keep |
| 1. Founding beliefs | 47 | boot | keep |
| 2. Decision framework — les 7 filtres | 55 | boot | keep |
| 3. Decision process | 253 | /coaching | move |
| 4. Energy model (version courte) | 16 | boot | keep |
| 5. Time management | 96 | /coaching | move |
| 6. Tribe OS — la culture Generations | 33 | boot | keep |
| 7. Questions systématiques | 16 | boot | keep |
| 8. Personality paradoxes | 66 | /coaching | move |
| 9. Non-negotiables | 79 | boot | keep |
| 10. Conflict resolution | 13 | boot | keep |
| 11. Règles comportementales pour Yonax | 17 | boot | keep |
| 12. Relationships & trust | 260 | /coaching | move |
| 13. The weight of decisions & the solitude of leadership | 285 | /coaching | move |
| 14. Flow states & performance conditions | 273 | /coaching | move |
| 15. Leadership & management philosophy | 137 | builder / management skill — to be decided | move |
| 16. Commercial philosophy | 200 | /redaction + new /client | move |
| 17. Client reading & diagnosis | 342 | /redaction + new /client | move |
| 18. Commercial mistakes | 115 | /redaction + new /client | move |
| 19. Client meeting method | 144 | /redaction + new /client | move |
| 20. Émotional & relational self | 347 | /coaching | move |
| 21. Yonax builder OS | 394 | builder / management skill — to be decided | move |
| 22. Yonax recruitment OS | 416 | /assessment, /candidat, /delivery | move |
| 23. Candidate evaluation engine | 373 | /assessment | move |
| 24. Recruitment brain v2 | 790 | /assessment, /delivery | move |
Totals
| Destination | Chapters | Lines |
|---|---|---|
| Stays in the boot | Quick-Reference, Architecture (as index), 1, 2, 4, 6, 7, 9, 10, 11 | 451 |
/coaching | 3, 5, 8, 12, 13, 14, 20 | 1,580 |
Commercial — /redaction + new /client | 16, 17, 18, 19 | 801 |
Recruitment — /assessment, /candidat, /delivery | 22, 23, 24 | 1,579 |
| Builder / management | 15, 21 | 531 |
Result: the boot goes from 220 KB to roughly 22 KB. Chapters 13, 14 and 20 alone are 905 lines — 18% of the file — and they are only used by
/coaching. Today they load on every email to a candidate.The second problem: files nothing reads
A file that no skill declares as a source is never read again. Writing it feels like remembering something; in practice it disappears. Out of four "remember this" requests in the last ten days, three produced files that nothing reloads.
Found while measuring:
boot/conditional-rules.md — 31 KB — is not imported by CLAUDE.md and is not mentioned by any other file in the workspace. Zero references. It was written, and since then nothing has ever opened it.The pattern that does work is already in this brain. /analyse-profil names its source file inside its own SKILL.md, so the file gets reloaded every time the skill runs:
.claude/skills/analyse-profil/SKILL.md
→ "Le rapport est stocké dans wiki/career-patterns/index.md"The same mechanism carries the split. Each extracted chapter becomes its own file under wiki/os/, and the skill that needs it declares it in a Sources block at the top:
.claude/skills/coaching/SKILL.md
## Sources
- wiki/os/decision-process.md
- wiki/os/flow-states.md
- wiki/os/weight-of-decisions.mdRule to adopt: a file that no skill declares as a source does not exist. Every time something is worth remembering, it needs both a file and the skill that will open it.
How the move is done
| # | Step | Status |
|---|---|---|
| 1 | Full backup of the workspace before touching anything | done, 30 July |
| 2 | Mechanical split: 24 chapters into wiki/os/, byte for byte, no rewriting | ready |
| 3 | Reduced boot + index of where each chapter went | ready |
| 4 | Sources block added to each destination skill | ready |
| 5 | Decide what to do with conditional-rules.md | needs Yoni |
| 6 | Open a session and measure the preamble before and after | verification |
Timing: this should happen before the brains for the 5-10 test users are built, otherwise the same structure gets replicated on all of them.
Open questions for the session
| Question | Why it needs Yoni |
|---|---|
| Chapters 15 and 21 — leadership and builder OS. Existing skill, or a new one? | They do not map onto any skill that exists today. Either a new /strategy, or they fold into /coaching. |
Should the commercial chapters get their own /client skill? | 801 lines currently spread across client reading, meeting prep and past mistakes. |
conditional-rules.md — who was supposed to read it? | If it has an owner it gets wired to a skill. If not, it moves to wiki/ and stops weighing on the boot. |
| How does GR Recruitment know-how reach the colleagues' brains? | Position taken on 30 July: skills plus project runway, no company brain sitting above the others. |