Capítulo 2

Planejar com o agente

Definir as funcionalidades, pedir um plano de implementação ao agente e revisar.

As três funcionalidades

O projeto tem um escopo definido:

  1. Busca de artistas, /search/artist?q=nome
  2. Discografia, /artist/{id}/albums
  3. Detalhes do álbum, /album/{id} (tracklist, capa, data)

Todos os endpoints são da API pública do Deezer. Não precisa de autenticação, mas tem uma questão de CORS que vamos resolver no próximo capítulo.

---

Melhorar o PLAN.md

Prompt:

"Revise o PLAN.md inicial com base no AGENTS.md (ou CLAUDE.md, se eu estiver usando Claude Code). Detalhe as fases de implementação, mantenha cada fase pequena e testável, adicione critérios de aceite claros e sugira a stack mais simples que funcione."

O agente vai melhorar o rascunho, propor uma stack e organizar a execução. Não aceite automaticamente.

---

Revisar e iterar

Leia o plano inteiro e se pergunte:

  • As fases fazem sentido? Cada uma é testável individualmente?
  • O escopo é claro? Nenhuma fase é grande demais?
  • A stack é simples o suficiente? Você entende as tecnologias sugeridas?

Se algo não faz sentido, itere:

Exemplos de ajuste:

"Essa fase está grande, divide em duas."

"Não quero essa lib, sugere algo mais simples."

"Adiciona critérios de aceite pra cada fase."

✓ Checkpoint:

O PLAN.md está detalhado, salvo no repositório e revisado por você. Cada fase tem critérios de aceite que dá pra testar.

Capítulo 2

0 de 3 checkpoints

Complete todos os checkpoints para desbloquear o próximo capítulo.

Próximo: Construir por partes
Voltar para a visão geral

Quer se aprofundar?

Artigos

Documentação