CLAUDE.md: een bruikbaar projecthandboek voor Claude Code

Wat CLAUDE.md doet

CLAUDE.md bevat blijvende projectinstructies die Claude Code bij het werk betrekt. Het bestand is geschikt voor architectuurgrenzen, gangbare commando’s en kwaliteitsafspraken. Het is context voor de agent, geen technisch afdwingbaar beveiligingsbeleid.

Kies de juiste scope

Organisatiebeleid, persoonlijke voorkeuren en projectregels hebben elk een eigen plaats. Zet gedeelde projectafspraken in versiebeheer en houd persoonlijke of machinegebonden details buiten het teamdocument.

Schrijf concrete instructies

Beschrijf welk commando tests uitvoert, waar domeinlogica woont en welke acties verboden zijn. Een toetsbare regel zoals “voer de integratietests uit na een wijziging aan betalingen” werkt beter dan “test grondig”.

Houd context compact

Plak geen volledige interne handleidingen in één bestand. Verwijs naar gerichte documenten of regels die alleen bij bepaalde bestanden nodig zijn. Minder ruis maakt de belangrijke grenzen zichtbaarder.

Nee. Het vat alleen samen wat de agent tijdens vrijwel elke sessie nodig heeft.

Gebruik een hiërarchie

Een rootbestand kan algemene regels bevatten, terwijl een map met een afzonderlijk domein aanvullende instructies krijgt. Controleer regelmatig welke bestanden in de actieve context geladen zijn.

Beheer het als code

Wijs een eigenaar aan, review wijzigingen en verwijder achterhaalde commando’s. Een korte kwartaalcontrole voorkomt dat Claude op oude architectuur of verdwenen scripts vertrouwt.

# Project context - Domain logic lives in src/domain/ - Run pnpm test after behaviour changes - Never add secrets or production data

Zo maak je CLAUDE.md voor Claude Code toetsbaar

De beslisreview voor CLAUDE.md voor Claude Code richt zich eerst op één projectregel over build, tests en mapgebonden instructies die Claude Code aantoonbaar moet volgen. Leg voor CLAUDE.md voor Claude Code vooraf vast welk gebruikersresultaat aanvaardbaar is, welke invoer noodzakelijk blijft en wie de uitkomst mag goedkeuren. Houd de eerste proef van CLAUDE.md voor Claude Code klein genoeg om oorzaken en gevolgen afzonderlijk te kunnen beoordelen.

Ontwerp voor CLAUDE.md voor Claude Code bewijs rond één realistische succesroute en simuleer daarnaast een verouderd commando, conflicterende CLAUDE.md-lagen en een lokale uitzondering die onzichtbaar blijft. Noteer bij CLAUDE.md voor Claude Code per controle de verwachte uitkomst, het zichtbare bewijs en de herstelactie wanneer de controle faalt. De laatste beslisvraag voor CLAUDE.md voor Claude Code luidt: “Vervangt CLAUDE.md documentatie?”

CLAUDE.md voor Claude Code: van proef naar dagelijks beheer

Wijs voor CLAUDE.md voor Claude Code één operationele eigenaar, één inhoudelijke reviewer en een duidelijke terugvalroute aan. Behandel de checklist voor CLAUDE.md voor Claude Code als afzonderlijke werkstappen met bewijs, zodat interpunctie of formulering nooit onderdeel van de proceslogica wordt. Laat de betrokken gebruiker CLAUDE.md voor Claude Code doorlopen zonder mondelinge hulp en registreer elke plek waar uitleg of handmatig herstel nodig blijft.

Neem voor CLAUDE.md voor Claude Code wijzigingsrechten, logging, support en reviewmomenten op in hetzelfde beheerplan. Herhaal de praktijktest van CLAUDE.md voor Claude Code na een wijziging in brondata, configuratie, model, integratie of gebruikersrol. Breid CLAUDE.md voor Claude Code pas uit wanneer het team ook een verouderd commando, conflicterende CLAUDE.md-lagen en een lokale uitzondering die onzichtbaar blijft tijdig herkent, begrenst en herstelt.

Stop de uitrol van CLAUDE.md voor Claude Code zolang een verouderd commando, conflicterende CLAUDE.md-lagen en een lokale uitzondering die onzichtbaar blijft niet zichtbaar wordt gemeld en door de aangewezen eigenaar kan worden hersteld.