Uma migração de framework
Um passo a passo ilustrativo do trabalho para o qual o DWP foi feito: uma migração que abrange dezenas de arquivos e várias horas — tempo suficiente para que um agente sem orientação perca o fio da meada.
O objetivo
Uma grande mudança → tarefas ordenadas e com portões
Sem um plano
Como um Deep Work Plan
- Tarefa 1
- Tarefa 2
- Tarefa 3
- Tarefa 4
- Tarefa 5
“Migrar a camada de dados do ORM legado para o novo em todo o serviço.”
Sem um plano
Um agente edita os models até que seu contexto se encha de alterações pela metade, esquece quais pontos de chamada já converteu e deixa o build vermelho sem registro do que falta. Retomar significa reconstruir o próprio raciocínio a partir de um log de chat.
Como um Deep Work Plan
O /dwp-create decompõe o objetivo em tarefas atômicas e ordenadas, cada uma com critérios de aceitação e um validation gate:
- Introduzir o novo ORM ao lado do antigo (sem mudança de comportamento; gate: build + testes verdes).
- Migrar os models e os pontos de chamada do módulo A (gate: testes do módulo A verdes).
- Repetir por módulo, uma tarefa para cada — progresso registrado após cada tarefa.
- Remover o ORM legado e seus shims (gate: nenhuma referência permanece; suíte completa verde).
- Atualizar os docs e os READMEs por módulo.
O /dwp-execute executa as tarefas em ordem, comitando após cada gate aprovado e atualizando o PROGRESS.md. Se a janela de contexto for reiniciada no meio do caminho, o /dwp-resume lê o plano e o progresso a partir do disco e continua na próxima tarefa não marcada.
Resultado
A migração é entregue como uma sequência de commits pequenos, revisáveis e validados individualmente — e sobrevive a interrupções, porque o plano, e não a conversa, é a fonte de verdade.