claude-md-keeper

Detect drift between CLAUDE.md and project state, then generate a reviewable proposed diff.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/jorgeochipinti97/dublin-skills --skill claude-md-keeper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-md-keeper
Source: https://github.com/jorgeochipinti97/dublin-skills/tree/main/skills/meta/claude-md-keeper
Command: npx skills add https://github.com/jorgeochipinti97/dublin-skills --skill claude-md-keeper

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Drift between the declared CLAUDE.md and the observed project state, ensuring alignment by generating a reviewable proposed diff instead of auto-writing.

Core Features & Use Cases

  • Detect drift across package.json, filesystem, git log, and Dublin skills to surface mismatches.
  • Generate a CLAUDE.md.proposed diff for user review and manual application.
  • Integrate with session-bridge for durable decisions and with the orchestrator for re-planning when drift changes strategy.

Quick Start

Invoke the drift detector on your project to generate CLAUDE.md.proposed and review the diff before applying.

Frequently Asked Questions about claude-md-keeper

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

FAQPage Schema
How do I detect drift between CLAUDE.md and my project state?

You detect CLAUDE.md drift by running a drift check that compares your declared CLAUDE.md against observed project state across package.json, filesystem, git log, and skills manifest, generating a reviewable proposed diff.

What is CLAUDE.md drift detection and how does it work?

CLAUDE.md drift detection is a process that compares your declared project configuration against the observed state of package.json, git log, and the filesystem to identify mismatches and prepare a reviewable diff.

How do I generate a proposed diff for CLAUDE.md without auto-writing files?

You generate a reviewable CLAUDE.md diff by invoking the drift detector, which outputs a CLAUDE.md.proposed file containing diff blocks for manual review and application.

Does CLAUDE.md drift detection integrate with session-bridge and orchestrator tools?

Yes, CLAUDE.md drift detection integrates with session-bridge for durable decisions and connects with the orchestrator to trigger re-planning when detected drift changes your project strategy.

When should I run a CLAUDE.md drift check on my project?

You should run a CLAUDE.md drift check when your project state changes across package.json, the filesystem, or git log, ensuring your declared configuration stays aligned by surfacing mismatches for review.

Can I review and manually apply CLAUDE.md.proposed changes?

Yes, you can manually review and apply changes because the tool generates a CLAUDE.md.proposed file with diff blocks instead of auto-writing, giving you full control over synchronizing your declared configuration.