Pular para o conteúdo principal
EnzRossi
GrátisGuia/13 capítulos

Primeiros passos com AI coding: um app Next.js real com Cursor e Claude

Um passo a passo prático, para acompanhar fazendo. Uma stack, um projeto, um workflow que você vai continuar usando depois que o tutorial acabar.

Por EnzRossi EngineeringAtualizado em abril de 202636 min de leitura
13 capítulos/36 min de leitura

Sumário

O que tem dentro

Os primeiros 2 capítulos estão liberados para leitura nesta página. O material completo vem em PDF para salvar, imprimir e compartilhar com o time.

  1. 01O Que Você Vai Construir (e Por Que Vale 90 Minutos)Um app real publicado, um workflow real e a memória muscular para continuar usando os dois.
  2. 02O Que Você Precisa Antes de ComeçarCinco contas, um terminal. Nenhuma custa mais que US$ 20.
  3. 03Configure o Cursor com ClaudeCinco minutos de configuração. Você vai se agradecer depois.
  4. 04Opus para Planejar, Sonnet para ConstruirO hábito mais útil que você vai aprender com este guia.
  5. 05Passo 1: Scaffold do Projeto (Sonnet)Tenha um projeto Next.js 16 funcional na sua máquina em 60 segundos.
  6. 06Passo 2: Escreva o CLAUDE.md e os .cursor/rulesO passo mais importante. Dois arquivos que mudam o comportamento de todo prompt daqui pra frente.
  7. 07Passo 3: Instale Skills do skills.shBriefings de especialista reutilizáveis que a IA carrega sob demanda.
  8. 08Passo 4: Crie o Plano do Projeto (Opus, modo Agent)Converse com o Opus para dividir o projeto todo em fases, com um plan prompt pronto pra colar em cada uma. O plano fica no repo como o mapa de tudo que vem depois.
  9. 09Passo 5: Fase 1, a Fundação de Auth (conversa nova)Primeira passada pelo loop. Abra uma conversa nova, planeje com o Opus no modo Plan, clique em Build para o Sonnet executar.
  10. 10Passo 6: Repita o Loop em Cada Fase do MeioMesmo padrão, uma conversa nova por fase. Quantas viagens depende do que o seu PLAN.md gerou.
  11. 11Passo 7: A Fase Final, Review Sênior e ShipÚltima passada pelo loop. Complete a cobertura de testes, faça um review sênior com o Opus e publique na Vercel.
  12. 12Quando as Coisas Saem ErradasUm playbook rápido para as seis falhas que pegam a maioria.
  13. 13Cheat Sheet e Suas Próximas 5 SessõesUma página de referência, mais cinco projetos concretos para continuar praticando.

Prévia grátis

Capítulo 1

O Que Você Vai Construir (e Por Que Vale 90 Minutos)

Um app real publicado, um workflow real e a memória muscular para continuar usando os dois.

Este é um guia para acompanhar fazendo. Abra o Cursor em uma janela, este documento em outra, e construa junto com a gente. No final você vai ter um app no ar em seu-app.vercel.app com:

  • Sign-in com magic link (sem senhas)
  • Todos por usuário: cada um só vê os seus
  • Criar, editar, completar e deletar
  • Filtro de status: todos / ativos / concluídos
  • UI amigável no mobile

O app é pequeno de propósito. O foco é o workflow, não a quantidade de funcionalidades. Depois que você publicar esse, o mesmo workflow escala para qualquer coisa que você construir em seguida.

Orçamento de tempo

Como você lê Tempo
Lê cada prompt, roda cada passo de verificação, questiona a IA quando ela corta atalhos ~90 minutos
Copia e cola, confia no agente, corrige o que quebrar no final ~30 minutos (e você aprende menos)

O que você vai realmente aprender

O app é o artefato. As habilidades são o que fica:

  • Como alternar entre Opus e Sonnet para tarefas diferentes (e por que isso economiza dinheiro)
  • Como usar o modo Plan + o botão Build para o Opus planejar e o Sonnet executar em um clique
  • Como redigir um CLAUDE.md que a IA realmente respeite
  • Como usar .cursor/rules direcionados para orientação por escopo de arquivo
  • Como instalar e usar skills da comunidade no skills.sh
  • Como planejar um projeto no nível certo: um PLAN.md geral dividido em fases, cada uma com um plan prompt pronto para colar que dispara o modo Plan daquela fase
  • Por que você abre uma nova conversa para cada fase (e o que acontece quando não abre)
  • Como debugar rápido com screenshots arrastados direto pro chat
  • Como se recuperar quando o agente sai dos trilhos (vai sair, e tudo bem)
Dica

Se você só tem 30 minutos, faça as seções 1 a 7 hoje e volte para os passos de build amanhã. O trabalho de setup compõe valor. Os passos de build ficam mais fáceis com as camadas de contexto já no lugar.

Capítulo 2

O Que Você Precisa Antes de Começar

Cinco contas, um terminal. Nenhuma custa mais que US$ 20.

Resolva isso antes de abrir o Cursor. Leva ~10 minutos e desbloqueia tudo o que vem depois.

O quê Custo Por que você precisa
Cursor Pro US$ 20/mês A IDE, mais acesso confiável ao Opus 4.7 e ao Sonnet 4.6. A assinatura do Cursor inclui o uso dos modelos; você não faz login com uma conta separada do Claude. O plano Hobby gratuito funciona para parte deste guia, mas limita quanto você pode usar os modelos top. Baixe em cursor.com/get-started.
Node.js 20+ Grátis Necessário para o Next.js 16. Instale via nvm se ainda não tem.
pnpm Grátis O gerenciador de pacotes. npm install -g pnpm se ainda não tem.
Conta no Supabase Grátis Postgres + Auth. Crie um novo projeto antes do Passo 5; o e-mail de confirmação chega enquanto o Cursor faz o scaffold.
Conta na Vercel Grátis Para o deploy no Passo 7. Login com GitHub serve.
Um terminal com o qual você se sente à vontade Grátis iTerm2, Warp, o Terminal nativo do macOS, ou o que você usa.
Dica

Crie o projeto no Supabase agora, antes de começar a codar. Escolha uma senha forte para o banco e salve em um gerenciador de senhas. O e-mail de confirmação do cadastro e a inicialização do projeto rodam enquanto o Cursor está fazendo outras coisas, então você ganha tempo real tirando isso do caminho logo no começo.

Atenção

Se você está no plano Hobby gratuito do Cursor, vai bater nos limites de uso durante os passos de planejamento (o Opus é o modelo caro, e o plano gratuito raciona o uso dele). Você ainda consegue completar o guia, mas espere algumas pausas ou um upgrade no meio do caminho. O Pro é a experiência mais tranquila.

Continue a leitura no PDF

Mais 11 capítulos estão no PDF grátis, com todas as tabelas, modelos e checklists prontos para imprimir.

  1. 03

    Configure o Cursor com Claude

    Cinco minutos de configuração. Você vai se agradecer depois.

    Este guia assume que o Cursor já está instalado. Se não estiver, pegue em cursor.com/get-started e volte. Existem instaladores para macOS, Windows e Linux. O download é grátis; você só precisa de um plano pago se quiser mais uso do…

  2. 04

    Opus para Planejar, Sonnet para Construir

    O hábito mais útil que você vai aprender com este guia.

    Opus e Sonnet são os dois modelos do Claude, treinados pela Anthropic, os dois excelentes. Eles também têm preços bem diferentes e são bons em coisas diferentes. O modelo mental que faz isso funcionar:

  3. 05

    Passo 1: Scaffold do Projeto (Sonnet)

    Tenha um projeto Next.js 16 funcional na sua máquina em 60 segundos.

    Este é o passo fácil. O objetivo é ter uma base limpa antes de empilhar contexto em cima.

  4. 06

    Passo 2: Escreva o CLAUDE.md e os .cursor/rules

    O passo mais importante. Dois arquivos que mudam o comportamento de todo prompt daqui pra frente.

    Este é o passo de engenharia de contexto. Dois arquivos fazem a maior parte do trabalho:

  5. 07

    Passo 3: Instale Skills do skills.sh

    Briefings de especialista reutilizáveis que a IA carrega sob demanda.

    Skills são unidades empacotadas de conhecimento procedural. Enquanto o CLAUDE.md é a constituição do seu projeto (sempre carregada, específica do projeto) e as.cursor/rules são diretrizes cirúrgicas por escopo de arquivo, skills são pacotes reutilizáveis de instruções que a IA carrega…

  6. 08

    Passo 4: Crie o Plano do Projeto (Opus, modo Agent)

    Converse com o Opus para dividir o projeto todo em fases, com um plan prompt pronto pra colar em cada uma. O plano fica no repo como o mapa de tudo que vem depois.

    Essa é a metodologia que separa demos de "a IA construiu um app pra mim" de trabalho de produção real. Pedir para um agente "construa um app de tarefas pra mim" produz um diff enorme, pela metade, que você não…

  7. 09

    Passo 5: Fase 1, a Fundação de Auth (conversa nova)

    Primeira passada pelo loop. Abra uma conversa nova, planeje com o Opus no modo Plan, clique em Build para o Sonnet executar.

    Hora de aplicar o loop do Passo 4. A Fase 1 configura Supabase, auth por magic link e proteção de rota. Quando isso funcionar, toda fase posterior se apoia nisso. Vamos passar por essa fase em detalhe porque é a…

  8. 10

    Passo 6: Repita o Loop em Cada Fase do Meio

    Mesmo padrão, uma conversa nova por fase. Quantas viagens depende do que o seu PLAN.md gerou.

    A Fase 1 está publicada. Agora o loop se repete uma vez para cada fase restante que o seu PLAN.md gerou, exceto a fase final de ship (que cobrimos no Passo 7). Para este app de tarefas são tipicamente de…

  9. 11

    Passo 7: A Fase Final, Review Sênior e Ship

    Última passada pelo loop. Complete a cobertura de testes, faça um review sênior com o Opus e publique na Vercel.

    As fases do meio estão publicadas. Falta uma: a última do seu docs/PLAN.md. Para este app de tarefas, ela é tipicamente a fase "Testes, review, deploy". Passamos por ela explicitamente porque duas das suas sub-tarefas (o review sênior com o…

  10. 12

    Quando as Coisas Saem Erradas

    Um playbook rápido para as seis falhas que pegam a maioria.

    As coisas vão sair erradas. O agente vai se confundir. Um diff vai ser grande demais. Um teste vai passar enquanto a funcionalidade está quebrada. Nada disso significa que você está fazendo errado: significa que você está fazendo tempo suficiente…

  11. 13

    Cheat Sheet e Suas Próximas 5 Sessões

    Uma página de referência, mais cinco projetos concretos para continuar praticando.

    O guia inteiro comprimido numa página só. Imprima, salve no wiki, cole no Slack do time.

Quero o PDF

Sobre o autor

EnzRossi Engineering

Engineering, EnzRossi

Quer pular o processo seletivo?

Já avaliamos mais de 3.000 profissionais. A gente encontra o seu.

Agende uma conversa gratuita de 30 minutos e receba a primeira shortlist em 3 dias.