rulesync 3.26.0 → 3.27.1

package/README.md

@@ -10,6 +10,7 @@
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/dyoshikawa/rulesync)
 [![Mentioned in Awesome Claude Code](https://awesome.re/mentioned-badge.svg)](https://github.com/hesreallyhim/awesome-claude-code)
 [![Mentioned in Awesome Gemini CLI](https://awesome.re/mentioned-badge.svg)](https://github.com/Piebald-AI/awesome-gemini-cli)
+<a href="https://flatt.tech/oss/gmo/trampoline" target="_blank"><img src="https://flatt.tech/assets/images/badges/gmo-oss.svg" height="24px"/></a>
 
 A Node.js CLI tool that automatically generates configuration files for various AI development tools from unified AI rule files. Features selective generation, comprehensive import/export capabilities, and supports major AI development tools with rules, commands, MCP, ignore files, subagents and skills.
 
@@ -142,7 +143,7 @@ Rulesync supports both **generation** and **import** for All of the major AI cod
 | Gemini CLI             |  ✅ 🌏  |   ✅   |  ✅ 🌏  |     ✅ 🌏  |      🎮     |    🎮   |
 | GitHub Copilot         |  ✅    |       |  ✅    |     ✅     |    🎮      |    🎮   |
 | Cursor                 |  ✅   |   ✅  |   ✅   |     ✅ 🌏  |     🎮     |    🎮   |
-| OpenCode               |  ✅   |       |       |         |          |        |
+| OpenCode               |  ✅   |       |   ✅   |         |          |        |
 | Cline                  |  ✅    |   ✅    |  ✅    |          |          |        |
 | Roo Code               |  ✅   |   ✅   |  ✅    |   ✅     |     🎮     |        |
 | Qwen Code              |  ✅   |   ✅   |       |         |          |        |
@@ -390,7 +391,21 @@ Example:
 }
 ```
 
-### `.rulesyncignore`
+### `.rulesync/.aiignore` or `.rulesyncignore`
+
+Rulesync supports a single ignore list that can live in either location below:
+
+- `.rulesync/.aiignore` (recommended)
+- `.rulesyncignore` (project root)
+
+Rules and behavior:
+
+- You may use either location.
+- When both exist, Rulesync prefers `.rulesync/.aiignore` (recommended) over `.rulesyncignore` (legacy) when reading.
+- If neither file exists yet, Rulesync defaults to creating `.rulesync/.aiignore`.
+
+Notes:
+- Running `rulesync init` will create `.rulesync/.aiignore` if no ignore file is present.
 
 Example:
 

package/dist/index.cjs

@@ -499,6 +499,8 @@ var RULESYNC_RULES_RELATIVE_DIR_PATH = (0, import_node_path3.join)(RULESYNC_RELA
 var RULESYNC_COMMANDS_RELATIVE_DIR_PATH = (0, import_node_path3.join)(RULESYNC_RELATIVE_DIR_PATH, "commands");
 var RULESYNC_SUBAGENTS_RELATIVE_DIR_PATH = (0, import_node_path3.join)(RULESYNC_RELATIVE_DIR_PATH, "subagents");
 var RULESYNC_MCP_RELATIVE_FILE_PATH = (0, import_node_path3.join)(RULESYNC_RELATIVE_DIR_PATH, "mcp.json");
+var RULESYNC_AIIGNORE_FILE_NAME = ".aiignore";
+var RULESYNC_AIIGNORE_RELATIVE_FILE_PATH = (0, import_node_path3.join)(RULESYNC_RELATIVE_DIR_PATH, ".aiignore");
 var RULESYNC_IGNORE_RELATIVE_FILE_PATH = ".rulesyncignore";
 var RULESYNC_OVERVIEW_FILE_NAME = "overview.md";
 var RULESYNC_SKILLS_RELATIVE_DIR_PATH = (0, import_node_path3.join)(RULESYNC_RELATIVE_DIR_PATH, "skills");
@@ -1938,18 +1940,48 @@ var RulesyncIgnore = class _RulesyncIgnore extends RulesyncFile {
   }
   static getSettablePaths() {
     return {
-      relativeDirPath: ".",
-      relativeFilePath: RULESYNC_IGNORE_RELATIVE_FILE_PATH
+      recommended: {
+        relativeDirPath: RULESYNC_RELATIVE_DIR_PATH,
+        relativeFilePath: RULESYNC_AIIGNORE_FILE_NAME
+      },
+      legacy: {
+        relativeDirPath: ".",
+        relativeFilePath: RULESYNC_IGNORE_RELATIVE_FILE_PATH
+      }
     };
   }
   static async fromFile() {
     const baseDir = process.cwd();
-    const filePath = (0, import_node_path15.join)(baseDir, this.getSettablePaths().relativeFilePath);
-    const fileContent = await readFileContent(filePath);
+    const paths = this.getSettablePaths();
+    const recommendedPath = (0, import_node_path15.join)(
+      baseDir,
+      paths.recommended.relativeDirPath,
+      paths.recommended.relativeFilePath
+    );
+    const legacyPath = (0, import_node_path15.join)(baseDir, paths.legacy.relativeDirPath, paths.legacy.relativeFilePath);
+    if (await fileExists(recommendedPath)) {
+      const fileContent2 = await readFileContent(recommendedPath);
+      return new _RulesyncIgnore({
+        baseDir,
+        relativeDirPath: paths.recommended.relativeDirPath,
+        relativeFilePath: paths.recommended.relativeFilePath,
+        fileContent: fileContent2
+      });
+    }
+    if (await fileExists(legacyPath)) {
+      const fileContent2 = await readFileContent(legacyPath);
+      return new _RulesyncIgnore({
+        baseDir,
+        relativeDirPath: paths.legacy.relativeDirPath,
+        relativeFilePath: paths.legacy.relativeFilePath,
+        fileContent: fileContent2
+      });
+    }
+    const fileContent = await readFileContent(recommendedPath);
     return new _RulesyncIgnore({
       baseDir,
-      relativeDirPath: this.getSettablePaths().relativeDirPath,
-      relativeFilePath: this.getSettablePaths().relativeFilePath,
+      relativeDirPath: paths.recommended.relativeDirPath,
+      relativeFilePath: paths.recommended.relativeFilePath,
       fileContent
     });
   }
@@ -1986,8 +2018,8 @@ var ToolIgnore = class extends ToolFile {
   toRulesyncIgnoreDefault() {
     return new RulesyncIgnore({
       baseDir: ".",
-      relativeDirPath: ".",
-      relativeFilePath: RULESYNC_IGNORE_RELATIVE_FILE_PATH,
+      relativeDirPath: RULESYNC_RELATIVE_DIR_PATH,
+      relativeFilePath: RULESYNC_AIIGNORE_FILE_NAME,
       fileContent: this.fileContent
     });
   }
@@ -2131,8 +2163,8 @@ var ClaudecodeIgnore = class _ClaudecodeIgnore extends ToolIgnore {
     const fileContent = rulesyncPatterns.join("\n");
     return new RulesyncIgnore({
       baseDir: this.baseDir,
-      relativeDirPath: RulesyncIgnore.getSettablePaths().relativeDirPath,
-      relativeFilePath: RulesyncIgnore.getSettablePaths().relativeFilePath,
+      relativeDirPath: RulesyncIgnore.getSettablePaths().recommended.relativeDirPath,
+      relativeFilePath: RulesyncIgnore.getSettablePaths().recommended.relativeFilePath,
       fileContent
     });
   }
@@ -2254,7 +2286,7 @@ var CursorIgnore = class _CursorIgnore extends ToolIgnore {
     return new RulesyncIgnore({
       baseDir: ".",
       relativeDirPath: ".",
-      relativeFilePath: RULESYNC_IGNORE_RELATIVE_FILE_PATH,
+      relativeFilePath: RULESYNC_AIIGNORE_RELATIVE_FILE_PATH,
       fileContent: this.fileContent
     });
   }
@@ -2661,7 +2693,7 @@ var IgnoreProcessor = class extends FeatureProcessor {
       (file) => file instanceof RulesyncIgnore
     );
     if (!rulesyncIgnore) {
-      throw new Error(`No ${RULESYNC_IGNORE_RELATIVE_FILE_PATH} found.`);
+      throw new Error(`No ${RULESYNC_AIIGNORE_RELATIVE_FILE_PATH} found.`);
     }
     const toolIgnores = await Promise.all(
       [rulesyncIgnore].map(async (rulesyncIgnore2) => {
@@ -4551,7 +4583,8 @@ var DirFeatureProcessor = class {
       const mainFile = aiDir.getMainFile();
       if (mainFile) {
         const mainFilePath = (0, import_node_path44.join)(dirPath, mainFile.name);
-        const contentWithNewline = addTrailingNewline(mainFile.body);
+        const content = stringifyFrontmatter(mainFile.body, mainFile.frontmatter);
+        const contentWithNewline = addTrailingNewline(content);
         await writeFileContent(mainFilePath, contentWithNewline);
       }
       const otherFiles = aiDir.getOtherFiles();
@@ -8698,7 +8731,6 @@ var gitignoreCommand = async () => {
     // AGENTS.md
     "**/AGENTS.md",
     "**/.agents/",
-    "**/.agents/skills/",
     // Amazon Q
     "**/.amazonq/",
     // Augment
@@ -8724,9 +8756,6 @@ var gitignoreCommand = async () => {
     // Cursor
     "**/.cursor/",
     "**/.cursorignore",
-    "**/.cursor/mcp.json",
-    "**/.cursor/subagents/",
-    "**/.cursor/skills/",
     // Gemini
     "**/GEMINI.md",
     "**/.gemini/memories/",
@@ -8762,7 +8791,8 @@ var gitignoreCommand = async () => {
     "**/.warp/",
     "**/WARP.md",
     // Others
-    "**/modular-mcp.json"
+    "**/modular-mcp.json",
+    "!.rulesync/.aiignore"
   ];
   let gitignoreContent = "";
   if (await fileExists(gitignorePath)) {
@@ -8977,7 +9007,7 @@ async function initCommand() {
   logger.success("rulesync initialized successfully!");
   logger.info("Next steps:");
   logger.info(
-    `1. Edit ${RULESYNC_RELATIVE_DIR_PATH}/**/*.md, ${RULESYNC_MCP_RELATIVE_FILE_PATH} and ${RULESYNC_IGNORE_RELATIVE_FILE_PATH}`
+    `1. Edit ${RULESYNC_RELATIVE_DIR_PATH}/**/*.md, ${RULESYNC_MCP_RELATIVE_FILE_PATH} and ${RULESYNC_AIIGNORE_RELATIVE_FILE_PATH}`
   );
   logger.info("2. Run 'rulesync generate' to create configuration files");
 }
@@ -9130,7 +9160,7 @@ Attention, again, you are just the planner, so though you can read any files and
   await ensureDir(mcpPaths.recommended.relativeDirPath);
   await ensureDir(commandPaths.relativeDirPath);
   await ensureDir(subagentPaths.relativeDirPath);
-  await ensureDir(ignorePaths.relativeDirPath);
+  await ensureDir(ignorePaths.recommended.relativeDirPath);
   const ruleFilepath = (0, import_node_path81.join)(rulePaths.recommended.relativeDirPath, sampleRuleFile.filename);
   if (!await fileExists(ruleFilepath)) {
     await writeFileContent(ruleFilepath, sampleRuleFile.content);
@@ -9162,7 +9192,10 @@ Attention, again, you are just the planner, so though you can read any files and
   } else {
     logger.info(`Skipped ${subagentFilepath} (already exists)`);
   }
-  const ignoreFilepath = (0, import_node_path81.join)(ignorePaths.relativeDirPath, ignorePaths.relativeFilePath);
+  const ignoreFilepath = (0, import_node_path81.join)(
+    ignorePaths.recommended.relativeDirPath,
+    ignorePaths.recommended.relativeFilePath
+  );
   if (!await fileExists(ignoreFilepath)) {
     await writeFileContent(ignoreFilepath, sampleIgnoreFile.content);
     logger.success(`Created ${ignoreFilepath}`);
@@ -9357,21 +9390,21 @@ var import_node_path83 = require("path");
 var import_mini31 = require("zod/mini");
 var maxIgnoreFileSizeBytes = 100 * 1024;
 async function getIgnoreFile() {
-  const ignoreFilePath = (0, import_node_path83.join)(process.cwd(), RULESYNC_IGNORE_RELATIVE_FILE_PATH);
+  const ignoreFilePath = (0, import_node_path83.join)(process.cwd(), RULESYNC_AIIGNORE_RELATIVE_FILE_PATH);
   try {
     const content = await readFileContent(ignoreFilePath);
     return {
-      relativePathFromCwd: RULESYNC_IGNORE_RELATIVE_FILE_PATH,
+      relativePathFromCwd: RULESYNC_AIIGNORE_RELATIVE_FILE_PATH,
       content
     };
   } catch (error) {
-    throw new Error(`Failed to read .rulesyncignore file: ${formatError(error)}`, {
+    throw new Error(`Failed to read .rulesync/.aiignore file: ${formatError(error)}`, {
       cause: error
     });
   }
 }
 async function putIgnoreFile({ content }) {
-  const ignoreFilePath = (0, import_node_path83.join)(process.cwd(), RULESYNC_IGNORE_RELATIVE_FILE_PATH);
+  const ignoreFilePath = (0, import_node_path83.join)(process.cwd(), RULESYNC_AIIGNORE_RELATIVE_FILE_PATH);
   const contentSizeBytes = Buffer.byteLength(content, "utf8");
   if (contentSizeBytes > maxIgnoreFileSizeBytes) {
     throw new Error(
@@ -9382,26 +9415,32 @@ async function putIgnoreFile({ content }) {
     await ensureDir(process.cwd());
     await writeFileContent(ignoreFilePath, content);
     return {
-      relativePathFromCwd: RULESYNC_IGNORE_RELATIVE_FILE_PATH,
+      relativePathFromCwd: RULESYNC_AIIGNORE_RELATIVE_FILE_PATH,
       content
     };
   } catch (error) {
-    throw new Error(`Failed to write .rulesyncignore file: ${formatError(error)}`, {
+    throw new Error(`Failed to write .rulesync/.aiignore file: ${formatError(error)}`, {
       cause: error
     });
   }
 }
 async function deleteIgnoreFile() {
-  const ignoreFilePath = (0, import_node_path83.join)(process.cwd(), RULESYNC_IGNORE_RELATIVE_FILE_PATH);
+  const aiignorePath = (0, import_node_path83.join)(process.cwd(), RULESYNC_AIIGNORE_RELATIVE_FILE_PATH);
+  const legacyIgnorePath = (0, import_node_path83.join)(process.cwd(), RULESYNC_IGNORE_RELATIVE_FILE_PATH);
   try {
-    await removeFile(ignoreFilePath);
+    await Promise.all([removeFile(aiignorePath), removeFile(legacyIgnorePath)]);
     return {
-      relativePathFromCwd: RULESYNC_IGNORE_RELATIVE_FILE_PATH
+      // Keep the historical return shape — point to the recommended file path
+      // for backward compatibility.
+      relativePathFromCwd: RULESYNC_AIIGNORE_RELATIVE_FILE_PATH
     };
   } catch (error) {
-    throw new Error(`Failed to delete .rulesyncignore file: ${formatError(error)}`, {
-      cause: error
-    });
+    throw new Error(
+      `Failed to delete .rulesyncignore and .rulesync/.aiignore files: ${formatError(error)}`,
+      {
+        cause: error
+      }
+    );
   }
 }
 var ignoreToolSchemas = {
@@ -9423,7 +9462,7 @@ var ignoreTools = {
   },
   putIgnoreFile: {
     name: "putIgnoreFile",
-    description: "Create or update the .rulesyncignore file (upsert operation). content parameter is required.",
+    description: "Create or update the .rulesync/.aiignore file (upsert operation). content parameter is required.",
     parameters: ignoreToolSchemas.putIgnoreFile,
     execute: async (args) => {
       const result = await putIgnoreFile({ content: args.content });
@@ -9432,7 +9471,7 @@ var ignoreTools = {
   },
   deleteIgnoreFile: {
     name: "deleteIgnoreFile",
-    description: "Delete the .rulesyncignore file from the project root.",
+    description: "Delete the .rulesyncignore and .rulesync/.aiignore files.",
     parameters: ignoreToolSchemas.deleteIgnoreFile,
     execute: async () => {
       const result = await deleteIgnoreFile();
@@ -9963,7 +10002,7 @@ async function mcpCommand({ version }) {
 }
 
 // src/cli/index.ts
-var getVersion = () => "3.26.0";
+var getVersion = () => "3.27.1";
 var main = async () => {
   const program = new import_commander.Command();
   const version = getVersion();

package/dist/index.js

@@ -476,6 +476,8 @@ var RULESYNC_RULES_RELATIVE_DIR_PATH = join2(RULESYNC_RELATIVE_DIR_PATH, "rules"
 var RULESYNC_COMMANDS_RELATIVE_DIR_PATH = join2(RULESYNC_RELATIVE_DIR_PATH, "commands");
 var RULESYNC_SUBAGENTS_RELATIVE_DIR_PATH = join2(RULESYNC_RELATIVE_DIR_PATH, "subagents");
 var RULESYNC_MCP_RELATIVE_FILE_PATH = join2(RULESYNC_RELATIVE_DIR_PATH, "mcp.json");
+var RULESYNC_AIIGNORE_FILE_NAME = ".aiignore";
+var RULESYNC_AIIGNORE_RELATIVE_FILE_PATH = join2(RULESYNC_RELATIVE_DIR_PATH, ".aiignore");
 var RULESYNC_IGNORE_RELATIVE_FILE_PATH = ".rulesyncignore";
 var RULESYNC_OVERVIEW_FILE_NAME = "overview.md";
 var RULESYNC_SKILLS_RELATIVE_DIR_PATH = join2(RULESYNC_RELATIVE_DIR_PATH, "skills");
@@ -1915,18 +1917,48 @@ var RulesyncIgnore = class _RulesyncIgnore extends RulesyncFile {
   }
   static getSettablePaths() {
     return {
-      relativeDirPath: ".",
-      relativeFilePath: RULESYNC_IGNORE_RELATIVE_FILE_PATH
+      recommended: {
+        relativeDirPath: RULESYNC_RELATIVE_DIR_PATH,
+        relativeFilePath: RULESYNC_AIIGNORE_FILE_NAME
+      },
+      legacy: {
+        relativeDirPath: ".",
+        relativeFilePath: RULESYNC_IGNORE_RELATIVE_FILE_PATH
+      }
     };
   }
   static async fromFile() {
     const baseDir = process.cwd();
-    const filePath = join13(baseDir, this.getSettablePaths().relativeFilePath);
-    const fileContent = await readFileContent(filePath);
+    const paths = this.getSettablePaths();
+    const recommendedPath = join13(
+      baseDir,
+      paths.recommended.relativeDirPath,
+      paths.recommended.relativeFilePath
+    );
+    const legacyPath = join13(baseDir, paths.legacy.relativeDirPath, paths.legacy.relativeFilePath);
+    if (await fileExists(recommendedPath)) {
+      const fileContent2 = await readFileContent(recommendedPath);
+      return new _RulesyncIgnore({
+        baseDir,
+        relativeDirPath: paths.recommended.relativeDirPath,
+        relativeFilePath: paths.recommended.relativeFilePath,
+        fileContent: fileContent2
+      });
+    }
+    if (await fileExists(legacyPath)) {
+      const fileContent2 = await readFileContent(legacyPath);
+      return new _RulesyncIgnore({
+        baseDir,
+        relativeDirPath: paths.legacy.relativeDirPath,
+        relativeFilePath: paths.legacy.relativeFilePath,
+        fileContent: fileContent2
+      });
+    }
+    const fileContent = await readFileContent(recommendedPath);
     return new _RulesyncIgnore({
       baseDir,
-      relativeDirPath: this.getSettablePaths().relativeDirPath,
-      relativeFilePath: this.getSettablePaths().relativeFilePath,
+      relativeDirPath: paths.recommended.relativeDirPath,
+      relativeFilePath: paths.recommended.relativeFilePath,
       fileContent
     });
   }
@@ -1963,8 +1995,8 @@ var ToolIgnore = class extends ToolFile {
   toRulesyncIgnoreDefault() {
     return new RulesyncIgnore({
       baseDir: ".",
-      relativeDirPath: ".",
-      relativeFilePath: RULESYNC_IGNORE_RELATIVE_FILE_PATH,
+      relativeDirPath: RULESYNC_RELATIVE_DIR_PATH,
+      relativeFilePath: RULESYNC_AIIGNORE_FILE_NAME,
       fileContent: this.fileContent
     });
   }
@@ -2108,8 +2140,8 @@ var ClaudecodeIgnore = class _ClaudecodeIgnore extends ToolIgnore {
     const fileContent = rulesyncPatterns.join("\n");
     return new RulesyncIgnore({
       baseDir: this.baseDir,
-      relativeDirPath: RulesyncIgnore.getSettablePaths().relativeDirPath,
-      relativeFilePath: RulesyncIgnore.getSettablePaths().relativeFilePath,
+      relativeDirPath: RulesyncIgnore.getSettablePaths().recommended.relativeDirPath,
+      relativeFilePath: RulesyncIgnore.getSettablePaths().recommended.relativeFilePath,
       fileContent
     });
   }
@@ -2231,7 +2263,7 @@ var CursorIgnore = class _CursorIgnore extends ToolIgnore {
     return new RulesyncIgnore({
       baseDir: ".",
       relativeDirPath: ".",
-      relativeFilePath: RULESYNC_IGNORE_RELATIVE_FILE_PATH,
+      relativeFilePath: RULESYNC_AIIGNORE_RELATIVE_FILE_PATH,
       fileContent: this.fileContent
     });
   }
@@ -2638,7 +2670,7 @@ var IgnoreProcessor = class extends FeatureProcessor {
       (file) => file instanceof RulesyncIgnore
     );
     if (!rulesyncIgnore) {
-      throw new Error(`No ${RULESYNC_IGNORE_RELATIVE_FILE_PATH} found.`);
+      throw new Error(`No ${RULESYNC_AIIGNORE_RELATIVE_FILE_PATH} found.`);
     }
     const toolIgnores = await Promise.all(
       [rulesyncIgnore].map(async (rulesyncIgnore2) => {
@@ -4528,7 +4560,8 @@ var DirFeatureProcessor = class {
       const mainFile = aiDir.getMainFile();
       if (mainFile) {
         const mainFilePath = join42(dirPath, mainFile.name);
-        const contentWithNewline = addTrailingNewline(mainFile.body);
+        const content = stringifyFrontmatter(mainFile.body, mainFile.frontmatter);
+        const contentWithNewline = addTrailingNewline(content);
         await writeFileContent(mainFilePath, contentWithNewline);
       }
       const otherFiles = aiDir.getOtherFiles();
@@ -8675,7 +8708,6 @@ var gitignoreCommand = async () => {
     // AGENTS.md
     "**/AGENTS.md",
     "**/.agents/",
-    "**/.agents/skills/",
     // Amazon Q
     "**/.amazonq/",
     // Augment
@@ -8701,9 +8733,6 @@ var gitignoreCommand = async () => {
     // Cursor
     "**/.cursor/",
     "**/.cursorignore",
-    "**/.cursor/mcp.json",
-    "**/.cursor/subagents/",
-    "**/.cursor/skills/",
     // Gemini
     "**/GEMINI.md",
     "**/.gemini/memories/",
@@ -8739,7 +8768,8 @@ var gitignoreCommand = async () => {
     "**/.warp/",
     "**/WARP.md",
     // Others
-    "**/modular-mcp.json"
+    "**/modular-mcp.json",
+    "!.rulesync/.aiignore"
   ];
   let gitignoreContent = "";
   if (await fileExists(gitignorePath)) {
@@ -8954,7 +8984,7 @@ async function initCommand() {
   logger.success("rulesync initialized successfully!");
   logger.info("Next steps:");
   logger.info(
-    `1. Edit ${RULESYNC_RELATIVE_DIR_PATH}/**/*.md, ${RULESYNC_MCP_RELATIVE_FILE_PATH} and ${RULESYNC_IGNORE_RELATIVE_FILE_PATH}`
+    `1. Edit ${RULESYNC_RELATIVE_DIR_PATH}/**/*.md, ${RULESYNC_MCP_RELATIVE_FILE_PATH} and ${RULESYNC_AIIGNORE_RELATIVE_FILE_PATH}`
   );
   logger.info("2. Run 'rulesync generate' to create configuration files");
 }
@@ -9107,7 +9137,7 @@ Attention, again, you are just the planner, so though you can read any files and
   await ensureDir(mcpPaths.recommended.relativeDirPath);
   await ensureDir(commandPaths.relativeDirPath);
   await ensureDir(subagentPaths.relativeDirPath);
-  await ensureDir(ignorePaths.relativeDirPath);
+  await ensureDir(ignorePaths.recommended.relativeDirPath);
   const ruleFilepath = join79(rulePaths.recommended.relativeDirPath, sampleRuleFile.filename);
   if (!await fileExists(ruleFilepath)) {
     await writeFileContent(ruleFilepath, sampleRuleFile.content);
@@ -9139,7 +9169,10 @@ Attention, again, you are just the planner, so though you can read any files and
   } else {
     logger.info(`Skipped ${subagentFilepath} (already exists)`);
   }
-  const ignoreFilepath = join79(ignorePaths.relativeDirPath, ignorePaths.relativeFilePath);
+  const ignoreFilepath = join79(
+    ignorePaths.recommended.relativeDirPath,
+    ignorePaths.recommended.relativeFilePath
+  );
   if (!await fileExists(ignoreFilepath)) {
     await writeFileContent(ignoreFilepath, sampleIgnoreFile.content);
     logger.success(`Created ${ignoreFilepath}`);
@@ -9334,21 +9367,21 @@ import { join as join81 } from "path";
 import { z as z31 } from "zod/mini";
 var maxIgnoreFileSizeBytes = 100 * 1024;
 async function getIgnoreFile() {
-  const ignoreFilePath = join81(process.cwd(), RULESYNC_IGNORE_RELATIVE_FILE_PATH);
+  const ignoreFilePath = join81(process.cwd(), RULESYNC_AIIGNORE_RELATIVE_FILE_PATH);
   try {
     const content = await readFileContent(ignoreFilePath);
     return {
-      relativePathFromCwd: RULESYNC_IGNORE_RELATIVE_FILE_PATH,
+      relativePathFromCwd: RULESYNC_AIIGNORE_RELATIVE_FILE_PATH,
       content
     };
   } catch (error) {
-    throw new Error(`Failed to read .rulesyncignore file: ${formatError(error)}`, {
+    throw new Error(`Failed to read .rulesync/.aiignore file: ${formatError(error)}`, {
       cause: error
     });
   }
 }
 async function putIgnoreFile({ content }) {
-  const ignoreFilePath = join81(process.cwd(), RULESYNC_IGNORE_RELATIVE_FILE_PATH);
+  const ignoreFilePath = join81(process.cwd(), RULESYNC_AIIGNORE_RELATIVE_FILE_PATH);
   const contentSizeBytes = Buffer.byteLength(content, "utf8");
   if (contentSizeBytes > maxIgnoreFileSizeBytes) {
     throw new Error(
@@ -9359,26 +9392,32 @@ async function putIgnoreFile({ content }) {
     await ensureDir(process.cwd());
     await writeFileContent(ignoreFilePath, content);
     return {
-      relativePathFromCwd: RULESYNC_IGNORE_RELATIVE_FILE_PATH,
+      relativePathFromCwd: RULESYNC_AIIGNORE_RELATIVE_FILE_PATH,
       content
     };
   } catch (error) {
-    throw new Error(`Failed to write .rulesyncignore file: ${formatError(error)}`, {
+    throw new Error(`Failed to write .rulesync/.aiignore file: ${formatError(error)}`, {
       cause: error
     });
   }
 }
 async function deleteIgnoreFile() {
-  const ignoreFilePath = join81(process.cwd(), RULESYNC_IGNORE_RELATIVE_FILE_PATH);
+  const aiignorePath = join81(process.cwd(), RULESYNC_AIIGNORE_RELATIVE_FILE_PATH);
+  const legacyIgnorePath = join81(process.cwd(), RULESYNC_IGNORE_RELATIVE_FILE_PATH);
   try {
-    await removeFile(ignoreFilePath);
+    await Promise.all([removeFile(aiignorePath), removeFile(legacyIgnorePath)]);
     return {
-      relativePathFromCwd: RULESYNC_IGNORE_RELATIVE_FILE_PATH
+      // Keep the historical return shape — point to the recommended file path
+      // for backward compatibility.
+      relativePathFromCwd: RULESYNC_AIIGNORE_RELATIVE_FILE_PATH
     };
   } catch (error) {
-    throw new Error(`Failed to delete .rulesyncignore file: ${formatError(error)}`, {
-      cause: error
-    });
+    throw new Error(
+      `Failed to delete .rulesyncignore and .rulesync/.aiignore files: ${formatError(error)}`,
+      {
+        cause: error
+      }
+    );
   }
 }
 var ignoreToolSchemas = {
@@ -9400,7 +9439,7 @@ var ignoreTools = {
   },
   putIgnoreFile: {
     name: "putIgnoreFile",
-    description: "Create or update the .rulesyncignore file (upsert operation). content parameter is required.",
+    description: "Create or update the .rulesync/.aiignore file (upsert operation). content parameter is required.",
     parameters: ignoreToolSchemas.putIgnoreFile,
     execute: async (args) => {
       const result = await putIgnoreFile({ content: args.content });
@@ -9409,7 +9448,7 @@ var ignoreTools = {
   },
   deleteIgnoreFile: {
     name: "deleteIgnoreFile",
-    description: "Delete the .rulesyncignore file from the project root.",
+    description: "Delete the .rulesyncignore and .rulesync/.aiignore files.",
     parameters: ignoreToolSchemas.deleteIgnoreFile,
     execute: async () => {
       const result = await deleteIgnoreFile();
@@ -9940,7 +9979,7 @@ async function mcpCommand({ version }) {
 }
 
 // src/cli/index.ts
-var getVersion = () => "3.26.0";
+var getVersion = () => "3.27.1";
 var main = async () => {
   const program = new Command();
   const version = getVersion();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rulesync",
-  "version": "3.26.0",
+  "version": "3.27.1",
   "description": "Unified AI rules management CLI tool that generates configuration files for various AI development tools",
   "keywords": [
     "ai",