drift-detection

Scan codebases for cumulative drift across seven indicator categories.

2|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/veegee82/loss-driven-development --skill drift-detection-veegee82
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: drift-detection
Source: https://github.com/veegee82/loss-driven-development/tree/main/skills/drift-detection
Command: npx skills add https://github.com/veegee82/loss-driven-development --skill drift-detection-veegee82

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Periodic drift detection surfaces cumulative divergences that slip through per-commit gates, helping teams keep mental models aligned with the evolving codebase.

Core Features & Use Cases

  • Periodic drift scanning to reveal patterns that accumulate over time across the codebase.
  • Seven drift indicators (identifier, contract, layer, doc-model, rubric, test/spec, defaults) paired with actionable findings.
  • Supports looping in release reviews and cadence-driven engineering, guiding method evolution and documentation hygiene.

Quick Start

Run the drift-scan script to generate a periodic drift report for your project.

Frequently Asked Questions about drift-detection

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

FAQPage Schema
What is codebase drift and how does periodic scanning detect it?

Codebase drift is cumulative divergence that slips through per-commit gates. Periodic drift scanning detects it by surfacing actionable findings across seven indicators, including identifier, contract, and layer drift, to align mental models with the evolving codebase.

How do I detect cumulative codebase drift during a release candidate review?

To detect cumulative drift during a release candidate review, run a periodic drift scan to generate a report. This report lists actionable indicators and patterns across contract, test, and defaults drift to guide method evolution and loop-driven engineering decisions.

What types of drift indicators can I scan for in my codebase?

You can scan for seven drift indicators in your codebase: identifier drift, contract drift, layer drift, doc-model drift, rubric drift, test/spec drift, and defaults drift. These indicators surface actionable patterns to guide documentation hygiene and method evolution.

Can I use periodic drift scans to improve documentation hygiene and test specs?

Yes, periodic drift scans improve documentation hygiene and test specs. The scan surfaces doc-model drift and test/spec drift indicators, producing actionable findings that guide loop-driven engineering decisions and method evolution.

Does drift detection replace per-commit code quality gates?

Drift detection does not replace per-commit code quality gates. It complements them by performing periodic scans on a weekly cadence to surface cumulative divergences and long-term patterns that slip through standard per-commit checks.