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

# Memórias & Regras

> Configure as memórias e regras do Cascade para preservar o contexto entre conversas com regras globais, regras do workspace e regras de nível de sistema para Enterprise.

`Memories` é o sistema de compartilhamento e persistência de contexto entre conversas.

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

<div id="how-to-manage-memories">
  ## Como gerenciar memórias
</div>

As memórias e as regras podem ser acessadas e configuradas a qualquer momento clicando no ícone `Personalização` no menu deslizante no canto superior direito do Cascade. Para editar uma memória existente, basta clicar nela e depois no botão `Edit`.

<Frame>
  <img src="https://mintcdn.com/cognitionai/-PTA3zzo2bR9Qfc8/desktop/assets/managing-memories-jb.gif?s=88e9c5c87919fdf7768141c1a9d15137" width="800" height="506" data-path="desktop/assets/managing-memories-jb.gif" />
</Frame>

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

Durante a conversa, Cascade pode gerar e armazenar memórias automaticamente se encontrar algum contexto que considere útil guardar.

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 são associadas ao workspace em que foram criadas, e o Cascade as recuperará quando considerar que são relevantes. Memórias geradas em um workspace não estarão disponíveis em outro.

<Tip>Criar e usar memórias geradas automaticamente NÃO consomem 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 em 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 as regras em vários locais para oferecer uma organização flexível:

* **workspace atual e subdiretórios**: Todos os diretórios `.windsurf/rules` no workspace atual e em seus subdiretórios
* **Estrutura do repositório Git**: Em repositórios Git, o Windsurf também procura até o diretório raiz do Git para encontrar regras nos 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` nos 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 regras, clique no ícone `Personalizações` no menu deslizante no canto superior direito do Cascade e, em seguida, vá para o painel `Rules`. Lá, você pode clicar no botão `+ Global` ou `+ Workspace` para criar novas regras no nível global ou do workspace, respectivamente.

<Tip>Você pode encontrar templates 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>

Cada arquivo de regras é limitado a 12000 caracteres.

<div id="best-practices">
  ### Práticas recomendadas
</div>

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

* 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á está incorporado aos dados de treinamento do Cascade.
* Formate suas regras usando listas com marcadores, listas numeradas e markdown. Isso é mais fácil para o Cascade seguir do que um parágrafo longo.

Por exemplo:

```
# Coding Guidelines 
- My project's programming language is python
- Use early returns when possible
- Always add documentation when creating new functions and classes
```

* Tags XML podem ser uma maneira eficaz de comunicar e agrupar regras semelhantes. Por exemplo:

```
<coding_guidelines>
- My project's programming language is python
- Use early returns when possible
- Always add documentation when creating new functions and classes
</coding_guidelines>
```

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

As organizações Enterprise podem configurar regras de nível de sistema que se aplicam globalmente a todos os workspaces e não podem ser modificadas pelos usuários finais sem permissões de administrador. Isso é ideal para impor padrões de codificação, políticas de segurança e requisitos de conformidade em toda a organização.

As regras de 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 seus arquivos de regras (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 nível de sistema
</div>

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

Na UI do Cascade, as regras de 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 de nível de sistema devem ser gerenciadas pela sua equipe de TI ou de segurança. Garanta que suas equipes internas cuidem da implantação, das atualizações e da conformidade de acordo com as políticas da sua organização. Você pode usar ferramentas e workflows padrão, como Mobile Device Management (MDM) ou Configuration Management, para isso.
</Note>
