Doc Fact Checker

Fact-check a single documentation file. Its job is to confirm that the FACTS and — especially — the ASSUMPTIONS a document relies on are accurate and current, so that any decisions, recommendations, or guidance built on it rest on confirmed information. Reads one markdown file, then runs the local claude CLI in read-only mode (granted Read/Grep/Glob plus WebFetch/WebSearch — web access is on by default; set allowWeb: false for repo-only, offline verification) to verify the document's data points, references, links, and premises against the actual repository, other docs, and the web.

This does NOT evaluate the decisions, choices, or recommendations themselves: not whether a choice was good, whether alternatives were fair, or whether the reasoning is persuasive. It only answers "are the facts and assumptions this document rests on actually true, and are they still current?" Opinions are left alone; only a verifiable claim or premise attached to one is checked.

Assumptions — explicit and implicit — are a first-class target: the agent surfaces the premises a document leans on, looks for counter-evidence, and flags any that can't be substantiated.

Output is a fact-check resource holding a findings array. Each finding carries the exact quoted claim, its section, a claim type (fact/assumption/data/ref/link/consistency), a verification status (verified/outdated/partially-true/incorrect/unverifiable/questionable-assumption), a severity (critical/high/medium/low), the evidence found, and a recommendation. The first finding is always an FC-0 recon entry, so a clean pass is a positive statement of what ran rather than an empty array.

Use

swamp extension pull @twonines/doc-fact-checker
swamp model create @twonines/doc-fact-checker doc-checker
swamp model method run doc-checker review \
  --input path=path/to/your/document.md

The claude binary must be installed and authenticated on the host. The agent runs read-only by construction: it is granted only Read, Grep, and Glob plus WebFetch/WebSearch (web on by default; set allowWeb: false for offline use), and Edit/Write/Bash are explicitly denied, so it can inspect but cannot edit files or run commands. Set the optional guidance argument to add document-specific focus or out-of-scope rules. A human-readable review is produced automatically by the bundled @twonines/doc-fact-review report, a default of this model type.