What problem does it solve?
It prevents broken builds and runtime failures caused by moving scattered files without updating every import, URL, CSS reference, and configuration pointer.
Core Features & Use Cases
- Inventory-driven reorganization: Collects an exhaustive list of loose files at the specified root (with kinds, topics, and reference style).
- Approval-gated layout proposal: Proposes a coherent target structure based on signals in filenames and file types, with an explicit user approve/revise step before any moves.
- Reference sweep that catches silent path breakage: Updates all reference classes including static/bundler imports, string URL paths, CSS url() usage, metadata/OG/sitemap/JSON-LD, config-embedded paths, and test/fixture references.
- Safe execution workflow: Uses an atomic edit pass and enforces verification via typecheck and stale-segment grep to ensure no old path segments remain.
Quick Start
Use the reorganize-files skill to reorganize the directory and update every reference after you confirm the proposed file layout.