# How Knowledge Health works

> For the complete documentation index, see [llms.txt](https://falconer.com/docs/llms.txt).

Find contradictions, gaps, and stale pages across your docs, code, and connected tools, and fix them with Falcon.


Find contradictions, gaps, and stale pages across your docs, code, and connected sources.

![The Knowledge Health page with the run banner, the open findings chart, and counts for each category](/docs/images/kh-page-2x-2.png)

## How it works

Knowledge Health scans your connected sources, compares them with each other and with your code, and finds existing issues.

Start a scan with **Run now**, or put scans on a schedule. You can assign any finding to Falconer, which drafts the proposed fix for you to review. You can also fix issues with your preferred coding agent through the Falconer MCP.

## Prerequisites

- At least one connected source.
- Credits in your balance, or your organization’s own model provider key.

**Run now** and **Schedule** appear on the Knowledge Health page when your organization uses credits or its own model provider key.

## Categories

| Category | What it means |
| --- | --- |
| **Contradiction** | Two sources make claims that can’t both be true. |
| **Stale doc** | A doc describes knowledge that has since changed. |
| **Coverage gap** | A topic comes up in Slack, meetings, code, or tickets, but no doc covers it. |
| **Redundancy** | The same knowledge is documented in more than one place. |
| **Code drift** | A doc no longer matches what the code does. |

## How a scan works

1. Knowledge Health checks the findings it already filed, so it doesn’t report the same problem twice.
2. It compares your sources with each other and with your code, and checks recent pull requests.
3. It files findings as it goes. The scan keeps running if you leave the page.

```mermaid
flowchart LR
  review["Review existing findings"]
  subgraph checks["Check in parallel"]
    cross["Across sources"]
    code["Against code and PRs"]
    stale["Stale content"]
    gaps["Coverage gaps"]
  end
  filed["File findings with evidence"]
  review --> cross & code & stale & gaps
  cross & code & stale & gaps --> filed
```

## See more

- **Set up:** [run your first scan](https://falconer.com/docs/knowledge-health/set-up/run-your-first-scan.md), [connect sources](https://falconer.com/docs/knowledge-health/set-up/connect-sources.md), and [schedule scans](https://falconer.com/docs/knowledge-health/set-up/schedule-scans.md).
- **Find issues:** [read the Knowledge Health page](https://falconer.com/docs/knowledge-health/find-issues/read-the-page.md), [understand a finding](https://falconer.com/docs/knowledge-health/find-issues/understand-a-finding.md), and [fix and triage findings](https://falconer.com/docs/knowledge-health/find-issues/fix-and-triage-findings.md).
- **Manage:** [Knowledge Health credits](https://falconer.com/docs/knowledge-health/manage/credits.md), [notifications](https://falconer.com/docs/knowledge-health/manage/notifications), and [troubleshooting](https://falconer.com/docs/knowledge-health/manage/troubleshooting.md).

## FAQ

**What data does Knowledge Health read?**

Only the sources you connect. You choose which repositories, folders, documents, and Slack channels Falconer can read.

**Does a scan change my docs or code?**

No. A scan only reads. When you assign a finding to Falcon, it drafts the change, and nothing changes until you accept it.

**Is my data used to train AI models?**

No. Falconer doesn’t train on customer data.

**Which security certifications does Falconer have?**

Falconer is SOC 2 Type II certified, and data is encrypted in transit and at rest. HIPAA compliance, single-tenant, and self-hosted deployments are available. See [trust.falconer.com](https://trust.falconer.com).