What problem does it solve?
Synchronizes the documentation index by scanning the doc/ directory and aligning doc/index.yml with doc/guide.list.directory.md, ensuring entries reflect current markdown files and reducing drift between the authoritative index and the rendered guide view.
Core Features & Use Cases
- Bidirectional synchronization between index.yml and guide.list.directory.md to keep metadata consistent with the actual files.
- Automatic title updates by reading the first heading from each markdown file or falling back to the filename when a heading is missing.
- Non-destructive handling of deletions: missing files are flagged for review rather than auto-deleted, enabling safe cleanup.
- Use Case: when new docs are added to doc/ by team members, run the sync to update the index and render view in one step.
Quick Start
Run the /doc-sync command to perform a full synchronization of the documentation index.