AGENTS.md voor Codex: projectinstructies die standhouden

Een contract voor de werkomgeving

AGENTS.md beschrijft wat een code-agent over de repository moet weten voordat hij wijzigt. Denk aan architectuurgrenzen, verplichte controles, bestandsconventies en handelingen die expliciete toestemming vragen. Het bestand stuurt gedrag, maar vervangt geen technische toegangscontrole.

Werk van algemeen naar lokaal

Plaats brede afspraken bovenaan de repository en voeg alleen in gespecialiseerde mappen extra instructies toe. Zo krijgt een database-migratie andere controles dan een stijlaanpassing, zonder dat elke sessie alle details hoeft te dragen.

Schrijf waarneembare regels

Formuleer instructies als acties en uitkomsten: voer een bepaald testcommando uit, behoud bestaande API-contracten of wijzig nooit gegenereerde bestanden met de hand. Vermijd woorden als “netjes” en “goed” zonder acceptatiecriterium.

Geef een veilige route door de code

Benoem startpunten, bronbestanden en gegenereerde output. Leg uit welke map eigenaar is van data, waar migrations horen en hoe lokale services worden gestart. Daarmee verklein je zoekwerk én het risico op wijzigingen op de verkeerde plek.

Nee. Behandel het bestand als gewone repository-inhoud en verwijs voor secrets naar een veilig beheerproces.

Voorkom conflicterende instructies

Dupliceer dezelfde regel niet in meerdere bestanden. Laat lokale instructies alleen verfijnen wat bovenliggend geldt en documenteer uitzonderingen expliciet. Controleer na herstructureringen of oude bestanden nog worden ingelezen.

Verifieer in plaats van vertrouwen

Laat Codex na elke relevante wijziging linting, tests of een gerichte browsercontrole uitvoeren. Review zowel het resultaat als de gevolgde route. Een goed instructiebestand maakt verificatie standaard, niet optioneel.

# Working agreements - Read the local guide before editing - Run pnpm lint and pnpm test - Preserve unrelated worktree changes

Zo maak je AGENTS.md voor Codex toetsbaar

De beslisreview voor AGENTS.md voor Codex richt zich eerst op één genest repositorypad waar root- en lokale AGENTS.md-regels samen de toegestane wijziging en controles bepalen. Leg voor AGENTS.md voor Codex vooraf vast welk gebruikersresultaat aanvaardbaar is, welke invoer noodzakelijk blijft en wie de uitkomst mag goedkeuren. Houd de eerste proef van AGENTS.md voor Codex klein genoeg om oorzaken en gevolgen afzonderlijk te kunnen beoordelen.

Ontwerp voor AGENTS.md voor Codex bewijs rond één realistische succesroute en simuleer daarnaast tegenstrijdige instructies, handmatig gewijzigde gegenereerde output en een ontbrekend verificatiecommando. Noteer bij AGENTS.md voor Codex per controle de verwachte uitkomst, het zichtbare bewijs en de herstelactie wanneer de controle faalt. De laatste beslisvraag voor AGENTS.md voor Codex luidt: “Kan AGENTS.md secrets bevatten?”

AGENTS.md voor Codex: van proef naar dagelijks beheer

Wijs voor AGENTS.md voor Codex één operationele eigenaar, één inhoudelijke reviewer en een duidelijke terugvalroute aan. Behandel de checklist voor AGENTS.md voor Codex als afzonderlijke werkstappen met bewijs, zodat interpunctie of formulering nooit onderdeel van de proceslogica wordt. Laat de betrokken gebruiker AGENTS.md voor Codex doorlopen zonder mondelinge hulp en registreer elke plek waar uitleg of handmatig herstel nodig blijft.

Neem voor AGENTS.md voor Codex wijzigingsrechten, logging, support en reviewmomenten op in hetzelfde beheerplan. Herhaal de praktijktest van AGENTS.md voor Codex na een wijziging in brondata, configuratie, model, integratie of gebruikersrol. Breid AGENTS.md voor Codex pas uit wanneer het team ook tegenstrijdige instructies, handmatig gewijzigde gegenereerde output en een ontbrekend verificatiecommando tijdig herkent, begrenst en herstelt.

Stop de uitrol van AGENTS.md voor Codex zolang tegenstrijdige instructies, handmatig gewijzigde gegenereerde output en een ontbrekend verificatiecommando niet zichtbaar wordt gemeld en door de aangewezen eigenaar kan worden hersteld.