Agentic engineering: bouwen met AI-agents en het werk in de hand houden

Wat is agentic engineering?

Een codeeragent is meer dan een chat die codefragmenten aanraadt. Hij werkt direct in je projectmap: hij leest bestanden, doorzoekt de code, draait tests, wijzigt meerdere bestanden en controleert het resultaat zelf. Agentic coding beschrijft wat de agent doet. Agentic engineering beschrijft de discipline eromheen: hoe je briefings schrijft, resultaten controleerbaar maakt en de verantwoordelijkheid houdt.

De term heeft een bekende peetvader. In februari 2025 bedacht Andrej Karpathy, medeoprichter van OpenAI, “vibe coding” voor een manier van programmeren waarbij je je volledig aan de vibes overgeeft en vergeet dat de code überhaupt bestaat. Collins koos het tot woord van het jaar 2025. Een jaar later, in februari 2026, noemde Karpathy “agentic engineering” zijn voorkeursterm voor de professionele variant: agentic, omdat je de code meestal niet meer zelf schrijft, maar agents aanstuurt en controleert; engineering, omdat er vakmanschap en ervaring in zit.

Agentic engineering of vibecoding: het verschil

Beide gebruiken dezelfde tools. Het verschil zit in hoeveel je vooraf vastlegt en hoe grondig je achteraf controleert.

Vibecoding is geen fout; het is gereedschap voor het juiste moment. Veel vibecoders stappen over op engineering zodra het experiment iets wordt wat anderen gebruiken.

Jij stuurt: briefing, review, beslissing

Bij agentic engineering verschuift je werk. Je typt minder code en doet drie dingen grondiger:

• Briefing: je beschrijft wat er gebouwd moet worden en waaraan je ziet dat het af is. Hoe preciezer de briefing, hoe minder correctierondes.
• Review: je leest de diff, bekijkt de testresultaten en probeert het resultaat uit. Een agent stopt als het werk af lijkt; alleen een review laat zien of het dat ook is.
• Beslissing: mergen of herwerken, volgende taak of koerswijziging. Die beslissingen blijven bij jou.

Typische knelpunten als je dagelijks met codeeragents werkt

Wie dagelijks met agents werkt, kent deze plekken:

• Openstaande punten verdwijnen in de chatgeschiedenis. Aan het eind van een sessie blijven er drie dingen over. Een paar dagen later zijn ze ondergesneeuwd door nieuwe berichten of samen met de sessie gesloten.
• Taken voor jou verstoppen zich in lange antwoorden. De agent heeft een API-sleutel, een DNS-record of een goedkeuring in de App Store nodig en noemt dat in de vierde alinea van zijn samenvatting.
• Meerdere sessies, meerdere projecten. In het ene venster loopt de cursuspagina, in een tweede een bugfix, in een derde een onderzoek. Alleen jij weet welke stand waar staat.
• Volle contextvensters. Lange sessies maken agents slechter; daarom raadt Anthropic aan tussen losse taken opnieuw te beginnen met /clear. Wat niet in een bestand staat, is dan voor de agent weg.

De oplossingen hebben één ding gemeen: de stand van het werk hoort in bestanden, niet in de chat.

In de praktijk: Claude Code-workflows die standhouden

Taken als bestanden in plaats van chatgeschiedenis

Maak elke taak aan als bestand dat de agent kan lezen en wijzigen: met titel, status, eigenaar en logboek. Dan begint elke nieuwe sessie met “Werk je openstaande taken af”, en vindt de agent alles wat hij nodig heeft, ook na /clear of in een andere tool. Aan het eind van een sessie luidt de briefing: “Maak taken aan voor de openstaande punten.”

Specs met acceptatiecriteria

Voor alles wat groter is dan een eenregelige wijziging schrijf je een spec: doel, vereisten en acceptatiecriteria die je kunt afvinken. In zijn best practices voor Claude Code raadt Anthropic aan om bij grotere features de agent eerst vragen te laten stellen en een spec te laten schrijven, en de implementatie daarna in een nieuwe sessie te starten. Goede specs noemen de betrokken bestanden, zeggen wat buiten de scope valt en eindigen met een controle die laat zien dat alles werkt.

De mate van zelfstandigheid bepalen: uitvoeren, concept, navragen

Niet elke taak verdraagt dezelfde vrijheid. Een dependency bijwerken mag de agent gewoon doen. Teksten voor de startpagina moet hij als concept voorbereiden, dat jij goedkeurt. Bij een databasemigratie moet hij eerst navragen. Beslis dat per taak, niet één keer voor alles.

Teruggaven in plaats van samenvattingen

Is de agent klaar, dan moet hij niet alleen antwoorden, maar de taak teruggeven: ter controle, met een notitie over wat hij heeft gedaan en waar het resultaat staat, of met een vraag als er iets ontbreekt. Wat alleen jij kunt doen, maakt hij aan als aparte taak voor jou.

Review met bewijs

Vraag om bewijs in plaats van beweringen: de testuitvoer, het uitgevoerde commando, een screenshot. Geef de agent iets wat hij zelf kan controleren, zoals tests of een build. Bij grotere wijzigingen helpt de planmodus van Claude Code (Shift+Tab): de agent leest en plant voordat hij iets wijzigt. En een tweede blik in een frisse context, bijvoorbeeld van een subagent, vindt gaten die de agent in zijn eigen code over het hoofd ziet. Codetaken doet hij in een eigen branch; jij beslist over de merge.

AGENTS.md en CLAUDE.md: de handleiding voor je agent

Elke sessie begint zonder herinnering aan de vorige. Wat de agent over je project moet weten, hoort daarom in een bestand dat hij bij de start leest. AGENTS.md is daarvoor een open formaat, een soort README voor agents, inmiddels beheerd door de Agentic AI Foundation onder de Linux Foundation. Codex, Cursor en veel andere tools lezen het. Claude Code leest CLAUDE.md en valt terug op AGENTS.md als er geen CLAUDE.md is; met @AGENTS.md neem je het ene bestand in het andere op. Gemini CLI leest GEMINI.md; de bestandsnaam is aan te passen.

# AGENTS.md

## Commando’s
- Tests: npm test
- Voor het afronden: npm run lint && npm run typecheck

## Regels
- Werk in een eigen branch, nooit op main.
- Geen push en geen deploy zonder goedkeuring.
- Nieuwe dependencies alleen na navraag.

## Taken
Taken staan in TandemLoop, gekoppeld als ./tandemloop.
Lees eerst ./tandemloop/AGENTS.md. Wat alleen ik kan doen
(toegang, goedkeuringen, beslissingen), maak je daar aan als taak voor mij.

Houd het bestand kort. Voor CLAUDE.md raadt Anthropic minder dan 200 regels aan, en alleen wat de agent niet zelf uit de code kan lezen. Herhaalt hij een fout, dan hoort de regel in het bestand; volgt hij een regel al lang, dan kun je hem schrappen.

Tools: Claude Code, Codex, Cursor, Gemini CLI

Welke tool je kiest, is minder belangrijk dan hoe je werkt. Staan instructies, specs en taken in bestanden, dan kun je van agent wisselen en gaat de nieuwe verder vanaf dezelfde stand.

Hoe TandemLoop agentic engineering ondersteunt

TandemLoop is een to-do-app voor Mac, iPad en iPhone waarin jij en je agent dezelfde taken delen. Ze staan als tekstbestanden in je iCloud Drive; je agent leest en schrijft ze rechtstreeks en volgt een handleiding die TandemLoop meelevert. Er is geen plug-in of API nodig.

Meerdere agents en sessies lezen dezelfde map en zien dezelfde stand. Er zou steeds maar één tegelijk moeten schrijven; anders kan de synchronisatie via iCloud conflictkopieën maken. De pagina Een to-do-app om met AI-agents te werken toont de hele workflow; de gids Claude Code en Obsidian beschrijft hoe dezelfde opzet eruitziet in een Obsidian-vault.

Naast de code is TandemLoop een volledige to-do-app met Inbox, projecten, vervaldatums en eigen weergaven. Volg je de GTD-methode, laat de agent dan de Inbox voorsorteren en de wekelijkse review voorbereiden.