Skip to Content

Windsurf rules

Windsurf rules in .devin/rules/ or .windsurf/rules/ inject based on activation mode . GSC showed impressions on /ides/windsurf#rules — this spoke targets that intent.

Hub: Tokenminning in Windsurf.

Activation modes

ModeContext cost
always_on / root AGENTS.mdEvery Cascade message
model_decisionDescription always; full rule on demand
globOnly when matching files touched
manual (@rule-name)Only when you @mention it

Prefer glob and manual over always_on.

Size caps

ScopeCap
Global rules6,000 characters
Workspace rules12,000 characters per file

Do not duplicate the same instructions in rules, AGENTS.md, and .windsurfrules.

AGENTS.md

Use AGENTS.md  for directory-scoped conventions instead of always-on root rules when possible. Same pattern as Devin rules.

vs Memories

Memories  do not consume quota but still add tokens when retrieved. Prefer a Rule or AGENTS.md entry for durable team knowledge.

Checklist

  1. Audit always_on rules — convert to glob where possible
  2. Split oversized rule files under caps
  3. Remove duplicate instructions across config surfaces
  4. @manual rules only when needed this session
Last updated on