Come scomporre un'attività grande in sottoattività con l'IA

Per scomporre un'attività grande in sottoattività con l'IA, chiedi a un agente di scomporla prima che inizi qualsiasi lavoro: un'attività troppo grande diventa più sottoattività concrete, ciascuna abbastanza piccola da prendere in carico, finire e approvare da sola. “Riprogettare l'onboarding” non è un'attività che un agente IA, o la maggior parte delle persone, possa semplicemente cominciare. È un obiettivo travestito da attività. La soluzione non è un prompt migliore: è trasformare una voce troppo grande in più voci concrete che un agente può davvero prendere in carico, svolgere e concludere una alla volta.

Perché le attività grandi si fermano

Un'attività che in realtà sono cinque tende a restare in cima a una coda senza fare nulla, perché nulla, al suo interno, dice che cosa fare dopo. Le persone la rimandano; gli agenti si bloccano davanti all'ambiguità oppure, peggio, tirano a indovinare, fanno qualcosa che suona plausibile e riportano un risultato che in teoria ha a che fare con il titolo ma manca il punto. La scomposizione risolve entrambi i problemi allo stesso modo: sostituisce una cosa vaga con più cose prive di ambiguità.

Come funziona decompose_task

decompose_task scompone un'attività in più sottoattività con una sola chiamata, ciascuna un'attività vera a tutti gli effetti: si può assegnare, programmare e svolgere in modo indipendente. Punta un agente verso l'attività troppo grande e chiedigli prima di scomporla: ottieni un insieme di sottoattività concrete, invece di un paragrafo su cui nessuno agirà.

Dalle sottoattività a un piano

Le sottoattività da sole non ti dicono l'ordine né la forma del lavoro. render_plan presenta i passaggi di un'attività in tre modi insieme: una lista di controllo in markdown che leggi a colpo d'occhio, JSON strutturato per gli strumenti e un widget interattivo per gli host MCP che lo mostrano. Chiamalo subito dopo decompose_task o propose_plan per trasformare un mucchio di sottoattività in qualcosa che si legge come un piano vero.

Spuntare i passaggi man mano

set_step_status spunta o riapre un passaggio e restituisce il piano aggiornato: è l'azione naturale quando dici a un agente che un passaggio è fatto, o quando lo cambi tu nel widget. Qui conta un dettaglio: un agente che segna un proprio passaggio senza agent_ok passa comunque dal passaggio di approvazione, invece di chiuderlo direttamente. La scomposizione non crea una scorciatoia intorno all'approvazione; rende solo ogni unità di lavoro abbastanza piccola da approvarla in fretta.

Proponi il piano prima di impegnarti

Per tutto ciò che è consistente, la sequenza migliore non è scomporre e partire: è scomporre, poi propose_plan, e aspettare. L'attività passa a plan_proposed e resta fuori dalla coda delle attività pronte finché non scegli approve_plan (il lavoro comincia) o reject_plan (torna a “da iniziare”, con le tue osservazioni incorporate). Esamini l'approccio prima che ci venga speso qualsiasi sforzo, ed è un punto in cui un presupposto sbagliato costa meno che a lavoro già fatto.

Un esempio concreto

Dopo decompose_task, “Riprogettare l'onboarding” diventa: analizzare il flusso attuale, preparare tre opzioni, raccogliere pareri, realizzare quella scelta, scrivere la documentazione. render_plan trasforma queste cinque voci in una lista di controllo con un ordine. propose_plan ti permette di dare il via libera a quell'ordine (magari anticipi “raccogliere pareri”) prima che venga realizzato qualcosa. Poi ogni sottoattività viene presa in carico, svolta e spuntata (o mandata in approvazione) per conto suo, invece di avere un'unica attività enorme che resta intatta per un mese.