Adr Fact Checker

Fact-check a single Architecture Decision Record (ADR). Reads one ADR 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 FACTS the ADR states — its data points, references, links, and the assumptions it relies on — against the actual repository and the other docs.

This does NOT evaluate the decision itself: not whether the choice was good, whether alternatives were fair, or whether the rationale is persuasive. It only answers "are the things this ADR asserts as true actually true, and are they still current?" Opinions are left alone; only verifiable claims attached to them are checked.

Output is a fact-check resource holding a findings array. Each finding carries the exact quoted claim, its ADR 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 ADR-FC-0 recon entry, so a clean pass is a positive statement of what ran rather than an empty array.

Use

swamp extension source add ./swamp-extensions/adr-fact-checker
swamp model create @twonines/adr-fact-checker adr-checker
swamp model method run adr-checker review \
  --input path=content/app_svcs_teams/explanation/ADRs/ADR-002-standard-language-golang.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. A human-readable review is produced automatically by the bundled @twonines/adr-fact-review report, a default of this model type.