architectureFind Python architectural improvements (deeper modules, lower coupling, better testability) via metric- and bug-report-informed RFCs.
cleanupHard-nuke all python-refactor output (.python-refactor/) and project-root tool caches (.hypothesis, .pytest_cache, .semgrep, .skylos_cache).
hunt-bugsHunt real Python bugs via metric-guided organic exploration then Hypothesis property-based confirmation, writing BUG_REPORT to .python-refactor/.
measureInstrument a Python project with radon, vulture, bandit, semgrep, skylos, and grimp, writing aggregated codebase_metrics.json to .python-refactor/.
orchestrateOrchestrate the full python-refactor pipeline (measure → hunt-bugs → architecture → plan-refactor) via isolated subagents with compact JSON handoffs.
plan-refactorGenerate a P0–P3, dependency-safe Python refactor plan from codebase_metrics.json (and any BUG_REPORT) with test-gap analysis.