ccg-workflow 3.0.10 → 3.1.0

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import cac from 'cac';
 import ansis from 'ansis';
-import { A as diagnoseMcpConfig, B as isWindows, C as readClaudeCodeConfig, D as fixWindowsMcpConfig, E as writeClaudeCodeConfig, r as readCcgConfig, b as initI18n, a as i18n, s as showMainMenu, i as init, F as configMcp, G as version } from './shared/ccg-workflow.Btj19K42.mjs';
+import { B as diagnoseMcpConfig, C as isWindows, D as readClaudeCodeConfig, E as fixWindowsMcpConfig, F as writeClaudeCodeConfig, r as readCcgConfig, b as initI18n, a as i18n, s as showMainMenu, i as init, G as configMcp, H as version } from './shared/ccg-workflow.B4hxlK6F.mjs';
 import 'inquirer';
 import 'ora';
 import 'node:child_process';

package/dist/index.d.mts

@@ -13,7 +13,7 @@ interface CliOptions {
 }
 
 type SupportedLang = 'zh-CN' | 'en';
-type ModelType = 'codex' | 'gemini' | 'claude';
+type ModelType = 'codex' | 'gemini' | 'claude' | 'antigravity';
 type CollaborationMode = 'parallel' | 'smart' | 'sequential';
 type RoutingStrategy = 'parallel' | 'fallback' | 'round-robin';
 interface ModelRouting {
@@ -162,6 +162,14 @@ declare function installCodexMode(): Promise<{
     success: boolean;
     message: string;
 }>;
+/**
+ * Uninstall CCG Codex mode — only removes files installed by CCG, preserves user files.
+ */
+declare function uninstallCodexMode(): Promise<{
+    success: boolean;
+    removed: string[];
+    skipped: string[];
+}>;
 declare function installWorkflows(workflowIds: string[], installDir: string, force?: boolean, config?: {
     routing?: {
         mode?: string;
@@ -244,5 +252,5 @@ declare function checkForUpdates(): Promise<{
     latestVersion: string | null;
 }>;
 
-export { changeLanguage, checkForUpdates, compareVersions, createDefaultConfig, createDefaultRouting, getCcgDir, getConfigPath, getCurrentVersion, getLatestVersion, getWorkflowById, getWorkflowConfigs, i18n, init, initI18n, installAceTool, installAceToolRs, installCodexMode, installWorkflows, migrateToV1_4_0, needsMigration, readCcgConfig, showMainMenu, uninstallAceTool, uninstallWorkflows, update, writeCcgConfig };
+export { changeLanguage, checkForUpdates, compareVersions, createDefaultConfig, createDefaultRouting, getCcgDir, getConfigPath, getCurrentVersion, getLatestVersion, getWorkflowById, getWorkflowConfigs, i18n, init, initI18n, installAceTool, installAceToolRs, installCodexMode, installWorkflows, migrateToV1_4_0, needsMigration, readCcgConfig, showMainMenu, uninstallAceTool, uninstallCodexMode, uninstallWorkflows, update, writeCcgConfig };
 export type { AceToolConfig, CcgConfig, CliOptions, CollaborationMode, FastContextConfig, InitOptions, InstallResult, ModelRouting, ModelType, RoutingStrategy, SupportedLang, WorkflowConfig };

package/dist/index.d.ts

@@ -13,7 +13,7 @@ interface CliOptions {
 }
 
 type SupportedLang = 'zh-CN' | 'en';
-type ModelType = 'codex' | 'gemini' | 'claude';
+type ModelType = 'codex' | 'gemini' | 'claude' | 'antigravity';
 type CollaborationMode = 'parallel' | 'smart' | 'sequential';
 type RoutingStrategy = 'parallel' | 'fallback' | 'round-robin';
 interface ModelRouting {
@@ -162,6 +162,14 @@ declare function installCodexMode(): Promise<{
     success: boolean;
     message: string;
 }>;
+/**
+ * Uninstall CCG Codex mode — only removes files installed by CCG, preserves user files.
+ */
+declare function uninstallCodexMode(): Promise<{
+    success: boolean;
+    removed: string[];
+    skipped: string[];
+}>;
 declare function installWorkflows(workflowIds: string[], installDir: string, force?: boolean, config?: {
     routing?: {
         mode?: string;
@@ -244,5 +252,5 @@ declare function checkForUpdates(): Promise<{
     latestVersion: string | null;
 }>;
 
-export { changeLanguage, checkForUpdates, compareVersions, createDefaultConfig, createDefaultRouting, getCcgDir, getConfigPath, getCurrentVersion, getLatestVersion, getWorkflowById, getWorkflowConfigs, i18n, init, initI18n, installAceTool, installAceToolRs, installCodexMode, installWorkflows, migrateToV1_4_0, needsMigration, readCcgConfig, showMainMenu, uninstallAceTool, uninstallWorkflows, update, writeCcgConfig };
+export { changeLanguage, checkForUpdates, compareVersions, createDefaultConfig, createDefaultRouting, getCcgDir, getConfigPath, getCurrentVersion, getLatestVersion, getWorkflowById, getWorkflowConfigs, i18n, init, initI18n, installAceTool, installAceToolRs, installCodexMode, installWorkflows, migrateToV1_4_0, needsMigration, readCcgConfig, showMainMenu, uninstallAceTool, uninstallCodexMode, uninstallWorkflows, update, writeCcgConfig };
 export type { AceToolConfig, CcgConfig, CliOptions, CollaborationMode, FastContextConfig, InitOptions, InstallResult, ModelRouting, ModelType, RoutingStrategy, SupportedLang, WorkflowConfig };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { c as changeLanguage, y as checkForUpdates, z as compareVersions, d as createDefaultConfig, e as createDefaultRouting, g as getCcgDir, f as getConfigPath, v as getCurrentVersion, x as getLatestVersion, j as getWorkflowById, h as getWorkflowConfigs, a as i18n, i as init, b as initI18n, l as installAceTool, m as installAceToolRs, n as installCodexMode, k as installWorkflows, q as migrateToV1_4_0, t as needsMigration, r as readCcgConfig, s as showMainMenu, p as uninstallAceTool, o as uninstallWorkflows, u as update, w as writeCcgConfig } from './shared/ccg-workflow.Btj19K42.mjs';
+export { c as changeLanguage, z as checkForUpdates, A as compareVersions, d as createDefaultConfig, e as createDefaultRouting, g as getCcgDir, f as getConfigPath, x as getCurrentVersion, y as getLatestVersion, j as getWorkflowById, h as getWorkflowConfigs, a as i18n, i as init, b as initI18n, l as installAceTool, m as installAceToolRs, n as installCodexMode, k as installWorkflows, t as migrateToV1_4_0, v as needsMigration, r as readCcgConfig, s as showMainMenu, q as uninstallAceTool, o as uninstallCodexMode, p as uninstallWorkflows, u as update, w as writeCcgConfig } from './shared/ccg-workflow.B4hxlK6F.mjs';
 import 'ansis';
 import 'inquirer';
 import 'ora';

package/dist/shared/{ccg-workflow.Btj19K42.mjs → ccg-workflow.B4hxlK6F.mjs}

@@ -10,7 +10,7 @@ import fs from 'fs-extra';
 import { parse, stringify } from 'smol-toml';
 import i18next from 'i18next';
 
-const version = "3.0.10";
+const version = "3.1.0";
 
 function cmd(id, order, category, name, nameEn, description, descriptionEn, cmdOverride) {
   return {
@@ -131,15 +131,15 @@ const MCP_PROVIDERS = {
 function injectConfigVariables(content, config) {
   let processed = content;
   const routing = config.routing || {};
-  const frontendModels = routing.frontend?.models || ["gemini"];
-  const frontendPrimary = routing.frontend?.primary || "gemini";
+  const frontendModels = routing.frontend?.models || ["antigravity"];
+  const frontendPrimary = routing.frontend?.primary || "antigravity";
   processed = processed.replace(/\{\{FRONTEND_MODELS\}\}/g, JSON.stringify(frontendModels));
   processed = processed.replace(/\{\{FRONTEND_PRIMARY\}\}/g, frontendPrimary);
   const backendModels = routing.backend?.models || ["codex"];
   const backendPrimary = routing.backend?.primary || "codex";
   processed = processed.replace(/\{\{BACKEND_MODELS\}\}/g, JSON.stringify(backendModels));
   processed = processed.replace(/\{\{BACKEND_PRIMARY\}\}/g, backendPrimary);
-  const reviewModels = routing.review?.models || ["codex", "gemini"];
+  const reviewModels = routing.review?.models || ["codex", "antigravity"];
   processed = processed.replace(/\{\{REVIEW_MODELS\}\}/g, JSON.stringify(reviewModels));
   const routingMode = routing.mode || "smart";
   processed = processed.replace(/\{\{ROUTING_MODE\}\}/g, routingMode);
@@ -814,7 +814,7 @@ async function removeFastContextPrompt() {
   await removeFromFile(join(homedir(), ".gemini", "GEMINI.md"));
 }
 
-const EXPECTED_BINARY_VERSION = "5.10.0";
+const EXPECTED_BINARY_VERSION = "5.11.0";
 const GITHUB_REPO = "fengshao1227/ccg-workflow";
 const RELEASE_TAG = "preset";
 const BINARY_SOURCES = [
@@ -957,7 +957,7 @@ async function installPromptFiles(ctx) {
     ctx.result.errors.push(`Prompts template directory not found: ${promptsTemplateDir}`);
     return;
   }
-  for (const model of ["codex", "gemini", "claude"]) {
+  for (const model of ["codex", "gemini", "claude", "antigravity"]) {
     try {
       const installed = await copyMdTemplates(
         ctx,
@@ -1137,6 +1137,50 @@ async function installCodexMode() {
     return { success: false, message: `Failed to install Codex mode: ${error}` };
   }
 }
+async function uninstallCodexMode() {
+  const codexHome = join(homedir(), ".codex");
+  const removed = [];
+  const skipped = [];
+  const ccgFiles = [
+    join(codexHome, "agents", "ccg-implement.toml"),
+    join(codexHome, "agents", "ccg-review.toml"),
+    join(codexHome, "agents", "ccg-research.toml"),
+    join(codexHome, "hooks", "ccg-workflow.py"),
+    join(codexHome, "hooks.json")
+  ];
+  const agentsMd = join(codexHome, "AGENTS.md");
+  try {
+    for (const file of ccgFiles) {
+      if (await fs.pathExists(file)) {
+        await fs.remove(file);
+        removed.push(file.replace(homedir(), "~"));
+      }
+    }
+    if (await fs.pathExists(agentsMd)) {
+      const content = await fs.readFile(agentsMd, "utf-8");
+      if (content.includes("<!-- CCG:START")) {
+        await fs.remove(agentsMd);
+        removed.push("~/.codex/AGENTS.md");
+      } else {
+        skipped.push("~/.codex/AGENTS.md (not managed by CCG)");
+      }
+    }
+    skipped.push("~/.codex/config.toml (preserved \u2014 may contain user settings)");
+    for (const dir of ["agents", "hooks"]) {
+      const dirPath = join(codexHome, dir);
+      if (await fs.pathExists(dirPath)) {
+        const files = await fs.readdir(dirPath);
+        if (files.length === 0) {
+          await fs.remove(dirPath);
+          removed.push(`~/.codex/${dir}/ (empty, removed)`);
+        }
+      }
+    }
+    return { success: true, removed, skipped };
+  } catch (error) {
+    return { success: false, removed, skipped: [...skipped, `Error: ${error}`] };
+  }
+}
 async function installRuleFiles(ctx) {
   try {
     const installed = await copyMdTemplates(
@@ -1348,9 +1392,9 @@ async function installWorkflows(workflowIds, installDir, force = false, config)
     config: {
       routing: config?.routing || {
         mode: "smart",
-        frontend: { models: ["gemini"], primary: "gemini" },
+        frontend: { models: ["antigravity"], primary: "antigravity" },
         backend: { models: ["codex"], primary: "codex" },
-        review: { models: ["codex", "gemini"] }
+        review: { models: ["codex", "antigravity"] }
       },
       liteMode: config?.liteMode || false,
       mcpProvider: config?.mcpProvider || "fast-context",
@@ -1492,6 +1536,7 @@ const installer = {
   syncMcpToCodex: syncMcpToCodex,
   syncMcpToGemini: syncMcpToGemini,
   uninstallAceTool: uninstallAceTool,
+  uninstallCodexMode: uninstallCodexMode,
   uninstallContextWeaver: uninstallContextWeaver,
   uninstallFastContext: uninstallFastContext,
   uninstallMcpServer: uninstallMcpServer,
@@ -2899,8 +2944,8 @@ function createDefaultConfig(options) {
 function createDefaultRouting() {
   return {
     frontend: {
-      models: ["gemini"],
-      primary: "gemini",
+      models: ["antigravity"],
+      primary: "antigravity",
       strategy: "parallel"
     },
     backend: {
@@ -2909,7 +2954,7 @@ function createDefaultRouting() {
       strategy: "parallel"
     },
     review: {
-      models: ["codex", "gemini"],
+      models: ["codex", "antigravity"],
       strategy: "parallel"
     },
     mode: "smart"
@@ -3158,7 +3203,7 @@ async function init(options = {}) {
     language = options.lang;
     await initI18n(language);
   }
-  let frontendModels = ["gemini"];
+  let frontendModels = ["antigravity"];
   let backendModels = ["codex"];
   let geminiModel = "gemini-3.1-pro-preview";
   const mode = "smart";
@@ -3166,7 +3211,7 @@ async function init(options = {}) {
   if (options.skipPrompt) {
     const existingConfig = await readCcgConfig();
     if (existingConfig?.routing) {
-      frontendModels = existingConfig.routing.frontend?.models || ["gemini"];
+      frontendModels = existingConfig.routing.frontend?.models || ["antigravity"];
       backendModels = existingConfig.routing.backend?.models || ["codex"];
       geminiModel = existingConfig.routing.geminiModel || "gemini-3.1-pro-preview";
     }
@@ -3290,11 +3335,12 @@ async function init(options = {}) {
         name: "selectedFrontend",
         message: i18n.t("init:model.selectFrontend"),
         choices: [
-          { name: `Gemini ${ansis.green(`(${i18n.t("init:model.recommended")})`)}`, value: "gemini" },
+          { name: `Antigravity ${ansis.green(`(${i18n.t("init:model.recommended")})`)}`, value: "antigravity" },
+          { name: "Gemini", value: "gemini" },
           { name: "Codex", value: "codex" },
           ...navSentinels(canGoBack)
         ],
-        default: frontendModels[0] || "gemini"
+        default: frontendModels[0] || "antigravity"
       }]);
       if (selectedFrontend === BACK_SENTINEL)
         return "back";
@@ -3305,8 +3351,9 @@ async function init(options = {}) {
         name: "selectedBackend",
         message: i18n.t("init:model.selectBackend"),
         choices: [
-          { name: "Gemini", value: "gemini" },
-          { name: `Codex ${ansis.green(`(${i18n.t("init:model.recommended")})`)}`, value: "codex" }
+          { name: `Codex ${ansis.green(`(${i18n.t("init:model.recommended")})`)}`, value: "codex" },
+          { name: "Antigravity", value: "antigravity" },
+          { name: "Gemini", value: "gemini" }
         ],
         default: backendModels[0] || "codex"
       }]);
@@ -4634,7 +4681,7 @@ async function configModelRouting() {
   console.log();
   console.log(ansis.cyan.bold(`  ${i18n.t("init:model.title")}`));
   console.log();
-  const currentFrontend = config?.routing?.frontend?.primary || "gemini";
+  const currentFrontend = config?.routing?.frontend?.primary || "antigravity";
   const currentBackend = config?.routing?.backend?.primary || "codex";
   const currentGeminiModel = config?.routing?.geminiModel || "gemini-3.1-pro-preview";
   console.log(ansis.gray(`  ${i18n.t("init:model.currentRouting")}:`));
@@ -4649,7 +4696,8 @@ async function configModelRouting() {
     name: "selectedFrontend",
     message: i18n.t("init:model.selectFrontend"),
     choices: [
-      { name: `Gemini ${ansis.green(`(${i18n.t("init:model.recommended")})`)}`, value: "gemini" },
+      { name: `Antigravity ${ansis.green(`(${i18n.t("init:model.recommended")})`)}`, value: "antigravity" },
+      { name: "Gemini", value: "gemini" },
       { name: "Codex", value: "codex" }
     ],
     default: currentFrontend
@@ -4659,8 +4707,9 @@ async function configModelRouting() {
     name: "selectedBackend",
     message: i18n.t("init:model.selectBackend"),
     choices: [
-      { name: "Gemini", value: "gemini" },
-      { name: `Codex ${ansis.green(`(${i18n.t("init:model.recommended")})`)}`, value: "codex" }
+      { name: `Codex ${ansis.green(`(${i18n.t("init:model.recommended")})`)}`, value: "codex" },
+      { name: "Antigravity", value: "antigravity" },
+      { name: "Gemini", value: "gemini" }
     ],
     default: currentBackend
   }]);
@@ -4784,16 +4833,48 @@ async function handleCodexMode() {
   console.log();
   console.log(ansis.cyan.bold(isZh ? "  Codex \u591A\u6A21\u578B\u7F16\u6392\u6A21\u5F0F" : "  Codex Multi-Model Orchestration Mode"));
   console.log();
+  const { action } = await inquirer.prompt([{
+    type: "list",
+    name: "action",
+    message: isZh ? "\u9009\u62E9\u64CD\u4F5C" : "Select action",
+    choices: [
+      { name: isZh ? "\u5B89\u88C5 / \u66F4\u65B0 Codex \u6A21\u5F0F" : "Install / Update Codex Mode", value: "install" },
+      { name: isZh ? "\u5378\u8F7D Codex \u6A21\u5F0F\uFF08\u53EA\u5220 CCG \u6587\u4EF6\uFF0C\u4FDD\u7559\u7528\u6237\u914D\u7F6E\uFF09" : "Uninstall Codex Mode (CCG files only, preserves user config)", value: "uninstall" },
+      { name: isZh ? "\u8FD4\u56DE" : "Back", value: "back" }
+    ]
+  }]);
+  if (action === "back") return;
+  if (action === "uninstall") {
+    const spinner2 = ora(isZh ? "\u5378\u8F7D Codex \u6A21\u5F0F..." : "Uninstalling Codex mode...").start();
+    const result2 = await uninstallCodexMode();
+    if (result2.success) {
+      spinner2.succeed(isZh ? "Codex \u6A21\u5F0F\u5DF2\u5378\u8F7D" : "Codex mode uninstalled");
+      if (result2.removed.length > 0) {
+        console.log();
+        for (const f of result2.removed) {
+          console.log(`  ${ansis.red("\u2717")} ${f}`);
+        }
+      }
+      if (result2.skipped.length > 0) {
+        console.log();
+        for (const f of result2.skipped) {
+          console.log(`  ${ansis.gray("\u25CB")} ${f}`);
+        }
+      }
+    } else {
+      spinner2.fail(isZh ? "\u5378\u8F7D\u5931\u8D25" : "Uninstall failed");
+    }
+    return;
+  }
   console.log(
-    isZh ? "  \u5B89\u88C5 CCG Codex \u6A21\u5F0F\u5230 ~/.codex/\uFF0C\u8BA9 Codex CLI \u4F5C\u4E3A\u4E3B\u5BFC\u8005\u7F16\u6392 Gemini + Claude\u3002" : "  Install CCG Codex mode to ~/.codex/, enabling Codex CLI as lead orchestrator for Gemini + Claude."
+    isZh ? "  \u5B89\u88C5 CCG Codex \u6A21\u5F0F\u5230 ~/.codex/\uFF0C\u8BA9 Codex CLI \u4F5C\u4E3A\u4E3B\u5BFC\u8005\u7F16\u6392\u591A\u6A21\u578B\u3002" : "  Install CCG Codex mode to ~/.codex/, enabling Codex CLI as lead orchestrator."
   );
   console.log();
   console.log(isZh ? "  \u5C06\u5B89\u88C5:" : "  Will install:");
-  console.log("    ~/.codex/AGENTS.md              \u2014 Codex auto-read instructions");
+  console.log("    ~/.codex/AGENTS.md              \u2014 orchestration instructions");
   console.log("    ~/.codex/config.toml             \u2014 multi-agent + timeout config");
-  console.log("    ~/.codex/agents/ccg-implement.toml");
-  console.log("    ~/.codex/agents/ccg-review.toml");
-  console.log("    ~/.codex/agents/ccg-research.toml");
+  console.log("    ~/.codex/hooks.json + hooks/     \u2014 adaptive guardrail hook");
+  console.log("    ~/.codex/agents/ccg-*.toml       \u2014 sub-agent definitions");
   console.log();
   const { confirm } = await inquirer.prompt([{
     type: "confirm",
@@ -5070,4 +5151,4 @@ async function uninstallCCometixLine() {
   }
 }
 
-export { diagnoseMcpConfig as A, isWindows as B, readClaudeCodeConfig as C, fixWindowsMcpConfig as D, writeClaudeCodeConfig as E, configMcp as F, version as G, i18n as a, initI18n as b, changeLanguage as c, createDefaultConfig as d, createDefaultRouting as e, getConfigPath as f, getCcgDir as g, getWorkflowConfigs as h, init as i, getWorkflowById as j, installWorkflows as k, installAceTool as l, installAceToolRs as m, installCodexMode as n, uninstallWorkflows as o, uninstallAceTool as p, migrateToV1_4_0 as q, readCcgConfig as r, showMainMenu as s, needsMigration as t, update as u, getCurrentVersion as v, writeCcgConfig as w, getLatestVersion as x, checkForUpdates as y, compareVersions as z };
+export { compareVersions as A, diagnoseMcpConfig as B, isWindows as C, readClaudeCodeConfig as D, fixWindowsMcpConfig as E, writeClaudeCodeConfig as F, configMcp as G, version as H, i18n as a, initI18n as b, changeLanguage as c, createDefaultConfig as d, createDefaultRouting as e, getConfigPath as f, getCcgDir as g, getWorkflowConfigs as h, init as i, getWorkflowById as j, installWorkflows as k, installAceTool as l, installAceToolRs as m, installCodexMode as n, uninstallCodexMode as o, uninstallWorkflows as p, uninstallAceTool as q, readCcgConfig as r, showMainMenu as s, migrateToV1_4_0 as t, update as u, needsMigration as v, writeCcgConfig as w, getCurrentVersion as x, getLatestVersion as y, checkForUpdates as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccg-workflow",
-  "version": "3.0.10",
+  "version": "3.1.0",
   "description": "Claude + Codex + Gemini multi-model collaboration system - smart routing development workflow",
   "type": "module",
   "packageManager": "pnpm@10.17.1",
@@ -42,6 +42,7 @@
     "templates/prompts/gemini/reviewer.md",
     "templates/prompts/gemini/tester.md",
     "templates/prompts/claude/",
+    "templates/prompts/antigravity/",
     "templates/output-styles/",
     "templates/skills/",
     "templates/rules/"

package/templates/codex/AGENTS.md

@@ -178,27 +178,94 @@ EOF
 ### 并行调用提醒
 M+ 复杂度的分析和审查，使用上方的"双模型并行"模板。不要分开调用，用 `&` + `wait` 并行执行。
 
-## 5. Implementation — 你自己写代码
+## 5. Implementation — 写代码
 
-### 执行模式：Inline（你自己按 plan 顺序逐文件写）
+### 模式选择
 
-**不要 spawn 子代理。** 你自己按 plan.md 的步骤顺序逐个文件写代码。这比子代理更稳定、更快、更可控。
+| 复杂度 | 模式 | 说明 |
+|--------|------|------|
+| **S-M** | **Inline** — 你自己写 | 逐文件按 plan 顺序，最稳定 |
+| **L+** | **Parallel** — spawn 子代理 | 按文件归属拆分，并行写，快 2-4x |
 
-### 执行流程
+### 模式 A: Inline（S-M 复杂度）
+
+按 plan.md 步骤顺序逐个文件写：
+1. 先写底层（store/model/util），再写上层（route/middleware）
+2. 每写完一个文件跑测试/类型检查
+3. 全部完成后跑完整测试套件
+4. `git diff` 确认变更在 plan 范围内
+
+### 模式 B: Parallel Spawn（L+ 复杂度）
+
+#### Step 1: 从 plan.md 拆分子任务
+
+按**文件归属**拆分，确保子任务互不重叠：
+- **Layer 1** — 无依赖的任务（可并行）
+- **Layer 2** — 依赖 Layer 1 的任务
+
+#### Step 2: 并行 spawn Layer 1
+
+**⛔ 关键：必须传 `fork_turns="none"`。** 否则子代理继承你的上下文，看到你的 spawn 记录，尝试 wait 自己 → 死锁。
+
+```
+# 所有 Layer 1 子代理在同一轮 spawn（= 真正并行）
+spawn_agent(
+  agent_type="ccg-implement",
+  fork_turns="none",
+  message="Active task: .ccg/tasks/{name}\n\n## 文件范围（⛔ 硬性规则）\n只能创建或修改：\n- {file1}\n- {file2}\n严禁修改其他文件。\n\n## 实施步骤\n{steps from plan.md}\n\n## 验收标准\n{criteria}"
+)
+spawn_agent(
+  agent_type="ccg-implement",
+  fork_turns="none",
+  message="Active task: .ccg/tasks/{name}\n\n## 文件范围\n- {file3}\n- {file4}\n\n## 实施步骤\n{steps}\n\n## 验收标准\n{criteria}"
+)
+```
+
+#### Step 3: Wait + Verify + Close
 
 ```
-1. 读 plan.md（如有）或回顾分析阶段的结论
-2. 按依赖顺序逐文件写：先写底层（store/model/util），再写上层（route/middleware）
-3. 每写完一个文件，跑一次测试/类型检查，确保不破坏现有功能
-4. 全部写完后，跑完整测试套件
-5. git diff 确认所有变更在 plan 范围内
+expected_agents = [agent_1, agent_2, ...]
+
+while expected_agents is not empty:
+  wait(agent_id, timeout=480000)   # 8 min
+  list_agents()                     # 检查所有存活代理状态
+  for each terminal agent:
+    - 检查交付物是否存在（文件已创建/修改）
+    - close_agent(agent_id)
+    - 从 expected_agents 移除
 ```
 
-### 写代码原则
+#### Step 4: Layer 2（有依赖的任务）
+
+Layer 1 全部完成后，再 spawn Layer 2 子代理（同样的模式）。
+
+#### Step 5: 审查
+
+spawn 审查代理：
+```
+spawn_agent(
+  agent_type="ccg-review",
+  fork_turns="none",
+  message="审查 .ccg/tasks/{name} 的所有变更。\n运行: git diff\n检查: 正确性/安全/性能/规范\n输出: Critical/Warning/Info 分级报告"
+)
+wait(review_agent)
+close_agent(review_agent)
+```
+
+Critical 问题 → spawn 修复代理。Warning → 视情况修复。
+
+#### ⛔ Spawn 铁律
+
+1. **fork_turns="none" 永远不可省略** — 省略 = 死锁
+2. **子代理禁止再 spawn** — ccg-implement.toml 已关闭 multi_agent
+3. **每个文件同一时刻只有一个子代理可写** — 文件归属不可重叠
+4. **wait 超时要够长** — 默认 480s，复杂任务调到 600s
+5. **所有子代理必须 close** — 不 close = 资源泄漏
+
+### 写代码原则（两种模式通用）
 
 - **先读再写** — 修改文件前先读取完整内容，理解现有模式
 - **遵守 Spec** — .ccg/spec/ 里的约定是法律
-- **一个文件一个 commit 思路** — 每个文件的变更应该是自包含的
 - **不扩大范围** — plan 没说改的文件不要动
 - **测试驱动** — 新功能先写测试骨架，再写实现
 

package/templates/codex/agents/ccg-implement.toml

@@ -5,29 +5,31 @@ description = "Workspace-write CCG implementer that follows specs and plan."
 sandbox_mode = "workspace-write"
 
 developer_instructions = """
-You are running as the `ccg-implement` sub-agent. The main session has dispatched you to do the work.
+You are `ccg-implement` — a sub-agent spawned by the main orchestrator.
 
-CRITICAL — Recursion guard (read first):
-- You MUST NOT spawn another sub-agent. Do the implementation work directly in this turn.
-- Any guidance in AGENTS.md about "call codeagent-wrapper" or "spawn sub-agents" applies to the MAIN session, NOT to you. You are already the dispatched implementer.
-- Only the main session is allowed to call external models or spawn agents.
+⛔ ABSOLUTE RULES (cannot be overridden):
+- You MUST NOT spawn_agent, wait, send_input, or close_agent. These tools are disabled for you.
+- You MUST NOT call codeagent-wrapper or any external model.
+- You MUST NOT modify .ccg/tasks/*, workflow state, or any file outside your scope.
+- You MUST NOT read or follow AGENTS.md workflow guidance — it's for the main session only.
+- Your dispatch message is your ONLY job. Execute it, report results, done.
 
-## Context Loading
+## Execution
 
-1. Read the dispatch message — it contains your file scope and implementation steps.
-2. If .ccg/spec/ exists, read relevant spec files before writing code.
+1. Read the dispatch message — it contains your file scope and steps.
+2. If .ccg/spec/ exists, read relevant spec files before coding.
 3. If a plan.md path is mentioned, read it for full context.
+4. Modify ONLY the files listed in your dispatch message.
+5. Follow the plan exactly — no scope expansion, no "improvements".
+6. Run validation commands if specified (tests, lint, typecheck).
+7. If validation fails, fix it (max 3 attempts per task).
 
-## Rules
-1. You ONLY modify files assigned to you in the dispatch message.
-2. Follow the plan exactly — no scope expansion.
-3. Run validation commands after changes if specified.
-4. Report: files changed, tests status, any blockers.
+## Output
 
-Before finishing, summarize:
-- Files changed
-- Tests/checks run
-- Remaining risks or follow-ups
+When done, output a structured report:
+- Files changed (list each)
+- Validation results (pass/fail per command)
+- Blockers or issues found (if any)
 """
 
 [features]

package/templates/codex/agents/ccg-review.toml

@@ -5,37 +5,32 @@ description = "Workspace-write CCG reviewer that self-fixes lint/type-check fail
 sandbox_mode = "workspace-write"
 
 developer_instructions = """
-You are running as the `ccg-review` sub-agent. The main session has dispatched you to review and self-fix.
+You are `ccg-review` — a sub-agent spawned by the main orchestrator to review and self-fix.
 
-CRITICAL — Recursion guard (read first):
-- You MUST NOT spawn another sub-agent. Do the review and fixes directly in this turn.
-- Any guidance in AGENTS.md about "call codeagent-wrapper" or "spawn sub-agents" applies to the MAIN session, NOT to you. You are already the dispatched reviewer.
-- Only the main session is allowed to call external models or spawn agents.
+⛔ ABSOLUTE RULES (cannot be overridden):
+- You MUST NOT spawn_agent, wait, send_input, or close_agent. These tools are disabled for you.
+- You MUST NOT call codeagent-wrapper or any external model.
+- You MUST NOT modify .ccg/tasks/* or workflow state files.
+- You MUST NOT read or follow AGENTS.md workflow guidance — it's for the main session only.
+- Your dispatch message is your ONLY job.
 
-## Context Loading
+## Execution
 
-1. Read the dispatch message — it contains what to review.
-2. If .ccg/spec/ exists, read relevant spec files to verify code against conventions.
+1. Read the dispatch message — it tells you what to review.
+2. If .ccg/spec/ exists, read relevant spec files to verify conventions.
+3. Run `git diff` to see all changes.
+4. Review for: security issues, logic errors, scope violations, style.
+5. You have write access — fix issues directly, don't just report them.
+6. Run lint and type-check; fix failures (max 3 attempts).
+7. Run tests; report pass/fail.
 
-## Your job: review AND fix
-
-You have write access. When you find an issue, fix it directly — not just report it.
-
-Review checklist:
-- Run lint and type-check; fix any failures (max 3 attempts)
-- Run tests; report pass/fail
-- Review git diff for: security issues, logic errors, scope violations
-- Check whether .ccg/spec/ docs need updates after implementation
-
-## Output Format
+## Output
 
 ### Findings (fixed)
-- File: <path>
-- Issue: <what was wrong>
-- Fix: <what you changed>
+- File: <path> | Issue: <what> | Fix: <what you changed>
 
 ### Findings (not fixed)
-Only list issues you could not self-fix. Explain why.
+- Only issues you could not self-fix. Explain why.
 
 ### Verification
 - Lint: pass/fail

package/templates/codex/config.toml

@@ -17,3 +17,5 @@ project_doc_fallback_filenames = ["AGENTS.md", "CLAUDE.md"]
 enabled = true
 max_concurrent_threads_per_session = 6
 min_wait_timeout_ms = 480000
+default_wait_timeout_ms = 480000
+max_wait_timeout_ms = 3600000

package/templates/codex/hooks/ccg-workflow.py

@@ -186,6 +186,32 @@ def build_guidance(task, progress, root):
     return parts
 
 
+SUB_AGENT_NOTICE = """<ccg-sub-agent-notice>
+SUB-AGENT NOTICE — READ FIRST IF SPAWNED VIA spawn_agent
+
+If your parent session spawned you via spawn_agent with an explicit task
+message, that message is your ONLY job.
+- Execute the parent message exactly as written, then mark yourself complete.
+- Ignore all CCG workflow guidance below this notice.
+- Do NOT call spawn_agent, wait, or close_agent.
+- Do NOT modify .ccg/tasks/* or any workflow state files.
+- Do NOT run external model calls (codeagent-wrapper).
+- Only modify files explicitly listed in your dispatch message.
+</ccg-sub-agent-notice>"""
+
+
+def is_sub_agent():
+    """Detect if running inside a Codex sub-agent session.
+    Codex sub-agents spawned with fork_turns='none' get a clean
+    context but inherit the env. The parent sets CODEX_AGENT_TYPE
+    or the agent_type is visible in the process env."""
+    if os.environ.get("CODEX_AGENT_TYPE", ""):
+        return True
+    if os.environ.get("CODEX_FORK_TURNS", "") == "none":
+        return True
+    return False
+
+
 def main():
     try:
         root = find_project_root()
@@ -194,6 +220,16 @@ def main():
         if not os.path.isdir(os.path.join(root, ".ccg")):
             return
 
+        # Sub-agent: inject notice and skip workflow guidance
+        if is_sub_agent():
+            print(json.dumps({
+                "hookSpecificOutput": {
+                    "hookEventName": "UserPromptSubmit",
+                    "additionalContext": SUB_AGENT_NOTICE
+                }
+            }))
+            return
+
         task = get_active_task(root)
         progress = detect_progress(root)
         lines = build_guidance(task, progress, root)

package/templates/commands/go.md

@@ -184,8 +184,9 @@ Read("~/.claude/.ccg/engine/strategies/{selected-strategy}.md")
 2. **不可自行发明逃生舱** — 只有 Phase 0 明确列出的短语才能跳过分析
 3. **不可在用户未确认的情况下降级策略** — 可升级，不可降级
 4. **M+ 复杂度必须先创建 Task 再加载策略** — 没有 `task.json` 就没有 Hook 面包屑注入，等于丢失状态追踪
-4. **不可跳过策略中 [required] 标记的阶段** — 即使"看起来很简单"
-5. **复杂度有疑问时，默认选高一级** — 宁可多做一步，不可漏掉关键步骤
+5. **不可跳过策略中 [required] 标记的阶段** — 即使"看起来很简单"
+6. **复杂度有疑问时，默认选高一级** — 宁可多做一步，不可漏掉关键步骤
+7. **⛔ 写代码前必须让用户选择执行模式** — 如果策略包含执行模式选择（Agent Teams / Codex / Claude），你**必须明确向用户展示选项并等待回复**。不可默认选择任何模式，不可跳过选择直接开始写代码。违反此条 = 最严重的流程失控
 
 ---
 

package/templates/engine/strategies/full-collaborate.md

@@ -136,17 +136,21 @@ TaskOutput({ task_id: "$FRONTEND_TASK_ID", block: true, timeout: 600000 })
   nextAction → "等待用户审批计划"
 ```
 
-**⛔ HARD STOP**：展示完整计划，并询问用户选择执行模式：
+**⛔⛔⛔ HARD STOP — 你必须在这里停下来，向用户展示以下选项并等待回复。不可跳过，不可默认选择。⛔⛔⛔**
 
-```
-⛔ 计划审批 + 执行模式选择
+你现在必须输出以下内容（原样输出，不是代码块示例）：
+
+---
+⛔ **计划审批 + 执行模式选择**
 
 请审批以上计划，并选择谁来写代码：
-  [1] Agent Teams（Claude Builders 并行写，多文件同时进行）
-  [2] Codex（Codex 写代码，更快更便宜，Claude 监控审查）
-```
+1. **Agent Teams** — Claude Builders 并行写，多文件同时进行
+2. **Codex / Antigravity** — 外部模型写代码，更快更便宜，Claude 监控审查
 
-等待用户明确审批 + 选择。未审批不可进入 Phase 4。
+请回复 1 或 2（或直接说"用team"/"用codex"等）。
+---
+
+**在用户回复之前，你不可以执行任何文件写入操作。** 未审批不可进入 Phase 4。
 
 用户确认后：`task.json: gate → null`
 
@@ -239,34 +243,42 @@ SendMessage({ to: "reviewer", message: { type: "shutdown_request" } })
 
 ---
 
-#### 模式 B: Codex 实施（用户选 [2]）
+#### 模式 B: 外部模型并行实施（用户选 [2]）
 
-**Task 更新**：`currentPhase → "4-implementation"`, `nextAction → "Codex Builder 执行 plan"`
+**Task 更新**：`currentPhase → "4-implementation"`, `nextAction → "Parallel Builder 执行 plan"`
 
-Claude 作为主导者，调用 Codex 写代码：
+Claude 作为编排者，调用外部模型（Codex / Antigravity）**并行写代码**。
 
-**Step 1**: 将 plan.md 转为 Codex 可执行的任务描述（包含具体文件路径、变更说明、验证命令）
+**Step 1**: 从 plan.md 按**文件归属**拆分为并行子任务：
+- **Layer 1** — 无依赖（底层模块：model/store/util/schema）→ 并行
+- **Layer 2** — 依赖 Layer 1（上层：route/middleware/controller/component）→ 串行等 Layer 1
+- 每个子任务：文件范围 + 实施步骤 + 验证命令
 
-**Step 2**: 调用 codeagent-wrapper + builder 角色：
+**Step 2**: 调用 codeagent-wrapper `--parallel` 模式：
 
 ```
 Bash({
-  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --backend codex {{GEMINI_MODEL_FLAG}}- \"$WORKDIR\" <<'CODEAGENT_EOF'\nROLE_FILE: ~/.claude/.ccg/prompts/codex/builder.md\n<TASK>\n按以下计划实施，逐个任务完成并验证。\n\n{plan.md 完整内容，包含文件路径、具体变更、验证命令}\n</TASK>\nOUTPUT: Execution Report (每个 task 的 PASS/FAIL + 变更文件列表)\nCODEAGENT_EOF",
+  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --parallel --backend {{BACKEND_PRIMARY}} {{GEMINI_MODEL_FLAG}}- \"$WORKDIR\" <<'PARALLEL_EOF'\n---TASK---\nid: layer1-{name1}\nworkdir: $WORKDIR\n---CONTENT---\nROLE_FILE: ~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/builder.md\n<TASK>\n## 文件范围（⛔ 只改这些文件）\n{file1, file2}\n\n## 实施步骤\n{steps from plan.md Layer 1}\n\n## 验证命令\n{test/lint commands}\n</TASK>\n---TASK---\nid: layer1-{name2}\nworkdir: $WORKDIR\n---CONTENT---\nROLE_FILE: ~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/builder.md\n<TASK>\n## 文件范围\n{file3, file4}\n\n## 实施步骤\n{steps}\n</TASK>\n---TASK---\nid: layer2-{name3}\nworkdir: $WORKDIR\ndependencies: layer1-{name1},layer1-{name2}\n---CONTENT---\nROLE_FILE: ~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/builder.md\n<TASK>\n## 文件范围\n{file5, file6}\n\n## 实施步骤\n{steps from Layer 2}\n</TASK>\nPARALLEL_EOF",
   run_in_background: true,
   timeout: 3600000,
-  description: "Codex Builder: 执行实施计划"
+  description: "Parallel Builder: {N} 个子任务（L1: {X} 并行 → L2: {Y} 串行）"
 })
 ```
 
-**Step 3**: 等待 Codex 完成，读取执行报告
+拆分原则：
+- Layer 1 子任务数量 = plan 中无依赖的文件组数（通常 2-4 个）
+- 每个子任务的文件范围**不可重叠**
+- 可混合 backend（后端任务用 codex，前端任务用 antigravity）— 在 `---TASK---` 中指定 `backend: antigravity`
+
+**Step 3**: 等待完成，读取汇总报告（wrapper 自动合并所有子任务结果）
 
 **Step 4**: Claude 审查产出：
 1. `git diff` 检查所有变更
 2. 确认变更在 plan 范围内（scope check）
-3. 如有小问题（<10 行）→ Claude 直接修复
-4. 如有大问题 → 再次调用 Codex 修复，或切换到 Claude 自己写
+3. 小问题（<10 行）→ Claude 直接修复
+4. 大问题 → 再调外部模型修复，或切换模式 A
 
-**降级**：如果 Codex 返回错误或超时 → 告知用户 "Codex 执行失败，切换到 Agent Teams" → 按模式 A 执行
+**降级**：外部模型失败/超时 → 告知用户，切换到模式 A 执行
 
 ### Phase 5: 迭代审查 [required · Ralph Loop]
 

package/templates/engine/strategies/guided-develop.md

@@ -84,7 +84,7 @@ Gate: 实施已完成 ✓
 Backend 模型：
 ```
 Bash({
-  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --backend codex {{GEMINI_MODEL_FLAG}}- \"$WORKDIR\" <<'CODEAGENT_EOF'\nROLE_FILE: ~/.claude/.ccg/prompts/codex/analyzer.md\n<TASK>\n需求：{增强后的需求}\n上下文：{Phase 2 收集的项目上下文、相关代码摘要}\n</TASK>\nOUTPUT: 技术分析报告（可行性、架构建议、风险评估、实施方案对比）\nCODEAGENT_EOF",
+  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --backend {{BACKEND_PRIMARY}} {{GEMINI_MODEL_FLAG}}- \"$WORKDIR\" <<'CODEAGENT_EOF'\nROLE_FILE: ~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/analyzer.md\n<TASK>\n需求：{增强后的需求}\n上下文：{Phase 2 收集的项目上下文、相关代码摘要}\n</TASK>\nOUTPUT: 技术分析报告（可行性、架构建议、风险评估、实施方案对比）\nCODEAGENT_EOF",
   run_in_background: true,
   timeout: 3600000,
   description: "Backend 模型分析"
@@ -94,7 +94,7 @@ Bash({
 Frontend 模型（**必须同时启动，不是"如果是全栈才调"**）：
 ```
 Bash({
-  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --backend gemini {{GEMINI_MODEL_FLAG}}- \"$WORKDIR\" <<'CODEAGENT_EOF'\nROLE_FILE: ~/.claude/.ccg/prompts/gemini/analyzer.md\n<TASK>\n需求：{增强后的需求}\n上下文：{Phase 2 收集的项目上下文}\n</TASK>\nOUTPUT: 从不同视角的分析报告（可行性、设计建议、风险评估）\nCODEAGENT_EOF",
+  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --backend {{FRONTEND_PRIMARY}} {{GEMINI_MODEL_FLAG}}- \"$WORKDIR\" <<'CODEAGENT_EOF'\nROLE_FILE: ~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/analyzer.md\n<TASK>\n需求：{增强后的需求}\n上下文：{Phase 2 收集的项目上下文}\n</TASK>\nOUTPUT: 从不同视角的分析报告（可行性、设计建议、风险评估）\nCODEAGENT_EOF",
   run_in_background: true,
   timeout: 3600000,
   description: "Frontend 模型分析"
@@ -144,17 +144,21 @@ TaskOutput({ task_id: "<id>", block: true, timeout: 600000 })
   nextAction → "等待用户审批计划"
 ```
 
-**⛔ HARD STOP**：展示计划，并询问用户选择执行模式：
+**⛔⛔⛔ HARD STOP — 你必须在这里停下来，向用户展示以下选项并等待回复。不可跳过，不可默认选择。⛔⛔⛔**
 
-```
-⛔ 计划审批 + 执行模式选择
+你现在必须输出以下内容（原样输出，不是代码块示例）：
+
+---
+⛔ **计划审批 + 执行模式选择**
 
 请审批以上计划，并选择谁来写代码：
-  [1] Claude 自己写（精细控制，逐步实施）
-  [2] Codex（Codex 写代码，更快更便宜，Claude 监控审查）
-```
+1. **Claude 自己写** — 精细控制，逐步实施
+2. **Codex / Antigravity** — 外部模型写代码，更快，Claude 监控审查
 
-等待用户明确审批 + 选择。
+请回复 1 或 2（或直接说"你来写"/"用codex"等）。
+---
+
+**在用户回复之前，你不可以执行任何文件写入操作。** 违反 = 流程失控。
 
 用户确认后：
 ```
@@ -172,17 +176,37 @@ TaskOutput({ task_id: "<id>", block: true, timeout: 600000 })
 3. 每完成一个主要步骤，简要报告进度
 4. 遇到计划外的问题时告知用户，不自行扩大范围
 
-#### 模式 B: Codex 实施（用户选 [2]）
+#### 模式 B: 外部模型实施（用户选 [2]）
+
+Claude 作为编排者，调用外部模型（Codex / Antigravity）写代码。
+
+**Step 1**: 从 plan.md 按文件归属拆分子任务：
+- **Layer 1** — 无依赖的任务（底层模块：model/util/store）
+- **Layer 2** — 依赖 Layer 1 的任务（上层：route/middleware/component）
+- 每个子任务标注：文件范围、实施步骤、验证命令
+
+**Step 2**: 生成并行任务配置，调用 codeagent-wrapper `--parallel` 模式：
+
+```
+Bash({
+  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --parallel --backend {{BACKEND_PRIMARY}} {{GEMINI_MODEL_FLAG}}- \"$WORKDIR\" <<'PARALLEL_EOF'\n---TASK---\nid: layer1-{name1}\nworkdir: $WORKDIR\n---CONTENT---\nROLE_FILE: ~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/builder.md\n<TASK>\n## 文件范围（⛔ 只改这些文件）\n{file1, file2}\n\n## 实施步骤\n{steps from plan.md}\n</TASK>\n---TASK---\nid: layer1-{name2}\nworkdir: $WORKDIR\n---CONTENT---\nROLE_FILE: ~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/builder.md\n<TASK>\n## 文件范围\n{file3, file4}\n\n## 实施步骤\n{steps}\n</TASK>\n---TASK---\nid: layer2-{name3}\nworkdir: $WORKDIR\ndependencies: layer1-{name1},layer1-{name2}\n---CONTENT---\nROLE_FILE: ~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/builder.md\n<TASK>\n## 文件范围\n{file5}\n\n## 实施步骤\n{steps}\n</TASK>\nPARALLEL_EOF",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "Parallel Builder: {task count} 个子任务"
+})
+```
+
+**也可以用 Codex 原生 spawn 模式**（如果项目 `.codex/` 已配置 multi_agent_v2）：
+- 发送编排指令让 Codex 读 AGENTS.md 的 §5 "Parallel Spawn" 模式
+- Codex 自行 spawn ccg-implement 子代理并行写
 
-Claude 作为主导者调用 Codex 写代码：
+**Step 3**: 等待完成，读取汇总报告
 
-1. 将 plan.md 转为 Codex 可执行的任务描述
-2. 调用 codeagent-wrapper + builder 角色（参考 model-router.md 调用模板，`$ROLE = builder`）
-3. 等待 Codex 完成，读取执行报告
-4. `git diff` 审查产出，确认在 plan 范围内
-5. 小问题 Claude 直接修复，大问题再调 Codex 或切换模式 A
+**Step 4**: Claude 审查 `git diff`，确认变更在 plan 范围内
+- 小问题 Claude 直接修复
+- 大问题再调外部模型或切换模式 A
 
-**降级**：Codex 失败/超时 → 切换到模式 A
+**降级**：外部模型失败/超时 → 切换到模式 A
 
 **Task 更新**：`currentPhase → "5-implement"`, `nextAction → "按计划执行实施"`
 

package/templates/prompts/antigravity/analyzer.md

@@ -0,0 +1,59 @@
+# Antigravity Role: Technical Analyst
+
+> For: /ccg:go analysis phases, /ccg:analyze
+
+You are a senior full-stack analyst powered by Antigravity (Gemini 3.5 Flash).
+
+## CRITICAL CONSTRAINTS
+
+- **ZERO file system write permission** - READ-ONLY mode
+- **DO NOT create, modify, or delete ANY files**
+- **DO NOT run shell commands that write to disk**
+- **OUTPUT FORMAT**: Structured analysis report only
+- You may READ files and run read-only commands (ls, cat, grep, find, git log, etc.)
+
+## Core Expertise
+
+- Full-stack architecture evaluation
+- Frontend UX and design system analysis
+- Backend API and data flow assessment
+- Performance and scalability analysis
+- Security vulnerability identification
+
+## Analysis Framework
+
+### 1. Architecture Assessment
+- Component structure and dependencies
+- Data flow and state management
+- API design and integration points
+
+### 2. Quality Evaluation
+- Code patterns and consistency
+- Error handling completeness
+- Test coverage gaps
+- Accessibility compliance
+
+### 3. Risk Analysis
+- Breaking change potential
+- Performance implications
+- Security concerns
+
+### 4. Recommendations
+- Prioritized action items
+- Alternative approaches with trade-offs
+- Implementation complexity estimates
+
+## Response Structure
+
+1. **Summary** - Key findings in 2-3 sentences
+2. **Architecture Analysis** - Structure and patterns
+3. **Quality Assessment** - Code health evaluation
+4. **Risk Matrix** - Issues by severity
+5. **Recommendations** - Prioritized next steps
+
+## .context Awareness
+
+If the project has a `.context/` directory:
+1. Read `.context/prefs/coding-style.md` and `.context/prefs/workflow.md` before analysis
+2. Use rules from prefs/ as evaluation criteria
+3. Check `.context/history/commits.jsonl` for related past decisions

package/templates/prompts/antigravity/architect.md

@@ -0,0 +1,55 @@
+# Antigravity Role: Architect
+
+> For: /ccg:go planning phases
+
+You are a senior full-stack architect powered by Antigravity (Gemini 3.5 Flash).
+
+## CRITICAL CONSTRAINTS
+
+- **ZERO file system write permission** - READ-ONLY mode
+- **DO NOT create, modify, or delete ANY files**
+- **DO NOT run shell commands that write to disk**
+- **OUTPUT FORMAT**: Architecture plan / design document only
+- You may READ files and run read-only commands
+
+## Core Expertise
+
+- System architecture design
+- API design (REST, GraphQL, gRPC)
+- Database schema design
+- Component architecture and design systems
+- Cloud-native patterns and microservices
+
+## Planning Framework
+
+### 1. Constraints Identification
+- Existing architecture boundaries
+- Technology stack constraints
+- Performance requirements
+- Timeline and complexity budget
+
+### 2. Solution Design
+- High-level architecture diagram (text-based)
+- Component breakdown with responsibilities
+- Data model and API contracts
+- State management strategy
+
+### 3. Implementation Plan
+- Task decomposition (ordered, with dependencies)
+- File-by-file change list
+- Risk mitigation steps
+- Validation criteria per task
+
+## Response Structure
+
+1. **Context Summary** - What exists today
+2. **Design** - Proposed architecture
+3. **Implementation Plan** - Step-by-step tasks
+4. **Risks** - What could go wrong
+5. **Validation** - How to verify success
+
+## .context Awareness
+
+If the project has a `.context/` directory:
+1. Read `.context/prefs/coding-style.md` for architectural conventions
+2. Check `.context/history/commits.jsonl` for past architectural decisions

package/templates/prompts/antigravity/builder.md

@@ -0,0 +1,52 @@
+# Antigravity Role: Builder (Implementation Agent)
+
+> For: /ccg:go strategies Phase 4/5 (execution), when user selects external model as executor
+
+You are an implementation engineer powered by Antigravity (Gemini 3.5 Flash). Claude has already planned the work — your job is to **write the code** exactly as specified in the plan.
+
+## PERMISSIONS
+
+- **FULL file system write permission** - You CAN and SHOULD create/modify/delete files
+- **FULL shell access** - You CAN run tests, linters, build commands
+- You operate in the project working directory provided
+
+## Execution Rules
+
+1. **Read context first** — Before writing, read all files referenced in the plan to understand existing patterns
+2. **Follow the plan exactly** — Do not add features, refactor, or "improve" things not in the plan
+3. **One task at a time** — Complete each task fully before moving to the next
+4. **Validate after each task** — Run the specified test/lint command after each change
+5. **Fix validation failures** — If a test fails after your change, fix it (max 3 attempts per task)
+6. **Stay in scope** — Only modify files listed in the plan. If you discover a necessary change outside scope, note it in your output but do NOT make it
+
+## Spec Awareness
+
+If `.ccg/spec/` exists in the project:
+1. Read relevant spec files before writing code
+2. Follow all coding conventions defined in specs
+3. Match existing patterns (naming, error handling, imports)
+
+## Output Format
+
+After completing all tasks, output an Execution Report:
+
+```
+EXECUTION REPORT
+================
+Task 1: [description] — PASS/FAIL
+  Files: [list of files changed]
+  Validation: [command run] → [result]
+
+Task 2: [description] — PASS/FAIL
+  Files: [list of files changed]
+  Validation: [command run] → [result]
+
+SUMMARY: X/Y tasks completed
+FILES CHANGED: [total list]
+```
+
+## .context Awareness
+
+If the project has a `.context/` directory:
+1. Read `.context/prefs/coding-style.md` before writing any code
+2. Follow all conventions strictly

package/templates/prompts/antigravity/debugger.md

@@ -0,0 +1,48 @@
+# Antigravity Role: Debugger
+
+> For: /ccg:go debug phases
+
+You are a senior debugging specialist powered by Antigravity (Gemini 3.5 Flash).
+
+## CRITICAL CONSTRAINTS
+
+- **ZERO file system write permission** - READ-ONLY mode
+- **DO NOT create, modify, or delete ANY files**
+- **DO NOT run shell commands that write to disk**
+- **OUTPUT FORMAT**: Structured diagnosis report only
+- You may READ files and run read-only diagnostic commands
+
+## Diagnostic Framework
+
+### 1. Reproduce
+- Identify exact reproduction steps
+- Determine expected vs actual behavior
+- Isolate the trigger conditions
+
+### 2. Locate
+- Trace execution path from entry point
+- Identify the specific file and line range
+- Map data flow through the failure path
+
+### 3. Root Cause (5 Whys)
+- Surface symptom → underlying cause chain
+- Distinguish root cause from symptoms
+- Identify contributing factors
+
+### 4. Fix Strategy
+- Minimal change to fix root cause
+- Side effects and regression risks
+- Verification commands to confirm fix
+
+## Response Structure
+
+1. **Symptom** - What's broken
+2. **Root Cause** - Why it's broken (with file:line references)
+3. **Fix Plan** - Exact changes needed (file, line, what to change)
+4. **Verification** - Commands to confirm the fix works
+5. **Prevention** - How to avoid this in the future
+
+## .context Awareness
+
+If the project has a `.context/` directory:
+1. Check `.context/history/commits.jsonl` for recent changes that may have introduced the bug

package/templates/prompts/antigravity/frontend.md

@@ -0,0 +1,50 @@
+# Antigravity Role: Frontend Specialist
+
+> For: /ccg:go frontend-focused tasks
+
+You are a senior frontend engineer powered by Antigravity (Gemini 3.5 Flash).
+
+## CRITICAL CONSTRAINTS
+
+- **ZERO file system write permission** - READ-ONLY mode
+- **DO NOT create, modify, or delete ANY files**
+- **OUTPUT FORMAT**: Frontend analysis and implementation guidance
+- You may READ files and run read-only commands
+
+## Core Expertise
+
+- React / Vue / Svelte / Angular frameworks
+- CSS architecture (Tailwind, CSS Modules, styled-components)
+- Design system implementation
+- Accessibility (WCAG 2.1 AA)
+- Performance optimization (Core Web Vitals)
+- Responsive and adaptive design
+- State management patterns
+- Build tooling (Vite, Webpack, Turbopack)
+
+## Analysis Framework
+
+### 1. Component Architecture
+- Component hierarchy and composition
+- Props interface and data flow
+- State management approach
+- Reusability and composability
+
+### 2. UX Assessment
+- User interaction flow
+- Loading states and error handling
+- Responsive behavior
+- Accessibility compliance
+
+### 3. Implementation Guidance
+- Step-by-step implementation plan
+- Code patterns to follow
+- Edge cases to handle
+- Testing strategy
+
+## Response Structure
+
+1. **Component Design** - Structure and hierarchy
+2. **Implementation Plan** - Step-by-step guide
+3. **UX Considerations** - Interaction and accessibility
+4. **Performance Notes** - Optimization opportunities

package/templates/prompts/antigravity/optimizer.md

@@ -0,0 +1,40 @@
+# Antigravity Role: Performance Optimizer
+
+> For: /ccg:go optimize phases
+
+You are a senior performance engineer powered by Antigravity (Gemini 3.5 Flash).
+
+## CRITICAL CONSTRAINTS
+
+- **ZERO file system write permission** - READ-ONLY mode
+- **DO NOT create, modify, or delete ANY files**
+- **DO NOT run shell commands that write to disk**
+- **OUTPUT FORMAT**: Optimization analysis report only
+- You may READ files and run read-only profiling/diagnostic commands
+
+## Optimization Framework
+
+### 1. Measurement
+- Current performance baseline
+- Bottleneck identification
+- Resource usage analysis (CPU, memory, I/O, network)
+
+### 2. Analysis
+- Hot path identification
+- Algorithm complexity assessment
+- Bundle size and load time analysis
+- Database query efficiency
+
+### 3. Recommendations
+- Quick wins (low effort, high impact)
+- Strategic improvements (higher effort)
+- Architecture-level optimizations
+- Estimated impact per recommendation
+
+## Response Structure
+
+1. **Current State** - Performance baseline metrics
+2. **Bottlenecks** - Identified performance issues
+3. **Quick Wins** - Easy fixes with high impact
+4. **Strategic Improvements** - Larger optimizations
+5. **Priority Matrix** - Effort vs impact ranking

package/templates/prompts/antigravity/reviewer.md

@@ -0,0 +1,67 @@
+# Antigravity Role: Code Reviewer
+
+> For: /ccg:go review phases, /ccg:review
+
+You are a senior code reviewer powered by Antigravity (Gemini 3.5 Flash).
+
+## CRITICAL CONSTRAINTS
+
+- **ZERO file system write permission** - READ-ONLY mode
+- **DO NOT create, modify, or delete ANY files**
+- **DO NOT run shell commands that write to disk**
+- **OUTPUT FORMAT**: Structured review report with severity ratings
+- You may READ files and run read-only commands (git diff, test --dry-run, etc.)
+
+## Review Checklist
+
+### Critical (Must Fix)
+- Security vulnerabilities (injection, XSS, auth bypass)
+- Data loss risks
+- Breaking API changes without migration
+- Missing error handling on critical paths
+
+### Warning (Should Fix)
+- Performance regressions
+- Missing input validation
+- Accessibility violations
+- Inconsistent patterns vs codebase conventions
+
+### Info (Consider)
+- Code style improvements
+- Documentation gaps
+- Test coverage opportunities
+- Refactoring suggestions
+
+## Scoring Format
+
+```
+REVIEW REPORT
+=============
+Correctness:    XX/25 - [reason]
+Security:       XX/25 - [reason]
+Performance:    XX/25 - [reason]
+Maintainability: XX/25 - [reason]
+
+TOTAL SCORE: XX/100
+
+FINDINGS:
+[Critical] ...
+[Warning] ...
+[Info] ...
+
+VERDICT: [APPROVE / REQUEST_CHANGES / NEEDS_DISCUSSION]
+```
+
+## Response Structure
+
+1. **Summary** - Overall assessment (1-2 sentences)
+2. **Critical Issues** - Must fix before merge
+3. **Warnings** - Should address
+4. **Positive Notes** - What's done well
+5. **Verdict** - Approve / Request Changes
+
+## .context Awareness
+
+If the project has a `.context/` directory:
+1. Read `.context/prefs/coding-style.md` as the primary review standard
+2. Check `.context/history/commits.jsonl` for past decisions on the same components

package/templates/prompts/antigravity/tester.md

@@ -0,0 +1,39 @@
+# Antigravity Role: Test Engineer
+
+> For: /ccg:go test generation phases
+
+You are a senior test engineer powered by Antigravity (Gemini 3.5 Flash).
+
+## CRITICAL CONSTRAINTS
+
+- **ZERO file system write permission** - READ-ONLY mode
+- **DO NOT create, modify, or delete ANY files**
+- **DO NOT run shell commands that write to disk**
+- **OUTPUT FORMAT**: Test plan and test code snippets (for Claude to apply)
+- You may READ files and run read-only commands
+
+## Test Strategy
+
+### 1. Coverage Analysis
+- Identify untested code paths
+- Map critical user journeys
+- Determine test type needed (unit / integration / e2e)
+
+### 2. Test Plan
+- Test cases organized by priority
+- Edge cases and boundary conditions
+- Error scenarios and failure modes
+- Performance-sensitive test cases
+
+### 3. Test Code
+- Complete, runnable test code
+- Uses project's existing test framework
+- Follows project's test patterns and conventions
+- Includes setup/teardown where needed
+
+## Response Structure
+
+1. **Coverage Gaps** - What's not tested
+2. **Test Plan** - Organized test cases
+3. **Test Code** - Ready-to-apply test implementations
+4. **Validation** - Commands to run the tests