fact-check

Fact Check

Verify the factual accuracy of a document against the actual codebase and git history. Extracts verifiable claims, checks each against source, corrects inaccuracies in place, and adds a verification summary.

This is not a re-review. It does not second-guess analysis, opinions, or design judgments. It does not change the document's structure or organization. It is a fact-checker — it verifies that the data presented matches reality, corrects what doesn't, and leaves everything else alone.

Instructions

Format Detection

--format controls which verification-summary block to inject:

Flag	Values	Default	Meaning
--format	html | md	auto	Auto-detected from the input file extension (.html → html block, .md → markdown block). Override when the input is a generic text file or when you want a markdown summary inside an HTML document

Principle: Fact-check edits the source document in place. The format flag only governs the verification summary appended at the end — HTML summary uses KPI cards + <details> blocks, markdown summary uses a table + bullet lists. Auto-detection is almost always correct; override only for edge cases.

Target File Detection

Determine what to verify from $1:

1. Explicit path: Verify that specific file (.html, .md, or any text document)
   • Resolve relative paths against cwd
2. No argument: Auto-detect the most recent report of either format:

   ls -t ${CLAUDE_PLUGIN_DATA}/reports/*.html ${CLAUDE_PLUGIN_DATA}/reports/*.md 2>/dev/null | head -1
   

   If no reports found, inform the user and stop.

Document type detection — auto-detect from page content to adjust verification strategy:

Document Type	Detection	Verification Focus
diff-visual report	Contains "Diff Visual" in title/heading	Verify against the git ref the review was based on
doc-visual report	Contains "Doc Visual" in title/heading	Verify file references, names, architecture claims
plugin-visual report	Contains plugin analysis markers	Verify plugin structure, file paths, feature descriptions
Markdown document	.md extension	Verify file references, function/type names, behavior descriptions
Other	Fallback	Extract and verify whatever factual claims about code it contains