feat: enhance rule file loading with .roo/rules directory support (#2354)

* feat: enhance rule file loading with .roo/rules directory support

- Introduced functions to safely read files and check for directory existence.
- Added capability to read all text files from a specified directory in alphabetical order.
- Updated `loadRuleFiles` to prioritize loading rules from a `.roo/rules/` directory, falling back to existing rule files if necessary.
- Enhanced `addCustomInstructions` to support loading mode-specific rules from a `.roo/rules-{mode}/` directory, improving flexibility in rule management.

This change improves the organization and retrieval of rule files, allowing for better modularity and maintainability.

* Updated strings and translations

* Add tests

* Revert changes to system prompt translations

* Fix path resolution

* Make instruction structure clearer

---------

Co-authored-by: Matt Rubens <[email protected]>

src/core/prompts/sections/__tests__/custom-instructions.test.ts

@@ -1,9 +1,38 @@
 import { loadRuleFiles, addCustomInstructions } from "../custom-instructions"
 import fs from "fs/promises"
+import path from "path"
+import { PathLike } from "fs"
 
 // Mock fs/promises
 jest.mock("fs/promises")
-const mockedFs = jest.mocked(fs)
+
+// Create mock functions
+const readFileMock = jest.fn()
+const statMock = jest.fn()
+const readdirMock = jest.fn()
+
+// Replace fs functions with our mocks
+fs.readFile = readFileMock as any
+fs.stat = statMock as any
+fs.readdir = readdirMock as any
+
+// Mock path.resolve and path.join to be predictable in tests
+jest.mock("path", () => ({
+	...jest.requireActual("path"),
+	resolve: jest.fn().mockImplementation((...args) => args.join("/")),
+	join: jest.fn().mockImplementation((...args) => args.join("/")),
+	relative: jest.fn().mockImplementation((from, to) => to),
+}))
+
+// Mock process.cwd
+const originalCwd = process.cwd
+beforeAll(() => {
+	process.cwd = jest.fn().mockReturnValue("/fake/cwd")
+})
+
+afterAll(() => {
+	process.cwd = originalCwd
+})
 
 describe("loadRuleFiles", () => {
 	beforeEach(() => {
@@ -11,42 +40,46 @@ describe("loadRuleFiles", () => {
 	})
 
 	it("should read and trim file content", async () => {
-		mockedFs.readFile.mockResolvedValue("  content with spaces  ")
+		// Simulate no .roo/rules directory
+		statMock.mockRejectedValueOnce({ code: "ENOENT" })
+		readFileMock.mockResolvedValue("  content with spaces  ")
 		const result = await loadRuleFiles("/fake/path")
-		expect(mockedFs.readFile).toHaveBeenCalled()
+		expect(readFileMock).toHaveBeenCalled()
 		expect(result).toBe("\n# Rules from .roorules:\ncontent with spaces\n")
 	})
 
 	it("should handle ENOENT error", async () => {
-		mockedFs.readFile.mockRejectedValue({ code: "ENOENT" })
+		// Simulate no .roo/rules directory
+		statMock.mockRejectedValueOnce({ code: "ENOENT" })
+		readFileMock.mockRejectedValue({ code: "ENOENT" })
 		const result = await loadRuleFiles("/fake/path")
 		expect(result).toBe("")
 	})
 
 	it("should handle EISDIR error", async () => {
-		mockedFs.readFile.mockRejectedValue({ code: "EISDIR" })
+		// Simulate no .roo/rules directory
+		statMock.mockRejectedValueOnce({ code: "ENOENT" })
+		readFileMock.mockRejectedValue({ code: "EISDIR" })
 		const result = await loadRuleFiles("/fake/path")
 		expect(result).toBe("")
 	})
 
 	it("should throw on unexpected errors", async () => {
+		// Simulate no .roo/rules directory
+		statMock.mockRejectedValueOnce({ code: "ENOENT" })
 		const error = new Error("Permission denied") as NodeJS.ErrnoException
 		error.code = "EPERM"
-		mockedFs.readFile.mockRejectedValue(error)
+		readFileMock.mockRejectedValue(error)
 
 		await expect(async () => {
 			await loadRuleFiles("/fake/path")
 		}).rejects.toThrow()
 	})
-})
-
-describe("loadRuleFiles", () => {
-	beforeEach(() => {
-		jest.clearAllMocks()
-	})
 
 	it("should not combine content from multiple rule files when they exist", async () => {
-		mockedFs.readFile.mockImplementation(((filePath: string | Buffer | URL | number) => {
+		// Simulate no .roo/rules directory
+		statMock.mockRejectedValueOnce({ code: "ENOENT" })
+		readFileMock.mockImplementation((filePath: PathLike) => {
 			if (filePath.toString().endsWith(".roorules")) {
 				return Promise.resolve("roo rules content")
 			}
@@ -54,31 +87,25 @@ describe("loadRuleFiles", () => {
 				return Promise.resolve("cline rules content")
 			}
 			return Promise.reject({ code: "ENOENT" })
-		}) as any)
+		})
 
 		const result = await loadRuleFiles("/fake/path")
 		expect(result).toBe("\n# Rules from .roorules:\nroo rules content\n")
 	})
 
 	it("should handle when no rule files exist", async () => {
-		mockedFs.readFile.mockRejectedValue({ code: "ENOENT" })
+		// Simulate no .roo/rules directory
+		statMock.mockRejectedValueOnce({ code: "ENOENT" })
+		readFileMock.mockRejectedValue({ code: "ENOENT" })
 
 		const result = await loadRuleFiles("/fake/path")
 		expect(result).toBe("")
 	})
 
-	it("should throw on unexpected errors", async () => {
-		const error = new Error("Permission denied") as NodeJS.ErrnoException
-		error.code = "EPERM"
-		mockedFs.readFile.mockRejectedValue(error)
-
-		await expect(async () => {
-			await loadRuleFiles("/fake/path")
-		}).rejects.toThrow()
-	})
-
 	it("should skip directories with same name as rule files", async () => {
-		mockedFs.readFile.mockImplementation(((filePath: string | Buffer | URL | number) => {
+		// Simulate no .roo/rules directory
+		statMock.mockRejectedValueOnce({ code: "ENOENT" })
+		readFileMock.mockImplementation((filePath: PathLike) => {
 			if (filePath.toString().endsWith(".roorules")) {
 				return Promise.reject({ code: "EISDIR" })
 			}
@@ -86,11 +113,94 @@ describe("loadRuleFiles", () => {
 				return Promise.reject({ code: "EISDIR" })
 			}
 			return Promise.reject({ code: "ENOENT" })
-		}) as any)
+		})
 
 		const result = await loadRuleFiles("/fake/path")
 		expect(result).toBe("")
 	})
+
+	it("should use .roo/rules/ directory when it exists and has files", async () => {
+		// Simulate .roo/rules directory exists
+		statMock.mockResolvedValueOnce({
+			isDirectory: jest.fn().mockReturnValue(true),
+		} as any)
+
+		// Simulate listing files
+		readdirMock.mockResolvedValueOnce([
+			{ name: "file1.txt", isFile: () => true },
+			{ name: "file2.txt", isFile: () => true },
+		] as any)
+
+		statMock.mockImplementation(
+			(path) =>
+				({
+					isFile: jest.fn().mockReturnValue(true),
+				}) as any,
+		)
+
+		readFileMock.mockImplementation((filePath: PathLike) => {
+			if (filePath.toString() === "/fake/path/.roo/rules/file1.txt") {
+				return Promise.resolve("content of file1")
+			}
+			if (filePath.toString() === "/fake/path/.roo/rules/file2.txt") {
+				return Promise.resolve("content of file2")
+			}
+			return Promise.reject({ code: "ENOENT" })
+		})
+
+		const result = await loadRuleFiles("/fake/path")
+		expect(result).toContain("# Rules from /fake/path/.roo/rules/file1.txt:")
+		expect(result).toContain("content of file1")
+		expect(result).toContain("# Rules from /fake/path/.roo/rules/file2.txt:")
+		expect(result).toContain("content of file2")
+
+		expect(statMock).toHaveBeenCalledWith("/fake/path/.roo/rules/file1.txt")
+		expect(statMock).toHaveBeenCalledWith("/fake/path/.roo/rules/file2.txt")
+		expect(readFileMock).toHaveBeenCalledWith("/fake/path/.roo/rules/file1.txt", "utf-8")
+		expect(readFileMock).toHaveBeenCalledWith("/fake/path/.roo/rules/file2.txt", "utf-8")
+	})
+
+	it("should fall back to .roorules when .roo/rules/ is empty", async () => {
+		// Simulate .roo/rules directory exists
+		statMock.mockResolvedValueOnce({
+			isDirectory: jest.fn().mockReturnValue(true),
+		} as any)
+
+		// Simulate empty directory
+		readdirMock.mockResolvedValueOnce([])
+
+		// Simulate .roorules exists
+		readFileMock.mockImplementation((filePath: PathLike) => {
+			if (filePath.toString().endsWith(".roorules")) {
+				return Promise.resolve("roo rules content")
+			}
+			return Promise.reject({ code: "ENOENT" })
+		})
+
+		const result = await loadRuleFiles("/fake/path")
+		expect(result).toBe("\n# Rules from .roorules:\nroo rules content\n")
+	})
+
+	it("should handle errors when reading directory", async () => {
+		// Simulate .roo/rules directory exists
+		statMock.mockResolvedValueOnce({
+			isDirectory: jest.fn().mockReturnValue(true),
+		} as any)
+
+		// Simulate error reading directory
+		readdirMock.mockRejectedValueOnce(new Error("Failed to read directory"))
+
+		// Simulate .roorules exists
+		readFileMock.mockImplementation((filePath: PathLike) => {
+			if (filePath.toString().endsWith(".roorules")) {
+				return Promise.resolve("roo rules content")
+			}
+			return Promise.reject({ code: "ENOENT" })
+		})
+
+		const result = await loadRuleFiles("/fake/path")
+		expect(result).toBe("\n# Rules from .roorules:\nroo rules content\n")
+	})
 })
 
 describe("addCustomInstructions", () => {
@@ -99,7 +209,10 @@ describe("addCustomInstructions", () => {
 	})
 
 	it("should combine all instruction types when provided", async () => {
-		mockedFs.readFile.mockResolvedValue("mode specific rules")
+		// Simulate no .roo/rules-test-mode directory
+		statMock.mockRejectedValueOnce({ code: "ENOENT" })
+
+		readFileMock.mockResolvedValue("mode specific rules")
 
 		const result = await addCustomInstructions(
 			"mode instructions",
@@ -118,14 +231,20 @@ describe("addCustomInstructions", () => {
 	})
 
 	it("should return empty string when no instructions provided", async () => {
-		mockedFs.readFile.mockRejectedValue({ code: "ENOENT" })
+		// Simulate no .roo/rules directory
+		statMock.mockRejectedValueOnce({ code: "ENOENT" })
+
+		readFileMock.mockRejectedValue({ code: "ENOENT" })
 
 		const result = await addCustomInstructions("", "", "/fake/path", "", {})
 		expect(result).toBe("")
 	})
 
 	it("should handle missing mode-specific rules file", async () => {
-		mockedFs.readFile.mockRejectedValue({ code: "ENOENT" })
+		// Simulate no .roo/rules-test-mode directory
+		statMock.mockRejectedValueOnce({ code: "ENOENT" })
+
+		readFileMock.mockRejectedValue({ code: "ENOENT" })
 
 		const result = await addCustomInstructions(
 			"mode instructions",
@@ -140,7 +259,10 @@ describe("addCustomInstructions", () => {
 	})
 
 	it("should handle unknown language codes properly", async () => {
-		mockedFs.readFile.mockRejectedValue({ code: "ENOENT" })
+		// Simulate no .roo/rules-test-mode directory
+		statMock.mockRejectedValueOnce({ code: "ENOENT" })
+
+		readFileMock.mockRejectedValue({ code: "ENOENT" })
 
 		const result = await addCustomInstructions(
 			"mode instructions",
@@ -156,9 +278,12 @@ describe("addCustomInstructions", () => {
 	})
 
 	it("should throw on unexpected errors", async () => {
+		// Simulate no .roo/rules-test-mode directory
+		statMock.mockRejectedValueOnce({ code: "ENOENT" })
+
 		const error = new Error("Permission denied") as NodeJS.ErrnoException
 		error.code = "EPERM"
-		mockedFs.readFile.mockRejectedValue(error)
+		readFileMock.mockRejectedValue(error)
 
 		await expect(async () => {
 			await addCustomInstructions("", "", "/fake/path", "test-mode")
@@ -166,12 +291,15 @@ describe("addCustomInstructions", () => {
 	})
 
 	it("should skip mode-specific rule files that are directories", async () => {
-		mockedFs.readFile.mockImplementation(((filePath: string | Buffer | URL | number) => {
+		// Simulate no .roo/rules-test-mode directory
+		statMock.mockRejectedValueOnce({ code: "ENOENT" })
+
+		readFileMock.mockImplementation((filePath: PathLike) => {
 			if (filePath.toString().includes(".clinerules-test-mode")) {
 				return Promise.reject({ code: "EISDIR" })
 			}
 			return Promise.reject({ code: "ENOENT" })
-		}) as any)
+		})
 
 		const result = await addCustomInstructions(
 			"mode instructions",
@@ -184,4 +312,261 @@ describe("addCustomInstructions", () => {
 		expect(result).toContain("Mode-specific Instructions:\nmode instructions")
 		expect(result).not.toContain("Rules from .clinerules-test-mode")
 	})
+
+	it("should use .roo/rules-test-mode/ directory when it exists and has files", async () => {
+		// Simulate .roo/rules-test-mode directory exists
+		statMock.mockResolvedValueOnce({
+			isDirectory: jest.fn().mockReturnValue(true),
+		} as any)
+
+		// Simulate listing files
+		readdirMock.mockResolvedValueOnce([
+			{ name: "rule1.txt", isFile: () => true },
+			{ name: "rule2.txt", isFile: () => true },
+		] as any)
+
+		statMock.mockImplementation(
+			(path) =>
+				({
+					isFile: jest.fn().mockReturnValue(true),
+				}) as any,
+		)
+
+		readFileMock.mockImplementation((filePath: PathLike) => {
+			if (filePath.toString() === "/fake/path/.roo/rules-test-mode/rule1.txt") {
+				return Promise.resolve("mode specific rule 1")
+			}
+			if (filePath.toString() === "/fake/path/.roo/rules-test-mode/rule2.txt") {
+				return Promise.resolve("mode specific rule 2")
+			}
+			return Promise.reject({ code: "ENOENT" })
+		})
+
+		const result = await addCustomInstructions(
+			"mode instructions",
+			"global instructions",
+			"/fake/path",
+			"test-mode",
+			{ language: "es" },
+		)
+
+		expect(result).toContain("# Rules from /fake/path/.roo/rules-test-mode")
+		expect(result).toContain("# Rules from /fake/path/.roo/rules-test-mode/rule1.txt:")
+		expect(result).toContain("mode specific rule 1")
+		expect(result).toContain("# Rules from /fake/path/.roo/rules-test-mode/rule2.txt:")
+		expect(result).toContain("mode specific rule 2")
+
+		expect(statMock).toHaveBeenCalledWith("/fake/path/.roo/rules-test-mode/rule1.txt")
+		expect(statMock).toHaveBeenCalledWith("/fake/path/.roo/rules-test-mode/rule2.txt")
+		expect(readFileMock).toHaveBeenCalledWith("/fake/path/.roo/rules-test-mode/rule1.txt", "utf-8")
+		expect(readFileMock).toHaveBeenCalledWith("/fake/path/.roo/rules-test-mode/rule2.txt", "utf-8")
+	})
+
+	it("should fall back to .roorules-test-mode when .roo/rules-test-mode/ does not exist", async () => {
+		// Simulate .roo/rules-test-mode directory does not exist
+		statMock.mockRejectedValueOnce({ code: "ENOENT" })
+
+		// Simulate .roorules-test-mode exists
+		readFileMock.mockImplementation((filePath: PathLike) => {
+			if (filePath.toString().includes(".roorules-test-mode")) {
+				return Promise.resolve("mode specific rules from file")
+			}
+			return Promise.reject({ code: "ENOENT" })
+		})
+
+		const result = await addCustomInstructions(
+			"mode instructions",
+			"global instructions",
+			"/fake/path",
+			"test-mode",
+		)
+
+		expect(result).toContain("Rules from .roorules-test-mode:\nmode specific rules from file")
+	})
+
+	it("should fall back to .clinerules-test-mode when .roo/rules-test-mode/ and .roorules-test-mode do not exist", async () => {
+		// Simulate .roo/rules-test-mode directory does not exist
+		statMock.mockRejectedValueOnce({ code: "ENOENT" })
+
+		// Simulate file reading
+		readFileMock.mockImplementation((filePath: PathLike) => {
+			if (filePath.toString().includes(".roorules-test-mode")) {
+				return Promise.reject({ code: "ENOENT" })
+			}
+			if (filePath.toString().includes(".clinerules-test-mode")) {
+				return Promise.resolve("mode specific rules from cline file")
+			}
+			return Promise.reject({ code: "ENOENT" })
+		})
+
+		const result = await addCustomInstructions(
+			"mode instructions",
+			"global instructions",
+			"/fake/path",
+			"test-mode",
+		)
+
+		expect(result).toContain("Rules from .clinerules-test-mode:\nmode specific rules from cline file")
+	})
+
+	it("should correctly format content from directories when using .roo/rules-test-mode/", async () => {
+		// Need to reset mockImplementation first to avoid interference from previous tests
+		statMock.mockReset()
+		readFileMock.mockReset()
+
+		// Simulate .roo/rules-test-mode directory exists
+		statMock.mockImplementationOnce(() =>
+			Promise.resolve({
+				isDirectory: jest.fn().mockReturnValue(true),
+			} as any),
+		)
+
+		// Simulate directory has files
+		readdirMock.mockResolvedValueOnce([{ name: "rule1.txt", isFile: () => true }] as any)
+		readFileMock.mockReset()
+
+		// Set up stat mock for checking files
+		let statCallCount = 0
+		statMock.mockImplementation((filePath) => {
+			statCallCount++
+			if (filePath === "/fake/path/.roo/rules-test-mode/rule1.txt") {
+				return Promise.resolve({
+					isFile: jest.fn().mockReturnValue(true),
+					isDirectory: jest.fn().mockReturnValue(false),
+				} as any)
+			}
+			return Promise.resolve({
+				isFile: jest.fn().mockReturnValue(false),
+				isDirectory: jest.fn().mockReturnValue(false),
+			} as any)
+		})
+
+		readFileMock.mockImplementation((filePath: PathLike) => {
+			if (filePath.toString() === "/fake/path/.roo/rules-test-mode/rule1.txt") {
+				return Promise.resolve("mode specific rule content")
+			}
+			return Promise.reject({ code: "ENOENT" })
+		})
+
+		const result = await addCustomInstructions(
+			"mode instructions",
+			"global instructions",
+			"/fake/path",
+			"test-mode",
+		)
+
+		expect(result).toContain("# Rules from /fake/path/.roo/rules-test-mode")
+		expect(result).toContain("# Rules from /fake/path/.roo/rules-test-mode/rule1.txt:")
+		expect(result).toContain("mode specific rule content")
+
+		expect(statCallCount).toBeGreaterThan(0)
+	})
+})
+
+// Test directory existence checks through loadRuleFiles
+describe("Directory existence checks", () => {
+	beforeEach(() => {
+		jest.clearAllMocks()
+	})
+
+	it("should detect when directory exists", async () => {
+		// Mock the stats to indicate the directory exists
+		statMock.mockResolvedValueOnce({
+			isDirectory: jest.fn().mockReturnValue(true),
+		} as any)
+
+		// Simulate empty directory to test that stats is called
+		readdirMock.mockResolvedValueOnce([])
+
+		// For loadRuleFiles to return something for testing
+		readFileMock.mockResolvedValueOnce("fallback content")
+
+		await loadRuleFiles("/fake/path")
+
+		// Verify stat was called to check directory existence
+		expect(statMock).toHaveBeenCalledWith("/fake/path/.roo/rules")
+	})
+
+	it("should handle when directory does not exist", async () => {
+		// Mock the stats to indicate the directory doesn't exist
+		statMock.mockRejectedValueOnce({ code: "ENOENT" })
+
+		// Mock file read to verify fallback
+		readFileMock.mockResolvedValueOnce("fallback content")
+
+		const result = await loadRuleFiles("/fake/path")
+
+		// Verify it fell back to reading rule files directly
+		expect(result).toBe("\n# Rules from .roorules:\nfallback content\n")
+	})
+})
+
+// Indirectly test readTextFilesFromDirectory and formatDirectoryContent through loadRuleFiles
+describe("Rules directory reading", () => {
+	beforeEach(() => {
+		jest.clearAllMocks()
+	})
+
+	it("should correctly format multiple files from directory", async () => {
+		// Simulate .roo/rules directory exists
+		statMock.mockResolvedValueOnce({
+			isDirectory: jest.fn().mockReturnValue(true),
+		} as any)
+
+		// Simulate listing files
+		readdirMock.mockResolvedValueOnce([
+			{ name: "file1.txt", isFile: () => true },
+			{ name: "file2.txt", isFile: () => true },
+			{ name: "file3.txt", isFile: () => true },
+		] as any)
+
+		statMock.mockImplementation((path) => {
+			expect([
+				"/fake/path/.roo/rules/file1.txt",
+				"/fake/path/.roo/rules/file2.txt",
+				"/fake/path/.roo/rules/file3.txt",
+			]).toContain(path)
+
+			return Promise.resolve({
+				isFile: jest.fn().mockReturnValue(true),
+			}) as any
+		})
+
+		readFileMock.mockImplementation((filePath: PathLike) => {
+			if (filePath.toString() === "/fake/path/.roo/rules/file1.txt") {
+				return Promise.resolve("content of file1")
+			}
+			if (filePath.toString() === "/fake/path/.roo/rules/file2.txt") {
+				return Promise.resolve("content of file2")
+			}
+			if (filePath.toString() === "/fake/path/.roo/rules/file3.txt") {
+				return Promise.resolve("content of file3")
+			}
+			return Promise.reject({ code: "ENOENT" })
+		})
+
+		const result = await loadRuleFiles("/fake/path")
+
+		expect(result).toContain("# Rules from /fake/path/.roo/rules/file1.txt:")
+		expect(result).toContain("content of file1")
+		expect(result).toContain("# Rules from /fake/path/.roo/rules/file2.txt:")
+		expect(result).toContain("content of file2")
+		expect(result).toContain("# Rules from /fake/path/.roo/rules/file3.txt:")
+		expect(result).toContain("content of file3")
+	})
+
+	it("should handle empty file list gracefully", async () => {
+		// Simulate .roo/rules directory exists
+		statMock.mockResolvedValueOnce({
+			isDirectory: jest.fn().mockReturnValue(true),
+		} as any)
+
+		// Simulate empty directory
+		readdirMock.mockResolvedValueOnce([])
+
+		readFileMock.mockResolvedValueOnce("fallback content")
+
+		const result = await loadRuleFiles("/fake/path")
+		expect(result).toBe("\n# Rules from .roorules:\nfallback content\n")
+	})
 })

src/core/prompts/sections/custom-instructions.ts

@@ -3,6 +3,9 @@ import path from "path"
 
 import { LANGUAGES, isLanguage } from "../../../shared/language"
 
+/**
+ * Safely read a file and return its trimmed content
+ */
 async function safeReadFile(filePath: string): Promise<string> {
 	try {
 		const content = await fs.readFile(filePath, "utf-8")
@@ -16,7 +19,81 @@ async function safeReadFile(filePath: string): Promise<string> {
 	}
 }
 
+/**
+ * Check if a directory exists
+ */
+async function directoryExists(dirPath: string): Promise<boolean> {
+	try {
+		const stats = await fs.stat(dirPath)
+		return stats.isDirectory()
+	} catch (err) {
+		return false
+	}
+}
+
+/**
+ * Read all text files from a directory in alphabetical order
+ */
+async function readTextFilesFromDirectory(dirPath: string): Promise<Array<{ filename: string; content: string }>> {
+	try {
+		const files = await fs
+			.readdir(dirPath, { withFileTypes: true, recursive: true })
+			.then((files) => files.filter((file) => file.isFile()))
+			.then((files) => files.map((file) => path.resolve(dirPath, file.name)))
+
+		const fileContents = await Promise.all(
+			files.map(async (file) => {
+				try {
+					// Check if it's a file (not a directory)
+					const stats = await fs.stat(file)
+					if (stats.isFile()) {
+						const content = await safeReadFile(file)
+						return { filename: file, content }
+					}
+					return null
+				} catch (err) {
+					return null
+				}
+			}),
+		)
+
+		// Filter out null values (directories or failed reads)
+		return fileContents.filter((item): item is { filename: string; content: string } => item !== null)
+	} catch (err) {
+		return []
+	}
+}
+
+/**
+ * Format content from multiple files with filenames as headers
+ */
+function formatDirectoryContent(dirPath: string, files: Array<{ filename: string; content: string }>): string {
+	if (files.length === 0) return ""
+
+	return (
+		"\n\n" +
+		files
+			.map((file) => {
+				return `# Rules from ${file.filename}:\n${file.content}:`
+			})
+			.join("\n\n")
+	)
+}
+
+/**
+ * Load rule files from the specified directory
+ */
 export async function loadRuleFiles(cwd: string): Promise<string> {
+	// Check for .roo/rules/ directory
+	const rooRulesDir = path.join(cwd, ".roo", "rules")
+	if (await directoryExists(rooRulesDir)) {
+		const files = await readTextFilesFromDirectory(rooRulesDir)
+		if (files.length > 0) {
+			return formatDirectoryContent(rooRulesDir, files)
+		}
+	}
+
+	// Fall back to existing behavior
 	const ruleFiles = [".roorules", ".clinerules"]
 
 	for (const file of ruleFiles) {
@@ -41,16 +118,30 @@ export async function addCustomInstructions(
 	// Load mode-specific rules if mode is provided
 	let modeRuleContent = ""
 	let usedRuleFile = ""
+
 	if (mode) {
-		const rooModeRuleFile = `.roorules-${mode}`
-		modeRuleContent = await safeReadFile(path.join(cwd, rooModeRuleFile))
-		if (modeRuleContent) {
-			usedRuleFile = rooModeRuleFile
-		} else {
-			const clineModeRuleFile = `.clinerules-${mode}`
-			modeRuleContent = await safeReadFile(path.join(cwd, clineModeRuleFile))
+		// Check for .roo/rules-${mode}/ directory
+		const modeRulesDir = path.join(cwd, ".roo", `rules-${mode}`)
+		if (await directoryExists(modeRulesDir)) {
+			const files = await readTextFilesFromDirectory(modeRulesDir)
+			if (files.length > 0) {
+				modeRuleContent = formatDirectoryContent(modeRulesDir, files)
+				usedRuleFile = modeRulesDir
+			}
+		}
+
+		// If no directory exists, fall back to existing behavior
+		if (!modeRuleContent) {
+			const rooModeRuleFile = `.roorules-${mode}`
+			modeRuleContent = await safeReadFile(path.join(cwd, rooModeRuleFile))
 			if (modeRuleContent) {
-				usedRuleFile = clineModeRuleFile
+				usedRuleFile = rooModeRuleFile
+			} else {
+				const clineModeRuleFile = `.clinerules-${mode}`
+				modeRuleContent = await safeReadFile(path.join(cwd, clineModeRuleFile))
+				if (modeRuleContent) {
+					usedRuleFile = clineModeRuleFile
+				}
 			}
 		}
 	}
@@ -78,7 +169,11 @@ export async function addCustomInstructions(
 
 	// Add mode-specific rules first if they exist
 	if (modeRuleContent && modeRuleContent.trim()) {
-		rules.push(`# Rules from ${usedRuleFile}:\n${modeRuleContent}`)
+		if (usedRuleFile.includes(path.join(".roo", `rules-${mode}`))) {
+			rules.push(modeRuleContent.trim())
+		} else {
+			rules.push(`# Rules from ${usedRuleFile}:\n${modeRuleContent}`)
+		}
 	}
 
 	if (options.rooIgnoreInstructions) {

webview-ui/src/components/prompts/PromptsView.tsx

@@ -798,7 +798,7 @@ const PromptsView = ({ onDone }: PromptsViewProps) => {
 												// Open or create an empty file
 												vscode.postMessage({
 													type: "openFile",
-													text: `./.roorules-${currentMode.slug}`,
+													text: `./.roo/rules-${currentMode.slug}/rules.md`,
 													values: {
 														create: true,
 														content: "",
@@ -935,7 +935,7 @@ const PromptsView = ({ onDone }: PromptsViewProps) => {
 										onClick={() =>
 											vscode.postMessage({
 												type: "openFile",
-												text: "./.roorules",
+												text: "./.roo/rules/rules.md",
 												values: {
 													create: true,
 													content: "",

webview-ui/src/i18n/locales/ca/prompts.json

@@ -36,12 +36,12 @@
 		"title": "Instruccions personalitzades específiques del mode (opcional)",
 		"resetToDefault": "Restablir a valors predeterminats",
 		"description": "Afegiu directrius de comportament específiques per al mode {{modeName}}.",
-		"loadFromFile": "Les instruccions personalitzades específiques per al mode {{mode}} també es poden carregar des de <span>.roorules-{{slug}}</span> al vostre espai de treball (.clinerules-{{slug}} està obsolet i deixarà de funcionar aviat)."
+		"loadFromFile": "Les instruccions personalitzades específiques per al mode {{mode}} també es poden carregar des de la carpeta <span>.roo/rules-{{slug}}/</span> al vostre espai de treball (.roorules-{{slug}} i .clinerules-{{slug}} estan obsolets i deixaran de funcionar aviat)."
 	},
 	"globalCustomInstructions": {
 		"title": "Instruccions personalitzades per a tots els modes",
 		"description": "Aquestes instruccions s'apliquen a tots els modes. Proporcionen un conjunt bàsic de comportaments que es poden millorar amb instruccions específiques de cada mode a continuació.\nSi voleu que Roo pensi i parli en un idioma diferent al de la visualització del vostre editor ({{language}}), podeu especificar-ho aquí.",
-		"loadFromFile": "Les instruccions també es poden carregar des de <span>.roorules</span> al vostre espai de treball (.clinerules està obsolet i deixarà de funcionar aviat)."
+		"loadFromFile": "Les instruccions també es poden carregar des de la carpeta <span>.roo/rules/</span> al vostre espai de treball (.roorules i .clinerules estan obsolets i deixaran de funcionar aviat)."
 	},
 	"systemPrompt": {
 		"preview": "Previsualització del prompt del sistema",

webview-ui/src/i18n/locales/de/prompts.json

@@ -36,12 +36,12 @@
 		"title": "Modusspezifische benutzerdefinierte Anweisungen (optional)",
 		"resetToDefault": "Auf Standardwerte zurücksetzen",
 		"description": "Fügen Sie verhaltensspezifische Richtlinien für den Modus {{modeName}} hinzu.",
-		"loadFromFile": "Benutzerdefinierte Anweisungen für den Modus {{mode}} können auch aus <span>.roorules-{{slug}}</span> in deinem Arbeitsbereich geladen werden (.clinerules-{{slug}} ist veraltet und wird bald nicht mehr funktionieren)."
+		"loadFromFile": "Benutzerdefinierte Anweisungen für den Modus {{mode}} können auch aus dem Ordner <span>.roo/rules-{{slug}}/</span> in deinem Arbeitsbereich geladen werden (.roorules-{{slug}} und .clinerules-{{slug}} sind veraltet und werden bald nicht mehr funktionieren)."
 	},
 	"globalCustomInstructions": {
 		"title": "Benutzerdefinierte Anweisungen für alle Modi",
 		"description": "Diese Anweisungen gelten für alle Modi. Sie bieten einen grundlegenden Satz von Verhaltensweisen, die durch modusspezifische Anweisungen unten erweitert werden können.\nWenn du möchtest, dass Roo in einer anderen Sprache als deiner Editor-Anzeigesprache ({{language}}) denkt und spricht, kannst du das hier angeben.",
-		"loadFromFile": "Anweisungen können auch aus <span>.roorules</span> in deinem Arbeitsbereich geladen werden (.clinerules ist veraltet und wird bald nicht mehr funktionieren)."
+		"loadFromFile": "Anweisungen können auch aus dem Ordner <span>.roo/rules/</span> in deinem Arbeitsbereich geladen werden (.roorules und .clinerules sind veraltet und werden bald nicht mehr funktionieren)."
 	},
 	"systemPrompt": {
 		"preview": "System-Prompt Vorschau",

webview-ui/src/i18n/locales/en/prompts.json

@@ -36,12 +36,12 @@
 		"title": "Mode-specific Custom Instructions (optional)",
 		"resetToDefault": "Reset to default",
 		"description": "Add behavioral guidelines specific to {{modeName}} mode.",
-		"loadFromFile": "Custom instructions specific to {{mode}} mode can also be loaded from <span>.roorules-{{slug}}</span> in your workspace (.clinerules-{{slug}} is deprecated and will stop working soon)."
+		"loadFromFile": "Custom instructions specific to {{mode}} mode can also be loaded from the <span>.roo/rules-{{slug}}/</span> folder in your workspace (.roorules-{{slug}} and .clinerules-{{slug}} are deprecated and will stop working soon)."
 	},
 	"globalCustomInstructions": {
 		"title": "Custom Instructions for All Modes",
 		"description": "These instructions apply to all modes. They provide a base set of behaviors that can be enhanced by mode-specific instructions below.\nIf you would like Roo to think and speak in a different language than your editor display language ({{language}}), you can specify it here.",
-		"loadFromFile": "Instructions can also be loaded from <span>.roorules</span> in your workspace (.clinerules is deprecated and will stop working soon)."
+		"loadFromFile": "Instructions can also be loaded from the <span>.roo/rules/</span> folder in your workspace (.roorules and .clinerules are deprecated and will stop working soon)."
 	},
 	"systemPrompt": {
 		"preview": "Preview System Prompt",

webview-ui/src/i18n/locales/es/prompts.json

@@ -36,12 +36,12 @@
 		"title": "Instrucciones personalizadas para el modo (opcional)",
 		"resetToDefault": "Restablecer a valores predeterminados",
 		"description": "Agrega directrices de comportamiento específicas para el modo {{modeName}}.",
-		"loadFromFile": "Las instrucciones personalizadas para el modo {{mode}} también se pueden cargar desde <span>.roorules-{{slug}}</span> en tu espacio de trabajo (.clinerules-{{slug}} está obsoleto y dejará de funcionar pronto)."
+		"loadFromFile": "Las instrucciones personalizadas para el modo {{mode}} también se pueden cargar desde la carpeta <span>.roo/rules-{{slug}}/</span> en tu espacio de trabajo (.roorules-{{slug}} y .clinerules-{{slug}} están obsoletos y dejarán de funcionar pronto)."
 	},
 	"globalCustomInstructions": {
 		"title": "Instrucciones personalizadas para todos los modos",
 		"description": "Estas instrucciones se aplican a todos los modos. Proporcionan un conjunto base de comportamientos que pueden ser mejorados por instrucciones específicas de cada modo.\nSi quieres que Roo piense y hable en un idioma diferente al idioma de visualización de tu editor ({{language}}), puedes especificarlo aquí.",
-		"loadFromFile": "Las instrucciones también se pueden cargar desde <span>.roorules</span> en tu espacio de trabajo (.clinerules está obsoleto y dejará de funcionar pronto)."
+		"loadFromFile": "Las instrucciones también se pueden cargar desde la carpeta <span>.roo/rules/</span> en tu espacio de trabajo (.roorules y .clinerules están obsoletos y dejarán de funcionar pronto)."
 	},
 	"systemPrompt": {
 		"preview": "Vista previa de la solicitud del sistema",

webview-ui/src/i18n/locales/fr/prompts.json

@@ -36,12 +36,12 @@
 		"title": "Instructions personnalisées spécifiques au mode (optionnel)",
 		"resetToDefault": "Réinitialiser aux valeurs par défaut",
 		"description": "Ajoutez des directives comportementales spécifiques au mode {{modeName}}.",
-		"loadFromFile": "Les instructions personnalisées spécifiques au mode {{mode}} peuvent également être chargées depuis <span>.roorules-{{slug}}</span> dans votre espace de travail (.clinerules-{{slug}} est obsolète et cessera de fonctionner bientôt)."
+		"loadFromFile": "Les instructions personnalisées spécifiques au mode {{mode}} peuvent également être chargées depuis le dossier <span>.roo/rules-{{slug}}/</span> dans votre espace de travail (.roorules-{{slug}} et .clinerules-{{slug}} sont obsolètes et cesseront de fonctionner bientôt)."
 	},
 	"globalCustomInstructions": {
 		"title": "Instructions personnalisées pour tous les modes",
 		"description": "Ces instructions s'appliquent à tous les modes. Elles fournissent un ensemble de comportements de base qui peuvent être améliorés par des instructions spécifiques au mode ci-dessous.\nSi vous souhaitez que Roo pense et parle dans une langue différente de celle de votre éditeur ({{language}}), vous pouvez le spécifier ici.",
-		"loadFromFile": "Les instructions peuvent également être chargées depuis <span>.roorules</span> dans votre espace de travail (.clinerules est obsolète et cessera de fonctionner bientôt)."
+		"loadFromFile": "Les instructions peuvent également être chargées depuis le dossier <span>.roo/rules/</span> dans votre espace de travail (.roorules et .clinerules sont obsolètes et cesseront de fonctionner bientôt)."
 	},
 	"systemPrompt": {
 		"preview": "Aperçu du prompt système",

webview-ui/src/i18n/locales/hi/prompts.json

@@ -36,12 +36,12 @@
 		"title": "मोड-विशिष्ट कस्टम निर्देश (वैकल्पिक)",
 		"resetToDefault": "डिफ़ॉल्ट पर रीसेट करें",
 		"description": "{{modeName}} मोड के लिए विशिष्ट व्यवहार दिशानिर्देश जोड़ें।",
-		"loadFromFile": "{{mode}} मोड के लिए विशिष्ट कस्टम निर्देश आपके वर्कस्पेस में <span>.roorules-{{slug}}</span> से भी लोड किए जा सकते हैं (.clinerules-{{slug}} पुराना हो गया है और जल्द ही काम करना बंद कर देगा)।"
+		"loadFromFile": "{{mode}} मोड के लिए विशिष्ट कस्टम निर्देश आपके वर्कस्पेस में <span>.roo/rules-{{slug}}/</span> फ़ोल्डर से भी लोड किए जा सकते हैं (.roorules-{{slug}} और .clinerules-{{slug}} पुराने हो गए हैं और जल्द ही काम करना बंद कर देंगे)।"
 	},
 	"globalCustomInstructions": {
 		"title": "सभी मोड्स के लिए कस्टम निर्देश",
 		"description": "ये निर्देश सभी मोड्स पर लागू होते हैं। वे व्यवहारों का एक आधार सेट प्रदान करते हैं जिन्हें नीचे दिए गए मोड-विशिष्ट निर्देशों द्वारा बढ़ाया जा सकता है।\nयदि आप चाहते हैं कि Roo आपके एडिटर की प्रदर्शन भाषा ({{language}}) से अलग भाषा में सोचे और बोले, तो आप यहां इसे निर्दिष्ट कर सकते हैं।",
-		"loadFromFile": "निर्देश आपके वर्कस्पेस में <span>.roorules</span> से भी लोड किए जा सकते हैं (.clinerules पुराना हो गया है और जल्द ही काम करना बंद कर देगा)।"
+		"loadFromFile": "निर्देश आपके वर्कस्पेस में <span>.roo/rules/</span> फ़ोल्डर से भी लोड किए जा सकते हैं (.roorules और .clinerules पुराने हो गए हैं और जल्द ही काम करना बंद कर देंगे)।"
 	},
 	"systemPrompt": {
 		"preview": "सिस्टम प्रॉम्प्ट का पूर्वावलोकन",

webview-ui/src/i18n/locales/it/prompts.json

@@ -36,12 +36,12 @@
 		"title": "Istruzioni personalizzate specifiche per la modalità (opzionale)",
 		"resetToDefault": "Ripristina predefiniti",
 		"description": "Aggiungi linee guida comportamentali specifiche per la modalità {{modeName}}.",
-		"loadFromFile": "Le istruzioni personalizzate specifiche per la modalità {{mode}} possono essere caricate anche da <span>.roorules-{{slug}}</span> nel tuo spazio di lavoro (.clinerules-{{slug}} è obsoleto e smetterà di funzionare presto)."
+		"loadFromFile": "Le istruzioni personalizzate specifiche per la modalità {{mode}} possono essere caricate anche dalla cartella <span>.roo/rules-{{slug}}/</span> nel tuo spazio di lavoro (.roorules-{{slug}} e .clinerules-{{slug}} sono obsoleti e smetteranno di funzionare presto)."
 	},
 	"globalCustomInstructions": {
 		"title": "Istruzioni personalizzate per tutte le modalità",
 		"description": "Queste istruzioni si applicano a tutte le modalità. Forniscono un insieme base di comportamenti che possono essere migliorati dalle istruzioni specifiche per modalità qui sotto.\nSe desideri che Roo pensi e parli in una lingua diversa dalla lingua di visualizzazione del tuo editor ({{language}}), puoi specificarlo qui.",
-		"loadFromFile": "Le istruzioni possono essere caricate anche da <span>.roorules</span> nel tuo spazio di lavoro (.clinerules è obsoleto e smetterà di funzionare presto)."
+		"loadFromFile": "Le istruzioni possono essere caricate anche dalla cartella <span>.roo/rules/</span> nel tuo spazio di lavoro (.roorules e .clinerules sono obsoleti e smetteranno di funzionare presto)."
 	},
 	"systemPrompt": {
 		"preview": "Anteprima prompt di sistema",

webview-ui/src/i18n/locales/ja/prompts.json

@@ -36,12 +36,12 @@
 		"title": "モード固有のカスタム指示（オプション）",
 		"resetToDefault": "デフォルトにリセット",
 		"description": "{{modeName}}モードに特化した行動ガイドラインを追加します。",
-		"loadFromFile": "{{mode}}モード固有のカスタム指示は、ワークスペースの<span>.roorules-{{slug}}</span>からも読み込めます（.clinerules-{{slug}}は非推奨であり、まもなく機能しなくなります）。"
+		"loadFromFile": "{{mode}}モード固有のカスタム指示は、ワークスペースの<span>.roo/rules-{{slug}}/</span>フォルダからも読み込めます（.roorules-{{slug}}と.clinerules-{{slug}}は非推奨であり、まもなく機能しなくなります）。"
 	},
 	"globalCustomInstructions": {
 		"title": "すべてのモードのカスタム指示",
 		"description": "これらの指示はすべてのモードに適用されます。モード固有の指示で強化できる基本的な動作セットを提供します。\nRooにエディタの表示言語({{language}})とは異なる言語で考えたり話したりさせたい場合は、ここで指定できます。",
-		"loadFromFile": "指示はワークスペースの<span>.roorules</span>からも読み込めます（.clinerules は非推奨であり、まもなく機能しなくなります）。"
+		"loadFromFile": "指示はワークスペースの<span>.roo/rules/</span>フォルダからも読み込めます（.roorules と .clinerules は非推奨であり、まもなく機能しなくなります）。"
 	},
 	"systemPrompt": {
 		"preview": "システムプロンプトのプレビュー",

webview-ui/src/i18n/locales/ko/prompts.json

@@ -36,12 +36,12 @@
 		"title": "모드별 사용자 지정 지침 (선택 사항)",
 		"resetToDefault": "기본값으로 재설정",
 		"description": "{{modeName}} 모드에 대한 특정 행동 지침을 추가하세요.",
-		"loadFromFile": "{{mode}} 모드에 대한 사용자 지정 지침은 작업 공간의 <span>.roorules-{{slug}}</span>에서도 로드할 수 있습니다(.clinerules-{{slug}}는 더 이상 사용되지 않으며 곧 작동을 중단합니다)."
+		"loadFromFile": "{{mode}} 모드에 대한 사용자 지정 지침은 작업 공간의 <span>.roo/rules-{{slug}}/</span> 폴더에서도 로드할 수 있습니다(.roorules-{{slug}}와 .clinerules-{{slug}}는 더 이상 사용되지 않으며 곧 작동을 중단합니다)."
 	},
 	"globalCustomInstructions": {
 		"title": "모든 모드에 대한 사용자 지정 지침",
 		"description": "이 지침은 모든 모드에 적용됩니다. 아래의 모드별 지침으로 향상될 수 있는 기본 동작 세트를 제공합니다.\nRoo가 에디터 표시 언어({{language}})와 다른 언어로 생각하고 말하기를 원하시면, 여기에 지정할 수 있습니다.",
-		"loadFromFile": "지침은 작업 공간의 <span>.roorules</span>에서도 로드할 수 있습니다(.clinerules는 더 이상 사용되지 않으며 곧 작동을 중단합니다)."
+		"loadFromFile": "지침은 작업 공간의 <span>.roo/rules/</span> 폴더에서도 로드할 수 있습니다(.roorules와 .clinerules는 더 이상 사용되지 않으며 곧 작동을 중단합니다)."
 	},
 	"systemPrompt": {
 		"preview": "시스템 프롬프트 미리보기",

webview-ui/src/i18n/locales/pl/prompts.json

@@ -36,12 +36,12 @@
 		"title": "Niestandardowe instrukcje dla trybu (opcjonalne)",
 		"resetToDefault": "Przywróć domyślne",
 		"description": "Dodaj wytyczne dotyczące zachowania specyficzne dla trybu {{modeName}}.",
-		"loadFromFile": "Niestandardowe instrukcje dla trybu {{modeName}} mogą być również ładowane z <span>.roorules-{{modeSlug}}</span> w Twoim obszarze roboczym (.clinerules-{{modeSlug}} jest przestarzały i wkrótce przestanie działać)."
+		"loadFromFile": "Niestandardowe instrukcje dla trybu {{modeName}} mogą być również ładowane z folderu <span>.roo/rules-{{modeSlug}}/</span> w Twoim obszarze roboczym (.roorules-{{modeSlug}} i .clinerules-{{modeSlug}} są przestarzałe i wkrótce przestaną działać)."
 	},
 	"globalCustomInstructions": {
 		"title": "Niestandardowe instrukcje dla wszystkich trybów",
 		"description": "Te instrukcje dotyczą wszystkich trybów. Zapewniają podstawowy zestaw zachowań, które mogą być rozszerzone przez instrukcje specyficzne dla trybów poniżej.\nJeśli chcesz, aby Roo myślał i mówił w języku innym niż język wyświetlania Twojego edytora ({{language}}), możesz to określić tutaj.",
-		"loadFromFile": "Instrukcje mogą być również ładowane z <span>.roorules</span> w Twoim obszarze roboczym (.clinerules jest przestarzały i wkrótce przestanie działać)."
+		"loadFromFile": "Instrukcje mogą być również ładowane z folderu <span>.roo/rules/</span> w Twoim obszarze roboczym (.roorules i .clinerules są przestarzałe i wkrótce przestaną działać)."
 	},
 	"systemPrompt": {
 		"preview": "Podgląd podpowiedzi systemowej",

webview-ui/src/i18n/locales/pt-BR/prompts.json

@@ -36,12 +36,12 @@
 		"title": "Instruções personalizadas específicas do modo (opcional)",
 		"resetToDefault": "Restaurar para padrão",
 		"description": "Adicione diretrizes comportamentais específicas para o modo {{modeName}}.",
-		"loadFromFile": "Instruções personalizadas específicas para o modo {{modeName}} também podem ser carregadas de <span>.roorules-{{modeSlug}}</span> no seu espaço de trabalho (.clinerules-{{modeSlug}} está obsoleto e deixará de funcionar em breve)."
+		"loadFromFile": "Instruções personalizadas específicas para o modo {{modeName}} também podem ser carregadas da pasta <span>.roo/rules-{{modeSlug}}/</span> no seu espaço de trabalho (.roorules-{{modeSlug}} e .clinerules-{{modeSlug}} estão obsoletos e deixarão de funcionar em breve)."
 	},
 	"globalCustomInstructions": {
 		"title": "Instruções personalizadas para todos os modos",
 		"description": "Estas instruções se aplicam a todos os modos. Elas fornecem um conjunto base de comportamentos que podem ser aprimorados por instruções específicas do modo abaixo.\nSe você desejar que o Roo pense e fale em um idioma diferente do idioma de exibição do seu editor ({{language}}), você pode especificá-lo aqui.",
-		"loadFromFile": "As instruções também podem ser carregadas de <span>.roorules</span> no seu espaço de trabalho (.clinerules está obsoleto e deixará de funcionar em breve)."
+		"loadFromFile": "As instruções também podem ser carregadas da pasta <span>.roo/rules/</span> no seu espaço de trabalho (.roorules e .clinerules estão obsoletos e deixarão de funcionar em breve)."
 	},
 	"systemPrompt": {
 		"preview": "Visualizar prompt do sistema",
@@ -62,35 +62,35 @@
 		"types": {
 			"ENHANCE": {
 				"label": "Aprimorar Prompt",
-				"description": "Use prompt enhancement to get tailored suggestions or improvements for your inputs. This ensures Roo understands your intent and provides the best possible responses. Available via the ✨ icon in chat."
+				"description": "Use o aprimoramento de prompt para obter sugestões ou melhorias personalizadas para suas entradas. Isso garante que o Roo entenda sua intenção e forneça as melhores respostas possíveis. Disponível através do ícone ✨ no chat."
 			},
 			"EXPLAIN": {
 				"label": "Explicar Código",
-				"description": "Obtenha explicações detalhadas de trechos de código, funções ou arquivos inteiros. Useful for understanding complex code or learning new patterns. Available in code actions (lightbulb icon in the editor) and the editor context menu (right-click on selected code)."
+				"description": "Obtenha explicações detalhadas de trechos de código, funções ou arquivos inteiros. Útil para entender código complexo ou aprender novos padrões. Disponível nas ações de código (ícone de lâmpada no editor) e no menu de contexto do editor (clique direito no código selecionado)."
 			},
 			"FIX": {
 				"label": "Corrigir Problemas",
-				"description": "Obtenha ajuda para identificar e resolver bugs, erros ou code quality issues. Provides step-by-step guidance for fixing problems. Available in code actions (lightbulb icon in the editor) and the editor context menu (right-click on selected code)."
+				"description": "Obtenha ajuda para identificar e resolver bugs, erros ou problemas de qualidade de código. Fornece orientação passo a passo para corrigir problemas. Disponível nas ações de código (ícone de lâmpada no editor) e no menu de contexto do editor (clique direito no código selecionado)."
 			},
 			"IMPROVE": {
 				"label": "Melhorar Código",
-				"description": "Receba sugestões para code optimization, better practices e architectural improvements while maintaining functionality. Available in code actions (lightbulb icon in the editor) and the editor context menu (right-click on selected code)."
+				"description": "Receba sugestões para otimização de código, melhores práticas e melhorias arquitetônicas mantendo a funcionalidade. Disponível nas ações de código (ícone de lâmpada no editor) e no menu de contexto do editor (clique direito no código selecionado)."
 			},
 			"ADD_TO_CONTEXT": {
 				"label": "Adicionar ao Contexto",
-				"description": "Adicione contexto à sua tarefa ou conversa atual. Useful for providing additional information or clarifications. Available in code actions (lightbulb icon in the editor) and the editor context menu (right-click on selected code)."
+				"description": "Adicione contexto à sua tarefa ou conversa atual. Útil para fornecer informações adicionais ou esclarecimentos. Disponível nas ações de código (ícone de lâmpada no editor) e no menu de contexto do editor (clique direito no código selecionado)."
 			},
 			"TERMINAL_ADD_TO_CONTEXT": {
 				"label": "Adicionar Conteúdo do Terminal ao Contexto",
-				"description": "Adicione a saída do terminal à sua tarefa ou conversa atual. Useful for providing command outputs or logs. Available in the terminal context menu (right-click on selected terminal content)."
+				"description": "Adicione a saída do terminal à sua tarefa ou conversa atual. Útil para fornecer saídas de comandos ou logs. Disponível no menu de contexto do terminal (clique direito no conteúdo selecionado do terminal)."
 			},
 			"TERMINAL_FIX": {
 				"label": "Corrigir Comando do Terminal",
-				"description": "Obtenha ajuda para corrigir comandos de terminal que falharam ou precisam de melhorias. Available in the terminal context menu (right-click on selected terminal content)."
+				"description": "Obtenha ajuda para corrigir comandos de terminal que falharam ou precisam de melhorias. Disponível no menu de contexto do terminal (clique direito no conteúdo selecionado do terminal)."
 			},
 			"TERMINAL_EXPLAIN": {
 				"label": "Explicar Comando do Terminal",
-				"description": "Obtenha explicações detalhadas de comandos de terminal e suas saídas. Available in the terminal context menu (right-click on selected terminal content)."
+				"description": "Obtenha explicações detalhadas de comandos de terminal e suas saídas. Disponível no menu de contexto do terminal (clique direito no conteúdo selecionado do terminal)."
 			},
 			"NEW_TASK": {
 				"label": "Iniciar Nova Tarefa",

webview-ui/src/i18n/locales/tr/prompts.json

@@ -36,12 +36,12 @@
 		"title": "Moda özgü özel talimatlar (isteğe bağlı)",
 		"resetToDefault": "Varsayılana sıfırla",
 		"description": "{{modeName}} modu için özel davranış yönergeleri ekleyin.",
-		"loadFromFile": "{{mode}} moduna özgü özel talimatlar ayrıca çalışma alanınızdaki <span>.roorules-{{slug}}</span> adresinden yüklenebilir (.clinerules-{{slug}} kullanımdan kaldırılmıştır ve yakında çalışmayı durduracaktır)."
+		"loadFromFile": "{{mode}} moduna özgü özel talimatlar ayrıca çalışma alanınızdaki <span>.roo/rules-{{slug}}/</span> klasöründen yüklenebilir (.roorules-{{slug}} ve .clinerules-{{slug}} kullanımdan kaldırılmıştır ve yakında çalışmayı durduracaklardır)."
 	},
 	"globalCustomInstructions": {
 		"title": "Tüm Modlar için Özel Talimatlar",
 		"description": "Bu talimatlar tüm modlara uygulanır. Aşağıdaki moda özgü talimatlarla geliştirilebilen temel davranış seti sağlarlar.\nRoo'nun editörünüzün görüntüleme dilinden ({{language}}) farklı bir dilde düşünmesini ve konuşmasını istiyorsanız, burada belirtebilirsiniz.",
-		"loadFromFile": "Talimatlar ayrıca çalışma alanınızdaki <span>.roorules</span> adresinden de yüklenebilir (.clinerules kullanımdan kaldırılmıştır ve yakında çalışmayı durduracaktır)."
+		"loadFromFile": "Talimatlar ayrıca çalışma alanınızdaki <span>.roo/rules/</span> klasöründen de yüklenebilir (.roorules ve .clinerules kullanımdan kaldırılmıştır ve yakında çalışmayı durduracaklardır)."
 	},
 	"systemPrompt": {
 		"preview": "Sistem promptunu önizle",

webview-ui/src/i18n/locales/vi/prompts.json

@@ -36,12 +36,12 @@
 		"title": "Hướng dẫn tùy chỉnh dành riêng cho chế độ (tùy chọn)",
 		"resetToDefault": "Đặt lại về mặc định",
 		"description": "Thêm hướng dẫn hành vi dành riêng cho chế độ {{modeName}}.",
-		"loadFromFile": "Hướng dẫn tùy chỉnh dành riêng cho chế độ {{modeName}} cũng có thể được tải từ <span>.roorules-{{modeSlug}}</span> trong không gian làm việc của bạn (.clinerules-{{modeSlug}} đã lỗi thời và sẽ sớm ngừng hoạt động)."
+		"loadFromFile": "Hướng dẫn tùy chỉnh dành riêng cho chế độ {{modeName}} cũng có thể được tải từ thư mục <span>.roo/rules-{{modeSlug}}/</span> trong không gian làm việc của bạn (.roorules-{{modeSlug}} và .clinerules-{{modeSlug}} đã lỗi thời và sẽ sớm ngừng hoạt động)."
 	},
 	"globalCustomInstructions": {
 		"title": "Hướng dẫn tùy chỉnh cho tất cả các chế độ",
 		"description": "Những hướng dẫn này áp dụng cho tất cả các chế độ. Chúng cung cấp một bộ hành vi cơ bản có thể được nâng cao bởi hướng dẫn dành riêng cho chế độ bên dưới.\nNếu bạn muốn Roo suy nghĩ và nói bằng ngôn ngữ khác với ngôn ngữ hiển thị trình soạn thảo của bạn ({{language}}), bạn có thể chỉ định ở đây.",
-		"loadFromFile": "Hướng dẫn cũng có thể được tải từ <span>.roorules</span> trong không gian làm việc của bạn (.clinerules đã lỗi thời và sẽ sớm ngừng hoạt động)."
+		"loadFromFile": "Hướng dẫn cũng có thể được tải từ thư mục <span>.roo/rules/</span> trong không gian làm việc của bạn (.roorules và .clinerules đã lỗi thời và sẽ sớm ngừng hoạt động)."
 	},
 	"systemPrompt": {
 		"preview": "Xem trước lời nhắc hệ thống",

webview-ui/src/i18n/locales/zh-CN/prompts.json

@@ -36,12 +36,12 @@
 		"title": "模式专属规则（可选）",
 		"resetToDefault": "重置为默认值",
 		"description": "{{modeName}}模式的专属规则",
-		"loadFromFile": "支持从<span>.roorules-{{slug}}</span>文件读取配置（.clinerules-{{slug}}已弃用并将很快停止工作）。"
+		"loadFromFile": "支持从<span>.roo/rules-{{slug}}/</span>目录读取配置（.roorules-{{slug}}和.clinerules-{{slug}}已弃用并将很快停止工作）。"
 	},
 	"globalCustomInstructions": {
 		"title": "所有模式的自定义指令",
 		"description": "所有模式通用规则\n当前语言：{{language}}",
-		"loadFromFile": "支持从<span>.roorules</span>文件读取全局配置（.clinerules已弃用并将很快停止工作）。"
+		"loadFromFile": "支持从<span>.roo/rules/</span>目录读取全局配置（.roorules和.clinerules已弃用并将很快停止工作）。"
 	},
 	"systemPrompt": {
 		"preview": "预览系统提示词",

webview-ui/src/i18n/locales/zh-TW/prompts.json

@@ -36,12 +36,12 @@
 		"title": "模式專屬自訂指令（選用）",
 		"resetToDefault": "重設為預設值",
 		"description": "為 {{modeName}} 模式新增專屬的行為指南。",
-		"loadFromFile": "{{mode}} 模式的自訂指令也可以從工作區的 <span>.roorules-{{slug}}</span> 載入（.clinerules-{{slug}} 已棄用並將很快停止運作）。"
+		"loadFromFile": "{{mode}} 模式的自訂指令也可以從工作區的 <span>.roo/rules-{{slug}}/</span> 資料夾載入（.roorules-{{slug}} 和 .clinerules-{{slug}} 已棄用並將很快停止運作）。"
 	},
 	"globalCustomInstructions": {
 		"title": "所有模式的自訂指令",
 		"description": "這些指令適用於所有模式。它們提供了一組基本行為，可以透過下方的模式專屬自訂指令來強化。\n如果您希望 Roo 使用與編輯器顯示語言 ({{language}}) 不同的語言來思考和對話，您可以在這裡指定。",
-		"loadFromFile": "指令也可以從工作區的 <span>.roorules</span> 載入（.clinerules 已棄用並將很快停止運作）。"
+		"loadFromFile": "指令也可以從工作區的 <span>.roo/rules/</span> 資料夾載入（.roorules 和 .clinerules 已棄用並將很快停止運作）。"
 	},
 	"systemPrompt": {
 		"preview": "預覽系統提示詞",