drift-check

Detect documentation drift (docs out of sync with code). Use after changes, periodically, or when something feels wrong. Returns severity-rated findings with specific fixes.

📖 中文导读:Detect documentation drift (docs out of sync with code). Use after changes, periodically, or when something feels wrong. Returns severity-rated findings with specific fixes. 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: drift-check description: Detect documentation drift (docs out of sync with code). Use after changes, periodically, or when something feels wrong. Returns severity-rated findings with specific fixes. allowed-tools: Read, Glob, Grep, Bash

Drift Check

Detect documentation rot by comparing code reality against documented expectations.

When to Use

  • After completing a feature or bug fix
  • Before starting work on unfamiliar area
  • When behavior doesn't match expectations
  • Periodically (weekly recommended)

Severity Levels

Severity Areas Action Required
🔴 Critical Auth/RLS wrong, billing docs incorrect, schema mismatch Fix immediately
🟠 High Server action undocumented, invariant violated Fix this session
🟡 Medium Route missing from surfaces, stale checklist Fix soon
🟢 Low Minor description inaccuracy Track

Check Categories

  1. Server Actions vs Docs — Actions exist in code but not documented (or vice versa)
  2. Routes vs User Surfaces — Routes exist but not in feature doc tables
  3. Schema vs Data Model — Tables/columns don't match docs
  4. RLS vs Permissions Docs — Policies undocumented or incorrect
  5. Invariants vs Reality — Can't find code enforcing documented invariants
  6. Workflow Steps vs UI — Documented steps don't match actual UI

Quick Check Commands

# Count server actions
find app/actions -name "*.ts" | wc -l

# Count routes
find app -name "page.tsx" | wc -l

# Recent migrations (verify reflected in docs)
ls -lt supabase/migrations/ | head -5

Output

## Drift Check Report — [date]

**Scope**: [full / feature-name]

| Severity | Count |
|----------|-------|
| 🔴 Critical | [n] |
| 🟠 High | [n] |
| 🟡 Medium | [n] |
| 🟢 Low | [n] |

### Issues Found
[For each issue: category, location, finding, remediation]

### No Drift Found
[Areas checked with no issues]