audit-claude-md

You can audit CLAUDE.md files by running the /audit-claude-md command, which validates YAML frontmatter presence, required fields, and optional directory structures to generate a conformance report.

Validating AGENTS.md documentation structure involves checking for proper YAML frontmatter, verifying the existence and usage of optional directories like scripts/ and references/, and enforcing safe defaults for prompt behavior.

You need to split CLAUDE.md files when the audit identifies structural issues or excessive content, providing actionable improvement guidance for dividing documentation into manageable, best-practice compliant sections.

Yes, the audit checks markdown documentation for YAML frontmatter presence, validates required fields, and verifies dependencies using included scripts and configuration to ensure proper documentation structure.

The best way to ensure CLAUDE.md follows recommended practices is executing a structured audit that validates frontmatter, checks optional components like assets/ and references/, and provides actionable improvement guidance.

Yes, the documentation audit works without external dependencies, using only included scripts and configuration to validate structure, enforce safe defaults, and generate conformance reports for CLAUDE.md and AGENTS.md files.