Jesse Vincent (obra) / writing-plans
Por que escrever um plano se o agente já poderia começar?
Porque o plano é a única parte do trabalho que sobrevive a um contexto perdido.
O que vale lembrar
- Um plano é o mecanismo de recuperação quando o contexto se perde, o que em trabalho longo acontece o tempo todo.
- Passos sem definição de pronto são desejos, não passos.
- Revisar um plano é muito mais barato que revisar implementação terminada.
- É a ponte natural entre brainstorming e desenvolvimento com subagentes.
01O que muda na prática
Tarefas longas com agente falham de um jeito específico: a conversa cresce, decisões antigas saem do contexto e o agente começa a contradizer o que fez uma hora atrás. Um plano em disco é imune, porque é relido em vez de lembrado.
Ele também barateia a discordância. Discutir um plano leva minutos, discutir uma implementação pronta custa o que ela custou para ser feita.
02Onde decepciona
Planos envelhecem. Um plano que não bate mais com o código é pior que nenhum, porque nele se confia, então atualize quando a realidade divergir.
Excesso de planejamento também existe. Trabalho pequeno não precisa de documento, e produzir um é procedimento por procedimento.
Instalação e primeira execução
- Instale o superpowers a partir de obra/superpowers, sob licença MIT.
- Exija que cada passo nomeie um arquivo ou componente e um jeito de saber que terminou.
- Guarde o plano no repositório, para ser revisável e sobreviver à sessão.
Perguntas que as pessoas realmente fazem
- Onde o plano deve ficar?
- No repositório, para poder ser revisado, versionado e relido por outra sessão ou outro agente.
- O que faz um passo ser bom?
- Um alvo nomeado e um jeito de saber que terminou. Sem isso não dá para conferir o progresso.
- Quando planejar é demais?
- Quando a tarefa cabe em uma sessão e em uma frase. Aí o plano é cerimônia.
Fontes
Versões legíveis por máquina desta página