Skip to main content

Best Practices

Neste capítulo, vamos explorar as melhores práticas para tirar máximo proveito do Cursor, incluindo dicas avançadas e padrões comprovados.

Organização de Rules​

Estrutura Recomendada​

.cursor/rules/
├── architecture/
│   ├── frontend-standards.mdc
│   └── api-standards.mdc
├── code-style/
│   ├── typescript.mdc
│   └── react-components.mdc
└── workflows/
    ├── testing.mdc
    └── documentation.mdc

Princípios​

  • Modularidade: Rules pequenas e focadas
  • Organização: Agrupe por categoria
  • Reutilização: Evite duplicação
  • Documentação: Explique o "porquê"

Criação de Commands​

Estrutura Recomendada​

.cursor/commands/
├── development/
│   ├── setup-feature.md
│   └── create-component.md
├── quality/
│   ├── code-review.md
│   └── security-audit.md
└── maintenance/
    ├── update-dependencies.md
    └── refactor-code.md

Princípios​

  • Clareza: Instruções específicas e acionáveis
  • Checklists: Facilite seguir o processo
  • Contexto: Explique quando usar
  • Atualização: Revise regularmente

Uso de Agents​

Quando Usar Agents​

✅ Use Agents para:

  • Tarefas complexas com múltiplos passos
  • Refatorações que afetam múltiplos arquivos
  • Configuração de ambientes
  • Migrações e atualizações

❌ Não use Agents para:

  • Tarefas muito simples (use autocomplete)
  • Edições muito específicas (use inline edit)
  • Quando precisa de controle total manual

Dicas de Prompts​

✅ BOM:

Crie um componente UserCard que:
- Recebe props: name, email, avatar (todos opcionais)
- Usa TypeScript com interface explícita
- Estiliza com Tailwind seguindo design system
- Inclui testes unitários com Jest
- Segue padrão de componentes do projeto

❌ RUIM:

Crie um componente de usuário

Validação​

Sempre valide o que Agents criam:

  1. Revise código: Verifique se faz sentido
  2. Execute testes: Garanta que funciona
  3. Teste manualmente: Valide comportamento
  4. Use checkpoints: Restaure se necessário

Trabalhando com Rules​

Escrevendo Rules Eficazes​

✅ BOM:

---
description: "Padrões para componentes React"
globs: ["**/*.tsx"]
---

# React Component Standards

Componentes devem:
- Ser funcionais (não classes)
- Usar TypeScript com props tipadas
- Seguir naming: PascalCase
- Estar em arquivos separados
- Ter no máximo 200 linhas

Estrutura esperada:
```tsx
interface Props {
  // props aqui
}

export function ComponentName({ prop }: Props) {
  // implementação
}

@component-template.tsx


**❌ RUIM:**
```markdown
Seja consistente com React

Aplicação de Rules​

  • Always Apply: Apenas para regras fundamentais
  • Apply Intelligently: Para regras contextuais
  • Apply to Files: Para regras específicas de tipo
  • Apply Manually: Para regras opcionais

Trabalhando com Commands​

Estrutura de Commands​

✅ BOM:

# Code Review Checklist

## Overview
Checklist completo para revisão de código.

## Categories

### Functionality
- [ ] Código funciona como esperado
- [ ] Edge cases tratados
- [ ] Error handling adequado

### Code Quality
- [ ] Código legível
- [ ] Sem duplicação
- [ ] Segue padrões

## Usage
Use este comando ao revisar PRs:
/code-review [contexto adicional]

❌ RUIM:

Revise código

Parâmetros​

Sempre permita contexto adicional:

/code-review Foque em segurança do endpoint /api/users

O Command deve ser flexível o suficiente para aceitar contexto.

Integração de Ferramentas​

Combinando Agents + Rules + Commands​

Padrão Recomendado:

  1. Rules definem padrões e convenções
  2. Commands definem workflows usando Rules
  3. Agents executam tarefas seguindo Rules e Commands

Exemplo:

Rule: Padrões de API
Command: /setup-feature
Agent: Executa seguindo Rule e Command

Workflow Completo​

# 1. Rules definem padrões
.cursor/rules/api-standards.mdc

# 2. Command define workflow
.cursor/commands/setup-feature.md

# 3. Agent executa
/setup-feature Criar endpoint de usuários

Performance e Eficiência​

Otimização de Rules​

  • Mantenha curtas: Rules muito longas são menos efetivas
  • Seja específico: Instruções claras são mais eficientes
  • Use referências: @filename é melhor que copiar código

Otimização de Commands​

  • Checklists: Facilite seguir o processo
  • Estrutura clara: Organize por categorias
  • Contexto: Explique quando usar

Otimização de Agents​

  • Seja específico: Prompts claros são mais eficientes
  • Quebre tarefas: Tarefas menores são mais gerenciáveis
  • Valide incrementalmente: Revise durante execução

Colaboração em Time​

Compartilhamento​

  • Version controle: Mantenha Rules e Commands no Git
  • Documentação: Explique propósito e uso
  • Onboarding: Inclua Rules e Commands no onboarding

Padronização​

  • Team Rules: Use para padrões organizacionais
  • Team Commands: Use para workflows do time
  • Revisão: Revise e melhore regularmente

Troubleshooting​

Rules Não Aplicando​

Problema: Rule não está sendo aplicada

Soluções:

  • Verifique alwaysApply e globs
  • Confirme que descrição está clara
  • Teste aplicação manual com @rule-name

Commands Não Aparecendo​

Problema: Command não aparece ao digitar /

Soluções:

  • Verifique localização (.cursor/commands/)
  • Confirme formato Markdown correto
  • Reinicie Cursor se necessário

Agents Não Executando​

Problema: Agent não executa tarefa corretamente

Soluções:

  • Seja mais específico no prompt
  • Verifique se Rules relevantes estão aplicadas
  • Use checkpoints para restaurar se necessário

Artigos Relacionados​

Para ver exemplos práticos de best practices em ação:

Conclusão​

Estas best practices ajudam a tirar máximo proveito do Cursor. A chave é:

  1. Organização: Estrutura clara e modular
  2. Especificidade: Instruções claras e acionáveis
  3. Integração: Combine ferramentas para máximo efeito
  4. Validação: Sempre revise e valide resultados
  5. Iteração: Melhore baseado em uso

No próximo capítulo, vamos explorar segurança ao usar Cursor Agents.

Próximo: Segurança com Cursor Agents