CLAUDE.md Maintenance and Drift Repair
Keep CLAUDE.md accurate with verified commands, scoped conventions, and minimal updates that remove stale project guidance.
Before & after
Same prompt, same agent — the only difference is the skill.
I can help you document your project standards. It's important to keep track of conventions like naming styles and API changes. Would you like me to create a documentation file? I'd suggest outlining your main conventions, dependencies, and recent changes. Let me know what specific standards you want to capture and I can help you organize them in a clear format.
CLAUDE.MD UPDATE API CONFIGURATION -> base URL changed to https://api-prod.example.com/v2 -> authentication via Bearer token in Authorization header -> response format: JSON, ISO 8601 timestamps DATABASE CONVENTIONS -> field naming: snake_case (user_id, created_at, is_active) -> no Hungarian notation or camelCase in schema -> timestamps always UTC DEPENDENCY UPDATE -> Prisma upgraded to v5.8, schema client regenerates on prisma generate -> React Query v5 requires new query key factory pattern -> deprecation: lodash removed, use native Array methods instead ARCHITECTURE DECISION -> API routes moved from pages/ to app/api/ (Next.js 13+) -> middleware now handles auth at route level, not per-handler -> no breaking changes to existing endpoints Persistent across all future sessions.
About this skill
Your CLAUDE.md still says to run the old test command, and every session rediscovers the same exceptions. This skill checks project guidance against the actual repository, repairs stale instructions, and captures durable decisions without turning the file into a session transcript.
What it does
- Checks documented commands against package scripts, configuration, and CI definitions.
- Separates team rules from patterns that merely happen to appear in the code.
- Updates conventions at the correct project or directory scope.
- Removes superseded guidance while preserving exceptions that still apply.
- Turns repeated corrections into concise, actionable project instructions.
- Reviews the final changes for contradictions, duplication, sensitive data, and unsupported claims.
What you get
A focused CLAUDE.md edit or proposed patch, with a short explanation of what changed and the evidence behind it. For a full audit, you also get unresolved conflicts and specific verification steps.
Best for
Developers maintaining established repositories, teams migrating tools or conventions, and anyone whose Claude sessions keep repeating mistakes despite an existing CLAUDE.md file.
SKILL.md preview
---
name: claude-md-maintenance-and-drift-repair
description: Maintain project CLAUDE.md guidance by checking commands and conventions against repository evidence, repairing drift, and preserving only durable, correctly scoped instructions. Use when the user says "update CLAUDE.md", "Claude keeps using the old test runner", "stop making me explain our conventions", "audit our project instructions", "remember this rule for this project", "our memory file is stale", or "create CLAUDE.md for this repo".
---
# CLAUDE.md Maintenance and Drift Repair
… (sign up to view the full skill)More development skills
View all Development skills →CodeTour Walkthrough File Builder
Writes a valid CodeTour .tour file for your repo: persona-targeted steps anchored to verified file paths and line numbers.
Code-Accurate Docs: Docstrings, JSDoc, OpenAPI Specs
Docstrings, JSDoc/TSDoc, OpenAPI specs, and quickstart guides written from your real code, covering error paths and edge cases.
Markdown to Single-File HTML (Docs, Reviews, Slides)
Turns markdown into one offline-safe HTML file laid out as a document, diff review, or slide deck, with a fidelity report.
Release Changelog from Commits and PRs
Turns a commit range or merged PRs into a release changelog with breaking changes, migration steps, and user-facing wording.