audit-claude-md

To audit a Claude.md file, you can run the /audit-claude-md command. It analyzes document structure, enforces best practices, assigns a quality score, and provides automated refactoring recommendations to improve instruction clarity.

A well-structured Claude.md file avoids excessive length, eliminates vague language, and includes all required sections. Auditing helps maintain these best practices to ensure optimal context engineering and improve overall readability for Claude.

Yes, you can automatically refactor markdown documentation and score its quality. The audit evaluates line count, language clarity, and section completeness, assigning a grade and generating refactoring recommendations to enhance file organization.

Common issues in Claude.md files include excessive length, vague language, and missing required sections. The audit identifies these structural and content problems and provides guidance for manual adjustments or automated corrections.

No dependencies are required to maintain Claude.md file organization. The audit operates using built-in scripts to analyze document structure and enforce best practices without external packages.

You should refactor markdown documentation when files become excessively long, instructions lack clarity, or required sections are missing. Running an audit identifies these specific issues and provides targeted recommendations to improve organization.