Devin Desktop (Windsurf) rules: lokasi dan cara tool membacanya

Devin Desktop, nama baru Windsurf sejak 2026-06-02, membaca file aturan dari .devin/rules/ dan tetap menerima .windsurf/rules/ serta file lama .windsurfrules. Pemicu setiap aturan menentukan apakah aturan selalu aktif, dicocokkan berdasarkan glob, dipilih oleh model, atau dipanggil secara manual.

Lokasi

• Workspace: .devin/rules/*.md (disarankan) atau .windsurf/rules/*.md (fallback).
• Satu file lama: .windsurfrules di root workspace, tetap dibaca.
• Global: ~/.codeium/windsurf/memories/global_rules.md, selalu aktif.
• AGENTS.md di direktori mana pun.
• Sistem (Enterprise): /Library/Application Support/Devin/rules/*.md, /etc/devin/rules/*.md atau C:\ProgramData\Devin\rules\*.md.

Format

Markdown; aturan workspace diawali frontmatter YAML. trigger bernilai always_on, model_decision, glob atau manual; aturan glob menggunakan globs, sedangkan aturan model_decision menggunakan description. global_rules.md dibatasi hingga 6,000 karakter dan setiap file aturan workspace hingga 12,000 karakter.

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

Prioritas dan penggabungan

.devin/ lebih diutamakan daripada .windsurf/. Aturan sistem digabungkan dengan aturan workspace dan global tanpa menimpanya; global_rules.md dan AGENTS.md di root selalu aktif. Aturan ditemukan di workspace, subdirektorinya, dan direktori induk hingga root git.

Tool yang membacanya

Tips

• Buat aturan baru di .devin/rules/; gunakan .windsurf/rules/ hanya untuk instalasi lama.
• Gunakan trigger: model_decision dengan description yang jelas untuk panduan yang hanya perlu dimuat agen saat relevan.
• Memories yang dibuat otomatis hanya berlaku untuk agen Cascade lama, bukan Devin Local, yang kini menjadi default.

File instruksi lainnya