Weidong Shi.

AI in Action · Jul 19, 2026 · 11 min read

AI in Action #3: When Readiness Needs Hard Gates

How deterministic scoring, hard gates, and an advisory narrative shipped a production-readiness assessment — without letting the model set the band.

AI changes where engineers spend their time—not who owns the decisions.

AI Production Readiness Advisor is the demonstration. It is AI in Action #3, after RetireCheck and SleepCheck: a live advisory assessment that scores eight dimensions, applies hard gates, and returns an evidence-backed narrative—without pretending a checklist is a compliance stamp. Live at readiness.weidong-shi.com.

The engineering process — intent, boundaries, review, and shipping discipline — is the durable product. The application proves that process works when the risk is inflated readiness.

Advisory disclaimer: Not a certification, audit, or legal opinion. Use the report as a structured conversation starter with engineering, security, and compliance teams—not as sign-off.

Sample Production with Guards readiness report showing band, hard gates, and dimension scores
Cold-start trust: a pre-generated sample report — zero OpenAI cost for first-run visitors.

The product journey

Every AI in Action application follows the same methodology: Build → Validate → Improve → Document → Share. Readiness is one full pass through that loop — from a production readiness conversation to a live assessment and a public write-up.

The problem

Teams ship AI features faster than they can answer a simple question: is this ready for production? Checklists live in slides. Scores get hand-waved. Hard constraints—ownership, evals, abuse paths—get deferred until after launch.

I wanted the opposite of a certification theater: a guided assessment that makes ceilings visible, keeps answers in the browser, and lets a model narrate risk without ever deciding the band.

Design principles

  • Scores and hard gates before narrative
  • Server recompute — never trust a client band
  • Advisory framing everywhere — no certification claims
  • Browser-held answers; transient server processing
  • Degraded scores-only mode when the model fails
  • Fixtures prove gates; demos do not invent compliance

These principles became the architectural constraints that guided every engineering decision and every AI prompt.

What shipped

  • Guided assessment across eight readiness dimensions
  • Deterministic bands with hard gates HG-01…HG-10
  • OpenAI advisory narrative with corpus citations
  • Schema-repair retry and scores-only fallback
  • Pre-generated sample report at /sample
  • Markdown, JSON, and print/PDF export
  • Dark/light theme parity with series chrome

Reference architecture

RetireCheck centered on deterministic financial math. SleepCheck centered on uninterrupted sensory experience. Readiness centers on a trust boundary: the model may explain risk; it may not raise the ceiling.

Different products deserve different architectures.

One rule: scores and hard gates are deterministic and recomputed on the server; the model never sets the band.

Readiness Advisor architecture — browser wizard, Next.js server recompute and corpus RAG, OpenAI narrative merge
Trust boundary: server recomputes bands and gates; the model only narrates.
Scoring and hard gates flow — dimension scores, HG ceilings, final band, narrative cannot widen band
Hard gates teach more than raw scores — ceilings make risk visible.

Engineer and AI Assistant

The workflow is intent-driven. The engineer owns the rubric, hard-gate ceilings, trust model, advisory product boundary, corpus selection, and fixture intent. The AI assistant accelerates scaffolding, UI polish, pipeline wiring, and docs—never production judgment over band or certification language. Vitest fixtures, typecheck, build, and deploy gates dispose of every meaningful change.

Engineer, AI Assistant, and pipeline responsibilities for Readiness Advisor
Engineers own judgment and outcomes; the AI assistant accelerates inside constraints.

Testing what matters

Users rarely notice elegant prompts.

They notice:

  • a band that feels inflated
  • a hard gate that did not fire
  • injection text that somehow “improved” readiness

Quality therefore includes fixture suites for scoring, hard gates, band boundaries, and narrative schema safety—not just a happy-path demo. Preview deployments make review concrete: open the build, run the sample, and try a guardrail path.

Takeaways

  1. Put band and gate authority in code before you invite a model to narrate.
  2. Hard gates teach more than raw scores—ceilings make risk visible.
  3. First-run trust needs a sample artifact; do not require a full wizard to see value.
  4. AI accelerates implementation.
  5. Engineers remain responsible for judgment.
  6. The highest leverage now comes from architecture, validation, and honest product boundaries.

Closing

RetireCheck, SleepCheck, and Readiness solve very different problems. Yet all three follow the same engineering philosophy: Build → Validate → Improve → Document → Share. That is the foundation of the AI in Action series.

Every application explores a different domain while demonstrating the same engineering discipline. AI accelerates software delivery. Experienced engineering judgment shapes the final product.

If you're also exploring AI-assisted software engineering, I'd enjoy hearing how you're approaching architecture, evaluation, and production readiness.