check-project-drift

Detect documentation and implementation drift across repository files.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/jmagar/rust-bin --skill check-project-drift
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: check-project-drift
Source: https://github.com/jmagar/rust-bin/tree/main/.claude/skills/check-project-drift
Command: npx skills add https://github.com/jmagar/rust-bin --skill check-project-drift

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Drift between documentation and code undermines trust, slows onboarding, and increases maintenance risk. This skill centralizes checks that surface inconsistencies across knowledge maps, spec.md vs xtask parity, exec-plan lifecycles, stale active plans, and ADR coverage, enabling teams to act with context.

Core Features & Use Cases

  • Knowledge-map integrity checks across repository files to verify alignment.
  • Spec.md vs xtask parity checks to ensure implemented commands and plans exist and reflect current docs.
  • ADR coverage checks to identify missing or outdated architectural decisions.
  • Use Case: A team runs drift checks before a major release to surface gaps and drive alignment.

Quick Start

Run the drift checks against the repository and review the resulting report.

Frequently Asked Questions about check-project-drift

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

FAQPage Schema
How do I detect drift between documentation and code in my repository?

You can detect documentation drift by running deterministic checks across your repository that compare knowledge maps, spec.md versus xtask parity, exec-plan lifecycles, and ADR coverage. The skill produces a structured report surfacing inconsistencies without requiring code changes.

What is spec.md versus xtask parity checking in a codebase?

Spec.md versus xtask parity checking verifies that implemented commands and execution plans documented in spec.md actually exist and reflect the current codebase. It surfaces inconsistencies between documented specifications and actual implementation behavior.

Can I check ADR coverage and stale active plans during code reviews?

Yes, ADR coverage and stale active plan checks are designed to surface inconsistencies during development and code reviews. Running these deterministic checks before major releases helps identify missing or outdated architectural decision records.

What is the best way to verify knowledge-map integrity across repository files?

The best way to verify knowledge-map integrity is running automated drift checks that scan repository files for alignment. This centralizes consistency verification and produces a structured report highlighting gaps and misalignments.

Does drift reporting require any code changes to the repository?

Drift reporting requires no code changes to the repository. It enforces deterministic checks against existing files and outputs a structured report identifying inconsistencies, enabling teams to act with context.