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.