Als je maar tijd hebt voor één leerplan, neem deze. De opdracht in het midden kost vijf minuten en is het punt waarop het kwartje meestal valt.
1. CLAUDE.md: het bestand dat het verschil maakt
Als je één ding uit deze hele feed meeneemt, neem dit. CLAUDE.md is een bestand in je repo waarin je opschrijft hoe jouw project in elkaar zit: welke commando's, welke conventies, waar de valkuilen zitten. Zonder dat bestand legt Claude Code elke sessie opnieuw de verkeerde aannames op tafel. Met dat bestand scheelt het je een uitlegronde per keer.
2. Opdracht: schrijf vanavond je eerste CLAUDE.md
Vijf minuten, in het project waar je nu aan werkt. Maak een CLAUDE.md met drie kopjes: hoe je het start, hoe je de tests draait, en twee dingen die een nieuwe collega verkeerd zou doen. Niet mooier maken. Commit hem. Merk je morgen in je eerste sessie het verschil, dan weet je genoeg. Zo niet, dan kost het je vijf minuten en een regel in git.
3. Waarom mijn CLAUDE.md kort blijft
Mijn eerste CLAUDE.md groeide naar driehonderd regels en werd toen slechter in plaats van beter. Alles wat erin staat gaat elke sessie mee als context, dus elke overbodige regel verdringt iets nuttigs. Ik houd nu één regel aan: staat er iets in dat Claude ook uit de code kan afleiden, dan haal ik het weg. Wat overblijft zijn commando's, conventies en de dingen die je nergens kunt zien.
4. Drie plekken voor je instructies
Er is een CLAUDE.md per project, één per submap en één voor jou persoonlijk in je home-map. Die laatste wordt vaak vergeten en is juist handig: daarin zet je jouw voorkeuren, niet die van de klant. Bij mij staat er onder andere in dat ik Nederlandse commitberichten wil en waar mijn eigen scripts staan. Dat hoort niet in de repo van een opdrachtgever.
5. Context is een budget
Alles wat in het venster staat concurreert met elkaar. Dit stuk maakt daar een expliciet vak van: wat laad je, wanneer gooi je het weg, en hoe vat je samen zonder het belangrijke te verliezen. Sindsdien denk ik bij elke instructie die ik toevoeg: verdringt dit iets nuttigers? Meestal wel.
