Como dividir uma tarefa grande em subtarefas com IA

Para dividir uma tarefa grande em subtarefas com IA, peça a um agente que a decomponha antes de qualquer trabalho começar: uma tarefa grande demais vira várias subtarefas concretas, cada uma pequena o bastante para ser assumida, concluída e aprovada separadamente. “Redesenhar o onboarding” não é uma tarefa que um agente de IA, ou a maioria das pessoas, consiga simplesmente começar. É uma meta fantasiada de tarefa. A solução não é um prompt melhor. É transformar um item grande demais em vários itens concretos que um agente consiga assumir, trabalhar e terminar, um de cada vez.

Por que as tarefas grandes travam?

Uma tarefa que na verdade são cinco costuma ficar parada no topo da fila, porque nada nela diz o que fazer em seguida. As pessoas procrastinam. Os agentes travam diante da ambiguidade ou, pior, chutam, fazem algo que parece razoável e entregam um resultado que tecnicamente toca no título, mas erra o alvo. A decomposição resolve os dois problemas do mesmo jeito: troca uma coisa vaga por várias sem ambiguidade.

Como funciona o decompose_task?

O decompose_task divide uma tarefa em várias subtarefas em uma única chamada, e cada uma é uma tarefa de verdade por si só: pode ser atribuída, agendada e trabalhada separadamente. Aponte um agente para a tarefa grande demais e peça que ele a decomponha primeiro. Você recebe um conjunto de tarefas filhas concretas em vez de um parágrafo com o qual ninguém vai fazer nada.

Das subtarefas a um plano

As subtarefas sozinhas não dizem a ordem nem o formato do trabalho. O render_plan apresenta as etapas de uma tarefa de três formas ao mesmo tempo: um checklist em markdown que dá para ler de relance, JSON estruturado para ferramentas e um widget interativo para os hosts MCP que o exibem. Chame-o logo depois de decompose_task ou propose_plan para transformar um monte de subtarefas em algo que se lê como um plano de verdade.

Marcar as etapas conforme elas acontecem

O set_step_status marca uma etapa como concluída ou a reabre e devolve o plano atualizado. É a ação natural quando você diz a um agente que uma etapa terminou, ou quando você mesmo a marca no widget. Um detalhe importa aqui: se um agente marca uma etapa própria que não é agent_ok, ela ainda passa pela trava de aprovação em vez de ser fechada diretamente. A decomposição não cria um atalho para contornar a aprovação. Ela só deixa cada unidade de trabalho pequena o bastante para ser aprovada rápido.

Proponha o plano antes de se comprometer

Para qualquer coisa substancial, a melhor sequência não é decompor e sair fazendo. É decompor, chamar propose_plan e esperar. A tarefa passa para plan_proposed e fica fora da fila de tarefas prontas até você chamar approve_plan (o trabalho começa) ou reject_plan (ela volta para não iniciada, com o seu feedback incorporado). Você revisa a abordagem antes de qualquer esforço ser gasto, e esse é um ponto bem mais barato para pegar uma suposição errada do que depois que o trabalho já foi feito.

Um exemplo prático

Depois do decompose_task, “Redesenhar o onboarding” vira: auditar o fluxo atual, esboçar três opções, colher feedback, construir a vencedora e escrever a documentação. O render_plan transforma essas cinco em um checklist ordenado. O propose_plan deixa você aprovar essa ordem (talvez você antecipe “colher feedback”) antes de qualquer coisa ser construída. Depois, cada subtarefa é assumida, trabalhada e marcada como concluída (ou encaminhada para aprovação) separadamente, em vez de uma tarefa enorme ficar parada por um mês.