← All sheets
GL-A-037Sheet 037FOR CONSTRUCTIONA · ARTIFICIAL INTELLIGENCE

Never show a number the software can't explain.

FOR CONSTRUCTION · SHOW THE REASON · AI OUTPUT · STRUCTURED RESPONSES

Drawing sheet 037: Never show a number the software can't explain.

General notes

  1. 01A model can produce a score for anything. "Lead quality: 82." The number looks like knowledge. It is a guess wearing a font.
  2. 02Ask the model for a reason field beside every value, in the same structured response. Refuse to render a value whose reason is empty.
  3. 03People forgive a wrong number with a visible reason. They do not forgive a confident number with none. Design for the second case.
RDetail · the response shapeShape, not a screen
{ "score": 82, "reason": "" }                              // does not render
{ "score": 82, "reason": "asked for a self-hosted option, 2 days ago" }  // renders

As posted

Never show a number the software can't explain.

A model can produce a score for anything. "Lead quality: 82." It looks like knowledge. It's a guess wearing a font.

Structural fix: a reason field beside every value. Refuse to render a value whose reason is empty.

Sheet 037.

Read with

  • Sheet 032 · An invented number wearing a disclaimer.