AGENTS.md vs Windsurf Rules & Memories
AGENTS.md vs Windsurf Rules & Memories: side-by-side comparison of two file-backed / editor paradigms systems — architecture, taxonomy, license, pricing, MCP/A2A support, and direct edges.
AGENTS.md · Windsurf Rules & Memories
Cost & capability
| AGENTS.md | Windsurf Rules & Memories | |
|---|---|---|
| Use cases | Code Generation Focused, Scoped Agentic | Code Generation Focused, Scoped Agentic, Analytical Summarization |
Where they differ (4)
Rows where both sides have data and the values disagree — the shortlist of dimensions that actually distinguish these two systems.
| AGENTS.md | Windsurf Rules & Memories | |
|---|---|---|
| Use cases | Code Generation Focused, Scoped Agentic | Code Generation Focused, Scoped Agentic, Analytical Summarization |
| Type | Cross-tool open standard | Codebase semantic + auto-memory |
| Created | 2025-05 (introduced with OpenAI Codex CLI research preview May 16 2025; donated to Linux Foundation AAIF Dec 2025) | 2024-11 (Windsurf Editor launched November 2024; Cascade Memories feature included at launch) |
| Backend storage | file (AGENTS.md) | file (.windsurfrules / global memories) |
At a glance
| AGENTS.md | Windsurf Rules & Memories | |
|---|---|---|
| Section | File-backed / editor paradigms | File-backed / editor paradigms |
| Tier | T1 | T1 |
| Type | Cross-tool open standard | Codebase semantic + auto-memory |
| Created | 2025-05 (introduced with OpenAI Codex CLI research preview May 16 2025; donated to Linux Foundation AAIF Dec 2025) | 2024-11 (Windsurf Editor launched November 2024; Cascade Memories feature included at launch) |
| Backend storage | file (AGENTS.md) | file (.windsurfrules / global memories) |
| Multi-tenancy | — | hard-isolation |
| Optimised for | simplicity / git-versioned / human-readable | simplicity / git-versioned / human-readable |
| Anti-fit | not for non-coding / non-IDE use cases | not for non-coding / non-IDE use cases |
Taxonomy
| Axis | AGENTS.md | Windsurf Rules & Memories |
|---|---|---|
| storage | file | file |
| retrieval | injection | injection |
| persistence | cross-session | cross-session |
| update | overwrite | overwrite |
| unit | document | document |
| governance | user-controllable | user-controllable |
| conflict | manual | llm-arbitrate |
Pros & cons
AGENTS.md
Pros: Cross-vendor convention — the closest thing to a universal agent memory file format; works across Claude Code, Cursor, and Codex CLI.
Cons: Adoption is informal (no spec authority); agent-by-agent interpretation differences mean behavior isn't fully portable.
Windsurf Rules & Memories
Pros: Two-tier model — explicit rules + implicit auto-memory — covers both curated and emergent guidance; Codeium ecosystem maturity.
Cons: Auto-memory layer is opaque (no inspect UI); rules + memories together can compound into context bloat.