claude-md

Validate proposed CLAUDE.md changes for placement, redundancy, and universality.

1|Updated Nov 26, 2025
One-click install
npx skills add https://github.com/slavochek2/claritypledge --skill claude-md-slavochek2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-md
Source: https://github.com/slavochek2/claritypledge/tree/main/.claude/commands/slava/maintain/claude-md
Command: npx skills add https://github.com/slavochek2/claritypledge --skill claude-md-slavochek2

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enforces safe, consistent CLAUDE.md updates by validating placement, preventing redundancy, and ensuring proper routing before any edits are applied.

Core Features & Use Cases

  • Audits CLAUDE.md for universality, correct routing, and content relevance.
  • Performs a drift scan against existing .claude/rules/*.md to surface misplacements or orphan content.
  • Outputs a structured action (ADD/REDIRECT/SKIP) with exact markdown so changes can be applied automatically.

Quick Start

Run this gate before editing CLAUDE.md and any .claude/rules/*.md files; supply the proposed change as input to the gate.

Frequently Asked Questions about claude-md

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

FAQPage Schema
How do I validate CLAUDE.md changes before applying them?

Validate CLAUDE.md changes by running a gate-driven audit that checks proposed edits for placement, redundancy, and universality. The validation outputs a structured ADD, REDIRECT, or SKIP action with exact markdown for safe application.

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

A CLAUDE.md drift scan compares proposed content against existing .claude/rules/*.md files. It surfaces misrouted content and orphan rules, ensuring updates do not create redundant or conflicting instructions across your configuration files.

How do I prevent bloated rules and misrouted content in CLAUDE.md?

Prevent bloated rules and misrouted content in CLAUDE.md by applying a gatekeeper validation step before editing. This audit checks content universality and routing, redirecting misplaced entries to .claude/rules/*.md instead of allowing bloat.

Does the CLAUDE.md validation gate work with .claude/rules/*.md files?

Yes, the CLAUDE.md validation gate explicitly audits .claude/rules/*.md files. It performs a drift scan against them to catch misplacements and orphan content, ensuring correct routing between the main file and specific rule files.

What's the best way to structure CLAUDE.md updates for automation?

The best way to structure CLAUDE.md updates for automation is to supply proposed changes to a validation gate. The gate outputs exact markdown with an ADD, REDIRECT, or SKIP directive, allowing downstream tools to apply changes automatically.

When should I skip adding new content to CLAUDE.md?

You should skip adding new content to CLAUDE.md when the validation gate determines the proposed change lacks universality or is redundant. The gate outputs a SKIP action if the content is too specific or already exists in .claude/rules/*.md.