Anthropic schrapt 80 procent van zijn AI-instructies: zo ruim jij de jouwe op

Anthropic haalde vorige week ruim 80 procent uit de vaste instructies van Claude Code, de tekst die het model bij elke sessie meekrijgt. De programmeertests die het bedrijf zelf draait, gingen er niet op achteruit. Dat is een ongemakkelijke uitkomst voor iedereen die het afgelopen jaar zijn CLAUDE.md heeft volgeschreven met regels, uitzonderingen en voorbeelden. Wat er weg mocht, en wat ervoor terugkwam, is een vrij directe handleiding voor je eigen instructies: of je nu met Claude Code werkt of zelf een AI-agent bouwt voor je bedrijf.

Wat is context engineering precies?

Context engineering is alles wat naast je eigen prompt in het contextvenster van het model belandt: de system prompt van de tool, je CLAUDE.md-bestanden, skills, het automatische geheugen en de bestanden die je met een @ meestuurt. Je prompt is daar maar een dun laagje van.

Het verschil met prompten zit in de reikwijdte. Een prompt schrijf je voor één klus, dus die mag zo specifiek zijn als je wilt. Context gaat mee bij elk verzoek, ook bij verzoeken die je nog niet kent. Denk aan het verschil tussen een briefje voor de klusjesman en het personeelshandboek dat elke medewerker elke dag opnieuw moet lezen. Dat handboek moet kloppen voor situaties die je niet hebt bedacht.

Precies daar ging het mis, schrijft Thariq Shihipar, technisch medewerker bij Anthropic, in de blogpost van 24 juli. Zijn team las de eigen sessielogs terug en zag hoe de lagen elkaar in de weg zaten.

Waarom werkt het oude recept niet meer?

Omdat de lagen elkaar tegenspraken en het model daar denkwerk aan kwijt was. In één enkel verzoek stond volgens Anthropic zowel "laat documentatie staan waar dat gepast is" als "voeg GEEN commentaar toe", afkomstig uit de system prompt, een skill en de vraag van de gebruiker.

Die strenge regels waren ooit nodig. Oudere modellen schreven zonder rem commentaar op plekken waar het niet hoorde, of maakten ongevraagd planningsdocumenten aan. De prijs daarvoor was dat de regel ook gold in de gevallen waarin hij fout was. Zo zag de oude instructie eruit:

In code: default to writing no comments. Never write multi-paragraph
docstrings or multi-line comment blocks — one short line max. Don't create
planning, decision, or analysis documents unless the user asks for them —
work from conversation context, not intermediate files.

En zo ziet de vervanger eruit, in de huidige system prompt:

Write code that reads like the surrounding code: match its comment density,
naming, and idiom.

Vier verboden werden één opdracht. Het model kijkt nu naar de code eromheen in plaats van naar een lijst met dingen die het niet mag. Anthropic noemt dat proces unhobbling: de rem eraf halen waar het model die niet meer nodig heeft.

De zes verschuivingen op een rij

Anthropic zet zes oude vuistregels naast de nieuwe. Deze tabel is de kern van het hele verhaal.

De rode draad: je beschrijft niet langer stap voor stap hoe iets moet, je zorgt dat het model de juiste informatie kan vinden op het moment dat het die nodig heeft.

Wat gebeurde er met de takenlijst van Claude Code?

De omschrijving van de TodoWrite-tool kromp van ongeveer 9.100 tekens naar een handvol regels. In die 9.100 tekens stonden wanneer-gebruik-je-dit-lijsten en uitgewerkte voorbeelden, grofweg tweeduizend tokens die bij elke sessie meegingen. Wat ervoor in de plaats kwam, is bijna saai: een korte zin over wat de tool doet, een statusveld met drie mogelijke waarden, en één gedragsregel.

Het statusveld kan alleen pending, in_progress of completed zijn, met daarbij de afspraak dat er maar één taak tegelijk in uitvoering is. Die drie woorden vertellen het model meer over de bedoeling dan een pagina met voorbeelden. Even voor de beeldvorming: dit is het verschil tussen een formulier met een uitrolmenu en een handleiding die uitlegt wat je in het lege tekstvak mag typen.

Overigens passen ze dezelfde truc toe op de tools zelf. Een deel van de gereedschapskist wordt pas geladen als het model er expliciet naar zoekt. Zo kun je tientallen tools beschikbaar hebben zonder dat ze allemaal ruimte innemen zolang niemand ze gebruikt.

Hoe ruim je je eigen CLAUDE.md op?

In vijf stappen, en je bent er ongeveer een halfuur mee kwijt. Ze werken ook als je geen Claude Code gebruikt maar een eigen assistent hebt gebouwd met een system prompt.

Stap 1. Meet eerst wat je meestuurt. Draai /context in een lopende sessie. Je ziet dan welk deel van het venster opgaat aan system prompt, tools, skills en je eigen bestanden, nog voordat je iets hebt gevraagd.

Stap 2. Laat de opruimhulp meekijken. Anthropic heeft de nieuwe richtlijnen in een commando gestopt. In de officiële documentatie staat het zo: /doctor geeft een automatische controle van je installatie, instellingen, extensies en contextgebruik, en stelt fixes voor die het pas toepast nadat jij ze hebt goedgekeurd. Start Claude Code helemaal niet meer op? Dan draai je claude doctor vanuit je terminal.

Stap 3. Schrap alles wat het model zelf kan zien. Regels als "dit is een PHP-project" of "de tests staan in de map tests" zijn verspilde ruimte, want die informatie staat in je bestandssysteem. Wat wél in je CLAUDE.md hoort, zijn de valkuilen die je nergens kunt aflezen: dat alle types in één bestand staan, dat een bepaalde map wordt gegenereerd en niet met de hand bewerkt mag worden, dat een oude API alleen nog voor twee klanten draait.

Een uitgeklede versie ziet er ongeveer zo uit:

# Projectnaam

Wat dit is: klantportaal, PHP 8.4, eigen MVC-laag. Eén regel, meer niet.

## Valkuilen
- Alle types staan in src/Types.php. Nergens anders types aanmaken.
- public/build/ wordt gegenereerd. Nooit met de hand bewerken.
- De oude v1-API draait nog voor twee klanten. Niet verwijderen.

## Werkwijzen
Zie de skills: /verificatie (tests draaien), /release (uitrollen).

Stap 4. Verplaats procedures naar skills. Alles wat een stappenplan is en geen feit, hoort in een aparte skill. De documentatie van Claude Code is daar helder over: anders dan de inhoud van CLAUDE.md wordt de body van een skill pas geladen op het moment dat hij wordt gebruikt, waardoor lang naslagmateriaal vrijwel niets kost tot je het nodig hebt. Is een skill zelf lang geworden, splits hem dan op in meerdere bestanden.

Weet je niet waar je moet beginnen? Gebruik dan deze opdracht als startpunt in een sessie:

Lees mijn CLAUDE.md en al mijn skills. Deel elke regel in drie stapels:
(1) feiten over dit project die je niet uit de code kunt afleiden,
(2) stappenplannen die beter als aparte skill werken,
(3) regels die overbodig zijn omdat je ze zelf kunt zien of afleiden.

Toon de drie stapels als lijst, met per regel één zin waarom.
Wijzig nog niets. Ik kies daarna wat weg mag.

Stap 5. Leg harde regels vast in iets dat alarm slaat. Een zin in een tekstbestand is een advies dat het model afweegt tegen alle andere adviezen. Een test die rood wordt, een lint-regel of een hook die het commando gewoon blokkeert is geen advies. Alles wat echt altijd moet gelden, hoort in die tweede categorie.

Wat zeggen gebruikers die het al proberen?

In de Claude Code-community op Reddit liep deze week een druk gelezen draadje over precies deze vraag, opgezet door een gebruiker die merkte dat zijn oude CLAUDE.md-trucs niet meer werken sinds Claude Opus 5 er is. De meest gestemde reactie kwam van een ontwikkelaar die al had opgeruimd.

“Een groot deel van wat er in de CLAUDE.md van mensen staat, is littekenweefsel van een ouder model. Ik heb ongeveer de helft van de mijne geschrapt en er ging niets stuk.”

Ontwikkelaar in de r/ClaudeCode-community, vertaald uit het Engels

Zijn bestand is nu ongeveer vijftig regels lang. Wat er echt moest gelden, verhuisde naar een test of een hook. Zijn redenering: een regel in een document zakt stilletjes lager in de rangorde zodra het venster vol raakt. Een commando dat rood terugkomt, doet dat nooit.

Niet iedereen juicht. Een andere gebruiker in hetzelfde draadje wijst erop dat structuur nog steeds telt: korter betekent niet slordiger, en instructies zonder duidelijke opbouw leveren nog altijd rommelige resultaten op. Een derde deelt een praktische tussenweg die goed aansluit bij het Anthropic-advies: geneste CLAUDE.md-bestanden per map, zodat elke map alleen zijn eigen eigenaardigheden meestuurt.

Waar dit advies niet geldt

De nieuwe regels zijn geschreven voor de zwaarste modellen, en dat is geen detail. Anthropic test de kaalgeslagen system prompt met Claude Opus 5 en Claude Fable 5. Draai je je agent op een kleiner en goedkoper model, dan kunnen de oude guardrails nog steeds nodig zijn. Vergelijk het zelf voordat je schrapt: hetzelfde verzoek, één keer met en één keer zonder de regel.

Er is ook een categorie instructies die je juist nooit aan het oordeel van een model overlaat. "Stuur geen persoonsgegevens naar een externe API" is onder de AVG geen wens maar een verplichting, en die hoort in een permissie-instelling of een hook, niet in een alinea die concurreert met vijftig andere alinea's. Hetzelfde geldt voor de vastlegging die de EU AI Act vraagt van bedrijven die AI in risicovolle processen inzetten. Techniek die blokkeert is daar het antwoord, niet een vriendelijk verzoek in een tekstbestand.

En let op de rekenkant, want die snijdt twee kanten op. Instructies die je bij elke sessie meestuurt kosten tokens, en bij Claude Opus 5 betaal je 5 dollar per miljoen input-tokens tegen 10 dollar bij Fable 5. Tegelijk: in het Claude Pro-abonnement van zo'n 20 euro per maand merk je die tokens niet als een rekening maar als een limiet die eerder op is. Korter schrijven betekent daar simpelweg dat je langer kunt doorwerken.

Begin bij het bestand dat elke sessie meegaat

Open je CLAUDE.md en schrap wat het model zelf al kan zien. Dat is de kleinste ingreep met het grootste effect, en je hebt er geen nieuw abonnement, geen nieuw model en geen nieuwe tool voor nodig. Draai daarna /doctor en laat de rest voorstellen.

Dat opruimen raakt meer mensen dan alleen programmeurs. De ICT-sector is met 54 procent al jaren de koploper in AI-gebruik onder Nederlandse bedrijven volgens het CBS, en Nederland zit met 33,2 procent bedrijfsadoptie op 1,66 keer het EU-gemiddelde, blijkt uit cijfers van Eurostat. Dat betekent dat er in heel veel Nederlandse organisaties inmiddels instructiebestanden en interne assistenten rondslingeren die door drie generaties modellen heen zijn dichtgeschreven. Hoe die verhoudingen liggen per bedrijfsgrootte, staat in de AI-adoptiecijfers voor het Nederlandse mkb van TheAIDaily.

Heb je zelf skills gebouwd die je wilt afslanken, dan is het overzicht van populaire Claude-skills een goed vertrekpunt om te zien hoe anderen hun werkwijzen opdelen. En wil je dit soort updates automatisch binnenkrijgen, schrijf je dan in voor de dagelijkse AI-nieuwsbrief.