Open Source ยท Built on GitHub Actions ยท Powered by Gemini

Wrong docs are more dangerous than no docs

Doc-Sentinel AI hooks into your CI/CD pipeline and flags drift between your code and your documentation on every pull request โ€” before anything ships.

โ˜… Star on GitHub See how it works โ†’
github.com / your-repo / pull / 12 โ€” Doc-Sentinel AI Audit
๐Ÿ›ก๏ธ

Doc-Sentinel Audit Result

AI-Readability Score: 70%
Drift Detected: YES โ€” Action Required
File audited: getting-started.md
1. Drift Audit

The code diff introduces changes to the start_ai_audit function signature โ€” adding optional mode and version parameters โ€” that are not reflected in the existing documentation.

Suggested Fix
start_ai_audit(api_key, mode='strict', version=2)
2. Style Audit

The documentation score of 70% indicates room for improvement in agent-friendliness. Recommend defining parameters with explicit type annotations and adding an examples section for AI retrieval accuracy.

40%
of your entire tech estate is debt โ€” and a lot of it is documentation that stopped being true months ago
30min
engineers spend figuring out something that should take one minute when docs are wrong or missing
0
teams with a dedicated safety net for documentation drift โ€” until now
Features

Everything your docs need.
Nothing your team has to do.

Doc-Sentinel runs silently in the background on every pull request, so documentation debt never compounds unnoticed.

๐Ÿ”
Drift Detection
Compares every code change against your documentation using Gemini 2.0 Flash. Catches logic shifts that regex-based linters miss entirely.
๐Ÿ“Š
AI-Readability Scoring
Scores your docs for agent-friendliness โ€” catching vague pronouns, broken heading hierarchy, and missing code block metadata that break RAG pipelines.
๐Ÿ’ฌ
PR Comments
Posts findings directly on the pull request with a severity label, one-sentence explanation, and a corrected Markdown snippet ready to paste in.
โšก
Zero-Friction Setup
Runs natively in GitHub Actions. Add one workflow file and two secrets. No new tools, no new dashboards, no new workflows.
๐Ÿ”—
Doc Detective Integration
When Doc Detective test failures are detected, Doc-Sentinel automatically wakes up, audits the affected file, and posts findings on the issue.
๐Ÿ›ก๏ธ
Style Guide Enforcement
Audits against a custom AI-Readability Style Guide covering context persistence, semantic hierarchy, paragraph density, and visual-to-text bridging.

From code change to
audit result in seconds.

01

A pull request is opened

A developer pushes code or opens a PR. Doc-Sentinel wakes up automatically via GitHub Actions โ€” no manual trigger needed.

02

The agent captures the diff

Doc-Sentinel fetches the latest git diff and the corresponding documentation from your repository via the GitHub API.

03

Gemini runs the two-part audit

The Drift Audit checks whether code changes are reflected in the docs. The Intelligence Audit scores the documentation for AI-readability against the Style Guide.

04

Findings are posted on the PR

A bot comment appears on the pull request with a severity label, a plain-English explanation of what drifted, and a corrected Markdown snippet ready to paste in.

Ecosystem

Part of a complete
documentation quality loop.

Doc-Sentinel pairs with Doc Detective to give you both drift detection and functional validation โ€” the full picture.

๐Ÿ•ต๏ธ Doc Detective
โ†’
โš ๏ธ Test failure
โ†’
๐Ÿ›ก๏ธ Doc-Sentinel audit
โ†’
โœ… Issue resolved

Built in collaboration with @hawkeyexl from Doc Detective.

The debt doesn't have
to keep compounding.

Add Doc-Sentinel to your GitHub Actions pipeline in under five minutes. Free and open source, forever.

โ˜… Star on GitHub