--- title: "Versioneer het agent-OS zoals de app (STACK) | Len P. van der Hof | Len P. van der Hof" description: "Wanneer agents goed demonstreren maar daarna de repo laten rotten, heb je last van agentic repo-schuld. STACK is vijf lagen: structuur, toolchain, agent-configuratie, connectie, en kennis en kwaliteit." image: "https://lenvanderhof.com/media/generated/blog-hero-stack-os-nl-v2.2e85cab10797.wide.webp" --- [AI-systemen](https://lenvanderhof.com/nl/blog/categorie/ai-systemen/) Onderzoeksartikel # STACK: versioneer het agent-OS zoals je de app versioneert Regels verspreid over vijf tools. MCP zonder afspraken. Skills die van niemand zijn. Dat is geen probleem van het model. Len P. van der HofGepubliceerd 23 augustus 20262 min. leestijd Vijf lagen. Eén kast. Versioneer het agent-OS zoals de app. Direct antwoord STACK is een architectuur van vijf lagen voor repositories waar mensen en agents samenwerken: Structuur, Toolchain, Agent-configuratie, Connectie, en Kennis en kwaliteit. Je moet het agent-OS net zo versioneren als de applicatie. Als prompts, MCP-servers en skills buiten de repo leven, of verspreid over vijf plekken daarbinnen, bouw je agentic repo-schuld op. De oplossing is eigenaarschap en één bron van waarheid voor regels, niet een slimmer model. ## Belangrijkste inzichten - De kwaliteit van een demo is niet de kwaliteit van de repo. - Vijf lagen. Eén eigenaar per laag. Regels op één plek. - MCP hoort in Connectie, met een contract, of het hoort er helemaal niet. - Dit is het architectuurartikel. De introductie van het boek staat op een andere URL. Agents geven prachtige demo’s. Daarna begint de repository te stinken. Prompts in vier verschillende bestanden. Dezelfde regel in een README, een host-configuratie en in iemands hoofd. Een MCP-server die nergens gedocumenteerd staat. Die stank heeft een naam: agentic repo-schuld. ## De ziekte Een zwak model is zelden de oorzaak. Het echte probleem is een agent-OS dat niet als besturingssysteem is gebouwd. Het is een stapel losse onderdelen. Applicatiecode zou je nooit op die manier live zetten. Je versioneert de app. Je laat de code reviewen. Je weet exact wie eigenaar is van een package. De helft van de repo waar de agent in leeft, verdient diezelfde afkeer voor aannames en losse verhalen. ## Vijf lagen [STACK](https://lenvanderhof.com/nl/frameworks/stack/) is de kaart die ik gebruik: 1. **Structuur** — de enige plek waar agent-artefacten leven, nergens anders. 2. **Toolchain** — de hosts en runners, vastgezet, niet simpelweg “wat er toevallig op de laptop staat.” 3. **Agent-configuratie** — mandaten, prompts en skills, altijd met eigenaren. 4. **Connectie** — [MCP](https://lenvanderhof.com/nl/begrippen/mcp/) en andere contracten voor tools. Zichtbaarheid, mutatie, logs. 5. **Kennis en kwaliteit** — wat de agent als waarheid mag zien, plus de tests die een slechte wijziging direct afkeuren. Als een wijziging niet onder een van deze lagen valt, hoort die ook niet thuis in de beschrijving van je PR. “De agent een beetje aangepast” is geen geldige commit message. ## Versioneer het Behandel prompts, skills en servercontracten exact als code. - Ze horen in de repo thuis. - Ze hebben reviewers. - Er is een mogelijkheid tot rollback. - De [override-doctrine](https://lenvanderhof.com/nl/begrippen/override-doctrine/) is een vastgelegd bestand, geen vage herinnering in Slack. Wanneer een tool iets kan versturen, geld kan uitgeven of data kan verwijderen, staan er bij de eerste tien aanroepen een menselijke naam naast. Daarna vormt de log de review. Zonder log is er geen tool. ## Waar dit in past [The Agentic Codebase](https://lenvanderhof.com/boeken/the-agentic-codebase/) is het boek. De [introductie](https://lenvanderhof.com/nl/blog/de-agentische-codebase-introductie/) is het lanceerartikel. Deze pagina beschrijft de architectuur die je installeert nadat de demo vlekkeloos werkte, maar de repo een puinhoop werd. [MCP uitgelegd voor ondernemers](https://lenvanderhof.com/nl/blog/mcp-uitgelegd-voor-ondernemers/) is het complementaire stuk voor de connectielaag. Lees dat voordat je een server koppelt die een mail naar een klant kan sturen. Als je deze week maar één ding doet: kies één specifieke map uit als je agent-OS, verplaats de rondslingerende prompts daarheen en zet een naam op de CODEOWNERS-regel. Folklore stopt bij de eerste eigenaar. ## Begrippen - [STACK](https://lenvanderhof.com/nl/begrippen/stack/) - [MCP](https://lenvanderhof.com/nl/begrippen/mcp/) - [Override-doctrine](https://lenvanderhof.com/nl/begrippen/override-doctrine/) ## Bronnen 1. [STACK framework](https://lenvanderhof.com/nl/frameworks/stack/) 2. [The Agentic Codebase](https://lenvanderhof.com/boeken/the-agentic-codebase/) 3. [MCP uitgelegd voor ondernemers](https://lenvanderhof.com/nl/blog/mcp-uitgelegd-voor-ondernemers/) ## Verwante essays Wat is een AI-agent?MCP uitgelegd voor ondernemersDe agentische codebase: introductieEen agentische workflow is geen automatiseringLLM-integratie is een operationeel ontwerpprobleem ## Verder lezen - [STACK](https://lenvanderhof.com/nl/frameworks/stack/) - [The Agentic Codebase](https://lenvanderhof.com/boeken/the-agentic-codebase/) - [MCP uitgelegd voor ondernemers](https://lenvanderhof.com/nl/blog/mcp-uitgelegd-voor-ondernemers/) Over de auteur ## [Len P. van der Hof](https://lenvanderhof.com/nl/auteurs/len-p-van-der-hof/) Ondernemer, AI-innovator en venture builder Len P. van der Hof bouwt praktische AI-systemen, digitale ventures en evidence-informed hulpmiddelen voor founders. ```json { "@context": "https://schema.org", "@graph": [ { "@type": "Person", "@id": "https://lenvanderhof.com/#person", "name": "Len P. van der Hof", "alternateName": [ "Len van der Hof", "L.P. van der Hof", "Leendert Pieter van der Hof" ], "honorificSuffix": "MSc", "url": "https://lenvanderhof.com/", "image": [ "https://lenvanderhof.com/photos/len-portrait-1.jpg", "https://lenvanderhof.com/photos/len-portrait-2.jpg", "https://lenvanderhof.com/photos/len-portrait-3.jpg", "https://lenvanderhof.com/photos/len-portrait-4.jpg", "https://lenvanderhof.com/photos/len-speaking.jpg", "https://lenvanderhof.com/photos/len-hero.jpg" ], "jobTitle": "Ondernemer, AI-innovator en venture builder", "description": "Len P. van der Hof is een Nederlandse ondernemer en AI-innovator die ReasonKit, MindSesh en technologieventures bouwt via LPH98.ventures.", "address": { "@type": "PostalAddress", "addressLocality": "Zwijndrecht", "addressCountry": "NL" }, "alumniOf": { "@type": "CollegeOrUniversity", "name": "Rotterdam School of Management, Erasmus University" }, "knowsAbout": [ "Artificial intelligence", "AI agents", "Agentic AI systems", "SEO", "Generative engine optimization", "Answer engine optimization", "Venture building", "Founder performance", "Founder psychology", "Evidence-based decision-making" ], "sameAs": [ "https://www.linkedin.com/in/lenvanderhof/", "https://x.com/LenvanderHof", "https://www.youtube.com/channel/UCTG20buKqYYbitqqf7l3zJA", "https://www.instagram.com/Lenvanderhof/", "https://www.threads.com/@lenvanderhof", "https://github.com/Lenvanderhof", "https://www.goodreads.com/author/show/70983905.Len_P_van_der_Hof", "https://www.amazon.com/stores/author/B0H8B1SCLQ", "https://www.bol.com/nl/nl/b/len-p-van-der-hof-msc/609879394/", "https://bsky.app/profile/lenvanderhof.com", "https://mastodon.social/@Lenvanderhof", "https://crates.io/users/Lenvanderhof", "https://cursor.com/@Lenvanderhof", "https://medium.com/@Lenvanderhof", "https://gitlab.com/Lenvanderhof", "https://hub.docker.com/u/lenvanderhof/", "https://dev.to/lenvanderhof", "https://www.facebook.com/Lenvanderhof", "https://soundcloud.com/Lenvanderhof" ], "affiliation": [ { "@id": "https://lenvanderhof.com/#publisher" }, { "@id": "https://lenvanderhof.com/#mindsesh" } ] }, { "@type": "WebSite", "@id": "https://lenvanderhof.com/#website", "url": "https://lenvanderhof.com/", "name": "Len P. van der Hof", "description": "Len P. van der Hof is een Nederlandse ondernemer en AI-innovator die ReasonKit, MindSesh en technologieventures bouwt via LPH98.ventures.", "inLanguage": [ "en", "nl" ], "publisher": { "@id": "https://lenvanderhof.com/#person" } }, { "@type": "Organization", "@id": "https://lenvanderhof.com/#publisher", "name": "LPH98.ventures", "url": "https://lph98.ventures", "founder": { "@id": "https://lenvanderhof.com/#person" } }, { "@type": "Organization", "@id": "https://lenvanderhof.com/#mindsesh", "name": "MindSesh", "url": "https://mindsesh.net", "founder": { "@id": "https://lenvanderhof.com/#person" } }, { "@type": "SoftwareApplication", "@id": "https://lenvanderhof.com/#reasonkit", "name": "ReasonKit", "url": "https://reasonkit.sh", "creator": { "@id": "https://lenvanderhof.com/#person" } }, { "@type": "ImageObject", "@id": "https://lenvanderhof.com/nl/blog/stack-versioneer-het-agent-os/#primaryimage", "url": "https://lenvanderhof.com/media/generated/blog-hero-stack-os-nl-v2.2e85cab10797.wide.webp", "contentUrl": "https://lenvanderhof.com/media/generated/blog-hero-stack-os-nl-v2.2e85cab10797.wide.webp", "representativeOfPage": true }, { "@type": "BreadcrumbList", "@id": "https://lenvanderhof.com/nl/blog/stack-versioneer-het-agent-os/#breadcrumb", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://lenvanderhof.com/nl/" }, { "@type": "ListItem", "position": 2, "name": "Blog", "item": "https://lenvanderhof.com/nl/blog/" }, { "@type": "ListItem", "position": 3, "name": "AI-systemen", "item": "https://lenvanderhof.com/nl/blog/categorie/ai-systemen/" }, { "@type": "ListItem", "position": 4, "name": "STACK: versioneer het agent-OS zoals je de app versioneert", "item": "https://lenvanderhof.com/nl/blog/stack-versioneer-het-agent-os/" } ] }, { "@type": "WebPage", "@id": "https://lenvanderhof.com/nl/blog/stack-versioneer-het-agent-os/#webpage", "url": "https://lenvanderhof.com/nl/blog/stack-versioneer-het-agent-os/", "name": "STACK: versioneer het agent-OS zoals je de app versioneert", "description": "Wanneer agents goed demonstreren maar daarna de repo laten rotten, heb je last van agentic repo-schuld. STACK is vijf lagen: structuur, toolchain, agent-configuratie, connectie, en kennis en kwaliteit.", "isPartOf": { "@id": "https://lenvanderhof.com/#website" }, "primaryImageOfPage": { "@id": "https://lenvanderhof.com/nl/blog/stack-versioneer-het-agent-os/#primaryimage" }, "breadcrumb": { "@id": "https://lenvanderhof.com/nl/blog/stack-versioneer-het-agent-os/#breadcrumb" }, "inLanguage": "nl-NL" }, { "@type": "BlogPosting", "@id": "https://lenvanderhof.com/nl/blog/stack-versioneer-het-agent-os/#article", "mainEntityOfPage": { "@id": "https://lenvanderhof.com/nl/blog/stack-versioneer-het-agent-os/#webpage" }, "headline": "STACK: versioneer het agent-OS zoals je de app versioneert", "description": "Wanneer agents goed demonstreren maar daarna de repo laten rotten, heb je last van agentic repo-schuld. STACK is vijf lagen: structuur, toolchain, agent-configuratie, connectie, en kennis en kwaliteit.", "datePublished": "2026-08-22T23:05:00.000Z", "author": { "@id": "https://lenvanderhof.com/#person" }, "publisher": { "@id": "https://lenvanderhof.com/#person" }, "image": [ "https://lenvanderhof.com/media/generated/blog-hero-stack-os-nl-v2.2e85cab10797.square.webp", "https://lenvanderhof.com/media/generated/blog-hero-stack-os-nl-v2.2e85cab10797.landscape.webp", "https://lenvanderhof.com/media/generated/blog-hero-stack-os-nl-v2.2e85cab10797.wide.webp" ], "articleSection": "AI-systemen", "inLanguage": "nl-NL" } ] } ```