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.
Volg NexumOS, een fictieve maar realistische startup-repository, van een indrukwekkend maar broos prototype naar een systeem dat een team kan doorgronden en onderhouden. Onderweg werk je met repo-schuldscorekaarten, STACK-audits, instructiebestanden, skillpakketten, rolcharters, contextlagen, toolcontracten, pluginreviews, evals, CI-poorten en een beheerste route van vibe coding naar onderhoudbare software.
Dit is
geen verzameling slimme prompts. Het is geen leveranciershandleiding en het belooft geen autonome software zonder menselijk oordeel. Je krijgt duurzame engineeringpatronen onder tools die voortdurend veranderen, met implementatievoorbeelden die je aan je eigen omgeving kunt aanpassen en toetsen.
Stop met agentdemo's die alleen werken zolang jij erbij zit. Bouw de repository die het systeem draagt.
