Engineering · spec

Answer-first search: functional spec

All pages
in reviewsearchplatformai2,380 words

Answer-first search: functional spec

How retrieval, permissions and the answer surface fit together, including the failure modes we accept.

TV Owner · Tobias VanceUpdated 8h agoReview date · 90 days from last edit

Shape of the feature

Search returns a drafted answer above the results, never instead of them. Each sentence of the answer carries the page it came from, and the answer is suppressed entirely when confidence is low or when the top sources disagree.

  • Permission filtering happens before retrieval, not after generation.
  • Answers cite between one and four sources; more than four means the question is too broad.
  • Stale sources (>90 days, no owner) are labelled, not hidden.

Accepted failure modes

We would rather show nothing than a confident wrong answer. When retrieval returns conflicting decisions, we surface the conflict and the two owners instead of picking a winner.