Leanpub Header

Skip to main content

From Certainty to Calibration

This book is 100% completeLast updated on 2026-07-01

A software architect returns to grade his own seven-volume series, chapter by chapter, on the record. Six decisions re-examined, each fix costed before it's proposed — not a defense, not an apology, but an audit turned on the author himself.

Minimum price

$29.99

$39.99

You pay

Author earns

$

Also available for 2 book credits with a Reader Membership

PDF
About

About

About the Book

Full Book Description (Markdown, for the LeanPub landing page)

Most technical books perform certainty. This one interrogates it.

From Certainty to Calibration is the retrospective closing volume of the NEXUS-1 Companion Series — a return trip through six architectural decisions from the first seven volumes, each one re-examined against a single question: was this actually right, and if not, what would replace it?

Every chapter runs the same disciplined structure:

  • Then — the original decision, stated faithfully
  • The Mechanism, in Detail — the actual code or schema behind it, walked through before any verdict is offered
  • Why This Seemed Sufficient at the Time — a fair reading of the original constraints, before any critique
  • Learned — what changed the picture, labeled explicitly: did the original volume already name this limit (confirmed), or is this genuinely new (extended)?
  • Now — a specific, implementable fix, not a vague direction
  • What the Fix Itself Risks — the same scrutiny turned back on the book's own proposal

Six chapters, in full:

  1. The Sacrifice of Scale for Readability — a reinforcement-learning Q-table's readability-versus-scale trade-off, and a hybrid design that keeps the audited core intact while adding room to grow.
  2. The Sequential Bottleneck — a root-cause engine's fail-closed pipeline, and the hidden difference between "nothing caused this" and "the cause exists but was never mapped."
  3. The Discipline of the LLM — ten anti-hallucination controls around a language model, and why the obvious fix for their one known gap would quietly break two of the ten.
  4. The Naïve RAG Corpus — a retrieval corpus's governance disciplines, and the case for enforcing them as database constraints instead of team discipline.
  5. The Illusion of Independent Witnesses — a telemetry corroboration check's independence assumption, and a table in the schema that looks like the fix but isn't.
  6. The SQL That (Almost) Worked — a preview-feature dependency in a vector search query, and an argument against the obvious two-database fix.

A five-lesson survival guide distills the findings into a short, source-agnostic checklist for anyone building audit-heavy or safety-adjacent systems — each lesson closes with a worked example from outside NEXUS-1 entirely (payments, fraud detection, content moderation, medical triage, demand forecasting), as a check that it actually generalizes rather than just restating its source chapter.

The book closes with an honest tally of its own six chapters — how many findings were confirmed, how many were genuinely new, and an admission that most landed somewhere in between — because a retrospective that only ever finds fault in the original design, and never in its own proposals, hasn't actually kept its own rule.

Who this is for: senior software architects, .NET and SQL Server practitioners, and engineers building systems where an audit trail matters. Familiarity with the earlier NEXUS-1 volumes helps but isn't required — Part 0 gives enough context to follow the argument without it.

What this book is not: a defense, an apology, or a claim that the original series was wrong. Every original decision examined here is judged to have been correct under the constraints it was made with. What's new is only ever the second half of the sentence: correct, and here is what it costs now that the constraints have shifted.

Author: Grigorios Kyriakos Agathangelidis
Greek name: Γρηγόριος Κυριάκος Αγαθαγγελίδης
Also searchable as: Αγαθαγγελίδης ΓρηγόριοςΑγαθαγγελιδης ΓρηγοριοςGrigorios Agathangelidis.

Share this book

Author

About the Author

Grigorios Agathangelidis

My name is Grigorios Agathangelidis, and my professional background is in Electrical Engineering and Software Engineering. I am not a nuclear physicist, nuclear engineer, or nuclear power-plant specialist. The NEXUS-1 series is not the result of formal nuclear-industry experience; it is the product of extensive independent study, research, and a passion for understanding complex engineering systems — and this volume is what happens when that same habit of study gets turned back on the work itself.

Seven volumes is a lot of software to write with a straight face. Each one had to sound sure of itself — a Q-table shaped one way and not another, a pipeline ordered one way and not another — because that is what a teaching volume needs from its author. But sounding sure of something and having checked it are not the same discipline, and after seven volumes I owed the series a book that checked.

From Certainty to Calibration is that book. It is not a sequel in the usual sense — it adds no new screens to the console and no new chapters to the plant. It goes back through six of the bigger decisions in the earlier volumes and asks the question a first-pass teaching book rarely has room to ask: was this actually right, and if not, what would I build instead, and what would that cost? I have tried to hold this volume to the same standard I asked of the first seven — state what is known, state what is assumed, and say plainly where one stops and the other begins. Nothing here claims a mistake that was not, in the author's own honest reading, a real one, and nothing proposes a fix without naming what the fix itself would cost.

My broader interest has always extended past nuclear technology itself to the harder problem underneath it: understanding, modeling, and reasoning about complex systems — digital twins, root-cause analysis, verification and validation, retrieval-augmented generation, explainable AI, and decision-support systems for industrial environments. This retrospective sits at the same intersection, applied for once to a system I built rather than one I was studying.

I don't think a retrospective is worth much if it only ever finds fault in the original work. This one tries just as hard to find fault in its own proposed fixes, because a system that knows its limits — including this book, about its own limits — is worth more than one that only ever claims to have found the answer.

If you've read the earlier NEXUS-1 volumes, I hope this one earns the trust the others asked you to extend. If you haven't, I hope it stands on its own — and, honestly, I hope it sends you back to find out what it's a retrospective of.

Author: Grigorios Kyriakos Agathangelidis
Greek name: Γρηγόριος Κυριάκος Αγαθαγγελίδης
Also searchable as: Αγαθαγγελίδης ΓρηγόριοςΑγαθαγγελιδης ΓρηγοριοςGrigorios Agathangelidis.

Contents

Table of Contents

  • Front Matter
    • Standing Boundary & Copyright Note
    • Preface — Retrospective, Not Apology
    • How to Read This Book
  • Part 0 — The Map of the Retrospective
  • Part I — The Big Architectural Bets
    • 1. The Sacrifice of Scale for Readability
    • 2. The Sequential Bottleneck
    • 3. The Discipline of the LLM
  • Part II — The Devil's Details
    • 4. The Naïve RAG Corpus
    • 5. The Illusion of Independent Witnesses
    • 6. The SQL That (Almost) Worked
  • Part III — Survival Guide for the Next Architect
  • Part IV — Epilogue: The Value of Imperfection
  • References
  • Glossary
  • Index

Get the free sample chapters

Click the buttons to get the free sample in PDF or EPUB, or read the sample online here

The Leanpub 60 Day 100% Happiness Guarantee

Within 60 days of purchase you can get a 100% refund on any Leanpub purchase, in two clicks.

See full terms...

Earn $8 on a $10 Purchase, and $16 on a $20 Purchase

We pay 80% royalties on purchases of $7.99 or more, and 80% royalties minus a 50 cent flat fee on purchases between $0.99 and $7.98. You earn $8 on a $10 sale, and $16 on a $20 sale. So, if we sell 5000 non-refunded copies of your book for $20, you'll earn $80,000.

(Yes, some authors have already earned much more than that on Leanpub.)

In fact, authors have earned over $15 million writing, publishing and selling on Leanpub.

Learn more about writing on Leanpub

Free Updates. DRM Free.

If you buy a Leanpub book, you get free updates for as long as the author updates the book! Many authors use Leanpub to publish their books in-progress, while they are writing them. All readers get free updates, regardless of when they bought the book or how much they paid (including free).

Most Leanpub books are available in PDF (for computers) and EPUB (for phones, tablets and Kindle). The formats that a book includes are shown at the top right corner of this page.

Finally, Leanpub books don't have any DRM copy-protection nonsense, so you can easily read them on any supported device.

Learn more about Leanpub's ebook formats and where to read them

Write and Publish on Leanpub

You can use Leanpub to easily write, publish and sell in-progress and completed ebooks and online courses!

Leanpub is a powerful platform for serious authors, combining a simple, elegant writing and publishing workflow with a store focused on selling in-progress ebooks.

Leanpub is a magical typewriter for authors: just write in plain text, and to publish your ebook, just click a button. (Or, if you are producing your ebook your own way, you can even upload your own PDF and/or EPUB files and then publish with one click!) It really is that easy.

Learn more about writing on Leanpub