Capítulo 2

Planejar com o agente

Definir as funcionalidades, criar o plano para desenvolver as tarefas 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 para os endpoints de catálogo usados neste projeto.

---

Melhorar o PLAN.md

Prompt pronto para copiar
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 só mude a stack inicial se existir uma razão concreta para isso.

O agente vai melhorar o rascunho e organizar a execução. Se quiser trocar a stack inicial, ele precisa justificar bem. 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 para 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á para testar.

Antes de sair deste capítulo

Salve o que foi feito até aqui no Git antes de avançar. Isso ajuda você a manter progresso, histórico e pontos seguros de retorno.

git add .
git commit -m "[resuma o que foi feito neste capitulo]"
git push

Troque a mensagem do commit por um resumo curto e real do que mudou neste capítulo.

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

Comunidade

Pergunte, responda, destrave

Use este espaço para fazer perguntas sobre a sessão, compartilhar exemplos e ajudar outras pessoas a entenderem o tema.