> ## 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.

# Memories & Rules

> Mantenha o contexto entre conversas no Cascade com memories geradas automaticamente e Rules definidas pelo usuário nos níveis global, de workspace e de sistema para equipes Enterprise.

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

Há dois mecanismos para isso no Windsurf: **Memories**, que são geradas automaticamente pelo Cascade, e **Rules**, que são definidas manualmente pelo usuário no nível global, de workspace ou de sistema.

<div id="memories-rules-workflows-or-skills">
  ## Memories, Rules, Workflows ou Skills?
</div>

O Windsurf oferece várias formas de personalizar o Cascade. Use esta tabela para escolher a mais adequada:

| Recurso                                            | O que faz                                                                             | Como é ativado                                                                       | Quando usar                                                                                     |
| -------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------- |
| **[Rules](#rules)**                                | Diz ao Cascade *como se comportar* (por exemplo, "use bun, não npm")                  | `always_on`, `glob`, `model_decision` ou `manual` ([veja abaixo](#activation-modes)) | Convenções de código, guias de estilo, restrições do projeto                                    |
| **[AGENTS.md](/pt-BR/windsurf/cascade/agents-md)** | Regras com escopo por localização, sem configuração                                   | Automático — raiz = sempre ativo, subdiretório = glob                                | Convenções específicas de diretório sem frontmatter                                             |
| **[Workflows](/pt-BR/windsurf/cascade/workflows)** | Templates de prompt para tarefas repetíveis de várias etapas                          | **Somente manualmente** via comando slash `/[workflow-name]`                         | Implantações, revisões de PR, checklists de release                                             |
| **[Skills](/pt-BR/windsurf/cascade/skills)**       | Procedimentos de várias etapas empacotados com arquivos de apoio (scripts, templates) | Invocados dinamicamente pelo modelo, ou por `@mention`                               | Tarefas complexas em que o Cascade precisa de arquivos de referência — **vale investir aqui**   |
| **[Memories](#memories)**                          | Contexto que o Cascade gera automaticamente durante as conversas                      | Recuperação automática quando relevante                                              | Deixe o Cascade lembrar fatos pontuais; para conhecimento duradouro, prefira Rules ou AGENTS.md |

<Tip>
  **Recomendação:** Para conhecimento que você quer que o Cascade reutilize com confiabilidade, escreva isso como uma Rule ou adicione ao `AGENTS.md` no seu repositório, em vez de depender de Memories geradas automaticamente. Rules ficam sob controle de versão, podem ser compartilhadas com a equipe e dão a você controle explícito sobre a ativação.
</Tip>

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

Memories e Rules podem ser acessados e configurados a qualquer momento clicando no ícone `Customizations` no menu deslizante no canto superior direito do Cascade, ou por “Windsurf - Settings” no canto inferior direito. Para editar uma Memory existente, basta clicar nela e depois clicar no botão `Edit`.

<video autoPlay controls muted loop playsInline className="aspect-video" src="https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf/cascade/memories-rules.mp4?fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=2a80ad4bb69460c082c09f9633ab3649" data-path="assets/windsurf/cascade/memories-rules.mp4" />

<div id="memories">
  ## Memories
</div>

Durante a conversa, o Cascade pode gerar e armazenar Memories automaticamente se encontrar um contexto que considere útil lembrar.

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

As Memories geradas automaticamente pelo Cascade ficam associadas ao workspace em que foram criadas e são armazenadas localmente em `~/.codeium/windsurf/memories/`. O Cascade as recupera quando considera que são relevantes. Memories geradas em um workspace não ficam disponíveis em outro, e não são incluídas em commits no seu repositório.

<Tip>Criar e usar Memories geradas automaticamente NÃO consome créditos.</Tip>

<Note>
  Memories geradas automaticamente existem apenas na sua máquina. Se você quiser que o Cascade se lembre de algo de forma duradoura — e compartilhe isso com sua equipe — peça ao Cascade para gravar isso em uma [Rule](#rules) em `.windsurf/rules/` ou no `AGENTS.md` do seu repositório.
</Note>

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

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

As Rules podem ser definidas no nível global, de workspace ou de sistema, e também podem ser inferidas a partir de arquivos [AGENTS.md](/pt-BR/windsurf/cascade/agents-md).

| Escopo                                                 | Localização                                            | Observações                                                                                                                   |
| ------------------------------------------------------ | ------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------- |
| Global                                                 | `~/.codeium/windsurf/memories/global_rules.md`         | Arquivo único, aplicado a todos os workspaces. Sempre ativo. Limitado a 6.000 caracteres.                                     |
| Workspace                                              | `.windsurf/rules/*.md`                                 | Um arquivo por Rule, cada um com seu próprio [modo de ativação](#activation-modes). Limitado a 12.000 caracteres por arquivo. |
| [AGENTS.md](/pt-BR/windsurf/cascade/agents-md)         | Qualquer diretório no seu workspace                    | Processado pelo mesmo mecanismo de Rules — nível raiz = sempre ativo; subdiretório = auto-glob para esse diretório.           |
| [Sistema (Enterprise)](#system-level-rules-enterprise) | Específico do SO (por exemplo, `/etc/windsurf/rules/`) | Implantado pela TI, somente leitura para os usuários finais.                                                                  |

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

Windsurf descobre automaticamente regras em vários locais para oferecer 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**: Para 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 menor caminho relativo

<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)

Quando você cria uma nova regra, ela é 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 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 de workspace são limitados a 12.000 caracteres cada. O arquivo de regras globais é limitado a 6.000 caracteres.

<div id="activation-modes">
  ### Modos de ativação
</div>

Cada regra do workspace declara um modo de ativação no frontmatter por meio do campo `trigger`. Isso controla **quando** o conteúdo da regra é fornecido ao Cascade e **quanto da janela de contexto ele consome**:

| Modo                        | valor de `trigger:` | Como chega ao Cascade                                                                                                                       | Custo de contexto                                     |
| --------------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| **Sempre ativo**            | `always_on`         | O conteúdo completo da regra é incluído no prompt do sistema em todas as mensagens.                                                         | Todas as mensagens                                    |
| **Decisão do modelo de IA** | `model_decision`    | Apenas a `description` é mostrada no prompt do sistema. O Cascade lê o arquivo completo da regra quando decide que a descrição é relevante. | Descrição sempre; conteúdo completo sob demanda       |
| **Glob**                    | `glob`              | A regra é aplicada quando o Cascade lê ou edita um arquivo que corresponde ao padrão `globs` (por exemplo, `*.js`, `src/**/*.ts`).          | Somente quando arquivos correspondentes são acessados |
| **Manual**                  | `manual`            | A regra **não** fica no prompt do sistema. Você a ativa digitando `@rule-name` na caixa de entrada do Cascade.                              | Somente quando mencionada com @                       |

<Note>
  O arquivo de regras globais (`global_rules.md`) e os arquivos `AGENTS.md` no nível raiz não usam frontmatter — ficam sempre ativos.
</Note>

Exemplo de regra de workspace com frontmatter:

```markdown theme={null}
---
trigger: glob
globs: **/*.test.ts
---

All test files must use `describe`/`it` blocks and mock external API calls.
```

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

Para ajudar o Cascade a seguir suas regras com eficácia, adote 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 marcadores, listas numeradas e Markdown. Esse formato é 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
```

* 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 de Sistema (Enterprise)
</div>

Organizações no plano Enterprise podem implantar regras 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 garantir padrões de código em toda a organização, políticas de segurança e requisitos de conformidade.

As regras 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 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 mínimos sem deixar de permitir que as equipes adicionem personalizações específicas de projeto.

Na interface do Windsurf, 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 de segurança. Garanta que suas equipes internas cuidem da 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>