refactor-python

Plugin refactor-python in nixlim/refactor-python. Commands read from the repo's manifest — 1 month ago.

Skills (3)

• decompose

  Decompose oversized Python classes, functions, and test classes using manifest-verified method moves, statement extraction, and test-ID checks. Use split-module for whole top-level relocations.

• guardrails

  Install and verify file-size, complexity, and import-boundary guardrails for a Python repo worked on by AI agents: ruff complexity rules, a max-code-lines pre-commit hook with a grandfather baseline, import-linter contracts, a CI job, and a CLAUDE.md/AGENTS.md section that points at the enforcing to

• split-module

  Safely decompose an oversized Python module (anything over ~500 code lines, especially multi-thousand-line "god files") into a package of small modules, using deterministic tools (rope for moves, an AST body-hash oracle, a test/type/import gate) and parallel subagents in git worktrees. Use this when

Subagents (5)

• extractor

  Moves one cluster of symbols from a Python god-module into a target module using rope, runs the verification gate, and commits on its own worktree branch. Spawned in parallel by the split-module skill, one per cluster. Never used for anything but mechanical moves.

• gate-runner

  Runs the split-module verification gate (verify.sh) after a merge and returns a short verdict, keeping test and lint output out of the main conversation. Use from the split-module skill in fan-in.

• plan-critic

  Adversarially reviews a module-split plan produced by split-planner before any code moves. Use from the split-module skill in Phase 2. Read-only.

• refactor-reviewer

  Adjudicating review of a completed module split: independently checks the diff AND verifies the headless Codex (GPT-5.6 Sol) review verdict finding by finding. Use from the split-module skill in Phase 6b, never as the extractor. Read-only.

• split-planner

  Produces the decomposition plan for splitting one oversized Python module into a package. Use from the split-module skill after inventory.py has run. Read-only; never edits code.

Hooks (2)

• SessionStart

  if [ -d .refactor ]; then echo "refactor-python: split in progress. $(python3 "${CLAUDE_PLUGIN_ROOT}"/skills/split-module/scripts/type_baseline.py status 2>/dev/null)"; fi

• PostToolUse

  python3 "${CLAUDE_PLUGIN_ROOT}"/skills/split-module/scripts/check_file_length.py --hook

Similar plugins