De Agentische Codebase

De demo werkte. Zes maanden later kon niemand hem reproduceren.

Je beste prompt zit begraven in de chatgeschiedenis. Regels spreken elkaar tegen. Toolkoppelingen staan in de persoonlijke configuratie van één engineer. Dan verschijnt een nieuw model, en niemand weet of het systeem beter werd of stilletjes brak.

Herkenbaar? Dan is het probleem niet nóg een zwakke prompt. Het is agentische repo-schuld.

De Agentische Codebase is een praktisch architectuurboek voor technische oprichters, senior engineers en AI-platformleiders die agentwerk reproduceerbaar, bestuurbaar en onderhoudbaar willen maken.

Het centrale idee: je repository is niet alleen de plek waar de output van een agent terechtkomt. Het is het besturingssysteem waarin de agent werkt.

Het boek introduceert STACK, een vijflaags raamwerk voor dat besturingssysteem:

• Structure: maak de codebase vindbaar, begrensd en begrijpelijk.
• Toolchain: standaardiseer shells, CLI's, runners en uitvoeromgevingen.
• Agent configuration: verander losse prompts in geversioneerde regels, skills, rollen en workflows.
• Connection layer: beheer MCP-servers, hooks, plugins, credentials en toolcontracten.
• Knowledge and quality: organiseer geheugen, context, evals, observability, kosten en veiligheid.