doc-drift-auditworkflow★3,780
Atmosphere/atmosphere ↗What it does
Audit documentation for semantic drift classes
Best for
Catching documentation claims that grep/structural validators miss (citations, superlatives, stale enumerations, business facts, capability contradictions).
Inputs
- · documentation file paths (from both repos)
- · scope parameter: main/site/all
Outputs
- · inventory of doc groups by area
- · findings array with file, line, claim, drift_class, evidence, suggested_fix
- · verdict report: confirmed drift + gateable classes
Preconditions
- · access to both atmosphere main repo and atmosphere.github.io site repo
- · git available for file listing
Failure modes
- · missed semantic drift due to ambiguous claim interpretation
- · false positives on stale/historical claims that are actually correct
- · inability to find site repo if not at standard locations
Trust signals
- · explicit phases: Inventory, Audit, Verify, Synthesize
- · VERDICT_SCHEMA with confirmed boolean + corrected_truth field
- · adversarial verification step (refute findings before confirming)