Decompose (aunx-decompose)

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.

Version 0.2.0 adds unit maps, a fuller planning method:

1. Split the ask into numbered clauses and tag every unit with the clauses it serves. A clause with no unit is flagged.
2. Break the job into the smallest units, each with its own inputs, outputs and verifier. N similar items become N units.
3. Give each unit one of 14 types (coding, reasoning, research, writing, four creative types, design, vision, review, data, agentic, cyber) and one of 3 speeds (fast, standard, frontier).
4. Draw only real data edges: a unit depends on another only when it reads that unit's output. False and missing edges are rejected. Checks that can kill the plan run first.
5. Build parallel waves, count how many units read each output, and raise importance with that count.
6. Choose a dispatch shape per group: one call per unit, an agent's own subagents, a bulk prompt fan-out, an agent fan-out, or split worktrees for disjoint writes. The thresholds are tunable defaults.
7. Send big or serial maps to an advisor review before any picks, and apply its patch (split, cut edges, re-tier, change the shape or the needs) all or nothing.
8. Pick a model and a machine per unit with a written method: type first, then speed, family spread within a wave, context as a scored key, effort set apart from tier, and the smallest machine that fits.
9. Print one plan table with the waves, the critical path and clause coverage.

The simpler step plans from 0.1.0 still work unchanged.

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.

Install

One repository, one skill, a wrapper for each agent. Pick yours:

Agent	Install
Claude Code	claude plugin marketplace add aunysillyme-dev/aunx-skills then claude plugin install aunx-decompose@aunx
Codex CLI	codex plugin marketplace add aunysillyme-dev/aunx-decompose then codex plugin add aunx-decompose@aunx-decompose
Gemini CLI	gemini extensions install https://github.com/aunysillyme-dev/aunx-decompose
GitHub Copilot CLI	copilot plugin install aunysillyme-dev/aunx-decompose
Cursor	cursor-agent plugin marketplace add https://github.com/aunysillyme-dev/aunx-decompose, then install it from Customize, Plugins
OpenCode	npx aunx-decompose install --agent opencode
Qwen Code	npx aunx-decompose install --agent qwen
Hermes Agent	hermes plugins install aunx-decompose then hermes plugins enable aunx-decompose — listed in the Hermes plugin catalog

Skill only, from npm

npx aunx-decompose install copies the skill into an agent's skills folder. It defaults to Claude Code. Name another agent with --agent, repeat the flag for several, or use all:

npx aunx-decompose install --agent codex
npx aunx-decompose install --agent gemini --agent cursor
npx aunx-decompose install --agent all

--agent	User folder	With --project
claude	~/.claude/skills	.claude/skills
codex	~/.agents/skills	.agents/skills
gemini	~/.gemini/skills	.gemini/skills
cursor	~/.cursor/skills	.cursor/skills
opencode	~/.config/opencode/skills	.opencode/skills
copilot	~/.copilot/skills	.github/skills
qwen	~/.qwen/skills	.qwen/skills

--force replaces an existing copy. npx aunx-decompose check --plan plan.json runs the checker without installing anything.

From skills.sh

npx skills add aunysillyme-dev/aunx-skills --skill decompose

Listed at skills.sh. The CLI asks which agent to install into.

Use it

Type /decompose <task> in Claude Code (namespaced as /decompose:decompose), Gemini CLI and Hermes, $decompose in Codex, or ask any agent to split a task into steps, plan dependencies, or check write-path overlap. Decompose plans work and does not execute the plan.

Unit map example

From the root of this repository:

python3 skills/decompose/scripts/decompose.py --plan skills/decompose/examples/plan.json

The bundled map compares three CSV libraries on speed and license, then recommends one. Actual output, exit 0 (table trimmed to four rows):

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗