Skip to content
Deep Work Plan está no Product Hunt hoje Vote nele
← Todos os capítulos

Capítulo 03

Templates de plano e de tarefa

Um Deep Work Plan é um diretório de arquivos markdown. O formato desse diretório — e de cada arquivo dentro dele — é o que torna um plano revisável tanto por humanos quanto por agentes.

Estrutura do plano

Um plano é um diretório em .dwp/plans/ chamado PLAN_<slug>/. Ele contém:

  • README.md — a visão geral do plano: objetivo, material de origem, tabela de tarefas e status.
  • Um arquivo por tarefa, chamado <n>.task_<slug>.md.
  • PROGRESS.md — um registro contínuo da execução.

Estrutura do arquivo de tarefa

Cada arquivo de tarefa é chamado <n>.task_<slug>.md e segue a anatomia de dez seções: Goal, Context, Superfície tocada, Steps, Acceptance criteria, Validation, Files, Dependencies, Risks e Completion & Log. As seções sempre aparecem nessa ordem para que qualquer leitor saiba onde procurar. Cada tarefa reancora-se ao objetivo do plano antes de agir, o que impede o agente de derivar ao longo de um horizonte extenso, de várias horas.

O Final Review

Todo plano deve terminar com exatamente uma tarefa obrigatória: o Final Review. Ele encerra o plano em três passes ordenados — nada do passe de segurança é relaxado:

  1. Passe de segurança — auditar tudo o que o plano mudou em busca de segredos, riscos de injeção e nova superfície de ataque, e manter o docs/SECURITY.md atualizado. Segurança não é um fluxo de trabalho separado acrescentado no final: todo plano deixa suas próprias mudanças auditadas, e um achado crítico bloqueia a conclusão.
  2. Validação do estado final — a validação completa do repositório é executada e passa sobre o último estado relevante, após a correção final.
  3. Reconciliação de skills — cada tarefa registrou sua própria disposição de skills enquanto sua evidência estava fresca; a revisão reconcilia o registro. O Executive Report continua disponível mediante solicitação.

Convenções de README e PROGRESS

O README.md do plano deve conter um título (# Deep Work Plan: <name>), uma declaração de objetivo em prosa, uma seção opcional de material de origem, uma tabela de tarefas (número, nome da tarefa, caixa de status) e uma linha de status do plano no formato <n>/<total> tasks complete.

O PROGRESS.md é um registro de execução somente de adição. Cada entrada registra um carimbo de data/hora ISO 8601, o número e o nome da tarefa, o que foi feito e quaisquer desvios ou motivos de pular. Como ele apenas cresce, é um histórico confiável de como o plano realmente se desenrolou.

Títulos e referências cruzadas

Todos os títulos usam sentence case, e os documentos evitam linguagem de marketing e pontos de exclamação. Essas convenções mantêm os planos consistentes entre agentes e ao longo do tempo.