Het belangrijkste bestand in je AI-project is geen code

Als ik in een bouwtraining een project open, kijken de deelnemers meestal eerst naar de code. En dan wijs ik naar een ander bestand. Een gewoon tekstbestand, een paar schermen lang, zonder één regel code. Dat bestand bepaalt of je agent zelfstandig kan werken, of je om de vijf minuten iets komt vragen.

Onderaan dit artikel staat een prompt waarmee je agent je helpt om zo'n bestand op te stellen.

Cartoon
Het belangrijkste bestand in je AI-project is geen code: een AGENTS.md voor je agent

Het probleem dat iedereen kent

Als je een tijd met een AI-agent aan een project werkt, ken je het wel. Elke nieuwe sessie begint met uitleg. Dit is het project en zo zit het in elkaar. Daar staan de bestanden, en zo willen we het. Vergeet je iets, dan gaat de agent zelf op zoek. En dan maakt hij aannames die je later moet rechtzetten.

Dat ligt eigenlijk niet aan de agent. Hij begint elke sessie met een leeg geheugen. Hij weet alleen wat er in zijn context zit.

Je agent leest eerst zijn instructies, en per map leg je een kort bestand.
Je agent leest eerst zijn instructies, en per map leg je een kort bestand.

Veelgestelde vragen

Wat is een AGENTS.md en waarom heeft mijn AI-agent het nodig?

Het is een gewoon tekstbestand in je projectmap dat je agent automatisch leest aan het begin van elke sessie. Een agent begint elke keer met een leeg geheugen. Met dat bestand hoef je niet telkens opnieuw uit te leggen hoe je project in elkaar zit.

Wat zet ik in een AGENTS.md?

Ik zou het kort houden: wat het project is en voor wie, welke mappen er zijn, waar de agent mag lezen en schrijven, welke afspraken gelden en waar de belangrijke documenten staan. Verwijs liever naar een ander bestand dan alles te herhalen. Schrijf het in Markdown met korte koppen.

Wat doe ik als mijn tool naar CLAUDE.md zoekt in plaats van AGENTS.md?

Sommige tools zoeken nog naar hun eigen bestandsnaam. Ik zou in dat bestand één regel zetten die verwijst naar AGENTS.md. Dan leest elke tool hetzelfde bestand.

Hoe leer ik dit in de praktijk toepassen?

In AI-agents: bouw je eigen digitale collega en in Vibe Coding met AI: applicaties bouwen zonder programmeerkennis werk je hands-on aan een eigen project, waar je zo'n instructiebestand meteen kan gebruiken. Alle opleidingen, data en inschrijvingen vind je bij Workshops & Events.

Lees gratis verder

Registreer gratis met je e-mailadres en lees verder. Met je account open je de gratis artikels in de leerruimte; de rest is voor abonnees, vanaf Learn Plus.

Al geregistreerd? Nog geen account?

Nog geen reactiesLees de reacties

Reacties

Leden reageren hier en lezen elkaars reacties. Registreer gratis of log in om mee te praten.

Registreer gratis of log in

Nog geen reacties. Wat neem jij mee?

    QR-code van deze pagina

    coachsteff.live/het-bestand-dat-je-agent-leest

    Scan met je telefoon om de pagina te openen.