Arquivo .cursorrules (Regras do Projeto para IA)

1. Visão geral do conceito e propósito

Ao trabalhar em um projeto junto com a inteligência artificial, você rapidamente notará seus maus hábitos:

• Ela decide de repente instalar uma versão desatualizada de uma biblioteca que não é mais mantida há três anos.
• Ela escreve código em JavaScript em vez de TypeScript estrito.
• Ela inventa sua própria estrutura de pastas, quebrando a arquitetura do seu site.

O arquivo .cursorrules é a lei do seu projeto. É um conjunto conciso de regras em formato de texto simples ou Markdown, que você coloca uma única vez na raiz do projeto. Toda vez que a IA tenta escrever ou modificar qualquer linha de código, ela é obrigada a consultar este arquivo.

Princípio chave de engenharia: a maneira mais simples de manter o código limpo e organizado sem dar lições diárias e tediosas ao modelo.

2. Anatomia do arquivo .cursorrules ideal

Aqui está um template pronto para ser copiado diretamente no seu projeto agora mesmo:

# Stack tecnológico e padrões do projeto
- Linguagem: TypeScript (modo estrito strict: true)
- Framework: Next.js (App Router)
- Estilos: Tailwind CSS (nenhum estilo inline ou CSS puro)
- Banco de dados: Drizzle ORM + PostgreSQL / SQLite

# Regras para o agente:
1. Sempre escreva implementações completas dos arquivos. Nunca deixe comentários preguiçosos como "// ... aqui está o restante do código".
2. Todos os textos voltados ao usuário e botões devem estar em português.
3. Antes de criar um novo pacote npm, verifique se já não existe um equivalente instalado no package.json.
4. Se você identificar um erro na arquitetura — primeiro explique o risco, depois proponha as mudanças.

3. Quatro coisas que você deve proibir absolutamente

1. Proibição de comentários preguiçosos: O pior cenário é quando o modelo apaga o meio do seu código funcional e escreve // ... keep existing code. Estabeleça uma proibição direta contra isso.
2. Fixação de versões de bibliotecas: Especifique, por exemplo: «Use apenas Lucide-React para ícones», para evitar que o modelo importe FontAwesome e HeroIcons simultaneamente.
3. Regras de nomenclatura de componentes: Indique: «Nomes de componentes devem estar em PascalCase, nomes de utilitários — em camelCase».
4. Exigências de tipagem: Proíba o uso do tipo any no TypeScript.

4. Por que isso economiza horas de debug

Graças ao .cursorrules, o modelo se sente desde o primeiro segundo como um desenvolvedor experiente da sua equipe, que conhece perfeitamente os padrões corporativos. Você recebe código que compila de primeira, sem conflitos sintáticos!