Como criar um app com o Cursor
Para criar um app com o Cursor, defina o problema e as telas antes de abrir o editor, escreva as regras do projeto (AGENTS.md ou arquivos em .cursor/rules), use o Plan Mode para tarefas grandes e peça ao agente uma mudança pequena por vez. Revise o diff, rode o app, teste e faça um commit no Git a cada passo que funcionar. O Cursor escreve o código; decidir o que entra e conferir se está certo continua sendo trabalho seu.
Atualizado em · Por Luis Henrique Cuba
O que o Cursor faz e o que fica com você
O Cursor é um editor de código com um agente de IA embutido. No modo Agent, ele lê os arquivos do projeto, edita, cria arquivos novos e roda comandos no terminal. No modo Ask, só responde perguntas sobre o código, sem alterar nada. O Plan Mode pesquisa o projeto, faz perguntas e escreve um plano que você revisa antes de qualquer edição.
Isso tira muito trabalho braçal. O que ele não faz é saber qual problema o app resolve, quais dados são sensíveis ou se o resultado está bom para quem vai usar. Quem pula essa parte costuma terminar com um projeto grande que ninguém entende, nem o agente.
Antes de abrir o editor
- 01
Escreva o problema em duas frases
Quem usa e o que resolve. Exemplo: "A recepção de uma clínica precisa registrar retornos de pacientes e ver quem deve ser chamado na semana."
- 02
Liste telas, dados e regras
Três ou quatro telas, as tabelas principais e as regras que não podem falhar ("cada recepcionista vê só a própria unidade"). Esse texto vira a base do plano.
- 03
Escolha uma pilha conhecida
Prefira tecnologias com muita documentação, como React com Vite ou Next.js e um banco PostgreSQL. O agente acerta mais em terreno comum, e você encontra ajuda quando travar.
- 04
Crie o repositório
Pasta nova, git init e um primeiro commit vazio ou com o esqueleto do projeto. Sem Git, cada erro do agente é mais difícil de desfazer.
Escreva as regras do projeto
Regras são instruções que o agente recebe junto com o pedido. A documentação do Cursor descreve dois formatos para o projeto: um AGENTS.md na raiz, em Markdown simples, ou arquivos .mdc dentro de .cursor/rules, com um cabeçalho que diz quando a regra vale (sempre, por decisão do agente, para certos arquivos ou só quando mencionada com @). Existem também regras de usuário, que valem para todos os seus projetos.
Comece curto. O próprio Cursor recomenda acrescentar regras quando o agente repete o mesmo erro e manter cada arquivo abaixo de 500 linhas. Dá para criar uma regra digitando /create-rule no chat.
# AGENTS.md
## Projeto
App interno para a recepção registrar retornos de pacientes.
Usuários: recepcionistas (veem só a própria unidade) e gerente (vê todas).
## Pilha
- React + Vite + TypeScript
- Supabase (PostgreSQL) com Row Level Security ativado em todas as tabelas
## Regras
- Nunca colocar chaves secretas no front-end nem em variáveis VITE_.
- Toda tabela nova vem com política de acesso por unidade.
- Antes de instalar uma dependência nova, explique por quê.
- Mudanças pequenas: um assunto por vez, sem refatorar o que não foi pedido.
- Depois de editar, rode npm run build e npm test e mostre o resultado.O ciclo de cada tarefa
- 01
Planeje o que for grande
Para algo que mexe em vários arquivos, troque para o Plan Mode (Shift+Tab no campo do chat). Leia o plano, corrija o que estiver errado e só então mande executar.
- 02
Peça uma coisa por vez
"Crie a tabela de retornos com estas colunas" é um bom pedido. "Faça o sistema da clínica" não é. Cite os arquivos envolvidos com @ quando souber quais são.
- 03
Acompanhe o diff
As edições aparecem na visualização de diferenças enquanto o agente trabalha. Se ele tomar um caminho errado, clique em Stop e redirecione. Rejeite o que não pediu.
- 04
Peça uma revisão
Ao final, o botão Review com a opção Find Issues procura problemas nas mudanças. Use como segunda opinião, não como aprovação.
- 05
Rode e teste você mesmo
Abra o app, faça o caminho do usuário, tente o caso errado (campo vazio, outro usuário). Se o projeto tem testes, peça para o agente escrevê-los antes da implementação e confirme que falham primeiro.
- 06
Faça commit
Funcionou, commit com uma mensagem clara. Os checkpoints do Cursor (Restore Checkpoint) desfazem edições do agente dentro da conversa, mas o histórico permanente fica no Git.
- 07
Abra uma conversa nova ao trocar de assunto
Conversas longas misturam contexto antigo e o agente começa a errar mais. Terminou uma unidade de trabalho, comece outra conversa.
Exemplo de sequência de pedidos
1. (Ask) Explique a estrutura de pastas deste projeto e onde ficam as rotas.
2. (Plan) Quero uma tela de lista de retornos da semana, filtrada pela unidade
do usuário logado. Proponha o plano, sem editar ainda.
3. (Agent) Execute só a parte 1 do plano: tabela e política de acesso.
4. (Agent) Agora a consulta e a tela de lista, sem botões de edição.
5. (Agent) Escreva um teste que garanta que uma recepcionista não vê
retornos de outra unidade. Rode e mostre o resultado.Antes de publicar o app
- O arquivo .env está no .gitignore e nenhuma chave secreta aparece no código do navegador.
- O banco tem regras de acesso por usuário, e você testou entrar como um usuário e tentar ver dados de outro.
- npm run build termina sem erros e os testes passam.
- Dependências auditadas (npm audit) e sem pacotes que você não sabe para que servem.
- Você leu os comandos de terminal que o agente executou, principalmente os que apagam arquivos ou mexem no banco.
- Existe backup do banco antes de colocar dados reais.
Como criar um app com o Cursor: dúvidas comuns
Preciso saber programar para criar um app com o Cursor?
Para um protótipo, não muito. Para colocar no ar com dados de clientes, você precisa entender o suficiente para ler um diff, rodar o projeto e perceber quando algo não faz sentido, ou ter alguém que faça essa revisão.
O Cursor é gratuito?
Existe um plano de entrada e planos pagos com mais uso dos modelos. Limites e preços mudam com frequência; confira a página de preços do Cursor antes de decidir.
Qual a diferença entre o modo Ask e o modo Agent?
O Ask só lê e responde, sem alterar arquivos. É bom para entender um projeto que você não escreveu. O Agent edita arquivos e roda comandos. O Plan Mode fica no meio: monta um plano e só edita depois que você aprova.
Tenho um arquivo .cursorrules antigo. Ainda funciona?
A documentação atual descreve as regras em AGENTS.md e em arquivos .mdc dentro de .cursor/rules. Se o projeto usa o formato antigo, vale mover as instruções para um desses dois e conferir se o agente as segue.
Posso continuar no Cursor um app que comecei em outra ferramenta de IA?
Sim, desde que você tenha o código. Exporte para o GitHub, clone no computador e abra a pasta no Cursor. Comece pelo modo Ask, pedindo um resumo da estrutura, antes de pedir mudanças.
Precisa de ajuda para resolver isso na sua empresa?
Respondemos em até 24 horas com as próximas perguntas e uma proposta objetiva.