AI LAB · CASE STUDY LIVE

AI LAB · PROJECT 01

EVIDENCE-GROUNDED CUSTOMER HEALTH DIAGNOSTIC

AI interprets evidence and communicates results. It does not own diagnostic authority.

An AI-assisted diagnostic system that evaluates whether a customer is achieving the outcomes that justified the purchase, identifies conditions that support or threaten those outcomes, exposes missing or contradictory evidence, and helps Customer Success teams decide what deserves attention next.

THE PROBLEM

Every Customer Success team eventually builds, buys, or inherits a health score. Almost none of them trust it.

The pattern repeats across companies. A model outputs a number, usually red, yellow, or green, and the CSM who owns the account can't explain why it moved. The score can't say which evidence it used, whether that evidence was ever confirmed as true, or what would need to happen to change it. When the number and the CSM's own judgment disagree, the number loses, quietly, and the team goes back to spreadsheets and instinct.

That isn't a tooling failure. It's an authority failure. The system was asked to make a judgment call it had no way to justify.

The question this project set out to answer: can an AI-assisted system evaluate customer health in a way a CSM or executive would actually trust, meaning it shows its evidence, admits what it doesn't know, and never quietly overrides a human's read of the account?

RESEARCH

Before writing a line of methodology, the starting question was why existing health scores fail to earn trust, not how to build a better scoring formula. Three recurring failure patterns showed up across the approaches reviewed.

OPACITY

A single composite score compresses dozens of signals into one number. The compression is exactly what destroys trust, because the CSM can't trace the number back to a reason.

EVIDENCE BLINDNESS

Most scoring models treat every input as equally certain. A rumor from one email thread and a confirmed contract renewal get averaged together as if they carried the same weight.

FALSE CONFIDENCE

When evidence is missing or contradictory, most systems still produce a clean number rather than admitting the gap. The output looks decisive right up until it's wrong.

A health diagnostic earns trust by being auditable, not by being smart.

DESIGN DECISION

The central design decision followed directly from that hypothesis: separate the parts of the system that interpret language from the part that decides the outcome.

Large language models are genuinely good at reading messy customer evidence, emails, call notes, tickets, and pulling structured signal out of it. They are not something you want holding sole authority over a governed business conclusion, because they can be persuasive and wrong at the same time.

So the system was split into two categories of work that never blend: interpretation work, which stays AI-assisted, and authority work, which stays rules-based and deterministic. A human confirmation step sits between the two, deliberately. Nothing the AI extracts from evidence is allowed to affect the governed result until a person has confirmed it.

HOW IT WORKS

The 5-step method

Evidence moves through five stages, and only one of them is allowed to decide anything.

  1. 01

    Customer Evidence

    Notes, emails, call summaries: whatever a CSM already has on the account.

  2. 02

    AI Structured Extraction

    The evidence is parsed into structured candidates, such as stakeholder changes, service issues, and risk signals, each traceable back to the exact source text it came from.

  3. 03

    Human Confirmation

    A reviewer confirms, corrects, or rejects each candidate before it can affect anything downstream. Nothing consequential moves forward on AI say-so alone.

  4. 04

    Deterministic Rules Engine → Governed Diagnostic Result

    A fixed, published methodology, not a model and not a prompt, evaluates the confirmed evidence and produces the diagnostic result: objective outcome, risk exposure, operational priority, and an explicit account of what remains uncertain.

  5. 05

    AI Grounded Explanation + Diagnostic Questions

    The AI is invited back in, only to explain the governed result in plain language and phrase a handful of questions about what's still unresolved. It cannot introduce a fact, a risk, or a conclusion that isn't already in the governed result.

WHAT IT DOES

  • Reconstructs structured evidence from raw customer notes, with every item traceable to its source
  • Treats evidence states explicitly (confirmed, unconfirmed, contradicted) instead of averaging them together
  • Requires human confirmation before any AI-derived evidence can affect a governed conclusion
  • Evaluates customer health through a deterministic, published methodology rather than a model's internal weights
  • Surfaces risks, uncertainty, and contradictions explicitly instead of resolving them silently
  • Generates a grounded AI explanation and a short set of diagnostic questions, each traceable to a real, unresolved gap

WHAT IT REFUSES TO DO

  • No single opaque health score
  • No churn prediction
  • No renewal-probability forecasting
  • No AI-generated governed conclusion of any kind
  • No silent resolution of contradictory evidence
  • No fabricated evidence or invented gaps
  • No claim of statistical validation or production-SaaS readiness

AI AUTHORITY BOUNDARY

AI interprets evidence and communicates results. It does not own diagnostic authority.

That boundary is enforced at two separate points, not just asserted in a slide. At extraction, every AI-proposed candidate is inert until a human confirms it; the rules engine only ever reads confirmed evidence. At explanation, the AI is handed a closed package of already-governed facts and unresolved-gap references, nothing else, and its response is checked against that package before anything reaches the screen. If the explanation references anything outside that package, it doesn't get shown; the underlying diagnostic result is displayed on its own instead.

The AI can be wrong about how it phrases something, and the worst case is a plain notice that the explanation isn't available. It cannot be wrong about the diagnosis itself, because it never gets a vote on the diagnosis.

DEMO

A working prototype exists: a Streamlit application that walks a reviewer through the full flow end to end, from raw evidence to a governed result to an AI explanation. The screenshots below are from that running app. Try it yourself with the flagship scenario, or read the code directly.

RUN THE PROTOTYPE VIEW THE REPO ON GITHUB
CHDM setup screen with the sample-scenario picker
Setup screen with the sample-scenario picker, showing the entry point without any real customer data.
Evidence-review queue with unconfirmed candidates awaiting a human decision
The evidence-review queue, showing unconfirmed candidates awaiting a human decision, the confirmation gate made concrete.
Diagnostic Result panel showing operational priority, evidence review, reliability, and objective outcome
The Diagnostic Result panel: operational priority, evidence-review status, reliability, and objective outcome together, plainly labeled as rule-derived.
AI Explanation and Diagnostic Questions panel, expanded
The AI Explanation & Diagnostic Questions panel, expanded, showing the generated narrative and its ranked questions, each pointing at a real gap.

EVALUATION

The system was validated in layers, moving from synthetic to live at each stage.

WHAT THIS SYSTEM DOES NOT DO, STATED DIRECTLY

A system built on "admit what you don't know" should hold itself to the same standard.

  • This is a working prototype, not production software. There is no authentication, no persistence, no multi-tenancy, and no deployment.
  • It has not been validated against real customer accounts or a production dataset, only synthetic and hand-labeled scenarios.
  • It does not predict churn or renewal probability, and it was never designed to.
  • It makes no statistically validated claim about outcomes; the automated tests verify that the software behaves as specified, not that the methodology predicts business results.
  • It is not an autonomous Customer Success agent. It does not act on an account; it produces a diagnostic result for a human to act on.
  • The AI steps depend on a live language model and carry that technology's ordinary limitations: they can fail, and the system is designed to fail closed, showing nothing rather than something ungrounded, when they do.

WHAT I LEARNED

The technical challenge in this project turned out to be the easy part. Getting a language model to extract structured signal from messy text, or to phrase a coherent explanation, is now a solved problem in most domains that matter.

The harder problem, and the one worth carrying into any future AI system, was deciding where the AI's voice should stop and a rule, or a human, should start. It's tempting to let a capable model handle the whole judgment end to end, because it can. The discipline is in refusing that shortcut deliberately: writing down, in advance, exactly which decisions the AI is never allowed to make on its own, and then building the software so that boundary can't quietly erode as the system grows.

That isn't really an AI lesson. It's an operations lesson wearing an AI costume: authority has to be designed, not assumed, or it drifts to whichever part of the system is most persuasive rather than whichever part is most accountable.

THE THINKING BEHIND IT

Authority has to be designed, not assumed.

LET'S TALK ABOUT WHAT THIS COULD MEAN FOR YOUR TEAM