@vuau/agent-memory 0.3.1 → 0.4.1

package/README.md

@@ -1,6 +1,6 @@
 # @vuau/agent-memory
 
-Structured AI memory for codebases. Works with OpenCode, GitHub Copilot, Cursor, Windsurf, and any AI coding assistant that reads markdown files.
+Structured AI memory for codebases. Uses `AGENTS.md` to work with OpenCode, GitHub Copilot, Cursor, Windsurf, and any AI coding assistant that reads markdown files.
 
 **[Tiếng Việt →](./README.vi.md)**
 
@@ -16,24 +16,14 @@ AI coding assistants lose context between sessions. They can't remember:
 ## Quick Start
 
 ```bash
-# Interactive mode — choose your IDEs
 npx @vuau/agent-memory init
-
-# Or specify directly
-npx @vuau/agent-memory init --opencode           # OpenCode only
-npx @vuau/agent-memory init --copilot --cursor   # Multiple IDEs
-npx @vuau/agent-memory init --all                # All IDEs
 ```
 
 ## What It Creates
 
 ```
 / (Project Root)
-├── AGENTS.md                    # OpenCode rules
-├── .cursorrules                 # Cursor rules
-├── .windsurfrules               # Windsurf rules
-├── .github/
-│   └── copilot-instructions.md  # GitHub Copilot rules
+├── AGENTS.md                    # Root agent rules
 └── .agents/
     ├── MEMORY.md                # Long-term memory (decisions, patterns)
     ├── TASKS.md                 # Working memory (current tasks)
@@ -42,13 +32,13 @@ npx @vuau/agent-memory init --all                # All IDEs
 
 ## How It Works
 
-1. **You run `init`** → Creates IDE config files + `.agents/` structure
+1. **You run `init`** → Creates `AGENTS.md` + `.agents/` structure
 2. **Agent reads rules** → Finds documentation map pointing to `.agents/`
 3. **Agent works** → Reads MEMORY.md before implementing, updates TASKS.md
 4. **You approve decision** → Agent writes 1-line entry to MEMORY.md
 5. **Next session** → Agent reads memory, continues where you left off
 
-**No plugin required.** The rules in AGENTS.md/copilot-instructions.md instruct the agent what to do.
+**No plugin required.** The rules in `AGENTS.md` instruct the agent what to do.
 
 ## CLI Options
 
@@ -56,11 +46,6 @@ npx @vuau/agent-memory init --all                # All IDEs
 npx @vuau/agent-memory init [options]
 
 Options:
-  --opencode    Create AGENTS.md for OpenCode
-  --copilot     Create .github/copilot-instructions.md
-  --cursor      Create .cursorrules
-  --windsurf    Create .windsurfrules
-  --all         Create config for all IDEs
   --force       Overwrite existing files without asking
   --name <n>    Project name (default: from package.json)
 
@@ -99,7 +84,7 @@ Agents follow this protocol (defined in config files):
 
 | Layer | File | Purpose |
 |-------|------|---------|
-| Router | AGENTS.md / .cursorrules / etc | Rules + pointers (~100 lines) |
+| Router | AGENTS.md | Rules + pointers (~100 lines) |
 | Memory | .agents/MEMORY.md | Curated decisions (1-line each) |
 | Tasks | .agents/TASKS.md | Current work, next steps |
 | Specs | .agents/spec/*.md | Detailed docs (on-demand) |
@@ -119,14 +104,19 @@ File-based solution:
 
 ## Cross-IDE Compatibility
 
-| IDE | Config File | Reads .agents/* |
-|-----|-------------|-----------------|
-| OpenCode | AGENTS.md | ✅ |
-| GitHub Copilot | .github/copilot-instructions.md | ✅ |
-| Cursor | .cursorrules | ✅ |
-| Windsurf | .windsurfrules | ✅ |
+By default, we only scaffold `AGENTS.md`, which is an emerging standard router file.
+
+If your tool requires a specific file (e.g. Cursor requires `.cursorrules`, GitHub Copilot requires `.github/copilot-instructions.md`), you can simply symlink or copy `AGENTS.md`:
+
+```bash
+# For Cursor
+ln -s AGENTS.md .cursorrules
+
+# For GitHub Copilot
+mkdir -p .github && ln -s ../AGENTS.md .github/copilot-instructions.md
+```
 
-All IDEs use the same `.agents/` memory structure.
+All tools will read from the same underlying `.agents/` memory structure.
 
 ## Documentation
 

package/README.vi.md

@@ -1,6 +1,6 @@
 # @vuau/agent-memory
 
-Bộ nhớ AI có cấu trúc cho các codebase. Hoạt động với OpenCode, GitHub Copilot, Cursor, Windsurf, và bất kỳ AI coding assistant nào đọc markdown files.
+Bộ nhớ AI có cấu trúc cho các codebase. Sử dụng `AGENTS.md` để hoạt động với OpenCode, GitHub Copilot, Cursor, Windsurf, và bất kỳ AI coding assistant nào đọc markdown files.
 
 ## Bài toán
 
@@ -14,24 +14,14 @@ AI coding assistants mất bối cảnh giữa các phiên. Họ không thể nh
 ## Bắt đầu nhanh
 
 ```bash
-# Interactive mode — chọn IDEs của bạn
 npx @vuau/agent-memory init
-
-# Hoặc chỉ định trực tiếp
-npx @vuau/agent-memory init --opencode           # Chỉ OpenCode
-npx @vuau/agent-memory init --copilot --cursor   # Nhiều IDEs
-npx @vuau/agent-memory init --all                # Tất cả IDEs
 ```
 
 ## Cấu trúc tạo ra
 
 ```
 / (Project Root)
-├── AGENTS.md                    # OpenCode rules
-├── .cursorrules                 # Cursor rules
-├── .windsurfrules               # Windsurf rules
-├── .github/
-│   └── copilot-instructions.md  # GitHub Copilot rules
+├── AGENTS.md                    # Root agent rules
 └── .agents/
     ├── MEMORY.md                # Long-term memory (decisions, patterns)
     ├── TASKS.md                 # Working memory (current tasks)
@@ -40,13 +30,13 @@ npx @vuau/agent-memory init --all                # Tất cả IDEs
 
 ## Cách hoạt động
 
-1. **Bạn chạy `init`** → Tạo IDE config files + `.agents/` structure
+1. **Bạn chạy `init`** → Tạo `AGENTS.md` + `.agents/` structure
 2. **Agent đọc rules** → Tìm documentation map trỏ đến `.agents/`
 3. **Agent làm việc** → Đọc MEMORY.md trước khi implement, update TASKS.md
 4. **Bạn approve decision** → Agent ghi 1-line entry vào MEMORY.md
 5. **Phiên tiếp theo** → Agent đọc memory, tiếp tục từ nơi dừng lại
 
-**Không cần plugin.** Rules trong AGENTS.md/copilot-instructions.md hướng dẫn agent phải làm gì.
+**Không cần plugin.** Rules trong `AGENTS.md` hướng dẫn agent phải làm gì.
 
 ## CLI Options
 
@@ -54,11 +44,6 @@ npx @vuau/agent-memory init --all                # Tất cả IDEs
 npx @vuau/agent-memory init [options]
 
 Options:
-  --opencode    Tạo AGENTS.md cho OpenCode
-  --copilot     Tạo .github/copilot-instructions.md
-  --cursor      Tạo .cursorrules
-  --windsurf    Tạo .windsurfrules
-  --all         Tạo config cho tất cả IDEs
   --force       Ghi đè files có sẵn mà không hỏi
   --name <n>    Tên project (mặc định: từ package.json)
 
@@ -97,7 +82,7 @@ Agents follow protocol này (defined trong config files):
 
 | Layer | File | Mục đích |
 |-------|------|----------|
-| Router | AGENTS.md / .cursorrules / etc | Rules + pointers (~100 dòng) |
+| Router | AGENTS.md | Rules + pointers (~100 dòng) |
 | Memory | .agents/MEMORY.md | Curated decisions (1-line each) |
 | Tasks | .agents/TASKS.md | Current work, next steps |
 | Specs | .agents/spec/*.md | Detailed docs (on-demand) |
@@ -117,14 +102,19 @@ File-based solution:
 
 ## Cross-IDE Compatibility
 
-| IDE | Config File | Reads .agents/* |
-|-----|-------------|-----------------|
-| OpenCode | AGENTS.md | ✅ |
-| GitHub Copilot | .github/copilot-instructions.md | ✅ |
-| Cursor | .cursorrules | ✅ |
-| Windsurf | .windsurfrules | ✅ |
+Mặc định, công cụ chỉ scaffold `AGENTS.md`, một chuẩn router file đang phổ biến.
+
+Nếu công cụ của bạn yêu cầu một file cụ thể (vd: Cursor yêu cầu `.cursorrules`, GitHub Copilot yêu cầu `.github/copilot-instructions.md`), bạn có thể đơn giản dùng symlink hoặc copy `AGENTS.md`:
+
+```bash
+# Cho Cursor
+ln -s AGENTS.md .cursorrules
+
+# Cho GitHub Copilot
+mkdir -p .github && ln -s ../AGENTS.md .github/copilot-instructions.md
+```
 
-Tất cả IDEs dùng cùng `.agents/` memory structure.
+Tất cả các công cụ sẽ cùng đọc chung cấu trúc bộ nhớ bên trong thư mục `.agents/`.
 
 ## Tài liệu
 

package/dist/bin/cli.js

@@ -1,10 +1,5 @@
 #!/usr/bin/env node
 
-// bin/cli.ts
-import * as readline from "readline";
-import { existsSync as existsSync3 } from "fs";
-import { join as join3 } from "path";
-
 // src/core/scaffold.ts
 import { existsSync, mkdirSync, writeFileSync, readFileSync } from "fs";
 import { join, resolve, dirname } from "path";
@@ -17,9 +12,6 @@ var MEMORY_FILE = ".agents/MEMORY.md";
 var MEMORY_DETAIL_FILE = ".agents/MEMORY-DETAIL.md";
 var TASKS_FILE = ".agents/TASKS.md";
 var AGENTS_MD = "AGENTS.md";
-var COPILOT_INSTRUCTIONS = ".github/copilot-instructions.md";
-var CURSOR_RULES = ".cursorrules";
-var WINDSURF_RULES = ".windsurfrules";
 
 // src/core/scaffold.ts
 function getTemplatesDir() {
@@ -50,18 +42,10 @@ function scaffold(projectDir, options = {}) {
   const projectName = options.projectName || guessProjectName(projectDir);
   const vars = { PROJECT_NAME: projectName };
   const force = options.force || false;
-  const hasAnyIde = options.opencode || options.copilot || options.cursor || options.windsurf;
-  const useOpencode = hasAnyIde ? options.opencode : true;
-  const useCopilot = options.copilot || false;
-  const useCursor = options.cursor || false;
-  const useWindsurf = options.windsurf || false;
   const dirs = [
     join(projectDir, AGENTS_DIR),
     join(projectDir, SPEC_DIR)
   ];
-  if (useCopilot) {
-    dirs.push(join(projectDir, ".github"));
-  }
   for (const dir of dirs) {
     if (!existsSync(dir)) {
       mkdirSync(dir, { recursive: true });
@@ -87,42 +71,13 @@ function scaffold(projectDir, options = {}) {
     writeFileSync(specKeep, "");
     result.created.push(`${SPEC_DIR}/.gitkeep`);
   }
-  if (useOpencode) {
-    writeFileIfNeeded(
-      join(projectDir, AGENTS_MD),
-      applyVars(readTemplate("AGENTS.md"), vars),
-      AGENTS_MD,
-      result,
-      force
-    );
-  }
-  if (useCopilot) {
-    writeFileIfNeeded(
-      join(projectDir, COPILOT_INSTRUCTIONS),
-      applyVars(readTemplate("copilot-instructions.md"), vars),
-      COPILOT_INSTRUCTIONS,
-      result,
-      force
-    );
-  }
-  if (useCursor) {
-    writeFileIfNeeded(
-      join(projectDir, CURSOR_RULES),
-      applyVars(readTemplate("cursorrules.md"), vars),
-      CURSOR_RULES,
-      result,
-      force
-    );
-  }
-  if (useWindsurf) {
-    writeFileIfNeeded(
-      join(projectDir, WINDSURF_RULES),
-      applyVars(readTemplate("windsurfrules.md"), vars),
-      WINDSURF_RULES,
-      result,
-      force
-    );
-  }
+  writeFileIfNeeded(
+    join(projectDir, AGENTS_MD),
+    applyVars(readTemplate("AGENTS.md"), vars),
+    AGENTS_MD,
+    result,
+    force
+  );
   return result;
 }
 function writeFileIfNeeded(targetPath, content, displayName, result, force) {
@@ -166,14 +121,6 @@ function doctor(projectDir) {
       issues.push({ level: "error", file: dir, message: "Directory missing" });
     }
   }
-  const copilotPath = join2(projectDir, COPILOT_INSTRUCTIONS);
-  if (!existsSync2(copilotPath)) {
-    issues.push({
-      level: "warning",
-      file: COPILOT_INSTRUCTIONS,
-      message: "Copilot instructions missing \u2014 VSCode/GitHub Copilot won't have context"
-    });
-  }
   const agentsPath = join2(projectDir, AGENTS_MD);
   if (existsSync2(agentsPath)) {
     const content = readFileSync2(agentsPath, "utf-8");
@@ -203,182 +150,39 @@ function doctor(projectDir) {
       });
     }
   }
-  const opencodePkgPath = join2(projectDir, ".opencode", "package.json");
-  const opencodeJsonPath = join2(projectDir, "opencode.json");
-  const opencodeExists = existsSync2(join2(projectDir, ".opencode"));
-  if (opencodeExists) {
-    if (!existsSync2(opencodePkgPath)) {
-      issues.push({
-        level: "warning",
-        file: ".opencode/package.json",
-        message: "Missing \u2014 run 'agent-memory init --opencode' to wire up the plugin"
-      });
-    } else {
-      try {
-        const pkg = JSON.parse(readFileSync2(opencodePkgPath, "utf-8"));
-        const deps = { ...pkg.dependencies, ...pkg.devDependencies };
-        if (!deps["@vuau/agent-memory"]) {
-          issues.push({
-            level: "warning",
-            file: ".opencode/package.json",
-            message: "@vuau/agent-memory not in dependencies \u2014 run 'agent-memory init --opencode'"
-          });
-        }
-      } catch {
-        issues.push({ level: "warning", file: ".opencode/package.json", message: "Invalid JSON" });
-      }
-    }
-    if (!existsSync2(opencodeJsonPath)) {
-      issues.push({
-        level: "warning",
-        file: "opencode.json",
-        message: "Missing \u2014 run 'agent-memory init --opencode' to wire up the plugin"
-      });
-    } else {
-      try {
-        const config = JSON.parse(readFileSync2(opencodeJsonPath, "utf-8"));
-        const plugins = config.plugin || [];
-        if (!plugins.includes("@vuau/agent-memory")) {
-          issues.push({
-            level: "warning",
-            file: "opencode.json",
-            message: "@vuau/agent-memory not in plugin array \u2014 run 'agent-memory init --opencode'"
-          });
-        }
-      } catch {
-        issues.push({ level: "warning", file: "opencode.json", message: "Invalid JSON" });
-      }
-    }
-  }
   return { ok: issues.filter((i) => i.level === "error").length === 0, issues };
 }
 
 // bin/cli.ts
 var args = process.argv.slice(2);
 var command = args[0];
-var rl = readline.createInterface({
-  input: process.stdin,
-  output: process.stdout
-});
-function ask(question) {
-  return new Promise((resolve2) => {
-    rl.question(question, (answer) => resolve2(answer.trim()));
-  });
-}
-function askYesNo(question, defaultYes = true) {
-  const hint = defaultYes ? "(Y/n)" : "(y/N)";
-  return ask(`${question} ${hint} `).then((answer) => {
-    if (!answer) return defaultYes;
-    return answer.toLowerCase().startsWith("y");
-  });
-}
-async function askMultiSelect(question, options) {
-  console.log(`
-${question}`);
-  for (const opt of options) {
-    console.log(`  [${opt.key}] ${opt.label}`);
-  }
-  const answer = await ask("Enter choices (e.g., 1,2 or 1 2): ");
-  const selected = answer.split(/[,\s]+/).filter(Boolean);
-  return selected;
-}
 function printUsage() {
   console.log(`
 @vuau/agent-memory \u2014 Structured AI memory for codebases
 
 Usage:
-  agent-memory init [options]    Scaffold .agents/ structure
+  agent-memory init [options]    Scaffold .agents/ structure and AGENTS.md
   agent-memory doctor            Validate .agents/ structure
   agent-memory help              Show this help
 
 Options (init):
-  --opencode                     Create AGENTS.md for OpenCode
-  --copilot                      Create .github/copilot-instructions.md for GitHub Copilot
-  --cursor                       Create .cursorrules for Cursor
-  --windsurf                     Create .windsurfrules for Windsurf
-  --all                          Create config for all IDEs
   --force                        Overwrite existing files without asking
   --name <name>                  Project name (default: from package.json)
 
 Examples:
-  npx @vuau/agent-memory init                    # Interactive mode
-  npx @vuau/agent-memory init --opencode         # OpenCode only
-  npx @vuau/agent-memory init --copilot --cursor # Copilot + Cursor
-  npx @vuau/agent-memory init --all              # All IDEs
+  npx @vuau/agent-memory init
+  npx @vuau/agent-memory init --force
 `);
 }
 async function runInit() {
   const cwd = process.cwd();
   const force = args.includes("--force");
-  const hasOpencode = args.includes("--opencode");
-  const hasCopilot = args.includes("--copilot");
-  const hasCursor = args.includes("--cursor");
-  const hasWindsurf = args.includes("--windsurf");
-  const hasAll = args.includes("--all");
   const nameIdx = args.indexOf("--name");
   const projectName = nameIdx !== -1 ? args[nameIdx + 1] : void 0;
-  let selectedIdes = [];
-  if (hasAll) {
-    selectedIdes = ["1", "2", "3", "4"];
-  } else if (hasOpencode || hasCopilot || hasCursor || hasWindsurf) {
-    if (hasOpencode) selectedIdes.push("1");
-    if (hasCopilot) selectedIdes.push("2");
-    if (hasCursor) selectedIdes.push("3");
-    if (hasWindsurf) selectedIdes.push("4");
-  } else {
-    console.log("\n@vuau/agent-memory \u2014 Structured AI memory for codebases\n");
-    selectedIdes = await askMultiSelect("What are your coding tools?", [
-      { key: "1", label: "OpenCode (AGENTS.md)" },
-      { key: "2", label: "GitHub Copilot (.github/copilot-instructions.md)" },
-      { key: "3", label: "Cursor (.cursorrules)" },
-      { key: "4", label: "Windsurf (.windsurfrules)" }
-    ]);
-    if (selectedIdes.length === 0) {
-      console.log("\nNo tools selected. Defaulting to OpenCode.\n");
-      selectedIdes = ["1"];
-    }
-  }
   const options = {
     projectName,
-    opencode: selectedIdes.includes("1"),
-    copilot: selectedIdes.includes("2"),
-    cursor: selectedIdes.includes("3"),
-    windsurf: selectedIdes.includes("4")
+    force
   };
-  if (!force) {
-    const filesToCheck = [
-      { path: MEMORY_FILE, name: ".agents/MEMORY.md" },
-      { path: TASKS_FILE, name: ".agents/TASKS.md" }
-    ];
-    if (options.opencode) {
-      filesToCheck.push({ path: AGENTS_MD, name: "AGENTS.md" });
-    }
-    if (options.copilot) {
-      filesToCheck.push({ path: COPILOT_INSTRUCTIONS, name: ".github/copilot-instructions.md" });
-    }
-    if (options.cursor) {
-      filesToCheck.push({ path: ".cursorrules", name: ".cursorrules" });
-    }
-    if (options.windsurf) {
-      filesToCheck.push({ path: ".windsurfrules", name: ".windsurfrules" });
-    }
-    const existingFiles = filesToCheck.filter((f) => existsSync3(join3(cwd, f.path)));
-    if (existingFiles.length > 0) {
-      console.log("\nExisting files found:");
-      for (const f of existingFiles) {
-        console.log(`  - ${f.name}`);
-      }
-      const overwrite = await askYesNo("\nOverwrite these files?", false);
-      if (!overwrite) {
-        console.log("\nAborted. Use --force to overwrite without asking.\n");
-        rl.close();
-        return;
-      }
-      options.force = true;
-    }
-  } else {
-    options.force = true;
-  }
   console.log(`
 Initializing agent memory in ${cwd}...
 `);
@@ -394,13 +198,15 @@ Initializing agent memory in ${cwd}...
     for (const f of result.skipped) {
       console.log(`  - ${f}`);
     }
+    if (!force) {
+      console.log("\nTip: Use --force to overwrite existing files.");
+    }
   }
   console.log("\nNext steps:");
-  console.log("  1. Edit your IDE config file \u2014 add project-specific rules");
+  console.log("  1. Edit AGENTS.md \u2014 add project-specific rules");
   console.log("  2. Add spec files to .agents/spec/ for detailed documentation");
   console.log("  3. Agent will read rules and write to .agents/MEMORY.md automatically");
   console.log("");
-  rl.close();
 }
 function runDoctor() {
   const cwd = process.cwd();
@@ -425,7 +231,6 @@ switch (command) {
   case "init":
     runInit().catch((err) => {
       console.error("Error:", err.message);
-      rl.close();
       process.exit(1);
     });
     break;
@@ -440,7 +245,6 @@ switch (command) {
   case void 0:
     runInit().catch((err) => {
       console.error("Error:", err.message);
-      rl.close();
       process.exit(1);
     });
     break;

package/dist/index.js

@@ -10,9 +10,6 @@ var MEMORY_FILE = ".agents/MEMORY.md";
 var MEMORY_DETAIL_FILE = ".agents/MEMORY-DETAIL.md";
 var TASKS_FILE = ".agents/TASKS.md";
 var AGENTS_MD = "AGENTS.md";
-var COPILOT_INSTRUCTIONS = ".github/copilot-instructions.md";
-var CURSOR_RULES = ".cursorrules";
-var WINDSURF_RULES = ".windsurfrules";
 
 // src/core/scaffold.ts
 function getTemplatesDir() {
@@ -43,18 +40,10 @@ function scaffold(projectDir, options = {}) {
   const projectName = options.projectName || guessProjectName(projectDir);
   const vars = { PROJECT_NAME: projectName };
   const force = options.force || false;
-  const hasAnyIde = options.opencode || options.copilot || options.cursor || options.windsurf;
-  const useOpencode = hasAnyIde ? options.opencode : true;
-  const useCopilot = options.copilot || false;
-  const useCursor = options.cursor || false;
-  const useWindsurf = options.windsurf || false;
   const dirs = [
     join(projectDir, AGENTS_DIR),
     join(projectDir, SPEC_DIR)
   ];
-  if (useCopilot) {
-    dirs.push(join(projectDir, ".github"));
-  }
   for (const dir of dirs) {
     if (!existsSync(dir)) {
       mkdirSync(dir, { recursive: true });
@@ -80,42 +69,13 @@ function scaffold(projectDir, options = {}) {
     writeFileSync(specKeep, "");
     result.created.push(`${SPEC_DIR}/.gitkeep`);
   }
-  if (useOpencode) {
-    writeFileIfNeeded(
-      join(projectDir, AGENTS_MD),
-      applyVars(readTemplate("AGENTS.md"), vars),
-      AGENTS_MD,
-      result,
-      force
-    );
-  }
-  if (useCopilot) {
-    writeFileIfNeeded(
-      join(projectDir, COPILOT_INSTRUCTIONS),
-      applyVars(readTemplate("copilot-instructions.md"), vars),
-      COPILOT_INSTRUCTIONS,
-      result,
-      force
-    );
-  }
-  if (useCursor) {
-    writeFileIfNeeded(
-      join(projectDir, CURSOR_RULES),
-      applyVars(readTemplate("cursorrules.md"), vars),
-      CURSOR_RULES,
-      result,
-      force
-    );
-  }
-  if (useWindsurf) {
-    writeFileIfNeeded(
-      join(projectDir, WINDSURF_RULES),
-      applyVars(readTemplate("windsurfrules.md"), vars),
-      WINDSURF_RULES,
-      result,
-      force
-    );
-  }
+  writeFileIfNeeded(
+    join(projectDir, AGENTS_MD),
+    applyVars(readTemplate("AGENTS.md"), vars),
+    AGENTS_MD,
+    result,
+    force
+  );
   return result;
 }
 function writeFileIfNeeded(targetPath, content, displayName, result, force) {
@@ -262,14 +222,6 @@ function doctor(projectDir) {
       issues.push({ level: "error", file: dir, message: "Directory missing" });
     }
   }
-  const copilotPath = join4(projectDir, COPILOT_INSTRUCTIONS);
-  if (!existsSync4(copilotPath)) {
-    issues.push({
-      level: "warning",
-      file: COPILOT_INSTRUCTIONS,
-      message: "Copilot instructions missing \u2014 VSCode/GitHub Copilot won't have context"
-    });
-  }
   const agentsPath = join4(projectDir, AGENTS_MD);
   if (existsSync4(agentsPath)) {
     const content = readFileSync4(agentsPath, "utf-8");
@@ -299,65 +251,15 @@ function doctor(projectDir) {
       });
     }
   }
-  const opencodePkgPath = join4(projectDir, ".opencode", "package.json");
-  const opencodeJsonPath = join4(projectDir, "opencode.json");
-  const opencodeExists = existsSync4(join4(projectDir, ".opencode"));
-  if (opencodeExists) {
-    if (!existsSync4(opencodePkgPath)) {
-      issues.push({
-        level: "warning",
-        file: ".opencode/package.json",
-        message: "Missing \u2014 run 'agent-memory init --opencode' to wire up the plugin"
-      });
-    } else {
-      try {
-        const pkg = JSON.parse(readFileSync4(opencodePkgPath, "utf-8"));
-        const deps = { ...pkg.dependencies, ...pkg.devDependencies };
-        if (!deps["@vuau/agent-memory"]) {
-          issues.push({
-            level: "warning",
-            file: ".opencode/package.json",
-            message: "@vuau/agent-memory not in dependencies \u2014 run 'agent-memory init --opencode'"
-          });
-        }
-      } catch {
-        issues.push({ level: "warning", file: ".opencode/package.json", message: "Invalid JSON" });
-      }
-    }
-    if (!existsSync4(opencodeJsonPath)) {
-      issues.push({
-        level: "warning",
-        file: "opencode.json",
-        message: "Missing \u2014 run 'agent-memory init --opencode' to wire up the plugin"
-      });
-    } else {
-      try {
-        const config = JSON.parse(readFileSync4(opencodeJsonPath, "utf-8"));
-        const plugins = config.plugin || [];
-        if (!plugins.includes("@vuau/agent-memory")) {
-          issues.push({
-            level: "warning",
-            file: "opencode.json",
-            message: "@vuau/agent-memory not in plugin array \u2014 run 'agent-memory init --opencode'"
-          });
-        }
-      } catch {
-        issues.push({ level: "warning", file: "opencode.json", message: "Invalid JSON" });
-      }
-    }
-  }
   return { ok: issues.filter((i) => i.level === "error").length === 0, issues };
 }
 export {
   AGENTS_DIR,
   AGENTS_MD,
-  COPILOT_INSTRUCTIONS,
-  CURSOR_RULES,
   MEMORY_DETAIL_FILE,
   MEMORY_FILE,
   SPEC_DIR,
   TASKS_FILE,
-  WINDSURF_RULES,
   appendMemory,
   doctor,
   readMemory,

package/docs/ARCHITECTURE.md

@@ -168,28 +168,21 @@ This document proposes a generalizable architecture for AI memory across codebas
 
 ---
 
-## IDE Integration Points
+## Integration Points
 
-### OpenCode
-- Reads: AGENTS.md (via plugin hook)
-- Plugin auto-injects: `.agents/MEMORY.md` context on session start
-- Plugin reminds: Update TASKS.md on session idle
-- Writes: Agent appends to MEMORY.md/TASKS.md/spec/
+By default, we scaffold `AGENTS.md` which acts as the root router for your AI coding assistant. This file contains rules and documentation maps that point to the `.agents/` folder.
 
-### GitHub Copilot (VSCode)
-- Reads: `.github/copilot-instructions.md` (GitHub convention)
-- copilot-instructions.md = same router format as AGENTS.md
-- Points to `.agents/MEMORY.md` + spec files
-- Writes: User includes `@save memory: <decision>` in chat → agent appends
+If your specific AI tool requires a different file name, you can simply symlink the `AGENTS.md` file:
 
-### Cursor / Windsurf
-- Reads: `.cursorrules` / `.windsurfrules` (IDE convention)
-- Same router format, points to `.agents/`
-- Writes: Agent rules instruct direct append
+```bash
+# Example: For Cursor
+ln -s AGENTS.md .cursorrules
 
-### CLI / Non-IDE Workflows
-- Humans can read/edit `.agents/` files directly
-- No special IDE integration needed
+# Example: For GitHub Copilot
+mkdir -p .github && ln -s ../AGENTS.md .github/copilot-instructions.md
+```
+
+This ensures a single source of truth (`AGENTS.md`) is maintained while providing backward compatibility with any tool.
 
 ---
 
@@ -219,12 +212,12 @@ This document proposes a generalizable architecture for AI memory across codebas
    - Keep `.memsearch/memory/` as archive (1 year retention)
    - Delete milvus.db
 
-### From .github/copilot-instructions.md (monolithic)
+### From Monolithic Config Files (e.g. .cursorrules)
 
 1. **Extract decisions** → `.agents/MEMORY.md`
 2. **Extract patterns** → `.agents/spec/patterns.md`
 3. **Extract commands** → `AGENTS.md`
-4. **Keep router** → update `.github/copilot-instructions.md` to point to `.agents/`
+4. **Keep router** → Create symlink from your old config file to `AGENTS.md`
 
 ---
 
@@ -254,10 +247,8 @@ This document proposes a generalizable architecture for AI memory across codebas
 ## Tooling Support
 
 ### CLI
-- ✓ `npx @vuau/agent-memory init` — scaffold structure (interactive or with flags)
-- ✓ `npx @vuau/agent-memory init --opencode` — OpenCode only
-- ✓ `npx @vuau/agent-memory init --copilot --cursor` — multiple IDEs
-- ✓ `npx @vuau/agent-memory init --all` — all IDEs
+- ✓ `npx @vuau/agent-memory init` — scaffold structure (`AGENTS.md` + `.agents/`)
+- ✓ `npx @vuau/agent-memory init --force` — overwrite existing files
 - ✓ `npx @vuau/agent-memory doctor` — validate structure
 - Planned: ✗ `report` — generate memory stats, archival suggestions
 

package/docs/ARCHITECTURE.vi.md

@@ -168,27 +168,21 @@ Tài liệu này đề xuất kiến trúc khả năng skalabiliti cho AI memory
 
 ---
 
-## IDE Integration Points
+## Điểm Tích Hợp
 
-### OpenCode
-- Reads: `AGENTS.md` (native)
-- Agents follow rules trong AGENTS.md
-- Writes: Agent appends đến MEMORY.md/TASKS.md/spec/
+Mặc định, chúng tôi scaffold `AGENTS.md` hoạt động như root router cho AI coding assistant của bạn. File này chứa các rules và documentation maps trỏ đến thư mục `.agents/`.
 
-### GitHub Copilot (VSCode)
-- Reads: `.github/copilot-instructions.md` (GitHub convention)
-- copilot-instructions.md = cùng router format với AGENTS.md
-- Points đến `.agents/MEMORY.md` + spec files
-- Writes: Agent follows rules → appends khi appropriate
+Nếu công cụ AI cụ thể của bạn yêu cầu một tên file khác, bạn có thể dễ dàng dùng symlink file `AGENTS.md`:
 
-### Cursor / Windsurf
-- Reads: `.cursorrules` / `.windsurfrules` (IDE convention)
-- Cùng router format, points đến `.agents/`
-- Writes: Agent rules instruct direct append
+```bash
+# Ví dụ: Cho Cursor
+ln -s AGENTS.md .cursorrules
 
-### CLI / Non-IDE Workflows
-- Humans có thể read/edit `.agents/` files trực tiếp
-- Không cần special IDE integration
+# Ví dụ: Cho GitHub Copilot
+mkdir -p .github && ln -s ../AGENTS.md .github/copilot-instructions.md
+```
+
+Điều này đảm bảo single source of truth (`AGENTS.md`) được duy trì trong khi cung cấp khả năng tương thích ngược với mọi công cụ.
 
 ---
 
@@ -218,12 +212,12 @@ Tài liệu này đề xuất kiến trúc khả năng skalabiliti cho AI memory
    - Keep `.memsearch/memory/` như archive (1 year retention)
    - Delete milvus.db
 
-### Từ .github/copilot-instructions.md (monolithic)
+### Từ Monolithic Config Files (vd: .cursorrules)
 
 1. **Extract decisions** → `.agents/MEMORY.md`
 2. **Extract patterns** → `.agents/spec/patterns.md`
 3. **Extract commands** → `AGENTS.md`
-4. **Keep router** → update `.github/copilot-instructions.md` để point đến `.agents/`
+4. **Keep router** → Tạo symlink từ config file cũ của bạn trỏ tới `AGENTS.md`
 
 ---
 
@@ -253,10 +247,8 @@ Tài liệu này đề xuất kiến trúc khả năng skalabiliti cho AI memory
 ## Công cụ Support
 
 ### CLI
-- ✓ `npx @vuau/agent-memory init` — scaffold structure (interactive hoặc với flags)
-- ✓ `npx @vuau/agent-memory init --opencode` — chỉ OpenCode
-- ✓ `npx @vuau/agent-memory init --copilot --cursor` — nhiều IDEs
-- ✓ `npx @vuau/agent-memory init --all` — tất cả IDEs
+- ✓ `npx @vuau/agent-memory init` — scaffold structure (`AGENTS.md` + `.agents/`)
+- ✓ `npx @vuau/agent-memory init --force` — ghi đè files có sẵn
 - ✓ `npx @vuau/agent-memory doctor` — validate structure
 - Planned: ✗ `report` — generate memory stats, archival suggestions
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vuau/agent-memory",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "description": "Structured AI memory for codebases — scaffolding CLI for OpenCode, Copilot, Cursor, Windsurf",
   "type": "module",
   "main": "./dist/index.js",

package/templates/copilot-instructions.md

@@ -1,31 +0,0 @@
-# {{PROJECT_NAME}} - Copilot Instructions (VSCode)
-
-Router file for GitHub Copilot. Points to shared agent documentation.
-
-## Priority
-1. Follow direct user request.
-2. Follow this file.
-3. Follow spec files in `.agents/spec/`.
-4. If conflict remains, choose smallest safe change and state assumptions.
-
-## Documentation Map
-
-| Task | Spec File |
-|------|-----------|
-| Past decisions (1-line) | `.agents/MEMORY.md` |
-| Past decisions (full context) | `.agents/MEMORY-DETAIL.md` |
-| Current work in progress | `.agents/TASKS.md` |
-
-> Add your own spec files to `.agents/spec/` and reference them here.
-
-## Response Style
-- Concise, concrete, implementation-focused.
-- If uncertain, say "I don't know" and give fastest verification step.
-- Do not invent files, APIs, or command results.
-- Keep diffs minimal, aligned with existing conventions.
-
-## Memory Protocol
-- When user approves a decision → append 1-line entry to `.agents/MEMORY.md` under appropriate category.
-- Format: `- YYYY-MM-DD: <decision> → detail` (add `→ detail` when full context exists in MEMORY-DETAIL.md).
-- Read `.agents/MEMORY.md` before implementing; follow pointers for details.
-- Do not create additional memory files.

package/templates/cursorrules.md

@@ -1,44 +0,0 @@
-# {{PROJECT_NAME}} - Cursor Rules
-
-Instructions for Cursor AI. Keep under 150 lines.
-
-## Priority
-1. User request first.
-2. These rules.
-3. Spec files in `.agents/spec/`.
-4. If conflict remains, choose smallest safe change and state assumption.
-
-## Documentation Map
-
-| Task | Location |
-|------|----------|
-| Past decisions (1-line) | `.agents/MEMORY.md` |
-| Past decisions (full context) | `.agents/MEMORY-DETAIL.md` |
-| Current work in progress | `.agents/TASKS.md` |
-| Detailed specs | `.agents/spec/*.md` |
-
-## Memory Protocol
-
-### When to write
-- User approves a decision or pattern → append to `.agents/MEMORY.md`
-- Explore codebase/architecture → update relevant `.agents/spec/*.md`
-- Start/finish a large task → update `.agents/TASKS.md`
-
-### MEMORY.md entry format
-```
-- YYYY-MM-DD: <1-line decision or pattern> → detail
-```
-Place under the appropriate category. Add `→ detail` pointer when full context exists in MEMORY-DETAIL.md.
-
-### TASKS.md update
-Before ending a session with unfinished work, move items to `## In Progress` or `## Up Next`.
-
-### Rules
-- Keep MEMORY.md entries to 1 line each. Details go in spec files.
-- If MEMORY.md > 150 lines, archive old entries.
-- Do not create additional memory files outside `.agents/`.
-
-## Response Style
-- Concise, concrete, implementation-focused.
-- If uncertain, say `I don't know`, then give fastest verification step.
-- Do not invent files, APIs, or command outputs.

package/templates/windsurfrules.md

@@ -1,44 +0,0 @@
-# {{PROJECT_NAME}} - Windsurf Rules
-
-Instructions for Windsurf AI. Keep under 150 lines.
-
-## Priority
-1. User request first.
-2. These rules.
-3. Spec files in `.agents/spec/`.
-4. If conflict remains, choose smallest safe change and state assumption.
-
-## Documentation Map
-
-| Task | Location |
-|------|----------|
-| Past decisions (1-line) | `.agents/MEMORY.md` |
-| Past decisions (full context) | `.agents/MEMORY-DETAIL.md` |
-| Current work in progress | `.agents/TASKS.md` |
-| Detailed specs | `.agents/spec/*.md` |
-
-## Memory Protocol
-
-### When to write
-- User approves a decision or pattern → append to `.agents/MEMORY.md`
-- Explore codebase/architecture → update relevant `.agents/spec/*.md`
-- Start/finish a large task → update `.agents/TASKS.md`
-
-### MEMORY.md entry format
-```
-- YYYY-MM-DD: <1-line decision or pattern> → detail
-```
-Place under the appropriate category. Add `→ detail` pointer when full context exists in MEMORY-DETAIL.md.
-
-### TASKS.md update
-Before ending a session with unfinished work, move items to `## In Progress` or `## Up Next`.
-
-### Rules
-- Keep MEMORY.md entries to 1 line each. Details go in spec files.
-- If MEMORY.md > 150 lines, archive old entries.
-- Do not create additional memory files outside `.agents/`.
-
-## Response Style
-- Concise, concrete, implementation-focused.
-- If uncertain, say `I don't know`, then give fastest verification step.
-- Do not invent files, APIs, or command outputs.