3hSite em 3HNPD ACADEMY APOIO AO TREINAMENTO

Módulo 03 · Contextualizando o Cursor

08

Avaliando o pacote `.md` e contextualizando o Cursor

Conferir o pacote do ChatGPT, colocar em docs/ e fazer o Cursor ler tudo antes de programar.

Teoria — o que o vídeo pode ter passado rápido

Por que ler antes de programar

Se o agente começa a gerar código sem “digerir” o pacote, ele:

  • inventa stack diferente da documentada;
  • ignora critérios de fidelidade visual;
  • preenche lacunas comerciais com lixo (preços fake, textos stock).

O comando de leitura é um gate de qualidade.

Janela de contexto (tokens)

Modelos têm limite de quanto texto/imagem “lembram” por vez.

Pacote de dezenas de MDs + imagens → escolha modelo com contexto longo.

Se a janela for pequena, peça leitura por etapas (COMECE_AQUI → briefing → páginas).

Pasta docs/ como fonte da verdade no repo

Convenção simples:

  • docs/ = especificação
  • src/ / código = implementação
  • public/ = estáticos finais

Assim você (e a IA) sabem onde olhar.

Pendências ≠ falha

Preço, Hotmart, WhatsApp podem estar em aberto. O correto é listar em PENDENCIAS.md e usar placeholders — não inventar URL de checkout.

Avaliação rápida do pacote (QA humano, 10 min)

  • Existe ordem de leitura
  • Briefing descreve o negócio certo
  • Cada página importante tem MD
  • Artes batem com os nomes citados
  • Stack/Cloudflare mencionados
  • Critérios de aceite existem (mesmo simples)

Se faltar peça 1, volte ao ChatGPT e regenere só o buraco — não jogue o pacote fora inteiro sem necessidade.

Passos

1. Download do ZIP

2. Criar docs/ no projeto

3. Copiar pacote

4. Novo chat + modelo de contexto grande

5. Pedir leitura e resumo + dúvidas bloqueantes

Prompt

Prompt

Leia todo o conteúdo da pasta docs (incluindo subpastas).
Resuma: marca, páginas, stack, restrições e pendências.
NÃO comece a programar ainda — confirme o entendimento e liste dúvidas bloqueantes.

Para a próxima aula

Liberar a implementação e acompanhar a base do projeto nascendo.

PARA CONSULTAR QUANDO PRECISAR

Dúvidas desta aula

O Cursor sabe o que conversei em outra ferramenta?

Não conte com essa transferência automática. Coloque na pasta do projeto os documentos e arquivos necessários e indique quais devem ser lidos. Peça um resumo do entendimento antes de iniciar a implementação.

O que faço se o documento e a imagem discordarem?

Resolva a diferença antes de programar. Por exemplo: a imagem pode mostrar um preço fictício, enquanto o documento contém o preço aprovado. Registre qual informação vale e atualize o material para evitar a mesma dúvida depois.

Preciso organizar todas as imagens antes de continuar?

Separe pelo menos as que serão usadas na primeira versão e deixe claro onde entram. Nomes compreensíveis ajudam. Se faltar uma imagem, indique a pendência em vez de deixar a ferramenta escolher uma foto definitiva sem sua revisão.