Skip to content
How it learnsFrom coding sessions, reviews, Slack and docs.Only what fitsEach session gets the few rules its task needs.Pull request reviewEvery PR checked against your team’s rules.Keep it trueA gate, conflicts, disputes and stale rules, handled.HandoffsCarry the work to another session or a teammate.SecurityWhat it sends, what it changes and how to leave.
Engineering teamsOne agent or several: what one person learns, every session uses.PR review onlyInstall the GitHub App. Nothing on anyone’s machine.Teams that mix agentsClaude Code, Cursor, Codex and Copilot, the same rules.On your ownYour corrections follow you across repos, machines and agents.Book a call30 minutes with Roei, if you want a hand. Never required.
DocsPricingSign in
Connect your agents →
For teamsOn your ownPR review onlyHow it learnsOnly what fitsPull request reviewKeep it trueSecurityDocsPricingSign inConnect your agents →
Home/Answers

Answers

Ignores its rule file

  • HTML comments in CLAUDE.md
  • "Read AGENTS.md" does not import
  • Antigravity ignores AGENTS.md
  • Windsurf ignores rules

Rule file too long

  • AGENTS.md too long for Codex
  • Antigravity rule size limit
  • Copilot instructions length
  • Cursor rules too long

Rules drift from the code

  • CLAUDE.md and AGENTS.md drift
  • Directory trees in rule files

Share rules across repos and agents

  • Share CLAUDE.md across repos
  • Share AGENTS.md in Codex
  • Copilot org instructions
  • Gemini CLI and AGENTS.md
  • Share Windsurf rules

Memory between sessions

  • Gemini CLI memory

Answers

Windsurf is now Devin Desktop: .devin/rules wins, and only one global_rules.md loads

Published November 18, 2026

If Windsurf seems to ignore a rule, first check whether a .devin/ copy shadows it: Windsurf became Devin Desktop on 2 June 2026, .devin/rules/ is now the preferred location and takes precedence, and when both global_rules.md files exist only .devin/global_rules.md loads. After that, check the rule’s trigger: only always_on rules and AGENTS.md are in every session.

For Windsurf (Devin Desktop). Vendor facts are from the pages linked below, read on November 18, 2026.

Check these, in order

  • Open Customize in the agent sidebar and read the Rules tab: it lists what the agent has loaded.
  • If both .windsurf/global_rules.md and .devin/global_rules.md exist, merge them into the .devin/ one. The .windsurf/ file is skipped.
  • Read each rule’s trigger:. glob loads only on matching files, model_decision only when the agent judges the description relevant, manual only when you invoke it.
  • For a rule that must hold every time, use always_on or put it in AGENTS.md, which is always on.
  • Keep always-on rules short: the docs note they are in every session and cost tokens on every message.
---
trigger: always_on
---
Run pnpm test before every commit.

The numbers

MeasureValueSource
Windsurf renamed Devin Desktop2 June 2026, as an over-the-air updateDevin Desktop FAQ
Rule triggers4: always_on, glob, model_decision, manualDevin Local customizations
Global rules files loaded when both exist1: only .devin/global_rules.mdDevin Local customizations
Public AGENTS.md files on GitHub, which it reads as always-on rules1,142,784Harbor study, 18 Oct 2026

Study figures are weighted estimates from 1,935 CLAUDE.md and 1,970 AGENTS.md files sampled from public GitHub repositories on 18 October 2026, with GitHub's own counts for the totals. Every figure is in the study's CSV, and the method is in the study.

What the docs say

  • Devin Desktop FAQ: On June 2, 2026, Windsurf is becoming Devin Desktop. It still reads existing Windsurf rules; .devin/rules/ is the preferred location and takes precedence, with .windsurf/rules/ kept as a fallback. It also reads AGENTS.md and can import .cursor/rules into .devin/rules/.
  • Devin Local: customizations: AGENTS.md, AGENTS.local.md and AGENT.md are read as always-on rules at the workspace root and in each directory down to the one the agent works in. Rule files in both .devin/rules/ and .windsurf/rules/ load; when both global_rules.md files exist, only .devin/global_rules.md loads.

Where Harbor fits

Harbor has no hooks for this agent. Its MCP server can be added to any MCP client, but then the agent has to decide to call it, which is the same weakness as a file it has to choose to open. If this is your main agent, the free fixes above are the answer today.

Read next

  • Cursor rules, the same trigger model
  • AGENTS.md vs CLAUDE.md, every agent
  • Check a rule file for free
  • Claude Code strips HTML comments from CLAUDE.md, so a rule inside one never loads
  • "Read AGENTS.md" in CLAUDE.md does not load it: put @AGENTS.md on its own line
  • Antigravity CLI skips AGENTS.md in subfolders and drops rule files without a valid trigger
  • Share Windsurf rules across repos with ~/.devin/rules, and with other agents through AGENTS.md
  • Every answer, by agent and problem

Questions

Does Windsurf still read .windsurfrules and .windsurf/rules?

Yes. Devin Desktop imports .windsurf/rules/*.md, .windsurf/global_rules.md and .windsurfrules by default. New rules should go in .devin/rules/, which takes precedence.

Does Windsurf (Devin Desktop) read AGENTS.md?

Yes. AGENTS.md, AGENTS.local.md and AGENT.md are always-on rules, read at the workspace root and in each directory between the root and the one the agent is working in.

What happened to Windsurf memories?

The Devin Desktop FAQ says Devin Local replaces memories and workflows with rules and skills. Anything you relied on as a memory should be written as a rule file or AGENTS.md line.

How do I see which rules Windsurf loaded?

Click Customize in the agent sidebar. The Rules tab lists what the agent has loaded, beside what your repository, organization and account offer.

Your team’s rules, in every agent, checked on every PR.

Harbor is shared memory for your team’s Claude Code, Cursor, Codex and Copilot. Free for you and one teammate. No card. No end date.

Start free →

Product

  • How it learns
  • Only what fits
  • Pull request review
  • Keep it true
  • Handoffs
  • The result
  • Security
  • For coding agents
  • Pricing

Developers

  • Docs
  • Quickstart
  • Install
  • CLI
  • MCP server
  • Served and cited
  • Rule-file checker
  • Blog

Guides

  • Why Claude ignores CLAUDE.md
  • AGENTS.md vs CLAUDE.md
  • Share Claude Code memory with a team
  • Why Codex ignores AGENTS.md
  • Why Cursor ignores rules
  • Copilot instructions vs AGENTS.md
  • Shared memory across agents
  • Copilot Memory and Dreaming

Compare

  • All comparisons
  • vs Mem0
  • vs Zep
  • vs Unblocked
  • vs ByteRover
  • vs Cognee
  • vs Hindsight
  • vs OpenViking
  • vs Supermemory
  • vs Glen
  • vs MemPalace
  • vs Sentra
  • vs Trail-code

Company

  • Questions
  • Contact
  • X
  • LinkedIn
  • Privacy Policy
  • Terms of Service
  • Data Processing Agreement
  • Refund Policy
© 2026 HarborConnect your agents