Meer dan 80 procent van de system prompt van Claude Code is geschrapt. Anthropic snoeide diep in de instructies voor modellen als Claude Opus 5 en Claude Fable 5, zonder meetbaar kwaliteitsverlies. Veel van wat als best practice gold voor context engineering blijkt voor Claude 5 een fabeltje. Richt je je CLAUDE.md files, skills en agents nog in volgens de regels van vorig jaar, dan rem je het model waarschijnlijk af in plaats van het te sturen.
Wat is context engineering precies
Wanneer je een bericht stuurt naar Claude, is je prompt slechts een klein deel van wat het model te zien krijgt. De rest van de context wordt samengesteld uit de system prompt, skills, CLAUDE.md files, geheugen en tooldefinities. Dat geheel heet context engineering en het bepaalt in hoge mate de kwaliteit van wat Claude Code of je eigen agent oplevert.
Het verschil met prompt engineering is dat context generiek werkt over veel verzoeken heen. Je weet niet vooraf welke prompt een gebruiker typt, dus schrijf je algemene richtlijnen die in elke situatie moeten kloppen. Dat is lastig. Hoe bouw je een algemene leidraad voor een model waarvan de capaciteiten steeds verder groeien?
Waarom de oude aanpak van Claude Code vastliep
Bij het doorlezen van interne transcripts ontdekte Anthropic dat Claude Code te strak aan banden was gelegd. In één verzoek konden de system prompt, skills en gebruikersinstructies elkaar tegenwerken. Claude kan de intentie van de gebruiker meestal wel interpreteren, maar moet dan eerst nadenken over overlappende en conflicterende boodschappen. Dat kost aandacht en tokens. Deze vorm van micromanagement heeft een naam gekregen: hobbling.
Die strenge regels waren ooit nodig om rampsscenario’s te voorkomen, zoals het verwijderen van bestanden. Oudere modellen maakten zonder die regels te veel fouten. Tegelijk groeide Claude Code door. Waar CLAUDE.md vroeger de enige plek was voor geheugen en richtlijnen, zijn er nu memory, artifacts en skills om context over sessies heen te laden en te delen. De reden voor die regels viel weg, maar de regels zelf bleven.
De nieuwe regels van context engineering voor Claude 5
Thariq Shihipar, lid van het technische team van Anthropic, zette de veranderingen op een rijtje. Je kan ze in zes regels samenvatten.
Van regels naar oordeel
De oude system prompt bevatte absolute verboden. Voor veel taken was zo’n verbod gewoon fout. De nieuwe instructie luidt “Write code that reads like the surrounding code”. Die richtlijn is lokaal en adaptief. Nieuwere modellen hebben voldoende beoordelingsvermogen om zelf keuzes te maken.
Van voorbeelden naar interfaces
Lange tijd was het geven van voorbeelden de belangrijkste regel voor toolgebruik. Bij de nieuwste modellen werken voorbeelden juist beperkend, omdat ze het model naar een vaste exploratieruimte sturen. Denk na over het ontwerp van je tools, scripts en bestanden. Welke parameters heeft Claude nodig en hoe kunnen die expressiever worden?
Van alles vooraf naar progressive disclosure
Omdat Claude Code zich op programmeren richt, bevatte de system prompt uitgebreide informatie over code review en verificatie. Cruciaal wanneer nodig, maar meestal overbodig. Claude Code is inmiddels bedreven in progressive disclosure, het laden van de juiste context op het juiste moment. Verificatie en code review verhuisden naar eigen skills die selectief worden aangeroepen. Sommige tools laden hun volledige definitie zelfs pas nadat de agent ernaar heeft gezocht via ToolSearch. Dezelfde gedachte geldt voor je eigen CLAUDE.md en skills. Maak er geen centrale opslag van alles wat ooit misging, maar een boomstructuur van bestanden die op het juiste moment laden.
Van herhaling naar eenvoudige toolbeschrijvingen
Oudere modellen luisterden beter naar instructies aan het einde van het context window dan aan het begin. Daarom stonden aanwijzingen soms dubbel, zowel in de system prompt als in de toolbeschrijving. Die herhalingen kunnen allemaal weg. Instructies over hoe een tool werkt horen in de toolbeschrijving thuis, niet in de system prompt.
Van CLAUDE.md naar automatisch geheugen
Vroeger was het advies om met de # toets aantekeningen naar CLAUDE.md te schrijven. Nu slaat Claude relevante herinneringen automatisch op, afgestemd op het werk en op jou. Ook voor plannen is verandering. Waar plan mode lang leunde op markdown bestanden, kan Claude inmiddels verwijzen naar HTML artifacts, een gedetailleerde testsuite als specificatie of een functie uit een andere codebase die moet worden overgezet.
Van specificaties naar rubrics
Een rubric is een nieuwe vorm van referentie waarmee Claude jouw smaak in een vakgebied kan toetsen, bijvoorbeeld hoe een goed API ontwerp eruitziet. Dynamische workflows starten verifier agents op die een rubric gebruiken om het resultaat te beoordelen. Context wordt zo niet alleen beschrijvend, maar ook verifieerbaar.
Zo pas je context engineering toe op je eigen project
Een system prompt is sterk verbonden met de productcontext. Die vertelt Claude in welk product het opereert en wat het moet doen. Gebruik je Claude Code, dan pas je hier zelden iets aan. Bouw je een harness voor je eigen agent, dan is het belangrijk om hier veel tijd in te steken.
Hou je CLAUDE.md licht. Beschrijf kort waar je repo voor dient en besteed de meeste tokens aan de valkuilen in je codebase. Een voorbeeld is code zo organiseren dat types in één bestand zitten en nergens anders. Vermijd voor de hand liggende zaken die Claude zelf in je bestandssysteem ziet.
Gebruik progressive disclosure. Heb je uitgebreide instructies voor verificatie, maak dan een verificatie skill en verwijs ernaar in je CLAUDE.md. Zie skills als beknopte gidsen waarmee Claude informatie vindt indien nodig, niet als overgedetailleerde draaiboeken. Skills werken het best als ze jouw specifieke meningen, kennis en werkwijzen vastleggen. Alleen als fouten dure consequenties hebben, begrens je je skill strakker.
Verwerk referenties door bestanden met @ te vermelden en verkies code boven beschrijvingen. Een HTML mockup van een ontwerp levert betere resultaten op dan een screenshot of een stuk proza, omdat code een taal is die Claude uitstekend beheerst.
Anthropic verwerkte deze best practices in het commando claude doctor. Met /doctor in Claude Code analyseer je je skills en CLAUDE.md files en breng je ze terug naar de juiste omvang. Anthropic publiceerde daarnaast een Fable field guide met aanvullende richtlijnen voor het prompten van geavanceerdere modellen.
Kritische kanttekeningen bij de nieuwe regels
De claim van Anthropic luidt dat er geen meetbaar verlies was op de eigen coding evaluaties. Dat is geen garantie voor jouw evaluaties. Schrap je regels, draai dan achteraf je eigen harness opnieuw en behandel /doctor als assistent, niet als rechter. Beoordeel de voorgestelde verwijderingen zelf.
Ook het automatische geheugen krijgt kritiek. In de developercommunity melden gebruikers dat agents te veel of te willekeurig onthouden en herinneringen op verkeerde momenten toepassen. Sommigen schakelden de functie juist uit en kregen voorspelbaarder gedrag terug met gedetailleerdere CLAUDE.md files en skills. Projectcontext hoort volgens criticasters in de repo plaats, waar het hele team de context kan vinden, reviewen en corrigeren.
Tot slot blijven strikte regels noodzakelijk waar fouten onacceptabel zijn, zoals bij het behandelen van financiële transacties en persoonsgegevens. Het nieuwe credo is niet dat regels verboden zijn, maar dat elke regel zijn bestaan moet rechtvaardigen. Zoek als eerste stap naar absolute verboden in je CLAUDE.md en skills, bewaar degene die noodzakelijk zijn en verwijder degene die elkaar tegenspreken of smaak herhalen die het model allang heeft.
Context engineering wordt ontwerpwerk
De kern van de verschuiving is dat context engineering steeds minder lijkt op instructies schrijven en steeds meer op ontwerpen. Je ontwerpt interfaces, mappenstructuren en verificatiesystemen en vertrouwt het model voor de rest. Dat vraagt om een nieuwe vaardigheid. De schaarse resource is niet langer de aandacht van het model voor jouw regels, maar jouw eigen helderheid over wat er echt toe doet in je project. Heb je die helderheid, dan volstaat één zin. Laat Claude zelf de rest bedenken.
