refactor-python
v1.0.0Deterministic, verified decomposition of oversized Python modules using rope + AST oracles, with fan-out/fan-in subagents in git worktrees and file-size guardrails.
License: MIT0 GitHub starsUpdated last week
Directory evidence
- Runtimes
- Claude Code
- Parsed components
- 2 skill or MCP entries
- Source updated
- Sep 13, 2026
- Manifest status
- Canonical path parsed
The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →
Install refactor-python for Claude Code
claude plugin marketplace add IchenDEV/agent-plugin-mkt
claude plugin marketplace update agent-plugin-marketplace
claude plugin install refactor-python@agent-plugin-marketplacePaste and run these commands in a terminal with Claude Code. They add and refresh the PluginsMP catalog, then install this plugin.
The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.
Get the source manually
git clone https://github.com/nixlim/refactor-pythonClone the source repository, then follow its setup instructions to add the plugin to a compatible client. The repository root is the plugin root.
Plugin files
├── .claude-plugin/plugin.json├── skills/guardrails/SKILL.md└── skills/split-module/SKILL.md
Included Skills2
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 tools. Use after a module split, when files keep growing, when setting up a new agent-driven repo, or when asked for "guardrails", "lint rules for file size", "stop files from getting huge", or "enforce module boundaries".
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 whenever a Python file is too large, blocks parallel agent work, trips the file-size guard hook, or someone says "split", "break up", "decompose", "modularize", "this file is huge", or "extract into modules". Also use it proactively before adding code to a file that is already over budget.
Plugin manifests1
{
"$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
"name": "refactor-python",
"displayName": "Refactor Python (split god-modules safely)",
"version": "1.0.0",
"description": "Deterministic, verified decomposition of oversized Python modules using rope + AST oracles, with fan-out/fan-in subagents in git worktrees and file-size guardrails.",
"keywords": [
"refactoring",
"python",
"rope",
"worktree",
"subagents",
"guardrails"
],
"license": "MIT"
}For maintainers
If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.
[refactor-python on Agent Plugins Marketplace](https://pluginsmp.com/plugins/refactor-python)