Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

Memories é o sistema que compartilha e mantém o contexto entre conversas. No Devin Desktop, há dois mecanismos para isso: Memories, geradas automaticamente pelo Cascade, e Rules, definidas manualmente pelo usuário no nível global, de workspace ou de sistema.

​
Memories, Rules, Workflows ou Skills?

O Devin Desktop oferece várias formas de personalizar o Cascade. Use esta tabela para escolher a opção certa:
RecursoO que fazComo é ativadoQuando usar
RulesDizem ao Cascade como se comportar (ex.: “use bun, não npm”)always_on, glob, model_decision ou manual (veja abaixo)Convenções de código, guias de estilo, restrições do projeto
AGENTS.mdRules com escopo por localização, sem configuraçãoAutomático — raiz = always-on, subdiretório = globConvenções específicas de diretório sem frontmatter
WorkflowsTemplates de prompt para tarefas repetíveis com várias etapasSomente manual via slash command /[workflow-name]Implantações, revisões de PR, checklists de release
SkillsProcedimentos com várias etapas agrupados com arquivos de suporte (scripts, templates)Invocados dinamicamente pelo modelo ou por @mentionTarefas complexas em que o Cascade precisa de arquivos de referência — vale a pena investir aqui
MemoriesContexto que o Cascade gera automaticamente durante as conversasRecuperação automática quando relevanteDeixe o Cascade lembrar fatos pontuais; para conhecimento duradouro, prefira Rules ou AGENTS.md
Recomendação: Para conhecimento que você quer que o Cascade reutilize com confiabilidade, escreva-o como uma Rule ou adicione-o ao AGENTS.md no seu repo, em vez de depender de Memories geradas automaticamente. Rules ficam em controle de versão, podem ser compartilhadas com sua equipe e dão a você controle explícito sobre a ativação.

​
Como gerenciar Memories

Memories e Rules podem ser acessados e configurados a qualquer momento clicando no ícone Personalização no menu lateral no canto superior direito do Cascade ou em “Windsurf - Configurações”, no canto inferior direito. Para editar uma memória existente, basta clicar nela e depois clicar no botão Edit.

​
Memories

Durante uma 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 pedir ao Cascade para “criar uma memory de …”. As memories geradas automaticamente pelo Cascade são associadas ao workspace em que foram criadas e 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 comitadas no seu repositório.
Criar e usar memories geradas automaticamente NÃO consome créditos.
As memories geradas automaticamente ficam 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 em .windsurf/rules/ ou no AGENTS.md do seu repo.

​
Rules

Os usuários podem definir explicitamente suas próprias Rules para o Cascade seguir. As Rules podem ser definidas no nível global, do workspace ou do sistema, e também podem ser inferidas de arquivos AGENTS.md.
EscopoLocalizaçãoObservações
Global~/.codeium/windsurf/memories/global_rules.mdArquivo único, aplicado em todos os workspaces. Sempre ativo. Limitado a 6.000 caracteres.
Workspace.windsurf/rules/*.mdUm arquivo por Rule, cada um com seu próprio modo de ativação. Limitado a 12.000 caracteres por arquivo.
AGENTS.mdQualquer diretório no seu workspaceProcessado pelo mesmo mecanismo de Rules — nível raiz = sempre ativo; subdiretório = auto-glob para esse diretório.
Sistema (Enterprise)Específico do SO (por exemplo, /etc/windsurf/rules/)Implantado pela TI, somente leitura para usuários finais.

​
Descoberta de Rules

O Devin Desktop descobre automaticamente Rules em vários locais para oferecer uma organização flexível:
  • workspace atual e subdiretórios: Todos os diretórios .windsurf/rules dentro do workspace atual e dos respectivos subdiretórios
  • Estrutura do repositório Git: Para repositórios Git, o Devin Desktop também procura até o diretório raiz do Git para encontrar Rules em diretórios pai
  • Suporte a múltiplos workspaces: Quando várias pastas estão abertas no mesmo workspace, as Rules são deduplicadas e exibidas com o caminho relativo mais curto

​
Locais de armazenamento de Rules

As Rules 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 Rule, 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 Personalização no menu lateral superior direito do Cascade e, em seguida, acesse o painel Rules. Ali, você pode clicar no botão + Global ou + Workspace para criar novas Rules no nível global ou no nível do workspace, respectivamente.
Você pode encontrar templates de Rules de exemplo selecionados pela equipe do Devin Desktop em https://windsurf.com/editor/directory para ajudar você a começar.
Os arquivos de Rules do workspace são limitados a 12.000 caracteres cada. O arquivo global de Rules é limitado a 6.000 caracteres.

​
Modos de ativação

Cada regra de 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:
ModoValor de trigger:Como chega ao CascadeCusto de contexto
Sempre ativaalways_onO conteúdo completo da regra é incluído no prompt do sistema em todas as mensagens.Todas as mensagens
Decisão do modelomodel_decisionApenas a description é exibida 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
GlobglobA 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
ManualmanualA regra não fica no prompt do sistema. Você a ativa digitando @rule-name na caixa de entrada do Cascade.Somente quando mencionada com @
O arquivo de regras globais (global_rules.md) e os arquivos AGENTS.md no nível raiz não usam frontmatter — eles ficam sempre ativos.
Exemplo de regra de workspace com frontmatter: 
---
trigger: glob
globs: **/*.test.ts
---

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

​
Boas práticas

Para ajudar o Cascade a seguir suas regras com eficácia, siga estas boas práticas:
  • Mantenha as regras simples, concisas e específicas. Regras muito longas ou vagas podem confundir o Cascade.
  • N’ao é 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 com marcadores, listas numeradas e Markdown. Esses formatos são mais fáceis 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 forma 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>

​
Rules de Nível de Sistema (Enterprise)

As organizações Enterprise podem implementar rules de nível de sistema que se aplicam globalmente a todos os workspaces e não podem ser modificadas por usuários finais sem permissões de administrador. Isso é ideal para impor padrões de codificação em toda a organização, políticas de segurança e requisitos de conformidade. As rules de nível de sistema são carregadas 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 rules (em formato .md) no diretório apropriado para o seu sistema operacional. O sistema carregará automaticamente todos os arquivos .md desses diretórios.

​
Como funcionam as Rules de nível de sistema

As rules de nível de sistema são mescladas com as rules do workspace e as rules globais, fornecendo contexto adicional ao Cascade sem substituir as rules definidas pelo usuário. Isso permite que as organizations estabeleçam padrões base, ao mesmo tempo que permite que as equipes adicionem personalizações específicas de cada projeto. Na Devin Desktop UI, as rules de nível de sistema são exibidas com o rótulo “System” e não podem ser excluídas pelos usuários finais.
Importante: As rules de nível de sistema devem ser gerenciadas pela sua equipe de TI ou de segurança. Certifique-se de 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 fluxos de trabalho padrão, como Mobile Device Management (MDM) ou Configuration Management, para isso.