Skip to content
runward
runward
Product
Who it is for
Trust
Documentation
News
Try it on an example Talk to us

Docs · Reference

Designing and running agentic systems

The target architecture: the decision framework, from language to evaluation, so they hold up in production.

Read the PDF versionThibault Souris

runward is the tooling of this doctrine: it gives the why. Here it is in full: fifteen sections, a decision matrix, an appendix of evidence in code.

Architecture first, model second.

Start simple, isolate behind contracts, add complexity only on evidence.

Author's note

For two years, generative AI was experienced as a rupture: we marveled that a machine could write, summarize, code. That time has passed. The question is no longer whether the technology impresses, but how to integrate it for good into processes, professions, and organizations. And there, the verdict is harsh: nearly every application calls itself "agentic," and almost none truly holds up in production. The vast majority of pilot projects fail to make that leap, and always for the same reasons: we do not know how to evaluate nondeterministic behavior, we do not know how to govern it, we cannot say in advance when it will be wrong. These are not model problems. They are architecture problems.

"Adopting AI," moreover, covers two realities that are too often confused. Giving teams generative assistants for writing or analysis is a matter of acculturation: useful, but relatively simple and with little structural risk. Integrating agentic systems into processes, existing or yet to be invented, is something else entirely: it means rethinking flows, trust, governance, reliability. It is this second adoption, the harder one, that is at stake here; and the confusion between the two explains a good share of the disillusionment.

The sign that the stakes have shifted from the model to integration lies in a decision the largest model providers have just made: rather than ship one more model, they are building deployment organizations and sending engineers to embed with their customers. When those who build the models conclude that the bottleneck is no longer the model but its integration into the real world, the case is closed: the value plays out around the model, not inside it.

Too many teams, however, still choose a framework before they have thought through their architecture, and pay for that choice for months. The conviction behind these pages is the exact opposite: it is not the model that dictates the architecture, it is the architecture that frames the model. The model is rented and replaced; the architecture is owned and compounds. Once that reversal is accepted, the rest (language, topology, memory, evaluation, security) ceases to be an initial bet and becomes a sequence of reversible decisions, made behind stable contracts.

These pages are addressed to anyone who designs, runs, or defends such systems, and wants to do so on foundations that last.

Thibault Souris · 2026

Contents

PART I · Scope · Decoupling · Language · Decomposition

The foundations

The bedrock: why the architecture frames the model, and how decoupling makes language and topology reversible.

  1. 01Framing, how to read, and the guiding principle
  2. 02The decoupling that makes language and topology secondary
  3. 03Language choice, full TypeScript or polyglot
  4. 04Modular monolith or microservices

PART II · Topology · Memory · Execution

The execution of an agentic system

How the system runs: runtime topology, memory and context engineering, state, concurrency, and asynchronous work.

  1. 05Runtime topology of an agentic system
  2. 06Memory and context engineering
  3. 07State, concurrency, and scaling
  4. 08Asynchronous work and scheduling

PART III · Resilience · Observability · Security · Evaluation

Robustness, security, and evaluation

Holding up over time: runtime resilience, observability, cost control, security, and behavioral evaluation of agents.

  1. 09Execution resilience
  2. 10Observability and cost control
  3. 11Execution security
  4. 12Agent evaluation and testing

PART IV · Matrix · Synthesis · Shared blocks · Evidence

Decision and synthesis

Deciding: the summary decision matrix, the synthesis of recommendations, the extension to shared building blocks, and evidence in code.

  1. 13Summary decision matrix
  2. 14Synthesis and recommendations
  3. 15Beyond the application, the shared building blocks
  1. ·Evidence in code
  2. ·Afterword

Back cover

Architecture first, model second.

Nearly every application calls itself agentic; almost none holds up in production. The gap is not a model problem, it is an architecture problem.

These pages lay out the decision framework that makes the difference: where to draw the boundaries, how to make language and topology reversible, how to keep state explicit, govern memory, secure untrusted inputs, and evaluate nondeterministic behavior. From the first port laid down on day zero to the loop that watches for drift, each section turns an initial bet into a reversible decision, made behind stable contracts. The model remains what it must be: a component you replace, down to its paradigm, while the architecture compounds.

For anyone who designs, runs, or defends such systems, and wants to do so on foundations that last.

← Docs

Talk to us

Tell us who you are, and we will get back to you.

Your details are recorded by Another Framework, publisher of runward, to get back to you. They are neither sold nor shared, and are deleted three years after our last exchange. To see or delete them: contact@runward.dev.