/doctor prompt-audit: check je Claude Code-instructies op verouderde prompts

In het kort

• Wat: Claude Code versie 2.1.283 voegt een nieuw commando toe, /doctor prompt-audit (ook te starten als /checkup prompt-audit). Het scant je CLAUDE.md-bestanden, skills, agents en commands op promptpatronen die geschreven zijn voor oudere modellen.
• Waarom relevant: De instructies die je maanden geleden voor Claude opschreef, verouderen stilletjes. Verwijzingen naar bestanden die niet meer bestaan, commando's die veranderd zijn en instructies die elkaar tegenspreken sluipen erin — zonder dat je het merkt.
• Wat je ermee kunt: In één commando krijg je een rapport dat de grootste problemen bovenaan zet: stale paden, stale commando's en tegenstrijdige instructiebestanden komen eerst.

Wat is er precies nieuw?

Claude Code is de opdrachtregel-tool waarmee je Claude direct in je eigen projectmap laat werken. Veel teams sturen die tool bij met instructiebestanden. Het bekendste is CLAUDE.md: een soort huisregels waarin je vastlegt hoe Claude in jouw project moet werken. Daarnaast zijn er skills, agents en commands — kleinere bouwstenen die vaak ook uit zorgvuldig geschreven instructies (prompts) bestaan.

Het probleem: die instructies verouderen. Je begint met tekst die past bij het model van dat moment, maar Claude wordt beter en de aanpak verandert. Volgens de changelog van Claude Code lost het nieuwe commando dat aan. Letterlijk staat er dat 2.1.283 /doctor prompt-audit toevoegt om "your CLAUDE.md files, skills, agents and commands" te controleren op "prompting patterns written for older models".

Kort gezegd: het commando leest je eigen instructies terug en wijst aan wat achterhaald is.

Wat controleert het rapport?

Een eerdere verbetering (versie 2.1.282) beschrijft hoe het rapport is opgebouwd. De audit zet de meest storende problemen bovenaan:

• Stale paden — verwijzingen naar bestanden of mappen die niet meer bestaan of verplaatst zijn.
• Stale commando's — commando's in je instructies die inmiddels veranderd of vervallen zijn.
• Tegenstrijdige instructiebestanden — regels die elkaar tegenspreken, bijvoorbeeld twee bestanden die iets anders voorschrijven.

Bij dat laatste is het handig te weten dat er ook zoiets bestaat als "thinking keywords" die Claude Code officieel documenteert. Die worden juist behouden en niet als fout aangemerkt — de audit haalt dus niet zomaar alles overhoop, maar spaart wat bewust in de documentatie staat.

De volgorde is het belangrijkste deel. Je krijgt niet een ellenlange lijst waarin het echte probleem verstopt zit; de zaken die je aandacht het hardst nodig hebben, staan bovenaan.

Wat betekent dit concreet voor het Nederlandse MKB?

Stel: je hebt een half jaar geleden een CLAUDE.md opgezet zodat Claude jouw codebase, offertetemplates of documentatie op jouw manier behandelt. Sindsdien is je projectstructuur veranderd, is er een collega vertrokken, en heeft iemand een tweede instructiebestand toegevoegd. Niemand weet nog precies wat er in staat. Op zeker moment doet Claude iets wat niet klopt — en de oorzaak ligt in een oude instructie die naar een bestand wijst dat er niet meer is.

Dat is precies het soort onderhoud dat in een klein bedrijf blijft liggen. Er is geen aparte beheerder voor, en "het werkt toch" wint het meestal van "laten we het eens opschonen". /doctor prompt-audit maakt die opschoonronde klein en concreet: één commando, en je ziet zwart-op-wit wat er niet meer klopt.

Een paar praktische situaties waarin dit loont:

• Je hebt Claude Code een tijd niet actief onderhouden en wilt weten of je instructies nog kloppen.
• Meerdere collega's schrijven aan dezelfde instructiebestanden en je vermoedt tegenstrijdigheden.
• Je stapt over op een nieuwer Claude-model en wilt niet dat oude promptgewoontes je in de weg zitten.

Dat laatste punt sluit aan bij een eerdere ontwikkeling: teams kunnen inmiddels bewust sturen welk model ze gebruiken. Lees daarover Claude Code: teams zetten modelversies vast en blokkeren ze. Een audit van je prompts en grip op je modelversie horen bij hetzelfde huishoudelijke werk.

Wat kun je vandaag doen?

Je hebt hiervoor geen technische achtergrond nodig, maar het helpt als iemand met verstand van je projectopzet even meekijkt. In de praktijk komt het neer op:

• Zorg dat je Claude Code up-to-date is (versie 2.1.283 of nieuwer).
• Draai /doctor prompt-audit in het project waar je instructiebestanden staan.
• Loop het rapport van boven naar beneden af: begin bij de stale paden en tegenstrijdigheden.
• Pas je CLAUDE.md, skills, agents en commands aan waar nodig, en gooi weg wat niet meer klopt.

Het is geen magische knop die alles voor je oplost — het is een controlelijst die je opruimwerk richting geeft. Maar juist daardoor is het laagdrempelig: je hoeft niet zelf te bedenken waar je moet zoeken.

Weet je niet zeker of je instructies nog goed staan, of wil je iemand die dit soort onderhoud vaker heeft gedaan? Vind een Claude-specialist die met je meekijkt. Een goede opschoonronde kost meestal minder tijd dan je denkt en voorkomt vreemde uitkomsten later.

Tot slot

/doctor prompt-audit is geen groot nieuw model of spectaculaire functie, maar precies het soort gereedschap dat een klein bedrijf blij maakt: het maakt onderhoud dat anders blijft liggen behapbaar. Verouderde instructies opsporen was tot nu toe handwerk; nu krijg je er een rapport voor met de belangrijkste problemen bovenaan.

Wil je hier eens rustig over sparren, zonder verplichtingen? Plan een gratis kennismaking via [email protected] — dan kijken we samen wat voor jouw situatie zinvol is.

Santa Claude is een onafhankelijke community van Claude-specialisten en niet gelieerd aan Anthropic.