reorganize-logic

What problem does it solve?

When a project's design documentation (architecture diagrams, structure maps, interface contracts) has rotted so severely that incremental syncing is no longer effective, stale docs create a risk of inaccurate documentation that appears correct but does not match the actual code, leading to development errors and bugs. This Skill solves that by rebuilding the entire design-contract layer directly from the codebase, with code as the single source of truth.

Core Features & Use Cases

• Full contract rebuild from code: Re-derives architecture diagrams, structure maps, and explicit interface definitions entirely from the current codebase, with no copy-pasting from stale legacy docs.
• Deterministic validation gate: A language-agnostic script cross-references every documented interface to a real code file:line, catches coverage holes, flags ambiguous near-name matches, and blocks on any inconsistencies to eliminate incorrect documentation.
• Review-gated legacy cleanup: Generates a deletion manifest for stale docs, but never auto-deletes anything — all deletions require explicit human approval to avoid data loss.
• Use case: Use this Skill when your project's design docs are drastically out of sync with the actual code, and you need accurate, traceable contracts without the risk of incorrect incremental updates.

Quick Start

Use the reorganize-logic skill to rebuild your project's design contract layer from the current codebase, replacing all stale architecture, structure, and interface documentation with accurate, code-verified versions.