doc__guard-drift

Compare repository documentation against source artifacts to generate drift reports.

1|1|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/erikhazzard/vasir --skill doc-guard-drift
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc__guard-drift
Source: https://github.com/erikhazzard/vasir/tree/main/.agents/skills/doc__guard-drift
Command: npx skills add https://github.com/erikhazzard/vasir --skill doc-guard-drift

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects and prevents documentation drift by treating docs as testable claims and verifying them against primary source artifacts in the current repository. Compares docs to implementation, schemas, types, tests, configs, build/deploy files, and recent changes; then reports mismatches, missing coverage, and exact doc fixes. Use before releases, after refactors, during PR review, or whenever README/API docs/runbooks may have drifted from reality.

Core Features & Use Cases

  • Evidence-based drift detection between docs and code.
  • Generates concrete drift reports with file references and suggested fixes.
  • Use during PR reviews, releases, or post-refactor audits to maintain truthfulness of docs.

Quick Start

Run the audit across the repository to surface documentation drift and generate evidence-backed fixes.

Frequently Asked Questions about doc__guard-drift

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect documentation drift between my README and source code?

Detect documentation drift by comparing repository docs to primary source artifacts like code, schemas, and configs. The audit treats docs as testable claims, verifying them against implementation files to surface mismatches and generate evidence-backed drift reports with precise file references.

What is the best way to audit API docs for accuracy during a pull request review?

Audit API docs for accuracy during PR reviews by validating them against source-of-truth contracts and implementation files. The audit identifies mismatches between documented endpoints and actual code, generating concrete drift reports with suggested fixes to maintain documentation truthfulness.

How do I fix outdated runbooks and architecture notes after a code refactor?

Fix outdated runbooks and architecture notes after refactoring by running a documentation audit across the repository. The audit compares docs to recent changes, deployment files, and tests, then reports mismatches with exact file references and recommended corrections to snap docs back to reality.

Can I verify documentation claims against schemas, tests, and deployment configs?

Verify documentation claims against schemas, tests, and deployment configs by running an audit that treats docs as testable assertions. The audit checks README, API docs, and runbooks against these primary source artifacts to surface mismatches and missing coverage with evidence-backed reports.

When should I run a documentation drift audit in my release process?

Run a documentation drift audit before releases, during PR reviews, or after refactors to catch mismatches between docs and implementation. The audit validates docs against current repository artifacts, ensuring documentation accuracy and preventing outdated information from reaching users.

What does a documentation drift report include?

A documentation drift report includes evidence-backed mismatches with precise file references and recommended fixes. The audit compares docs to code, schemas, tests, and configs, generating concrete corrections that snap documentation back to reality with source-of-truth validation.