The Agentic Codebase: The Five-Layer Architecture That Makes Agent Work Survive Production

By Len P. van der Hof MSc

The demo worked. Six months later, no one could reproduce it.

Your best prompt is buried in chat history. The rules disagree. Tool connections live in one engineer's personal configuration. A new model arrives, and nobody can tell whether the system improved or quietly broke.

If that sounds familiar, the problem is not another weak prompt. It is agentic repo debt.

The Agentic Codebase is a practical architecture book for technical founders, senior engineers, and AI platform leaders who need agent work to become repeatable, governable, and maintainable.

The central idea: your repository is not merely where an agent's output lands. It is the operating system the agent works inside.

The book introduces STACK, a five-layer framework for designing that operating system: Structure: make the codebase navigable, bounded, and legible.Toolchain: standardize the shells, CLIs, runners, and environments that perform the work.Agent configuration: turn scattered prompts into versioned rules, skills, roles, and workflows.Connection layer: govern MCP servers, hooks, plugins, credentials, and tool contracts.Knowledge and quality: manage memory, context, evals, observability, cost, and safety.
Follow NexumOS, a fictional but realistic startup repository, from a brilliant but fragile prototype to a system a team can inspect and maintain. Along the way, you will work with repo-debt scorecards, STACK audits, instruction files, skill packages, role charters, context tiers, tool contracts, plugin reviews, evals, CI gates, and a disciplined route from vibe coding to maintained software.

This is not another prompt collection. It is not a vendor manual, and it does not promise autonomous software without judgment. It gives you the durable engineering patterns beneath fast-changing tools, plus implementation examples you can adapt and test against your own environment.

Stop building agent demos that depend on memory. Build the repository that remembers.

• Format: Paperback
• Language: English
• ISBN: B0H96NPJ1B
• ISBN13: 9798187627509
• Release Date: July 2026
• Publisher: Independently Published
• Length: 484 Pages
• Weight: 1.41 lbs.
• Dimensions: 1.0" x 6.0" x 9.0"