Detecting Doc Drift

Overview

A doc is a set of claims about the repo; drift is a claim the repo no longer backs. This skill declares the shape of drift detection so it runs the same way every time and can be invoked programmatically to trigger updates — not a one-off prose review.

Two non-negotiables make the output usable by automation:

1. A verdict requires evidence. Never mark a claim VERIFIED because doc and code "seem consistent." Verified means you ran the command, opened the line, or matched the grep.
2. The result is structured, not prose. Answer in the verdicts shape below. A human summary on top is fine; the artifact is what the engine reads and downstream tooling parses.