Devin Desktop (Windsurf) rules: onde fica e como as ferramentas o leem

Devin Desktop, novo nome do Windsurf desde 2026-06-02, lê arquivos de regras em .devin/rules/ e ainda aceita .windsurf/rules/ e o arquivo legado .windsurfrules. O trigger de cada regra determina se ela está sempre ativa, se é selecionada por glob, pelo modelo ou manualmente.

Onde fica

• Workspace: .devin/rules/*.md (preferencial) ou .windsurf/rules/*.md (alternativa).
• Arquivo único legado: .windsurfrules na raiz do workspace; ele ainda é lido.
• Global: ~/.codeium/windsurf/memories/global_rules.md, sempre ativo.
• AGENTS.md em qualquer diretório.
• Sistema (Enterprise): /Library/Application Support/Devin/rules/*.md, /etc/devin/rules/*.md ou C:\ProgramData\Devin\rules\*.md.

Formato

Markdown; as regras do workspace começam com frontmatter YAML. trigger pode ser always_on, model_decision, glob ou manual; regras glob usam globs, e regras model_decision usam description. global_rules.md tem limite de 6,000 caracteres, e cada arquivo de regra do workspace, de 12,000.

Chaves do frontmatter: triggerglobsdescription

---
trigger: glob
globs: **/*.test.ts
---

# Test files

- Use Vitest and import describe, it and expect explicitly.
- Test one behaviour per case and name it in plain English.
- Mock network calls with the helpers in test/mocks/.
- Never call real payment APIs from a test.

Precedência e combinação

.devin/ tem precedência sobre .windsurf/. As regras do sistema são combinadas com as regras do workspace e globais, sem substituí-las; global_rules.md e o AGENTS.md da raiz estão sempre ativos. As regras são encontradas no workspace, em seus subdiretórios e nos diretórios pais até a raiz do git.

Ferramentas que o leem

Dicas

• Crie novas regras em .devin/rules/; use .windsurf/rules/ apenas em instalações antigas.
• Use trigger: model_decision com uma descrição clara para orientações que o agente deve incluir apenas quando forem relevantes.
• As Memories geradas automaticamente se aplicam apenas ao agente Cascade legado, não ao Devin Local, que agora é o padrão.

Outros arquivos de instruções