@uzysjung/agent-harness 26.160.0 → 26.161.0

package/dist/index.js

@@ -4,6 +4,7 @@ import {
   CATEGORIES,
   CATEGORY_TITLES,
   CLI_BASES,
+  CLI_BASE_SORT_ORDER,
   CONTINUOUS_SKILLS,
   CONTINUOUS_SKILLS_HEADING,
   DEFAULT_OPTIONS,
@@ -11,6 +12,7 @@ import {
   HARNESS_ANCHOR_FILE,
   HARNESS_IMPORT_LINE,
   INSTALL_LOG_DIR,
+  INSTALL_LOG_FILENAME,
   INTERNAL_BUNDLED_SKILL_IDS,
   POLICY_DIRS,
   RENAMED_SKILL_IDS,
@@ -47,6 +49,7 @@ import {
   hashContent,
   init_esm_shims,
   installLogPath,
+  installedClis,
   isAssetSelected,
   isCliBase,
   isCliNeutralTarget,
@@ -57,6 +60,7 @@ import {
   legacyInstallLogPath,
   listFilesRecursive,
   mergeExternalFiles,
+  parseCliTargets,
   readInstallLog,
   renderContinuousSkillsNote,
   renderFillScaffold,
@@ -64,12 +68,14 @@ import {
   resolveBundleRoot,
   resolveRules,
   resolveScope,
+  scaffoldBanner,
   stripHarnessImport,
   summarizeContextCost,
+  targetsInclude,
   upsertHarnessImport,
   withContinuousSkillsNote,
   writeInstallLog
-} from "./chunk-ZXWOY5VO.js";
+} from "./chunk-MBRLCU5O.js";
 
 // node_modules/sisteransi/src/index.js
 var require_src = __commonJS({
@@ -754,7 +760,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "@uzysjung/agent-harness",
-  version: "26.160.0",
+  version: "26.161.0",
   description: "Curate vetted AI-coding skills & plugins by your tech stack \u2014 install only what you need, across Claude Code, Codex, OpenCode & Antigravity",
   type: "module",
   publishConfig: {
@@ -799,10 +805,10 @@ var package_default = {
   devDependencies: {
     "@biomejs/biome": "^2.4.13",
     "@types/node": "^25.6.0",
-    "@vitest/coverage-v8": "^4.1.10",
+    "@vitest/coverage-v8": "^4.1.11",
     tsup: "^8.3.0",
     typescript: "^5.6.0",
-    vitest: "^4.1.10"
+    vitest: "^4.1.11"
   },
   license: "MIT",
   repository: {
@@ -894,55 +900,6 @@ function withBaselineHints(targets, templatesDir) {
   });
 }
 
-// src/cli-targets.ts
-init_esm_shims();
-var CLI_BASE_SORT_ORDER = {
-  claude: 0,
-  codex: 1,
-  opencode: 2,
-  antigravity: 3
-};
-function parseCliTargets(input) {
-  const items = normalizeInput(input);
-  if (items.length === 0) {
-    return { ok: true, targets: ["claude"], warnings: [] };
-  }
-  const collected = /* @__PURE__ */ new Set();
-  const warnings = [];
-  for (const item of items) {
-    if (!isCliBase(item)) {
-      let hint = "";
-      if (item === "both") {
-        hint = "\n         v0.8.0 removed 'both' alias. Use --cli claude --cli codex.";
-      } else if (item === "all") {
-        hint = "\n         v0.8.0 removed 'all' alias. Use --cli claude --cli codex --cli opencode.";
-      } else if (item.includes(",")) {
-        hint = "\n         Tip: comma-separated not supported. Use --cli A --cli B for multiple.";
-      }
-      return {
-        ok: false,
-        targets: ["claude"],
-        warnings,
-        error: `Invalid --cli value: ${item}. Must be one of: ${CLI_BASES.join(" | ")}${hint}`
-      };
-    }
-    collected.add(item);
-  }
-  const targets = [...collected].sort((a, b2) => CLI_BASE_SORT_ORDER[a] - CLI_BASE_SORT_ORDER[b2]);
-  return { ok: true, targets, warnings };
-}
-function normalizeInput(input) {
-  if (input === void 0 || input === null) return [];
-  if (typeof input === "string") {
-    const trimmed = input.trim();
-    return trimmed === "" ? [] : [trimmed];
-  }
-  return input.filter((s) => typeof s === "string" && s.trim() !== "").map((s) => s.trim());
-}
-function targetsInclude(targets, base) {
-  return targets.includes(base);
-}
-
 // src/design.ts
 init_esm_shims();
 var isColorEnabled = (() => {
@@ -1030,62 +987,18 @@ function padDisplay(s, width) {
 init_esm_shims();
 import {
   chmodSync as chmodSync3,
-  existsSync as existsSync14,
+  existsSync as existsSync15,
   mkdirSync as mkdirSync4,
   readdirSync as readdirSync4,
-  readFileSync as readFileSync13,
+  readFileSync as readFileSync14,
   writeFileSync as writeFileSync6
 } from "fs";
-import { basename as basename5, dirname as dirname4, join as join13, resolve } from "path";
+import { basename as basename5, dirname as dirname4, join as join16, resolve } from "path";
 
-// src/ci-scaffold.ts
+// src/anchor-seed.ts
 init_esm_shims();
-import { existsSync as existsSync2 } from "fs";
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
 import { join as join2 } from "path";
-var PYTHON_TRACKS = "data|csr-fastapi|full";
-var VARIANTS = [
-  {
-    source: "ci-node.yml",
-    target: "ci.yml",
-    applies: (tracks) => anyTrack(tracks, "csr-*|ssr-*|tooling|full") || !anyTrack(tracks, PYTHON_TRACKS)
-  },
-  {
-    source: "ci-python.yml",
-    target: "ci-python.yml",
-    applies: (tracks) => anyTrack(tracks, PYTHON_TRACKS)
-  },
-  {
-    source: "e2e.yml",
-    target: "e2e.yml",
-    applies: (tracks) => hasUiTrack(tracks)
-  }
-];
-function installCiScaffold(ctx) {
-  const report = { written: [], skippedExisting: [] };
-  for (const v2 of VARIANTS) {
-    if (!v2.applies(ctx.tracks)) continue;
-    const relTarget = `.github/workflows/${v2.target}`;
-    const target = join2(ctx.projectDir, relTarget);
-    if (existsSync2(target)) {
-      report.skippedExisting.push(relTarget);
-      continue;
-    }
-    copyFile(join2(ctx.harnessRoot, "templates/github-workflows", v2.source), target);
-    report.written.push(relTarget);
-  }
-  return report;
-}
-
-// src/cli-transforms.ts
-init_esm_shims();
-
-// src/antigravity/transform.ts
-init_esm_shims();
-import { existsSync as existsSync6, readFileSync as readFileSync5 } from "fs";
-import { basename, join as join6 } from "path";
-
-// src/codex/agents-md.ts
-init_esm_shims();
 
 // src/agents-md-merge.ts
 init_esm_shims();
@@ -1210,8 +1123,200 @@ function mergeAgentsMd(params) {
   }
   return bodies.size === 0 ? rendered : assemble(rendered, names, bodies);
 }
+function installerLines(body, m) {
+  if (body === null) return [];
+  const at2 = blockRange(body, m);
+  return at2 === null ? [...body] : [...body.slice(0, at2[0]), ...body.slice(at2[1] + 1)];
+}
+function compact(lines) {
+  return lines.map((l) => l.replace(/\r$/, "").trimEnd()).filter((l) => l.trim() !== "");
+}
+function trimBlankEdges(lines) {
+  const out = trimTrailingBlanks(lines);
+  while (out.length > 0 && (out[0] ?? "").trim() === "") out.shift();
+  return out;
+}
+function projectContextInstallerLines(params) {
+  const { existing, template } = params;
+  const body = sectionBody(existing, sectionNames(template), CONTEXT_SECTION);
+  return body === null ? null : installerLines(body, SKILLS_BLOCK);
+}
+function stripHarnessFromAgentsMd(params) {
+  const { existing, template } = params;
+  const lines = existing.split("\n");
+  if (blockRange(lines, ANCHOR_BLOCK) === null && blockRange(lines, SKILLS_BLOCK) === null) {
+    return null;
+  }
+  const names = sectionNames(template);
+  const context = installerLines(sectionBody(existing, names, CONTEXT_SECTION), SKILLS_BLOCK);
+  const rules = installerLines(sectionBody(existing, names, RULES_SECTION), ANCHOR_BLOCK);
+  const scaffold = compact(renderFillScaffold("agents-md").split("\n"));
+  const contextFilled = compact(context).join("\n") !== scaffold.join("\n");
+  const rulesFilled = compact(rules).length > 0;
+  if (!contextFilled && !rulesFilled) return null;
+  const out = [];
+  const title = (lines[0] ?? "").replace(/\r$/, "");
+  if (/^# /.test(title)) out.push(title, "");
+  out.push(`## ${CONTEXT_SECTION}`, "", ...trimBlankEdges(context), "");
+  if (rulesFilled) out.push(`## ${RULES_SECTION}`, "", ...trimBlankEdges(rules), "");
+  return out.join("\n");
+}
+
+// src/anchor-seed.ts
+var SCAFFOLD_MARK = "SCAFFOLD \u2014 not filled in yet";
+var TRACK_NOTE_MARK = "Active track(s):";
+function readIfExists(path) {
+  if (!existsSync2(path)) return null;
+  try {
+    return readFileSync2(path, "utf8");
+  } catch {
+    return null;
+  }
+}
+function dropHarnessQuoteBlocks(lines) {
+  const out = [];
+  let i = 0;
+  while (i < lines.length) {
+    if (!(lines[i] ?? "").trim().startsWith(">")) {
+      out.push(lines[i] ?? "");
+      i += 1;
+      continue;
+    }
+    let end = i;
+    while (end < lines.length && (lines[end] ?? "").trim().startsWith(">")) end++;
+    const run = lines.slice(i, end);
+    const text = run.join("\n");
+    if (!text.includes(SCAFFOLD_MARK) && !text.includes(TRACK_NOTE_MARK)) out.push(...run);
+    i = end;
+  }
+  return out;
+}
+function dropTitle(lines) {
+  const out = [...lines];
+  while (out.length > 0 && (out[0] ?? "").trim() === "") out.shift();
+  if (out.length > 0 && /^#\s/.test(out[0] ?? "")) out.shift();
+  return out;
+}
+function compact2(lines) {
+  return lines.map((l) => l.replace(/\r$/, "").trimEnd()).filter((l) => l.trim() !== "");
+}
+function isPristineScaffold(body, surface) {
+  const pristine = compact2(dropHarnessQuoteBlocks(renderFillScaffold(surface).split("\n")));
+  return compact2(body).join("\n") === pristine.join("\n");
+}
+function compose(body, into) {
+  const trimmed = [...body];
+  while (trimmed.length > 0 && (trimmed.at(-1) ?? "").trim() === "") trimmed.pop();
+  while (trimmed.length > 0 && (trimmed[0] ?? "").trim() === "") trimmed.shift();
+  if (trimmed.length === 0) return null;
+  return `${scaffoldBanner(into)}
+
+${trimmed.join("\n")}`;
+}
+function seedAgentsMdProjectContext(projectDir) {
+  const root = readIfExists(join2(projectDir, "CLAUDE.md"));
+  if (root === null) return null;
+  const withoutImport = stripHarnessImport(root) ?? root;
+  const body = dropHarnessQuoteBlocks(dropTitle(withoutImport.split("\n")));
+  if (isPristineScaffold(body, "claude")) return null;
+  return compose(body, "agents-md");
+}
+function seedRootClaudeProjectContext(projectDir, harnessRoot) {
+  const agents = readIfExists(join2(projectDir, "AGENTS.md"));
+  if (agents === null) return null;
+  const template = readIfExists(join2(harnessRoot, "templates/codex/AGENTS.md.template")) ?? readIfExists(join2(harnessRoot, "templates/opencode/AGENTS.md.template"));
+  if (template === null) return null;
+  const installer = projectContextInstallerLines({ existing: agents, template });
+  if (installer === null) return null;
+  const body = dropHarnessQuoteBlocks(installer);
+  if (isPristineScaffold(body, "agents-md")) return null;
+  return compose(body, "claude");
+}
+
+// src/ci-scaffold.ts
+init_esm_shims();
+import { existsSync as existsSync3 } from "fs";
+import { join as join3 } from "path";
+var PYTHON_TRACKS = "data|csr-fastapi|full";
+var VARIANTS = [
+  {
+    source: "ci-node.yml",
+    target: "ci.yml",
+    applies: (tracks) => anyTrack(tracks, "csr-*|ssr-*|tooling|full") || !anyTrack(tracks, PYTHON_TRACKS)
+  },
+  {
+    source: "ci-python.yml",
+    target: "ci-python.yml",
+    applies: (tracks) => anyTrack(tracks, PYTHON_TRACKS)
+  },
+  {
+    source: "e2e.yml",
+    target: "e2e.yml",
+    applies: (tracks) => hasUiTrack(tracks)
+  }
+];
+function installCiScaffold(ctx) {
+  const report = { written: [], skippedExisting: [] };
+  for (const v2 of VARIANTS) {
+    if (!v2.applies(ctx.tracks)) continue;
+    const relTarget = `.github/workflows/${v2.target}`;
+    const target = join3(ctx.projectDir, relTarget);
+    if (existsSync3(target)) {
+      report.skippedExisting.push(relTarget);
+      continue;
+    }
+    copyFile(join3(ctx.harnessRoot, "templates/github-workflows", v2.source), target);
+    report.written.push(relTarget);
+  }
+  return report;
+}
+
+// src/cli-transforms.ts
+init_esm_shims();
+
+// src/antigravity/transform.ts
+init_esm_shims();
+import { existsSync as existsSync7, readFileSync as readFileSync6 } from "fs";
+import { basename, join as join8 } from "path";
+
+// src/agents-skill-targets.ts
+init_esm_shims();
+import { join as join4, sep } from "path";
+function bundledSkillTargets(projectDir) {
+  const log = readInstallLog(projectDir);
+  if (log === null) return [];
+  const tracks = log.spec.tracks.filter(
+    (t) => TRACKS.includes(t)
+  );
+  if (tracks.length === 0) return [];
+  const skillExcluded = new Set(log.spec.skillExclude ?? []);
+  const baselineExcluded = new Set(log.spec.baselineExclude ?? []);
+  return buildAssetSpec({ tracks, options: DEFAULT_OPTIONS }).selectedInternalSkills.filter(
+    (id) => !skillExcluded.has(id) && !isBaselineExcluded(`.claude/skills/${id}`, baselineExcluded)
+  );
+}
+function allowSkillCreation(writer, projectDir, ids) {
+  if (ids.length === 0) return writer;
+  const roots = ids.map((id) => `${join4(projectDir, ".agents", "skills", id)}${sep}`);
+  return {
+    write(absPath, content, opts) {
+      const inTarget = roots.some((root) => absPath.startsWith(root));
+      return writer.write(absPath, content, inTarget ? { ...opts, createInRefresh: true } : opts);
+    },
+    result: () => writer.result()
+  };
+}
+function agentsSkillSlot(params) {
+  const { projectDir, selectedInternalSkills, refreshOnly, writer } = params;
+  const creatable = refreshOnly ? bundledSkillTargets(projectDir) : [];
+  return {
+    skillIds: creatable.length === 0 ? selectedInternalSkills : [.../* @__PURE__ */ new Set([...selectedInternalSkills, ...creatable])],
+    skillWriter: allowSkillCreation(writer, projectDir, creatable)
+  };
+}
 
 // src/codex/agents-md.ts
+init_esm_shims();
 function renameSlashes(text) {
   return text.replaceAll("/uzys:", "/uzys-");
 }
@@ -1223,8 +1328,8 @@ function renderAgentsMd(params) {
 
 // src/codex/skills.ts
 init_esm_shims();
-import { chmodSync, existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
-import { join as join3 } from "path";
+import { chmodSync, existsSync as existsSync4, readFileSync as readFileSync3 } from "fs";
+import { join as join5 } from "path";
 function renderBundledSkill(source) {
   const trimmed = source.trimEnd();
   const lines = trimmed.split(/\r?\n/);
@@ -1256,14 +1361,14 @@ function writeBundledSkillDirs(params) {
   const { harnessRoot, projectDir, skillIds, writer } = params;
   const written = [];
   for (const id of skillIds) {
-    const srcDir = join3(harnessRoot, "templates/skills", id);
-    const srcSkill = join3(srcDir, "SKILL.md");
-    if (!existsSync3(srcSkill)) {
+    const srcDir = join5(harnessRoot, "templates/skills", id);
+    const srcSkill = join5(srcDir, "SKILL.md");
+    if (!existsSync4(srcSkill)) {
       continue;
     }
-    const targetDir = join3(projectDir, ".agents", "skills", id);
-    const targetSkill = join3(targetDir, "SKILL.md");
-    if (!writer.write(targetSkill, renderBundledSkill(readFileSync2(srcSkill, "utf8")))) {
+    const targetDir = join5(projectDir, ".agents", "skills", id);
+    const targetSkill = join5(targetDir, "SKILL.md");
+    if (!writer.write(targetSkill, renderBundledSkill(readFileSync3(srcSkill, "utf8")))) {
       continue;
     }
     written.push(targetSkill);
@@ -1271,10 +1376,10 @@ function writeBundledSkillDirs(params) {
       if (rel === "SKILL.md") continue;
       if (rel.split("/").some((segment) => segment.startsWith("."))) continue;
       const segments = rel.split("/");
-      const raw = readFileSync2(join3(srcDir, ...segments), "utf8");
+      const raw = readFileSync3(join5(srcDir, ...segments), "utf8");
       const ported = rel.endsWith(".md") || rel.endsWith(".sh") ? `${portBody(raw)}
 ` : raw;
-      const target = join3(targetDir, ...segments);
+      const target = join5(targetDir, ...segments);
       if (!writer.write(target, ported, { createInRefresh: true })) continue;
       if (rel.endsWith(".sh")) chmodSync(target, 493);
       written.push(target);
@@ -1285,30 +1390,40 @@ function writeBundledSkillDirs(params) {
 
 // src/owned-write.ts
 init_esm_shims();
-import { existsSync as existsSync4, mkdirSync, readFileSync as readFileSync3, writeFileSync } from "fs";
-import { dirname, relative, sep } from "path";
+import { existsSync as existsSync5, mkdirSync, readFileSync as readFileSync4, writeFileSync } from "fs";
+import { dirname, relative, sep as sep2 } from "path";
 
 // src/foreign-slot.ts
 init_esm_shims();
-import { lstatSync } from "fs";
-import { join as join4 } from "path";
+import { lstatSync, realpathSync, statSync } from "fs";
+import { join as join6 } from "path";
 var SKILL_SLOT = /^((?:\.claude|\.agents)\/skills\/[^/]+)(?:\/|$)/;
 function occupiedByNonDirectory(path) {
   const stat = lstatSync(path, { throwIfNoEntry: false });
   return stat !== void 0 && !stat.isDirectory();
 }
+function linksToProjectSharedSkill(projectDir, id) {
+  const slot = join6(projectDir, ".claude/skills", id);
+  if (lstatSync(slot, { throwIfNoEntry: false })?.isSymbolicLink() !== true) return false;
+  try {
+    const real = realpathSync(slot);
+    return real === join6(realpathSync(projectDir), ".agents/skills", id) && statSync(real).isDirectory();
+  } catch {
+    return false;
+  }
+}
 function foreignOwnedTarget(projectDir, rel) {
   const slot = SKILL_SLOT.exec(rel)?.[1];
   if (slot === void 0) return null;
-  if (occupiedByNonDirectory(join4(projectDir, slot))) return slot;
+  if (occupiedByNonDirectory(join6(projectDir, slot))) return slot;
   if (rel !== slot) {
     const parts = rel.slice(slot.length + 1).split("/");
     let cursor = slot;
     for (const part of parts.slice(0, -1)) {
       cursor = `${cursor}/${part}`;
-      if (occupiedByNonDirectory(join4(projectDir, cursor))) return cursor;
+      if (occupiedByNonDirectory(join6(projectDir, cursor))) return cursor;
     }
-    const leaf = lstatSync(join4(projectDir, rel), { throwIfNoEntry: false });
+    const leaf = lstatSync(join6(projectDir, rel), { throwIfNoEntry: false });
     if (leaf !== void 0 && !leaf.isFile()) return rel;
   }
   return null;
@@ -1324,20 +1439,20 @@ function createOwnedWriter(projectDir, baseline, options = {}) {
   let updated = 0;
   return {
     write(absPath, content, opts) {
-      const rel = relative(projectDir, absPath).split(sep).join("/");
+      const rel = relative(projectDir, absPath).split(sep2).join("/");
       const foreign = foreignOwnedTarget(projectDir, rel);
       if (foreign !== null) {
         if (!foreignOwned.includes(foreign)) foreignOwned.push(foreign);
         return false;
       }
       const digest = hashContent(content);
-      if (!existsSync4(absPath)) {
+      if (!existsSync5(absPath)) {
         if (refreshOnly && !opts?.createInRefresh) return false;
         mkdirSync(dirname(absPath), { recursive: true });
         writeFileSync(absPath, content);
         updated++;
       } else {
-        const current = readFileSync3(absPath, "utf8");
+        const current = readFileSync4(absPath, "utf8");
         if (current !== content) {
           if (!isHarnessOwned(baseline, rel, current)) {
             backupPaths.push(backupFile(absPath, now));
@@ -1364,8 +1479,8 @@ function createOwnedWriter(projectDir, baseline, options = {}) {
 
 // src/rules-port.ts
 init_esm_shims();
-import { existsSync as existsSync5, readFileSync as readFileSync4 } from "fs";
-import { join as join5 } from "path";
+import { existsSync as existsSync6, readFileSync as readFileSync5 } from "fs";
+import { join as join7 } from "path";
 function stripClaudeFrontmatter(source) {
   if (!source.startsWith("---\n")) return source.trim();
   const end = source.indexOf("\n---", 4);
@@ -1375,9 +1490,9 @@ function stripClaudeFrontmatter(source) {
 function portRules(harnessRoot, ruleNames) {
   const ported = [];
   for (const name of ruleNames) {
-    const src = join5(harnessRoot, "templates/rules", `${name}.md`);
-    if (!existsSync5(src)) continue;
-    ported.push({ name, body: stripClaudeFrontmatter(readFileSync4(src, "utf8")) });
+    const src = join7(harnessRoot, "templates/rules", `${name}.md`);
+    if (!existsSync6(src)) continue;
+    ported.push({ name, body: stripClaudeFrontmatter(readFileSync5(src, "utf8")) });
   }
   return ported;
 }
@@ -1397,11 +1512,17 @@ function runAntigravityTransform(params) {
     refreshOnly
   } = params;
   const writer = createOwnedWriter(projectDir, baseline, { refreshOnly: refreshOnly ?? false });
-  const rulesFile = writeRules(harnessRoot, projectDir, writer, selectedInternalSkills);
+  const { skillIds, skillWriter } = agentsSkillSlot({
+    projectDir,
+    selectedInternalSkills,
+    refreshOnly: refreshOnly ?? false,
+    writer
+  });
+  const rulesFile = writeRules(harnessRoot, projectDir, writer, skillIds);
   const antigravityInstalled = rulesFile !== null;
   const harnessRuleFiles = [];
   for (const rule of portRules(harnessRoot, rules)) {
-    const target = join6(projectDir, ".agents", "rules", `${rule.name}.md`);
+    const target = join8(projectDir, ".agents", "rules", `${rule.name}.md`);
     if (!writer.write(target, `${rule.body}
 `, { createInRefresh: antigravityInstalled })) {
       continue;
@@ -1411,8 +1532,8 @@ function runAntigravityTransform(params) {
   const skillFiles = writeBundledSkillDirs({
     harnessRoot,
     projectDir,
-    skillIds: selectedInternalSkills,
-    writer
+    skillIds,
+    writer: skillWriter
   });
   return {
     rulesFile,
@@ -1422,14 +1543,14 @@ function runAntigravityTransform(params) {
   };
 }
 function writeRules(harnessRoot, projectDir, writer, selectedInternalSkills) {
-  const claudeMdPath = join6(harnessRoot, "templates/CLAUDE.md");
-  const templatePath = join6(harnessRoot, "templates/antigravity/AGENTS.md.template");
-  if (!existsSync6(claudeMdPath) || !existsSync6(templatePath)) {
+  const claudeMdPath = join8(harnessRoot, "templates/CLAUDE.md");
+  const templatePath = join8(harnessRoot, "templates/antigravity/AGENTS.md.template");
+  if (!existsSync7(claudeMdPath) || !existsSync7(templatePath)) {
     return null;
   }
-  const claudeMd = readFileSync5(claudeMdPath, "utf8");
-  const template = readFileSync5(templatePath, "utf8");
-  const target = join6(projectDir, ".agents", "rules", "uzys-harness.md");
+  const claudeMd = readFileSync6(claudeMdPath, "utf8");
+  const template = readFileSync6(templatePath, "utf8");
+  const target = join8(projectDir, ".agents", "rules", "uzys-harness.md");
   const rulesOut = renderAgentsMd({
     template,
     claudeMd,
@@ -1447,18 +1568,18 @@ function writeRules(harnessRoot, projectDir, writer, selectedInternalSkills) {
 // src/codex/opt-in.ts
 init_esm_shims();
 import { homedir } from "os";
-import { join as join7 } from "path";
+import { join as join9 } from "path";
 
 // src/codex/trust-entry.ts
 init_esm_shims();
-import { existsSync as existsSync7, mkdirSync as mkdirSync2, readFileSync as readFileSync6, writeFileSync as writeFileSync2 } from "fs";
+import { existsSync as existsSync8, mkdirSync as mkdirSync2, readFileSync as readFileSync7, writeFileSync as writeFileSync2 } from "fs";
 import { dirname as dirname2 } from "path";
 var TRUST_BLOCK_REGEX = /\[projects\."([^"]+)"\]/g;
 function registerTrustEntry(opts) {
   const { configPath, projectDir } = opts;
   try {
     mkdirSync2(dirname2(configPath), { recursive: true });
-    const existing = existsSync7(configPath) ? readFileSync6(configPath, "utf8") : "";
+    const existing = existsSync8(configPath) ? readFileSync7(configPath, "utf8") : "";
     if (hasTrustEntry(existing, projectDir)) {
       return { status: "already-present" };
     }
@@ -1482,8 +1603,8 @@ function hasTrustEntry(configContent, projectDir) {
 
 // src/codex/opt-in.ts
 function runCodexOptIn(ctx) {
-  const codexHome = ctx.codexHome ?? join7(homedir(), ".codex");
-  const configPath = join7(codexHome, "config.toml");
+  const codexHome = ctx.codexHome ?? join9(homedir(), ".codex");
+  const configPath = join9(codexHome, "config.toml");
   const result = registerTrustEntry({ configPath, projectDir: ctx.projectDir });
   return {
     trustEntry: {
@@ -1496,8 +1617,8 @@ function runCodexOptIn(ctx) {
 
 // src/codex/transform.ts
 init_esm_shims();
-import { chmodSync as chmodSync2, existsSync as existsSync8, readFileSync as readFileSync7 } from "fs";
-import { basename as basename2, join as join8 } from "path";
+import { chmodSync as chmodSync2, existsSync as existsSync9, readFileSync as readFileSync8 } from "fs";
+import { basename as basename2, join as join10 } from "path";
 
 // src/codex/config-toml.ts
 init_esm_shims();
@@ -1571,38 +1692,49 @@ function runCodexTransform(params) {
     selectedInternalSkills = [],
     rules = [],
     baseline,
-    refreshOnly
+    refreshOnly,
+    writeAgentsMd = true
   } = params;
   const writer = createOwnedWriter(projectDir, baseline, { refreshOnly: refreshOnly ?? false });
-  const claudeMd = readRequired(join8(harnessRoot, "templates/CLAUDE.md"));
-  const agentsTemplate = readRequired(join8(harnessRoot, "templates/codex/AGENTS.md.template"));
-  const configTemplate = readRequired(join8(harnessRoot, "templates/codex/config.toml.template"));
+  const claudeMd = readRequired(join10(harnessRoot, "templates/CLAUDE.md"));
+  const agentsTemplate = readRequired(join10(harnessRoot, "templates/codex/AGENTS.md.template"));
+  const configTemplate = readRequired(join10(harnessRoot, "templates/codex/config.toml.template"));
   const projectName = basename2(projectDir);
-  const mcp = readOptionalJson(join8(harnessRoot, ".mcp.json"));
-  const agentsMdPath = join8(projectDir, "AGENTS.md");
-  ensureDir(projectDir);
-  const agentsMdOut = renderAgentsMd({
-    template: agentsTemplate,
-    claudeMd,
-    projectName,
-    // ADR-085 — 상시 스킬 안내는 앵커가 아니라 여기(프로젝트 맥락)에, 깔린 것만.
-    // #503 — 그 조각은 설치자 소유 절 안에 사니 마커로 감싼다.
-    projectContext: withMarkedContinuousSkillsNote(
-      renderFillScaffold("agents-md"),
-      selectedInternalSkills
-    ),
-    // Codex 는 룰 디렉터리가 없다 — 룰이 AGENTS.md 본문에 들어가야 도달한다(§Harness Rules).
-    harnessRules: renderRulesBlock(portRules(harnessRoot, rules))
+  const mcp = readOptionalJson(join10(harnessRoot, ".mcp.json"));
+  const { skillIds, skillWriter } = agentsSkillSlot({
+    projectDir,
+    selectedInternalSkills,
+    refreshOnly: refreshOnly ?? false,
+    writer
   });
-  writer.write(
-    agentsMdPath,
-    mergeAgentsMd({
-      rendered: agentsMdOut,
-      existing: existsSync8(agentsMdPath) ? readFileSync7(agentsMdPath, "utf8") : null,
-      template: agentsTemplate
-    })
-  );
-  const configTomlPath = join8(projectDir, ".codex/config.toml");
+  const agentsMdPath = join10(projectDir, "AGENTS.md");
+  const seededContext = !writeAgentsMd || refreshOnly || existsSync9(agentsMdPath) ? null : seedAgentsMdProjectContext(projectDir);
+  ensureDir(projectDir);
+  if (writeAgentsMd) {
+    const agentsMdOut = renderAgentsMd({
+      template: agentsTemplate,
+      claudeMd,
+      projectName,
+      // ADR-085 — 상시 스킬 안내는 앵커가 아니라 여기(프로젝트 맥락)에, 깔린 것만.
+      // #503 — 그 조각은 설치자 소유 절 안에 사니 마커로 감싼다.
+      // #530 — `skillIds` 를 쓴다(= 깔린 것 + **이번 실행이 만들 것**).
+      projectContext: withMarkedContinuousSkillsNote(
+        seededContext ?? renderFillScaffold("agents-md"),
+        skillIds
+      ),
+      // Codex 는 룰 디렉터리가 없다 — 룰이 AGENTS.md 본문에 들어가야 도달한다(§Harness Rules).
+      harnessRules: renderRulesBlock(portRules(harnessRoot, rules))
+    });
+    writer.write(
+      agentsMdPath,
+      mergeAgentsMd({
+        rendered: agentsMdOut,
+        existing: existsSync9(agentsMdPath) ? readFileSync8(agentsMdPath, "utf8") : null,
+        template: agentsTemplate
+      })
+    );
+  }
+  const configTomlPath = join10(projectDir, ".codex/config.toml");
   writer.write(
     configTomlPath,
     renderConfigToml({
@@ -1612,15 +1744,15 @@ function runCodexTransform(params) {
       mcp
     })
   );
-  const hookDir = join8(projectDir, ".codex/hooks");
+  const hookDir = join10(projectDir, ".codex/hooks");
   const hookFiles = [];
   for (const hook of HOOK_NAMES) {
-    const src = join8(harnessRoot, "templates/hooks", `${hook}.sh`);
-    if (!existsSync8(src)) {
+    const src = join10(harnessRoot, "templates/hooks", `${hook}.sh`);
+    if (!existsSync9(src)) {
       continue;
     }
-    const ported = readFileSync7(src, "utf8").replace(ENV_VAR_RENAME, "CODEX_PROJECT_DIR");
-    const target = join8(hookDir, `${hook}.sh`);
+    const ported = readFileSync8(src, "utf8").replace(ENV_VAR_RENAME, "CODEX_PROJECT_DIR");
+    const target = join10(hookDir, `${hook}.sh`);
     if (!writer.write(target, ported)) continue;
     chmodSync2(target, 493);
     hookFiles.push(target);
@@ -1628,11 +1760,12 @@ function runCodexTransform(params) {
   const skillFiles = writeBundledSkillDirs({
     harnessRoot,
     projectDir,
-    skillIds: selectedInternalSkills,
-    writer
+    skillIds,
+    writer: skillWriter
   });
   return {
     agentsMdPath,
+    agentsMdSeededFrom: seededContext === null ? null : "CLAUDE.md",
     configTomlPath,
     hookFiles,
     skillFiles,
@@ -1640,17 +1773,17 @@ function runCodexTransform(params) {
   };
 }
 function readRequired(path) {
-  if (!existsSync8(path)) {
+  if (!existsSync9(path)) {
     throw new Error(`Codex transform: required source missing: ${path}`);
   }
-  return readFileSync7(path, "utf8");
+  return readFileSync8(path, "utf8");
 }
 function readOptionalJson(path) {
-  if (!existsSync8(path)) {
+  if (!existsSync9(path)) {
     return null;
   }
   try {
-    return JSON.parse(readFileSync7(path, "utf8"));
+    return JSON.parse(readFileSync8(path, "utf8"));
   } catch {
     return null;
   }
@@ -1658,8 +1791,8 @@ function readOptionalJson(path) {
 
 // src/opencode/transform.ts
 init_esm_shims();
-import { existsSync as existsSync9, readdirSync, readFileSync as readFileSync8, unlinkSync } from "fs";
-import { basename as basename3, join as join9 } from "path";
+import { existsSync as existsSync10, readdirSync, readFileSync as readFileSync9, unlinkSync } from "fs";
+import { basename as basename3, join as join11 } from "path";
 
 // src/opencode/agents-md.ts
 init_esm_shims();
@@ -1702,24 +1835,33 @@ function runOpencodeTransform(params) {
     refreshOnly
   } = params;
   const writer = createOwnedWriter(projectDir, baseline, { refreshOnly: refreshOnly ?? false });
-  const claudeMd = readRequired2(join9(harnessRoot, "templates/CLAUDE.md"));
-  const agentsTemplate = readRequired2(join9(harnessRoot, "templates/opencode/AGENTS.md.template"));
+  const claudeMd = readRequired2(join11(harnessRoot, "templates/CLAUDE.md"));
+  const agentsTemplate = readRequired2(join11(harnessRoot, "templates/opencode/AGENTS.md.template"));
   const opencodeTemplate = readRequired2(
-    join9(harnessRoot, "templates/opencode/opencode.json.template")
+    join11(harnessRoot, "templates/opencode/opencode.json.template")
   );
   const projectName = basename3(projectDir);
-  const mcp = readOptionalJson2(join9(harnessRoot, ".mcp.json"));
+  const mcp = readOptionalJson2(join11(harnessRoot, ".mcp.json"));
+  const { skillIds, skillWriter } = agentsSkillSlot({
+    projectDir,
+    selectedInternalSkills,
+    refreshOnly: refreshOnly ?? false,
+    writer
+  });
   ensureDir(projectDir);
-  const agentsMdPath = join9(projectDir, "AGENTS.md");
+  const agentsMdPath = join11(projectDir, "AGENTS.md");
+  const seededContext = refreshOnly || existsSync10(agentsMdPath) ? null : seedAgentsMdProjectContext(projectDir);
   const agentsMdOut = renderAgentsMd2({
     template: agentsTemplate,
     claudeMd,
     projectName,
     // ADR-085 — 상시 스킬 안내는 앵커가 아니라 여기(프로젝트 맥락)에, 깔린 것만.
     // #503 — 그 조각은 설치자 소유 절 안에 사니 마커로 감싼다 (codex 와 같은 마커).
+    // #531 — `skillIds` 를 쓴다(= 깔린 것 + **이번 실행이 만들 것**). 안 그러면 이번에 새로
+    // 깐 상시 스킬이 다음 update 까지 안내에서 빠져 설치자 에이전트가 영영 안 연다.
     projectContext: withMarkedContinuousSkillsNote(
-      renderFillScaffold("agents-md"),
-      selectedInternalSkills
+      seededContext ?? renderFillScaffold("agents-md"),
+      skillIds
     ),
     // codex 와 **같은 파일**(프로젝트 루트 `AGENTS.md`)이다. 두 transform 이 서로 다른 본문을
     // 쓰면 나중에 도는 쪽이 앞선 쪽을 덮어써, codex+opencode 조합에서 룰이 통째로 사라진다
@@ -1730,26 +1872,26 @@ function runOpencodeTransform(params) {
     agentsMdPath,
     mergeAgentsMd({
       rendered: agentsMdOut,
-      existing: existsSync9(agentsMdPath) ? readFileSync8(agentsMdPath, "utf8") : null,
+      existing: existsSync10(agentsMdPath) ? readFileSync9(agentsMdPath, "utf8") : null,
       template: agentsTemplate
     })
   );
-  const opencodeJsonPath = join9(projectDir, "opencode.json");
+  const opencodeJsonPath = join11(projectDir, "opencode.json");
   writer.write(opencodeJsonPath, renderOpencodeJson({ template: opencodeTemplate, mcp }));
   const skillFiles = writeBundledSkillDirs({
     harnessRoot,
     projectDir,
-    skillIds: selectedInternalSkills,
-    writer
+    skillIds,
+    writer: skillWriter
   });
   const retiredCommands = [];
-  const cmdDir = join9(projectDir, ".opencode/commands");
-  if (existsSync9(cmdDir)) {
+  const cmdDir = join11(projectDir, ".opencode/commands");
+  if (existsSync10(cmdDir)) {
     for (const entry of readdirSync(cmdDir)) {
       if (!entry.endsWith(".md")) continue;
       const id = entry.slice(0, -3);
-      if (!existsSync9(join9(harnessRoot, "templates/skills", id, "SKILL.md"))) continue;
-      const victim = join9(cmdDir, entry);
+      if (!existsSync10(join11(harnessRoot, "templates/skills", id, "SKILL.md"))) continue;
+      const victim = join11(cmdDir, entry);
       try {
         backupFile(victim);
         unlinkSync(victim);
@@ -1760,6 +1902,7 @@ function runOpencodeTransform(params) {
   }
   return {
     agentsMdPath,
+    agentsMdSeededFrom: seededContext === null ? null : "CLAUDE.md",
     opencodeJsonPath,
     skillFiles,
     retiredCommands,
@@ -1767,17 +1910,17 @@ function runOpencodeTransform(params) {
   };
 }
 function readRequired2(path) {
-  if (!existsSync9(path)) {
+  if (!existsSync10(path)) {
     throw new Error(`OpenCode transform: required source missing: ${path}`);
   }
-  return readFileSync8(path, "utf8");
+  return readFileSync9(path, "utf8");
 }
 function readOptionalJson2(path) {
-  if (!existsSync9(path)) {
+  if (!existsSync10(path)) {
     return null;
   }
   try {
-    return JSON.parse(readFileSync8(path, "utf8"));
+    return JSON.parse(readFileSync9(path, "utf8"));
   } catch {
     return null;
   }
@@ -1823,7 +1966,11 @@ function runCliTransforms(params) {
       selectedInternalSkills,
       rules,
       baseline,
-      refreshOnly
+      refreshOnly,
+      // #550 — 같은 `AGENTS.md` 를 한 실행에서 쓰는 쪽은 하나다. opencode 가 뒤에서 자기 템플릿으로
+      // 쓰면 codex 판은 어차피 같은 실행 안에서 덮였고(최종 파일 = opencode 판), 매 실행 codex 가
+      // opencode 판을 자기 판으로 뒤집는 한 번의 쓰기가 설치자 편집분을 백업으로 쌓았다.
+      writeAgentsMd: !cli2.includes("opencode")
     });
     absorb(codex);
     if (codexTrust) {
@@ -1869,8 +2016,8 @@ function runCliTransforms(params) {
 
 // src/env-files.ts
 init_esm_shims();
-import { appendFileSync, existsSync as existsSync10, readFileSync as readFileSync9, writeFileSync as writeFileSync3 } from "fs";
-import { join as join10 } from "path";
+import { appendFileSync, existsSync as existsSync11, readFileSync as readFileSync10, writeFileSync as writeFileSync3 } from "fs";
+import { join as join12 } from "path";
 var ENV_EXAMPLE_BODY = `# .env.example \u2014 csr-supabase Track
 # Copy to .env (gitignored) and fill in values: cp .env.example .env
 
@@ -1907,24 +2054,24 @@ function writeEnvExample(projectDir, tracks) {
   if (!tracks.some((t) => ENV_EXAMPLE_TRACKS.includes(t))) {
     return false;
   }
-  const path = join10(projectDir, ".env.example");
-  if (existsSync10(path)) {
+  const path = join12(projectDir, ".env.example");
+  if (existsSync11(path)) {
     return false;
   }
   writeFileSync3(path, ENV_EXAMPLE_BODY);
   return true;
 }
 function addGitignoreEnv(projectDir) {
-  const path = join10(projectDir, ".gitignore");
-  if (!existsSync10(path)) {
+  const path = join12(projectDir, ".gitignore");
+  if (!existsSync11(path)) {
     return false;
   }
-  const content = readFileSync9(path, "utf8");
+  const content = readFileSync10(path, "utf8");
   if (GITIGNORE_ENV_PATTERN.test(content)) {
     return false;
   }
-  const sep3 = content.endsWith("\n") ? "" : "\n";
-  appendFileSync(path, `${sep3}
+  const sep4 = content.endsWith("\n") ? "" : "\n";
+  appendFileSync(path, `${sep4}
 # Secret env (auto-added by agent-harness install)
 .env
 `);
@@ -1933,11 +2080,11 @@ function addGitignoreEnv(projectDir) {
 var AGENT_ARTIFACT_DIRS = [".factory/", ".goose/", ".uzys-agent-harness/"];
 var GITIGNORE_AGENT_ARTIFACT_HEADER = "# agent CLI / harness \uC790\uB3D9 \uC0DD\uC131\uBB3C (auto-added by agent-harness)";
 function addGitignoreAgentArtifacts(projectDir) {
-  const path = join10(projectDir, ".gitignore");
-  if (!existsSync10(path)) {
+  const path = join12(projectDir, ".gitignore");
+  if (!existsSync11(path)) {
     return [];
   }
-  const content = readFileSync9(path, "utf8");
+  const content = readFileSync10(path, "utf8");
   const missing = AGENT_ARTIFACT_DIRS.filter((pattern) => {
     const lineRegex = new RegExp(`^${pattern.replace(/\./g, "\\.").replace(/\//g, "/")}\\s*$`, "m");
     return !lineRegex.test(content);
@@ -1945,9 +2092,9 @@ function addGitignoreAgentArtifacts(projectDir) {
   if (missing.length === 0) {
     return [];
   }
-  const sep3 = content.endsWith("\n") ? "" : "\n";
+  const sep4 = content.endsWith("\n") ? "" : "\n";
   const block = [GITIGNORE_AGENT_ARTIFACT_HEADER, ...missing].join("\n");
-  appendFileSync(path, `${sep3}
+  appendFileSync(path, `${sep4}
 ${block}
 `);
   return [...missing];
@@ -1956,9 +2103,9 @@ ${block}
 // src/external-installer.ts
 init_esm_shims();
 import { spawnSync } from "child_process";
-import { existsSync as existsSync11, readdirSync as readdirSync2, readFileSync as readFileSync10 } from "fs";
+import { existsSync as existsSync12, readdirSync as readdirSync2, readFileSync as readFileSync11 } from "fs";
 import { homedir as homedir2 } from "os";
-import { join as join11 } from "path";
+import { join as join13 } from "path";
 var DEFAULT_SPAWN_TIMEOUT_MS = 12e4;
 var NPM_SPAWN_TIMEOUT_MS = 6e5;
 function spawnTimeoutFor(kind) {
@@ -2070,7 +2217,10 @@ function refreshExternalSkills(projectDir, deps = {}) {
       tracks: log.spec.tracks,
       // `forceInclude` 가 조건 판정을 앞지르므로 옵션 값은 결과에 영향을 주지 않는다.
       options: DEFAULT_OPTIONS,
-      cli: log.spec.cli,
+      // #528 — 대상 CLI 는 **깔린 집합**(`installedClis`)이다. `spec.cli` 는 마지막 install 의
+      // 요청이라 `uninstall --cli` 뒤에도 뺀 CLI 를 말하고, 반대로 그걸 비우면 `buildSkillArgs` 가
+      // `--agent`·`--copy` 를 못 붙여 Claude 몫이 조용히 빠진다(재리뷰 BLOCKER-3).
+      cli: [...installedClis(log)],
       userOverride: { forceInclude: [...installedIds], forceExclude: [] },
       scope: log.scope,
       projectDir
@@ -2166,17 +2316,17 @@ function detectVersion(method, spawn) {
         if (at2 <= 0) return void 0;
         const plugin = method.pluginId.slice(0, at2);
         const marketplaceShort = method.pluginId.slice(at2 + 1);
-        const cacheBase = join11(homedir2(), ".claude/plugins/cache", marketplaceShort, plugin);
-        if (!existsSync11(cacheBase)) return void 0;
+        const cacheBase = join13(homedir2(), ".claude/plugins/cache", marketplaceShort, plugin);
+        if (!existsSync12(cacheBase)) return void 0;
         const versions = readdirSync2(cacheBase).filter((v2) => /^\d/.test(v2)).sort();
         return versions.at(-1);
       }
       case "npm": {
         const npmRoot = getNpmGlobalRoot(spawn);
         if (!npmRoot) return void 0;
-        const pkgJson = join11(npmRoot, method.pkg, "package.json");
-        if (!existsSync11(pkgJson)) return void 0;
-        const parsed = JSON.parse(readFileSync10(pkgJson, "utf8"));
+        const pkgJson = join13(npmRoot, method.pkg, "package.json");
+        if (!existsSync12(pkgJson)) return void 0;
+        const parsed = JSON.parse(readFileSync11(pkgJson, "utf8"));
         return parsed.version;
       }
       default:
@@ -2201,9 +2351,30 @@ function getNpmGlobalRoot(spawn) {
   return void 0;
 }
 
+// src/linked-skill-bodies.ts
+init_esm_shims();
+import { join as join14 } from "path";
+function refreshLinkedSkillBodies(params) {
+  const { harnessRoot, projectDir, ids, baseline } = params;
+  const bodyKey = (id) => `.agents/skills/${id}/SKILL.md`;
+  const ours = ids.filter((id) => baseline.has(bodyKey(id)));
+  const writer = createOwnedWriter(projectDir, baseline);
+  const written = new Set(
+    writeBundledSkillDirs({ harnessRoot, projectDir, skillIds: ours, writer })
+  );
+  const result = writer.result();
+  return {
+    updated: ours.filter((id) => written.has(join14(projectDir, bodyKey(id)))),
+    notOurs: ids.filter((id) => !baseline.has(bodyKey(id))),
+    files: result.files,
+    backupPaths: result.backupPaths,
+    foreignOwned: result.foreignOwned
+  };
+}
+
 // src/mcp-merge.ts
 init_esm_shims();
-import { existsSync as existsSync12, readFileSync as readFileSync11, writeFileSync as writeFileSync4 } from "fs";
+import { existsSync as existsSync13, readFileSync as readFileSync12, writeFileSync as writeFileSync4 } from "fs";
 function parseTrackMcpMap(raw) {
   const rows = [];
   for (const line of raw.split(/\r?\n/)) {
@@ -2254,15 +2425,15 @@ function mergeMcpServers(base, rows, tracks) {
   return out;
 }
 function composeMcpJson(opts) {
-  const base = JSON.parse(readFileSync11(opts.templateMcpPath, "utf8"));
-  const merged = opts.existingPath && existsSync12(opts.existingPath) ? mergeUserBase(base, opts.existingPath) : base;
-  const mapRaw = existsSync12(opts.trackMapPath) ? readFileSync11(opts.trackMapPath, "utf8") : "";
+  const base = JSON.parse(readFileSync12(opts.templateMcpPath, "utf8"));
+  const merged = opts.existingPath && existsSync13(opts.existingPath) ? mergeUserBase(base, opts.existingPath) : base;
+  const mapRaw = existsSync13(opts.trackMapPath) ? readFileSync12(opts.trackMapPath, "utf8") : "";
   const rows = parseTrackMcpMap(mapRaw);
   return mergeMcpServers(merged, rows, opts.tracks);
 }
 function mergeUserBase(base, existingPath) {
   try {
-    const existing = JSON.parse(readFileSync11(existingPath, "utf8"));
+    const existing = JSON.parse(readFileSync12(existingPath, "utf8"));
     return {
       ...base,
       mcpServers: { ...base.mcpServers, ...existing.mcpServers }
@@ -2280,24 +2451,26 @@ function writeMcpJson(path, mcp) {
 init_esm_shims();
 import {
   copyFileSync,
-  existsSync as existsSync13,
+  existsSync as existsSync14,
   mkdirSync as mkdirSync3,
   readdirSync as readdirSync3,
-  readFileSync as readFileSync12,
+  readFileSync as readFileSync13,
   rmdirSync,
-  statSync,
+  statSync as statSync2,
   unlinkSync as unlinkSync2,
   writeFileSync as writeFileSync5
 } from "fs";
-import { basename as basename4, dirname as dirname3, join as join12 } from "path";
+import { basename as basename4, dirname as dirname3, join as join15 } from "path";
 var LEGACY_ANCHOR_FILE = ".claude/CLAUDE.md";
 function buildUpdateSpec(projectDir, tracks, only) {
+  const log = readInstallLog(projectDir);
+  const clis = log === null ? [] : installedClis(log);
   return {
     tracks: [...tracks],
     options: DEFAULT_OPTIONS,
-    cli: ["claude"],
+    cli: clis.length > 0 ? [...clis] : ["claude"],
     projectDir,
-    scope: readInstallLog(projectDir)?.scope ?? "project",
+    scope: log?.scope ?? "project",
     // 전부 골랐으면 "제한 없음"과 같다 — 화면·기록에 제한이 있었던 것처럼 남기지 않는다.
     ...only !== void 0 && only.length > 0 && only.length < UPDATE_GROUPS.length ? { updateOnly: [...only] } : {}
   };
@@ -2308,7 +2481,7 @@ function parseUpdateOnly(raw) {
   return { ok: true, groups: [...new Set(raw)] };
 }
 function runUpdateMode(projectDir, templatesDir, harnessRoot, deps = {}, only) {
-  const claudeDir = join12(projectDir, ".claude");
+  const claudeDir = join15(projectDir, ".claude");
   const startedAt = Date.now();
   const wants = (g) => only === void 0 || only.includes(g);
   const report = {
@@ -2323,6 +2496,7 @@ function runUpdateMode(projectDir, templatesDir, harnessRoot, deps = {}, only) {
     rootImportAdded: false,
     rootBlockRefreshed: false,
     legacyAnchor: null,
+    claudeUnrecorded: null,
     skillsBackedUp: [],
     skillsSkippedLinks: [],
     skillsPruned: [],
@@ -2345,11 +2519,14 @@ function runUpdateMode(projectDir, templatesDir, harnessRoot, deps = {}, only) {
   report.installedNew = fresh.installed;
   report.restored = fresh.restored;
   report.needsReinstall = fresh.needsReinstall;
+  const logAtStart = readInstallLog(projectDir);
+  const claudeManaged = logAtStart === null || installedClis(logAtStart).includes("claude");
+  report.claudeUnrecorded = !claudeManaged && logAtStart !== null && existsSync14(claudeDir) ? recordClaudeCommand(logAtStart, installedTracks(projectDir)) : null;
   const policyBase = policyBaseline(projectDir);
   for (const { dir, ext } of POLICY_DIRS) {
-    if (!wants(dir === "hooks" ? "hooks" : "rules")) continue;
-    const target = join12(claudeDir, dir);
-    const source = join12(templatesDir, dir);
+    if (!claudeManaged || !wants(dir === "hooks" ? "hooks" : "rules")) continue;
+    const target = join15(claudeDir, dir);
+    const source = join15(templatesDir, dir);
     const label = `.claude/${dir}`;
     const ctx = { prefix: dir, baseline: policyBase };
     const synced = updateDir(target, source, ext, ctx);
@@ -2360,10 +2537,11 @@ function runUpdateMode(projectDir, templatesDir, harnessRoot, deps = {}, only) {
   const syncedDirs = POLICY_DIRS.filter((d2) => wants(d2.dir === "hooks" ? "hooks" : "rules")).map(
     (d2) => d2.dir
   );
-  if (syncedDirs.length > 0) refreshPolicyBaseline(projectDir, templatesDir, syncedDirs);
-  const skillSync = wants("skills") ? syncSkills(
-    join12(claudeDir, "skills"),
-    join12(templatesDir, "skills"),
+  if (claudeManaged && syncedDirs.length > 0)
+    refreshPolicyBaseline(projectDir, templatesDir, syncedDirs);
+  const skillSync = claudeManaged && wants("skills") ? syncSkills(
+    join15(claudeDir, "skills"),
+    join15(templatesDir, "skills"),
     skillBaseline(projectDir),
     /* @__PURE__ */ new Date(),
     (relInSkills) => foreignOwnedTarget(projectDir, `.claude/skills/${relInSkills}`)
@@ -2372,25 +2550,36 @@ function runUpdateMode(projectDir, templatesDir, harnessRoot, deps = {}, only) {
   report.skillsBackedUp = skillSync.backedUp;
   report.skillsSkippedLinks = skillSync.skippedLinks;
   report.skillsPruned = skillSync.pruned;
-  const newSkills = wants("new-skills") ? installNewSkillDirs(projectDir, templatesDir, installedTracks(projectDir)) : { installed: [], foreignOwned: [] };
+  const newSkills = claudeManaged && wants("new-skills") ? installNewSkillDirs(projectDir, templatesDir, installedTracks(projectDir)) : { installed: [], restored: [], foreignOwned: [] };
   report.installedNew.push(...newSkills.installed);
-  if (wants("skills")) refreshSkillBaseline(projectDir, templatesDir);
-  else if (newSkills.installed.length > 0)
-    recordNewSkillBaseline(projectDir, templatesDir, newSkills.installed);
-  const installLog = readInstallLog(projectDir);
-  if (existsSync13(claudeDir) && (installLog === null || installLog.spec.cli.includes("claude"))) {
+  report.restored.push(...newSkills.restored);
+  const copiedSkills = [...newSkills.installed, ...newSkills.restored];
+  if (claudeManaged && wants("skills")) refreshSkillBaseline(projectDir, templatesDir);
+  else if (claudeManaged && copiedSkills.length > 0)
+    recordNewSkillBaseline(projectDir, templatesDir, copiedSkills);
+  if (existsSync14(claudeDir) && claudeManaged) {
     if (wants("anchor")) syncHarnessAnchor(projectDir, templatesDir, report);
   }
-  const settingsPath = join12(claudeDir, "settings.json");
-  if (wants("hooks") && existsSync13(settingsPath)) {
+  const settingsPath = join15(claudeDir, "settings.json");
+  if (claudeManaged && wants("hooks") && existsSync14(settingsPath)) {
     report.staleHookRefs = cleanStaleHookRefs(settingsPath, claudeDir);
   }
   if (wants("hooks")) report.mcpAllowlistRetired = retireMcpAllowlist(projectDir);
   report.retiredAgents = staleAgentFiles(claudeDir);
   report.demotedAgents = demotedAgentFiles(claudeDir, installedTracks(projectDir));
-  const external = wants("external") ? refreshExternalCli(projectDir, harnessRoot) : { externalUpdated: 0, externalBackedUp: [], externalForeignOwned: [] };
+  const external = wants("external") ? refreshExternalCli(projectDir, harnessRoot) : {
+    externalUpdated: 0,
+    externalBackedUp: [],
+    externalForeignOwned: [],
+    written: [],
+    skillsInstalled: [],
+    skillsRestored: []
+  };
   report.externalUpdated = external.externalUpdated;
   report.externalBackedUp = external.externalBackedUp;
+  report.installedNew.push(...external.skillsInstalled);
+  report.restored.push(...external.skillsRestored);
+  report.restoredWithout = restoredWithoutArgs(report.restored, installedTracks(projectDir));
   const saidBySlotRow = new Set(report.skillsSkippedLinks.map((id) => `.claude/skills/${id}`));
   const merged = [];
   for (const f of [
@@ -2402,6 +2591,17 @@ function runUpdateMode(projectDir, templatesDir, harnessRoot, deps = {}, only) {
     if (!saidBySlotRow.has(f) && !merged.includes(f)) merged.push(f);
   }
   report.foreignOwned = merged;
+  if (wants("external")) {
+    const linked = report.skillsSkippedLinks.filter(
+      (id) => linksToProjectSharedSkill(projectDir, id)
+    );
+    const refreshed = linked.filter(
+      (id) => external.written.includes(`.agents/skills/${id}/SKILL.md`)
+    );
+    report.skillsLinked = refreshed;
+    report.skillsLinkedNotOurs = linked.filter((id) => !refreshed.includes(id));
+    report.skillsSkippedLinks = report.skillsSkippedLinks.filter((id) => !linked.includes(id));
+  }
   const skillRefresh = wants("external") ? (deps.refreshSkills ?? refreshExternalSkills)(projectDir) : { attempted: 0, refreshed: 0, failed: [], notInCatalog: [], unknown: false };
   report.externalSkillsRefreshed = skillRefresh.refreshed;
   report.externalSkillsFailed = skillRefresh.failed;
@@ -2415,20 +2615,20 @@ function runUpdateMode(projectDir, templatesDir, harnessRoot, deps = {}, only) {
   return report;
 }
 function staleSkillDirs(claudeDir) {
-  const dir = join12(claudeDir, "skills");
-  if (!existsSync13(dir)) return [];
+  const dir = join15(claudeDir, "skills");
+  if (!existsSync14(dir)) return [];
   const stale = (id) => RENAMED_SKILL_IDS[id] !== void 0 || RETIRED_SKILL_IDS.includes(id);
   return readdirSync3(dir, { withFileTypes: true }).filter((e2) => e2.isDirectory() && stale(e2.name)).map((e2) => e2.name);
 }
 function staleAgentFiles(claudeDir) {
-  const dir = join12(claudeDir, "agents");
-  if (!existsSync13(dir)) return [];
+  const dir = join15(claudeDir, "agents");
+  if (!existsSync14(dir)) return [];
   return readdirSync3(dir, { withFileTypes: true }).filter((e2) => e2.isFile() && e2.name.endsWith(".md")).map((e2) => basename4(e2.name, ".md")).filter((id) => RETIRED_AGENT_IDS.includes(id));
 }
 function demotedAgentFiles(claudeDir, tracks) {
   if (tracks.length === 0) return [];
-  const dir = join12(claudeDir, "agents");
-  if (!existsSync13(dir)) return [];
+  const dir = join15(claudeDir, "agents");
+  if (!existsSync14(dir)) return [];
   const demoted = TRACK_AGENTS.filter(([, pattern]) => !anyTrack(tracks, pattern)).map(
     ([id]) => id
   );
@@ -2440,7 +2640,7 @@ function installNewAssets(projectDir, templatesDir, wants = () => true) {
   const needsReinstall = [];
   const foreignOwned = [];
   const log = readInstallLog(projectDir);
-  const claudeSelected = log?.spec.cli.includes("claude") ?? false;
+  const claudeSelected = installedClis(log).includes("claude");
   const baselineExcluded = new Set(log?.spec.baselineExclude ?? []);
   const priorBaseline = policyBaseline(projectDir);
   for (const entry of trackOnlyFileAssets(installedTracks(projectDir))) {
@@ -2448,15 +2648,15 @@ function installNewAssets(projectDir, templatesDir, wants = () => true) {
     if (!wants(group)) continue;
     if (entry.target === HARNESS_ANCHOR_FILE) continue;
     if (isBaselineExcluded(entry.target, baselineExcluded)) continue;
-    const target = join12(projectDir, entry.target);
+    const target = join15(projectDir, entry.target);
     const foreign = foreignOwnedTarget(projectDir, entry.target);
     if (foreign !== null) {
       if (!foreignOwned.includes(foreign)) foreignOwned.push(foreign);
       continue;
     }
-    if (existsSync13(target)) continue;
-    const source = join12(templatesDir, entry.source);
-    if (!existsSync13(source)) continue;
+    if (existsSync14(target)) continue;
+    const source = join15(templatesDir, entry.source);
+    if (!existsSync14(source)) continue;
     if (entry.target.startsWith(".claude/")) {
       if (!claudeSelected) continue;
       if (entry.target.startsWith(".claude/hooks/") || entry.target === ".claude/settings.json") {
@@ -2478,26 +2678,26 @@ function collectRunBackups(projectDir, startedAt) {
   const out = [];
   const consider = (rel) => {
     if (!BACKUP_SUFFIX.test(rel)) return;
-    const abs = join12(projectDir, rel);
-    if (statSync(abs).mtimeMs < startedAt - 1e3) return;
+    const abs = join15(projectDir, rel);
+    if (statSync2(abs).mtimeMs < startedAt - 1e3) return;
     out.push({ path: rel.replace(BACKUP_SUFFIX, ""), backup: rel });
   };
   for (const e2 of readdirSync3(projectDir, { withFileTypes: true }))
     if (e2.isFile()) consider(e2.name);
   for (const dir of BACKUP_SCAN_DIRS) {
-    for (const rel of listFilesRecursive(join12(projectDir, dir))) consider(`${dir}/${rel}`);
+    for (const rel of listFilesRecursive(join15(projectDir, dir))) consider(`${dir}/${rel}`);
   }
   return out.sort((a, b2) => a.path.localeCompare(b2.path));
 }
 function writeBackupList(projectDir, backups) {
-  const dir = join12(projectDir, ".uzys-agent-harness");
-  const file = join12(dir, "update-backups.json");
+  const dir = join15(projectDir, ".uzys-agent-harness");
+  const file = join15(dir, "update-backups.json");
   try {
     if (backups.length === 0) {
-      if (existsSync13(file)) unlinkSync2(file);
+      if (existsSync14(file)) unlinkSync2(file);
       return;
     }
-    if (!existsSync13(dir)) return;
+    if (!existsSync14(dir)) return;
     writeFileSync5(
       file,
       `${JSON.stringify({ updatedAt: (/* @__PURE__ */ new Date()).toISOString(), note: "update \uAC00 \uB0A8\uAE34 \uBC31\uC5C5 \uC30D. \uC6D0\uBCF8(path)\uC740 \uCD5C\uC2E0 \uBC88\uB4E4\uD310, \uBC31\uC5C5(backup)\uC740 \uB2F9\uC2E0\uC758 \uD3B8\uC9D1\uBD84. \uD3B8\uC9D1\uC744 \uC0C8 \uD310\uC5D0 \uB2E4\uC2DC \uC5B9\uC73C\uB824\uBA74 \uB450 \uD30C\uC77C\uC758 diff \uB97C \uBCF4\uB77C.", backups }, null, 2)}
@@ -2508,29 +2708,33 @@ function writeBackupList(projectDir, backups) {
 }
 function installNewSkillDirs(projectDir, templatesDir, tracks) {
   const installed = [];
+  const restored = [];
   const foreignOwned = [];
   const log = readInstallLog(projectDir);
+  const priorIds = new Set((log?.skillFiles ?? []).map((f) => f.path.split("/")[0] ?? ""));
   const excluded = new Set(log?.spec.baselineExclude ?? []);
   const skillExcluded = new Set(log?.spec.skillExclude ?? []);
-  if (!(log?.spec.cli ?? ["claude"]).includes("claude")) return { installed, foreignOwned };
+  if (log !== null && !installedClis(log).includes("claude"))
+    return { installed, restored, foreignOwned };
   const spec = buildAssetSpec({ tracks, options: DEFAULT_OPTIONS });
   for (const entry of buildManifest(spec)) {
     if (entry.type !== "dir" || !entry.target.startsWith(".claude/skills/")) continue;
     if (!entry.applies(spec) || isBaselineExcluded(entry.target, excluded)) continue;
     if (skillExcluded.has(entry.target.slice(".claude/skills/".length))) continue;
-    const target = join12(projectDir, entry.target);
+    const target = join15(projectDir, entry.target);
     const foreign = foreignOwnedTarget(projectDir, entry.target);
     if (foreign !== null) {
       if (!foreignOwned.includes(foreign)) foreignOwned.push(foreign);
       continue;
     }
-    if (existsSync13(target)) continue;
-    const source = join12(templatesDir, entry.source);
-    if (!existsSync13(source)) continue;
+    if (existsSync14(target)) continue;
+    const source = join15(templatesDir, entry.source);
+    if (!existsSync14(source)) continue;
     copyDir(source, target, (rel) => foreignOwnedTarget(projectDir, `${entry.target}/${rel}`));
-    installed.push(entry.target);
+    if (priorIds.has(entry.target.slice(".claude/skills/".length))) restored.push(entry.target);
+    else installed.push(entry.target);
   }
-  return { installed, foreignOwned };
+  return { installed, restored, foreignOwned };
 }
 function recordNewSkillBaseline(projectDir, templatesDir, targets) {
   const log = readInstallLog(projectDir);
@@ -2554,16 +2758,16 @@ function trackOnlyFileAssets(tracks) {
   );
 }
 function syncHarnessAnchor(projectDir, templatesDir, report, now = /* @__PURE__ */ new Date()) {
-  if (existsSync13(join12(projectDir, LEGACY_ANCHOR_FILE))) {
+  if (existsSync14(join15(projectDir, LEGACY_ANCHOR_FILE))) {
     report.legacyAnchor = LEGACY_ANCHOR_FILE;
   }
-  const templateMd = join12(templatesDir, "CLAUDE.md");
-  if (!existsSync13(templateMd)) return;
-  const anchor = join12(projectDir, HARNESS_ANCHOR_FILE);
-  const existed = existsSync13(anchor);
+  const templateMd = join15(templatesDir, "CLAUDE.md");
+  if (!existsSync14(templateMd)) return;
+  const anchor = join15(projectDir, HARNESS_ANCHOR_FILE);
+  const existed = existsSync14(anchor);
   if (existed) {
-    const current = readFileSync12(anchor, "utf8");
-    if (current !== readFileSync12(templateMd, "utf8")) {
+    const current = readFileSync13(anchor, "utf8");
+    if (current !== readFileSync13(templateMd, "utf8")) {
       const recorded = readInstallLog(projectDir)?.templates.rootClaudeMd;
       const owned = recorded?.path === HARNESS_ANCHOR_FILE && hashContent(current) === recorded.sha256;
       if (!owned) {
@@ -2583,15 +2787,15 @@ function syncHarnessAnchor(projectDir, templatesDir, report, now = /* @__PURE__
   recordAnchorBaseline(projectDir, anchor);
 }
 function upsertRootImport(projectDir) {
-  const target = join12(projectDir, "CLAUDE.md");
-  const existing = existsSync13(target) ? readFileSync12(target, "utf8") : null;
+  const target = join15(projectDir, "CLAUDE.md");
+  const existing = existsSync14(target) ? readFileSync13(target, "utf8") : null;
   const next = upsertHarnessImport(existing, {
     projectName: basename4(projectDir),
     tracks: installedTracks(projectDir),
     // ADR-085 — update 는 선택 목록을 인자로 받지 않는다. `syncSkills` 와 같은 판정을 쓴다:
     // `.claude/skills/<id>` 가 있으면 그 스킬은 이 설치가 고른 것이다.
     continuousSkills: CONTINUOUS_SKILLS.map((s) => s.id).filter(
-      (id) => existsSync13(join12(projectDir, ".claude/skills", id))
+      (id) => existsSync14(join15(projectDir, ".claude/skills", id))
     )
   });
   if (next === existing) return false;
@@ -2611,7 +2815,7 @@ function recordAnchorBaseline(projectDir, anchor) {
       ...log.templates,
       rootClaudeMd: {
         path: HARNESS_ANCHOR_FILE,
-        sha256: hashContent(readFileSync12(anchor, "utf8"))
+        sha256: hashContent(readFileSync13(anchor, "utf8"))
       }
     }
   };
@@ -2622,16 +2826,45 @@ function recordAnchorBaseline(projectDir, anchor) {
 }
 function installedBundledSkills(projectDir) {
   return INTERNAL_BUNDLED_SKILL_IDS.filter(
-    (id) => existsSync13(join12(projectDir, ".claude/skills", id)) || existsSync13(join12(projectDir, ".agents/skills", id))
+    (id) => existsSync14(join15(projectDir, ".claude/skills", id)) || existsSync14(join15(projectDir, ".agents/skills", id))
   );
 }
+function installedCliTargets(log) {
+  if (log === null) return ALL_CLI_TARGETS;
+  return installedClis(log);
+}
+var RESTORED_SKILL_SLOT = /^\.(?:claude|agents)\/skills\/([^/]+)$/;
+function restoredWithoutArgs(paths, tracks) {
+  const catalog = new Set(EXTERNAL_ASSETS.map((a) => a.id));
+  const baselineIds = new Set(listBaselineTargets({ tracks }).map((t) => t.id));
+  const out = {};
+  for (const path of paths) {
+    const skill = RESTORED_SKILL_SLOT.exec(path)?.[1];
+    if (skill !== void 0 && catalog.has(skill) && INTERNAL_BUNDLED_SKILL_IDS.includes(skill)) {
+      out[path] = skill;
+      continue;
+    }
+    const target = classifyBaselineTarget(path);
+    if (target !== null && baselineIds.has(target.id)) out[path] = target.id;
+  }
+  return out;
+}
+var SHARED_SKILLS_DIR = ".agents/skills";
+var SHARED_SKILL_FILE = /^\.agents\/skills\/([^/]+)\//;
+var SHARED_SKILL_MD = /^\.agents\/skills\/([^/]+)\/SKILL\.md$/;
+function sharedSkillIdsOnDisk(projectDir) {
+  const root = join15(projectDir, SHARED_SKILLS_DIR);
+  if (!existsSync14(root)) return /* @__PURE__ */ new Set();
+  return new Set(readdirSync3(root).filter((id) => existsSync14(join15(root, id, "SKILL.md"))));
+}
 function refreshExternalCli(projectDir, harnessRoot) {
   const log = readInstallLog(projectDir);
   const baselineExcluded = new Set(log?.spec.baselineExclude ?? []);
+  const presentBefore = sharedSkillIdsOnDisk(projectDir);
   const result = runCliTransforms({
     harnessRoot,
     projectDir,
-    cli: ALL_CLI_TARGETS,
+    cli: installedCliTargets(log),
     // 스킬은 **디스크에 있는 것만** 넘긴다. 스킬 *파일*은 전체 목록을 넘겨도 refreshOnly 가
     // 없는 것을 건너뛰지만, `AGENTS.md` 의 상시 스킬 안내(ADR-085)는 이 목록 그대로 렌더돼
     // `--without` 으로 뺀 스킬(#505)·opt-in 스킬을 "열어라"고 적었다(실측 2026-09-21). 판정은
@@ -2651,26 +2884,41 @@ function refreshExternalCli(projectDir, harnessRoot) {
     } catch {
     }
   }
+  const priorIds = new Set(
+    (log?.externalFiles ?? []).map((f) => SHARED_SKILL_FILE.exec(f.path)?.[1]).filter(Boolean)
+  );
+  const skillsInstalled = [];
+  const skillsRestored = [];
+  for (const f of result.externalFiles) {
+    const id = SHARED_SKILL_MD.exec(f.path)?.[1];
+    if (id === void 0 || presentBefore.has(id)) continue;
+    const slot = `${SHARED_SKILLS_DIR}/${id}`;
+    const into = priorIds.has(id) ? skillsRestored : skillsInstalled;
+    if (!into.includes(slot)) into.push(slot);
+  }
   return {
     externalUpdated: result.externalUpdated,
     externalBackedUp: result.externalBackedUp,
-    externalForeignOwned: result.externalForeignOwned
+    externalForeignOwned: result.externalForeignOwned,
+    written: result.externalFiles.map((f) => f.path),
+    skillsInstalled,
+    skillsRestored
   };
 }
 function isHarnessOwned2(ctx, rel, current) {
   return isHarnessOwned(ctx.baseline, `${ctx.prefix}/${rel}`, current);
 }
 function updateDir(target, source, ext, ctx, now = /* @__PURE__ */ new Date()) {
-  if (!existsSync13(target) || !existsSync13(source)) return { updated: 0, backedUp: [] };
+  if (!existsSync14(target) || !existsSync14(source)) return { updated: 0, backedUp: [] };
   let updated = 0;
   const backedUp = [];
   for (const file of readdirSync3(target)) {
     if (!file.endsWith(ext)) continue;
-    const targetFile = join12(target, file);
-    const sourceFile = join12(source, file);
-    if (!existsSync13(sourceFile)) continue;
-    const next = readFileSync12(sourceFile, "utf8");
-    const current = readFileSync12(targetFile, "utf8");
+    const targetFile = join15(target, file);
+    const sourceFile = join15(source, file);
+    if (!existsSync14(sourceFile)) continue;
+    const next = readFileSync13(sourceFile, "utf8");
+    const current = readFileSync13(targetFile, "utf8");
     if (current === next) continue;
     if (!isHarnessOwned2(ctx, file, current)) {
       backupFile(targetFile, now);
@@ -2682,7 +2930,7 @@ function updateDir(target, source, ext, ctx, now = /* @__PURE__ */ new Date()) {
   return { updated, backedUp };
 }
 function syncSkills(targetDir, sourceDir, baseline, now = /* @__PURE__ */ new Date(), foreignOf) {
-  if (!existsSync13(targetDir) || !existsSync13(sourceDir))
+  if (!existsSync14(targetDir) || !existsSync14(sourceDir))
     return { updated: 0, backedUp: [], skippedLinks: [], foreignOwned: [], pruned: [] };
   let updated = 0;
   const backedUp = [];
@@ -2691,27 +2939,27 @@ function syncSkills(targetDir, sourceDir, baseline, now = /* @__PURE__ */ new Da
   const pruned = [];
   for (const skill of readdirSync3(sourceDir, { withFileTypes: true })) {
     if (!skill.isDirectory()) continue;
-    const targetSkill = join12(targetDir, skill.name);
+    const targetSkill = join15(targetDir, skill.name);
     if (occupiedByNonDirectory(targetSkill)) {
       skippedLinks.push(skill.name);
       continue;
     }
-    if (!existsSync13(targetSkill)) continue;
-    for (const rel of listFilesRecursive(join12(sourceDir, skill.name))) {
-      const targetFile = join12(targetSkill, rel);
+    if (!existsSync14(targetSkill)) continue;
+    for (const rel of listFilesRecursive(join15(sourceDir, skill.name))) {
+      const targetFile = join15(targetSkill, rel);
       const foreign = foreignOf(`${skill.name}/${rel}`);
       if (foreign !== null) {
         if (!foreignOwned.includes(foreign)) foreignOwned.push(foreign);
         continue;
       }
-      const next = readFileSync12(join12(sourceDir, skill.name, rel), "utf8");
-      if (!existsSync13(targetFile)) {
+      const next = readFileSync13(join15(sourceDir, skill.name, rel), "utf8");
+      if (!existsSync14(targetFile)) {
         mkdirSync3(dirname3(targetFile), { recursive: true });
         writeFileSync5(targetFile, next);
         updated++;
         continue;
       }
-      const current = readFileSync12(targetFile, "utf8");
+      const current = readFileSync13(targetFile, "utf8");
       if (current === next) continue;
       const recorded = baseline.get(`${skill.name}/${rel}`);
       if (recorded === void 0 || hashContent(current) !== recorded) {
@@ -2721,13 +2969,13 @@ function syncSkills(targetDir, sourceDir, baseline, now = /* @__PURE__ */ new Da
       writeFileSync5(targetFile, next);
       updated++;
     }
-    const bundled = new Set(listFilesRecursive(join12(sourceDir, skill.name)));
+    const bundled = new Set(listFilesRecursive(join15(sourceDir, skill.name)));
     for (const rel of listFilesRecursive(targetSkill)) {
       if (bundled.has(rel) || basename4(rel).includes(".backup-")) continue;
       if (foreignOf(`${skill.name}/${rel}`) !== null) continue;
-      const targetFile = join12(targetSkill, rel);
+      const targetFile = join15(targetSkill, rel);
       const recorded = baseline.get(`${skill.name}/${rel}`);
-      if (recorded === void 0 || hashContent(readFileSync12(targetFile, "utf8")) !== recorded) {
+      if (recorded === void 0 || hashContent(readFileSync13(targetFile, "utf8")) !== recorded) {
         backupFile(targetFile, now);
         backedUp.push(`${skill.name}/${rel}`);
       }
@@ -2776,16 +3024,16 @@ function refreshSkillBaseline(projectDir, templatesDir) {
   }
 }
 function pruneOrphans(target, source, ext, ctx, now = /* @__PURE__ */ new Date()) {
-  if (!existsSync13(target) || !existsSync13(source)) return [];
+  if (!existsSync14(target) || !existsSync14(source)) return [];
   const removed = [];
   for (const file of readdirSync3(target)) {
     if (!file.endsWith(ext)) continue;
-    const sourceFile = join12(source, file);
-    if (!existsSync13(sourceFile)) {
-      const targetFile = join12(target, file);
+    const sourceFile = join15(source, file);
+    if (!existsSync14(sourceFile)) {
+      const targetFile = join15(target, file);
       if (!ctx.baseline.has(`${ctx.prefix}/${file}`)) continue;
       try {
-        const current = readFileSync12(targetFile, "utf8");
+        const current = readFileSync13(targetFile, "utf8");
         if (!isHarnessOwned2(ctx, file, current)) backupFile(targetFile, now);
         unlinkSync2(targetFile);
         removed.push(file);
@@ -2796,8 +3044,8 @@ function pruneOrphans(target, source, ext, ctx, now = /* @__PURE__ */ new Date()
   return removed;
 }
 function retireMcpAllowlist(projectDir, now = /* @__PURE__ */ new Date()) {
-  const target = join12(projectDir, ".mcp-allowlist");
-  if (!existsSync13(target)) return null;
+  const target = join15(projectDir, ".mcp-allowlist");
+  if (!existsSync14(target)) return null;
   try {
     const backup = backupFile(target, now);
     unlinkSync2(target);
@@ -2809,7 +3057,7 @@ function retireMcpAllowlist(projectDir, now = /* @__PURE__ */ new Date()) {
 function cleanStaleHookRefs(settingsPath, claudeDir) {
   let settings;
   try {
-    settings = JSON.parse(readFileSync12(settingsPath, "utf8"));
+    settings = JSON.parse(readFileSync13(settingsPath, "utf8"));
   } catch {
     return [];
   }
@@ -2836,7 +3084,7 @@ function cleanStaleHookRefs(settingsPath, claudeDir) {
 function keepHookRef(hook, claudeDir, removed) {
   const relPath = projectAnchoredRef(hook?.command ?? "", claudeDir);
   if (relPath === void 0) return true;
-  const exists = existsSync13(join12(claudeDir, relPath));
+  const exists = existsSync14(join15(claudeDir, relPath));
   if (!exists && !removed.includes(relPath)) removed.push(relPath);
   return exists;
 }
@@ -2858,31 +3106,47 @@ function projectAnchoredRef(command, claudeDir) {
   }
   return void 0;
 }
+function recordClaudeCommand(log, tracks) {
+  const trackArgs = (tracks.length > 0 ? tracks : log.spec.tracks).map((t) => `--track ${t}`);
+  return `agent-harness install ${trackArgs.join(" ")} --cli claude --scope ${log.scope}`.replace(
+    /\s+/g,
+    " "
+  );
+}
 
 // src/installer.ts
 function runInstall(ctx) {
   const { harnessRoot, projectDir, spec } = ctx;
   const mode = ctx.mode ?? "fresh";
-  const templatesDir = join13(harnessRoot, "templates");
-  if (!existsSync14(templatesDir)) {
+  const templatesDir = join16(harnessRoot, "templates");
+  if (!existsSync15(templatesDir)) {
     throw new Error(`Templates dir not found: ${templatesDir}`);
   }
-  const claudeDir = join13(projectDir, ".claude");
+  const claudeDir = join16(projectDir, ".claude");
   const previousLog = readInstallLog(projectDir);
-  const claudeWasSelected = previousLog?.spec.cli.includes("claude") ?? false;
-  if (mode === "update" && !existsSync14(claudeDir) && (previousLog === null || claudeWasSelected)) {
+  const claudeWasSelected = previousLog !== null && installedClis(previousLog).includes("claude");
+  if (mode === "update" && !existsSync15(claudeDir) && (previousLog === null || claudeWasSelected)) {
     throw new Error(
       claudeWasSelected ? `Update mode found a broken install at ${projectDir} \u2014 this project installed Claude Code assets but \`.claude/\` is gone. Reinstall instead: agent-harness install --track <name>` : `Update mode requires an existing install at ${projectDir}`
     );
   }
-  const backupPath = resolveBackupPath(ctx, mode, claudeDir);
+  const backupPath = resolveBackupPath(ctx, mode, claudeDir, previousLog);
   if (mode === "update") {
     return runUpdateInstall(ctx, templatesDir, backupPath);
   }
   const manifestSpec = buildManifestSpec(spec);
   const policyBase = new Map((previousLog?.policyFiles ?? []).map((f) => [f.path, f.sha256]));
+  const skillBase = new Map((previousLog?.skillFiles ?? []).map((f) => [f.path, f.sha256]));
   const baselineExcluded = new Set(spec.baselineExclude ?? []);
-  const base = spec.cli.includes("claude") ? installClaudeBaseline(manifestSpec, projectDir, templatesDir, policyBase, baselineExcluded) : (
+  const base = spec.cli.includes("claude") ? installClaudeBaseline(
+    manifestSpec,
+    projectDir,
+    templatesDir,
+    policyBase,
+    skillBase,
+    baselineExcluded,
+    harnessRoot
+  ) : (
     // claude 미선택이어도 CLI 중립 자산은 깔린다. manifest 전체가 `.claude/` baseline 안에서만
     // 돌던 탓에 이 자산들이 claude 설치에만 도달했는데, **배포 룰 본문이 이 스크립트들을
     // 호출 지점으로 지목한다** — 즉 없는 도구를 있다고 안내하고 있었다(#300 과 같은 형태).
@@ -2914,6 +3178,17 @@ function runInstall(ctx) {
     previousExternal: previousLog?.externalFiles ?? [],
     codexTrust: (spec.scope ?? "project") === "global" && spec.options.withCodexTrust
   });
+  const linked = refreshLinkedSkillBodies({
+    harnessRoot,
+    projectDir,
+    ids: base.linkedSkills,
+    baseline: new Map(
+      mergeExternalFiles(projectDir, previousLog?.externalFiles, externalFiles).map((f) => [
+        f.path,
+        f.sha256
+      ])
+    )
+  });
   const baseline = {
     filesCopied: base.filesCopied,
     dirsCopied: base.dirsCopied,
@@ -2930,21 +3205,23 @@ function runInstall(ctx) {
     rootClaudeMd: base.rootClaudeMd,
     // 외부 CLI 백업도 같은 줄에 노출한다 — 백업이 화면에 안 보이면 사용자는 자기 편집분이
     // 어디 갔는지 알 수 없고, 그러면 백업은 있어도 없는 것과 같다 (ADR-046/047 과 같은 이유).
-    backups: [...base.backups, ...externalBackups],
+    backups: [...base.backups, ...externalBackups, ...linked.backupPaths],
     baselineExcluded: base.excluded,
     baselineExcludedOnDisk: base.excludedOnDisk,
     // `.claude/` baseline 과 외부 CLI 산출물의 같은 판정을 **한 목록으로** 낸다.
     baselineForeignOwned: [
-      ...base.foreignOwned,
-      ...externalForeignOwned.filter((f) => !base.foreignOwned.includes(f))
-    ]
+      .../* @__PURE__ */ new Set([...base.foreignOwned, ...externalForeignOwned, ...linked.foreignOwned])
+    ],
+    baselineLinked: linked.updated,
+    baselineLinkedNotOurs: linked.notOurs
   };
   ctx.onProgress?.({ type: "baseline-complete", baseline });
   const external = runExternalPhase(ctx);
   const staleHookRefs = healStaleHookRefs(spec, projectDir);
   writeInstallLogSafe(
     ctx,
-    externalFiles,
+    // 링크 본문의 기준선도 같은 필드다 — 같은 경로면 뒤(이번에 쓴 값)가 이긴다.
+    [...externalFiles, ...linked.files],
     external,
     base.rootClaudeMdLog,
     previousLog,
@@ -2955,12 +3232,13 @@ function runInstall(ctx) {
 }
 function healStaleHookRefs(spec, projectDir) {
   if (!spec.cli.includes("claude")) return [];
-  const settingsPath = join13(projectDir, ".claude/settings.json");
-  if (!existsSync14(settingsPath)) return [];
-  return cleanStaleHookRefs(settingsPath, join13(projectDir, ".claude"));
+  const settingsPath = join16(projectDir, ".claude/settings.json");
+  if (!existsSync15(settingsPath)) return [];
+  return cleanStaleHookRefs(settingsPath, join16(projectDir, ".claude"));
 }
-function resolveBackupPath(ctx, mode, claudeDir) {
-  const wantBackup = ctx.backup ?? (mode === "update" || mode === "reinstall");
+function resolveBackupPath(ctx, mode, claudeDir, previousLog) {
+  const claudeUntouched = previousLog !== null && !installedClis(previousLog).includes("claude");
+  const wantBackup = ctx.backup ?? (mode === "reinstall" || mode === "update" && !claudeUntouched);
   if (!wantBackup) return null;
   return mode === "update" ? copyBackupDir(claudeDir) : backupDir(claudeDir);
 }
@@ -3017,7 +3295,8 @@ function emptyClaudeBaseline() {
     backups: [],
     excluded: [],
     excludedOnDisk: [],
-    foreignOwned: []
+    foreignOwned: [],
+    linkedSkills: []
   };
 }
 function installCliNeutralAssets(manifestSpec, projectDir, templatesDir, baselineExcluded) {
@@ -3029,12 +3308,12 @@ function installCliNeutralAssets(manifestSpec, projectDir, templatesDir, baselin
       continue;
     }
     if (!isCliNeutralTarget(entry.target)) continue;
-    const source = join13(templatesDir, entry.source);
-    if (!existsSync14(source)) {
+    const source = join16(templatesDir, entry.source);
+    if (!existsSync15(source)) {
       result.skipped += 1;
       continue;
     }
-    copyFile(source, join13(projectDir, entry.target));
+    copyFile(source, join16(projectDir, entry.target));
     result.filesCopied += 1;
   }
   return result;
@@ -3046,14 +3325,28 @@ function backupEditedPolicyFile(entryTarget, target, source, baseline) {
   if (!POLICY_DIRS.some(({ dir, ext }) => rel.startsWith(`${dir}/`) && rel.endsWith(ext))) {
     return null;
   }
-  if (!existsSync14(target)) return null;
-  const current = readFileSync13(target, "utf-8");
-  if (current === readFileSync13(source, "utf-8")) return null;
+  if (!existsSync15(target)) return null;
+  const current = readFileSync14(target, "utf-8");
+  if (current === readFileSync14(source, "utf-8")) return null;
   const recorded = baseline.get(rel);
   if (recorded !== void 0 && recorded === hashContent(current)) return null;
   return backupFile(target);
 }
-function installClaudeBaseline(manifestSpec, projectDir, templatesDir, policyBase, baselineExcluded) {
+function backupEditedSkillFiles(projectDir, entryTarget, source, baseline) {
+  const id = entryTarget.slice(".claude/skills/".length);
+  const backups = [];
+  for (const rel of listFilesRecursive(source)) {
+    if (foreignOwnedTarget(projectDir, `${entryTarget}/${rel}`) !== null) continue;
+    const target = join16(projectDir, entryTarget, rel);
+    if (!existsSync15(target)) continue;
+    const current = readFileSync14(target, "utf-8");
+    if (current === readFileSync14(join16(source, rel), "utf-8")) continue;
+    if (isHarnessOwned(baseline, `${id}/${rel}`, current)) continue;
+    backups.push(backupFile(target));
+  }
+  return backups;
+}
+function installClaudeBaseline(manifestSpec, projectDir, templatesDir, policyBase, skillBase, baselineExcluded, harnessRoot) {
   ensureProjectSkeleton(projectDir);
   const result = emptyClaudeBaseline();
   const manifest = buildManifest(manifestSpec);
@@ -3061,17 +3354,22 @@ function installClaudeBaseline(manifestSpec, projectDir, templatesDir, policyBas
     if (!entry.applies(manifestSpec)) {
       continue;
     }
-    const target = join13(projectDir, entry.target);
+    const target = join16(projectDir, entry.target);
     if (isBaselineExcluded(entry.target, baselineExcluded)) {
       result.excluded.push(entry.target);
-      if (existsSync14(target)) result.excludedOnDisk.push(entry.target);
+      if (existsSync15(target)) result.excludedOnDisk.push(entry.target);
       continue;
     }
-    const source = join13(templatesDir, entry.source);
-    if (!existsSync14(source)) {
+    const source = join16(templatesDir, entry.source);
+    if (!existsSync15(source)) {
       result.skipped += 1;
       continue;
     }
+    const skillId = entry.target.slice(".claude/skills/".length);
+    if (entry.type === "dir" && linksToProjectSharedSkill(projectDir, skillId)) {
+      result.linkedSkills.push(skillId);
+      continue;
+    }
     const foreign = foreignOwnedTarget(projectDir, entry.target);
     if (foreign !== null) {
       if (!result.foreignOwned.includes(foreign)) result.foreignOwned.push(foreign);
@@ -3079,7 +3377,7 @@ function installClaudeBaseline(manifestSpec, projectDir, templatesDir, policyBas
     }
     if (entry.type === "file") {
       if (entry.target === ".claude/settings.json") {
-        const backup = backupFileIfChanged(target, readFileSync13(source, "utf-8"));
+        const backup = backupFileIfChanged(target, readFileSync14(source, "utf-8"));
         if (backup) {
           result.backups.push(backup);
         }
@@ -3092,6 +3390,7 @@ function installClaudeBaseline(manifestSpec, projectDir, templatesDir, policyBas
       copyFile(source, target);
       result.filesCopied += 1;
     } else {
+      result.backups.push(...backupEditedSkillFiles(projectDir, entry.target, source, skillBase));
       for (const foreign2 of copyDir(
         source,
         target,
@@ -3103,24 +3402,29 @@ function installClaudeBaseline(manifestSpec, projectDir, templatesDir, policyBas
     }
     accumulateCategory(result.categories, entry);
   }
-  const hookDir = join13(projectDir, ".claude/hooks");
-  if (existsSync14(hookDir)) {
+  const hookDir = join16(projectDir, ".claude/hooks");
+  if (existsSync15(hookDir)) {
     chmodHooksSync(hookDir);
   }
   writeInstalledTracks(projectDir, manifestSpec.tracks);
   const rootClaudeMd = writeRootClaudeMd(
     projectDir,
     manifestSpec.tracks,
-    manifestSpec.selectedInternalSkills ?? []
+    manifestSpec.selectedInternalSkills ?? [],
+    harnessRoot
   );
-  result.rootClaudeMd = { tracks: manifestSpec.tracks, created: rootClaudeMd.created };
+  result.rootClaudeMd = {
+    tracks: manifestSpec.tracks,
+    created: rootClaudeMd.created,
+    seededFrom: rootClaudeMd.seededFrom
+  };
   result.rootClaudeMdLog = harnessAnchorLog(projectDir);
   return result;
 }
 function harnessAnchorLog(projectDir) {
-  const anchor = join13(projectDir, HARNESS_ANCHOR_FILE);
-  if (!existsSync14(anchor)) return null;
-  return { path: HARNESS_ANCHOR_FILE, sha256: hashContent(readFileSync13(anchor, "utf-8")) };
+  const anchor = join16(projectDir, HARNESS_ANCHOR_FILE);
+  if (!existsSync15(anchor)) return null;
+  return { path: HARNESS_ANCHOR_FILE, sha256: hashContent(readFileSync14(anchor, "utf-8")) };
 }
 function writeEnvironmentFiles(projectDir, tracks) {
   return {
@@ -3177,8 +3481,9 @@ function writeInstallLogSafe(ctx, externalFiles, external, rootClaudeMdLog, prev
       claudeDirMovedAside,
       rootFiles
     );
-    const skillFiles = collectSkillHashes(ctx.projectDir, join13(ctx.harnessRoot, "templates"));
-    const policyFiles = collectPolicyHashes(ctx.projectDir, join13(ctx.harnessRoot, "templates"));
+    const claudeInstalled = (log.spec.clis ?? []).includes("claude");
+    const skillFiles = claudeInstalled ? collectSkillHashes(ctx.projectDir, join16(ctx.harnessRoot, "templates")) : [];
+    const policyFiles = claudeInstalled ? collectPolicyHashes(ctx.projectDir, join16(ctx.harnessRoot, "templates")) : [];
     const merged = mergeExternalFiles(ctx.projectDir, previousLog?.externalFiles, externalFiles);
     writeInstallLog(ctx.projectDir, {
       ...log,
@@ -3194,11 +3499,11 @@ function writeInstallLogSafe(ctx, externalFiles, external, rootClaudeMdLog, prev
   }
 }
 function composeAndWriteMcp(harnessRoot, projectDir, spec) {
-  const mcpPath = join13(projectDir, ".mcp.json");
-  const created = !existsSync14(mcpPath);
+  const mcpPath = join16(projectDir, ".mcp.json");
+  const created = !existsSync15(mcpPath);
   const composed = composeMcpJson({
-    templateMcpPath: join13(harnessRoot, "templates/mcp.json"),
-    trackMapPath: join13(harnessRoot, "templates/track-mcp-map.tsv"),
+    templateMcpPath: join16(harnessRoot, "templates/mcp.json"),
+    trackMapPath: join16(harnessRoot, "templates/track-mcp-map.tsv"),
     existingPath: mcpPath,
     tracks: spec.tracks
   });
@@ -3251,24 +3556,26 @@ function accumulateCategory(cats, entry) {
   }
 }
 function writeInstalledTracks(projectDir, tracks) {
-  const path = join13(projectDir, ".claude/.installed-tracks");
+  const path = join16(projectDir, ".claude/.installed-tracks");
   mkdirSync4(dirname4(path), { recursive: true });
   const sorted = [...new Set(tracks)].sort().join("\n");
   writeFileSync6(path, `${sorted}
 `);
 }
-function writeRootClaudeMd(projectDir, tracks, continuousSkills) {
-  const target = join13(projectDir, "CLAUDE.md");
-  const existing = existsSync14(target) ? readFileSync13(target, "utf-8") : null;
+function writeRootClaudeMd(projectDir, tracks, continuousSkills, harnessRoot) {
+  const target = join16(projectDir, "CLAUDE.md");
+  const existing = existsSync15(target) ? readFileSync14(target, "utf-8") : null;
+  const seeded = existing === null ? seedRootClaudeProjectContext(projectDir, harnessRoot) : null;
   const content = upsertHarnessImport(existing, {
     projectName: basename5(projectDir),
     tracks,
-    continuousSkills
+    continuousSkills,
+    ...seeded === null ? {} : { projectContext: seeded }
   });
   if (content !== existing) {
     writeFileSync6(target, content);
   }
-  return { created: existing === null };
+  return { created: existing === null, seededFrom: seeded === null ? null : "AGENTS.md" };
 }
 function chmodHooksSync(hookDir) {
   for (const file of listHookFiles(hookDir)) {
@@ -3284,8 +3591,8 @@ function listHookFiles(hookDir) {
 
 // src/commands/install-render.ts
 init_esm_shims();
-import { existsSync as existsSync15, readdirSync as readdirSync5 } from "fs";
-import { join as join14 } from "path";
+import { existsSync as existsSync16, readdirSync as readdirSync5 } from "fs";
+import { join as join17 } from "path";
 
 // src/preset-recommend.ts
 init_esm_shims();
@@ -3453,13 +3760,13 @@ function renderUpdateSummary(log, spec, report) {
 function residentEntriesOnDisk(spec) {
   const assetSpec = buildManifestSpec(spec);
   const planned = buildManifest(assetSpec).filter((e2) => e2.applies(assetSpec));
-  const agentsDir = join14(spec.projectDir, ".claude", "agents");
-  const onDisk = existsSync15(agentsDir) ? readdirSync5(agentsDir, { withFileTypes: true }).filter((e2) => e2.isFile() && e2.name.endsWith(".md")).map((e2) => ({
+  const agentsDir = join17(spec.projectDir, ".claude", "agents");
+  const onDisk = existsSync16(agentsDir) ? readdirSync5(agentsDir, { withFileTypes: true }).filter((e2) => e2.isFile() && e2.name.endsWith(".md")).map((e2) => ({
     source: `agents/${e2.name}`,
     target: `.claude/agents/${e2.name}`,
     // 배포판이 아니라 **이 프로젝트의 파일**을 잰다 — 사용자가 고친 descriptor 도,
     // 배포판에 더는 없는 에이전트도 실제로 상주하는 것은 이쪽이다.
-    file: join14(agentsDir, e2.name)
+    file: join17(agentsDir, e2.name)
   })) : [];
   return [...planned.filter((e2) => !e2.target.startsWith(".claude/agents/")), ...onDisk];
 }
@@ -3476,6 +3783,16 @@ function renderCliArtifacts(log, spec, report) {
   } else if (report.codex || report.opencode) {
     log(assetRow("success", "AGENTS.md", `from ${HARNESS_ANCHOR_FILE}`));
   }
+  const agentsSeededFrom = report.codex?.agentsMdSeededFrom ?? report.opencode?.agentsMdSeededFrom ?? null;
+  if (agentsSeededFrom) {
+    log(
+      assetRow(
+        "success",
+        "AGENTS.md",
+        `Project Context seeded from ${agentsSeededFrom} \xB7 CLI \uACE0\uC720 \uD45C\uD604\uC740 audit-harness-fit \uC73C\uB85C \uB9DE\uCD98\uB2E4`
+      )
+    );
+  }
   if (report.codex) {
     log(assetRow("success", ".codex/config.toml", "settings + [mcp_servers.*]"));
     log(assetRow("success", ".codex/hooks/", `${report.codex.hookFiles.length} files`));
@@ -3637,6 +3954,20 @@ function formatAssetMeta(asset, version) {
       return `internal \xB7 templates (${m.key})`;
   }
 }
+function linkedSkillRows(log, updated, notOurs) {
+  for (const id of updated) {
+    log(assetRow("success", `.claude/skills/${id}`, `linked \xB7 updated via .agents/skills/${id}`));
+  }
+  for (const id of notOurs) {
+    log(
+      assetRow(
+        "skip",
+        `.claude/skills/${id}`,
+        `linked \xB7 not ours \u2014 .agents/skills/${id} \uB294 \uC774 \uD558\uB124\uC2A4\uAC00 \uC4F4 \uAE30\uB85D\uC774 \uC5C6\uC5B4 \uAC74\uB4DC\uB9AC\uC9C0 \uC54A\uC558\uB2E4`
+      )
+    );
+  }
+}
 function renderPhase1Rows(log, baseline, verbose = false) {
   if (baseline.updateMode) {
     if (baseline.backup) {
@@ -3648,8 +3979,30 @@ function renderPhase1Rows(log, baseline, verbose = false) {
     for (const path of baseline.updateMode.installedNew) {
       log(assetRow("success", path, "added by this release"));
     }
+    const withoutArgs = [];
     for (const path of baseline.updateMode.restored) {
-      log(assetRow("success", path, "was missing \u2014 reinstalled (delete it again if intentional)"));
+      const arg = baseline.updateMode.restoredWithout?.[path];
+      if (arg === void 0) {
+        log(
+          assetRow(
+            "success",
+            path,
+            "was missing \u2014 reinstalled (harness-managed \u2014 update always restores it)"
+          )
+        );
+        continue;
+      }
+      log(assetRow("success", path, "was missing \u2014 reinstalled"));
+      if (!withoutArgs.includes(arg)) withoutArgs.push(arg);
+    }
+    if (withoutArgs.length > 0) {
+      log(
+        assetRow(
+          "skip",
+          "to keep it out",
+          `deleting is undone by the next update \u2014 re-run \`agent-harness install\` with your usual flags plus ${withoutArgs.map((a) => `--without ${a}`).join(" ")}, then delete it again`
+        )
+      );
     }
     if (baseline.updateMode.needsReinstall.length > 0) {
       log(
@@ -3701,6 +4054,15 @@ function renderPhase1Rows(log, baseline, verbose = false) {
         )
       );
     }
+    if (baseline.updateMode.claudeUnrecorded) {
+      log(
+        assetRow(
+          "skip",
+          ".claude/",
+          `present but not recorded as installed \u2014 left untouched. If its rules/ \xB7 agents/ \xB7 hooks/ \xB7 skills/ came from this tool (you did not write them), run \`${baseline.updateMode.claudeUnrecorded}\` once to re-record them and updates resume; otherwise this directory is yours`
+        )
+      );
+    }
     if (baseline.updateMode.legacyAnchor) {
       log(
         assetRow(
@@ -3728,6 +4090,11 @@ function renderPhase1Rows(log, baseline, verbose = false) {
         )
       );
     }
+    linkedSkillRows(
+      log,
+      baseline.updateMode.skillsLinked ?? [],
+      baseline.updateMode.skillsLinkedNotOurs ?? []
+    );
     if (baseline.updateMode.skillsSkippedLinks.length > 0) {
       log(
         assetRow(
@@ -3934,6 +4301,7 @@ function renderPhase1Rows(log, baseline, verbose = false) {
       )
     );
   }
+  linkedSkillRows(log, baseline.baselineLinked ?? [], baseline.baselineLinkedNotOurs ?? []);
   if (baseline.baselineForeignOwned.length > 0) {
     log(
       assetRow(
@@ -3950,7 +4318,7 @@ function renderPhase1Rows(log, baseline, verbose = false) {
       assetRow(
         "success",
         "CLAUDE.md (root)",
-        baseline.rootClaudeMd.created ? `fill-in scaffold + @import \xB7 ${n} track${n > 1 ? "s" : ""} noted` : `@import ${HARNESS_ANCHOR_FILE} (body preserved)`,
+        rootClaudeMdMeta(baseline.rootClaudeMd, n),
         TEMPLATES_COL
       )
     );
@@ -4017,6 +4385,14 @@ function shortenPath(p2) {
   }
   return p2;
 }
+function rootClaudeMdMeta(root, trackCount) {
+  const tracks = `${trackCount} track${trackCount > 1 ? "s" : ""} noted`;
+  if (!root.created) return `@import ${HARNESS_ANCHOR_FILE} (body preserved)`;
+  if (root.seededFrom) {
+    return `Project Context seeded from ${root.seededFrom} + @import \xB7 ${tracks} \xB7 CLI \uACE0\uC720 \uD45C\uD604\uC740 audit-harness-fit \uC73C\uB85C \uB9DE\uCD98\uB2E4`;
+  }
+  return `fill-in scaffold + @import \xB7 ${tracks}`;
+}
 function formatCliPhaseTitle(targets) {
   const labels = [];
   if (targets.includes("codex")) labels.push("Codex");
@@ -4078,6 +4454,18 @@ function installAction(options, deps = {}) {
     exit(1);
     return;
   }
+  const spec = installSpecFromOptions(options, validated.cli, err);
+  executeSpec(spec, {
+    log,
+    err,
+    exit,
+    runPipeline,
+    resolveHarnessRoot,
+    verbose: options.verbose === true,
+    ...options.reinstall === true ? { mode: "reinstall" } : {}
+  });
+}
+function installSpecFromOptions(options, cli2, err) {
   const forceInclude = normalizeRepeatable(options.with);
   const forceExclude = normalizeRepeatable(options.without);
   const baselineIds = new Set(
@@ -4104,7 +4492,7 @@ function installAction(options, deps = {}) {
   const filteredInclude = forceInclude.filter((id) => validIds.has(id));
   const filteredExclude = forceExclude.filter((id) => validIds.has(id));
   const userOverride = filteredInclude.length > 0 || filteredExclude.length > 0 ? { forceInclude: filteredInclude, forceExclude: filteredExclude } : void 0;
-  const spec = {
+  return {
     tracks: options.track ?? [],
     ...userOverride ? { userOverride } : {},
     ...baselineExclude.length > 0 ? { baselineExclude } : {},
@@ -4113,18 +4501,21 @@ function installAction(options, deps = {}) {
     options: {
       withCodexTrust: options.withCodexTrust === true
     },
-    cli: validated.cli,
+    cli: cli2,
     projectDir: resolve2(options.projectDir ?? process.cwd()),
     scope: resolveScopeOption(options.scope, err)
   };
-  executeSpec(spec, {
-    log,
-    err,
-    exit,
-    runPipeline,
-    resolveHarnessRoot,
-    verbose: options.verbose === true
-  });
+}
+function installCommandLine(options) {
+  const repeat = (flag, value) => normalizeRepeatable(value).map((v2) => `${flag} ${v2}`);
+  return [
+    "agent-harness install",
+    ...repeat("--track", options.track),
+    ...repeat("--cli", options.cli),
+    ...options.scope ? [`--scope ${options.scope}`] : [],
+    ...repeat("--with", options.with),
+    ...repeat("--without", options.without)
+  ].join(" ");
 }
 function executeSpec(spec, deps = {}) {
   const log = deps.log ?? console.log;
@@ -4206,13 +4597,16 @@ function registerInstallCommand(cli2) {
   ).option(
     "--with-codex-trust",
     "[Codex] Codex global opt-in: register trust entry in ~/.codex/config.toml"
+  ).option(
+    "--reinstall",
+    "[Mode] Move .claude/ aside as .claude.backup-<ts> and rebuild it \u2014 use when .claude/ is damaged or missing"
   ).option("--verbose", "[Misc] Show installed file lists per category (default: counts only)").example("install --track tooling --with marketingskills").example("install --track csr-supabase --cli claude --cli codex").example("install --track csr-supabase --without netlify-cli --with railway-skills").action((options) => installAction(options));
 }
 
 // src/commands/list.ts
 init_esm_shims();
-import { existsSync as existsSync16, readFileSync as readFileSync14 } from "fs";
-import { join as join15, resolve as resolve3 } from "path";
+import { existsSync as existsSync17, readFileSync as readFileSync15 } from "fs";
+import { join as join18, resolve as resolve3 } from "path";
 function listAction(options = {}, deps = {}) {
   const log = deps.log ?? console.log;
   const err = deps.err ?? console.error;
@@ -4231,7 +4625,7 @@ function listAction(options = {}, deps = {}) {
   log(c.dim(`  installed: ${installLog.installedAt}`));
   log(c.dim(`  scope:     ${installLog.scope}`));
   log(c.dim(`  tracks:    ${installLog.spec.tracks.join(", ") || "(none)"}`));
-  log(c.dim(`  cli:       ${installLog.spec.cli.join(", ") || "(none)"}`));
+  log(c.dim(`  cli:       ${installedClis(installLog).join(", ") || "(none)"}`));
   log("");
   log(c.bold(`  Assets (${installLog.assets.length})`));
   if (installLog.assets.length === 0) {
@@ -4275,8 +4669,8 @@ function formatTemplateRows(log, projectDir) {
   const rows = [`    ${c.dim(dirs.join("  "))}`];
   const rootMd = log.templates.rootClaudeMd;
   if (rootMd) {
-    const path = join15(projectDir, rootMd.path);
-    const modified = existsSync16(path) && hashContent(readFileSync14(path, "utf8")) !== rootMd.sha256;
+    const path = join18(projectDir, rootMd.path);
+    const modified = existsSync17(path) && hashContent(readFileSync15(path, "utf8")) !== rootMd.sha256;
     rows.push(
       modified ? `    ${c.dim(rootMd.path)}  ${c.yellow("(\uC218\uC815\uB428 \u2014 uninstall \uC2DC \uBCF4\uC874)")}` : `    ${c.dim(rootMd.path)}`
     );
@@ -4284,7 +4678,7 @@ function formatTemplateRows(log, projectDir) {
   return rows;
 }
 function formatRootFileRows(rootFiles, projectDir) {
-  const present = rootFiles.filter((f) => existsSync16(join15(projectDir, f.path)));
+  const present = rootFiles.filter((f) => existsSync17(join18(projectDir, f.path)));
   const width = Math.max(0, ...present.map((f) => f.path.length));
   return present.map(
     (f) => `    ${c.dim(padDisplay(f.path, width))}  ${c.dim(f.change === "created" ? "\uC0DD\uC131" : "\uBCD1\uD569")}  ${c.dim(f.notes.join(" / "))}`
@@ -4302,15 +4696,64 @@ function registerListCommand(cli2) {
 init_esm_shims();
 import { spawnSync as spawnSync2 } from "child_process";
 import {
-  existsSync as existsSync17,
+  existsSync as existsSync18,
   lstatSync as lstatSync2,
   readdirSync as readdirSync6,
-  readFileSync as readFileSync15,
+  readFileSync as readFileSync16,
   rmdirSync as rmdirSync2,
   rmSync,
   writeFileSync as writeFileSync7
 } from "fs";
-import { dirname as dirname5, join as join16, relative as relative2, resolve as resolve4, sep as sep2 } from "path";
+import { dirname as dirname5, join as join19, relative as relative2, resolve as resolve4, sep as sep3 } from "path";
+
+// src/cli-ownership.ts
+init_esm_shims();
+var SHARED_BY_ALL = (self) => [
+  { path: ".mcp.json", kind: "keep", sharedWith: CLI_BASES.filter((c3) => c3 !== self) },
+  {
+    path: `${INSTALL_LOG_DIR}/`,
+    kind: "keep",
+    sharedWith: CLI_BASES.filter((c3) => c3 !== self)
+  }
+];
+var CLI_OWNERSHIP = {
+  claude: [
+    { path: ".claude/", kind: "dir", sharedWith: [] },
+    { path: HARNESS_ANCHOR_FILE, kind: "anchor", sharedWith: [] },
+    { path: "CLAUDE.md", kind: "import-block", sharedWith: [] },
+    ...SHARED_BY_ALL("claude")
+  ],
+  codex: [
+    { path: ".codex/", kind: "dir", sharedWith: [] },
+    { path: "AGENTS.md", kind: "recorded", sharedWith: ["opencode"] },
+    { path: ".agents/skills/", kind: "recorded", sharedWith: ["opencode", "antigravity"] },
+    ...SHARED_BY_ALL("codex")
+  ],
+  opencode: [
+    { path: ".opencode/", kind: "dir", sharedWith: [] },
+    { path: "opencode.json", kind: "recorded", sharedWith: [] },
+    { path: "AGENTS.md", kind: "recorded", sharedWith: ["codex"] },
+    { path: ".agents/skills/", kind: "recorded", sharedWith: ["codex", "antigravity"] },
+    ...SHARED_BY_ALL("opencode")
+  ],
+  antigravity: [
+    { path: ".agents/rules/uzys-harness.md", kind: "recorded", sharedWith: [] },
+    { path: ".agents/skills/", kind: "recorded", sharedWith: ["codex", "opencode"] },
+    ...SHARED_BY_ALL("antigravity")
+  ]
+};
+function removableFor(cli2, remaining) {
+  const others = remaining.filter((c3) => c3 !== cli2);
+  const stillUsed = new Set(others.flatMap((c3) => CLI_OWNERSHIP[c3].map((p2) => p2.path)));
+  const exclusive = [];
+  const sharedNowUnowned = [];
+  for (const owned of CLI_OWNERSHIP[cli2]) {
+    if (owned.kind === "keep") continue;
+    if (owned.sharedWith.length === 0) exclusive.push(owned);
+    else if (!stillUsed.has(owned.path)) sharedNowUnowned.push(owned);
+  }
+  return { exclusive, sharedNowUnowned };
+}
 
 // src/uninstall-interactive.ts
 init_esm_shims();
@@ -5285,109 +5728,605 @@ ${a}
 };
 var jt = `${e("gray", $)}  `;
 
-// src/uninstall-interactive.ts
-function buildRemovableRows(assets) {
-  return assets.map((a) => ({
-    value: a.id,
-    label: `${a.id}  [${a.method}]${a.version ? ` v${a.version}` : ""}`,
-    hint: hintFor(a)
-  }));
+// src/prompts.ts
+init_esm_shims();
+
+// src/router.ts
+init_esm_shims();
+var NO_RECORD = { clis: null, scope: null, repair: null };
+function buildInstallRecordView(state, log, claudeDirExists) {
+  if (log === null) return NO_RECORD;
+  const clis = installedClis(log);
+  const broken = clis.includes("claude") && !claudeDirExists;
+  return {
+    clis,
+    scope: log.scope,
+    repair: broken ? repairCommand(log, state.tracks) : null
+  };
 }
-function hintFor(asset) {
-  if (asset.scope === "global") return "global scope \u2014 \uC790\uB3D9 \uC0AD\uC81C \uC548 \uD568, \uC218\uAE30 \uC81C\uAC70 \uBA85\uB839\uC744 \uCD9C\uB825\uD55C\uB2E4";
-  switch (asset.method) {
-    case "plugin":
-      return "claude plugin uninstall --scope project";
-    case "skill":
-      return "npx skills remove";
-    case "npm":
-      return "npm uninstall --save-dev";
-    case "npx-run":
-    // shell-script = #492 에서 은퇴한 legacy kind. 옛 로그가 그대로 들어온다.
-    case "shell-script":
-    case "internal":
-      return "\uC790\uB3D9 \uB418\uB3CC\uB9AC\uAE30 \uACBD\uB85C \uC5C6\uC74C \u2014 \uC804\uB7C9 \uC81C\uAC70(`.claude/` \uC0AD\uC81C)\uB85C\uB9CC \uC0AC\uB77C\uC9C4\uB2E4";
-  }
+function repairCommand(log, detected) {
+  const recorded = log.spec.tracks.filter(isTrack);
+  const tracks = recorded.length > 0 ? recorded : detected;
+  const trackArgs = tracks.map((t) => `--track ${t}`).join(" ");
+  return `agent-harness install --reinstall ${trackArgs} --cli claude --scope ${log.scope}`;
+}
+function describeInstall(state, record = NO_RECORD) {
+  const tracks = state.tracks.length > 0 ? state.tracks.join(", ") : "(none detected)";
+  if (record.clis === null) return `Installed here (no record): tracks ${tracks} \xB7 CLI unknown`;
+  const clis = record.clis.length > 0 ? record.clis.join(", ") : "(none)";
+  const head = `Installed here: tracks ${tracks} \xB7 CLI ${clis} \xB7 scope ${record.scope}   (record: ${INSTALL_LOG_DIR}/${INSTALL_LOG_FILENAME})`;
+  if (record.repair === null) return head;
+  return [
+    head,
+    "\u26A0 .claude/ is missing but the record says Claude Code is installed. Update cannot rebuild it.",
+    `  Repair: ${record.repair}`
+  ].join("\n");
 }
-async function runInteractiveUninstall(projectDir, deps = {}) {
-  const prompts = deps.prompts ?? defaultUninstallPrompts();
-  const isTty = deps.isTty ?? (() => Boolean(process.stdin.isTTY));
-  const readLog = deps.readLog ?? readInstallLog;
-  if (!isTty()) return { ok: false, reason: "no-tty" };
-  const log = readLog(projectDir);
-  if (!log) return { ok: false, reason: "no-log" };
-  prompts.intro("uzys-agent-harness \xB7 uninstall");
-  const rows = buildRemovableRows(log.assets);
-  const mode = await prompts.selectMode(rows.length);
-  if (mode === null) {
-    prompts.cancel("Cancelled.");
-    return { ok: false, reason: "cancelled" };
+function buildRouterChoices(_state, record = NO_RECORD) {
+  const broken = typeof record.repair === "string";
+  return [
+    {
+      value: "update",
+      label: "Update",
+      // 이 hint 가 update 동작의 광고다 — 갱신 대상(rules/agents/commands/hooks/skills)과 편집분
+      // 백업을 빠뜨리면 거짓출하가 된다(R-3a · `tests/render-hint-parity.test.ts` 가 derive 로 문다).
+      hint: broken ? ".claude/ missing \u2014 run the repair command above" : "bring installed rules / agents / commands / hooks / skills to this release; add tracks, CLIs or assets on the way \u2014 nothing is removed here, your edits are backed up as *.backup-<time>",
+      enabled: !broken
+    },
+    {
+      value: "uninstall",
+      label: "Uninstall",
+      hint: "remove everything, one CLI, or single assets",
+      enabled: true
+    },
+    {
+      value: "exit",
+      label: "Exit",
+      enabled: true
+    }
+  ];
+}
+
+// src/wizard-steps.ts
+init_esm_shims();
+var WIZARD_TOTAL = 6;
+var WIZARD = {
+  TRACKS: { current: 1, total: WIZARD_TOTAL },
+  CLI: { current: 2, total: WIZARD_TOTAL },
+  TARGETS: { current: 3, total: WIZARD_TOTAL },
+  SCOPE: { current: 4, total: WIZARD_TOTAL },
+  CONFIRM: { current: 5, total: WIZARD_TOTAL },
+  INSTALL: { current: 6, total: WIZARD_TOTAL }
+};
+var UPDATE_WIZARD_TOTAL = 5;
+var UPDATE_WIZARD = {
+  TRACKS: { current: 1, total: UPDATE_WIZARD_TOTAL },
+  CLI: { current: 2, total: UPDATE_WIZARD_TOTAL },
+  TARGETS: { current: 3, total: UPDATE_WIZARD_TOTAL },
+  CONFIRM: { current: 4, total: UPDATE_WIZARD_TOTAL },
+  RUN: { current: 5, total: UPDATE_WIZARD_TOTAL }
+};
+function stepLabel(step, suffix) {
+  if (!step) return suffix;
+  return `Step ${step.current}/${step.total} \u2014 ${suffix}`;
+}
+
+// src/prompts.ts
+var TRACK_LABELS = {
+  // #533 — base 는 모든 dev 트랙에 이미 들어 있다(dev 트랙 8종 ∪ base = 추가 파일 0, 설계 §5 실측).
+  // 함께 골라도 해는 없어 막지 않고(사용자 결정 2026-09-27), 그 사실만 라벨로 알린다.
+  base: "base \u2014 no stack yet \u2014 every dev track already includes it",
+  tooling: "tooling \u2014 Bash + Markdown meta-project",
+  "csr-supabase": "csr-supabase \u2014 Vite + React + Supabase",
+  "csr-fastify": "csr-fastify \u2014 Vite + React + Fastify",
+  "csr-fastapi": "csr-fastapi \u2014 Vite + React + FastAPI",
+  "ssr-htmx": "ssr-htmx \u2014 htmx + FastAPI",
+  "ssr-nextjs": "ssr-nextjs \u2014 Next.js (App Router)",
+  data: "data \u2014 Python data / DuckDB / PySide6",
+  executive: "executive \u2014 proposals / DD / pitch (no agent-skills)",
+  full: "full \u2014 all dev capabilities",
+  "project-management": "project-management \u2014 PM / Scrum / Jira / Confluence",
+  "growth-marketing": "growth-marketing \u2014 Growth / Marketing / Content"
+};
+var VISIBLE_OPTION_DEFS = [];
+var CLI_BASE_LABELS = {
+  claude: "Claude Code",
+  codex: "Codex (OpenAI)",
+  opencode: "OpenCode (anomalyco)",
+  antigravity: "Antigravity (Google)"
+};
+var INSTALL_TARGET_PAGES = [
+  // 2026-08-16 — 트랙이 고르는 자산을 **맨 앞에서** 전부 보여준다. 그전까지 이 항목들은 화면에
+  // 한 번도 안 나온 채 깔렸고, 사용자는 설치가 끝난 뒤 요약에서 처음 봤다.
+  //
+  // 2페이지로 나눈 근거는 실측이다: 최대 트랙(`full`)이 32항목(당시 실측 — rules 6 · agents 9 · hooks 3 ·
+  // skills 14)이라 clack groupMultiselect 의 "페이지당 ≤ ~30행" 제약을 한 페이지로는 못 지킨다.
+  // 가르는 축은 역할이다 — 정책·가드가 한쪽, 실행 능력이 다른 쪽.
+  { label: "Track baseline \u2014 Rules & Hooks (\uC815\uCC45\xB7\uAC00\uB4DC)", cats: [], baseline: ["rules", "hooks"] },
+  {
+    label: "Track baseline \u2014 Agents & Skills (\uC5D0\uC774\uC804\uD2B8\xB7\uC2A4\uD0AC)",
+    cats: [],
+    baseline: ["agents", "skills"]
+  },
+  { label: "Dev Core (Frontend \xB7 Backend \xB7 Data)", cats: ["frontend", "backend", "data"] },
+  { label: "Dev Tools (Security \xB7 Quality \xB7 Understanding)", cats: ["dev-tools", "understanding"] },
+  { label: "Business (PM \xB7 Executive \xB7 Documents)", cats: ["business"] },
+  // v26.85.0 — 코드-퍼스트 비주얼/미디어 제작 (용도별 섹션, 전부 opt-in).
+  { label: "Visual & Media (Slides \xB7 Diagrams \xB7 Motion \xB7 Video)", cats: ["visual-media"] },
+  { label: "Workflow", cats: ["workflow"] }
+];
+var BASELINE_TITLES = {
+  rules: "Rules \u2014 \uC0C1\uC2DC \uC0C1\uC8FC\uD558\uB294 \uB300\uC6D0\uCE59 (4 CLI \uC804\uBD80\uC5D0 \uC124\uCE58)",
+  hooks: "Hooks \u2014 \uACB0\uC815\uB860\uC801 \uAC00\uB4DC (\uD574\uC81C\uD558\uBA74 settings.json \uBC30\uC120\uB3C4 \uD568\uAED8 \uBE60\uC9C4\uB2E4)",
+  agents: "Agents \u2014 \uB3C5\uB9BD \uB808\uC778 (\uB9AC\uBDF0\xB7\uAC80\uC99D)",
+  skills: "Skills \u2014 \uD544\uC694\uD560 \uB54C \uC5F4\uB9AC\uB294 \uC791\uC5C5 \uC808\uCC28"
+};
+function buildPageGroups(cats, initialSet, installedSet = /* @__PURE__ */ new Set(), baselineKinds = [], baselineTargets = []) {
+  const installedMark = (value) => installedSet.has(value) ? "  \u25CF installed" : "";
+  const groups = {};
+  const flatItems = [];
+  for (const kind of baselineKinds) {
+    const items = baselineTargets.filter((t) => t.kind === kind).map((t) => ({
+      value: t.id,
+      label: `    ${t.name}${installedMark(t.id)}`,
+      ...t.hint ? { hint: t.hint } : {}
+    }));
+    if (items.length === 0) continue;
+    groups[BASELINE_TITLES[kind]] = items;
+    flatItems.push(...items);
   }
-  if (mode === "all") {
-    const ok2 = await prompts.confirm(
-      [
-        "\uC804\uB7C9 \uC81C\uAC70 \u2014 \uB418\uB3CC\uB9B4 \uC218 \uC5C6\uB2E4:",
-        `  \xB7 \uC790\uC0B0 ${log.assets.length}\uAC1C (\uC790\uB3D9 \uACBD\uB85C\uAC00 \uC788\uB294 \uAC83\uB9CC \uC2E4\uC81C \uC81C\uAC70)`,
-        "  \xB7 templates \uC0AD\uC81C: `.claude/` \uB4F1 (\uC124\uCE58 \uAE30\uB85D\uB3C4 \uD568\uAED8 \uC0AC\uB77C\uC9C4\uB2E4)",
-        "  \xB7 `.claude/` \uBC16 \uD30C\uC77C(`.mcp.json` \uB4F1)\uC740 \uC0AD\uC81C\uD558\uC9C0 \uC54A\uACE0 \uC548\uB0B4\uB9CC \uD55C\uB2E4"
-      ].join("\n")
+  for (const cat of cats) {
+    const items = [];
+    for (const o of VISIBLE_OPTION_DEFS.filter((d2) => d2.category === cat)) {
+      items.push({
+        value: `option:${o.key}`,
+        // v26.62.3 — group header 와 옵션 사이 시각 hierarchy 강화. label prefix 4 space.
+        label: `    ${o.label}  [${o.source}]${installedMark(`option:${o.key}`)}`,
+        hint: o.hint
+      });
+    }
+    const tierOrder = { official: 0, vetted: 1, experimental: 2 };
+    const catAssets = [...EXTERNAL_ASSETS.filter((x) => x.category === cat)].sort(
+      (a, b2) => tierOrder[assetTrustTier(a.id)] - tierOrder[assetTrustTier(b2.id)]
     );
-    if (!ok2) {
-      prompts.cancel("Cancelled.");
-      return { ok: false, reason: "cancelled" };
+    for (const a of catAssets) {
+      const tier = assetTrustTier(a.id);
+      const badge = tier === "official" ? "  \u2605 official" : tier === "experimental" ? "  \u26A0 experimental (opt-in)" : "";
+      items.push({
+        value: `asset:${a.id}`,
+        label: `    ${a.id}  [${a.source}]${badge}${installedMark(`asset:${a.id}`)}`,
+        hint: a.description
+      });
     }
-    return { ok: true, options: { projectDir } };
-  }
-  const picked = await prompts.selectAssets(rows);
-  if (picked === null) {
-    prompts.cancel("Cancelled.");
-    return { ok: false, reason: "cancelled" };
+    if (items.length === 0) continue;
+    const selectedInCat = items.filter((it3) => initialSet.has(it3.value)).length;
+    const header = `${CATEGORY_TITLES[cat]}  [${selectedInCat}/${items.length} \u2713 default]`;
+    groups[header] = items;
+    flatItems.push(...items);
   }
-  if (picked.length === 0) {
-    prompts.outro("\uC544\uBB34\uAC83\uB3C4 \uC120\uD0DD\uD558\uC9C0 \uC54A\uC558\uB2E4 \u2014 \uBCC0\uACBD \uC5C6\uC74C.");
-    return { ok: false, reason: "nothing-selected" };
+  return { groups, flatItems };
+}
+function assertPagesCoverAllCategories(pages) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const page of pages) {
+    for (const cat of page.cats) counts.set(cat, (counts.get(cat) ?? 0) + 1);
   }
-  const ok = await prompts.confirm(
-    [
-      `\uC120\uD0DD \uC81C\uAC70 (${picked.length}\uAC1C):`,
-      ...picked.map((id) => `  \xB7 ${id}`),
-      "",
-      "templates \uB294 \uADF8\uB300\uB85C \uB454\uB2E4."
-    ].join("\n")
-  );
-  if (!ok) {
-    prompts.cancel("Cancelled.");
-    return { ok: false, reason: "cancelled" };
+  const missing = CATEGORIES.filter((c3) => !counts.has(c3));
+  const duplicated = CATEGORIES.filter((c3) => (counts.get(c3) ?? 0) > 1);
+  if (missing.length > 0 || duplicated.length > 0) {
+    throw new Error(
+      `INSTALL_TARGET_PAGES drift vs CATEGORIES \u2014 missing=[${missing.join(", ")}] duplicated=[${duplicated.join(", ")}]. \uBAA8\uB4E0 \uCE74\uD14C\uACE0\uB9AC\uB294 \uC815\uD655\uD788 \uD55C \uD398\uC774\uC9C0\uC5D0 \uBC30\uCE58\uD574\uC57C \uD55C\uB2E4 (no-false-ship: wizard \uBBF8\uB178\uCD9C = \uAC70\uC9D3 \uAD11\uACE0).`
+    );
   }
-  return { ok: true, options: { projectDir, only: picked.join(",") } };
 }
-function defaultUninstallPrompts() {
-  return {
+assertPagesCoverAllCategories(INSTALL_TARGET_PAGES);
+function viewportItems(itemCount) {
+  const rows = process.stdout.rows ?? 24;
+  return Math.max(8, Math.min(itemCount, rows - 10));
+}
+var defaultPrompts = {
+  intro: (msg) => ge(msg),
+  outro: (msg) => ye(msg),
+  cancel: (msg) => me(msg),
+  selectTracks: async (initial, step, installed = []) => {
+    const locked = new Set(installed);
+    const result = await ve({
+      message: locked.size > 0 ? `${stepLabel(step, "Tracks")}   (\u25CF installed = already here, locked \xB7 check a new one to add its rules \xB7 agents \xB7 skills)` : stepLabel(step, "Select Track(s)"),
+      options: TRACKS.map((t) => ({
+        value: t,
+        label: locked.has(t) ? `${TRACK_LABELS[t]}   \u25CF installed` : TRACK_LABELS[t]
+      })),
+      ...initial ? { initialValues: initial } : {},
+      maxItems: viewportItems(11),
+      required: true
+    });
+    return q(result) ? null : result;
+  },
+  selectCli: async (initial, step, installed = []) => {
+    const initialValues = initial && initial.length > 0 ? [...initial] : ["claude"];
+    const locked = new Set(installed);
+    const label = (c3) => locked.has(c3) ? `${CLI_BASE_LABELS[c3]}   \u25CF installed` : CLI_BASE_LABELS[c3];
+    const result = await ve({
+      message: locked.size > 0 ? `${stepLabel(step, "CLIs")}     (\u25CF installed = locked \u2014 remove one with Uninstall \xB7 check another to install its files)` : stepLabel(step, "Target CLI(s)"),
+      options: [
+        { value: "claude", label: label("claude") },
+        { value: "codex", label: label("codex") },
+        { value: "opencode", label: label("opencode") },
+        { value: "antigravity", label: label("antigravity") }
+      ],
+      initialValues,
+      required: true
+    });
+    if (q(result)) return null;
+    return [...result].sort(
+      (a, b2) => CLI_BASE_SORT_ORDER[a] - CLI_BASE_SORT_ORDER[b2]
+    );
+  },
+  selectAction: async (state, record) => {
+    const result = await Ee({
+      message: describeInstall(state, record),
+      options: buildRouterChoices(state, record).map((c3) => {
+        const label = c3.enabled ? c3.label : `${c3.label} [disabled]`;
+        return {
+          value: c3.value,
+          label,
+          ...c3.hint ? { hint: c3.hint } : {},
+          ...c3.enabled ? {} : { disabled: true }
+        };
+      })
+    });
+    return q(result) ? null : result;
+  },
+  /**
+   * v26.64.0 (ADR-020) — Installation scope select. Default Project (D16 — no global write).
+   * Global 은 사용자 명시 opt-in 시에만.
+   */
+  selectScope: async (initial = "project", step) => {
+    const result = await Ee({
+      message: stepLabel(step, "Installation scope"),
+      initialValue: initial,
+      options: [
+        {
+          value: "project",
+          label: "Project",
+          hint: "Install in current directory (committed with your project)"
+        },
+        {
+          value: "global",
+          label: "Global",
+          hint: "Write to ~/.claude/, ~/.codex/, npm -g (shared across all projects)"
+        }
+      ]
+    });
+    return q(result) ? null : result;
+  },
+  selectUpdateGroups: async () => {
+    const result = await ve({
+      message: "What to update  (space = toggle \xB7 your edits are always backed up)",
+      options: [
+        { value: "skills", label: "Skills", hint: "installed bundled skills \u2192 latest" },
+        {
+          value: "new-skills",
+          label: "New skills",
+          hint: "bundled skills added since your install"
+        },
+        {
+          value: "rules",
+          label: "Rules \xB7 agents \xB7 commands",
+          hint: "your edited files \u2192 *.backup-<time>"
+        },
+        {
+          value: "anchor",
+          label: "CLAUDE-uzys-harness.md anchor",
+          hint: "your edited anchor \u2192 *.backup-<time>"
+        },
+        {
+          value: "hooks",
+          label: "Hooks \xB7 settings.json",
+          hint: "stale hook refs cleaned"
+        },
+        {
+          value: "external",
+          label: "Codex / OpenCode / Antigravity + external skills",
+          hint: "rendered artifacts + npx skills"
+        }
+      ],
+      initialValues: [...UPDATE_GROUPS],
+      required: true
+    });
+    return q(result) ? null : result;
+  },
+  confirmInstall: async (summary) => {
+    const result = await ue({
+      message: `${summary}
+
+Proceed?`,
+      initialValue: true
+    });
+    return q(result) ? null : result;
+  },
+  selectInstallTargets: async (initialChecked, step, recap) => {
+    const pages = INSTALL_TARGET_PAGES;
+    const baselineTargets = withBaselineHints(listBaselineTargets({ tracks: recap?.tracks ?? [] }));
+    const initialSet = new Set(initialChecked);
+    const collected = new Set(initialChecked);
+    const recapLine = recap ? `Tracks: ${recap.tracks.join(", ")}  \xB7  CLIs: ${recap.cli.join(", ")}` : "";
+    const installedSet = new Set(recap?.installed ?? []);
+    process.stdout.write("\x1B[?1049h");
+    let resultIds = null;
+    let aborted = false;
+    try {
+      let pageIdx = 0;
+      let dir = 1;
+      while (pageIdx < pages.length) {
+        const page = pages[pageIdx];
+        if (!page) break;
+        const { groups, flatItems } = buildPageGroups(
+          page.cats,
+          initialSet,
+          installedSet,
+          page.baseline ?? [],
+          baselineTargets
+        );
+        if (flatItems.length === 0) {
+          pageIdx += dir;
+          if (pageIdx < 0) {
+            aborted = true;
+            break;
+          }
+          continue;
+        }
+        const selectedNow = flatItems.filter((it3) => collected.has(it3.value)).map((it3) => it3.value);
+        const pageDefault = flatItems.filter((it3) => initialSet.has(it3.value)).length;
+        const totalSelected = collected.size;
+        const message = [
+          `Step ${step.current}/${step.total}  \xB7  Page ${pageIdx + 1}/${pages.length}  \xB7  ${page.label}`,
+          recapLine ? `  ${recapLine}` : "",
+          `  Selected so far: ${totalSelected} items  \xB7  This page default \u2713 ${pageDefault}/${flatItems.length}`,
+          // 마커의 뜻을 화면에서 바로 알려준다 — 체크 해제를 제거로 오해하는 것이 이 화면의
+          // 원래 문제였으므로, 마커가 보일 때는 제거 경로를 같은 자리에서 말한다.
+          installedSet.size > 0 ? "  \u25CF installed = \uC774\uBBF8 \uC124\uCE58\uB428 \xB7 \uCCB4\uD06C \uD574\uC81C\uD574\uB3C4 \uC81C\uAC70\uB418\uC9C0 \uC54A\uB294\uB2E4 (\uC81C\uAC70: Uninstall \uBA54\uB274 \uB610\uB294 agent-harness uninstall)" : "",
+          "  Space toggle \xB7 Enter \u2192 next \xB7 ESC \u2192 prev"
+        ].filter(Boolean).join("\n");
+        const groupOpts = {
+          message,
+          options: groups,
+          initialValues: selectedNow,
+          required: false,
+          selectableGroups: false
+        };
+        const result = await pe(groupOpts);
+        if (q(result)) {
+          if (pageIdx === 0) {
+            aborted = true;
+            break;
+          }
+          dir = -1;
+          pageIdx--;
+          continue;
+        }
+        for (const it3 of flatItems) collected.delete(it3.value);
+        for (const v2 of result) collected.add(v2);
+        dir = 1;
+        pageIdx++;
+      }
+      if (!aborted) {
+        resultIds = [...collected];
+      }
+    } finally {
+      process.stdout.write("\x1B[?1049l");
+    }
+    if (resultIds !== null) {
+      process.stdout.write(
+        `\u25C7  Step ${step.current}/${step.total} \u2014 Install targets  \xB7  ${resultIds.length} selected
+\u2502
+`
+      );
+    }
+    return resultIds;
+  }
+};
+
+// src/uninstall-interactive.ts
+function buildRemovableRows(assets) {
+  return assets.map((a) => ({
+    value: a.id,
+    label: `${a.id}  [${a.method}]${a.version ? ` v${a.version}` : ""}`,
+    hint: hintFor(a)
+  }));
+}
+function hintFor(asset) {
+  if (asset.scope === "global") {
+    return "global scope \u2014 not removed automatically; prints the manual command to run";
+  }
+  switch (asset.method) {
+    case "plugin":
+      return "claude plugin uninstall --scope project";
+    case "skill":
+      return "npx skills remove";
+    case "npm":
+      return "npm uninstall --save-dev";
+    case "npx-run":
+    // shell-script = #492 에서 은퇴한 legacy kind. 옛 로그가 그대로 들어온다.
+    case "shell-script":
+    case "internal":
+      return 'no automatic reverse path \u2014 only "Remove everything" clears it';
+  }
+}
+function buildUninstallModeChoices(clis, assetCount) {
+  return [
+    {
+      value: "cli",
+      label: "Remove one CLI",
+      hint: clis.length > 1 ? "that CLI's own files go; files shared with a remaining CLI stay; your text stays" : 'only one CLI here \u2014 use "Remove everything"',
+      enabled: clis.length > 1
+    },
+    {
+      value: "selected",
+      label: "Remove selected assets",
+      hint: assetCount > 0 ? `pick from the ${assetCount} external assets; templates (.claude/ etc.) stay` : "no external assets recorded",
+      enabled: assetCount > 0
+    },
+    {
+      value: "all",
+      label: "Remove everything",
+      hint: "assets + templates + the install record \u2014 CLI folders (.claude/ \xB7 .codex/ \xB7 .opencode/, whichever exist) are moved aside as <dir>.backup-<time>",
+      enabled: true
+    }
+  ];
+}
+function describeOwned(p2) {
+  if (p2.kind === "dir") {
+    return `${p2.path} \u2192 moved aside as ${p2.path.replace(/\/+$/, "")}.backup-<time> (your own files there stay in it)`;
+  }
+  if (p2.kind === "import-block") return `the import block in ${p2.path} (your text stays)`;
+  if (p2.path === "AGENTS.md") return "AGENTS.md harness sections (your ## Project Context stays)";
+  if (p2.path === ".agents/skills/") return ".agents/skills/<harness skills>";
+  return p2.path;
+}
+function removalSummary(cli2, installed) {
+  const remaining = installed.filter((c3) => c3 !== cli2);
+  const { exclusive, sharedNowUnowned } = removableFor(cli2, remaining);
+  const lines = [];
+  if (exclusive.length > 0) {
+    lines.push(
+      `  \xB7 ${exclusive.map(describeOwned).join(" \xB7 ")}   (only ${CLI_BASE_LABELS[cli2]} uses them)`
+    );
+  }
+  if (sharedNowUnowned.length > 0) {
+    lines.push(
+      `  \xB7 ${sharedNowUnowned.map(describeOwned).join(" \xB7 ")}   (${CLI_BASE_LABELS[cli2]} was the last user)`
+    );
+  }
+  const kept = [
+    ...new Set(
+      remaining.flatMap(
+        (c3) => CLI_OWNERSHIP[c3].filter((p2) => p2.kind !== "keep").map((p2) => p2.path)
+      )
+    )
+  ];
+  lines.push(
+    `  \xB7 kept: ${[...kept, ".mcp.json", `install record (clis: ${remaining.join(", ")})`].join(" \xB7 ")}`
+  );
+  return lines;
+}
+function buildCliRows(installed) {
+  return installed.map((cli2) => {
+    const { exclusive, sharedNowUnowned } = removableFor(
+      cli2,
+      installed.filter((c3) => c3 !== cli2)
+    );
+    return {
+      value: cli2,
+      label: CLI_BASE_LABELS[cli2],
+      hint: `removes ${[...exclusive, ...sharedNowUnowned].map(describeOwned).join(" \xB7 ")}`
+    };
+  });
+}
+async function runInteractiveUninstall(projectDir, deps = {}) {
+  const prompts = deps.prompts ?? defaultUninstallPrompts();
+  const isTty = deps.isTty ?? (() => Boolean(process.stdin.isTTY));
+  const readLog = deps.readLog ?? readInstallLog;
+  if (!isTty()) return { ok: false, reason: "no-tty" };
+  const log = readLog(projectDir);
+  if (!log) return { ok: false, reason: "no-log" };
+  if (!deps.embedded) prompts.intro("uzys-agent-harness \xB7 uninstall");
+  const rows = buildRemovableRows(log.assets);
+  const clis = installedClis(log);
+  const mode = await prompts.selectMode(
+    buildUninstallModeChoices(clis, rows.length),
+    `uzys-agent-harness \xB7 uninstall     installed: ${clis.join(", ") || "(none)"} \xB7 assets ${rows.length}`
+  );
+  if (mode === null) {
+    prompts.cancel("Cancelled.");
+    return { ok: false, reason: "cancelled" };
+  }
+  if (mode === "cli") return pickCli(projectDir, clis, prompts);
+  if (mode === "all") {
+    const ok2 = await prompts.confirm(
+      [
+        "Remove everything? This is the same as: agent-harness uninstall --yes",
+        `  \xB7 ${log.assets.length} recorded asset(s) \u2014 only those with an automatic reverse path are removed`,
+        "  \xB7 templates: CLI folders (.claude/ \xB7 .codex/ \xB7 .opencode/, whichever exist) are moved aside as <dir>.backup-<time> (your own files there stay in them)",
+        "  \xB7 the install record goes too",
+        "  \xB7 files outside (.mcp.json etc.) are not deleted \u2014 you get instructions instead"
+      ].join("\n")
+    );
+    if (!ok2) {
+      prompts.cancel("Cancelled.");
+      return { ok: false, reason: "cancelled" };
+    }
+    return { ok: true, options: { projectDir } };
+  }
+  const picked = await prompts.selectAssets(rows);
+  if (picked === null) {
+    prompts.cancel("Cancelled.");
+    return { ok: false, reason: "cancelled" };
+  }
+  if (picked.length === 0) {
+    prompts.outro("Nothing selected \u2014 no changes.");
+    return { ok: false, reason: "nothing-selected" };
+  }
+  const ok = await prompts.confirm(
+    [
+      `Remove ${picked.length} selected asset(s)? This is the same as: agent-harness uninstall --only ${picked.join(",")}`,
+      ...picked.map((id) => `  \xB7 ${id}`),
+      "",
+      "Templates (.claude/ etc.) stay."
+    ].join("\n")
+  );
+  if (!ok) {
+    prompts.cancel("Cancelled.");
+    return { ok: false, reason: "cancelled" };
+  }
+  return { ok: true, options: { projectDir, only: picked.join(",") } };
+}
+async function pickCli(projectDir, clis, prompts) {
+  const cli2 = await prompts.selectCli(buildCliRows(clis));
+  if (cli2 === null) {
+    prompts.cancel("Cancelled.");
+    return { ok: false, reason: "cancelled" };
+  }
+  const ok = await prompts.confirm(
+    [
+      `Remove ${cli2}? This is the same as: agent-harness uninstall --cli ${cli2}`,
+      ...removalSummary(cli2, clis)
+    ].join("\n")
+  );
+  if (!ok) {
+    prompts.cancel("Cancelled.");
+    return { ok: false, reason: "cancelled" };
+  }
+  return { ok: true, options: { projectDir, cli: cli2 } };
+}
+function defaultUninstallPrompts() {
+  return {
     intro: (m) => ge(m),
     outro: (m) => ye(m),
     cancel: (m) => me(m),
-    selectMode: async (rowCount) => {
+    selectMode: async (choices, message) => {
       const r = await Ee({
-        message: `\uBB34\uC5C7\uC744 \uC81C\uAC70\uD560\uAE4C? (\uC124\uCE58\uB41C \uC790\uC0B0 ${rowCount}\uAC1C)`,
-        options: [
-          {
-            value: "selected",
-            label: "\uD56D\uBAA9 \uC120\uD0DD\uD574\uC11C \uC81C\uAC70",
-            hint: "templates(`.claude/` \uB4F1)\uB294 \uADF8\uB300\uB85C \uB454\uB2E4"
-          },
-          {
-            value: "all",
-            label: "\uC804\uBD80 \uC81C\uAC70",
-            hint: "\uC790\uC0B0 + templates. \uC124\uCE58 \uAE30\uB85D\uB3C4 \uC0AC\uB77C\uC9C4\uB2E4"
-          }
-        ]
+        message,
+        options: choices.map((c3) => ({
+          value: c3.value,
+          label: c3.enabled ? c3.label : `${c3.label} [disabled]`,
+          hint: c3.hint,
+          ...c3.enabled ? {} : { disabled: true }
+        }))
+      });
+      return q(r) ? null : r;
+    },
+    selectCli: async (rows) => {
+      const r = await Ee({
+        message: 'Which CLI?  (the last remaining CLI cannot be removed this way \u2014 use "Remove everything")',
+        options: rows.map((x) => ({ value: x.value, label: x.label, hint: x.hint }))
       });
       return q(r) ? null : r;
     },
     selectAssets: async (rows) => {
       if (rows.length === 0) return [];
       const r = await ve({
-        message: "\uC81C\uAC70\uD560 \uD56D\uBAA9 (Space \uD1A0\uAE00 \xB7 Enter \uD655\uC815 \xB7 ESC \uCDE8\uC18C)",
+        message: "Assets to remove (Space toggle \xB7 Enter confirm \xB7 ESC cancel)",
         options: rows.map((x) => ({ value: x.value, label: x.label, hint: x.hint })),
         required: false
       });
@@ -5396,13 +6335,25 @@ function defaultUninstallPrompts() {
     confirm: async (summary) => {
       const r = await ue({ message: `${summary}
 
-\uC9C4\uD589\uD560\uAE4C?`, initialValue: false });
+Proceed?`, initialValue: false });
       return q(r) ? null : r;
     }
   };
 }
 
 // src/commands/uninstall.ts
+function templateDirPath(projectDir, rel) {
+  return join19(projectDir, rel.replace(/\/+$/, ""));
+}
+function movedAsideLine(projectDir, rel, backup) {
+  return `  ${status.success(`${rel} moved aside \u2192 ${relative2(projectDir, backup)} (your own files there are kept)`)}`;
+}
+var MOVE_ASIDE_PREVIEW = (rel) => `  \u25CB move ${rel} aside \u2192 ${rel.replace(/\/+$/, "")}.backup-<time> (your own files there stay in the backup)`;
+function recordedTemplateDirs(log) {
+  return [log.templates.claudeDir, log.templates.codexDir, log.templates.opencodeDir].filter(
+    (d2) => d2 !== void 0
+  );
+}
 function uninstallAction(options, deps = {}) {
   const log = deps.log ?? console.log;
   const err = deps.err ?? console.error;
@@ -5410,6 +6361,8 @@ function uninstallAction(options, deps = {}) {
   const spawn = deps.spawn ?? defaultSpawn2;
   const rm = deps.rm ?? defaultRm;
   const writeLog = deps.writeLog ?? writeInstallLog;
+  const moveAside = deps.moveAside ?? backupDir;
+  const harnessRoot = (deps.resolveHarnessRoot ?? defaultHarnessRoot)();
   const projectDir = resolve4(options.projectDir ?? process.cwd());
   const installLog = readInstallLog(projectDir);
   if (!installLog) {
@@ -5418,6 +6371,13 @@ function uninstallAction(options, deps = {}) {
     exit(1);
     return;
   }
+  if (options.cli !== void 0) {
+    removeCliAction(
+      { options, installLog, projectDir, harnessRoot },
+      { log, err, exit, rm, writeLog, moveAside }
+    );
+    return;
+  }
   const selectedIds = parseOnly(options.only);
   if (options.only !== void 0 && selectedIds === null) {
     err(status.failure(c.red("ERROR: --only \uC5D0 \uC790\uC0B0 id \uAC00 \uC5C6\uB2E4")));
@@ -5438,7 +6398,14 @@ function uninstallAction(options, deps = {}) {
   const plan = planReverse(targetAssets, spawn);
   for (const line of headerLines(installLog, selectedIds, targetAssets.length)) log(line);
   if (options.dryRun) {
-    for (const line of dryRunLines(plan, installLog, projectDir, keepTemplates, rootFiles)) {
+    for (const line of dryRunLines(
+      plan,
+      installLog,
+      projectDir,
+      keepTemplates,
+      rootFiles,
+      harnessRoot
+    )) {
       log(line);
     }
     exit(0);
@@ -5447,12 +6414,16 @@ function uninstallAction(options, deps = {}) {
   const logSurvives = selectedIds !== null;
   const { succeeded, failed, removedIds } = executeReverse(plan, log, logSurvives);
   if (!keepTemplates) {
-    const { rootClaudeMdKept, importStripped, external } = removeTemplates(
+    const { rootClaudeMdKept, importStripped, external, moved } = removeTemplates(
       installLog,
       projectDir,
-      rm
+      { rm, moveAside },
+      harnessRoot
     );
-    log(`  ${status.success(`templates removed: ${formatTemplateList(installLog)}`)}`);
+    for (const m of moved) log(movedAsideLine(projectDir, m.rel, m.backup));
+    if (recordedTemplateDirs(installLog).length === 0) {
+      log(`  ${status.success("templates removed: (none)")}`);
+    }
     for (const line of externalRemovalLines(external)) log(line);
     if (importStripped) {
       log(`  ${status.success("CLAUDE.md \u2014 harness @import removed (\uBCF8\uBB38 \uBCF4\uC874)")}`);
@@ -5489,863 +6460,715 @@ function summarize(r) {
   if (r.failed > 0)
     return {
       line: c.yellow(`uninstall finished with ${r.failed} skip(s) (${r.succeeded} ok)`),
-      code: 1
-    };
-  if (r.nothingDone)
-    return {
-      line: c.yellow("\uC544\uBB34\uAC83\uB3C4 \uC790\uB3D9 \uC81C\uAC70\uB418\uC9C0 \uC54A\uC558\uB2E4 \u2014 \uC704 \uC548\uB0B4\uB97C \uB530\uB77C \uC9C1\uC811 \uCC98\uB9AC\uD574\uC57C \uD55C\uB2E4"),
-      code: 1
-    };
-  if (r.logWriteFailed)
-    return {
-      line: c.yellow("\uC790\uC0B0\uC740 \uC81C\uAC70\uB410\uC73C\uB098 install log \uB97C \uAC31\uC2E0\uD558\uC9C0 \uBABB\uD588\uB2E4 (\uAE30\uB85D\uC774 \uC2E4\uC81C\uC640 \uB2E4\uB974\uB2E4)"),
-      code: 1
-    };
-  return { line: status.success(c.green(`uninstall complete (${r.succeeded} asset(s))`)), code: 0 };
-}
-function headerLines(installLog, selectedIds, targetCount) {
-  return [
-    "",
-    c.bold("uzys-agent-harness \xB7 uninstall"),
-    "",
-    c.dim(`  installed: ${installLog.installedAt}`),
-    c.dim(`  scope:     ${installLog.scope}`),
-    c.dim(
-      selectedIds ? `  assets:    ${targetCount} selected of ${installLog.assets.length} (--only)` : `  assets:    ${installLog.assets.length}`
-    ),
-    ""
-  ];
-}
-function executeReverse(plan, log, logSurvives) {
-  let succeeded = 0;
-  let failed = 0;
-  const removedIds = [];
-  for (const step of plan.reverseSteps) {
-    const result = step.execute();
-    if (result.ok) {
-      log(`  ${status.success(step.label)}`);
-      removedIds.push(step.assetId);
-      succeeded++;
-    } else {
-      log(`  ${c.yellow("\u2298")} ${step.label}  (${result.message ?? "failed"})`);
-      failed++;
-    }
-  }
-  const tail = logSurvives ? "\uC790\uB3D9 \uB418\uB3CC\uB9AC\uAE30 \uACBD\uB85C \uC5C6\uC74C, \uAE30\uB85D \uC720\uC9C0" : "\uC790\uB3D9 \uB418\uB3CC\uB9AC\uAE30 \uACBD\uB85C \uC5C6\uC74C";
-  for (const asset of plan.noReversePath) {
-    log(`  ${c.yellow("\u2298")} ${asset.id} (${asset.method}) \u2014 ${tail}`);
-  }
-  return { succeeded, failed, removedIds };
-}
-function settleLog(ctx, io) {
-  const { installLog, projectDir, selectedIds, removedIds } = ctx;
-  if (selectedIds) {
-    const remaining = installLog.assets.filter((a) => !removedIds.includes(a.id));
-    try {
-      io.writeLog(projectDir, { ...installLog, assets: remaining });
-      io.log(`  ${status.success(`install log updated (${remaining.length} asset(s) remain)`)}`);
-    } catch (e2) {
-      io.err(status.failure(c.red(`ERROR: install log \uAC31\uC2E0 \uC2E4\uD328 \u2014 ${installLogPath(projectDir)}`)));
-      io.err(c.dim(`       ${e2 instanceof Error ? e2.message : String(e2)}`));
-      io.err(c.dim(`       \uC2E4\uC81C\uB85C \uC81C\uAC70\uB41C \uC790\uC0B0: ${removedIds.join(", ") || "(\uC5C6\uC74C)"}`));
-      return true;
-    }
-  } else {
-    io.rm(join16(projectDir, INSTALL_LOG_DIR));
-    io.rm(legacyInstallLogPath(projectDir));
-    io.log(`  ${status.success("install log removed")}`);
-  }
-  return false;
-}
-function dryRunLines(plan, installLog, projectDir, keepTemplates, rootFiles) {
-  const lines = [c.yellow("[DRY RUN] reverse list (\uC2E4\uC81C \uBCC0\uACBD \uC5C6\uC74C):"), ""];
-  if (plan.reverseSteps.length === 0) {
-    lines.push(c.dim("  (no project-scope assets to reverse)"));
-  }
-  lines.push(...plan.reverseSteps.map((s) => `  \u25CB ${s.label}`));
-  lines.push(
-    ...plan.noReversePath.map(
-      (a) => c.dim(`  \u2298 ${a.id} (${a.method}) \u2014 \uC790\uB3D9 \uB418\uB3CC\uB9AC\uAE30 \uACBD\uB85C \uC5C6\uC74C, \uAE30\uB85D \uC720\uC9C0`)
-    )
-  );
-  if (!keepTemplates) {
-    lines.push(`  \u25CB remove templates: ${formatTemplateList(installLog)}`);
-    const rootMd = installLog.templates.rootClaudeMd;
-    if (rootMd) {
-      lines.push(
-        rootClaudeMdModified(installLog, projectDir) ? `  \u25CB keep ${rootMd.path} (modified since install \u2014 preserved)` : `  \u25CB remove ${rootMd.path}`
-      );
-    }
-    if (hasRootImport(projectDir)) {
-      lines.push("  \u25CB strip harness @import from CLAUDE.md (\uBCF8\uBB38 \uBCF4\uC874)");
-    }
-    lines.push(...previewExternalLines(installLog, projectDir));
-  }
-  lines.push(...advisoryLines(plan, projectDir, rootFiles), "");
-  return lines;
-}
-function advisoryLines(plan, projectDir, rootFiles) {
-  const lines = [];
-  if (plan.globalAdvisories.length > 0) {
-    lines.push(
-      "",
-      c.yellow(
-        `[GLOBAL] ${plan.globalAdvisories.length} asset(s) at scope=global \u2014 manual removal required (D16):`
-      )
-    );
-    for (const adv of plan.globalAdvisories) {
-      lines.push(c.dim(`  \xB7 ${adv.asset.id} (${adv.asset.method})`), c.dim(`      ${adv.command}`));
-    }
-  }
-  lines.push(...rootFileAdvisoryLines(rootFiles, projectDir));
-  return lines;
-}
-function rootFileAdvisoryLines(rootFiles, projectDir) {
-  const present = rootFiles.filter((f) => existsSync17(join16(projectDir, f.path)));
-  if (present.length === 0) return [];
-  return [
-    "",
-    c.yellow("[ROOT] `.claude/` \uBC16\uC5D0 \uB0A8\uB294 \uAC83 (\uC790\uB3D9\uC73C\uB85C \uC9C0\uC6B0\uC9C0 \uC54A\uB294\uB2E4):"),
-    ...present.flatMap((f) => [
-      c.dim(
-        `  \xB7 ${f.path} \u2014 ${f.change === "created" ? "\uD558\uB124\uC2A4\uAC00 \uC0DD\uC131 (\uC218\uC815\uD55C \uC801 \uC5C6\uC73C\uBA74 \uC0AD\uC81C\uD574\uB3C4 \uC548\uC804)" : "\uAE30\uC874 \uC0AC\uC6A9\uC790 \uD30C\uC77C\uC5D0 \uBCD1\uD569 (\uC9C1\uC811 \uD655\uC778 \uD544\uC694)"}`
-      ),
-      c.dim(`      ${f.notes.join(" / ")}`)
-    ])
-  ];
-}
-function planReverse(assets, spawn) {
-  const reverseSteps = [];
-  const globalAdvisories = [];
-  const noReversePath = [];
-  for (const asset of assets) {
-    if (asset.scope === "global") {
-      globalAdvisories.push({ asset, command: buildGlobalAdvisoryCmd(asset) });
-      continue;
-    }
-    const step = buildProjectReverseStep(asset, spawn);
-    if (step) reverseSteps.push(step);
-    else noReversePath.push(asset);
-  }
-  return { reverseSteps, globalAdvisories, noReversePath };
-}
-function buildProjectReverseStep(asset, spawn) {
-  switch (asset.method) {
-    case "plugin": {
-      const pluginId = asset.detail.pluginId ?? asset.id;
-      return {
-        assetId: asset.id,
-        label: `claude plugin uninstall --scope project ${pluginId}`,
-        execute: () => {
-          const r = spawn("claude", ["plugin", "uninstall", "--scope", "project", pluginId]);
-          return r.status === 0 ? { ok: true } : { ok: false, message: (r.stderr || "").trim() };
-        }
-      };
-    }
-    case "skill": {
-      const source = asset.detail.source ?? asset.id;
-      return {
-        assetId: asset.id,
-        label: `npx skills remove ${source}`,
-        execute: () => {
-          const r = spawn("npx", [skillsCliSpec(), "remove", source, "--yes"]);
-          return r.status === 0 ? { ok: true } : { ok: false, message: (r.stderr || "").trim() };
-        }
-      };
-    }
-    case "npm": {
-      const pkg = asset.detail.pkg ?? asset.id;
-      return {
-        assetId: asset.id,
-        label: `npm uninstall --save-dev ${pkg}`,
-        execute: () => {
-          const r = spawn("npm", ["uninstall", "--save-dev", pkg]);
-          return r.status === 0 ? { ok: true } : { ok: false, message: (r.stderr || "").trim() };
-        }
-      };
-    }
-    case "npx-run":
-      return null;
-    case "shell-script":
-      return null;
-    case "internal":
-      return null;
-  }
-}
-function unknownIds(installLog, selectedIds) {
-  const known = new Set(installLog.assets.map((a) => a.id));
-  return selectedIds.filter((id) => !known.has(id));
-}
-function parseOnly(only) {
-  if (!only) return null;
-  const ids = only.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
-  return ids.length > 0 ? ids : null;
-}
-function buildGlobalAdvisoryCmd(asset) {
-  switch (asset.method) {
-    case "plugin": {
-      const pid = asset.detail.pluginId ?? asset.id;
-      return `claude plugin uninstall --scope user ${pid}`;
-    }
-    case "skill": {
-      const s = asset.detail.source ?? asset.id;
-      return `npx skills remove -g ${s}`;
-    }
-    case "npm": {
-      const pkg = asset.detail.pkg ?? asset.id;
-      return `npm uninstall -g ${pkg}`;
-    }
-    case "npx-run":
-    case "shell-script":
-    case "internal":
-      return "(no standard reverse \u2014 manual)";
-  }
+      code: 1
+    };
+  if (r.nothingDone)
+    return {
+      line: c.yellow("\uC544\uBB34\uAC83\uB3C4 \uC790\uB3D9 \uC81C\uAC70\uB418\uC9C0 \uC54A\uC558\uB2E4 \u2014 \uC704 \uC548\uB0B4\uB97C \uB530\uB77C \uC9C1\uC811 \uCC98\uB9AC\uD574\uC57C \uD55C\uB2E4"),
+      code: 1
+    };
+  if (r.logWriteFailed)
+    return {
+      line: c.yellow("\uC790\uC0B0\uC740 \uC81C\uAC70\uB410\uC73C\uB098 install log \uB97C \uAC31\uC2E0\uD558\uC9C0 \uBABB\uD588\uB2E4 (\uAE30\uB85D\uC774 \uC2E4\uC81C\uC640 \uB2E4\uB974\uB2E4)"),
+      code: 1
+    };
+  return { line: status.success(c.green(`uninstall complete (${r.succeeded} asset(s))`)), code: 0 };
 }
-function removeTemplates(log, projectDir, rm) {
-  rm(join16(projectDir, log.templates.claudeDir));
-  if (log.templates.codexDir) rm(join16(projectDir, log.templates.codexDir));
-  if (log.templates.opencodeDir) rm(join16(projectDir, log.templates.opencodeDir));
-  const external = removeExternalFiles(log, projectDir, rm);
-  const importStripped = stripRootImport(projectDir);
-  const rootMd = log.templates.rootClaudeMd;
-  if (rootMd) {
-    if (rootClaudeMdModified(log, projectDir))
-      return { rootClaudeMdKept: true, importStripped, external };
-    rm(join16(projectDir, rootMd.path));
-  }
-  return { rootClaudeMdKept: false, importStripped, external };
+function headerLines(installLog, selectedIds, targetCount) {
+  return [
+    "",
+    c.bold("uzys-agent-harness \xB7 uninstall"),
+    "",
+    c.dim(`  installed: ${installLog.installedAt}`),
+    c.dim(`  scope:     ${installLog.scope}`),
+    c.dim(
+      selectedIds ? `  assets:    ${targetCount} selected of ${installLog.assets.length} (--only)` : `  assets:    ${installLog.assets.length}`
+    ),
+    ""
+  ];
 }
-function removeExternalFiles(log, projectDir, rm) {
-  const removed = [];
-  const kept = [];
-  for (const { path, sha256 } of log.externalFiles ?? []) {
-    const abs = join16(projectDir, path);
-    if (!existsSync17(abs)) continue;
-    if (!lstatSync2(abs).isFile()) continue;
-    if (hashContent(readFileSync15(abs, "utf8")) !== sha256) {
-      kept.push(path);
-      continue;
+function executeReverse(plan, log, logSurvives) {
+  let succeeded = 0;
+  let failed = 0;
+  const removedIds = [];
+  for (const step of plan.reverseSteps) {
+    const result = step.execute();
+    if (result.ok) {
+      log(`  ${status.success(step.label)}`);
+      removedIds.push(step.assetId);
+      succeeded++;
+    } else {
+      log(`  ${c.yellow("\u2298")} ${step.label}  (${result.message ?? "failed"})`);
+      failed++;
     }
-    rm(abs);
-    removed.push(path);
   }
-  for (const path of removed) pruneEmptyDirsUpward(projectDir, dirname5(join16(projectDir, path)));
-  return { removed, kept };
+  const tail = logSurvives ? "\uC790\uB3D9 \uB418\uB3CC\uB9AC\uAE30 \uACBD\uB85C \uC5C6\uC74C, \uAE30\uB85D \uC720\uC9C0" : "\uC790\uB3D9 \uB418\uB3CC\uB9AC\uAE30 \uACBD\uB85C \uC5C6\uC74C";
+  for (const asset of plan.noReversePath) {
+    log(`  ${c.yellow("\u2298")} ${asset.id} (${asset.method}) \u2014 ${tail}`);
+  }
+  return { succeeded, failed, removedIds };
 }
-function pruneEmptyDirsUpward(projectDir, startDir) {
-  let cursor = startDir;
-  while (true) {
-    const rel = relative2(projectDir, cursor);
-    if (rel === "" || rel.startsWith(`..${sep2}`) || rel === "..") return;
+function settleLog(ctx, io) {
+  const { installLog, projectDir, selectedIds, removedIds } = ctx;
+  if (selectedIds) {
+    const remaining = installLog.assets.filter((a) => !removedIds.includes(a.id));
     try {
-      if (readdirSync6(cursor).length > 0) return;
-      rmdirSync2(cursor);
-    } catch {
-      return;
+      io.writeLog(projectDir, { ...installLog, assets: remaining });
+      io.log(`  ${status.success(`install log updated (${remaining.length} asset(s) remain)`)}`);
+    } catch (e2) {
+      io.err(status.failure(c.red(`ERROR: install log \uAC31\uC2E0 \uC2E4\uD328 \u2014 ${installLogPath(projectDir)}`)));
+      io.err(c.dim(`       ${e2 instanceof Error ? e2.message : String(e2)}`));
+      io.err(c.dim(`       \uC2E4\uC81C\uB85C \uC81C\uAC70\uB41C \uC790\uC0B0: ${removedIds.join(", ") || "(\uC5C6\uC74C)"}`));
+      return true;
     }
-    cursor = dirname5(cursor);
+  } else {
+    io.rm(join19(projectDir, INSTALL_LOG_DIR));
+    io.rm(legacyInstallLogPath(projectDir));
+    io.log(`  ${status.success("install log removed")}`);
   }
+  return false;
 }
-function stripRootImport(projectDir) {
-  const current = readRootClaudeMd(projectDir);
-  const stripped = current === null ? null : stripHarnessImport(current);
-  if (stripped === null) return false;
-  try {
-    writeFileSync7(join16(projectDir, "CLAUDE.md"), stripped, "utf8");
-    return true;
-  } catch {
-    return false;
+function dryRunLines(plan, installLog, projectDir, keepTemplates, rootFiles, harnessRoot) {
+  const lines = [c.yellow("[DRY RUN] reverse list (\uC2E4\uC81C \uBCC0\uACBD \uC5C6\uC74C):"), ""];
+  if (plan.reverseSteps.length === 0) {
+    lines.push(c.dim("  (no project-scope assets to reverse)"));
   }
-}
-function previewExternalLines(installLog, projectDir) {
-  const lines = [];
-  let removable = 0;
-  for (const { path, sha256 } of installLog.externalFiles ?? []) {
-    const abs = join16(projectDir, path);
-    if (!existsSync17(abs)) continue;
-    if (hashContent(readFileSync15(abs, "utf8")) !== sha256) {
-      lines.push(`  \u25CB keep ${path} (modified since install \u2014 preserved)`);
-      continue;
+  lines.push(...plan.reverseSteps.map((s) => `  \u25CB ${s.label}`));
+  lines.push(
+    ...plan.noReversePath.map(
+      (a) => c.dim(`  \u2298 ${a.id} (${a.method}) \u2014 \uC790\uB3D9 \uB418\uB3CC\uB9AC\uAE30 \uACBD\uB85C \uC5C6\uC74C, \uAE30\uB85D \uC720\uC9C0`)
+    )
+  );
+  if (!keepTemplates) {
+    const dirs = recordedTemplateDirs(installLog);
+    for (const rel of dirs) {
+      if (existsSync18(join19(projectDir, rel))) lines.push(MOVE_ASIDE_PREVIEW(rel));
     }
-    removable += 1;
+    if (dirs.length === 0) lines.push("  \u25CB remove templates: (none)");
+    const rootMd = installLog.templates.rootClaudeMd;
+    if (rootMd) {
+      lines.push(
+        rootClaudeMdModified(installLog, projectDir) ? `  \u25CB keep ${rootMd.path} (modified since install \u2014 preserved)` : `  \u25CB remove ${rootMd.path}`
+      );
+    }
+    if (hasRootImport(projectDir)) {
+      lines.push("  \u25CB strip harness @import from CLAUDE.md (\uBCF8\uBB38 \uBCF4\uC874)");
+    }
+    lines.push(...previewExternalLines(installLog, projectDir, harnessRoot, dirs));
   }
-  if (removable > 0) lines.unshift(`  \u25CB remove ${removable} CLI output file(s)`);
+  lines.push(...advisoryLines(plan, projectDir, rootFiles), "");
   return lines;
 }
-function externalRemovalLines(external) {
+function advisoryLines(plan, projectDir, rootFiles) {
   const lines = [];
-  if (external.removed.length > 0) {
-    lines.push(`  ${status.success(`CLI outputs removed: ${external.removed.length} file(s)`)}`);
-  }
-  for (const path of external.kept) {
+  if (plan.globalAdvisories.length > 0) {
     lines.push(
-      `  ${c.yellow("\u2298")} ${path} kept \u2014 modified since install. Remove manually if intended.`
+      "",
+      c.yellow(
+        `[GLOBAL] ${plan.globalAdvisories.length} asset(s) at scope=global \u2014 manual removal required (D16):`
+      )
     );
+    for (const adv of plan.globalAdvisories) {
+      lines.push(c.dim(`  \xB7 ${adv.asset.id} (${adv.asset.method})`), c.dim(`      ${adv.command}`));
+    }
   }
+  lines.push(...rootFileAdvisoryLines(rootFiles, projectDir));
   return lines;
 }
-function hasRootImport(projectDir) {
-  const current = readRootClaudeMd(projectDir);
-  return current !== null && stripHarnessImport(current) !== null;
+function rootFileAdvisoryLines(rootFiles, projectDir) {
+  const present = rootFiles.filter((f) => existsSync18(join19(projectDir, f.path)));
+  if (present.length === 0) return [];
+  return [
+    "",
+    c.yellow("[ROOT] `.claude/` \uBC16\uC5D0 \uB0A8\uB294 \uAC83 (\uC790\uB3D9\uC73C\uB85C \uC9C0\uC6B0\uC9C0 \uC54A\uB294\uB2E4):"),
+    ...present.flatMap((f) => [
+      c.dim(
+        `  \xB7 ${f.path} \u2014 ${f.change === "created" ? "\uD558\uB124\uC2A4\uAC00 \uC0DD\uC131 (\uC218\uC815\uD55C \uC801 \uC5C6\uC73C\uBA74 \uC0AD\uC81C\uD574\uB3C4 \uC548\uC804)" : "\uAE30\uC874 \uC0AC\uC6A9\uC790 \uD30C\uC77C\uC5D0 \uBCD1\uD569 (\uC9C1\uC811 \uD655\uC778 \uD544\uC694)"}`
+      ),
+      c.dim(`      ${f.notes.join(" / ")}`)
+    ])
+  ];
 }
-function readRootClaudeMd(projectDir) {
-  const path = join16(projectDir, "CLAUDE.md");
-  if (!existsSync17(path)) return null;
-  try {
-    return readFileSync15(path, "utf8");
-  } catch {
+var TEMPLATE_DIR_FIELD = {
+  claude: "claudeDir",
+  codex: "codexDir",
+  opencode: "opencodeDir"
+};
+function resolveCliTarget(ctx, io) {
+  const { options, installLog } = ctx;
+  if (options.only !== void 0 || options.keepTemplates) {
+    io.err(status.failure(c.red("ERROR: --cli \uB294 --only \xB7 --keep-templates \uC640 \uD568\uAED8 \uC4F8 \uC218 \uC5C6\uB2E4")));
+    io.err(
+      c.dim(
+        "       CLI \uD558\uB098 \uC81C\uAC70: uninstall --cli <name>  /  \uC790\uC0B0 \uD558\uB098 \uC81C\uAC70: uninstall --only <id>"
+      )
+    );
+    io.exit(1);
     return null;
   }
-}
-function rootClaudeMdModified(log, projectDir) {
-  const rootMd = log.templates.rootClaudeMd;
-  if (!rootMd) return false;
-  const path = join16(projectDir, rootMd.path);
-  if (!existsSync17(path)) return false;
-  return hashContent(readFileSync15(path, "utf8")) !== rootMd.sha256;
-}
-function formatTemplateList(log) {
-  const items = [log.templates.claudeDir];
-  if (log.templates.codexDir) items.push(log.templates.codexDir);
-  if (log.templates.opencodeDir) items.push(log.templates.opencodeDir);
-  return items.join(", ");
-}
-function defaultSpawn2(cmd, args) {
-  return spawnSync2(cmd, [...args], { encoding: "utf8", stdio: "pipe", timeout: 12e4 });
-}
-function defaultRm(path) {
-  if (existsSync17(path)) {
-    rmSync(path, { recursive: true, force: true });
+  const target = (options.cli ?? "").trim();
+  if (!isCliBase(target)) {
+    io.err(status.failure(c.red(`ERROR: Invalid --cli value: ${target || "(empty)"}`)));
+    io.err(c.dim(`       Must be one of: ${CLI_BASES.join(" | ")}`));
+    io.exit(1);
+    return null;
   }
-}
-function registerUninstallCommand(cli2) {
-  cli2.command("uninstall", "Uninstall harness assets (log-based reverse)").option("--project-dir <path>", "[Project] Target project directory", {
-    default: process.cwd()
-  }).option("--dry-run", "[Mode] List reverse steps without executing").option(
-    "--keep-templates",
-    "[Mode] Keep `.claude/`, `.codex/`, `.opencode/` templates (remove only external assets)"
-  ).option(
-    "--only <ids>",
-    "[Scope] Remove only these assets (comma-separated ids from `agent-harness list`). Templates untouched"
-  ).option("--yes", "[Mode] Skip the interactive picker and remove everything (non-interactive)").action(async (options) => {
-    await dispatchUninstall(options);
-  });
-}
-function shouldRunInteractive(options, isTty) {
-  if (!isTty) return false;
-  if (options.yes || options.dryRun) return false;
-  return options.only === void 0;
-}
-async function dispatchUninstall(options) {
-  if (!shouldRunInteractive(options, Boolean(process.stdin.isTTY))) {
-    uninstallAction(options);
-    return;
+  const installed = installedClis(installLog);
+  if (!installed.includes(target)) {
+    io.err(status.failure(c.red(`ERROR: ${target} is not installed in this project`)));
+    io.err(c.dim(`       installed: ${installed.join(", ") || "(none)"}`));
+    io.exit(1);
+    return null;
   }
-  const projectDir = resolve4(options.projectDir ?? process.cwd());
-  const picked = await runInteractiveUninstall(projectDir);
-  if (!picked.ok || !picked.options) {
-    if (picked.reason === "no-log") {
-      console.error(
-        status.failure(c.red(`ERROR: install log not found at ${installLogPath(projectDir)}`))
-      );
-      console.error(c.dim("       Nothing installed here by agent-harness."));
-      process.exit(1);
-    }
-    return;
+  if (installed.length <= 1) {
+    io.err(status.failure(c.red(`ERROR: ${target} \uB294 \uC774 \uD504\uB85C\uC81D\uD2B8\uC758 \uB9C8\uC9C0\uB9C9 CLI \uB2E4`)));
+    io.err(c.dim("       \uC804\uB7C9 \uC81C\uAC70\uB294 `agent-harness uninstall` \uC744 \uC4F4\uB2E4 (\uC790\uC0B0\xB7\uC124\uCE58 \uAE30\uB85D\uAE4C\uC9C0 \uD568\uAED8)"));
+    io.exit(1);
+    return null;
   }
-  uninstallAction(picked.options);
+  return target;
 }
-
-// src/commands/update.ts
-init_esm_shims();
-import { resolve as resolve5 } from "path";
-
-// src/state.ts
-init_esm_shims();
-import { existsSync as existsSync18, readFileSync as readFileSync16 } from "fs";
-import { join as join17 } from "path";
-var META_FILE = ".claude/.installed-tracks";
-var LEGACY_SIGNATURES = [
-  { rule: "htmx.md", track: "ssr-htmx" },
-  { rule: "nextjs.md", track: "ssr-nextjs" },
-  { rule: "data-analysis.md", track: "data" },
-  { rule: "pyside6.md", track: "data" },
-  { rule: "cli-development.md", track: "tooling" }
-];
-function detectInstallState(projectDir) {
-  const claudeDir = join17(projectDir, ".claude");
-  const hasClaudeDir = existsSync18(claudeDir);
-  if (hasClaudeDir) {
-    const metaPath = join17(projectDir, META_FILE);
-    if (existsSync18(metaPath)) {
-      const tracks2 = readMetafile(metaPath);
-      return { state: "existing", tracks: tracks2, source: "metafile", hasClaudeDir: true };
-    }
-    const tracks = inferFromLegacySignatures(projectDir);
-    return { state: "existing", tracks, source: "legacy", hasClaudeDir: true };
-  }
-  const log = readInstallLog(projectDir);
-  if (log) {
-    return {
-      state: "existing",
-      tracks: tracksFromLog(log.spec.tracks),
-      source: "install-log",
-      hasClaudeDir: false
-    };
-  }
-  return { state: "new", tracks: [], source: "none", hasClaudeDir: false };
+function underAny(path, owned) {
+  return owned.some((o) => o.endsWith("/") ? path.startsWith(o) : path === o);
 }
-function tracksFromLog(tracks) {
-  return [...new Set(tracks.filter(isTrack))].sort();
+function planCliRemoval(target, remaining, installLog) {
+  const { exclusive, sharedNowUnowned } = removableFor(target, remaining);
+  const owned = [...exclusive, ...sharedNowUnowned];
+  const recorded = owned.filter((o) => o.kind === "recorded").map((o) => o.path);
+  const scopedFiles = (installLog.externalFiles ?? []).filter(
+    (f) => underAny(f.path, recorded)
+  );
+  return {
+    dirs: owned.filter((o) => o.kind === "dir").map((o) => o.path),
+    scoped: { ...installLog, externalFiles: scopedFiles },
+    anchor: owned.some((o) => o.kind === "anchor"),
+    importBlock: owned.some((o) => o.kind === "import-block")
+  };
 }
-function readMetafile(path) {
-  const raw = readFileSync16(path, "utf8");
-  const seen = /* @__PURE__ */ new Set();
-  for (const line of raw.split(/\s+/)) {
-    const trimmed = line.trim();
-    if (isTrack(trimmed)) {
-      seen.add(trimmed);
-    }
+function removeCliHeader(target, installed, remaining) {
+  return [
+    "",
+    c.bold(`uzys-agent-harness \xB7 uninstall --cli ${target}`),
+    "",
+    c.dim(`  installed: ${installed.join(", ")}`),
+    c.dim(`  removing:  ${target}`),
+    c.dim(`  remaining: ${remaining.join(", ")}`),
+    ""
+  ];
+}
+function removeCliDryRunLines(plan, ctx, remaining) {
+  const { installLog, projectDir, harnessRoot } = ctx;
+  const lines = [c.yellow("[DRY RUN] CLI \uC81C\uAC70 \uBBF8\uB9AC\uBCF4\uAE30 (\uC2E4\uC81C \uBCC0\uACBD \uC5C6\uC74C):"), ""];
+  for (const dir of plan.dirs) {
+    if (existsSync18(join19(projectDir, dir))) lines.push(MOVE_ASIDE_PREVIEW(dir));
+  }
+  lines.push(...previewExternalLines(plan.scoped, projectDir, harnessRoot));
+  const rootMd = plan.anchor ? installLog.templates.rootClaudeMd : void 0;
+  if (rootMd && existsSync18(join19(projectDir, rootMd.path))) {
+    lines.push(
+      rootClaudeMdModified(installLog, projectDir) ? `  \u25CB keep ${rootMd.path} (modified since install \u2014 preserved)` : `  \u25CB remove ${rootMd.path}`
+    );
   }
-  return [...seen].sort();
-}
-function inferFromLegacySignatures(projectDir) {
-  const rulesDir = join17(projectDir, ".claude/rules");
-  if (!existsSync18(rulesDir)) {
-    return [];
+  if (plan.importBlock && hasRootImport(projectDir)) {
+    lines.push("  \u25CB strip harness @import from CLAUDE.md (\uBCF8\uBB38 \uBCF4\uC874)");
   }
-  const found = /* @__PURE__ */ new Set();
-  for (const sig of LEGACY_SIGNATURES) {
-    if (existsSync18(join17(rulesDir, sig.rule))) {
-      found.add(sig.track);
-    }
+  lines.push(`  \u25CB install log updated (clis: ${remaining.join(", ")})`, "");
+  return lines;
+}
+function removeHarnessAnchor(ctx, io) {
+  const { installLog, projectDir } = ctx;
+  const rootMd = installLog.templates.rootClaudeMd;
+  if (!rootMd || !existsSync18(join19(projectDir, rootMd.path))) return false;
+  if (rootClaudeMdModified(installLog, projectDir)) {
+    io.log(
+      `  ${c.yellow("\u2298")} ${rootMd.path} kept \u2014 modified since install. Remove manually if intended.`
+    );
+    return false;
   }
-  return [...found].sort();
+  io.rm(join19(projectDir, rootMd.path));
+  io.log(`  ${status.success(`${rootMd.path} removed`)}`);
+  return true;
 }
-
-// src/commands/update.ts
-function updateAction(options = {}, deps = {}) {
-  const log = deps.log ?? console.log;
-  const err = deps.err ?? console.error;
-  const exit = deps.exit ?? ((code) => process.exit(code));
-  const detect = deps.detect ?? detectInstallState;
-  const execute = deps.execute ?? executeSpec;
-  const projectDir = resolve5(options.projectDir ?? process.cwd());
-  const state = detect(projectDir);
-  if (state.state === "new") {
-    err(status.failure(c.red(`No harness install found at ${projectDir}`)));
-    err(c.dim("  Run `agent-harness install --track <name>` first."));
-    exit(1);
+function settleCliLog(ctx, target, remaining, recovered, anchorRemoved, removedDirs) {
+  const { installLog } = ctx;
+  const next = {
+    ...installLog,
+    spec: {
+      ...installLog.spec,
+      // `spec.cli` 는 손대지 않는다 — "마지막 install 이 요청한 CLI" 라는 뜻이고, 빼면 빈 배열이
+      // 된다(재리뷰 BLOCKER-3: 외부 스킬 refresh 가 그 값으로 `--agent`·`--copy` 를 조립하다
+      // 빈 배열이면 둘 다 빠져 Claude 몫이 조용히 빠졌다). 깔린 집합은 `clis` 하나가 말한다.
+      clis: [...remaining]
+    },
+    templates: { ...installLog.templates }
+  };
+  const field = TEMPLATE_DIR_FIELD[target];
+  if (field) delete next.templates[field];
+  if (anchorRemoved) delete next.templates.rootClaudeMd;
+  const survivors = (installLog.externalFiles ?? []).filter(
+    (f) => !recovered.has(f.path) && !underAny(f.path, removedDirs)
+  );
+  if (survivors.length > 0) next.externalFiles = survivors;
+  else delete next.externalFiles;
+  return next;
+}
+function removeCliAction(ctx, io) {
+  const target = resolveCliTarget(ctx, io);
+  if (target === null) return;
+  const { options, installLog, projectDir, harnessRoot } = ctx;
+  const installed = installedClis(installLog);
+  const remaining = installed.filter((cli2) => cli2 !== target);
+  const plan = planCliRemoval(target, remaining, installLog);
+  for (const line of removeCliHeader(target, installed, remaining)) io.log(line);
+  if (options.dryRun) {
+    for (const line of removeCliDryRunLines(plan, ctx, remaining)) io.log(line);
+    io.exit(0);
     return;
   }
-  const rawOnly = options.only === void 0 ? [] : [options.only].flat().map((v2) => typeof v2 === "string" ? v2 : "(missing value)");
-  const parsed = parseUpdateOnly(rawOnly);
-  if (!parsed.ok) {
-    err(status.failure(c.red(`Unknown --only value: ${parsed.invalid.join(", ")}`)));
-    err(c.dim(`  Valid groups: ${UPDATE_GROUPS.join(" | ")}`));
-    exit(1);
+  for (const dir of plan.dirs) {
+    if (!existsSync18(join19(projectDir, dir))) continue;
+    const backup = io.moveAside(templateDirPath(projectDir, dir));
+    if (backup) io.log(movedAsideLine(projectDir, dir, backup));
+  }
+  const external = removeExternalFiles(plan.scoped, projectDir, io.rm, harnessRoot);
+  for (const line of externalRemovalLines(external)) io.log(line);
+  if (plan.importBlock && stripRootImport(projectDir)) {
+    io.log(`  ${status.success("CLAUDE.md \u2014 harness @import removed (\uBCF8\uBB38 \uBCF4\uC874)")}`);
+  }
+  const anchorRemoved = plan.anchor ? removeHarnessAnchor(ctx, io) : false;
+  const recovered = /* @__PURE__ */ new Set([...external.removed, ...external.stripped]);
+  const next = settleCliLog(ctx, target, remaining, recovered, anchorRemoved, plan.dirs);
+  try {
+    io.writeLog(projectDir, next);
+    io.log(`  ${status.success(`install log updated (clis: ${remaining.join(", ")})`)}`);
+  } catch (e2) {
+    io.err(status.failure(c.red(`ERROR: install log \uAC31\uC2E0 \uC2E4\uD328 \u2014 ${installLogPath(projectDir)}`)));
+    io.err(c.dim(`       ${e2 instanceof Error ? e2.message : String(e2)}`));
+    io.log("");
+    io.log(
+      c.yellow(`${target} \uB294 \uC81C\uAC70\uB410\uC73C\uB098 install log \uB97C \uAC31\uC2E0\uD558\uC9C0 \uBABB\uD588\uB2E4 (\uAE30\uB85D\uC774 \uC2E4\uC81C\uC640 \uB2E4\uB974\uB2E4)`)
+    );
+    io.exit(1);
     return;
   }
-  log(c.dim(`Updating installed harness files in ${projectDir}`));
-  execute(buildUpdateSpec(projectDir, state.tracks, parsed.groups), {
-    log,
-    err,
-    exit,
-    mode: "update"
-  });
-}
-function registerUpdateCommand(cli2) {
-  cli2.command(
-    "update",
-    "Refresh installed policy files (rules / agents / commands / hooks / skills)"
-  ).option("--project-dir <path>", "[Project] Target project directory", {
-    default: process.cwd()
-  }).option(
-    "--only <group>",
-    `[Scope] Update only this group (repeatable): ${UPDATE_GROUPS.join(" | ")}`
-  ).action((options) => {
-    updateAction(options);
-  });
+  io.log("");
+  io.log(status.success(c.green(`${target} removed (remaining: ${remaining.join(", ")})`)));
+  io.exit(0);
 }
-
-// src/interactive.ts
-init_esm_shims();
-
-// src/prompts.ts
-init_esm_shims();
-
-// src/router.ts
-init_esm_shims();
-function buildRouterChoices(state) {
-  const detected = state.tracks.length > 0 ? state.tracks.join(", ") : "(none detected)";
-  return [
-    {
-      value: "add",
-      label: "Add a new Track",
-      hint: `Current: ${detected}`,
-      enabled: true
-    },
-    {
-      value: "update",
-      label: "Update policy files (auto-backup)",
-      // v26.126.0 (R-3a) — skills 가 목록에 들어왔다. 이 문구가 곧 update 의 광고이고
-      // (update 는 위저드로만 도달한다) 실동작과 어긋나면 그 자체로 거짓출하다.
-      hint: "Refresh rules / agents / commands / hooks / skills \u2014 your edits are backed up",
-      enabled: true
-    },
-    {
-      value: "remove",
-      label: "Remove a Track (unsupported)",
-      hint: "Manual edit of .claude/ required \u2014 not automated",
-      enabled: false
-    },
-    {
-      value: "reinstall",
-      label: "Reinstall (backs up current .claude/ first)",
-      hint: "Use when state is corrupted",
-      enabled: true
-    },
-    {
-      value: "exit",
-      label: "Exit",
-      enabled: true
+function planReverse(assets, spawn) {
+  const reverseSteps = [];
+  const globalAdvisories = [];
+  const noReversePath = [];
+  for (const asset of assets) {
+    if (asset.scope === "global") {
+      globalAdvisories.push({ asset, command: buildGlobalAdvisoryCmd(asset) });
+      continue;
     }
-  ];
+    const step = buildProjectReverseStep(asset, spawn);
+    if (step) reverseSteps.push(step);
+    else noReversePath.push(asset);
+  }
+  return { reverseSteps, globalAdvisories, noReversePath };
 }
-function summarizeState(state) {
-  if (state.state === "new") {
-    return "No prior install detected \u2014 new install flow.";
+function buildProjectReverseStep(asset, spawn) {
+  switch (asset.method) {
+    case "plugin": {
+      const pluginId = asset.detail.pluginId ?? asset.id;
+      return {
+        assetId: asset.id,
+        label: `claude plugin uninstall --scope project ${pluginId}`,
+        execute: () => {
+          const r = spawn("claude", ["plugin", "uninstall", "--scope", "project", pluginId]);
+          return r.status === 0 ? { ok: true } : { ok: false, message: (r.stderr || "").trim() };
+        }
+      };
+    }
+    case "skill": {
+      const source = asset.detail.source ?? asset.id;
+      return {
+        assetId: asset.id,
+        label: `npx skills remove ${source}`,
+        execute: () => {
+          const r = spawn("npx", [skillsCliSpec(), "remove", source, "--yes"]);
+          return r.status === 0 ? { ok: true } : { ok: false, message: (r.stderr || "").trim() };
+        }
+      };
+    }
+    case "npm": {
+      const pkg = asset.detail.pkg ?? asset.id;
+      return {
+        assetId: asset.id,
+        label: `npm uninstall --save-dev ${pkg}`,
+        execute: () => {
+          const r = spawn("npm", ["uninstall", "--save-dev", pkg]);
+          return r.status === 0 ? { ok: true } : { ok: false, message: (r.stderr || "").trim() };
+        }
+      };
+    }
+    case "npx-run":
+      return null;
+    case "shell-script":
+      return null;
+    case "internal":
+      return null;
   }
-  const trackList = state.tracks.length > 0 ? state.tracks.join(", ") : "(no tracks resolved)";
-  const sourceLabel = state.source === "metafile" ? "via .claude/.installed-tracks" : state.source === "legacy" ? "via legacy rules/*.md heuristic" : state.source === "install-log" ? "via .uzys-agent-harness/ install log" : "via no source";
-  return `Existing install detected ${sourceLabel}. Tracks: ${trackList}.`;
 }
-
-// src/wizard-steps.ts
-init_esm_shims();
-var WIZARD_TOTAL = 6;
-var WIZARD = {
-  TRACKS: { current: 1, total: WIZARD_TOTAL },
-  CLI: { current: 2, total: WIZARD_TOTAL },
-  TARGETS: { current: 3, total: WIZARD_TOTAL },
-  SCOPE: { current: 4, total: WIZARD_TOTAL },
-  CONFIRM: { current: 5, total: WIZARD_TOTAL },
-  INSTALL: { current: 6, total: WIZARD_TOTAL }
-};
-function stepLabel(step, suffix) {
-  if (!step) return suffix;
-  return `Step ${step.current}/${step.total} \u2014 ${suffix}`;
+function unknownIds(installLog, selectedIds) {
+  const known = new Set(installLog.assets.map((a) => a.id));
+  return selectedIds.filter((id) => !known.has(id));
 }
-
-// src/prompts.ts
-var TRACK_LABELS = {
-  base: "base \u2014 principles \xB7 methodology \xB7 tests only (no stack)",
-  tooling: "tooling \u2014 Bash + Markdown meta-project",
-  "csr-supabase": "csr-supabase \u2014 Vite + React + Supabase",
-  "csr-fastify": "csr-fastify \u2014 Vite + React + Fastify",
-  "csr-fastapi": "csr-fastapi \u2014 Vite + React + FastAPI",
-  "ssr-htmx": "ssr-htmx \u2014 htmx + FastAPI",
-  "ssr-nextjs": "ssr-nextjs \u2014 Next.js (App Router)",
-  data: "data \u2014 Python data / DuckDB / PySide6",
-  executive: "executive \u2014 proposals / DD / pitch (no agent-skills)",
-  full: "full \u2014 all dev capabilities",
-  "project-management": "project-management \u2014 PM / Scrum / Jira / Confluence",
-  "growth-marketing": "growth-marketing \u2014 Growth / Marketing / Content"
-};
-var VISIBLE_OPTION_DEFS = [];
-var CLI_BASE_LABELS = {
-  claude: "Claude Code",
-  codex: "Codex (OpenAI)",
-  opencode: "OpenCode (anomalyco)",
-  antigravity: "Antigravity (Google)"
-};
-var INSTALL_TARGET_PAGES = [
-  // 2026-08-16 — 트랙이 고르는 자산을 **맨 앞에서** 전부 보여준다. 그전까지 이 항목들은 화면에
-  // 한 번도 안 나온 채 깔렸고, 사용자는 설치가 끝난 뒤 요약에서 처음 봤다.
-  //
-  // 2페이지로 나눈 근거는 실측이다: 최대 트랙(`full`)이 32항목(당시 실측 — rules 6 · agents 9 · hooks 3 ·
-  // skills 14)이라 clack groupMultiselect 의 "페이지당 ≤ ~30행" 제약을 한 페이지로는 못 지킨다.
-  // 가르는 축은 역할이다 — 정책·가드가 한쪽, 실행 능력이 다른 쪽.
-  { label: "Track baseline \u2014 Rules & Hooks (\uC815\uCC45\xB7\uAC00\uB4DC)", cats: [], baseline: ["rules", "hooks"] },
-  {
-    label: "Track baseline \u2014 Agents & Skills (\uC5D0\uC774\uC804\uD2B8\xB7\uC2A4\uD0AC)",
-    cats: [],
-    baseline: ["agents", "skills"]
-  },
-  { label: "Dev Core (Frontend \xB7 Backend \xB7 Data)", cats: ["frontend", "backend", "data"] },
-  { label: "Dev Tools (Security \xB7 Quality \xB7 Understanding)", cats: ["dev-tools", "understanding"] },
-  { label: "Business (PM \xB7 Executive \xB7 Documents)", cats: ["business"] },
-  // v26.85.0 — 코드-퍼스트 비주얼/미디어 제작 (용도별 섹션, 전부 opt-in).
-  { label: "Visual & Media (Slides \xB7 Diagrams \xB7 Motion \xB7 Video)", cats: ["visual-media"] },
-  { label: "Workflow", cats: ["workflow"] }
-];
-var BASELINE_TITLES = {
-  rules: "Rules \u2014 \uC0C1\uC2DC \uC0C1\uC8FC\uD558\uB294 \uB300\uC6D0\uCE59 (4 CLI \uC804\uBD80\uC5D0 \uC124\uCE58)",
-  hooks: "Hooks \u2014 \uACB0\uC815\uB860\uC801 \uAC00\uB4DC (\uD574\uC81C\uD558\uBA74 settings.json \uBC30\uC120\uB3C4 \uD568\uAED8 \uBE60\uC9C4\uB2E4)",
-  agents: "Agents \u2014 \uB3C5\uB9BD \uB808\uC778 (\uB9AC\uBDF0\xB7\uAC80\uC99D)",
-  skills: "Skills \u2014 \uD544\uC694\uD560 \uB54C \uC5F4\uB9AC\uB294 \uC791\uC5C5 \uC808\uCC28"
-};
-function buildPageGroups(cats, initialSet, installedSet = /* @__PURE__ */ new Set(), baselineKinds = [], baselineTargets = []) {
-  const installedMark = (value) => installedSet.has(value) ? "  \u25CF installed" : "";
-  const groups = {};
-  const flatItems = [];
-  for (const kind of baselineKinds) {
-    const items = baselineTargets.filter((t) => t.kind === kind).map((t) => ({
-      value: t.id,
-      label: `    ${t.name}${installedMark(t.id)}`,
-      ...t.hint ? { hint: t.hint } : {}
-    }));
-    if (items.length === 0) continue;
-    groups[BASELINE_TITLES[kind]] = items;
-    flatItems.push(...items);
-  }
-  for (const cat of cats) {
-    const items = [];
-    for (const o of VISIBLE_OPTION_DEFS.filter((d2) => d2.category === cat)) {
-      items.push({
-        value: `option:${o.key}`,
-        // v26.62.3 — group header 와 옵션 사이 시각 hierarchy 강화. label prefix 4 space.
-        label: `    ${o.label}  [${o.source}]${installedMark(`option:${o.key}`)}`,
-        hint: o.hint
-      });
-    }
-    const tierOrder = { official: 0, vetted: 1, experimental: 2 };
-    const catAssets = [...EXTERNAL_ASSETS.filter((x) => x.category === cat)].sort(
-      (a, b2) => tierOrder[assetTrustTier(a.id)] - tierOrder[assetTrustTier(b2.id)]
-    );
-    for (const a of catAssets) {
-      const tier = assetTrustTier(a.id);
-      const badge = tier === "official" ? "  \u2605 official" : tier === "experimental" ? "  \u26A0 experimental (opt-in)" : "";
-      items.push({
-        value: `asset:${a.id}`,
-        label: `    ${a.id}  [${a.source}]${badge}${installedMark(`asset:${a.id}`)}`,
-        hint: a.description
-      });
+function parseOnly(only) {
+  if (!only) return null;
+  const ids = only.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  return ids.length > 0 ? ids : null;
+}
+function buildGlobalAdvisoryCmd(asset) {
+  switch (asset.method) {
+    case "plugin": {
+      const pid = asset.detail.pluginId ?? asset.id;
+      return `claude plugin uninstall --scope user ${pid}`;
     }
-    if (items.length === 0) continue;
-    const selectedInCat = items.filter((it3) => initialSet.has(it3.value)).length;
-    const header = `${CATEGORY_TITLES[cat]}  [${selectedInCat}/${items.length} \u2713 default]`;
-    groups[header] = items;
-    flatItems.push(...items);
+    case "skill": {
+      const s = asset.detail.source ?? asset.id;
+      return `npx skills remove -g ${s}`;
+    }
+    case "npm": {
+      const pkg = asset.detail.pkg ?? asset.id;
+      return `npm uninstall -g ${pkg}`;
+    }
+    case "npx-run":
+    case "shell-script":
+    case "internal":
+      return "(no standard reverse \u2014 manual)";
   }
-  return { groups, flatItems };
 }
-function assertPagesCoverAllCategories(pages) {
-  const counts = /* @__PURE__ */ new Map();
-  for (const page of pages) {
-    for (const cat of page.cats) counts.set(cat, (counts.get(cat) ?? 0) + 1);
+function removeTemplates(log, projectDir, io, harnessRoot) {
+  const { rm } = io;
+  const moved = recordedTemplateDirs(log).flatMap((rel) => {
+    const backup = io.moveAside(templateDirPath(projectDir, rel));
+    return backup ? [{ rel, backup }] : [];
+  });
+  const external = removeExternalFiles(log, projectDir, rm, harnessRoot);
+  const importStripped = stripRootImport(projectDir);
+  const rootMd = log.templates.rootClaudeMd;
+  if (rootMd) {
+    if (rootClaudeMdModified(log, projectDir))
+      return { rootClaudeMdKept: true, importStripped, external, moved };
+    rm(join19(projectDir, rootMd.path));
   }
-  const missing = CATEGORIES.filter((c3) => !counts.has(c3));
-  const duplicated = CATEGORIES.filter((c3) => (counts.get(c3) ?? 0) > 1);
-  if (missing.length > 0 || duplicated.length > 0) {
-    throw new Error(
-      `INSTALL_TARGET_PAGES drift vs CATEGORIES \u2014 missing=[${missing.join(", ")}] duplicated=[${duplicated.join(", ")}]. \uBAA8\uB4E0 \uCE74\uD14C\uACE0\uB9AC\uB294 \uC815\uD655\uD788 \uD55C \uD398\uC774\uC9C0\uC5D0 \uBC30\uCE58\uD574\uC57C \uD55C\uB2E4 (no-false-ship: wizard \uBBF8\uB178\uCD9C = \uAC70\uC9D3 \uAD11\uACE0).`
-    );
+  return { rootClaudeMdKept: false, importStripped, external, moved };
+}
+var AGENTS_MD = "AGENTS.md";
+function readAgentsMdTemplate(harnessRoot, log) {
+  const flavor = log.templates.opencodeDir ? "opencode" : "codex";
+  try {
+    return readFileSync16(join19(harnessRoot, "templates", flavor, "AGENTS.md.template"), "utf8");
+  } catch {
+    return null;
   }
 }
-assertPagesCoverAllCategories(INSTALL_TARGET_PAGES);
-function viewportItems(itemCount) {
-  const rows = process.stdout.rows ?? 24;
-  return Math.max(8, Math.min(itemCount, rows - 10));
+function agentsMdRemainder(current, harnessRoot, log) {
+  const template = readAgentsMdTemplate(harnessRoot, log);
+  if (template === null) return { ok: false };
+  return { ok: true, remainder: stripHarnessFromAgentsMd({ existing: current, template }) };
 }
-var defaultPrompts = {
-  intro: (msg) => ge(msg),
-  outro: (msg) => ye(msg),
-  cancel: (msg) => me(msg),
-  selectTracks: async (initial, step) => {
-    const result = await ve({
-      message: stepLabel(step, "Select Track(s)"),
-      options: TRACKS.map((t) => ({ value: t, label: TRACK_LABELS[t] })),
-      ...initial ? { initialValues: initial } : {},
-      maxItems: viewportItems(11),
-      required: true
-    });
-    return q(result) ? null : result;
-  },
-  selectCli: async (initial, step) => {
-    const initialValues = initial && initial.length > 0 ? [...initial] : ["claude"];
-    const result = await ve({
-      message: stepLabel(step, "Target CLI(s)"),
-      options: [
-        { value: "claude", label: CLI_BASE_LABELS.claude },
-        { value: "codex", label: CLI_BASE_LABELS.codex },
-        { value: "opencode", label: CLI_BASE_LABELS.opencode },
-        { value: "antigravity", label: CLI_BASE_LABELS.antigravity }
-      ],
-      initialValues,
-      required: true
-    });
-    if (q(result)) return null;
-    return [...result].sort(
-      (a, b2) => CLI_BASE_SORT_ORDER[a] - CLI_BASE_SORT_ORDER[b2]
-    );
-  },
-  selectAction: async (state) => {
-    const result = await Ee({
-      message: summarizeState(state),
-      options: buildRouterChoices(state).map((c3) => {
-        const label = c3.enabled ? c3.label : `${c3.label} [disabled]`;
-        return {
-          value: c3.value,
-          label,
-          ...c3.hint ? { hint: c3.hint } : {},
-          ...c3.enabled ? {} : { disabled: true }
-        };
-      })
-    });
-    return q(result) ? null : result;
-  },
-  /**
-   * v26.64.0 (ADR-020) — Installation scope select. Default Project (D16 — no global write).
-   * Global 은 사용자 명시 opt-in 시에만.
-   */
-  selectScope: async (initial = "project", step) => {
-    const result = await Ee({
-      message: stepLabel(step, "Installation scope"),
-      initialValue: initial,
-      options: [
-        {
-          value: "project",
-          label: "Project",
-          hint: "Install in current directory (committed with your project)"
-        },
-        {
-          value: "global",
-          label: "Global",
-          hint: "Write to ~/.claude/, ~/.codex/, npm -g (shared across all projects)"
-        }
-      ]
-    });
-    return q(result) ? null : result;
-  },
-  selectUpdateGroups: async () => {
-    const result = await ve({
-      message: "What to update  (space = toggle \xB7 your edits are always backed up)",
-      options: [
-        { value: "skills", label: "Skills", hint: "installed bundled skills \u2192 latest" },
-        {
-          value: "new-skills",
-          label: "New skills",
-          hint: "bundled skills added since your install"
-        },
-        {
-          value: "rules",
-          label: "Rules \xB7 agents \xB7 commands",
-          hint: "your edited files \u2192 *.backup-<time>"
-        },
-        {
-          value: "anchor",
-          label: "CLAUDE-uzys-harness.md anchor",
-          hint: "your edited anchor \u2192 *.backup-<time>"
-        },
-        {
-          value: "hooks",
-          label: "Hooks \xB7 settings.json",
-          hint: "stale hook refs cleaned"
-        },
-        {
-          value: "external",
-          label: "Codex / OpenCode / Antigravity + external skills",
-          hint: "rendered artifacts + npx skills"
+function removeExternalFiles(log, projectDir, rm, harnessRoot) {
+  const removed = [];
+  const kept = [];
+  const stripped = [];
+  const unjudged = [];
+  for (const { path, sha256 } of log.externalFiles ?? []) {
+    const abs = join19(projectDir, path);
+    if (!existsSync18(abs)) continue;
+    if (!lstatSync2(abs).isFile()) continue;
+    const current = readFileSync16(abs, "utf8");
+    if (hashContent(current) !== sha256) {
+      kept.push(path);
+      continue;
+    }
+    if (path === AGENTS_MD) {
+      const verdict = agentsMdRemainder(current, harnessRoot, log);
+      if (!verdict.ok) {
+        unjudged.push(path);
+        continue;
+      }
+      if (verdict.remainder !== null) {
+        try {
+          writeFileSync7(abs, verdict.remainder, "utf8");
+          stripped.push(path);
+        } catch {
+          unjudged.push(path);
         }
-      ],
-      initialValues: [...UPDATE_GROUPS],
-      required: true
-    });
-    return q(result) ? null : result;
-  },
-  confirmInstall: async (summary) => {
-    const result = await ue({
-      message: `${summary}
-
-Proceed?`,
-      initialValue: true
-    });
-    return q(result) ? null : result;
-  },
-  selectInstallTargets: async (initialChecked, step, recap) => {
-    const pages = INSTALL_TARGET_PAGES;
-    const baselineTargets = withBaselineHints(listBaselineTargets({ tracks: recap?.tracks ?? [] }));
-    const initialSet = new Set(initialChecked);
-    const collected = new Set(initialChecked);
-    const recapLine = recap ? `Tracks: ${recap.tracks.join(", ")}  \xB7  CLIs: ${recap.cli.join(", ")}` : "";
-    const installedSet = new Set(recap?.installed ?? []);
-    process.stdout.write("\x1B[?1049h");
-    let resultIds = null;
-    let aborted = false;
+        continue;
+      }
+    }
+    rm(abs);
+    removed.push(path);
+  }
+  for (const path of removed) pruneEmptyDirsUpward(projectDir, dirname5(join19(projectDir, path)));
+  return { removed, kept, stripped, unjudged };
+}
+function pruneEmptyDirsUpward(projectDir, startDir) {
+  let cursor = startDir;
+  while (true) {
+    const rel = relative2(projectDir, cursor);
+    if (rel === "" || rel.startsWith(`..${sep3}`) || rel === "..") return;
     try {
-      let pageIdx = 0;
-      let dir = 1;
-      while (pageIdx < pages.length) {
-        const page = pages[pageIdx];
-        if (!page) break;
-        const { groups, flatItems } = buildPageGroups(
-          page.cats,
-          initialSet,
-          installedSet,
-          page.baseline ?? [],
-          baselineTargets
-        );
-        if (flatItems.length === 0) {
-          pageIdx += dir;
-          if (pageIdx < 0) {
-            aborted = true;
-            break;
-          }
-          continue;
-        }
-        const selectedNow = flatItems.filter((it3) => collected.has(it3.value)).map((it3) => it3.value);
-        const pageDefault = flatItems.filter((it3) => initialSet.has(it3.value)).length;
-        const totalSelected = collected.size;
-        const message = [
-          `Step ${step.current}/${step.total}  \xB7  Page ${pageIdx + 1}/${pages.length}  \xB7  ${page.label}`,
-          recapLine ? `  ${recapLine}` : "",
-          `  Selected so far: ${totalSelected} items  \xB7  This page default \u2713 ${pageDefault}/${flatItems.length}`,
-          // 마커의 뜻을 화면에서 바로 알려준다 — 체크 해제를 제거로 오해하는 것이 이 화면의
-          // 원래 문제였으므로, 마커가 보일 때는 제거 경로를 같은 자리에서 말한다.
-          installedSet.size > 0 ? "  \u25CF installed = \uC774\uBBF8 \uC124\uCE58\uB428 \xB7 \uCCB4\uD06C \uD574\uC81C\uD574\uB3C4 \uC81C\uAC70\uB418\uC9C0 \uC54A\uB294\uB2E4 (\uC81C\uAC70: agent-harness uninstall)" : "",
-          "  Space toggle \xB7 Enter \u2192 next \xB7 ESC \u2192 prev"
-        ].filter(Boolean).join("\n");
-        const groupOpts = {
-          message,
-          options: groups,
-          initialValues: selectedNow,
-          required: false,
-          selectableGroups: false
-        };
-        const result = await pe(groupOpts);
-        if (q(result)) {
-          if (pageIdx === 0) {
-            aborted = true;
-            break;
-          }
-          dir = -1;
-          pageIdx--;
-          continue;
-        }
-        for (const it3 of flatItems) collected.delete(it3.value);
-        for (const v2 of result) collected.add(v2);
-        dir = 1;
-        pageIdx++;
+      if (readdirSync6(cursor).length > 0) return;
+      rmdirSync2(cursor);
+    } catch {
+      return;
+    }
+    cursor = dirname5(cursor);
+  }
+}
+function stripRootImport(projectDir) {
+  const current = readRootClaudeMd(projectDir);
+  const stripped = current === null ? null : stripHarnessImport(current);
+  if (stripped === null) return false;
+  try {
+    writeFileSync7(join19(projectDir, "CLAUDE.md"), stripped, "utf8");
+    return true;
+  } catch {
+    return false;
+  }
+}
+function previewExternalLines(installLog, projectDir, harnessRoot, movedDirs = []) {
+  const lines = [];
+  let removable = 0;
+  for (const { path, sha256 } of installLog.externalFiles ?? []) {
+    const abs = join19(projectDir, path);
+    if (underAny(path, movedDirs)) continue;
+    if (!existsSync18(abs)) continue;
+    if (!lstatSync2(abs).isFile()) continue;
+    const current = readFileSync16(abs, "utf8");
+    if (hashContent(current) !== sha256) {
+      lines.push(`  \u25CB keep ${path} (modified since install \u2014 preserved)`);
+      continue;
+    }
+    if (path === AGENTS_MD) {
+      const verdict = agentsMdRemainder(current, harnessRoot, installLog);
+      if (!verdict.ok) {
+        lines.push(`  \u25CB keep ${path} (harness sections could not be separated \u2014 preserved)`);
+        continue;
       }
-      if (!aborted) {
-        resultIds = [...collected];
+      if (verdict.remainder !== null) {
+        lines.push(`  \u25CB strip harness sections from ${path} (\uBCF8\uBB38 \uBCF4\uC874)`);
+        continue;
       }
-    } finally {
-      process.stdout.write("\x1B[?1049l");
     }
-    if (resultIds !== null) {
-      process.stdout.write(
-        `\u25C7  Step ${step.current}/${step.total} \u2014 Install targets  \xB7  ${resultIds.length} selected
-\u2502
-`
+    removable += 1;
+  }
+  if (removable > 0) lines.unshift(`  \u25CB remove ${removable} CLI output file(s)`);
+  return lines;
+}
+function externalRemovalLines(external) {
+  const lines = [];
+  if (external.removed.length > 0) {
+    lines.push(`  ${status.success(`CLI outputs removed: ${external.removed.length} file(s)`)}`);
+  }
+  for (const path of external.stripped) {
+    lines.push(`  ${status.success(`${path} \u2014 harness sections removed (\uBCF8\uBB38 \uBCF4\uC874)`)}`);
+  }
+  for (const path of external.unjudged) {
+    lines.push(
+      `  ${c.yellow("\u2298")} ${path} kept \u2014 harness sections could not be separated (template unreadable or write failed). Remove manually if intended.`
+    );
+  }
+  for (const path of external.kept) {
+    lines.push(
+      `  ${c.yellow("\u2298")} ${path} kept \u2014 modified since install. Remove manually if intended.`
+    );
+  }
+  return lines;
+}
+function hasRootImport(projectDir) {
+  const current = readRootClaudeMd(projectDir);
+  return current !== null && stripHarnessImport(current) !== null;
+}
+function readRootClaudeMd(projectDir) {
+  const path = join19(projectDir, "CLAUDE.md");
+  if (!existsSync18(path)) return null;
+  try {
+    return readFileSync16(path, "utf8");
+  } catch {
+    return null;
+  }
+}
+function rootClaudeMdModified(log, projectDir) {
+  const rootMd = log.templates.rootClaudeMd;
+  if (!rootMd) return false;
+  const path = join19(projectDir, rootMd.path);
+  if (!existsSync18(path)) return false;
+  return hashContent(readFileSync16(path, "utf8")) !== rootMd.sha256;
+}
+function defaultSpawn2(cmd, args) {
+  return spawnSync2(cmd, [...args], { encoding: "utf8", stdio: "pipe", timeout: 12e4 });
+}
+function defaultRm(path) {
+  if (existsSync18(path)) {
+    rmSync(path, { recursive: true, force: true });
+  }
+}
+function registerUninstallCommand(cli2) {
+  cli2.command("uninstall", "Uninstall harness assets (log-based reverse)").option("--project-dir <path>", "[Project] Target project directory", {
+    default: process.cwd()
+  }).option("--dry-run", "[Mode] List reverse steps without executing").option(
+    "--keep-templates",
+    "[Mode] Keep `.claude/`, `.codex/`, `.opencode/` templates (remove only external assets)"
+  ).option(
+    "--only <ids>",
+    "[Scope] Remove only these assets (comma-separated ids from `agent-harness list`). Templates untouched"
+  ).option(
+    "--cli <name>",
+    `[Scope] Remove one CLI only (${CLI_BASES.join(" | ")}). Shared files stay until the last user leaves`
+  ).option("--yes", "[Mode] Skip the interactive picker and remove everything (non-interactive)").action(async (options) => {
+    await dispatchUninstall(options);
+  });
+}
+function shouldRunInteractive(options, isTty) {
+  if (!isTty) return false;
+  if (options.yes || options.dryRun) return false;
+  return options.only === void 0 && options.cli === void 0;
+}
+async function dispatchUninstall(options) {
+  if (!shouldRunInteractive(options, Boolean(process.stdin.isTTY))) {
+    uninstallAction(options);
+    return;
+  }
+  await runUninstallScreen(resolve4(options.projectDir ?? process.cwd()));
+}
+async function runUninstallScreen(projectDir, opts = {}) {
+  const picked = await runInteractiveUninstall(projectDir, opts);
+  if (!picked.ok || !picked.options) {
+    if (picked.reason === "no-log") {
+      console.error(
+        status.failure(c.red(`ERROR: install log not found at ${installLogPath(projectDir)}`))
       );
+      console.error(c.dim("       Nothing installed here by agent-harness."));
+      process.exit(1);
     }
-    return resultIds;
+    return;
   }
-};
+  uninstallAction(picked.options);
+}
+
+// src/commands/update.ts
+init_esm_shims();
+import { resolve as resolve5 } from "path";
+
+// src/state.ts
+init_esm_shims();
+import { existsSync as existsSync19, readFileSync as readFileSync17 } from "fs";
+import { join as join20 } from "path";
+var META_FILE = ".claude/.installed-tracks";
+var LEGACY_SIGNATURES = [
+  { rule: "htmx.md", track: "ssr-htmx" },
+  { rule: "nextjs.md", track: "ssr-nextjs" },
+  { rule: "data-analysis.md", track: "data" },
+  { rule: "pyside6.md", track: "data" },
+  { rule: "cli-development.md", track: "tooling" }
+];
+function detectInstallState(projectDir) {
+  const claudeDir = join20(projectDir, ".claude");
+  const hasClaudeDir = existsSync19(claudeDir);
+  if (hasClaudeDir) {
+    const metaPath = join20(projectDir, META_FILE);
+    if (existsSync19(metaPath)) {
+      const tracks2 = readMetafile(metaPath);
+      return { state: "existing", tracks: tracks2, source: "metafile", hasClaudeDir: true };
+    }
+    const tracks = inferFromLegacySignatures(projectDir);
+    return { state: "existing", tracks, source: "legacy", hasClaudeDir: true };
+  }
+  const log = readInstallLog(projectDir);
+  if (log) {
+    return {
+      state: "existing",
+      tracks: tracksFromLog(log.spec.tracks),
+      source: "install-log",
+      hasClaudeDir: false
+    };
+  }
+  return { state: "new", tracks: [], source: "none", hasClaudeDir: false };
+}
+function tracksFromLog(tracks) {
+  return [...new Set(tracks.filter(isTrack))].sort();
+}
+function readMetafile(path) {
+  const raw = readFileSync17(path, "utf8");
+  const seen = /* @__PURE__ */ new Set();
+  for (const line of raw.split(/\s+/)) {
+    const trimmed = line.trim();
+    if (isTrack(trimmed)) {
+      seen.add(trimmed);
+    }
+  }
+  return [...seen].sort();
+}
+function inferFromLegacySignatures(projectDir) {
+  const rulesDir = join20(projectDir, ".claude/rules");
+  if (!existsSync19(rulesDir)) {
+    return [];
+  }
+  const found = /* @__PURE__ */ new Set();
+  for (const sig of LEGACY_SIGNATURES) {
+    if (existsSync19(join20(rulesDir, sig.rule))) {
+      found.add(sig.track);
+    }
+  }
+  return [...found].sort();
+}
+
+// src/commands/update.ts
+function updateAction(options = {}, deps = {}) {
+  const log = deps.log ?? console.log;
+  const err = deps.err ?? console.error;
+  const exit = deps.exit ?? ((code) => process.exit(code));
+  const detect = deps.detect ?? detectInstallState;
+  const execute = deps.execute ?? executeSpec;
+  const projectDir = resolve5(options.projectDir ?? process.cwd());
+  const state = detect(projectDir);
+  if (state.state === "new") {
+    err(status.failure(c.red(`No harness install found at ${projectDir}`)));
+    err(c.dim("  Run `agent-harness install --track <name>` first."));
+    exit(1);
+    return;
+  }
+  const rawOnly = options.only === void 0 ? [] : [options.only].flat().map((v2) => typeof v2 === "string" ? v2 : "(missing value)");
+  const parsed = parseUpdateOnly(rawOnly);
+  if (!parsed.ok) {
+    err(status.failure(c.red(`Unknown --only value: ${parsed.invalid.join(", ")}`)));
+    err(c.dim(`  Valid groups: ${UPDATE_GROUPS.join(" | ")}`));
+    exit(1);
+    return;
+  }
+  log(c.dim(`Updating installed harness files in ${projectDir}`));
+  execute(buildUpdateSpec(projectDir, state.tracks, parsed.groups), {
+    log,
+    err,
+    exit,
+    mode: "update"
+  });
+}
+function registerUpdateCommand(cli2) {
+  cli2.command(
+    "update",
+    "Refresh installed policy files (rules / agents / commands / hooks / skills)"
+  ).option("--project-dir <path>", "[Project] Target project directory", {
+    default: process.cwd()
+  }).option(
+    "--only <group>",
+    `[Scope] Update only this group (repeatable): ${UPDATE_GROUPS.join(" | ")}`
+  ).action((options) => {
+    updateAction(options);
+  });
+}
 
 // src/interactive.ts
+init_esm_shims();
+import { existsSync as existsSync20 } from "fs";
+import { join as join21 } from "path";
 function splitInstallTargets(targets) {
   const optionKeys = [];
   const assetIds = [];
@@ -6386,6 +7209,59 @@ function initialTargetSelection(tracks, installedProjectAssetIds) {
   const baseline = listBaselineTargets({ tracks }).map((t) => t.id);
   return [...assets, ...baseline];
 }
+function lockTracks(picked, installed) {
+  return [.../* @__PURE__ */ new Set([...installed, ...picked])].sort();
+}
+function lockClis(picked, installed) {
+  return [.../* @__PURE__ */ new Set([...installed, ...picked])].sort(
+    (a, b2) => CLI_BASE_SORT_ORDER[a] - CLI_BASE_SORT_ORDER[b2]
+  );
+}
+var BUNDLED_SKILLS = new Set(INTERNAL_BUNDLED_SKILL_IDS);
+function classifyUpdateIntent(log, confirmed, legacyTracks = []) {
+  const recordTracks = log ? log.spec.tracks : legacyTracks;
+  const recordClis = recordedClis(log);
+  if (!sameSet(confirmed.tracks, recordTracks)) return "add";
+  if (!sameSet(confirmed.cli, recordClis)) return "add";
+  const recorded = log?.assets ?? [];
+  const covered = coveredByRecord(log, legacyTracks);
+  const picked = new Set(confirmed.assetIds);
+  if (confirmed.assetIds.some((id) => !covered.has(id))) return "add";
+  if (recorded.some((a) => a.scope !== "global" && !picked.has(a.id))) return "add";
+  if (!sameSet(confirmed.baselineExclude, log?.spec.baselineExclude ?? [])) return "add";
+  if (!sameSet(confirmed.skillExclude, log?.spec.skillExclude ?? [])) return "add";
+  return "refresh";
+}
+function recordedClis(log) {
+  return log ? [...installedClis(log)] : ["claude"];
+}
+function coveredByRecord(log, legacyTracks) {
+  const recordTracks = (log ? log.spec.tracks : legacyTracks).filter(isTrack);
+  const clis = recordedClis(log);
+  const covered = new Set((log?.assets ?? []).map((a) => a.id));
+  for (const id of recommendedExternalAssets(recordTracks)) {
+    const asset = EXTERNAL_ASSETS.find((a) => a.id === id);
+    if (!asset || asset.method.kind === "internal" || !assetReachesCli(asset, clis)) {
+      covered.add(id);
+    }
+  }
+  return covered;
+}
+function sameSet(a, b2) {
+  const left = new Set(a);
+  const right = new Set(b2);
+  return left.size === right.size && [...left].every((x) => right.has(x));
+}
+function updateInitialSelection(tracks, installedProjectAssetIds, log, legacyTracks = []) {
+  const covered = coveredByRecord(log, legacyTracks);
+  const recordTracks = (log ? log.spec.tracks : legacyTracks).filter(isTrack);
+  const excluded = /* @__PURE__ */ new Set([
+    ...log?.spec.baselineExclude ?? [],
+    ...(log?.spec.skillExclude ?? []).map((id) => `asset:${id}`),
+    ...recommendedExternalAssets(recordTracks).filter((id) => !covered.has(id)).map((id) => `asset:${id}`)
+  ]);
+  return initialTargetSelection(tracks, installedProjectAssetIds).filter((id) => !excluded.has(id));
+}
 async function runInteractive(projectDir, deps = {}) {
   const prompts = deps.prompts ?? defaultPrompts;
   const detect = deps.detect ?? detectInstallState;
@@ -6400,10 +7276,10 @@ async function runInteractive(projectDir, deps = {}) {
   prompts.intro("uzys-agent-harness installer");
   const state = detect(projectDir);
   const installed = (deps.readInstalled ?? installedTargetState)(projectDir);
-  let initialTracks;
-  let mode = "fresh";
   if (state.state === "existing") {
-    const action = await prompts.selectAction(state);
+    const log = readInstallLog(projectDir);
+    const record = buildInstallRecordView(state, log, existsSync20(join21(projectDir, ".claude")));
+    const action = await prompts.selectAction(state, record);
     if (action === null) {
       prompts.cancel("Cancelled.");
       return { ok: false, reason: "cancelled" };
@@ -6412,34 +7288,14 @@ async function runInteractive(projectDir, deps = {}) {
       prompts.outro("Exiting without changes.");
       return { ok: false, reason: "exit" };
     }
-    if (action === "remove") {
-      prompts.cancel("Track removal is not automated \u2014 manually edit `.claude/`. Aborting.");
-      return { ok: false, reason: "disabled-action" };
-    }
-    if (action === "update") {
-      mode = "update";
-      const groups = prompts.selectUpdateGroups ? await prompts.selectUpdateGroups() : null;
-      if (groups === null && prompts.selectUpdateGroups) {
-        prompts.cancel("Cancelled.");
-        return { ok: false, reason: "cancelled" };
-      }
-      const spec = buildUpdateSpec(projectDir, state.tracks, groups ?? void 0);
-      const scopeLine = spec.updateOnly ? `UPDATE ${spec.updateOnly.join(" \xB7 ")} only (untouched: ${UPDATE_GROUPS.filter((g) => !spec.updateOnly?.includes(g)).join(", ")}):` : "UPDATE installed harness files:";
-      const confirmed = await prompts.confirmInstall(`${scopeLine}
-${formatSummary(spec)}`);
-      if (!confirmed) {
-        prompts.outro("Cancelled.");
-        return { ok: false, reason: "cancelled" };
-      }
-      prompts.outro("Running update mode...");
-      return { ok: true, mode: "update", spec };
+    if (action === "uninstall") {
+      return { ok: true, uninstall: true };
     }
-    if (action === "add") {
-      mode = "add";
-      initialTracks = state.tracks;
-    } else if (action === "reinstall") {
-      mode = "reinstall";
+    if (record.repair !== null) {
+      prompts.cancel(`.claude/ is missing \u2014 repair first: ${record.repair}`);
+      return { ok: false, reason: "disabled-action", message: record.repair };
     }
+    return runUpdateFlow({ projectDir, state, log, prompts, installed });
   }
   let step = "tracks";
   let tracks = null;
@@ -6448,7 +7304,7 @@ ${formatSummary(spec)}`);
   let scope = "project";
   while (true) {
     if (step === "tracks") {
-      const result = await prompts.selectTracks(tracks ?? initialTracks, WIZARD.TRACKS);
+      const result = await prompts.selectTracks(tracks ?? void 0, WIZARD.TRACKS);
       if (result === null) {
         prompts.cancel("Cancelled.");
         return { ok: false, reason: "cancelled" };
@@ -6502,7 +7358,7 @@ ${formatSummary(spec)}`);
         projectDir,
         ...userOverride ? { userOverride } : {},
         // 해제 목록을 안 넘기면 이 화면이 **제외 유무와 문자열이 완전히 같아진다** — 같은 화면이
-        // 외부 자산 제거는 `-User removed:` 로 이미 보고하므로, 없음은 "아무것도 안 빠졌다"로
+        // 외부 자산 제거는 `-Unchecked by you:` 로 이미 보고하므로, 없음은 "아무것도 안 빠졌다"로
         // 읽힌다. 상주 비용을 줄이려고 20개를 푼 사용자가 그대로인 숫자를 보게 된다.
         ...baselineExclude.length > 0 ? { baselineExclude } : {}
       })}
@@ -6529,10 +7385,169 @@ ${summary}`
         ...baselineExclude.length > 0 ? { baselineExclude } : {}
       };
       prompts.outro(stepLabel(WIZARD.INSTALL, "Installing..."));
-      return { ok: true, mode, spec };
+      return { ok: true, mode: "fresh", spec };
+    }
+  }
+}
+async function runUpdateFlow(ctx) {
+  const { projectDir, state, log, prompts, installed } = ctx;
+  const lockedTracks = lockTracks(log ? log.spec.tracks.filter(isTrack) : [], state.tracks);
+  const lockedClis = installedClis(log);
+  const scope = log?.scope ?? "project";
+  let step = "tracks";
+  let tracks = null;
+  let cli2 = null;
+  let targetSelections = null;
+  while (true) {
+    if (step === "tracks") {
+      const result = await prompts.selectTracks(
+        tracks ?? lockedTracks,
+        UPDATE_WIZARD.TRACKS,
+        lockedTracks
+      );
+      if (result === null) {
+        prompts.cancel("Cancelled.");
+        return { ok: false, reason: "cancelled" };
+      }
+      const next = lockTracks(result, lockedTracks);
+      if (tracks !== null && !tracksEqual(tracks, next)) targetSelections = null;
+      tracks = next;
+      step = "cli";
+    } else if (step === "cli") {
+      const initial = cli2 ?? (lockedClis.length > 0 ? [...lockedClis] : ["claude"]);
+      const result = await prompts.selectCli(initial, UPDATE_WIZARD.CLI, lockedClis);
+      if (result === null) {
+        step = "tracks";
+        continue;
+      }
+      cli2 = lockClis(result, lockedClis);
+      step = "targets";
+    } else if (step === "targets") {
+      const current = tracks ?? lockedTracks;
+      const initial = targetSelections !== null ? [...targetSelections] : updateInitialSelection(current, installed.projectScoped, log, state.tracks);
+      const result = await prompts.selectInstallTargets(initial, UPDATE_WIZARD.TARGETS, {
+        tracks: current,
+        cli: cli2 ?? [...lockedClis],
+        installed: installed.installed.map((id) => `asset:${id}`)
+      });
+      if (result === null) {
+        step = "cli";
+        continue;
+      }
+      targetSelections = result;
+      step = "confirm";
+    } else {
+      const outcome = await confirmUpdate({
+        projectDir,
+        state,
+        log,
+        prompts,
+        scope,
+        lockedClis,
+        // biome-ignore lint/style/noNonNullAssertion: confirm 도달 = 이전 step 완료 보장
+        tracks,
+        // biome-ignore lint/style/noNonNullAssertion: same as above
+        cli: cli2,
+        targetSelections: targetSelections ?? []
+      });
+      if (outcome === "back") {
+        step = "targets";
+        continue;
+      }
+      return outcome;
     }
   }
 }
+async function confirmUpdate(input) {
+  const { projectDir, state, log, prompts, scope, tracks, cli: cli2 } = input;
+  const { assetIds, baselineIds } = splitInstallTargets(input.targetSelections);
+  const userOverride = computeUserOverride(tracks, assetIds);
+  const baselineExclude = baselineExcludeFrom(listBaselineTargets({ tracks }), baselineIds);
+  const skillExclude = (userOverride?.forceExclude ?? []).filter((id) => BUNDLED_SKILLS.has(id));
+  const intent = classifyUpdateIntent(
+    log,
+    { tracks, cli: cli2, assetIds, baselineExclude, skillExclude },
+    state.tracks
+  );
+  const header = stepLabel(UPDATE_WIZARD.CONFIRM, "Confirm");
+  const scopeLine = `  SCOPE     ${scope === "global" ? "Global" : "Project"} (${log ? "from your install record \u2014 not changed here" : "no install record \u2014 default"})`;
+  if (intent === "refresh") {
+    const groups = prompts.selectUpdateGroups ? await prompts.selectUpdateGroups() : void 0;
+    if (groups === null) return "back";
+    const spec2 = buildUpdateSpec(projectDir, state.tracks, groups);
+    const only = spec2.updateOnly ?? [];
+    const summary2 = [
+      header,
+      only.length > 0 ? `UPDATE ${only.join(" \xB7 ")} only (untouched: ${UPDATE_GROUPS.filter((g) => !only.includes(g)).join(", ")}):` : "UPDATE installed harness files:",
+      // 요약은 Step 3 에서 체크된 것을 센다 — spec(추천 전체)으로 세면 체크 안 된 채 둔 자산까지
+      // "selected" 로 적는데 refresh 는 그것을 깔지 않는다(리뷰 B2). 실행 spec 은 그대로다.
+      annotate(formatSummary({ ...spec2, ...userOverride ? { userOverride } : {} }), {
+        Tracks: "no change",
+        CLI: "no change",
+        Assets: "no change"
+      }),
+      scopeLine,
+      `  RUNS AS   agent-harness update${only.map((g) => ` --only ${g}`).join("")}`
+    ].join("\n");
+    const confirmed2 = await prompts.confirmInstall(summary2);
+    if (confirmed2 === null) return "back";
+    if (!confirmed2) {
+      prompts.outro("Cancelled.");
+      return { ok: false, reason: "cancelled" };
+    }
+    prompts.outro("Running update mode...");
+    return { ok: true, mode: "update", spec: spec2 };
+  }
+  const without = [...userOverride?.forceExclude ?? [], ...baselineExclude];
+  const options = {
+    track: [...tracks],
+    cli: [...cli2],
+    scope,
+    projectDir,
+    ...userOverride && userOverride.forceInclude.length > 0 ? { with: [...userOverride.forceInclude] } : {},
+    ...without.length > 0 ? { without } : {}
+  };
+  const spec = installSpecFromOptions(options, [...cli2], () => {
+  });
+  const recordTracks = new Set(log ? log.spec.tracks : state.tracks);
+  const addedTracks = tracks.filter((t) => !recordTracks.has(t));
+  const addedClis = cli2.filter((c3) => !input.lockedClis.includes(c3));
+  const covered = coveredByRecord(log, state.tracks);
+  const addedAssets = assetIds.filter((id) => !covered.has(id));
+  const locked = input.lockedClis.join(", ");
+  const summary = [
+    header,
+    annotate(formatSummary(spec), {
+      Tracks: addedTracks.length > 0 ? `+${addedTracks.join(", +")}` : "no change",
+      CLI: [
+        addedClis.length > 0 ? `+${addedClis.join(", +")}` : "",
+        locked ? `${locked} ${input.lockedClis.length > 1 ? "stay" : "stays"} \u2014 locked` : ""
+      ].filter(Boolean).join(" \xB7 "),
+      Assets: addedAssets.length > 0 ? `+${addedAssets.length} new: ${addedAssets.join(", ")}` : "no new assets"
+    }),
+    scopeLine,
+    `  RUNS AS   ${installCommandLine(options)}`,
+    "            (adds the new track's files and the new CLI's files \xB7 refreshes what is installed \xB7 edited files \u2192 *.backup-<time>)",
+    "            (retired-file cleanup runs on your next `agent-harness update`)"
+  ].join("\n");
+  const confirmed = await prompts.confirmInstall(summary);
+  if (confirmed === null) return "back";
+  if (!confirmed) {
+    prompts.outro("Cancelled by user.");
+    return { ok: false, reason: "cancelled" };
+  }
+  prompts.outro(stepLabel(UPDATE_WIZARD.RUN, "Installing..."));
+  return { ok: true, mode: "add", spec };
+}
+function annotate(summary, notes) {
+  return summary.split("\n").map((line) => {
+    const key = Object.keys(notes).find(
+      (k2) => line.startsWith(`${k2}:`)
+    );
+    const note = key ? notes[key] : "";
+    return note ? `${line.padEnd(40)} (${note})` : line;
+  }).join("\n");
+}
 function tracksEqual(a, b2) {
   if (a.length !== b2.length) return false;
   const sortedA = [...a].sort();
@@ -6585,7 +7600,7 @@ function formatSummary(spec) {
       lines.push(`  +User added: ${spec.userOverride.forceInclude.join(", ")}`);
     }
     if (spec.userOverride.forceExclude.length > 0) {
-      lines.push(`  -User removed: ${spec.userOverride.forceExclude.join(", ")}`);
+      lines.push(`  -Unchecked by you: ${spec.userOverride.forceExclude.join(", ")}`);
     }
   }
   if (baselineExcluded.size > 0) {
@@ -6605,6 +7620,11 @@ async function defaultAction(deps = {}) {
   const run = deps.run ?? ((cwd) => runInteractive(cwd));
   const execute = deps.execute ?? executeSpec;
   const result = await run(process.cwd());
+  if (result.ok && result.uninstall) {
+    const uninstall = deps.uninstall ?? ((cwd) => runUninstallScreen(cwd, { embedded: true }));
+    await uninstall(process.cwd());
+    return;
+  }
   if (!result.ok) {
     if (result.message) {
       err(result.message);