AGENTS.md bestanden nesten in een monorepo
Voorkom contextverlies door een te groot AGENTS.md bestand. Leer hoe u geneste configuraties in uw monorepo structureert voor betere prestaties en nauwkeurige AI-instructies.
Wat geneste AGENTS.md-bestanden in een monorepo betekenen
Geneste AGENTS.md-bestanden in een monorepo betekenen dat er één klein bestand in de root van de repository staat en één extra bestand in elke servicemap. Het rootbestand bevat de weinige regels die overal gelden, plus een overzicht van waar de andere bestanden zich bevinden. Elk servicebestand bevat de commando's en conventies die uitsluitend voor die map gelden. Een agent die services/worker/queue.py bewerkt, leest vervolgens het rootbestand en het worker-bestand, en verbruikt geen enkele context van de front-end die hij nooit zal aanraken.
Er hoeft niets te worden geïnstalleerd. AGENTS.md is een conventie en het upstream-project stelt dit duidelijk:
AGENTS.md is gewoon standaard Markdown. Gebruik welke koppen u maar wilt; de agent parseert simpelweg de tekst die u aanlevert.
Daarom is het de moeite waard om deze techniek goed te leren. Het formaat zal niet zomaar veranderen. Wat wel kan falen is de plaatsing en het onderhoud, en beide zijn uw verantwoordelijkheid.
Waarom stopt één groot root AGENTS.md met werken?
Een enkel AGENTS.md-bestand van 600 regels in de root van een repository die een web-app, een achtergrondworker en een Terraform-directory bevat, faalt op vier verschillende manieren.
Het veroudert omdat niemand er eigenaar van is. De engineer die een testscript in apps/web hernoemt, bewerkt bestanden onder apps/web. Het root AGENTS.md staat niet in die diff, dus geen enkele reviewer ziet de discrepantie. Zes weken later beschrijft het bestand een build-stap die niet meer bestaat, en de persoon die het heeft aangepast, is de wijziging vergeten.
Het kost context bij elke taak. Deze bestanden worden geladen aan het begin van de sessie, voordat de agent weet wat u gaat vragen. De documentatie van Claude Code geeft hier een getal aan: "streef naar minder dan 200 regels per CLAUDE.md-bestand. Langere bestanden verbruiken meer context en verminderen de naleving." Codex stopt met het samenvoegen van instructiebestanden zodra hun gecombineerde grootte 32 KiB bereikt, de standaard project_doc_max_bytes. Een root-bestand dat vier services documenteert, besteedt dat budget bij elke taak aan drie daarvan.
Instructies beginnen elkaar tegen te spreken. De web-directory wil pnpm test. De worker wil pytest -q. Wanneer ze in één bestand staan, is elke regel slechts een deel van de tijd correct, waardoor de agent moet raden welke van toepassing is. De documentatie van Claude Code beschrijft het resultaat: "als twee instructies elkaar tegenspreken, kan Claude er willekeurig een kiezen." Het splitsen van het bestand houdt de andere regel niet buiten de context. Claude Code voegt elk geladen instructiebestand samen in plaats van het ene door het andere te laten vervangen, dus het root-bestand is altijd aanwezig. Zodra de agent bestanden in zowel apps/web als services/worker heeft geopend, bevinden beide directory-bestanden zich samen in de context. Wat een per-directory-bestand doet, is elke regel koppelen aan de directory waarvoor deze geldt. Benoem de directory bovenaan het bestand, zoals de onderstaande voorbeelden doen met # apps/web, zodat elk commando aangeeft waar het van toepassing is wanneer er meerdere bestanden tegelijk zijn geladen. Wanneer een regel waarvan u zeker weet dat u deze duidelijk hebt geschreven toch wordt overgeslagen, is het doornemen van de redenen waarom een instructie nooit wordt toegepast effectiever dan de formulering voor de vierde keer herschrijven.
Het raakt gevuld met feiten die de agent uit de code kan lezen. Een directory-structuur, een afhankelijkhedenlijst, een samenvatting van wat elk pakket doet. De /doctor-controle van Claude Code bestaat om precies dit te verwijderen. Het "snijdt inhoud weg die Claude uit de codebase kan afleiden, zoals directory-layouts, afhankelijkhedenlijsten en architectuuroverzichten" en behoudt "valkuilen, rationale en conventies die afwijken van de standaardinstellingen van tools." Die zin is de beste test die ik ken om te bepalen of een regel überhaupt in het bestand thuishoort.
Leest de agent het root-bestand, of alleen het dichtstbijzijnde bestand?
Dit is waar de meeste mensen het model verkeerd begrijpen. Daarom is het zinvol om de upstream-conventie te citeren in plaats van deze te parafraseren:
Plaats een extra AGENTS.md in elk pakket. Agents lezen automatisch het dichtstbijzijnde bestand in de mappenstructuur, dus het meest nabijgelegen bestand krijgt voorrang en elk subproject kan specifieke instructies bevatten.
En over conflicten:
Het AGENTS.md dat zich het dichtst bij het bewerkte bestand bevindt, wint; expliciete chatprompts van de gebruiker overschrijven alles.
"Krijgt voorrang" wordt door veel mensen gelezen als "het root-bestand wordt genegeerd". Dat is niet het geval. In de tools die de conventie implementeren, wordt elk bestand op het pad vanaf de repository-root tot aan de werkmap gelezen en samengevoegd. Het dichtstbijzijnde bestand wint alleen wanneer twee bestanden verschillende dingen zeggen over hetzelfde onderwerp.
Codex is expliciet over het mechanisme: "Codex voegt bestanden vanaf de root samen en verbindt ze met lege regels. Bestanden die dichter bij uw huidige map staan, overschrijven eerdere instructies." Claude Code volgt hetzelfde pad. Bij het starten van een sessie leest het "elke AGENTS.md en .claude/AGENTS.md in uw werkmap en de bovenliggende mappen", en de documentatie stelt het laadmodel duidelijk vast: "Alle gevonden bestanden worden samengevoegd in de context in plaats van elkaar te overschrijven." Mappen onder de werkmap gedragen zich anders: Claude Code laadt een AGENTS.md van een submap op aanvraag, "wanneer Claude daar een bestand opent met de Read-tool."
Hieruit volgen twee praktische consequenties. Het root-bestand vormt een prefix voor elke sessie in de repository; behandel elke regel daar dus als een regel waar u honderd keer per week voor betaalt. Een bestand per map kost niets totdat de agent een bestand in die map opent, wat betekent dat details daar goedkoop zijn en daar thuishoren.
Dit gedrag is op 27 oktober 2026 gecontroleerd aan de hand van de documentatie van Codex en Claude Code. Tools implementeren de conventie op licht afwijkende wijze en ze veranderen, dus controleer de laadregels voor de agent die uw team gebruikt.
Een werkende lay-out voor een repository met drie services
repo/
AGENTS.md rules true everywhere, plus the map
apps/web/AGENTS.md TypeScript client, Vite, Vitest
services/worker/AGENTS.md Python queue consumer, pytest
infra/AGENTS.md Terraform and the deploy scriptsHet root-bestand is bewust kort gehouden. Het geeft aan waar gezocht moet worden en bevat alleen de regels die in elke directory gelden.
# AGENTS.md
This is a monorepo. Each top-level directory ships its own AGENTS.md.
Read this file and the AGENTS.md nearest the code you are editing
before you change anything.
- `apps/web` browser client
- `services/worker` queue consumer
- `infra` Terraform and deploy scripts
## Rules for the whole repository
- The package manager is `pnpm`. `npm install` writes a second lockfile
that CI ignores, so the install you tested is not the install that ships.
- Any `generated/` directory is build output. Edit the schema in
`schemas/` and run `pnpm codegen` instead.
- `.env.local` holds real credentials. Do not read it and do not print it.
- If you change code in a directory, update that directory's AGENTS.md
in the same commit.Het per-directory-bestand bevat de details en kan zo lang zijn als nodig is voor de betreffende directory.
# apps/web
Browser client. Vite and React, TypeScript with `strict` on.
## Commands
- `pnpm dev` serves on port 5173.
- `pnpm test` runs Vitest once and exits.
- `pnpm typecheck` runs `tsc --noEmit`.
## Conventions
- One component per file under `src/components/`.
- All HTTP goes through `src/api/client.ts`. Do not call `fetch` directly,
because the client attaches the auth header and retries on 429.
## Traps
- `pnpm build` does not type check. Vite strips the types instead of
checking them, so a broken type still produces a green build.
Run `pnpm typecheck` as a separate step.Het worker-bestand heeft dezelfde structuur maar andere inhoud: het installatiecommando, pytest -q, de reden waarom de consumer idempotent moet blijven, en de migratie die moet draaien voordat de tests slagen. In het infra-bestand schrijft u de regels die voorkomen dat een agent schade aanricht. Voer nooit terraform apply uit. Voer terraform plan uit en stop daar, en specificeer de state backend die al geconfigureerd is, zodat de agent niet probeert een nieuwe te initialiseren.
Let op wat in geen van deze bestanden staat: een beschrijving van waar elke service voor dient. Dat is informatie voor mensen. Upstream trekt dezelfde grens en stelt: "README.md-bestanden zijn voor mensen: quick starts, projectbeschrijvingen en richtlijnen voor bijdragen", terwijl AGENTS.md "de extra, soms gedetailleerde context bevat die coding agents nodig hebben: build-stappen, tests en conventies." De scheiding tussen AGENTS.md en een op mensen gerichte README doorloopt die grens zin voor zin, en een DESIGN.md waarin wordt vastgelegd waarom de code op deze manier is vormgegeven beslaat het derde bestand, het bestand dat beslissingen uitlegt in plaats van commando's.
Wie werkt het bestand bij wanneer de code wijzigt?
Er geldt één regel, en die staat in het root-bestand: wie code in een directory wijzigt, werkt in dezelfde commit de AGENTS.md van die directory bij.
Dit werkt om een mechanische reden, niet om een culturele. Het bestand per directory bevindt zich in dezelfde diff als de code, waardoor de reviewer van de pull request beide tegelijk ziet. Een root-bestand is van iedereen, wat betekent dat het van niemand is, en het zit nooit in de diff die iemand op dat moment leest.
Ondersteun de regel met een controle op de pull request. Deze zoekt de dichtstbijzijnde AGENTS.md boven elk gewijzigd bestand en rapporteert wanneer dat bestand niet is aangepast.
#!/usr/bin/env bash
# Warn when code changed but the nearest AGENTS.md above it did not.
changed=$(git diff --name-only origin/main...HEAD)
nearest_doc() {
d=$(dirname "$1")
while [ "$d" != "." ]; do
if [ -f "$d/AGENTS.md" ]; then echo "$d/AGENTS.md"; return; fi
d=$(dirname "$d")
done
echo "AGENTS.md"
}
printf '%s\n' "$changed" | while read -r f; do
[ -n "$f" ] || continue
case "$f" in AGENTS.md|*/AGENTS.md) continue ;; esac
doc=$(nearest_doc "$f")
printf '%s\n' "$changed" | grep -Fqx "$doc" && continue
echo "note: $f changed but $doc was not updated"
doneOp een branch die de API client heeft aangepast zonder de documentatie te wijzigen, ziet de output er als volgt uit:
note: apps/web/src/api/client.ts changed but apps/web/AGENTS.md was not updatedHoud het bij een waarschuwing in plaats van een blokkade. Een harde blokkade leert mensen om een lege regel aan het bestand toe te voegen zodat CI groen wordt; een bestand dat is bewerkt om een robot tevreden te stellen is minder waard dan helemaal geen bestand. De waarschuwing geeft de reviewer een vraag om te stellen, en dat is het onderdeel dat daadwerkelijk werkt.
Hoe herken ik een verouderd AGENTS.md-bestand?
Er zijn twee controles die u vandaag kunt uitvoeren, en één symptoom dat u tijdens een sessie zult opmerken.
Vergelijk de ouderdom van elk bestand met de ouderdom van de code die het beschrijft. %cs toont de commit-datum als YYYY-MM-DD.
for f in $(git ls-files '*AGENTS.md'); do
d=$(dirname "$f")
printf '%s doc:%s code:%s\n' "$f" \
"$(git log -1 --format=%cs -- "$f")" \
"$(git log -1 --format=%cs -- "$d")"
doneapps/web/AGENTS.md doc:2026-02-11 code:2026-08-07
services/worker/AGENTS.md doc:2026-07-29 code:2026-08-09
infra/AGENTS.md doc:2026-08-01 code:2026-08-01Een documentatiedatum die zes maanden achterloopt op de code-datum bewijst niet dat het bestand onjuist is. Het geeft aan welk bestand u als eerste moet lezen, en dat is alles wat u nodig heeft van een controle die slechts één seconde duurt.
Zoek naar paden die niet langer bestaan. Documentatie veroudert op een zeer specifieke manier: het blijft code beschrijven die is verwijderd. Elk pad in deze bestanden staat tussen backticks, waardoor ze eenvoudig te extraheren en te testen zijn.
grep -o '`[^`]*`' apps/web/AGENTS.md | tr -d '`' | grep '/' | while read -r p; do
[ -e "$p" ] || [ -e "apps/web/$p" ] || echo "missing: $p"
doneLees de uitvoer in plaats van dit proces in uw CI te automatiseren. Het markeert ook globs zoals src/**/*.ts en elke URL die u heeft geciteerd, omdat beide een slash bevatten en geen van beide een bestand op de schijf is. Op Claude Code v2.1.283 of later voert /doctor prompt-audit een vergelijkbare controle voor u uit: het zoekt naar "verwijzingen naar bestanden of commando's die niet bestaan" en naar bestanden die elkaar tegenspreken, dekt standaard uw AGENTS.md-bestanden af en wijzigt niets totdat u vraagt om de voorgestelde bewerkingen toe te passen.
Het symptoom tijdens een sessie. De agent leest het bestand, probeert src/api/client.ts te openen omdat het bestand dat voorschrijft, en de tool geeft de volgende melding:
No such file or directoryDe agent doet vervolgens het logische: hij schrijft zijn eigen fetch-wrapper. Dat is de werkelijke kostprijs van een verouderd bestand. De agent negeert uw documentatie niet. Hij volgt de documentatie, komt uit op een pad dat drie maanden geleden is verwijderd en herbouwt code die u al heeft. Een vaardigheid zoals Ponytail, die een agent dwingt tot de kleinst mogelijke werkende wijziging, maakt die herbouw-instincten zeldzamer, maar het kan geen helper vinden waarnaar uw bestand naar de verkeerde locatie verwees.
Leest Claude Code AGENTS.md-bestanden?
Ja, vanaf Claude Code v2.1.277, en de exacte regel is van belang omdat de geneste structuur ervan afhangt. Gecontroleerd aan de hand van de documentatie op 27 oktober 2026: "Claude Code kan AGENTS.md lezen als uw projectinstructies, dus een repository die al is ingericht voor andere coding agents werkt zonder toevoeging van een CLAUDE.md, een import of een instelling." De standaardwaarde voor Project instructions, claude-md-or-agents-md, leest "uw AGENTS.md-bestanden wanneer u geen CLAUDE.md of CLAUDE.local.md in uw werkmap of daarboven heeft." Geneste bestanden worden ook gedekt: Claude leest de AGENTS.md van een submap "wanneer Claude daar een bestand opent met de Read-tool", zolang "die submap zelf geen van de drie CLAUDE.md-bestanden heeft". Die drie zijn CLAUDE.md, .claude/CLAUDE.md en CLAUDE.local.md, dus een persoonlijke CLAUDE.local.md in apps/web is voldoende om het laden van apps/web/AGENTS.md te stoppen.
Dat maakt het oude advies om een CLAUDE.md naast elke AGENTS.md te plaatsen tot een valstrik. Met een AGENTS.md en een CLAUDE.md of CLAUDE.local.md in uw werkmap of daarboven, stelt de documentatie dat Claude "alleen uw CLAUDE.md-bestanden" leest. Een .claude/CLAUDE.md telt op dezelfde manier. Eén begeleidend bestand in de root met een enkele Claude-specifieke regel verbergt elke AGENTS.md op het pad, en een persoonlijke CLAUDE.local.md doet hetzelfde. Als u er een wilt behouden, typ dan /config en stel Project instructions in op claude-md-and-agents-md, wat beide leest, eerst de CLAUDE.md van elke map en daarna de AGENTS.md.
Een versienummer alleen bevestigt niet dat het werkte. U heeft v2.1.277 of later nodig, maar vóór v2.1.281 lazen sommige sessies, zoals die op Amazon Bedrock of met uitgeschakelde telemetrie, alleen CLAUDE.md-bestanden, en in sommige gevallen slaat de eerste sessie na een upgrade vanaf v2.1.276 of eerder ook AGENTS.md over: de documentatie stelt "Claude leest AGENTS.md vanaf uw volgende sessie". Controleer dus de sessie zelf. In een interactieve sessie print Claude Code een regel zoals no CLAUDE.md found; AGENTS.md loaded: gevolgd door het pad, en in huidige versies vermeldt /memory het bestand. Vóór v2.1.280 vermelden /memory en /context geen AGENTS.md die Claude direct las, dus vraag op die versies aan Claude wat de projectinstructies zijn.
De importvorm is nog steeds correct waar Claude AGENTS.md niet direct kan lezen: een oudere versie, een sessie vóór v2.1.281 op Amazon Bedrock of met uitgeschakelde telemetrie, een sessie waarbij de ingebouwde plugin die het leest is uitgeschakeld, of een project dat een CLAUDE.md behoudt met Project instructions ingesteld op claude-md. Plaats dit in services/worker/CLAUDE.md:
@AGENTS.md
## Claude Code
Use plan mode for changes under `services/worker/migrations/`.De symlink-vorm is correct wanneer er niets tool-specifieks hoeft te worden toegevoegd.
git ls-files '*AGENTS.md' | while read -r f; do
ln -s AGENTS.md "$(dirname "$f")/CLAUDE.md"
done
ls -l apps/web/CLAUDE.mdln print niets bij succes, dus controleer de lijst: apps/web/CLAUDE.md -> AGENTS.md. Start vervolgens een sessie en voer /context uit, waarbij de geladen bestanden verschijnen onder Memory files. Op Windows vereist een symlink Administrator-rechten of Developer Mode, en Git checkt een gecommitteerde symlink uit als een plat tekstbestand tenzij core.symlinks is ingeschakeld, wat die kloon achterlaat met een CLAUDE.md van één regel in plaats van uw instructies. Als iemand die de repository kloont op Windows werkt, gebruik dan de @AGENTS.md-import. Als u een van beide workarounds heeft ingesteld voordat Claude Code AGENTS.md zelfstandig las, kunt u deze laten staan: de documentatie stelt dat het behouden van de import "er nooit voor zorgt dat Claude AGENTS.md twee keer leest", en een symlinked CLAUDE.md wordt één keer gelezen.
Eén valstrik hoort hierbij. Na /compact wordt de CLAUDE.md in de project-root opnieuw vanaf schijf gelezen, maar geneste bestanden in submappen worden niet opnieuw geïnjecteerd. Claude Code herlaadt deze op verzoek, de volgende keer dat de agent met een bestand in die map werkt. De documentatie specificeert dit voor CLAUDE.md-bestanden en beschrijft compactie niet afzonderlijk voor een direct gelezen AGENTS.md, dus verwacht dat geneste bestanden van beide namen zich op deze manier gedragen. Als een regel per map halverwege een lange sessie niet meer lijkt te gelden, is dat meestal de reden, en het lezen van een willekeurig bestand in die map lost dit op.
Instellingen die andere agents naar AGENTS.md verwijzen
Codex leest AGENTS.md native. Op elk niveau controleert het eerst op AGENTS.override.md, wat één map een lokale override geeft zonder het gedeelde bestand te bewerken. Het stopt met samenvoegen zodra de gecombineerde grootte 32 KiB bereikt, de standaard project_doc_max_bytes, wat nog een reden is om het root-bestand klein te houden.
Aider neemt het via .aider.conf.yml met de regel read: AGENTS.md.
Gemini CLI neemt het via .gemini/settings.json met { "context": { "fileName": "AGENTS.md" } }.
Upstream documenteert een achterwaarts compatibele naamswijziging voor repositories die nog de oudere enkelvoudige naam gebruiken: mv AGENT.md AGENTS.md && ln -s AGENTS.md AGENT.md.
In een zeer grote monorepo slaat de claudeMdExcludes-instelling van Claude Code ancestor-bestanden over op basis van pad of glob, wat nuttig is wanneer de map van een ander team boven die van u staat. De patronen zijn ook van toepassing op de AGENTS.md-bestanden die Claude Code leest.
Waarin verschilt dit van agentgeheugen of een skill?
Deze mechanismen lijken op elkaar, maar falen op totaal verschillende manieren. Het is daarom de moeite waard om nauwkeurig te bepalen welke u nodig heeft.
AGENTS.md wordt door u geschreven, naar git gecommit, beoordeeld in een pull request en is identiek voor iedereen die de repository kloont. Agentgeheugen wordt door de agent geschreven, buiten de repository opgeslagen en is lokaal aan één machine. De documentatie van Claude Code trekt dezelfde grens: CLAUDE.md bevat "Instructies en regels" die u schrijft, automatisch geheugen bevat "Leerpunten en patronen" die Claude schrijft, en de geheugenmap wordt niet gedeeld tussen machines. De test is eenvoudig. Als een feit waar moet zijn voor een collega met een verse kloon, kan het niet in het geheugen staan. Hoe agentgeheugen behouden blijft tussen sessies behandelt dat deel van het plaatje.
Een skill is het derde aspect. AGENTS.md is context die bij elke sessie wordt geladen; een skill is een procedure die wordt geladen wanneer deze nodig is. De documentatie van Claude Code geeft een bruikbare regel: "Als een item een procedure met meerdere stappen is of slechts voor één deel van de codebase relevant is, verplaats het dan naar een skill of een regel met een pad-scope." De tweede helft van die zin is precies wat een geneste AGENTS.md oplost. De eerste helft is waar agent skills voor zijn, en wanneer dezelfde procedure in meer dan één repository nodig is, deel de skill tussen repo's in plaats van dezelfde paragrafen in tien verschillende AGENTS.md-bestanden te plakken.
Upstream merkt op dat "op het moment van schrijven de hoofd-repository van OpenAI 88 AGENTS.md-bestanden bevat". Dat getal is het hele argument. Een grote repository heeft geen groter bestand nodig. Het heeft meer kleine bestanden nodig, elk naast de code die het beschrijft, en elk beheerd door degene die die code als laatste heeft gewijzigd.
FAQ
Vervangt een genest AGENTS.md het root-bestand of wordt het eraan toegevoegd?
Het wordt eraan toegevoegd. Upstream wordt gesteld dat "het dichtstbijzijnde bestand voorrang heeft", wat beschrijft wat er gebeurt bij een conflict, niet wat er wordt geladen. Codex "voegt bestanden vanaf de root naar beneden samen en scheidt ze met lege regels", en Claude Code voegt elk bestand samen dat het vindt tijdens het doorlopen van de mappenstructuur vanaf de werkmap, in plaats van ze te overschrijven. Het dichtstbijzijnde bestand wint alleen wanneer twee bestanden verschillende instructies geven over hetzelfde onderwerp. Schrijf gedeelde regels één keer in de root en herhaal deze niet in elke map.
Hoe groot moet het root-bestand AGENTS.md zijn?
Klein genoeg zodat u het niet erg vindt als het boven op elk verzoek wordt geplakt dat u in die repository doet, want dat is wat er gebeurt. De documentatie van Claude Code suggereert een limiet van minder dan 200 regels per bestand en waarschuwt dat langere bestanden "de naleving verminderen". Codex stopt standaard met het samenvoegen van instructiebestanden bij 32 KiB in totaal. Als uw root-bestand vier services documenteert, is het grootste deel daarvan overbodige ballast voor een specifieke taak. Verplaats details naar bestanden per map en laat een verwijzing achter.
Hoe voorkom ik dat deze bestanden verouderen?
Voeg één regel toe aan het root-bestand: wie code in een map wijzigt, werkt in dezelfde commit ook het AGENTS.md van die map bij. Het plaatsen van het bestand naast de code zorgt ervoor dat de regel wordt nageleefd, omdat de wijziging dan in dezelfde pull request-diff verschijnt die een mens al aan het beoordelen is. Voeg een CI-waarschuwing toe die elk gewijzigd pad koppelt aan het dichtstbijzijnde AGENTS.md erboven, en vergelijk regelmatig git log -1 --format=%cs van elk bestand met hetzelfde commando uitgevoerd op de map die het documenteert.
Leest Claude Code AGENTS.md-bestanden?
Ja, vanaf v2.1.277. Gecontroleerd aan de hand van de documentatie op 27 oktober 2026: Claude Code leest standaard AGENTS.md wanneer u geen CLAUDE.md of CLAUDE.local.md in uw werkmap of daarboven heeft, en het leest het AGENTS.md van een submap wanneer het daar een bestand opent met de Read-tool en die submap zelf geen CLAUDE.md, .claude/CLAUDE.md of CLAUDE.local.md heeft. Voeg geen CLAUDE.md toe naast elk AGENTS.md: met één bestand in of boven de werkmap leest Claude "Your CLAUDE.md files only". Als u ook een CLAUDE.md nodig heeft, stel dan Project instructions in op claude-md-and-agents-md in /config, of zet @AGENTS.md op de eerste regel. Voer /memory uit in een sessie en bevestig dat het AGENTS.md-pad in de lijst verschijnt.
Waar plaats ik een regel die slechts soms van belang is?
Niet in AGENTS.md. Dat bestand wordt in elke sessie geladen, dus elke regel daarin concurreert om aandacht met het verzoek dat u daadwerkelijk heeft getypt. Een procedure met meerdere stappen die slechts af en toe nodig is, hoort thuis in een skill, die op verzoek wordt geladen. Een regel die van toepassing is op één map hoort thuis in het AGENTS.md van die map. Een feit dat de agent direct uit de code kan lezen, zoals de mappenstructuur of de afhankelijkhedenlijst, hoort in geen van beide thuis.