What problem does it solve? After updating the SDD Devkit plugin, projects often contain files, folders, and settings left in the structure of older versions, which the rest of the catalog can no longer read correctly. This Skill detects that legacy content structurally, proposes a migration plan, and normalizes it to the current layout without rewriting user content. ## Core Features & Use Cases - Structural detection: Scans the project against the current layout and templates to find outdated harness files (AGENTS.md, MEMORY.md, ADR/standards indexes), obsolete settings.json keys, old docs/specs/ layouts, legacy glossary paths, and outdated user-story headers. - Confirmed, lossless migration: Presents all findings in a single confirmation batch, applies approved changes with git mv, preserves existing identifiers exactly, and never rewrites or invents user content. - Reference rewriting and reporting: Updates internal links pointing to moved paths and reports the full old-to-new mapping, including items that require a dedicated owning skill. - Use Case: After upgrading the plugin, ask the agent to normalize the project; it finds an old docs/specs/user-stories/ folder and a legacy CLAUDE.md pointer, proposes moving them to the new changes/ layout and merging content into AGENTS.md, then applies everything after your approval. ## Quick Start Ask the agent to migrate and normalize the project content to the current SDD Devkit plugin structure after updating the plugin.
