Task Plan Decomposition Panel
When an agent's plan is accepted, Paperclip decomposes it into child tasks — and it guarantees that decomposition happens exactly once, even if the agent retries or a run is interrupted mid-creation. Normally that machinery is invisible: you just see sub-tasks appear. The Task Plan Decomposition Panel makes it visible.
It adds a read-only Plan decomposition section to task detail pages showing, per accepted plan revision, how many child tasks were requested, how many were actually created, and which ones — so you can validate that sub-task creation behaved correctly.
Why it exists
This panel is a debugging and validation surface. The app's own description is candid about it: "Intended for debugging and validating subtask creation behavior while the presentation is still being refined." Turn it on when you're diagnosing questions like "did this plan create all its sub-tasks?", "did a retry double-create children?", or "is a decomposition still in flight?" — and feel free to leave it off otherwise.
Turn it on
- Go to Settings → Instance settings → Experimental.
- Turn on Task Plan Decomposition Panel — "Show accepted-plan decomposition history on task detail pages."
The setting is instance-wide and takes effect immediately.
Reading the panel
Open a task whose accepted plan created sub-tasks. The Plan decomposition section appears in the main column, just above Documents, with a count of accepted plan revisions. Each revision gets a card:
- A status badge — Completed (green check) or In flight (amber spinner) while children are still being created.
- "Plan revision N" and the creation progress — "3 of 3 child tasks created".
- An "Idempotent claim" badge on completed records. This is the exactly-once guard: repeat attempts with the same fingerprint reuse this record instead of creating duplicate children.
- A metadata row — the owning agent, when the decomposition started and completed, and a link to the accepted Plan document.
- A chip for each created child task, linking to its detail page.
There's nothing to configure and nothing to click besides the links — the panel is purely informational.
Note: the panel only renders on tasks that actually have decomposition history. A task whose plan never spawned children shows nothing, even with the flag on.
When it's off
Purely hidden. Decomposition records still exist and the exactly-once guards still run — the flag only controls whether the history is displayed. Flip it back on and the history reappears.
Where to go next
- Work Modes — how plan-mode tasks produce plans that get accepted and decomposed.
- Issues — sub-tasks, blockers, and the task detail page.
- Experimental features overview