From 5d842e2c439aebfedfcada714a56b608fde0de1b Mon Sep 17 00:00:00 2001 From: Christian Torres Date: Wed, 18 Mar 2026 22:03:38 -0600 Subject: [PATCH 1/2] docs(cursor): enhance documentation for rule configuration on Cursor - Refined and expanded guidelines on managing persistent memory protocols within Cursor - Emphasizing best practices for configuring `.cursor/rules/engram.mdc`. - Improved examples, clarified file paths (including Windows considerations) --- docs/AGENT-SETUP.md | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/docs/AGENT-SETUP.md b/docs/AGENT-SETUP.md index 5629adb..4808651 100644 --- a/docs/AGENT-SETUP.md +++ b/docs/AGENT-SETUP.md @@ -273,7 +273,7 @@ Add to your `.cursor/mcp.json` (same path on all platforms — it's project-rela > **Windows**: Make sure `engram.exe` is in your `PATH`. Cursor resolves MCP commands from the system PATH. -> **Memory Protocol:** Add the Memory Protocol instructions to your `.cursorrules` file. See [DOCS.md](../DOCS.md#memory-protocol-full-text) for the full text, or use the minimal version from [Surviving Compaction](#surviving-compaction-recommended). +> **Memory Protocol:** Create `engram.mdc` with the Memory Protocol instructions. Place it in your project's `.cursor/rules/` for project-specific use (commit to git so your team gets it), or in `~/.cursor/rules/` (Windows: `%USERPROFILE%\.cursor\rules\`) to apply globally across all your projects. Create the directory if it doesn't exist. See [DOCS.md](../DOCS.md#memory-protocol-full-text) for the full text, or use the minimal version from [Surviving Compaction](#surviving-compaction-recommended). --- @@ -344,7 +344,17 @@ You have access to Engram persistent memory via MCP tools (mem_save, mem_search, - After any compaction or context reset, call `mem_context` to recover session state before continuing. ``` -**For Cursor/Windsurf** (`.cursorrules` or `.windsurfrules`): +**For Cursor** (`engram.mdc`): Create this file in your project's `.cursor/rules/` or in `~/.cursor/rules/` (Windows: `%USERPROFILE%\.cursor\rules\`) for global use across all projects. Add this content: +``` +--- +alwaysApply: true +--- + +You have access to Engram persistent memory (mem_save, mem_search, mem_context). +Save proactively after significant work. After context resets, call mem_context to recover state. +``` + +**For Windsurf** (`.windsurfrules`): ``` You have access to Engram persistent memory (mem_save, mem_search, mem_context). Save proactively after significant work. After context resets, call mem_context to recover state. From d0b6670118e8fb1ea8c782912a444988cbd425a6 Mon Sep 17 00:00:00 2001 From: Alan Buscaglia Date: Sat, 21 Mar 2026 23:01:31 +0100 Subject: [PATCH 2/2] docs(cursor): clarify mdc rules path, frontmatter, and deprecation notice - Break the Memory Protocol callout into a scannable bullet list - Add version note (Cursor 0.43+) for the .cursor/rules/ feature - Clarify that any .mdc filename is valid, not just engram.mdc - Add deprecation notice: .cursorrules still works but prefer .cursor/rules/ - Fix Surviving Compaction Cursor block: use 'text' code fence and explain what alwaysApply: true does before the code block - Use full file paths in the section heading instead of run-on description --- docs/AGENT-SETUP.md | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/docs/AGENT-SETUP.md b/docs/AGENT-SETUP.md index 4808651..c73fceb 100644 --- a/docs/AGENT-SETUP.md +++ b/docs/AGENT-SETUP.md @@ -273,7 +273,13 @@ Add to your `.cursor/mcp.json` (same path on all platforms — it's project-rela > **Windows**: Make sure `engram.exe` is in your `PATH`. Cursor resolves MCP commands from the system PATH. -> **Memory Protocol:** Create `engram.mdc` with the Memory Protocol instructions. Place it in your project's `.cursor/rules/` for project-specific use (commit to git so your team gets it), or in `~/.cursor/rules/` (Windows: `%USERPROFILE%\.cursor\rules\`) to apply globally across all your projects. Create the directory if it doesn't exist. See [DOCS.md](../DOCS.md#memory-protocol-full-text) for the full text, or use the minimal version from [Surviving Compaction](#surviving-compaction-recommended). +> **Memory Protocol:** Cursor uses `.mdc` rule files stored in `.cursor/rules/` (Cursor 0.43+). Create an `engram.mdc` file (any name works — the `.mdc` extension is what matters) and place it in one of: +> - **Project-specific:** `.cursor/rules/engram.mdc` — commit to git so your whole team gets it +> - **Global (all projects):** `~/.cursor/rules/engram.mdc` (Windows: `%USERPROFILE%\.cursor\rules\engram.mdc`) — create the directory if it doesn't exist +> +> See [DOCS.md](../DOCS.md#memory-protocol-full-text) for the full text, or use the minimal version from [Surviving Compaction](#surviving-compaction-recommended). +> +> **Note:** The legacy `.cursorrules` file at the project root is still recognized by Cursor but is deprecated. Prefer `.cursor/rules/` for all new setups. --- @@ -344,8 +350,11 @@ You have access to Engram persistent memory via MCP tools (mem_save, mem_search, - After any compaction or context reset, call `mem_context` to recover session state before continuing. ``` -**For Cursor** (`engram.mdc`): Create this file in your project's `.cursor/rules/` or in `~/.cursor/rules/` (Windows: `%USERPROFILE%\.cursor\rules\`) for global use across all projects. Add this content: -``` +**For Cursor** (`.cursor/rules/engram.mdc` or `~/.cursor/rules/engram.mdc`): + +The `alwaysApply: true` frontmatter tells Cursor to load this rule in every conversation, regardless of which files are open. + +```text --- alwaysApply: true ---