O workflow padrão para desenvolver com agentes: planejar antes de codar, manter a janela de contexto sob controle, delegar a subagentes e fechar via PR.
Guia · Documento vivoNunca comece codando. Todo desenvolvimento nasce de um plano em markdown, roda com a janela de contexto sob controle e termina numa PR.
Este guia é o piso, não o teto. Siga o ciclo abaixo como padrão e evolua a partir dele — quando o time descobrir um jeito melhor, o guia muda junto.
Seis comandos cobrem 90% do método. Deixe esta tabela à mão até virarem reflexo.
| Comando | O que faz | Quando usar |
|---|---|---|
/context |
Mostra quanto da janela de contexto está ocupada | Antes de qualquer tarefa grande. Acima de ~50%, limpe ou compacte |
/clear |
Zera a conversa — o CLAUDE.md permanece | Sempre que trocar de tarefa |
/compact |
Resume a conversa e libera espaço | Quando o contexto encheu no meio de uma tarefa que não pode parar |
Shift+Tab |
Plan mode — o agente planeja sem editar nada | No início de todo desenvolvimento |
/agents |
Cria e gerencia subagentes com contexto limpo | Para delegar pesquisa, testes e revisão sem inflar a sessão principal |
/init |
Gera o CLAUDE.md do projeto | Uma vez por repo — e mantenha enxuto depois |
Dica: ative a status line para ver o consumo de contexto em tempo real, sem precisar perguntar.
Quatro etapas, sempre na mesma ordem. A disciplina está em não pular a segunda.
Entre em plan mode (Shift+Tab) e descreva o que quer construir. O resultado é um plano em markdown com fases, tarefas pequenas e etapas de verificação. Nenhuma linha de código antes do plano aprovado.
Leia o plano — ele é a revisão mais barata que existe. Depois, faça perguntas adversariais ao agente: o que quebra? qual o jeito mais simples? o que você assumiu sem me perguntar? Corrigir plano custa minutos; corrigir código custa horas.
Aprovado o plano: 1 desenvolvimento = 1 plano = 1 branch. Dispare subagentes para pesquisa, testes e tarefas paralelas — cada um com contexto limpo — e mantenha a sessão principal leve, orquestrando.
Antes de abrir a PR, peça ao próprio agente uma revisão do diff. Depois, teste de verdade: rode a aplicação, clique nos fluxos. Merge só com verificação feita.
A janela de contexto é o recurso mais escasso do agente. Quem cuida dela recebe respostas melhores — simples assim.
/context como reflexo; status line ligada para monitorar em tempo real/clear ao trocar de assunto; /compact só quando não dá pra pararO repositório é o ativo — e o git é a rede de segurança que deixa o agente trabalhar rápido sem medo.
O agente só é tão bom quanto o contexto que recebe. O conhecimento do negócio entra por um caminho definido — não por copy-paste.
Cada tema deste guia tem uma entrega dedicada no portal, com fontes e o raciocínio completo.
Siga o ciclo como está nas primeiras semanas. Quando algo travar — ou quando o time encontrar um atalho melhor —, este guia é atualizado. Documento vivo: a versão desta página é sempre a versão do método.
Ver as entregas do portal →