Fluxos de Trabalho com Todos

Atualização (Jan 2025): Um sistema de tarefas mais capaz está agora incluído no Claude Code, com dependências, bloqueadores e passagem de testemunho entre sessões. Os fundamentos desta página continuam válidos. Vê o novo guia para padrões avançados.

Problema: Os passos chegam fora de ordem, ou um passo inteiro desaparece, e ficas a questionar se o briefing foi claro de todo.

Solução Rápida: Adiciona isto ao final de qualquer tarefa complexa:

claude "add user authentication - create a todo list first, then implement each step"

Claude escreve o plano como uma checklist no terminal. Qualquer interpretação errada aparece antes de uma única linha de código ser entregue.

Os bugs não são o problema no desenvolvimento com IA. O problema é não saber se Claude realmente percebeu o pedido. Claude Code inclui uma ferramenta integrada TodoWrite que transforma cada tarefa numa checklist na UI do terminal.

Trata uma lista de todos como a versão do Claude de repetir o que ouviu. A checklist atualiza-se em tempo real enquanto o trabalho acontece, marcando itens concluídos, o foco atual e o que está na fila. Alinhamento significa que as instruções estavam claras. Divergência significa uma falha de comunicação, apanhada cedo.

Padrões Comuns de Divergência de Todos

Fora de Ordem: Pedes A depois B, a lista volta com B depois A. Passos em Falta: Os testes estavam no briefing, os todos esqueceram-nos.

Detalhe Errado: O pedido era "update docs" de alto nível, e Claude divide-o em entradas ficheiro a ficheiro. Interpretação Errada: Dizes "review changes", Claude planeia "commit changes."

A lista também redesenha-se em tempo real quando dás feedback. Isso transforma-a num volante real durante trabalho complexo. Diz "actually make the button green instead of blue" a meio da execução, e o todo pendente fica atualizado enquanto todos os itens concluídos ficam exatamente como estavam.

Obtém Todos Específicos

Um todo que diz "style navbar" é todo o problema numa linha. Pede detalhe concreto em vez disso.

Má abordagem:

- [ ] Style the navigation bar

Boa abordagem:

- [ ] Change navbar height from 60px to 80px
- [ ] Reduce padding from 16px to 12px
- [ ] Update background to rgba(255,255,255,0.95)

Dependências por Fases

Agrupa trabalho relacionado em fases e especifica o que cada uma espera:

Phase 1: Setup database schema, create user model
Phase 2: Build registration and login (needs Phase 1)
Phase 3: Add validation and styling (needs Phase 2)

Pontos de Verificação de Qualidade

Passa cada lista de todos por quatro verificações rápidas:

1. Ordem: Sequência lógica?
2. Completo: Todos os passos incluídos?
3. Detalhe Certo: Granularidade adequada?
4. Claro: Outro dev conseguia seguir?

Quando as Coisas Correm Mal

Claude salta todos: Adiciona "Check todo list before starting each step" ao teu CLAUDE.md.

Todos demasiado genéricos: Após dar as instruções, diz "Break this down into specific, measurable steps".

Prioridades erradas: Usa listas numeradas, não pontos, sempre que a ordem é crucial:

1. First, backup the database
2. Then run migrations
3. Finally, restart services

Torna-o um Hábito

Os melhores fluxos de trabalho com todos correm no piloto automático. Incorpora este ciclo de cinco passos no teu dia:

1. Dá ao Claude as instruções da tua tarefa
2. Pede "Create a detailed todo list"
3. Revê para alinhamento com as tuas intenções
4. Refina as instruções se os todos divergirem
5. Avança com confiança

Quando a checklist do Claude corresponde à que tens na cabeça, as instruções estavam claras. Esse é o único critério. Pede os todos primeiro, lê-os com atenção e o resto da sessão corre nos carris.

Próximos Passos:

• Integração com Git para commits orientados por todos
• Feedback loops para iterar na qualidade dos todos
• Gestão de permissões para execução segura
• Modos de planeamento para criação estruturada de todos
• Gestão de contexto para manter o histórico de todos