Skip to content
This page is also available as markdown at /docs/knowledge-health/find-issues/understand-a-finding.md. For the complete documentation index, see llms.txt.
Get started

Understand a finding

Open a finding to see what Knowledge Health found, the evidence behind it, and what to change.

Click a finding in the list to open its details.

An open contradiction finding next to the findings list, showing the cited docs, the conflicting claims, and Assign to Falcon
PartWhat it shows
CategoryContradiction, Stale doc, Coverage gap, Redundancy, or Code drift. See Categories.
SeverityCritical, Moderate, or Low.
EvidenceQuotes from each source. A contradiction shows both claims side by side.
Why it mattersThe effect on the people and agents who read the doc.
Suggested actionWhat to change to resolve it.
SourcesLinks to the cited docs, code files, and pull requests.
OwnerThe person responsible for the finding. It defaults to the doc owner.

Each quote links to its source, so you can check it before you act.

StatusWhat it means
OpenNot yet resolved or ignored.
Falcon is workingFalcon agent is drafting a fix.
Fix under reviewFalcon agent’s draft is waiting for someone to accept it.
ResolvedThe problem is fixed.
IgnoredSomeone marked the finding as not a real problem. Later scans don’t file it again.

To change a finding’s status, see Fix and triage findings.

If a resolved problem comes back, the next scan files a new finding instead of reopening the old one. Resolved and ignored findings are archived 30 days after their status changes.