Het probleem
Laten we eerlijk zijn: we willen geen code meer lezen. We willen niet alles nakijken wat agents doen, en niet elk technisch detail van het project in ons hoofd houden.
Maar als niemand de agents in toom houdt, veranderen ze elk project in een onhoudbare chaos die mens noch agent nog kan ontwarren. Het is slechts een kwestie van tijd.
Het idee
HUMAN-INTENT.md is één bestand in de root van je repository. Het bevat jouw intentie: de architectuur van het project, de ontwikkelregels en de productbeslissingen.
Het is geen documentatie van de code. Het is de wet waaraan de code moet gehoorzamen.
De regels
-
Geschreven door jou — en alleen door jou
Agents bewerken dit bestand nooit. Elke regel erin is een beslissing van een mens.
-
Zijn instructies zijn wet voor de agent
Wat in HUMAN-INTENT.md staat, gaat boven al het andere. Als de code het bestand tegenspreekt, is de code fout.
-
Het bepaalt architectuur, regels en product
Intentie, geen recepten. De agent kent alle patronen al; jouw taak is vastleggen wat waar moet zijn — en waarom.
Waarom het werkt
Agents zijn niet bij te houden: er ontstaat meer code dan iemand wil lezen. Elke regel controleren is hopeloos. De intentie controleren niet.
HUMAN-INTENT.md tilt de controle een niveau hoger: je houdt één bestand met jouw beslissingen in de gaten in plaats van duizenden regels code. Zolang het bestand wet is, volgt het project jouw intentie — ook als niemand de code leest.
Hoe te beginnen
- Maak HUMAN-INTENT.md aan in de root van je repository.
- Schrijf de beslissingen op die je al hebt genomen: architectuur, ontwikkelregels, product.
- Zeg je agent het bestand te lezen en als wet te behandelen — verwijs ernaar vanuit AGENTS.md of CLAUDE.md.
- Voeg elke nieuwe beslissing toe aan het bestand. Laat een agent er nooit in schrijven.
- Review dit bestand, niet de code.