anatomy.md: projectkaart met tokenschatting voor Claude Code
Definitie
Een anatomy.md is een handmatig bijgehouden bestandsindex in de projectroot die Claude Code vertelt wat elk bestand bevat en hoe groot het is, zodat bestanden niet geopend hoeven te worden als de samenvatting voldoende is. Het concept is ontleend aan OpenWolf maar werkt als plain-text conventie zonder die package te installeren.
Context
Claude Code leest bestanden pas als het ze opent. Zonder voorkennis opent het alles wat potentieel relevant lijkt, inclusief grote bestanden. Een bestandskaart met tokenschatting geeft Claude genoeg context om gericht te zoeken en grote bestanden te vermijden.
Kernpunten
Formaat
Per directory: bestandsnaam, korte beschrijving, tokenschatting.
## themes/jvdb/assets/
- `css/main.css` — Alle styling (~19600 tok) ⚠ GROOT — zoek specifieke sectie, nooit volledig lezen
- `js/main.js` — Barba.js page transitions (~4200 tok)Tokenschatting: ~4 tekens = 1 token. Ruwe grove schatting is genoeg. Markeringen die werken: 🔥 voor hot files (frequent gewijzigd), ⚠ voor grote bestanden.
Gebruik
Lees anatomy.md aan het begin van een werksessie vóór je bestanden opent. Als de beschrijving genoeg zegt, open het bestand dan niet.
Onderhoud
- anatomy.md handmatig aanvullen bij structuurwijzigingen
- Tokenschatting hoeft niet exact te zijn; orde van grootte is genoeg
- Niet lezen-secties expliciet benoemen:
public/,node_modules/,dist/
Locaties in dit project
~/Claude/projects/jimvandenbreemen.nl/anatomy.md— Hugo theme (incl. 19600-tok CSS)~/Claude/projects/kennisbank-web/anatomy.md— Quartz config, docs~/Claude/projects/Atelier/anatomy.md— vault MCP server (~40 tools), vault-app, vault-contract
Relatie tot OpenWolf
OpenWolf (cytostack/openwolf, v1.0.4) genereert anatomy.md automatisch via hooks en update het na elke write. Die automatisering is handig maar vereist installatie en is nog onvolwassen (6 weken oud, zelfgerapporteerde token-claims). De plain-text aanpak geeft 80% van de waarde zonder de afhankelijkheid.
Verbanden
-
Zie ook: wiki-openwolf-globale-configuratie — OpenWolf cerebrum en globale configuratie
-
Zie ook: wiki-cozempic-context-cleaning — context-reductie vanuit andere hoek
-
Zie ook: wiki-claude-workspace-setup — semantically_similar_to
Bronnen
- OpenWolf README. (2026, maart). cytostack/openwolf. GitHub. https://github.com/cytostack/openwolf