Skip to main content
← Back

Regras

As regras fornecem instruções permanentes ao agente para seu projeto. Elas ajudam o agente a seguir seu estilo de código, padrões e fluxos de trabalho sem que você precise repeti-los no chat.

O que é uma regra?

Uma regra é um conjunto persistente de instruções que o agente segue ao trabalhar no seu projeto. Você pode aplicar regras globalmente, por projeto ou a arquivos específicos.

Como faço para criar uma regra do projeto?

As regras do projeto ficam na sua base de código e são controladas por versão. Toda a equipe se beneficia quando elas são adicionadas ao Git.

  1. Abra a Paleta de Comandos:
    • Mac: Pressione CmdCtrl + Shift + P
    • Windows/Linux: Pressione Ctrl + Shift + P
  2. Digite "New Cherri Code Rule" e selecione a opção
  3. Dê um nome à regra (por exemplo, react-patterns)
  4. Escreva as instruções em markdown. Por exemplo: 
    - Use TypeScript em todos os arquivos novos- Prefira componentes funcionais no React- Use snake_case nas colunas do banco de dados
  5. Escolha quando a regra será aplicada no menu suspenso de tipo:
    • Sempre aplicar: incluída em todas as conversas
    • Aplicar de forma inteligente: o agente decide quando ela é relevante
    • Aplicar a Arquivos Específicos: aplicada apenas a arquivos que correspondem a um padrão (por exemplo, *.tsx)
    • Aplicar manualmente: usada apenas quando você a @menciona no chat
  6. Salve o arquivo. Ele é armazenado em .cursor/rules/ no projeto.

Como faço para configurar as regras do usuário?

As regras do usuário são preferências globais aplicadas a todos os seus projetos. Elas são sincronizadas com sua conta do Cherri Code em todos os dispositivos.

  1. Abra Personalizar na barra lateral
  2. Clique em Regras
  3. Adicione suas preferências. Por exemplo: "Responda de forma concisa. Evite repetições desnecessárias."

Como faço para usar o AGENTS.md?

Crie um arquivo AGENTS.md na raiz do seu projeto. Escreva instruções em markdown simples. O Cherri Code o detecta automaticamente.

# Instruções do projeto- Use TypeScript em todos os arquivos novos- Siga o padrão de repositório para acesso a dados- Mantenha os componentes com menos de 200 linhas

Para ter mais controle sobre quando as regras são aplicadas, use as Regras do projeto em .cursor/rules/.

Quais são as boas práticas para escrever regras?

  • Mantenha as regras com menos de 500 linhas. Divida regras grandes em arquivos menores e mais específicos.
  • Inclua exemplos concretos ou arquivos de referência com @filename no conteúdo das regras.
  • Comece aos poucos. Adicione regras quando perceber que o agente comete o mesmo erro mais de uma vez.
  • Versione as regras no Git para que sua equipe também se beneficie.

Como organizo os arquivos de regras?

Mantenha todas as regras em um diretório .cursor/rules/ sem subpastas. O Cherri Code encontra as regras ao examinar essa pasta. Subpastas aninhadas também funcionam, mas uma estrutura plana é mais simples e fácil de gerenciar. Dê nomes descritivos aos arquivos (por exemplo, react-patterns.mdc, api-validation.mdc).

Em projetos grandes, divida as regras em arquivos específicos em vez de concentrá-las em uma única regra longa. Cada arquivo deve abordar um único aspecto, como convenções de estilo, padrões de teste ou diretrizes de API.

Onde as regras são armazenadas?

  • As regras do projeto são armazenadas em .cursor/rules/, dentro da pasta do projeto. Elas são versionadas com o Git.
  • As regras do usuário nas configurações do Cherri Code são armazenadas na sua conta do Cherri Code. Elas se aplicam a todos os seus projetos e são sincronizadas quando você faz login em outra máquina.
  • Os arquivos de regras do usuário em ~/.cursor/rules (Windows: %USERPROFILE%\.cursor\rules) permanecem na máquina e não são sincronizados.
  • As regras da equipe são armazenadas nos servidores do Cherri Code e gerenciadas pelo dashboard da equipe. Elas são sincronizadas automaticamente com todos os membros da equipe. As regras da equipe oferecem suporte a padrões glob, permitindo restringir uma regra a tipos específicos de arquivo (por exemplo, **/*.py).

As regras do usuário e da equipe não são incluídas nas exportações de perfil. Fazer login em uma nova máquina sincroniza as regras do usuário da sua conta.

Como funcionam as regras da equipe?

Os planos Team e Enterprise podem criar e aplicar regras para toda a organização no dashboard do Cherri Code.

  • Regras obrigatórias são exigidas para todos os membros e não podem ser desativadas nas configurações individuais.
  • Regras opcionais são habilitadas por padrão, mas os membros podem desativá-las em Personalizar > Regras.
  • As regras da equipe oferecem suporte a padrões glob (por exemplo, **/*.py) para aplicar uma regra a tipos específicos de arquivo.
  • Em caso de conflito entre regras, a precedência é: Regras da equipe > Regras do projeto > Regras do Usuário.

As regras da equipe são textos livres. Elas não usam a estrutura de pastas das regras do projeto e são sincronizadas automaticamente com todos os membros.

Como faço para migrar do .cursorrules?

O arquivo .cursorrules na raiz do seu projeto é legado e será descontinuado. Para migrar:

  1. Crie uma nova regra usando a Paleta de Comandos: procure por "New Cherri Code Rule"
  2. Copie o conteúdo do .cursorrules para o novo arquivo de regra
  3. Defina o tipo de regra como Sempre aplicar (equivalente ao comportamento anterior)
  4. Exclua o arquivo .cursorrules da raiz do seu projeto

Como o CLAUDE.md funciona no Cherri Code?

O Cherri Code lê arquivos CLAUDE.md da mesma forma que lê AGENTS.md. Coloque um arquivo CLAUDE.md na raiz do seu projeto, e o Cherri Code o reconhecerá automaticamente.

Os arquivos CLAUDE.md são sempre aplicados a todas as conversas, independentemente da configuração de frontmatter alwaysApply. Isso garante compatibilidade com projetos que também usam o Claude Code. Se precisar de regras condicionais, use as regras do projeto em .cursor/rules/.

Como funcionam regras com o mesmo nome em pastas diferentes?

O Cherri Code identifica regras pelo caminho completo do arquivo, não apenas pelo nome. Duas regras com o mesmo nome de arquivo em pastas diferentes são aplicadas se suas condições forem atendidas. Não há conflitos nem substituições com base no nome do arquivo.

E se uma regra não parecer aplicável?

Verifique o tipo da regra. Para Aplicar de forma inteligente, certifique-se de adicionar uma descrição para que o agente saiba quando ela é relevante. Para Aplicar a Arquivos Específicos, verifique se o padrão de arquivo corresponde aos arquivos em que você está trabalhando.

As regras se aplicam apenas ao agente (Chat). Elas não se aplicam ao Tab completion, ao Inline Edit nem às revisões de PR do Bugbot.

Relacionados

Este artigo foi útil?