Resolving conflicting Knowledge, end to end
A contradiction parks the newer source in review and leaves the incumbent answering. Clearing it means reading both recorded claims, deciding whether they are genuinely incompatible, and changing one of the documents — activation is refused while the conflict stands, so there is no route that acknowledges the problem without fixing it.
The stages#
- Trigger — a source with fact, instruction or playbook authority is added, re-indexed, or promoted to one of those levels.
- User event — a person supplies the document or changes the level on one already stored.
- Authentication and workspace resolution — the comparison happens inside one workspace; approved material from anywhere else is not visible to it.
- Ingest — the extracted text of the new side is prepared, up to the first 16,000 characters.
- Canonical record — the existing side is assembled from what the workspace has already approved: enabled typed entries in authority-carrying categories, and active sources marked
verified_factorowner_instruction. - Reasoning — a contradiction detector reads both sides as quoted, untrusted data and returns only direct factual contradictions and materially incompatible instructions.
- Knowledge, memory and rules — up to twenty findings are stored on the source, each with the new claim, the existing claim, a severity and a reason.
- Autonomy and approval — the source moves to
needs_reviewand answers nothing. Activation is refused while a conflict stands; unlike a scanner warning, it cannot be approved away. - Action — a person edits, qualifies or retires one of the two documents, then re-indexes the source.
- Result — the check runs again on the new text. With nothing found, the source becomes
activeand joins retrieval; the incumbent has been answering throughout. - Relationship and memory — nothing is written to memory. The reasoning belongs in the review note on the source, where the next person will look.
- Audit and usage — the detection, every status change, the review with its reviewer and note, and any authority reassessment are all logged; the check itself is metered against the workspace's AI budget.
Reading the finding before acting on it#
| Severity | Typical situation | Usual action |
|---|---|---|
high | Two statements that cannot both be true of the same current policy — a warranty of two years and one of three | Decide which is current; retire or correct the other |
medium | Instructions that pull in different directions, or a scan that could not run | Read both; often a qualifying clause resolves it |
low | A brush rather than a collision — related claims stated at different levels of detail | Frequently a false positive; confirm and clear by rewording |
Roughly half of what is flagged turns out to be two true statements about different cases: a standard lead time beside an expedited one, a list price beside a contracted rate. The fix there is not to choose a winner but to make the distinction explicit in the text of one of them, because a distinction the documents do not state is one an answer cannot make either.
The four resolutions, and when each fits#
Qualify. Add the condition that separates the two claims — a region, a product line, a customer tier, a date range.
Result Re-index. Both documents survive, and answers can now pick the right one because the words that distinguish them are present.
Correct. One document is simply wrong or out of date; edit it.
Result Re-index whichever side you changed. If it was a typed entry, the edit takes effect at once.
Retire. The old document is superseded in full — disable the entry, or delete the source.
Result The claim it made disappears with it, and the conflict clears on the next check.
Demote. The new document is genuinely useful background but was never meant to carry fact authority; set it to
reference.Result The contradiction check does not run at that level, and the material is available as context without being able to prove anything. This is the honest answer for a supplier brochure or a draft.
Questions#
The two claims are about different products. Is that a bug?
It is the checker being conservative, and it is cheap to clear: name the product in the text of one of them and re-index. That wording also improves retrieval, because a question about one product will now match the passage about that product rather than both.
Can I activate the source and resolve the conflict afterwards?
No. Activation is refused while a conflict stands, and the refusal says so explicitly. The order is deliberate — a source that answers first and is corrected later has already sent the wrong answer to somebody.
What if the conflicting claim is in a typed entry rather than a document?
Same resolutions, easier execution. A typed entry can be edited or disabled in seconds, and disabling is the reversible option when you are not yet certain which of the two is current.