Devin Desktop (Windsurf) rules: vị trí và cách các tool đọc tệp

Devin Desktop, tên mới của Windsurf kể từ 2026-06-02, đọc các tệp rule trong .devin/rules/ và vẫn hỗ trợ .windsurf/rules/ cùng tệp .windsurfrules cũ. Trigger của mỗi rule quyết định rule luôn được áp dụng, được kích hoạt khi khớp glob, do model chọn hay được gọi thủ công.

Vị trí

• Workspace: .devin/rules/*.md (ưu tiên) hoặc .windsurf/rules/*.md (dự phòng).
• Tệp đơn cũ: .windsurfrules ở thư mục gốc của workspace; tệp này vẫn được đọc.
• Toàn cục: ~/.codeium/windsurf/memories/global_rules.md, luôn được áp dụng.
• AGENTS.md trong bất kỳ thư mục nào.
• Hệ thống (Enterprise): /Library/Application Support/Devin/rules/*.md, /etc/devin/rules/*.md hoặc C:\ProgramData\Devin\rules\*.md.

Định dạng

Markdown; các rule trong workspace bắt đầu bằng YAML frontmatter. trigger là always_on, model_decision, glob hoặc manual; rule glob cần có globs, còn model_decision cần có description. global_rules.md giới hạn ở 6,000 ký tự và mỗi tệp rule trong workspace giới hạn ở 12,000 ký tự.

Các khóa 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.

Thứ tự ưu tiên và hợp nhất

.devin/ được ưu tiên hơn .windsurf/. Rule hệ thống được kết hợp với rule trong workspace và rule toàn cục, không ghi đè chúng; global_rules.md và AGENTS.md ở thư mục gốc luôn được áp dụng. Rule được tìm trong workspace, các thư mục con và thư mục cha cho đến git root.

Các tool đọc tệp này

Mẹo

• Tạo rule mới trong .devin/rules/; chỉ giữ .windsurf/rules/ để tương thích với các bản cài đặt cũ.
• Dùng trigger: model_decision với description rõ ràng cho những hướng dẫn mà agent chỉ nên đưa vào khi phù hợp.
• Memories được tạo tự động chỉ áp dụng cho agent Cascade cũ, không áp dụng cho Devin Local, hiện là mặc định.

Các tệp hướng dẫn khác