| name | exeris-docs-drift-pattern-sweep-review |
| description | Drift-pattern sweep review for exeris-docs. Use after any non-trivial HLA / whitepaper / large-doc edit to catch the 10 recurring drift patterns. |
Exeris Docs Drift-Pattern Sweep Review
Purpose
Confirm the 10 recurring drift patterns are absent from edited files — and that
any correction was applied to every site, not just the one the PR touched.
Single source. The 10 patterns (why each is wrong) live once in
CLAUDE.md § "Common drift patterns to watch". The greppable locators live once
in .claude/scripts/drift-sweep.sh. This skill does NOT restate them — it runs
the script and adjudicates the candidates.
When to Use
- After any non-trivial
high-level-architecture.md or b2b-technical-whitepaper.md edit.
- After any ADR edit that frames cross-tier or cross-repo structure.
- After any execution-plan amendment.
- On request as a standalone audit pass.
Required Inputs
- File(s) edited + an edit summary.
Review Procedure
- Run the locator on every edited file:
.claude/scripts/drift-sweep.sh <file>…
- Adjudicate each candidate. The script marks likely-correct negations with
⟵ (neg? verify). For each candidate decide: real drift, or a correct
negation/mention? When unsure of canonical phrasing, read the relevant
CLAUDE.md § "Common drift patterns" entry (numbered 1–10 to match the
script's #N).
- Prioritise STRUCTURAL hits (the script tags patterns 1,3,4,5,7,8) — they
propagate downstream; review them first.
- Single-edit consistency. For every confirmed drift, grep the whole doc
(not just the diff) and confirm the same correction is applied at every site.
- Verdict:
CLEAN / CORRECTIONS_REQUIRED / INVESTIGATION_REQUIRED.
Decision Logic
- CLEAN: script clean, or all candidates confirmed correct negations/mentions.
- CORRECTIONS_REQUIRED: ≥1 confirmed drift with a known canonical fix — emit a patch list.
- INVESTIGATION_REQUIRED: a candidate is ambiguous between drift and intentional framing — escalate to
exeris-docs-architect.
Review Output Template
- Scope (files swept; script exit code).
- Adjudication — per candidate: pattern
#N, line, drift | correct-negation | ambiguous.
- Single-edit consistency check (same correction applied everywhere?).
- Verdict (
CLEAN / CORRECTIONS_REQUIRED / INVESTIGATION_REQUIRED).
- Patch list (precise corrections per confirmed drift).
Non-Negotiable Rules
- Never declare CLEAN without running
drift-sweep.sh on every edited file.
- Never resolve a candidate from memory when the canonical phrasing is in reach — read the
CLAUDE.md entry.
- Never fix one site and leave another; confirmed drift is corrected at every site.
- Never silently drop an ambiguous candidate — escalate.
