drift-check

Solid

Pre-PR advisory check for deviations from the project spec. Read-only analysis.

AI & Automation 416 stars 49 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 90/100

Stars 20%
87
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Drift Check Pre-PR deviation check against the project spec. Run this before `/create-pr` to verify alignment between implementation and documentation. > **Reference:** See `~/.claude/docs/prd-workflow/spec-driven-development.md` §2–§4 for the deviation threshold, workflow, and checkpoint cadence that this skill operationalizes. ## Your task Perform a lightweight, advisory review of the current branch's changes against the project's spec and living documents. This is a read-only check — do not modify any files. ### Step 1: Identify scope - Run `git log main..HEAD --oneline` to see all commits on this branch - Run `git diff main...HEAD --stat` to see all files changed - Determine which feature area this work relates to (from branch name, commit messages, or changed files) ### Step 2: Identify the relevant spec - Check for `docs/prd/ROADMAP.md` — if it exists, identify which phase or item this work relates to - Check for `docs/prd/` files that cover the feature area - Check for living documents (domain model, integration guides, runbooks) that describe the current state of the affected models or features - If no spec exists for this work (e.g., a bug fix or chore with no PRD entry), note that and skip to Step 4 ### Step 3: Scan for deviation signals Review `git diff main...HEAD` for changes that cross the deviation threshold: **Flag if present:** - New or removed database migrations (new models, columns, associations) - Changes to model validations or lifecycle (s...

Details

Author
joshukraine
Repository
joshukraine/dotfiles
Created
11 years ago
Last Updated
yesterday
Language
Shell
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

Testing & QA Listed

prd-implementation-precheck

Use this skill at Step 1 (PRD pre-check) and Step 2 (TDD alignment) of the v2 12-step SOP to find blockers and warnings in PRD / TDD before any implementation work begins. Produces a structured gap list pointing to missing scope boundaries, undefined acceptance criteria, unresolved cross-team dependencies, vague metrics, and stage breakdown gaps. Chinese trigger examples: "PRD 预检", "PRD 检查", "TDD 对齐检查", "需求文档审查", "PRD 缺口扫描", "Step 1", "Step 2". Do NOT use to write the PRD itself (use `prd` Skill), do NOT use as substitute for compliance precheck (Step 0 is separate). Success = zero blockers, zero warnings, stage breakdown present, every acceptance criterion has a measurable test hook, every dependency has a named owner.

72 Updated today
charliehzm
Data & Documents Listed

check

Read-only drift detector. Diffs SPEC.md vs current code ∧ reports violations grouped by severity. ⊥ writes — suggests remedies via spec ∨ build skills, ⊥ invokes them. Triggers when user asks to check drift, audit spec, verify invariants, ∨ ask if code still matches spec. Phrasings: "check drift", "audit the spec", "does the code still match §V", "check invariants", "spec vs code", "is the spec still accurate?", "did the code drift?".

4 Updated 2 days ago
kborovik
AI & Automation Listed

doncheli-drift

Detect and reconcile divergence between specs and implementation. Activate when user mentions "drift", "sync", "spec divergence", "out of sync", "spec doesn't match", "implementation differs".

53 Updated 2 weeks ago
doncheli
AI & Automation Listed

agentic-sdd-drift-retro

Detect spec drift, prepare release notes, and write retrospectives after SDD implementation or review.

5 Updated today
nawodyaishan
Code & Development Listed

lgtm-docs-drift-review

lgtm documentation drift review skill. Use when implementation or validation may affect README, AGENTS.md, PLAN.md, phase-linked project docs, API docs, operational docs, or other repo-local documentation.

4 Updated today
yarlson