DocSutra AIDocumentation Truth Audit - v0.2.1 - by Vatsal Shah

Executive summary

What DocSutra AI is, the problem it solves, what you get, and what it deliberately does not claim.

The problem

Documentation rots silently. Files move, headings are renamed, flags are removed, and nobody notices until a reader hits a 404 or copies a command that no longer exists. Manual review does not scale, and most link checkers ignore anchors, case-sensitivity, accessibility and leaked secrets.

The product

DocSutra AI is a command-line auditor for Markdown documentation. One command scans a repository and produces an audit report as Markdown, HTML, JSON and SARIF.

Who it is for

AudienceValue
Open-source maintainersCatch broken links and stale anchors before contributors do
Technical writersA readable HTML report with line-level evidence and fixes
CI / release engineersGate pull requests on newly introduced documentation errors
Security reviewersFind leaked tokens and risky install snippets before publishing
AI-assisted teamsGive coding assistants a deterministic scanner plus guardrailed skills

Evidence at a glance

72tests passed
0tests failed
3skipped (OS privilege)
100%benchmark precision
100%benchmark recall
18rules

Generated 2026-11-16T17:55:30.611Z on Node v24.15.0, win32/x64.

All numbers come from real runs (npm run build:evidence). See Testing and evidence for method and limits.

What it does not claim

Decision summary

QuestionAnswer
LicenseApache-2.0, zero runtime dependencies
RuntimeNode.js 20 or newer
CostFree; no external services
Data leaves machine?No
MaturityVersion 0.x, active; see roadmap
CreatorVatsal Shah