doc-sync

To synchronize CLAUDE.md and README.md navigation indexes, run the doc-sync skill at the repository root. It executes a five-phase workflow to detect drift, migrate misplaced content, and update table-based indexes for consistent documentation structure.

Documentation drift occurs when CLAUDE.md files become outdated or missing relative to repository changes. An audit phase detects this drift and misplaced content, followed by migration and update phases that refresh indexes to restore complete navigational coverage.

Yes, documentation synchronization can operate across the entire repository or within scoped directories. The discovery phase maps all targeted directories to detect missing CLAUDE.md files and validate structure before performing any migrations or updates.

The best way to migrate architecture and design details from CLAUDE.md to README.md is using the migration phase. It identifies misplaced content and moves it to README.md for proper documentation placement, then updates indexes to reflect the corrected structure.

To verify complete coverage and correct formatting, the verification phase checks for the absence of drift and confirms table-based indexes are properly formatted. It ensures all directories contain self-contained documentation with no missing entries.