Documentation
From README.md · b46c48d · Built 2026-11-17
Decompose is a plugin and agent skill that breaks a task into the smallest units that can each be checked, and shows which units can run at the same time. It installs in Claude Code, Codex CLI, Gemini CLI, Cursor, GitHub Copilot CLI, OpenCode, Qwen Code and Hermes Agent. Your agent writes the plan. A Python helper that uses only the standard library checks it. Python 3.8+ is enough. No API keys or Python packages needed.
When to use it
Use it when a task has several steps, some can run in parallel, more than one agent or subagent may edit files, or you want a plan a script can verify. Skip it for a single-step task or a prose outline. It works alongside plan mode and to-do lists and does not replace them.
What it runs and writes
- Claude runs one Python 3 script,
skills/decompose/scripts/decompose.py, on the files you name. It uses only the standard library. - It makes no network requests, sends no data anywhere, installs no packages, and starts no other programs. The plugin has no hooks and no MCP servers.
- It reads the steps, card, plan or patch file you pass and the bundled
recipes.json. - It never picks or calls a model or a machine. Picking is a written method for the agent.
- It writes only when you save a recipe: to
$DECOMPOSE_RECIPESor~/.claude/decompose/recipes.json, plus a.lockfile and a temporary file beside it. It never writes inside the plugin folder. - Claude is told to keep its working
steps.jsonin a new temporary directory, so it does not overwrite your files.