@vuau/agent-memory 0.3.0 → 0.4.0

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. Works with GitHub Copilot, Cursor, Windsurf, VS Code, OpenCode, and [25+ other AI coding tools](#supported-tools).
 
 **[Tiếng Việt →](./README.vi.md)**
 
@@ -16,39 +16,31 @@ 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
 ```
 
+That's it. Creates `AGENTS.md` + `.agents/` structure.
+
 ## What It Creates
 
 ```
 / (Project Root)
-├── AGENTS.md                    # OpenCode rules
-├── .cursorrules                 # Cursor rules
-├── .windsurfrules               # Windsurf rules
-├── .github/
-│   └── copilot-instructions.md  # GitHub Copilot rules
+├── AGENTS.md           # Universal agent instructions
 └── .agents/
-    ├── MEMORY.md                # Long-term memory (decisions, patterns)
-    ├── TASKS.md                 # Working memory (current tasks)
-    └── spec/                    # Detailed specs (on-demand)
+    ├── MEMORY.md       # Long-term memory (decisions, patterns)
+    ├── TASKS.md        # Working memory (current tasks)
+    └── spec/           # Detailed specs (on-demand)
 ```
 
 ## How It Works
 
-1. **You run `init`** → Creates IDE config files + `.agents/` structure
-2. **Agent reads rules** → Finds documentation map pointing to `.agents/`
+1. **You run `init`** → Creates `AGENTS.md` + `.agents/` structure
+2. **Agent reads AGENTS.md** → 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 instructions in AGENTS.md tell the agent what to do.
 
 ## CLI Options
 
@@ -56,13 +48,8 @@ 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)
+  --force        Overwrite existing files without asking
+  --name <n>     Project name (default: from package.json)
 
 npx @vuau/agent-memory doctor   # Validate structure
 npx @vuau/agent-memory help     # Show help
@@ -70,7 +57,7 @@ npx @vuau/agent-memory help     # Show help
 
 ## Memory Protocol
 
-Agents follow this protocol (defined in config files):
+Agents follow this protocol (defined in AGENTS.md):
 
 ```markdown
 ## When to write
@@ -95,11 +82,11 @@ Agents follow this protocol (defined in config files):
 
 ## Architecture
 
-### 4-Layer Design
+### 3-Layer Design
 
 | Layer | File | Purpose |
 |-------|------|---------|
-| Router | AGENTS.md / .cursorrules / etc | Rules + pointers (~100 lines) |
+| Instructions | 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) |
@@ -117,16 +104,17 @@ File-based solution:
 - Plain markdown (portable, git-versionable, human-readable)
 - No dependencies (works everywhere)
 
-## Cross-IDE Compatibility
+## Supported Tools
+
+AGENTS.md is the universal format, supported by **25+ AI coding tools**:
 
-| IDE | Config File | Reads .agents/* |
-|-----|-------------|-----------------|
-| OpenCode | AGENTS.md | ✅ |
-| GitHub Copilot | .github/copilot-instructions.md | ✅ |
-| Cursor | .cursorrules | ✅ |
-| Windsurf | .windsurfrules | ✅ |
+| Category | Tools |
+|----------|-------|
+| **IDEs** | Cursor, Windsurf, VS Code, Zed, RooCode, Kilo Code |
+| **CLI Tools** | OpenCode, Aider, goose, Gemini CLI, Warp, Augment Code |
+| **AI Agents** | GitHub Copilot, Codex (OpenAI), Jules (Google), Junie (JetBrains), Devin, Factory, Amp, Phoenix, Semgrep, Ona, UiPath Autopilot |
 
-All IDEs use the same `.agents/` memory structure.
+See [agents.md](https://agents.md) for the full list.
 
 ## 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. Hoạt động với GitHub Copilot, Cursor, Windsurf, VS Code, OpenCode, và [25+ AI coding tools khác](#supported-tools).
 
 ## Bài toán
 
@@ -14,39 +14,31 @@ 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
 ```
 
+Đơn giản vậy thôi. Tạo `AGENTS.md` + `.agents/` structure.
+
 ## 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           # Universal agent instructions
 └── .agents/
-    ├── MEMORY.md                # Long-term memory (decisions, patterns)
-    ├── TASKS.md                 # Working memory (current tasks)
-    └── spec/                    # Detailed specs (on-demand)
+    ├── MEMORY.md       # Long-term memory (decisions, patterns)
+    ├── TASKS.md        # Working memory (current tasks)
+    └── spec/           # Detailed specs (on-demand)
 ```
 
 ## Cách hoạt động
 
-1. **Bạn chạy `init`** → Tạo IDE config files + `.agents/` structure
-2. **Agent đọc rules** → Tìm documentation map trỏ đến `.agents/`
+1. **Bạn chạy `init`** → Tạo `AGENTS.md` + `.agents/` structure
+2. **Agent đọc AGENTS.md** → 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.** Instructions trong AGENTS.md hướng dẫn agent phải làm gì.
 
 ## CLI Options
 
@@ -54,13 +46,8 @@ 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)
+  --force        Ghi đè files có sẵn mà không hỏi
+  --name <n>     Tên project (mặc định: từ package.json)
 
 npx @vuau/agent-memory doctor   # Validate structure
 npx @vuau/agent-memory help     # Hiện help
@@ -68,7 +55,7 @@ npx @vuau/agent-memory help     # Hiện help
 
 ## Memory Protocol
 
-Agents follow protocol này (defined trong config files):
+Agents follow protocol này (defined trong AGENTS.md):
 
 ```markdown
 ## Khi nào ghi
@@ -93,11 +80,11 @@ Agents follow protocol này (defined trong config files):
 
 ## Kiến trúc
 
-### Thiết kế 4-Layer
+### Thiết kế 3-Layer
 
 | Layer | File | Mục đích |
 |-------|------|----------|
-| Router | AGENTS.md / .cursorrules / etc | Rules + pointers (~100 dòng) |
+| Instructions | 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) |
@@ -115,16 +102,17 @@ File-based solution:
 - Plain markdown (portable, git-versionable, human-readable)
 - Không dependencies (works everywhere)
 
-## Cross-IDE Compatibility
+## Supported Tools
+
+AGENTS.md là format universal, được hỗ trợ bởi **25+ AI coding tools**:
 
-| IDE | Config File | Reads .agents/* |
-|-----|-------------|-----------------|
-| OpenCode | AGENTS.md | ✅ |
-| GitHub Copilot | .github/copilot-instructions.md | ✅ |
-| Cursor | .cursorrules | ✅ |
-| Windsurf | .windsurfrules | ✅ |
+| Category | Tools |
+|----------|-------|
+| **IDEs** | Cursor, Windsurf, VS Code, Zed, RooCode, Kilo Code |
+| **CLI Tools** | OpenCode, Aider, goose, Gemini CLI, Warp, Augment Code |
+| **AI Agents** | GitHub Copilot, Codex (OpenAI), Jules (Google), Junie (JetBrains), Devin, Factory, Amp, Phoenix, Semgrep, Ona, UiPath Autopilot |
 
-Tất cả IDEs dùng cùng `.agents/` memory structure.
+Xem [agents.md](https://agents.md) để có danh sách đầy đủ.
 
 ## Tài liệu
 

package/dist/bin/cli.js

@@ -14,11 +14,9 @@ import { fileURLToPath } from "url";
 var AGENTS_DIR = ".agents";
 var SPEC_DIR = ".agents/spec";
 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() {
@@ -49,25 +47,25 @@ 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 });
     }
   }
+  writeFileIfNeeded(
+    join(projectDir, AGENTS_MD),
+    applyVars(readTemplate("AGENTS.md"), vars),
+    AGENTS_MD,
+    result,
+    force
+  );
   const coreFiles = [
     { target: MEMORY_FILE, template: "MEMORY.md" },
+    { target: MEMORY_DETAIL_FILE, template: "MEMORY-DETAIL.md" },
     { target: TASKS_FILE, template: "TASKS.md" }
   ];
   for (const { target, template } of coreFiles) {
@@ -85,42 +83,6 @@ 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
-    );
-  }
   return result;
 }
 function writeFileIfNeeded(targetPath, content, displayName, result, force) {
@@ -149,7 +111,7 @@ import { join as join2 } from "path";
 function doctor(projectDir) {
   const issues = [];
   const required = [
-    { file: AGENTS_MD, desc: "Root router file" },
+    { file: AGENTS_MD, desc: "Root agent instructions" },
     { file: MEMORY_FILE, desc: "Long-term memory" },
     { file: TASKS_FILE, desc: "Working memory" }
   ];
@@ -164,14 +126,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");
@@ -186,7 +140,7 @@ function doctor(projectDir) {
       issues.push({
         level: "warning",
         file: AGENTS_MD,
-        message: "Over 150 lines \u2014 consider keeping it concise as a router"
+        message: "Over 150 lines \u2014 consider keeping it concise"
       });
     }
   }
@@ -201,53 +155,6 @@ 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 };
 }
 
@@ -270,96 +177,44 @@ function askYesNo(question, defaultYes = true) {
     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.md + .agents/ structure
   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              # Create AGENTS.md + .agents/
+  npx @vuau/agent-memory init --force      # Overwrite existing files
+  npx @vuau/agent-memory doctor            # Check structure
+
+AGENTS.md is the universal format supported by 25+ AI coding tools:
+  GitHub Copilot, Cursor, Windsurf, VS Code, OpenCode, Codex, Jules,
+  Junie, Gemini CLI, Devin, Aider, goose, Factory, Amp, RooCode,
+  Zed, Warp, Kilo Code, Phoenix, Semgrep, Ona, UiPath, Augment Code...
 `);
 }
 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")
+    projectName
   };
   if (!force) {
     const filesToCheck = [
+      { path: AGENTS_MD, name: "AGENTS.md" },
       { 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:");
@@ -394,9 +249,9 @@ Initializing agent memory in ${cwd}...
     }
   }
   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("  3. AI agents will read AGENTS.md and write to .agents/ automatically");
   console.log("");
   rl.close();
 }

package/dist/index.js

@@ -7,11 +7,9 @@ import { fileURLToPath } from "url";
 var AGENTS_DIR = ".agents";
 var SPEC_DIR = ".agents/spec";
 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() {
@@ -42,25 +40,25 @@ 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 });
     }
   }
+  writeFileIfNeeded(
+    join(projectDir, AGENTS_MD),
+    applyVars(readTemplate("AGENTS.md"), vars),
+    AGENTS_MD,
+    result,
+    force
+  );
   const coreFiles = [
     { target: MEMORY_FILE, template: "MEMORY.md" },
+    { target: MEMORY_DETAIL_FILE, template: "MEMORY-DETAIL.md" },
     { target: TASKS_FILE, template: "TASKS.md" }
   ];
   for (const { target, template } of coreFiles) {
@@ -78,42 +76,6 @@ 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
-    );
-  }
   return result;
 }
 function writeFileIfNeeded(targetPath, content, displayName, result, force) {
@@ -245,7 +207,7 @@ import { join as join4 } from "path";
 function doctor(projectDir) {
   const issues = [];
   const required = [
-    { file: AGENTS_MD, desc: "Root router file" },
+    { file: AGENTS_MD, desc: "Root agent instructions" },
     { file: MEMORY_FILE, desc: "Long-term memory" },
     { file: TASKS_FILE, desc: "Working memory" }
   ];
@@ -260,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");
@@ -282,7 +236,7 @@ function doctor(projectDir) {
       issues.push({
         level: "warning",
         file: AGENTS_MD,
-        message: "Over 150 lines \u2014 consider keeping it concise as a router"
+        message: "Over 150 lines \u2014 consider keeping it concise"
       });
     }
   }
@@ -297,64 +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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vuau/agent-memory",
-  "version": "0.3.0",
-  "description": "Structured AI memory for codebases — scaffolding CLI for OpenCode, Copilot, Cursor, Windsurf",
+  "version": "0.4.0",
+  "description": "Structured AI memory for codebases — works with GitHub Copilot, Cursor, Windsurf, VS Code, OpenCode, and 25+ AI tools",
   "type": "module",
   "main": "./dist/index.js",
   "exports": {

package/templates/AGENTS.md

@@ -12,7 +12,8 @@ Router file for AI agents. Keep under 150 lines.
 
 | Task | Spec File |
 |------|-----------|
-| Past decisions & patterns | `.agents/MEMORY.md` |
+| 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.
@@ -26,9 +27,9 @@ Router file for AI agents. Keep under 150 lines.
 
 ### MEMORY.md entry format
 ```
-- YYYY-MM-DD: <1-line decision or pattern>
+- YYYY-MM-DD: <1-line decision or pattern> → detail
 ```
-Place under the appropriate category. Add `→ spec file` pointer if details belong in a spec.
+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`.

package/templates/MEMORY-DETAIL.md

@@ -0,0 +1,16 @@
+# Memory Detail
+
+Full Problem/Solution context for entries in MEMORY.md. Read on-demand when needing to understand *why* a decision was made.
+
+---
+
+## Example Category
+
+### Example decision title
+- **Date**: YYYY-MM-DD
+- **Problem**: What issue or question prompted this decision
+- **Solution**: What was decided and why
+
+---
+
+<!-- Add new detailed entries below. Use the format above. -->

package/templates/copilot-instructions.md

@@ -1,30 +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 & patterns | `.agents/MEMORY.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>`.
-- Read `.agents/MEMORY.md` before implementing; follow spec file pointers for details.
-- Do not create additional memory files.

package/templates/cursorrules.md

@@ -1,43 +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 & patterns | `.agents/MEMORY.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>
-```
-Place under the appropriate category. Add `→ spec file` pointer if details belong in a spec.
-
-### 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,43 +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 & patterns | `.agents/MEMORY.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>
-```
-Place under the appropriate category. Add `→ spec file` pointer if details belong in a spec.
-
-### 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.