Gerando o Markdown para o Cursor

Transformar decisões e artes em um pacote .md + assets que o Cursor execute sem reinventar o projeto.

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

Por que Markdown (.md)?

Markdown é texto estruturado (títulos, listas, ênfase) que IAs e humanos leem bem.

Vira o contrato entre planejamento e código: o que deve existir, com que texto, sob quais critérios.

Sem .md, você “conversa” com o Cursor para sempre. Com .md, você especifica uma vez.

Arte = verdade visual · MD = verdade operacional

Se houver conflito: atualize o MD ou reaprove a arte — não deixe ambíguo.

O que um bom MD de página contém

1. Objetivo da página

2. Seções na ordem (nome + conteúdo)

3. Componentes (FAQ accordion, cards, CTA…)

4. Interações (hover, expandir, carrossel…)

5. Responsividade (o que muda no mobile)

6. Assets necessários (hero, ícones)

7. Critérios de aceite (“pronto quando…”)

Prompt mestre vs microgestão

Um pedido completo de pacote > 40 mensagens “agora faz o footer”.

Microgestão sem documento é o anti-padrão que a Esteira combate.

Organização de arquivos (absorveu a antiga “aula ZIP”)

Peça explicitamente no pacote:

• pastas por tipo (docs/, referencias/, assets/);
• nomes estáveis (home--hero.png);
• manifesto do que cada imagem é;
• ordem de leitura para o Cursor (COMECE_AQUI).

Nomes ruins (imagem (1).png) geram implementação confusa.

Tokens e tamanho do pacote

Pacotes grandes exigem modelo com janela de contexto longa na hora de ler no Cursor (próximo módulo). Não é bug — é capacidade.

Prompt mestre

Prompt

Ainda não ficou igual às artes — tudo bem.
A partir das IMAGENS aprovadas (não do protótipo HTML), gere um pacote completo para o Cursor:

1) Um .md por tela com textos, seções, componentes, interações,
   responsividade, critérios de validação e referência da arte.

2) Documentação geral: briefing, design system, conteúdo oficial,
   arquitetura (estático / Cloudflare), plano de execução,
   prompt mestre / ordem de leitura.

3) Extraia ícones e recortes das artes aprovadas.
   Não substitua por ícones genéricos.

Stack: Cloudflare + Cursor.

Para a próxima aula

Aula conceitual: a Esteira de Contextualização — o porquê disso tudo funcionar.