validate-facts

Renamed: validate-facts was validate-resume-truth before v1.0.0 (see RIT-A-0005).

Inputs must be canonical JSON. This capability consumes a resume as a ResumeDocument JSON (build it from a PDF/DOCX/MD/text file with the parse-resume skill) and, where a job is involved, a JobDescription JSON (build it with parse-job so skills-coverage scoring works). Run those conversions in subagents, then pass the saved JSON paths here — they live under resume-kit/resumes/ and resume-kit/jobs/.

Prerequisites

Run the shared Prerequisites gate first — see _shared/prerequisites.md.

• Required inputs: a ResumeDocument JSON (config.json active_resume or an explicit path) and a list of CandidateEvidence records.
• If missing: STOP and name the upstream skill — no resume JSON → run parse-resume; no evidence → run extract-evidence.

Purpose

Cross-reference a ResumeDocument against a list of CandidateEvidence records and produce a TruthReport that identifies which resume claims are supported, unsupported, or contradicted by evidence.

When to use

• Before running update-keywords or update-terminology to ensure only truthful content is present.
• After alignment to verify the aligned resume does not contain fabricated claims.
• When the user wants an evidence-backed audit of a resume.

Inputs

Field	Type	Notes
resume	ResumeDocument	The resume to validate
evidence	list[CandidateEvidence]	Evidence records (may be empty; empty list produces a report with all claims unsupported)

Options (CapabilityOptions)

Option	Default	Effect
strict	false	Escalate advisory warnings to failures

no_llm has no effect — this capability is always deterministic.

How to invoke

CLI

resume-tool validate-truth --resume <resume.json> \
    [--evidence <evidence.json>] \
    [--output {json,text,md}] [--strict]