← ClaudeAtlas

managerlisted

Use when the codebase is structurally hard to navigate: oversized files or classes that should be split into cohesive modules, or a flat or misplaced directory layout that should be regrouped by feature or responsibility. Behavior-preserving structural refactor only: split files and move them into a cleaner layout, with import rewrites and re-export shims keeping callers unchanged. Run when the user says "this module is a mess", "split this giant file", "reorganize these folders", "group these files by feature", or "restructure this directory". Not for in-place dead-code removal or deduplication (that is the cleaner skill), nor for new features, bug fixes, or behavior changes.
Swellshinider/janitor · ★ 0 · AI & Automation · score 62
Install: claude install-skill Swellshinider/janitor
# Manager Behavior-preserving structural refactor. Split oversized files into cohesive modules and move files into a cleaner directory layout. Tests stay green and the public surface is frozen: every move rewrites imports and leaves a re-export shim at the old path so callers keep resolving. If a move would change behavior, do not make it. ## The Contract (non-negotiable) 1. **Tests first.** Run the project's tests before touching anything. Record green or red. If there is no test suite, say so and ask before proceeding. 2. **One move at a time.** Apply one structural edit, one split or one relocation, re-run the tests, then commit or revert. On the first failure you did not cause, stop and revert. 3. **Public surface frozen.** Exported names, function signatures, types, and module paths stay identical. Every moved module leaves a re-export shim at its old path so existing imports keep resolving. 4. **No dynamic guesses.** Never move or split code that may be reached by reflection, string dispatch, `eval`, dependency injection, or `__all__`-gated exports. When unsure, keep it and flag it for the human. 5. **Every move gets a diff and a one-line reason.** Group moves into a reviewable plan; nothing lands silently. ## How it works Assess, propose, execute. Survey the structure, design a target layout, then apply one move at a time with verification. - **Assess.** Run `scripts/survey_structure.py --json`. Build a map of oversized files, wide direc