check — drift report

check

Read-only drift detector. Diffs SPEC.md against current code and reports violations grouped by severity. Writes nothing — suggests remedies via the spec or build skills but never invokes them. Triggers when the user asks to check drift, audit the spec, verify invariants, or ask whether code still matches the spec. Phrasings: "check drift", "audit the spec", "does the code still match §V", "check invariants", "spec vs code".

juliusbrussee/cavekit·2.7Kinstalls1.1Kstars

SKILL.md

Full skill instructions

check — drift report

Pure diagnostic. Reports violations. Writes nothing. User decides remedy.

Spec drifting silently from code is the #1 SDD failure mode. check is the detector. Run it after each /build and before each ship — drift caught here is a diff; drift caught in prod is a §B.

LOAD

Read SPEC.md. If missing → "no spec, nothing to check." Stop.
Parse invocation args:
- §V → check invariants only (default)
- §I → check interfaces
- §T → audit task status vs code
- --all → all three

CHECK §V — invariants

For each V<n>:

Translate invariant into verifiable claim about code.
Grep / read relevant files.
Classify: HOLD / VIOLATE / UNVERIFIABLE.
Record address + file:line evidence.

CHECK §I — interfaces

For each I item:

Locate implementation.
Classify:
- MATCH — shape in code = shape in spec.
- DRIFT — impl exists, shape differs.
- MISSING — impl absent.
- EXTRA — code exposes surface not in §I.

CHECK §T — tasks

For each T<n>:

If x: verify claimed work present.
If ~: note as in-progress.
If .: note as pending.
Flag x rows with no evidence as STALE.

REPORT

Caveman. Grouped by severity.

## §V drift
V2 VIOLATE: auth/mw.go:47 uses `<` not `≤`. see §B.1.
V5 UNVERIFIABLE: no test covers ∀ req path.

## §I drift
I.api DRIFT: POST /x returns `{result}` not `{id}`. route.go:112.
I.cmd MISSING: `foo bar` absent from cli/*.go.

## §T drift
T3 STALE: status `x`, no middleware file exists.

## summary
2 violate. 1 missing. 1 stale. 1 unverifiable.
next: spec skill with `bug:` or fix code at cited lines.

REMEDY HINTS (not actions)

End report with one-line hint per class:

VIOLATE / DRIFT → invoke spec skill bug: <V.n> or fix code.
MISSING → invoke build skill on §T.n if task exists; else spec skill amend §T.
STALE → spec skill amend §T to uncheck.
EXTRA → spec skill amend §I to document, or delete code.

Never invoke fixes. Report only.

NON-GOALS

Zero writes. No SPEC.md edits. No code edits.
No sub-agents. Main thread reads.
No scores, no grades. Binary per item: holds or drifts.

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/juliusbrussee/cavekit --skill check

View on GitHub

check

caveman
Ultra-compressed communication mode cutting token usage ~75% while preserving technical accuracy.
559K installs
caveman-commit
Terse, conventional commit messages that prioritize reasoning over description.
392.8K installs
caveman-review
Ultra-compressed code review comments: location, problem, fix on one line each.
388.8K installs
caveman-compress
Compress natural language memory files into caveman-speak to reduce input tokens.
387.7K installs

More skills from juliusbrussee

juliusbrussee/caveman

caveman-help

Quick-reference card for caveman modes, skills, and commands with one-shot display.

109.9K 379.4K

View

juliusbrussee/caveman

cavecrew

Delegate code tasks to compressed subagents that shrink context by ~60% per delegation.

109.9K 335.7K

View

juliusbrussee/caveman

caveman-stats

Real token usage and estimated savings metrics from your Claude Code session log.

109.9K 334.9K

View

juliusbrussee/caveman

compress

Compress natural language memory files into caveman-speak to reduce input tokens.

109.9K 46.9K

View

juliusbrussee/skills

caveman

Ultra-compressed communication mode. Cuts token usage ~75% by speaking like caveman while keeping full technical accuracy. Supports intensity levels: lite, full (default), ultra, wenyan-lite, wenyan-full, wenyan-ultra. Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", or invokes /caveman. Also auto-triggers when token efficiency is requested.

160 3.5K

View

juliusbrussee/cavekit

caveman

1.1K 2.8K

View

juliusbrussee/cavekit

build

1.1K 2.7K

View

juliusbrussee/cavekit

spec

1.1K 2.7K

View

juliusbrussee/cavekit

backprop

1.1K 2.6K

View

juliusbrussee/skills

grill-me

Calibrated grilling session for stress-testing a plan, design, idea, or decision. First assesses the user's topic knowledge, confidence, and desired pressure level, then asks one question at a time with recommended answers. Use when user says "grill me", "stress-test this", "challenge my plan", "interview me", or wants a plan probed without being overwhelmed.

160 2.6K

View

juliusbrussee/skills

junior-to-senior

Adversarial senior-engineer review for agent-generated plans, designs, and architectures. Treats the current output as junior work, constructs a senior reviewer whose domain expertise comes from live codebase research plus web research of current best practices, diagnoses altitude failures (too vague or too granular), then rewrites the plan into a scoped, state-of-the-art version. Use when the user says "junior to senior", "senior review", "review this like a staff engineer", when a plan feels hand-wavy or lost in details, or before committing to any agent-written plan.

160 2.5K

View

juliusbrussee/skills

interface-kit

Authoritative guide for implementing stunning, accessible, performant UI. Synthesizes design engineering philosophy, accessibility standards, animation principles, spatial design, typography, color systems, and component craft into a single actionable reference. Complements the design-system skill (which covers DESIGN.md spec writing) by covering the HOW of implementation. Trigger phrases: "build UI", "create component", "landing page", "make it look good", "frontend", "design", "polish UI", "implement design", "make it beautiful", "UI implementation", "component styling", "animation", "accessibility"

160 2.1K

View