{
  "ok": true,
  "data": {
    "entry": {
      "id": "schema-first-output",
      "kind": "tip",
      "kindLabel": "Tip",
      "title": "Design the output schema before the prompt",
      "body": "When the output has fields, types, allowed values, and failure states, the prompt stops being a prose wish and becomes an interface contract. The model has less room to improvise because the answer has a shape to satisfy.",
      "tag": "reliability",
      "date": "2026 · 06 · 24",
      "publishedAt": "2026-06-24",
      "note": null,
      "insight": {
        "aha": "A schema turns a vague prompt into an interface contract with explicit absence states.",
        "tryThis": "Write the JSON fields, allowed values, evidence pointers, and unknown states before drafting the prompt.",
        "watchFor": [
          "Required fields that force the model to invent missing data",
          "Enums that do not include blocked, unknown, or partial",
          "Fields whose consumer or decision impact is unclear"
        ]
      },
      "extended": [
        "A schema makes ambiguity visible. If you cannot name the field, type, and allowed absence state, you probably do not know what you are asking the model to produce.",
        "Start with the downstream consumer. Does it need a label, a span, a confidence bucket, a source pointer, or an abstention? Write that contract first and then prompt the model to fill it.",
        "The aha is that schemas are not just for machines. They force human reviewers to decide what counts as complete, partial, unknown, and unsafe."
      ],
      "url": "https://tips.platphormnews.com/entries/schema-first-output"
    }
  }
}