Skip to content

Commit c349476

Browse files
author
Merge Resolver
committed
docs: update custom instructions for recursive loading and fallback behavior
1 parent 07ea7ac commit c349476

File tree

1 file changed

+2
-1
lines changed

1 file changed

+2
-1
lines changed

docs/features/custom-instructions.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -193,6 +193,7 @@ Workspace-wide instructions apply to all modes within the current project and ca
193193
* Create a directory named `.roo/rules/` in your workspace root.
194194
* Place instruction files (e.g., `.md`, `.txt`) inside. Roo Code reads files recursively (including subdirectories), appending their content to the system prompt in **alphabetical order** based on filename.
195195
* When this directory exists and contains files, its contents are loaded along with any global rules directories.
196+
* Note: If the `.roo/rules/` directory exists but is empty, Roo Code will fall back to using the `.roorules` file instead.
196197
* **Fallback Method: File-Based (`.roorules`)**
197198
* If `.roo/rules/` doesn't exist or is empty, Roo Code looks for a single `.roorules` file in the workspace root.
198199
* If found, its content is loaded.
@@ -290,7 +291,7 @@ Roo Code also supports loading rules from an `AGENTS.md` (or `AGENT.md` as fallb
290291

291292
* **Purpose:** Provides agent-specific rules and guidelines for AI behavior
292293
* **Location:** Must be in the workspace root directory
293-
* **Loading:** Automatically loaded by default (can be disabled via `settings.useAgentRules`)
294+
* **Loading:** Automatically loaded by default. To disable AGENTS.md loading, set `"roo-cline.useAgentRules": false` in your VSCode settings
294295
* **Priority:** Loaded after mode-specific rules but before general workspace rules
295296
* **Header:** Added to system prompt with header `# Agent Rules Standard (AGENTS.md):`
296297
* **Symbolic Links:** Supports symbolic links to AGENTS.md files in other locations

0 commit comments

Comments
 (0)