Criar plan.md Detalhado
O que e
O plan.md e um documento Markdown que serve como o "contrato" entre voce e o Claude Code. Ele descreve o que sera construido, como sera feito, e em que ordem. Diferente de documentacao tradicional, o plan.md e projetado para ser lido tanto por humanos quanto pelo Claude, servindo como contexto persistente entre sessoes.
Por que aprender
Sem um plano documentado, cada nova sessao Claude Code comeca do zero. Voce perde tempo re-explicando contexto, o agente toma decisoes inconsistentes, e o projeto diverge da visao original. Com um plan.md bem estruturado, qualquer sessao pode retomar o trabalho exatamente de onde parou, mantendo coerencia arquitetural.
Conceitos-chave
- • Documento vivo: Atualizado conforme o projeto evolui
- • Dual-purpose: Legivel por humanos e parseavel pelo Claude
- • Single source of truth: Toda decisao importante esta la
- • Contexto persistente: Sobrevive ao autocompact e troca de sessoes
Overview e Big Picture
O que e
A secao de Overview no plan.md descreve a visao geral do projeto em alto nivel. Inclui o problema que esta sendo resolvido, a solucao proposta, os principais componentes, e o resultado esperado. E o "elevator pitch" do projeto que orienta todas as decisoes subsequentes.
Por que aprender
Claude Code precisa entender o "porque" antes do "como". Sem big picture, o agente pode implementar solucoes tecnicamente corretas mas que nao se alinham com a visao do projeto. O overview garante que mesmo decisoes autonomas estejam na direcao certa.
Conceitos-chave
- • Problema: Qual dor estamos resolvendo
- • Solucao: Como vamos resolver
- • Arquitetura: Principais componentes e como se conectam
- • Success criteria: Como sabemos quando esta pronto
Fases com Tarefas
O que e
Dividir o projeto em fases sequenciais, cada uma com tarefas especificas. Cada fase representa um milestone logico - um ponto onde o sistema esta em estado funcional. Dentro de cada fase, as tarefas sao listadas em ordem de execucao, com dependencias explicitas.
Por que aprender
Fases bem definidas permitem paralelizacao inteligente. Voce sabe exatamente quando uma fase termina e a proxima pode comecar. Tambem facilita a delegacao: diferentes sessoes podem trabalhar em fases ou tarefas independentes sem colisao.
Conceitos-chave
- • Fase = Milestone: Ponto de parada funcional
- • Tarefas atomicas: Pequenas o suficiente para completar em uma sessao
- • Dependencias explicitas: "Tarefa B depende de A"
- • Estimativas: Tempo aproximado por tarefa
Checkboxes Automaticos
O que e
Usar checkboxes Markdown (- [ ] e - [x]) para rastrear progresso. O Claude Code pode atualizar esses checkboxes automaticamente ao completar tarefas, criando um registro vivo do que foi feito e o que falta.
Por que aprender
Checkboxes automaticos eliminam a necessidade de voce rastrear progresso manualmente. Uma nova sessao pode ler o plan.md e saber instantaneamente onde o projeto esta. Isso e especialmente util em Relay Race, onde cada sessao precisa saber exatamente onde a anterior parou.
Conceitos-chave
-
•
Sintaxe Markdown:
- [ ]pendente,- [x]completo - • Auto-update: Instrua Claude a marcar ao completar
- • Granularidade: Um checkbox por tarefa atomica
- • Visibilidade: Progresso visivel a qualquer momento
Decision Log
O que e
Uma secao do plan.md dedicada a registrar decisoes importantes tomadas durante o desenvolvimento. Cada entrada inclui a decisao, o contexto, as alternativas consideradas, e o racional. O decision log preserva o "porque" das escolhas que moldaram o projeto.
Por que aprender
Sem decision log, decisoes passadas viram "folklore" - ninguem lembra por que algo foi feito daquela forma. Novas sessoes podem reverter decisoes importantes sem perceber, ou reinventar solucoes ja descartadas. O log garante continuidade intelectual.
Conceitos-chave
- • Data + Decisao: Quando e o que foi decidido
- • Contexto: Qual problema motivou a decisao
- • Alternativas: O que mais foi considerado
- • Racional: Por que esta opcao venceu
Claude.md Updates
O que e
Alem do plan.md, manter o CLAUDE.md do projeto atualizado com padroes, convencoes e instrucoes que o Claude deve seguir. Enquanto o plan.md descreve O QUE construir, o CLAUDE.md descreve COMO construir - padroes de codigo, estrutura de pastas, convencoes de naming.
Por que aprender
Plan.md e CLAUDE.md sao complementares. O plan.md pode mudar drasticamente entre projetos, mas o CLAUDE.md mantem consistencia de estilo ao longo de todo o desenvolvimento. Juntos, eles garantem que o projeto avance de forma coerente e previsivel.
Conceitos-chave
- • CLAUDE.md: Instrucoes persistentes para o Claude
- • Padroes de codigo: Formatacao, naming, estrutura
- • Referencias: Links para plan.md e outros docs
- • Sincronizacao: Atualizar CLAUDE.md quando padroes mudam
Resumo do Modulo
Proximo Modulo:
7.6 - Session Management - Gerenciando contexto e limites de sessao