Your CLAUDE.md Might Not Be Loading — I Built a Check-Up for That

Описание и применение

Инструмент rules‑doctor анализирует файлы правил Claude Code, выявляя проблемы с импортами, скрытием AGENTS.md и размером файлов, и предлагает конкретные исправления.

Задача

Rule files for Claude Code may silently fail to load due to import placement, shadowing of AGENTS.md, or file size limits, causing expected behavior to be ignored.

Результат

rules-doctor identifies and reports import expansion failures, AGENTS.md shadowing, and rule file bloat, enabling developers to correct rule files and achieve a higher compliance score.

Рабочий процесс

• Install rules-doctor via pip
• Run rules-doctor on the project directory
• Review the report for errors, warnings, and suggestions
• Apply suggested fixes to rule files
• Re-run rules-doctor to confirm resolution
• Integrate --fail-on error flag into CI to enforce rule hygiene

Доказательства

Three ways rule files silently fail

Источник

I built rules-doctor: a tiny zero-dependency Python CLI that statically simulates Claude Code's rule-loading pipeline and gives your project a check-up.

Источник

Every finding comes with a concrete fix suggestion, and you get a 0–100 score with a letter grade.

Источник

This is a static heuristic simulation, not the Claude Code loader.

Источник