What problem does it solve? Project documentation files (CLAUDE.md, docs/*.md) generated from an older version of the btt-sdd plugin scaffold become outdated when the plugin template gains new sections, and this Skill detects and applies those missing sections without overwriting project customizations. ## Core Features & Use Cases - Changelog-Based Gap Detection: Compares the project's recorded plugin version against the installed plugin's CHANGELOG.md to find scaffold sections added since the last sync. - Bidirectional Structural Comparison: Scans section headings in both directions (project to scaffold and scaffold to project) to catch missing sections and entirely missing files, including retroactive coverage for versions before 1.15.0. - User-Approved Additive Updates: Presents every candidate section for approval before applying changes as pure additions, then commits on a dedicated branch and opens a PR. - Use Case: After running a plugin update, a project maintainer invokes the sync to discover that docs/POST-MERGE-VALIDATION.md and three new CLAUDE.md sections are missing, approves them, and gets a ready-to-review PR. ## Quick Start Ask the assistant to run the sync-docs utility to check whether the project documentation is missing any sections from the currently installed btt-sdd plugin version.
