Architecture

Retrieval is context. Operational proof is a different claim.

Retrieval can supply the information needed to perform a task. Establishing the present state of a business record or the outcome of a write takes evidence with the right authority and freshness. A useful evidence model names each claim and the observation that supports it.

Relevance and confirmation answer different questions

A search result can answer, “Where is the policy for supplier invoices?” A source-record query can answer, “Which supplier belongs to this identifier in this company?” A post-write read can answer, “Does the draft now contain the intended values?” All three may be necessary, but they are not interchangeable.

The distinction is about the claim and evidence path, not whether a component is labeled retrieval. A retrieval system may access an authoritative source directly. Conversely, a database query may read a stale replica or the wrong tenant. The label alone establishes neither authority nor freshness.

A perfectly retrieved document can be insufficient

Imagine a search returns yesterday’s purchase-order export with the exact line items referenced by an invoice. The excerpt is relevant, accurately quoted, and internally consistent. This morning the order was amended. The old export cannot establish the current quantity available to bill.

A citation helps identify the evidence used; it does not upgrade the evidence’s freshness. The workflow needs an explicit policy for which source and version can authorize the action. If only the old export is available, the limitation belongs in the result.

Define authority per claim

The system of record is authoritative for a particular business representation, such as a saved bill or recorded goods receipt. That does not make every field an unquestionable statement about the physical world. A recorded receipt can be the required business evidence without proving that every delivered item was undamaged.

A contract should therefore name both the source and the proposition it supports. “Receipt record exists and quantity meets the policy” is inspectable. “The delivery is correct” may overstate what the available source can establish.

Confirming a write requires a new observation

The context used to construct a bill cannot prove that the later write succeeded. Confirmation needs evidence from the operation itself or an authoritative observation of its effect. An assistant repeating the intended values is not that observation.

Read-back design also needs to account for consistency and identity. The integration should retrieve the record associated with the original operation and compare the relevant fields. Finding a similar bill by text search is weaker than confirming the exact saved record.

Use retrieval without asking it to prove too much

Retrieval remains valuable for discovering context, resolving terminology, locating policies, and assembling evidence candidates. The next step is to qualify those candidates: identify their source, version, access scope, observation time, and applicability to the contract.

This adds data-model work and sometimes an extra system query. The benefit is a receipt that explains the chain from source to check to effect. The result can remain useful even when it is incomplete, because the operator can see exactly which claim lacks sufficient evidence.

Missing a detail or found a problem?

Send a documentation question →

Apply the reasoning to a real workflow.

Talk through its inputs, decision boundaries, and definition of completion with the team.

Explore the evidence model

Search Outcomatic

Search products, documentation, articles, and help.

Open full search pageEsc to close

Analytics preferences

Optional analytics help us understand which pages and journeys are useful. They are off by default.

When enabled, we count page views and selected actions by page and day. We do not store visitor identifiers, search terms, form contents, or cookies in analytics. Your browser’s Do Not Track or Global Privacy Control signal takes priority.

Allow anonymous aggregate analytics?

Read the website privacy notice