optimize-rules

To consolidate Claude Code rules, use an optimization process that merges multiple markdown files into a single file. This reduces per-turn context cost while preserving all original constraints through a validation checklist.

Auditing markdown rules involves scanning a directory of .md files to extract constraints and detect duplicate instructions. This identifies redundant rules and outlines an optimization proposal for expected context reduction before merging.

Yes, you can execute a dry-run to preview a rules optimization safely. The process automatically creates backups before merging markdown files and provides a revert workflow to restore original files if validation fails.

Consolidating rule files requires standard file-system tools for reading, globbing directories of .md files, and writing the optimized output. These tools enable the extraction, merging, and backup of markdown constraints.

Splitting Claude Code rules across many markdown files increases context cost because each file adds overhead to the per-turn token usage. Consolidating them into one optimized file reduces this cumulative context burden.