Pidoku

PoC to Production

Advanced 50 min Difficulty 3/5 Lesson 03 of 06

Prerequisites Evaluation as the Contract

The idea in one minute#

A proof of concept (PoC) shows that something can work once, on chosen examples, for a friendly audience. Production means it works every day, on whatever arrives, for people who did not ask for it, inside the organisation’s security, cost and support rules. The distance between the two is where most enterprise AI projects end.

They rarely end because the model was not good enough. They end because the PoC was built to impress rather than to learn, had no success criterion, used data that production cannot reach, and left security, operations and the users themselves for later.

The cure is to treat delivery as four stages with a gate between each — prototype, pilot, limited release, full release — and to design the gates before the first line of code. Each stage exists to remove one kind of risk. A stage that removes no risk is a demo.

A picture#

flowchart LR
  P0[":i-flask-conical: <b>Prototype</b><br/><small>2–4 weeks · can it work at all?</small>"] -->|"gate: feasible on real samples"| P1[":i-users: <b>Pilot</b><br/><small>8–12 weeks · real users, real data</small>"]
  P1 -->|"gate: eval + business metric + adoption"| P2[":i-split: <b>Limited release</b><br/><small>10–50% of traffic</small>"]
  P2 -->|"gate: holds at scale, cost as modelled"| P3[":i-check: <b>Full release</b><br/><small>operated, monitored, owned</small>"]
  P0 -.->|"fails"| K[":i-archive: <b>Stop, with findings</b><br/><small>a cheap, useful outcome</small>"]
  P1 -.->|"fails"| K
  SEC[":i-shield-check: <b>Security, legal, operations</b><br/><small>engaged from the prototype</small>"] -.-> P0
  SEC -.-> P1
  SEC -.-> P2
  class P0 neutral
  class P1 compute
  class P2 queue
  class P3 io
  class K memory
  class SEC warn

How it really works#

Why pilots stall#

The same causes appear in every study and every post-mortem. Each has a design-time fix.

CauseWhat it looks likeFix, before the pilot starts
No success criterion“The pilot went well” — nobody can say if it should scaleA gate with numbers, signed by the sponsor
Demo dataWorked on twenty clean PDFs; production has scans and email chainsPrototype on a random sample of real inputs
No path to the dataThe pilot used an export; nobody approved live accessData access agreed with its owner in the prototype stage
Security arrives lastA six-week review begins the week before launchSecurity and legal in the first design review
Nobody owns it afterwardsThe project team disbands; no on-call, no budgetNamed product owner and run budget in the business case
Users were not involvedThe tool does not fit how the work is doneCo-design with the people who will use it
Does not learnThe same mistake on day ninety as on day oneA feedback loop from corrections into the evaluation set and prompts
Cost surpriseFine at 50 users, alarming at 5,000Unit cost measured in the pilot and projected to full volume
Too ambitious a first stepAn autonomous agent as project oneStart at a low autonomy level; earn the next

The MIT Project NANDA study put the point sharply: the organisations that got value treated adoption as a workflow and learning problem, while those that stalled treated it as a technology purchase.

The four stages#

StageThe risk it removesWho uses itWhat must exist by the end
PrototypeFeasibility — can the pattern do the task on our real data?The teamResults on 50+ real samples; measured token cost; a list of what failed
PilotValue and fit — does it help real users, and do they use it?10–30 real usersEvaluation gate passed; business metric moved; adoption and feedback data; security review complete
Limited releaseScale and operation — does it hold under load, at the modelled cost?A slice of all usersMonitoring, alerts, runbooks, on-call; cost per task at volume; rollback tested
Full releaseSustainability — can it be owned for years?Everyone in scopeProduct owner; run budget; upgrade process; scheduled reviews

Stopping after a prototype that fails its gate is a success of the process. It cost three weeks instead of nine months.

Design the gates first#

Write all three gates before the prototype begins. They come straight from the requirements page.

GATE 1 — prototype → pilot
  □ ≥ 90% field accuracy on a random sample of 50 real claims
  □ Measured token cost within 2× of the estimate
  □ Live data access agreed in writing with the document platform owner
  □ Security and privacy have reviewed the design; no blocking finding
  □ Sponsor confirms the pilot team and the baseline measurement

GATE 2 — pilot → limited release
  □ Evaluation gate passed on the full set (see the evaluation plan)
  □ Reading time per claim ≤ 6 minutes, measured, for the pilot group
  □ ≥ 70% of pilot handlers use it on ≥ 80% of their claims in the final four weeks
  □ No severity-1 incident; all high-risk review findings closed
  □ Unit cost at pilot volume ≤ $0.08 median

GATE 3 — limited release → full release
  □ Metrics hold at 40% of volume for four weeks
  □ Peak-hour load test passed against granted quota
  □ Runbooks exercised: provider outage, quality drop, rollback
  □ Product owner, run team and budget confirmed for 12 months

Each line is checkable by someone who was not in the project. That is the test of a gate.

A pilot is an experiment#

Run it like one.

  • Measure the baseline first. Reading time before the pilot, for the same people, on the same kind of claims. Without it the result is an opinion.
  • Have a comparison. A group not using the tool, or the same group before and after.
  • Fix the duration. Long enough to pass the novelty period — eight to twelve weeks. Usage in week one tells you nothing; usage in week eight tells you nearly everything.
  • Instrument adoption. Who used it, how often, where they abandoned it, what they corrected.
  • Collect the failures. Every correction and complaint is a future test case.
  • Report against the gate, including the lines that failed.

Releasing safely#

Models, prompts and retrieval indexes are released with the same care as code — and independently of it.

TechniqueWhat it isUse it for
Shadow modeThe new version runs on real traffic; its output is logged, not shownAny first launch; any model change
CanaryA small share of traffic gets the new version; metrics are comparedEvery prompt, model or index change
Feature flagSwitch the capability on per user group, and off instantlyStaged rollout; the emergency stop
RollbackReturn to the previous prompt, model and index version togetherMust be rehearsed before it is needed

Three things are versioned and released together: the prompt, the model version, and the retrieval index or tool set. A change to any one can change behaviour; the evaluation gate applies to each.

What “operated” means#

A system is in production when someone can answer these at three in the morning.

QuestionThe thing that must exist
Is it up?Health checks, uptime alerts
Is it good?A quality dashboard from sampled, graded traffic
Is it affordable?Spend by use case, with budget alerts
What happened in this request?A trace: prompt, retrieved context, tool calls, output
The provider is down — now what?Fallback route and a runbook
Quality dropped — now what?A runbook: check for model, prompt, index or input changes; roll back
Who decides to turn it off?A named owner and an off switch

The telemetry behind these answers is covered in Observability Engineering.

The part that is not technical#

Technology is the smaller half of a rollout. Budget time and money for:

  • Training — not how to click, but when to trust and when to check.
  • Process change — if handlers save twenty minutes, what does the process now expect of them?
  • Honest communication — what the tool does, what it does not, and what it means for people’s jobs. Silence is filled with the worst assumption.
  • Champions — two or three respected users who helped design it and will answer their colleagues’ questions.
  • A visible feedback route — and visible fixes. Nothing builds adoption like a complaint resolved within the week.

The architect’s role, stage by stage#

StageYou
PrototypeDefine the gates; choose the sample; keep the scope small
PilotRun the well-architected review; watch cost and quality data; update ADRs
Limited releaseReview the load test and runbooks; check cost against the model
Full releaseHand over to the product owner — in writing — and schedule the first yearly review
AfterPost-launch review at three months: did the business metric move?

Remember this#

  • A PoC proves it can work once. Production means every day, on anything, within the rules.
  • Four stages, each removing one risk: feasibility, value and fit, scale, sustainability.
  • Write all the gates before the prototype. Every line must be checkable by an outsider.
  • A pilot is an experiment: baseline, comparison, fixed duration, adoption data.
  • Involve security, data owners, operations and users from the prototype — not at launch.

Try it#

  1. Take a PoC you have seen stall. Which rows of the “why pilots stall” table applied? Which one fix would have mattered most?
  2. Write gate 1 and gate 2 for a use case of your own. Give them to a colleague and ask whether they could check each line without you.
  3. Draft the three-in-the-morning table for the same system. Which rows have no owner yet?

Check yourself#

  1. What risk does each of the four stages remove?
  2. Why is a prototype that fails its gate a good outcome?
  3. Which three things are versioned and released together in an AI system?
  4. Why must a pilot run longer than a few weeks?

Sources#

↑↓ navigate↵ openesc close

drag to pan · scroll to zoom