add-coder 0.1.5 → 0.1.8

package/README.md

@@ -1,10 +1,70 @@
 # add-coder
 
-[codein2027](https://github.com/xiaomingming92/codein2027) 项目配套工具包——将 ADD 范式从"公司内部方法论"落地为"任何人 `npx` 即可体验的开源工具"。
+**AI 代码治理的落地方案** — [codein2027](https://github.com/xiaomingming92/codein2027) 快速构建 ADD 编程范式的完整脚手架。以「审计即基础设施」为核心，彻底打破编程过程黑盒与跨轮失忆，让编程范式进化为可审计、可追溯、可收敛的新时代。[本项目NPM包地址](https://www.npmjs.com/package/add-coder)
 
-一键初始化 ADD（Audit-Driven Development）范式工作流模板，支持 Claude Code、Qoder、VS Code 三端。
+```bash
+npx add-coder init
+```
+
+---
+
+## 这不是模板工具，这是架构差异
+
+市面上已有大量 AI 编程模板、hook 适配器、MCP 脚手架。add-coder 与它们的根本区别不在「生成什么文件」，而在 **架构层面的范式转换**：
+
+### ① 审计是基础设施，而非事后日志
+
+传统 AI 开发：对话 → 生成代码 → 事后翻聊天记录找「谁改了什么」
+
+| 传统模式 | add-coder |
+|---------|----------|
+| 日志是 append-only 文本文件 | 审计是 **结构化数据表**（DevOperation + AuditLog），支持按 plan/step/agent/tool 多维查询 |
+| 审计靠开发者自觉记录 | **MCP 审计工具链** 自动记录每次操作，系统闸门强制检查 |
+| 无关联性 | 审计事件天然关联 Plan → Spec → Task → Step → Tool Call，形成完整证据链 |
+
+### ② 门禁驱动，而非自由对话
+
+传统 AI coding 是「你说我做」，质量完全依赖 LLM 当天状态。add-coder 在架构中嵌入了 **双质量闸门**：
+
+```
+DPS (Design-Process Symmetry)  — 设计/实现/文档/审计 四维各 25%，< 85% BLOCKED
+RAHS (Runtime Architecture Health Score) — 运行时架构健康度，< 90% BLOCKED
+```
+
+这不是「建议」，是**架构阻断** — 不通过闸门的 Step 无法推进到下一步。
+
+### ③ 跨轮记忆，而非每轮失忆
+
+AI 对话的致命缺陷：上次讨论的架构决策、已修复的 Bug、达成的约定，下轮对话全部遗忘。add-coder 在架构层面解决：
+
+- **Handoff 文档** — 每轮 Session 结束时自动生成结构化交接文档，下轮会话自动加载
+- **Plan 索引** — 所有 Plan 通过 `index.md` 集中索引，支持模糊匹配快速定位
+- **DevLog 时序记录** — 每一步操作写入 `{YYYY-MM}/{DD}/` 时间轴，可回溯任意历史状态
 
-ADD 范式将 AI 开发从"口述代码"升级为"可审计工程"——DPS/RAHS 双质量闸门 + ADD-7 审计追踪 + policy-update-loop 运行时自适应。详见 [codein2027/README.md §"ADD 范式与商业化路径"](https://github.com/xiaomingming92/codein2027#add-paradigm)。
+### ④ Policy-Update-Loop：治理自我进化
+
+不是静态模板，而是**闭环自适应系统**：
+
+```
+执行 → 审计 → 边界报告 → 规则调整 → 下一轮执行
+```
+
+运行时产生的 Report 会反过来更新 governance rules，实现治理策略的持续进化。
+
+### ⑤ 多 IDE 的 Hook 即治理层
+
+hook 不是「通知推送」，而是 **IDE 运行时拦截层**：
+
+| Hook 类型 | 作用 |
+|----------|------|
+| PreToolUse | 工具调用前校验白名单、注入上下文、DPS 条件检查 |
+| PostToolUse | 自动审计记录、Plan 同步检测、格式守卫 |
+| PreCompact | 跨轮上下文压缩时强制保留关键文档路径 |
+| PromptSubmit | 注入 ADD 词汇表触发词，确保 LLM 对「验收」「门禁」等命令零延迟响应 |
+
+每个 IDE（Claude/Qoder/VS Code）有各自的 hook 实现，但**治理逻辑统一** — 架构一致，适配层不同。
+
+---
 
 ## 快速开始
 
@@ -47,8 +107,6 @@ npx add-coder init --yes
 
 ### init 内部流程
 
-`npx add-coder init` 按以下步骤执行：
-
 | 步骤 | 动作 | 说明 |
 |------|------|------|
 | ① | 检测 IDE | 扫描 `.qoder/` `.claude/` `.vscode/` 存在性，或通过 `--adapter` 指定 |
@@ -59,8 +117,6 @@ npx add-coder init --yes
 | ⑥ | 写入文件 | 交互/yes/force/dry-run 四种模式，`.sh` 脚本自动 `chmod` |
 | ⑦ | 输出摘要 | 新建/跳过/覆盖统计 + 下一步提示 |
 
-> **Prisma 注入说明**：ADD-7 审计需要 `DevOperation` + `AuditLog` 两张表。首次 `init` 自动引导 `prisma init` 并注入 `User` 模型，第二次 `init` 执行 `prisma migrate dev` 完成建表。
-
 ### init 选项
 
 | 选项 | 说明 |
@@ -80,11 +136,61 @@ npx add-coder init --yes
 | `.qoder/` | Qoder 适配（hooks、settings.json、mcp.json） |
 | `.vscode/` | VS Code 适配（settings.json、tasks.json） |
 
-## 边界说明
+## MCP 审计工具链
+
+`init` 自动部署 MCP 服务器 (`mcp-server.ts`) 到项目中，IDE 通过 `mcp.json` 加载。提供以下审计与治理工具：
 
-npm 包提供模板和 MCP 工具链骨架。Report 体系（gateway.md 边界监测）和 policy-update-loop 运行时自适应由宿主项目实现，不在 npm 包覆盖范围内。
+| 工具 | 用途 | 触发场景 |
+|------|------|---------|
+| `record_dev_operation` | 记录开发操作审计（before/after/reason） | 每次文件变更、配置修改 |
+| `query_audit_logs` | 按 planKeyword / targetId 查询审计记录 | 跨会话恢复上下文、验证迭代证据 |
+| `get_project_context` | 获取 ADD 工作流状态快照 | 空白对话开局 |
+| `get_db_schema` | 获取 Prisma schema 信息 | 数据库相关操作 |
+| `check_dps` | DPS 闸门（设计/实现/文档/审计 四维各 25%） | Step 0 末尾 |
+| `check_rahs` | RAHS 闸门（运行时架构健康度） | Step 4/8 |
+| `check_add_route_status` | add-route 文件存在性校验 | Step 3 前 |
+| `check_spec_sync` | Spec 文档勾选状态与代码一致性 | Spec 执行后 |
+| `find_related_docs` | 检索相关架构/规范文档 | 语境理解 |
 
-> 🚧 **即将上线**：ADD 范式项目案例仓库——沉淀真实 ADD 项目案例讲解Report 体系（gateway.md 边界监测）和 policy-update-loop 运行时自适应
+> 完整工具列表见 [MCP 工具链规范](https://github.com/xiaomingming92/codein2027/blob/main/docs/大田精准耕播智能决策系统/knowledge/02-规范/%E3%80%8A%E5%BC%80%E5%8F%91%E6%93%8D%E4%BD%9C%E5%AE%A1%E8%AE%A1%E5%AD%98%E6%A1%A3%E8%A7%84%E8%8C%83%E3%80%8B.md)。
+
+## 架构全景
+
+```
+                    ┌─────────────┐
+                    │  ADD 范式    │
+                    │  Step 0-9    │
+                    └──────┬──────┘
+                           │ 门禁驱动
+              ┌────────────┼────────────┐
+              ▼            ▼            ▼
+       ┌──────────┐ ┌──────────┐ ┌──────────┐
+       │ DPS 闸门 │ │ RAHS 闸门│ │合规检查  │
+       └────┬─────┘ └────┬─────┘ └────┬─────┘
+            │            │            │
+              ▼            ▼            ▼
+       ┌─────────────────────────────────────┐
+       │         审计基础设施层                │
+       │  DevOperation / AuditLog 表           │
+       │  MCP 审计工具链                       │
+       │  Handoff / DevLog 时序文档            │
+       └─────────────────────────────────────┘
+                           │
+              ┌────────────┼────────────┐
+              ▼            ▼            ▼
+       ┌──────────┐ ┌──────────┐ ┌──────────┐
+       │ Claude   │ │  Qoder   │ │  VS Code │
+       │ Hooks    │ │  Hooks   │ │  Config  │
+       └──────────┘ └──────────┘ └──────────┘
+                           │
+              ┌────────────┘
+              ▼
+       ┌─────────────────────────────────────┐
+       │     Caijuehub 规则引擎               │
+       │  TOML 驱动的策略体系                 │
+       │  检测/适配/Prisma/写入 全可配置       │
+       └─────────────────────────────────────┘
+```
 
 ## 前置条件
 
@@ -102,4 +208,4 @@ npm 包提供模板和 MCP 工具链骨架。Report 体系（gateway.md 边界
 >     POSTGRES_USER: admin
 >     POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
 > ```
-> 数据卷建议挂载到 `~/data/your_project/postgres/`，避免容器销毁丢失数据。
+> 数据卷建议挂载到 `~/data/your_project/postgres/`，避免容器销毁丢失数据。

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
 // src/cli/index.ts
+import { readFileSync as readFileSync7 } from "fs";
 import { Command } from "commander";
 
 // src/caijuehub/strategies/detect.strategy.ts
@@ -83,7 +84,7 @@ var defaults = {
 };
 
 // src/cli/config-loader.ts
-async function loadConfig(projectRoot, configPath, options) {
+async function loadConfig(projectRoot, configPath, _options) {
   let config = { ...defaults };
   const pkgPath = join2(projectRoot, "package.json");
   if (existsSync2(pkgPath)) {
@@ -114,12 +115,9 @@ ${errors}`);
 // src/caijuehub/strategies/writer.strategy.ts
 import { existsSync as existsSync3, mkdirSync, writeFileSync, chmodSync } from "fs";
 import { join as join3, dirname } from "path";
+
+// src/lib/utils.ts
 import { createInterface } from "readline";
-var WRITER_CONFIG = {
-  onExisting: "ask",
-  jsonMerge: "deep",
-  shellChmod: true
-};
 function ask(q) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
   return new Promise((r) => {
@@ -129,6 +127,13 @@ function ask(q) {
     });
   });
 }
+
+// src/caijuehub/strategies/writer.strategy.ts
+var WRITER_CONFIG = {
+  onExisting: "ask",
+  jsonMerge: "deep",
+  shellChmod: true
+};
 async function writeFiles(projectRoot, files, options = {}) {
   const C = WRITER_CONFIG;
   let created = 0, skipped = 0, overwritten = 0;
@@ -186,6 +191,7 @@ var PLACEHOLDERS = {
   "{{docsDir}}": "docsDir",
   "{{logDir}}": "logDir",
   "{{envFilePath}}": "envFilePath",
+  "{{magicDir}}": "magicDir",
   "{{auditLoggerPath}}": "auditLoggerPath",
   "{{mcpServerCommand}}": "mcpServerCommand",
   "{{agentAuditImport}}": "agentAuditImport"
@@ -320,10 +326,9 @@ import { resolve as resolve2, dirname as dirname6 } from "path";
 import { fileURLToPath as fileURLToPath5 } from "url";
 
 // src/caijuehub/strategies/prisma.strategy.ts
-import { execSync } from "child_process";
+import { spawnSync } from "child_process";
 import { copyFileSync, existsSync as existsSync4, readFileSync as readFileSync6, unlinkSync, writeFileSync as writeFileSync2 } from "fs";
 import { resolve } from "path";
-import { createInterface as createInterface2 } from "readline";
 var PRISMA_CONFIG = {
   onMissing: "ask",
   onExistingAddPrisma: "ask",
@@ -333,15 +338,6 @@ var PRISMA_CONFIG = {
   schemaArg: "--schema=prisma/",
   requiresUserModel: true
 };
-function ask2(q) {
-  const rl = createInterface2({ input: process.stdin, output: process.stdout });
-  return new Promise((r) => {
-    rl.question(q, (a) => {
-      rl.close();
-      r(a.trim().toLowerCase());
-    });
-  });
-}
 async function injectPrisma(projectRoot, addPrismaTemplate, options = {}) {
   const C = PRISMA_CONFIG;
   const prismaDir = resolve(projectRoot, "prisma");
@@ -353,10 +349,10 @@ async function injectPrisma(projectRoot, addPrismaTemplate, options = {}) {
       return true;
     }
     if (C.onMissing === "ask" && !options.force && !options.yes) {
-      const a = await ask2("\u9879\u76EE\u7F3A\u5C11 Prisma\uFF0C\u662F\u5426\u6267\u884C prisma init\uFF1F[Y/n] ");
+      const a = await ask("\u9879\u76EE\u7F3A\u5C11 Prisma\uFF0C\u662F\u5426\u6267\u884C prisma init\uFF1F[Y/n] ");
       if (a !== "n" && a !== "no") {
         console.log("\u6267\u884C npx prisma init ...");
-        execSync("npx prisma init --datasource-provider postgresql", { cwd: projectRoot, stdio: "inherit" });
+        spawnSync("npx", ["prisma", "init", "--datasource-provider", "postgresql"], { cwd: projectRoot, stdio: "inherit", shell: false });
         const envPath = resolve(projectRoot, ".env");
         const devEnvPath = resolve(projectRoot, ".env.development");
         if (existsSync4(envPath)) {
@@ -368,7 +364,7 @@ async function injectPrisma(projectRoot, addPrismaTemplate, options = {}) {
               writeFileSync2(devEnvPath, `${existing}${existing ? "\n" : ""}${dbUrl[0]}
 `, "utf-8");
             }
-            execSync("rm -f .env", { cwd: projectRoot });
+            if (existsSync4(envPath)) unlinkSync(envPath);
             console.log("\u5DF2\u5C06 DATABASE_URL \u8FC1\u79FB\u5230 .env.development");
           }
         }
@@ -393,7 +389,7 @@ async function injectPrisma(projectRoot, addPrismaTemplate, options = {}) {
       writeFileSync2(schemaPath, userModel + "\n" + schema, "utf-8");
       console.log("\u5DF2\u6CE8\u5165 User \u6A21\u578B\u5230 schema.prisma");
     } else {
-      const a = await ask2("schema.prisma \u7F3A\u5C11 User \u6A21\u578B\uFF0C\u662F\u5426\u81EA\u52A8\u6CE8\u5165\uFF1F[Y/n] ");
+      const a = await ask("schema.prisma \u7F3A\u5C11 User \u6A21\u578B\uFF0C\u662F\u5426\u81EA\u52A8\u6CE8\u5165\uFF1F[Y/n] ");
       if (a !== "n" && a !== "no") {
         const schema = readFileSync6(schemaPath, "utf-8");
         writeFileSync2(schemaPath, userModel + "\n" + schema, "utf-8");
@@ -415,14 +411,14 @@ async function injectPrisma(projectRoot, addPrismaTemplate, options = {}) {
       console.log("\u8DF3\u8FC7");
       return true;
     } else {
-      const choice = await ask2("\u5DF2\u6709 prisma/add.prisma\uFF1A[s]\u8DF3\u8FC7 / [o]\u8986\u76D6 / [d]diff\uFF08\u9ED8\u8BA4 s\uFF09: ");
+      const choice = await ask("\u5DF2\u6709 prisma/add.prisma\uFF1A[s]\u8DF3\u8FC7 / [o]\u8986\u76D6 / [d]diff\uFF08\u9ED8\u8BA4 s\uFF09: ");
       if (choice === "o") {
         console.log("\u8986\u76D6");
       } else if (choice === "d") {
         copyFileSync(destPath, destPath + ".bak");
         console.log("=== \u5F53\u524D\uFF08\u5DF2\u5907\u4EFD\uFF09===\n" + readFileSync6(destPath, "utf-8"));
         console.log("=== \u6A21\u677F ===\n" + readFileSync6(addPrismaTemplate, "utf-8"));
-        if (await ask2("\u786E\u8BA4\u8986\u76D6\uFF1F[y/N] ") !== "y") {
+        if (await ask("\u786E\u8BA4\u8986\u76D6\uFF1F[y/N] ") !== "y") {
           console.log("\u5DF2\u8DF3\u8FC7");
           return true;
         }
@@ -439,21 +435,26 @@ async function injectPrisma(projectRoot, addPrismaTemplate, options = {}) {
   copyFileSync(addPrismaTemplate, destPath);
   console.log("\u5DF2\u590D\u5236 add.prisma");
   try {
-    const cmd = `npx prisma migrate dev --name ${C.migrationName} ${C.schemaArg}`;
-    console.log(`\u6267\u884C ${cmd} ...`);
-    execSync(cmd, { cwd: projectRoot, stdio: "inherit" });
+    const args = ["prisma", "migrate", "dev", "--name", C.migrationName];
+    if (C.schemaArg) args.push(C.schemaArg);
+    console.log(`\u6267\u884C npx ${args.join(" ")} ...`);
+    const r = spawnSync("npx", args, { cwd: projectRoot, stdio: "inherit", shell: false });
+    if (r.status !== 0) throw new Error(`prisma migrate dev \u9000\u51FA\u7801: ${r.status}`);
   } catch (err) {
     if (C.onMigrateFail === "keep") {
       console.log("\u8FC1\u79FB\u5931\u8D25\uFF0C\u4FDD\u7559\u6587\u4EF6");
       return true;
     }
-    unlinkSync(destPath);
+    try {
+      unlinkSync(destPath);
+    } catch {
+    }
     console.log("\u5DF2\u56DE\u6EDA");
     throw new Error(`\u8FC1\u79FB\u5931\u8D25: ${err instanceof Error ? err.message : String(err)}`);
   }
   if (C.autoGenerate) {
     console.log("\u6267\u884C prisma generate ...");
-    execSync("npx prisma generate", { cwd: projectRoot, stdio: "inherit" });
+    spawnSync("npx", ["prisma", "generate"], { cwd: projectRoot, stdio: "inherit", shell: false });
   }
   console.log("ADD \u6CBB\u7406\u6A21\u578B\u5DF2\u5C31\u7EEA");
   return true;
@@ -480,10 +481,14 @@ async function initCommand(options) {
   console.log(`\u68C0\u6D4B\u5230 IDE: ${target}${specified ? " (--adapter)" : " (\u81EA\u52A8)"}`);
   const config = await loadConfig(projectRoot, options.config, { yes: options.yes, force: options.force });
   config.projectRoot = projectRoot;
+  const MAGIC_DIR_MAP = { claude: ".claude", qoder: ".qoder", vscode: ".vscode" };
+  const magicDir = MAGIC_DIR_MAP[target] || ".qoder";
+  console.log(`magicDir: ${magicDir}`);
+  const renderConfig = { ...config, magicDir };
   if (!options.dryRun) {
     await injectPrisma2(projectRoot, { yes: options.yes, force: options.force, dryRun: options.dryRun });
   }
-  const coreFiles = renderCore(config, !!options.dryRun);
+  const coreFiles = renderCore(renderConfig, !!options.dryRun);
   console.log(`Core \u6A21\u677F: ${coreFiles.size} \u6587\u4EF6`);
   const CORE_TARGETS = [".add", ".qoder", ".claude"];
   const allFiles = /* @__PURE__ */ new Map();
@@ -568,8 +573,11 @@ async function statusCommand() {
 }
 
 // src/cli/index.ts
+var { version } = JSON.parse(
+  readFileSync7(new URL("../package.json", import.meta.url), "utf-8")
+);
 var program = new Command();
-program.name("add-coder").description("\u521D\u59CB\u5316 ADD \u8303\u5F0F\u5DE5\u4F5C\u6D41\u6A21\u677F").version("0.1.0");
+program.name("add-coder").description("\u521D\u59CB\u5316 ADD \u8303\u5F0F\u5DE5\u4F5C\u6D41\u6A21\u677F").version(version);
 program.command("init").description("\u521D\u59CB\u5316 ADD \u6A21\u677F\u5230\u5F53\u524D\u9879\u76EE").option("--adapter <type>", "\u76EE\u6807 IDE: claude | qoder | vscode | auto", "auto").option("--config <path>", "\u6307\u5B9A\u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84").option("--yes", "\u8DF3\u8FC7\u4EA4\u4E92\uFF0C\u53EA\u521B\u5EFA\u65B0\u6587\u4EF6").option("--force", "\u8986\u76D6\u5DF2\u6709\u6587\u4EF6\uFF0C\u4E0D\u4EA4\u4E92").option("--dry-run", "\u9884\u89C8\u6A21\u5F0F\uFF0C\u4E0D\u5B9E\u9645\u5199\u5165").action(initCommand);
 program.command("sync").description("\u589E\u91CF\u540C\u6B65\u7F3A\u5931\u6587\u4EF6").action(syncCommand);
 program.command("status").description("\u68C0\u67E5 ADD \u6A21\u677F\u5B8C\u6574\u6027").action(statusCommand);

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "add-coder",
-  "version": "0.1.5",
+  "version": "0.1.8",
   "private": false,
-  "description": "Initialize ADD paradigm workflow templates for Claude Code, Qoder, and VS Code.",
+  "description": "[codein2027](https://github.com/xiaomingming92/codein2027) 快速构建 ADD 编程范式的完整脚手架——AI 代码治理的落地方案。以「审计即基础设施」为核心，彻底打破编程过程黑盒与跨轮失忆，让编程范式进化为可审计、可追溯、可收敛的新时代。npx 即用，人人可体验。",
   "type": "module",
   "bin": {
     "add-coder": "bin/add-coder.js"
@@ -15,19 +15,11 @@
   "engines": {
     "node": ">=20"
   },
-  "packageManager": "pnpm@11.9.0",
   "files": [
     "bin",
     "dist",
     "templates"
   ],
-  "scripts": {
-    "build": "tsup",
-    "prepare": "tsup",
-    "dev": "tsup --watch",
-    "generate": "tsx src/caijuehub/transcribe.ts",
-    "test": "node bin/add-coder.js --help"
-  },
   "keywords": [
     "add",
     "add-paradigm",
@@ -35,11 +27,12 @@
     "qoder",
     "vscode",
     "mcp",
-    "workflow"
+    "workflow",
+    "codein2027"
   ],
   "author": "xiaomingming",
   "email": "wujixmm@gmail.com",
-  "license": "AGPL-3.0 license",
+  "license": "AGPL-3.0-only",
   "dependencies": {
     "commander": "^13.1.0",
     "smol-toml": "^1.7.0",
@@ -58,7 +51,19 @@
     }
   },
   "devDependencies": {
+    "@eslint/js": "^9.39.4",
+    "@types/node": "^22.20.1",
+    "eslint": "^9.39.4",
     "tsup": "^8.4.0",
-    "typescript": "^5.7.0"
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.62.1"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "generate": "tsx src/caijuehub/transcribe.ts",
+    "test": "node bin/add-coder.js --help"
   }
 }

package/templates/core/plans/2026-07/08/farm-agent-add-coder-npm-package-add-route-v1.md

@@ -14,6 +14,7 @@
 
 **输入**：
 - 上游 Review：`.qoder/reviews/farm-agent-add-coder-npm-package-review-v1.md` ✅
+- 上游 Review v2：`.qoder/reviews/farm-agent-add-coder-npm-package-review-v2.md` ✅ — 代码实现评审
 - Plan 文档：`.qoder/plans/2026-07/08/farm-agent-add-coder-npm-package-plan-v1.md` ✅
 
 **动作**：
@@ -107,11 +108,12 @@
 | 4 | 3 | Claude 适配器实现 | `templates/adapters/claude/`、`src/adapters/claude/renderer.ts` | `record_dev_operation` (CREATE) | — | 第2轮 Task 0 | ⬜ |
 | 5 | 3 | Qoder 适配器实现 | `templates/adapters/qoder/`、`src/adapters/qoder/renderer.ts` | `record_dev_operation` (CREATE/MODIFY) | — | 第3轮 Task 0 | ⬜ |
 | 6 | 3 | VS Code 适配器实现 | `templates/adapters/vscode/`、`src/adapters/vscode/renderer.ts` | `record_dev_operation` (CREATE/MODIFY) | — | 第3轮 Task 1 | ⬜ |
+| 6b | 3 | 三目录部署（core→.add/.qoder/.claude） | `src/core/renderer.ts`、`src/cli/commands/init.ts`、adapter renderers | `record_dev_operation` (MODIFY) | — | 第3轮 Task 2 | ⬜ |
 | 7 | 4 | 配置系统（Zod schema） | `src/config/schema.ts`、`src/config/defaults.ts` | `record_dev_operation` (CREATE) | — | 无 | ⬜ |
 | 8 | 4 | CLI 重写 | `src/cli/`、`bin/add-coder.js`、`tsup.config.ts` | `record_dev_operation` (CREATE/MODIFY) | — | 第1轮 Task 0 + 第4轮 Task 0 | ⬜ |
 | 9 | 5 | 集成测试 + 文档 + devlog | 测试文件、`README.md`、`package.json` | `record_dev_operation` (CREATE/MODIFY) | — | 全部前序 Task | ⬜ |
-| 10 | 6 | CaijueHub 核心 | `src/caijuehub/caijue.toml`、`src/caijuehub/caijue.ts` | `record_dev_operation` (CREATE) | — | 第4轮 Task 1 | ⬜ |
-| 11 | 6 | 重构模块读 caijue | `src/cli/detect.ts`、`src/cli/commands/init.ts` | `record_dev_operation` (MODIFY) | — | 第6轮 Task 0 | ⬜ |
+| 10 | 6 | CaijueHub 核心 | `src/caijuehub/caijue.toml`、`src/caijuehub/caijue.ts`、`src/caijuehub/transcribe.ts`、`src/caijuehub/*-rules.toml` (4) | `record_dev_operation` (CREATE) | — | 第4轮 Task 1 | ⬜ |
+| 11 | 6 | 策略文件 + cli 重构 | `src/caijuehub/strategies/*.strategy.ts` (4)、`src/cli/detect.ts`、`src/cli/prisma-injector.ts`、`src/cli/writer.ts` | `record_dev_operation` (CREATE/MODIFY) | — | 第6轮 Task 0 | ⬜ |
 
 ### 依赖拓扑
 
@@ -127,6 +129,9 @@
            ▼
 第3轮: 适配器实现
   Task 0: Claude → Task 1: Qoder → Task 2: VS Code（串行）
+           │
+           ▼  增量：core 内容三目录部署
+  Task 3.3: renderCore() 改造 → adapter renderers 不再重复部署 core
            │
            ▼
 第4轮: 配置 + CLI
@@ -320,4 +325,7 @@
 | `packages/add-coder/templates/docs/` (grounding 文档) | CREATE | 1/1 | DOC | ⬜ |
 | `packages/add-coder/src/caijuehub/caijue.toml` | CREATE | 6/0 | CAIJUE_CONFIG | ⬜ |
 | `packages/add-coder/src/caijuehub/caijue.ts` | CREATE | 6/0 | CAIJUE_CONFIG | ⬜ |
+| `packages/add-coder/src/caijuehub/transcribe.ts` | CREATE | 6/0 | CAIJUE_CONFIG | ⬜ |
+| `packages/add-coder/src/caijuehub/*-rules.toml` (4) | CREATE | 6/0 | CAIJUE_CONFIG | ⬜ |
+| `packages/add-coder/src/caijuehub/strategies/*.strategy.ts` (4) | CREATE | 6/1 | STRATEGY | ⬜ |
 | `packages/add-coder/README.md` | MODIFY | 5/0 | DOC | ⬜ |

package/templates/core/plans/2026-07/08/farm-agent-add-coder-npm-package-handoff-v1.md

@@ -610,6 +610,11 @@ npm run generate → transcribe.ts → GENERATED 区块         │ injectPrisma
 | caijue.toml | 无 | 索引注册 4 个策略 | 新增 |
 | transcribe.ts | 无 | GENERATED 区块产出引擎 | 新增 |
 | 策略文件 | 无 | GENERATED+USER CODE 双区块模式 | 新增 |
+| 模板部署策略 | 仅 `.add/` | `.qoder/` `.claude/` 同时部署 core 内容 | IDE 只认自身 magic path，需三者各自完整 |
+| `templates/core/prisma/` | add.prisma 模板 | 删除，由 injectPrisma 直接处理 | Prisma 文件不应在 `.add/` 下 |
+| plans/specs 示例 | 无 | `templates/core/plans/` `specs/` 含 add-coder 示例 | 用户首次 init 即可看到完整 ADD 文档样例 |
+| 三目录部署 | 仅 `.add/` | Plan 已设计，`renderCore()` 改造待执行 | 见 Plan §3.2 改造待执行清单 |
+| Review v2 回流 | 无 | `.qoder/reviews/farm-agent-add-coder-npm-package-review-v2.md` | 代码实现评审：2 条 P0（spawnSync catch 失能、ask 重复定义）在 Plan §4.8 回流，P0-1 已补充至 Task 1.0 验收项 |
 
 ## §8 验证结果
 
@@ -630,6 +635,9 @@ npm run generate → transcribe.ts → GENERATED 区块         │ injectPrisma
 - [x] `grep -r "farm.agent\|大田\|/home/xmm" templates/` 返回空
 - [ ] `npm pack` → `npm install` 端到端（待运行时验证）
 - [x] ADD-7 `query_audit_logs` 回查确认 — 共 20 条记录，覆盖 6 轮全部关键文件
+- [x] Review v2 P0-1（spawnSync catch 失能）已记录至 Plan 并补充验收项
+- [ ] Review v2 P0-2（ask 重复定义）待第6轮 CaijueHub 重构时提取到 utils
+- [ ] Review v2 P1-1（unlinkSync 缺口）、P1-2/3（gitignore）待 CI 基建清单补充
 
 ---