> ## Documentation Index
> Fetch the complete documentation index at: https://docs.windsurf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Memórias e Regras

> Configure `Memories` e regras do Cascade para manter o contexto entre conversas, com regras globais, regras de workspace e regras em nível de sistema para Enterprise.

`Memories` é o sistema para compartilhar e manter contexto entre conversas.

Há dois mecanismos para isso no Cascade: Memories, que podem ser geradas automaticamente pelo Cascade, e regras, que são definidas manualmente pelo usuário nos níveis local e global.

<div id="how-to-manage-memories">
  ## Como gerenciar Memories
</div>

Memories e Rules podem ser acessadas e configuradas a qualquer momento clicando no ícone `Customizations` no menu deslizante no canto superior direito do Cascade. Para editar uma Memory existente, basta clicar nela e depois clicar no botão `Edit`.

<Frame>
  <img src="https://mintcdn.com/codeium/d8O4q6w3H2CjrirL/assets/managing-memories-jb.gif?s=364abea59051eb01f19dbe91ba7bcf35" width="800" height="506" data-path="assets/managing-memories-jb.gif" />
</Frame>

<div id="memories">
  ## Memórias
</div>

Durante a conversa, o Cascade pode gerar e armazenar memórias automaticamente quando encontrar um contexto que considere útil lembrar.

Além disso, você pode pedir ao Cascade para criar uma memória a qualquer momento. Basta solicitar ao Cascade: "crie uma memória de ...".

As memórias geradas automaticamente pelo Cascade estão associadas ao workspace em que foram criadas, e o Cascade as recuperará quando considerar que são relevantes. As memórias geradas em um workspace não ficam disponíveis em outro.

<Tip>Criar e usar memórias geradas automaticamente NÃO consome créditos</Tip>

<div id="rules">
  ## Regras
</div>

Os usuários podem definir explicitamente suas próprias regras para o Cascade seguir.

As regras podem ser definidas no nível global ou no nível do workspace.

`global_rules.md` - regras aplicadas a todos os workspaces

`.windsurf/rules` - diretório no nível do workspace que contém regras associadas a globs ou descrições em linguagem natural.

<div id="rules-discovery">
  ## Descoberta de regras
</div>

O Windsurf descobre automaticamente regras em vários locais para oferecer uma organização flexível:

* **Workspace atual e subdiretórios**: Todos os diretórios `.windsurf/rules` dentro do seu workspace atual e de seus subdiretórios
* **Estrutura do repositório Git**: Em repositórios Git, o Windsurf também pesquisa até o diretório raiz do Git para encontrar regras em diretórios pai
* **Suporte a múltiplos workspaces**: Quando várias pastas estão abertas no mesmo workspace, as regras são deduplicadas e exibidas com o caminho relativo mais curto

<div id="rules-storage-locations">
  ### Locais de armazenamento de regras
</div>

As regras podem ser armazenadas em qualquer um destes locais:

* `.windsurf/rules` no diretório do seu workspace atual
* `.windsurf/rules` em qualquer subdiretório do seu workspace
* `.windsurf/rules` em diretórios pai até a raiz do Git (para repositórios Git)

Ao criar uma nova regra, ela será salva no diretório `.windsurf/rules` do seu workspace atual, não necessariamente na raiz do Git.

Para começar a usar Rules, clique no ícone `Customizations` no menu deslizante no canto superior direito do Cascade e vá até o painel `Rules`. Lá, você pode clicar no botão `+ Global` ou `+ Workspace` para criar novas regras nos níveis global ou de workspace, respectivamente.

<Tip>Você pode encontrar modelos de regras de exemplo, selecionados pela equipe da Windsurf, em [https://windsurf.com/editor/directory](https://windsurf.com/editor/directory) para ajudar você a começar.</Tip>

Os arquivos de regras são limitados a 12.000 caracteres cada.

<div id="best-practices">
  ### Melhores práticas
</div>

Para ajudar o Cascade a seguir suas regras com eficácia, siga estas melhores práticas:

* Mantenha as regras simples, concisas e específicas. Regras muito longas ou vagas podem confundir o Cascade.
* Não é necessário adicionar regras genéricas (por exemplo, “escreva um bom código”), pois isso já faz parte dos dados de treinamento do Cascade.
* Formate suas regras usando marcadores, listas numeradas e Markdown. Isso é mais fácil para o Cascade seguir do que um parágrafo longo.

Por exemplo:

```
# Diretrizes de Codificação
- A linguagem de programação do meu projeto é Python
- Use retornos antecipados quando possível
- Sempre adicione documentação ao criar novas funções e classes
```

* As tags XML podem ser uma forma eficaz de comunicar e agrupar regras semelhantes. Por exemplo:

```
<coding_guidelines>
- A linguagem de programação do meu projeto é Python
- Use retornos antecipados quando possível
- Sempre adicione documentação ao criar novas funções e classes
</coding_guidelines>
```

<div id="system-level-rules-enterprise">
  ## Regras em Nível de Sistema (Enterprise)
</div>

Organizações Enterprise podem definir regras em nível de sistema que se aplicam globalmente a todos os workspaces e não podem ser modificadas por usuários finais sem permissão de administrador. Isso é ideal para aplicar padrões de código em toda a organização, políticas de segurança e requisitos de conformidade.

As regras em nível de sistema são carregadas a partir de diretórios específicos do sistema operacional:

**macOS:**

```
/Library/Application Support/Windsurf/rules/*.md
```

**Linux/WSL:**

```
/etc/windsurf/rules/*.md
```

**Windows:**

```
C:\ProgramData\Windsurf\rules\*.md
```

Coloque os arquivos de regra (em arquivos `.md`) no diretório apropriado para o seu sistema operacional. O sistema carregará automaticamente todos os arquivos `.md` desses diretórios.

<div id="how-system-rules-work">
  ### Como funcionam as regras de sistema
</div>

As regras em nível de sistema são mescladas com as regras de workspace e globais, fornecendo contexto adicional ao Cascade sem substituir as regras definidas pelo usuário. Isso permite que as organizações estabeleçam padrões de base, ao mesmo tempo em que permitem que as equipes adicionem customizações específicas de projeto.

Na interface do Cascade, as regras em nível de sistema são exibidas com o rótulo "System" e não podem ser excluídas pelos usuários finais.

<Note>
  **Importante**: As regras em nível de sistema devem ser gerenciadas pela sua equipe de TI ou segurança. Certifique-se de que suas equipes internas lidem com implantação, atualizações e conformidade de acordo com as políticas da sua organização. Você pode usar ferramentas e fluxos de trabalho padrão, como Mobile Device Management (MDM) ou Configuration Management para fazer isso.
</Note>
