The promise-to-proof loop

A product review that compares claims in marketing, documentation, demos, and AI answers with current evidence, then fixes or nar…

Felix Haeberle (@felixhaberle) 2.2k updated 1mo ago
Claude CodeGeneric
View source ↗

A product review that compares claims in marketing, documentation, demos, and AI answers with current evidence, then fixes or narrows unsupported promises.

Use when

Use this when what a product says it does may no longer match what it actually does across marketing, documentation, demos, support answers, or the live product.

The loop

List every customer-facing promise [product] makes in marketing, documentation, demos, and AI answers. Compare each promise with current product behavior and evidence, then label it proven, partly proven, misleading, unsupported, outdated, or missing evidence. Fix or narrow the riskiest mismatch and rerun the affected check. Repeat until no high-risk unsupported promise remains. Ask before changing production or public copy. Return the promises, evidence, fixes, and decisions needed.

Steps

  • List the promises customers can see and rewrite each one as a concrete expectation, such as a feature working, a limit being honored, or an answer being accurate.
  • Compare each expectation with current product behavior, code, tests, documentation, examples, logs, or other direct evidence; do not guess.
  • Rank mismatches by the harm they could do to customer trust, then fix the riskiest one or narrow the public promise to what the product can prove.
  • Rerun the same check and repeat until no high-risk unsupported promise remains, progress is blocked, or the next action needs approval.

Verification

Every high-risk customer promise is supported, narrowed, or waiting on an explicit decision. Each promise links to current evidence, and every high-risk mismatch is fixed, narrowed to what the product can prove, or clearly approval-gated.

Why it works

This turns a vague question—can customers trust what we say?—into a list of promises that can each be checked. Fixing one risky mismatch at a time keeps the product and its public explanation aligned without turning the audit into an uncontrolled rewrite.

Maintain The promise-to-proof loop?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

The promise-to-proof loop on getagentictools
[![The promise-to-proof loop on getagentictools](https://getagentictools.com/badge/loops/promise-to-proof-loop.svg)](https://getagentictools.com/loops/promise-to-proof-loop?ref=badge)