code-review-rules-drift

Audit rule guidance for drift against the current codebase.

5|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/ably/ably-ai-transport-js --skill code-review-rules-drift
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-review-rules-drift
Source: https://github.com/ably/ably-ai-transport-js/tree/main/.claude/skills/code-review-rules-drift
Command: npx skills add https://github.com/ably/ably-ai-transport-js --skill code-review-rules-drift

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill checks whether rule guidance still matches the code after a change, helping teams catch stale conventions, outdated examples, and missing guidance before they cause confusion.

Core Features & Use Cases

  • Audits rule files and related guidance for drift against the current implementation.
  • Flags renamed symbols, removed behavior, outdated examples, and new conventions that should be documented.
  • Produces a conformance-style report that points back to the affected rule and the code change.
  • Useful after refactors, feature removals, API changes, and updates to team conventions.

Quick Start

Ask the skill to review the latest change for rules drift and report any stale or missing guidance in the rule files and CLAUDE.md.

Frequently Asked Questions about code-review-rules-drift

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if my code review rules are outdated after a refactor?

To check if code review rules are outdated after a refactor, audit your rule guidance for drift against the current codebase. This process flags renamed symbols, removed behavior, and outdated examples in your .claude/rules and CLAUDE.md files.

Why does my CLAUDE.md documentation reference symbols that no longer exist?

Your CLAUDE.md documentation references non-existent symbols because rule guidance has drifted from the current codebase after recent changes. Auditing rule files against the implementation catches these stale conventions and flags missing guidance for new behaviors.

When do I need to audit rule files for documentation drift?

You need to audit rule files for documentation drift after refactors, feature removals, API changes, and updates to team conventions. This ensures your .claude/rules and CLAUDE.md files capture new conventions and avoid referencing removed behavior.

Can I automatically detect missing conventions in CLAUDE.md after code changes?

You can detect missing conventions in CLAUDE.md by running a read-only review of affected files after code changes. This produces a conformance-style report pointing back to affected rules, highlighting new conventions that should be documented.

What is the best way to keep coding conventions aligned with the codebase?

The best way to keep coding conventions aligned with the codebase is auditing rule guidance for drift against the current implementation. This approach generates principle-level recommendations that avoid fragile implementation details while catching stale examples.

How do I review the latest code change for rules drift in .claude/rules?

To review the latest code change for rules drift in .claude/rules, request a read-only review of the affected files. This generates severity-based findings that identify stale or missing guidance caused by recent symbol renames or behavior changes.