Tutorial de Cursor e regras do projeto
Regras do projeto
As regras de projeto do Cursor ficam em .cursor/rules como arquivos .mdc. Seus metadados controlam quando são aplicadas. A documentação oficial, conferida em 14 de novembro de 2026, diferencia regras permanentes, regras associadas a arquivos, regras escolhidas por relevância e regras acionadas manualmente.
Uma aplicação fictícia de devoluções precisa de uma regra para seus handlers de API: usar o validador compartilhado e preservar o formato de erro documentado. Limite a instrução aos arquivos desses handlers. Aplicá-la a um documento de design adiciona contexto irrelevante; salvá-la como .md em .cursor/rules não a transforma em uma regra de projeto.
Revisão da alteração
Uma regra carregada corretamente ainda precisa de um resultado verificado. Leia as alterações e execute uma solicitação que percorra o caso de erro. Se o agente removeu o validador compartilhado para fazer um teste passar, a alteração viola a instrução mesmo com um resultado positivo no teste.
Pratique a decisão neste ambiente com respostas preparadas e confira depois as regras ativas na sua versão do Cursor. A comparação com Claude Code explica as diferenças entre os arquivos de instruções.