oh-my-customcode 0.73.0 → 0.75.0

package/README.md

@@ -21,17 +21,16 @@ npm install -g oh-my-customcode && cd your-project && omcustom init
 
 ---
 
-## What's New in v0.62.5
+## What's New in v0.74.0
 
 | Feature | Description |
 |---------|-------------|
-| **D3 Dependency Graph** | Interactive force-directed graph visualization at `/graph` — zoom, pan, drag, search, type filters |
-| **Playwright E2E Tests** | 11 accessibility tests with axe-core audit, `.pw.ts` extension for test isolation |
-| **Graph Accessibility** | WCAG keyboard navigation, aria-live announcements, skip link, focus-visible, reduced-motion support |
-| **CI Lockfile-Sync Gate** | New CI job validates bun.lockb consistency before lint/test |
-| **Token Optimization** | HTML comment technique reduces CLAUDE.md from 550→286 lines (48% reduction) |
-| **Workflow Engine** | YAML-defined workflow pipelines with `auto-dev` 8-step release batch |
-| **CC v2.1.83–v2.1.87 Compat** | Conditional hook `if` field, CwdChanged/FileChanged events, managed-settings.d |
+| **`omcustom sync`** | Drift detection for `.claude/` configuration — compare against lockfile, export team snapshots |
+| **`omcustom init --from-snapshot`** | Team reproducibility — install from pre-configured snapshot directory |
+| **`analysis --interview`** | Interactive AI architecture interview before file-based project detection |
+| **skill-extractor** | 100th skill — analyze task trajectories to propose reusable SKILL.md candidates |
+| **User Model** | Structured tracking of correction patterns, skill preferences, expertise profile |
+| **Release Cleanup** | Auto-close linked issues and delete release branches on PR merge |
 
 ---
 
@@ -153,13 +152,13 @@ Each agent declares its tools, model, memory scope, and limitations in YAML fron
 | Best Practices | 24 | Go, Python, TypeScript, Kotlin, Rust, React, FastAPI, Spring Boot, Django, Flutter, Docker, AWS, Postgres, Redis, Kafka, dbt, Spark, Snowflake, Airflow, pipeline-architecture-patterns, alembic, and more |
 | Routing | 4 | secretary, dev-lead, de-lead, qa-lead |
 | Workflow | 13 | structured-dev-cycle, deep-plan, research, evaluator-optimizer, dag-orchestration, worker-reviewer-pipeline, reasoning-sandwich, pipeline, and more |
-| Development | 7 | dev-review, dev-refactor, analysis, create-agent, intent-detection, web-design-guidelines, omcustom-takeover |
+| Development | 8 | dev-review, dev-refactor, analysis, create-agent, intent-detection, web-design-guidelines, omcustom-takeover, skill-extractor |
 | Operations | 9 | update-docs, audit-agents, sauron-watch, monitoring-setup, fix-refs, release-notes, and more |
 | Memory | 3 | memory-save, memory-recall, memory-management |
 | Package | 3 | npm-publish, npm-version, npm-audit |
 | Optimization | 3 | optimize-analyze, optimize-bundle, optimize-report |
 | Security | 3 | adversarial-review, cve-triage, jinja2-prompts |
-| Other | 9 | codex-exec, claude-native, vercel-deploy, skills-sh-search, result-aggregation, writing-clearly-and-concisely, and more |
+| Other | 10 | codex-exec, claude-native, vercel-deploy, skills-sh-search, result-aggregation, writing-clearly-and-concisely, and more |
 
 Skills use a 3-tier scope system: `core` (universal), `harness` (agent/skill maintenance), `package` (project-specific).
 
@@ -262,6 +261,10 @@ Security hooks are advisory (exit 0). They warn but never block.
 ```bash
 omcustom init                  # Interactive setup wizard (language, framework, team mode)
 omcustom init --lang ko        # Initialize with Korean
+omcustom init --from-snapshot  # Install from pre-configured team snapshot
+omcustom sync                  # Detect drift between .claude/ state and lockfile
+omcustom sync --check          # Check for drift without applying changes
+omcustom sync --export         # Export current state as team snapshot
 omcustom update                # Update to latest
 omcustom list                  # List components
 omcustom doctor                # Verify installation

package/dist/cli/index.js

@@ -9325,7 +9325,7 @@ var init_package = __esm(() => {
     workspaces: [
       "packages/*"
     ],
-    version: "0.73.0",
+    version: "0.75.0",
     description: "Batteries-included agent harness for Claude Code",
     type: "module",
     bin: {
@@ -11185,13 +11185,13 @@ var PromisePolyfill;
 var init_promise_polyfill = __esm(() => {
   PromisePolyfill = class PromisePolyfill extends Promise {
     static withResolver() {
-      let resolve2;
+      let resolve3;
       let reject;
       const promise = new Promise((res, rej) => {
-        resolve2 = res;
+        resolve3 = res;
         reject = rej;
       });
-      return { promise, resolve: resolve2, reject };
+      return { promise, resolve: resolve3, reject };
     }
   };
 });
@@ -11229,7 +11229,7 @@ function createPrompt(view) {
       output
     });
     const screen = new ScreenManager(rl);
-    const { promise, resolve: resolve2, reject } = PromisePolyfill.withResolver();
+    const { promise, resolve: resolve3, reject } = PromisePolyfill.withResolver();
     const cancel = () => reject(new CancelPromptError);
     if (signal) {
       const abort = () => reject(new AbortPromptError({ cause: signal.reason }));
@@ -11257,7 +11257,7 @@ function createPrompt(view) {
         cycle(() => {
           try {
             const nextView = view(config, (value) => {
-              setImmediate(() => resolve2(value));
+              setImmediate(() => resolve3(value));
             });
             if (nextView === undefined) {
               const callerFilename = callSites[1]?.getFileName();
@@ -17122,7 +17122,7 @@ var require_lib2 = __commonJS((exports) => {
     return matches;
   };
   exports.analyse = analyse;
-  var detectFile = (filepath, opts = {}) => new Promise((resolve2, reject) => {
+  var detectFile = (filepath, opts = {}) => new Promise((resolve3, reject) => {
     let fd;
     const fs3 = (0, node_1.default)();
     const handler = (err, buffer) => {
@@ -17132,7 +17132,7 @@ var require_lib2 = __commonJS((exports) => {
       if (err) {
         reject(err);
       } else if (buffer) {
-        resolve2((0, exports.detect)(buffer));
+        resolve3((0, exports.detect)(buffer));
       } else {
         reject(new Error("No error and no buffer received"));
       }
@@ -24757,6 +24757,9 @@ var en_default = {
       initializingTemplate: "Initializing with template: {{name}}",
       promptOverwrite: "Configuration already exists. Overwrite?",
       aborted: "Initialization aborted",
+      snapshot: {
+        installing: "Installing from team snapshot..."
+      },
       wizard: {
         welcome: "Welcome to oh-my-customcode setup!",
         langPrompt: "Select your preferred language",
@@ -24970,6 +24973,9 @@ var en_default = {
         serveStop: "[Deprecated] `omcustom serve-stop` is deprecated. Use `omcustom web stop` instead."
       }
     },
+    sync: {
+      description: "Check .claude/ configuration drift or export snapshot"
+    },
     security: {
       description: "Scan for security issues in hooks, configs, and templates",
       verboseOption: "Show detailed scan results",
@@ -25164,6 +25170,9 @@ var ko_default = {
       initializingTemplate: "템플릿으로 초기화 중: {{name}}",
       promptOverwrite: "설정 파일이 이미 존재합니다. 덮어쓰시겠습니까?",
       aborted: "초기화가 취소되었습니다",
+      snapshot: {
+        installing: "팀 스냅샷에서 설치 중..."
+      },
       wizard: {
         welcome: "oh-my-customcode 설정을 시작합니다!",
         langPrompt: "사용할 언어를 선택하세요",
@@ -25377,6 +25386,9 @@ var ko_default = {
         serveStop: "[Deprecated] `omcustom serve-stop` is deprecated. Use `omcustom web stop` instead."
       }
     },
+    sync: {
+      description: ".claude/ 설정 드리프트 확인 또는 스냅샷 내보내기"
+    },
     security: {
       description: "훅, 설정, 템플릿의 보안 문제 검사",
       verboseOption: "상세 검사 결과 표시",
@@ -26491,6 +26503,29 @@ async function generateAndWriteLockfileForDir(targetDir) {
     return { fileCount: 0, warning: `Lockfile generation failed: ${msg}` };
   }
 }
+function diffLockfiles(base, current) {
+  const baseKeys = new Set(Object.keys(base.files));
+  const currentKeys = new Set(Object.keys(current.files));
+  const added = [];
+  const removed = [];
+  const modified = [];
+  const unchanged = [];
+  for (const key of currentKeys) {
+    if (!baseKeys.has(key)) {
+      added.push(key);
+    } else if (base.files[key].templateHash !== current.files[key].templateHash) {
+      modified.push(key);
+    } else {
+      unchanged.push(key);
+    }
+  }
+  for (const key of baseKeys) {
+    if (!currentKeys.has(key)) {
+      removed.push(key);
+    }
+  }
+  return { added, removed, modified, unchanged };
+}
 
 // src/core/rtk-installer.ts
 import { execSync as execSync4 } from "node:child_process";
@@ -27209,7 +27244,7 @@ async function doctorCommand(options = {}) {
 
 // src/cli/init.ts
 init_package();
-import { join as join10 } from "node:path";
+import { join as join11 } from "node:path";
 
 // src/core/installer.ts
 init_fs();
@@ -28111,6 +28146,82 @@ async function checkUvAvailable() {
   }
 }
 
+// src/core/snapshot.ts
+init_package();
+init_projects();
+import { existsSync as existsSync2 } from "node:fs";
+import { copyFile as copyFile2, cp } from "node:fs/promises";
+import { join as join10 } from "node:path";
+init_fs();
+async function checkExistingInstallation(targetDir) {
+  const layout = getProviderLayout();
+  const rootDir = join10(targetDir, layout.rootDir);
+  return fileExists(rootDir);
+}
+async function installFromSnapshot(targetDir, snapshotPath, options) {
+  if (!existsSync2(snapshotPath)) {
+    return {
+      success: false,
+      message: i18n.t("cli.init.failed"),
+      errors: [`Snapshot path not found: ${snapshotPath}`]
+    };
+  }
+  const layout = getProviderLayout();
+  const snapshotClaude = join10(snapshotPath, layout.rootDir);
+  if (!existsSync2(snapshotClaude)) {
+    return {
+      success: false,
+      message: i18n.t("cli.init.failed"),
+      errors: [`Invalid snapshot: missing ${layout.rootDir}/ directory in ${snapshotPath}`]
+    };
+  }
+  console.log(`Installing from snapshot: ${snapshotPath}`);
+  try {
+    const exists2 = await checkExistingInstallation(targetDir);
+    if (exists2 && !options.force) {
+      console.log(i18n.t("cli.init.exists", { rootDir: layout.rootDir }));
+      console.log(i18n.t("cli.init.backing_up"));
+      const backupDir = join10(targetDir, `.claude-backup-${new Date().toISOString().replace(/[:.]/g, "-").slice(0, -1)}`);
+      await cp(join10(targetDir, layout.rootDir), backupDir, { recursive: true });
+      console.log(`  Backed up to: ${backupDir}`);
+    }
+    await cp(snapshotClaude, join10(targetDir, layout.rootDir), {
+      recursive: true,
+      force: true
+    });
+    const snapshotGuides = join10(snapshotPath, "guides");
+    if (existsSync2(snapshotGuides)) {
+      await cp(snapshotGuides, join10(targetDir, "guides"), {
+        recursive: true,
+        force: true
+      });
+    }
+    const snapshotEntry = join10(snapshotPath, layout.entryFile);
+    if (existsSync2(snapshotEntry)) {
+      await copyFile2(snapshotEntry, join10(targetDir, layout.entryFile));
+    }
+    try {
+      const existing = await readLockFile(targetDir);
+      await writeLockFile(targetDir, package_default.version, existing);
+    } catch {}
+    console.log(i18n.t("cli.init.success"));
+    console.log(`
+Installed from snapshot: ${snapshotPath}`);
+    return {
+      success: true,
+      message: `Installed from snapshot: ${snapshotPath}`
+    };
+  } catch (error2) {
+    const errorMessage = error2 instanceof Error ? error2.message : String(error2);
+    console.error(i18n.t("cli.init.failed"), errorMessage);
+    return {
+      success: false,
+      message: i18n.t("cli.init.failed"),
+      errors: [errorMessage]
+    };
+  }
+}
+
 // src/cli/init.ts
 init_fs();
 init_projects();
@@ -29090,9 +29201,9 @@ async function runInitWizard(options) {
 }
 
 // src/cli/init.ts
-async function checkExistingInstallation(targetDir) {
+async function checkExistingInstallation2(targetDir) {
   const layout = getProviderLayout();
-  const rootDir = join10(targetDir, layout.rootDir);
+  const rootDir = join11(targetDir, layout.rootDir);
   return fileExists(rootDir);
 }
 var PROVIDER_SUBDIR_COMPONENTS = new Set([
@@ -29106,13 +29217,13 @@ var PROVIDER_SUBDIR_COMPONENTS = new Set([
 function componentToPath(targetDir, component) {
   if (component === "entry-md") {
     const layout = getProviderLayout();
-    return join10(targetDir, layout.entryFile);
+    return join11(targetDir, layout.entryFile);
   }
   if (PROVIDER_SUBDIR_COMPONENTS.has(component)) {
     const layout = getProviderLayout();
-    return join10(targetDir, layout.rootDir, component);
+    return join11(targetDir, layout.rootDir, component);
   }
-  return join10(targetDir, component);
+  return join11(targetDir, component);
 }
 function buildInstalledPaths(targetDir, components) {
   return components.map((component) => componentToPath(targetDir, component));
@@ -29178,6 +29289,9 @@ async function setupMcpConfig(targetDir) {
 }
 async function initCommand(options) {
   const targetDir = process.cwd();
+  if (options.fromSnapshot) {
+    return installFromSnapshot(targetDir, options.fromSnapshot, options);
+  }
   const resolved = await resolveOptions(options);
   if (!resolved) {
     return { success: false, message: i18n.t("cli.init.wizard.cancelled") };
@@ -29185,7 +29299,7 @@ async function initCommand(options) {
   console.log(i18n.t("cli.init.start"));
   try {
     const layout = getProviderLayout();
-    const exists2 = await checkExistingInstallation(targetDir);
+    const exists2 = await checkExistingInstallation2(targetDir);
     if (exists2) {
       console.log(i18n.t("cli.init.exists", { rootDir: layout.rootDir }));
       console.log(i18n.t("cli.init.backing_up"));
@@ -29231,7 +29345,7 @@ async function initCommand(options) {
 }
 
 // src/cli/list.ts
-import { basename as basename4, dirname as dirname4, join as join11, relative as relative3 } from "node:path";
+import { basename as basename4, dirname as dirname4, join as join12, relative as relative3 } from "node:path";
 init_fs();
 var ALLOWED_TOP_LEVEL_KEYS = new Set(["name", "type", "description", "version", "category"]);
 function parseKeyValue(line) {
@@ -29296,12 +29410,12 @@ function extractAgentTypeFromFilename(filename) {
   return prefixMap[prefix] || "unknown";
 }
 function extractSkillCategoryFromPath(skillPath, baseDir, rootDir) {
-  const relativePath = relative3(join11(baseDir, rootDir, "skills"), skillPath);
+  const relativePath = relative3(join12(baseDir, rootDir, "skills"), skillPath);
   const parts = relativePath.split("/").filter(Boolean);
   return parts[0] || "unknown";
 }
 function extractGuideCategoryFromPath(guidePath, baseDir) {
-  const relativePath = relative3(join11(baseDir, "guides"), guidePath);
+  const relativePath = relative3(join12(baseDir, "guides"), guidePath);
   const parts = relativePath.split("/").filter(Boolean);
   return parts[0] || "unknown";
 }
@@ -29395,7 +29509,7 @@ async function tryExtractMarkdownDescription(mdPath, options = {}) {
   }
 }
 async function getAgents(targetDir, rootDir = ".claude", config) {
-  const agentsDir = join11(targetDir, rootDir, "agents");
+  const agentsDir = join12(targetDir, rootDir, "agents");
   if (!await fileExists(agentsDir))
     return [];
   try {
@@ -29423,7 +29537,7 @@ async function getAgents(targetDir, rootDir = ".claude", config) {
   }
 }
 async function getSkills(targetDir, rootDir = ".claude", config) {
-  const skillsDir = join11(targetDir, rootDir, "skills");
+  const skillsDir = join12(targetDir, rootDir, "skills");
   if (!await fileExists(skillsDir))
     return [];
   try {
@@ -29433,7 +29547,7 @@ async function getSkills(targetDir, rootDir = ".claude", config) {
     const skillMdFiles = await listFiles(skillsDir, { recursive: true, pattern: "SKILL.md" });
     const skills = await Promise.all(skillMdFiles.map(async (skillMdPath) => {
       const skillDir = dirname4(skillMdPath);
-      const indexYamlPath = join11(skillDir, "index.yaml");
+      const indexYamlPath = join12(skillDir, "index.yaml");
       const { description, version } = await tryReadIndexYamlMetadata(indexYamlPath);
       const relativePath = relative3(targetDir, skillDir);
       return {
@@ -29452,7 +29566,7 @@ async function getSkills(targetDir, rootDir = ".claude", config) {
   }
 }
 async function getGuides(targetDir, config) {
-  const guidesDir = join11(targetDir, "guides");
+  const guidesDir = join12(targetDir, "guides");
   if (!await fileExists(guidesDir))
     return [];
   try {
@@ -29479,7 +29593,7 @@ async function getGuides(targetDir, config) {
 }
 var RULE_PRIORITY_ORDER = { MUST: 0, SHOULD: 1, MAY: 2 };
 async function getRules(targetDir, rootDir = ".claude", config) {
-  const rulesDir = join11(targetDir, rootDir, "rules");
+  const rulesDir = join12(targetDir, rootDir, "rules");
   if (!await fileExists(rulesDir))
     return [];
   try {
@@ -29551,7 +29665,7 @@ function formatAsJson(components) {
   console.log(JSON.stringify(components, null, 2));
 }
 async function getHooks(targetDir, rootDir = ".claude") {
-  const hooksDir = join11(targetDir, rootDir, "hooks");
+  const hooksDir = join12(targetDir, rootDir, "hooks");
   if (!await fileExists(hooksDir))
     return [];
   try {
@@ -29569,7 +29683,7 @@ async function getHooks(targetDir, rootDir = ".claude") {
   }
 }
 async function getContexts(targetDir, rootDir = ".claude") {
-  const contextsDir = join11(targetDir, rootDir, "contexts");
+  const contextsDir = join12(targetDir, rootDir, "contexts");
   if (!await fileExists(contextsDir))
     return [];
   try {
@@ -29962,22 +30076,22 @@ async function securityCommand(_options = {}) {
 
 // src/cli/serve-commands.ts
 import { spawnSync as spawnSync2 } from "node:child_process";
-import { join as join13 } from "node:path";
+import { join as join14 } from "node:path";
 
 // src/cli/serve.ts
 import { spawn } from "node:child_process";
-import { existsSync as existsSync2 } from "node:fs";
+import { existsSync as existsSync3 } from "node:fs";
 import { readFile as readFile2, unlink, writeFile as writeFile2 } from "node:fs/promises";
-import { join as join12 } from "node:path";
+import { join as join13 } from "node:path";
 var DEFAULT_PORT = 4321;
-var PID_FILE = join12(process.env.HOME ?? "~", ".omcustom-serve.pid");
+var PID_FILE = join13(process.env.HOME ?? "~", ".omcustom-serve.pid");
 function findServeBuildDir(projectRoot, options) {
-  const localBuild = join12(projectRoot, "packages", "serve", "build");
-  if (existsSync2(join12(localBuild, "index.js")))
+  const localBuild = join13(projectRoot, "packages", "serve", "build");
+  if (existsSync3(join13(localBuild, "index.js")))
     return localBuild;
   if (options?.skipNpmFallback !== true) {
-    const npmBuild = join12(import.meta.dirname, "..", "..", "packages", "serve", "build");
-    if (existsSync2(join12(npmBuild, "index.js")))
+    const npmBuild = join13(import.meta.dirname, "..", "..", "packages", "serve", "build");
+    if (existsSync3(join13(npmBuild, "index.js")))
       return npmBuild;
   }
   return null;
@@ -30005,7 +30119,7 @@ async function startServeBackground(projectRoot, port = DEFAULT_PORT, buildDirOp
   if (buildDir === null) {
     return;
   }
-  const child = spawn("node", [join12(buildDir, "index.js")], {
+  const child = spawn("node", [join13(buildDir, "index.js")], {
     env: {
       ...process.env,
       OMCUSTOM_PORT: String(port),
@@ -30082,7 +30196,7 @@ function runForeground(projectRoot, port, buildDirOpts) {
     process.exit(1);
   }
   console.log(`Web UI: http://localhost:${port}`);
-  spawnSync2("node", [join13(buildDir, "index.js")], {
+  spawnSync2("node", [join14(buildDir, "index.js")], {
     env: {
       ...process.env,
       OMCUSTOM_PORT: String(port),
@@ -30094,12 +30208,199 @@ function runForeground(projectRoot, port, buildDirOpts) {
   });
 }
 
+// src/cli/sync.ts
+import { resolve as resolve2 } from "node:path";
+
+// src/core/sync.ts
+init_fs();
+import { existsSync as existsSync4 } from "node:fs";
+import { cp as cp2, mkdir } from "node:fs/promises";
+import { join as join15 } from "node:path";
+async function loadVersions() {
+  try {
+    const packageRoot = getPackageRoot();
+    const manifest = await readJsonFile(join15(packageRoot, "templates", "manifest.json"));
+    const pkg = await readJsonFile(join15(packageRoot, "package.json"));
+    return { generatorVersion: pkg.version, templateVersion: manifest.version };
+  } catch {
+    return { generatorVersion: "0.0.0", templateVersion: "0.0.0" };
+  }
+}
+async function generateCurrentLockfile(targetDir) {
+  try {
+    const { generatorVersion, templateVersion } = await loadVersions();
+    return await generateLockfile(targetDir, generatorVersion, templateVersion);
+  } catch {
+    return null;
+  }
+}
+async function syncCheck(targetDir, options) {
+  const empty = {
+    inSync: false,
+    added: [],
+    removed: [],
+    modified: [],
+    unchanged: 0,
+    referenceVersion: null,
+    currentVersion: null,
+    totalTracked: 0
+  };
+  const referenceDir = options?.reference ?? targetDir;
+  const reference = await readLockfile(referenceDir);
+  if (!reference) {
+    return empty;
+  }
+  const current = await generateCurrentLockfile(targetDir);
+  if (!current) {
+    return {
+      ...empty,
+      referenceVersion: reference.generatorVersion
+    };
+  }
+  const diff = diffLockfiles(reference, current);
+  return {
+    inSync: diff.added.length === 0 && diff.removed.length === 0 && diff.modified.length === 0,
+    added: diff.added,
+    removed: diff.removed,
+    modified: diff.modified,
+    unchanged: diff.unchanged.length,
+    referenceVersion: reference.generatorVersion,
+    currentVersion: current.generatorVersion,
+    totalTracked: Object.keys(current.files).length
+  };
+}
+function isExportable(src) {
+  const normalized = src.replace(/\\/g, "/");
+  const excluded = ["/agent-memory", "/agent-memory-local", "/outputs", "settings.local"];
+  return !excluded.some((segment) => {
+    if (segment.startsWith("/")) {
+      return normalized.includes(`${segment}/`) || normalized.endsWith(segment);
+    }
+    return normalized.includes(segment);
+  });
+}
+async function countFiles(dir2) {
+  const { readdir: readdir3, stat: stat3 } = await import("node:fs/promises");
+  async function walk(current) {
+    let total = 0;
+    let entries;
+    try {
+      entries = await readdir3(current);
+    } catch {
+      return 0;
+    }
+    for (const entry of entries) {
+      const full = join15(current, entry);
+      try {
+        const s = await stat3(full);
+        if (s.isDirectory()) {
+          total += await walk(full);
+        } else if (s.isFile()) {
+          total += 1;
+        }
+      } catch {}
+    }
+    return total;
+  }
+  return walk(dir2);
+}
+async function exportSnapshot(targetDir, outputPath) {
+  const claudeDir = join15(targetDir, ".claude");
+  const guidesDir = join15(targetDir, "guides");
+  if (!existsSync4(claudeDir)) {
+    return { success: false, exportPath: outputPath, fileCount: 0 };
+  }
+  await mkdir(outputPath, { recursive: true });
+  const destClaude = join15(outputPath, ".claude");
+  await cp2(claudeDir, destClaude, {
+    recursive: true,
+    filter: isExportable
+  });
+  if (existsSync4(guidesDir)) {
+    await cp2(guidesDir, join15(outputPath, "guides"), { recursive: true });
+  }
+  const lockfile = await generateCurrentLockfile(targetDir);
+  if (lockfile) {
+    await writeLockfile(outputPath, lockfile);
+  }
+  const fileCount = await countFiles(outputPath);
+  return { success: true, exportPath: outputPath, fileCount };
+}
+
+// src/cli/sync.ts
+async function runExport(targetDir, outputPath) {
+  const result = await exportSnapshot(targetDir, resolve2(outputPath));
+  if (!result.success) {
+    console.error(`
+Export failed — no .claude/ directory found in current project.`);
+    process.exit(1);
+  }
+  console.log(`
+Snapshot exported: ${result.exportPath} (${result.fileCount} files)`);
+  console.log(`Team members can install with: omcustom init --from-snapshot ${result.exportPath}`);
+}
+function printDriftDetails(result) {
+  if (result.unchanged > 0) {
+    console.log(`  ✓ ${result.unchanged} files in sync`);
+  }
+  if (result.modified.length > 0) {
+    console.log(`  ⚠ ${result.modified.length} files modified since install:`);
+    for (const f of result.modified) {
+      console.log(`    modified: ${f}`);
+    }
+  }
+  if (result.removed.length > 0) {
+    console.log(`  ✗ ${result.removed.length} files removed:`);
+    for (const f of result.removed) {
+      console.log(`    removed: ${f}`);
+    }
+  }
+  if (result.added.length > 0) {
+    console.log(`  + ${result.added.length} files added (not in lockfile):`);
+    for (const f of result.added) {
+      console.log(`    added: ${f}`);
+    }
+  }
+}
+async function runCheck(targetDir, options) {
+  const result = await syncCheck(targetDir, { reference: options.reference });
+  if (!result.referenceVersion) {
+    console.error(`
+No lockfile found. Run omcustom init first.`);
+    process.exit(1);
+  }
+  const label = options.reference ? `external snapshot at ${options.reference}` : `lockfile (v${result.referenceVersion})`;
+  console.log(`
+Sync check — comparing against ${label}
+`);
+  if (result.inSync) {
+    console.log(`  ✓ ${result.unchanged} files in sync`);
+  } else {
+    printDriftDetails(result);
+  }
+  console.log(`
+Summary: ${result.unchanged} unchanged, ${result.modified.length} modified, ${result.removed.length} removed, ${result.added.length} added`);
+  if (!result.inSync) {
+    process.exit(1);
+  }
+}
+function syncCommand(program2) {
+  program2.command("sync").description(i18n.t("cli.sync.description")).option("--check", "Compare current state against lockfile (default behavior)").option("--reference <path>", "Compare against an external snapshot instead of the lockfile").option("--export <path>", "Export current .claude/ state as a reusable snapshot").action(async (options) => {
+    const targetDir = resolve2(".");
+    if (options.export) {
+      await runExport(targetDir, options.export);
+      return;
+    }
+    await runCheck(targetDir, options);
+  });
+}
+
 // src/cli/update.ts
 init_package();
 
 // src/core/updater.ts
 init_package();
-import { join as join14 } from "node:path";
+import { join as join16 } from "node:path";
 init_fs();
 
 // src/core/entry-merger.ts
@@ -30354,7 +30655,7 @@ function resolveCustomizations(customizations, configPreserveFiles, targetDir) {
 }
 async function updateEntryDoc(targetDir, config, options) {
   const layout = getProviderLayout();
-  const entryPath = join14(targetDir, layout.entryFile);
+  const entryPath = join16(targetDir, layout.entryFile);
   const templateName = getEntryTemplateName2(config.language);
   const templatePath = resolveTemplatePath(templateName);
   if (!await fileExists(templatePath)) {
@@ -30455,7 +30756,7 @@ async function update(options) {
       result.error = `Downgrade prevented: project has v${result.previousVersion} but CLI is v${cliVersion}. Update the CLI first: npm install -g oh-my-customcode@latest`;
       return result;
     }
-    const targetPkgPath = join14(options.targetDir, "package.json");
+    const targetPkgPath = join16(options.targetDir, "package.json");
     if (await fileExists(targetPkgPath)) {
       const targetPkg = await readJsonFile(targetPkgPath);
       if (targetPkg.name === "oh-my-customcode") {
@@ -30571,11 +30872,11 @@ async function collectProtectedSkipPaths(srcPath, destPath, componentPath, force
   const warnedPaths = [];
   const updatedPaths = [];
   for (const p of protectedRelative) {
-    const targetFilePath = join14(targetDir, componentPath, p);
+    const targetFilePath = join16(targetDir, componentPath, p);
     const lockfileKey = `${componentPath}/${p}`.replace(/\\/g, "/");
     const shouldSkip = await shouldSkipProtectedFile(targetFilePath, lockfileKey, lockfile);
     if (shouldSkip) {
-      skipPaths.push(path3.relative(destPath, join14(destPath, p)));
+      skipPaths.push(path3.relative(destPath, join16(destPath, p)));
       warnedPaths.push(p);
     } else {
       updatedPaths.push(p);
@@ -30621,7 +30922,7 @@ async function updateComponent(targetDir, component, customizations, options, co
   const preservedFiles = [];
   const componentPath = getComponentPath2(component);
   const srcPath = resolveTemplatePath(componentPath);
-  const destPath = join14(targetDir, componentPath);
+  const destPath = join16(targetDir, componentPath);
   const customComponents = config.customComponents || [];
   const skipPaths = [];
   if (customizations && !options.forceOverwriteAll) {
@@ -30663,7 +30964,7 @@ async function updateComponent(targetDir, component, customizations, options, co
   }
   skipPaths.push(...protectedSkipPaths);
   const path3 = await import("node:path");
-  const normalizedSkipPaths = skipPaths.map((p) => path3.relative(destPath, join14(targetDir, p)));
+  const normalizedSkipPaths = skipPaths.map((p) => path3.relative(destPath, join16(targetDir, p)));
   const uniqueSkipPaths = [...new Set(normalizedSkipPaths)];
   await copyDirectory(srcPath, destPath, {
     overwrite: true,
@@ -30685,12 +30986,12 @@ async function syncRootLevelFiles(targetDir, options) {
   const layout = getProviderLayout();
   const synced = [];
   for (const fileName of ROOT_LEVEL_FILES) {
-    const srcPath = resolveTemplatePath(join14(layout.rootDir, fileName));
+    const srcPath = resolveTemplatePath(join16(layout.rootDir, fileName));
     if (!await fileExists(srcPath)) {
       continue;
     }
-    const destPath = join14(targetDir, layout.rootDir, fileName);
-    await ensureDirectory(join14(destPath, ".."));
+    const destPath = join16(targetDir, layout.rootDir, fileName);
+    await ensureDirectory(join16(destPath, ".."));
     await fs3.copyFile(srcPath, destPath);
     if (fileName.endsWith(".sh")) {
       await fs3.chmod(destPath, 493);
@@ -30725,7 +31026,7 @@ async function removeDeprecatedFiles(targetDir, options) {
       });
       continue;
     }
-    const fullPath = join14(targetDir, entry.path);
+    const fullPath = join16(targetDir, entry.path);
     if (await fileExists(fullPath)) {
       await fs3.unlink(fullPath);
       removed.push(entry.path);
@@ -30766,7 +31067,7 @@ async function syncNamespaceInFile(targetFilePath, upstreamFilePath) {
 async function processNamespaceSyncEntry(entry, relPath, fullSrcPath, destPath, componentPath, lockfile) {
   if (!entry.isFile() || !entry.name.endsWith(".md"))
     return null;
-  const targetFilePath = join14(destPath, relPath);
+  const targetFilePath = join16(destPath, relPath);
   const lockfileKey = `${componentPath}/${relPath}`.replace(/\\/g, "/");
   const shouldSkip = await shouldSkipProtectedFile(targetFilePath, lockfileKey, lockfile);
   if (shouldSkip)
@@ -30781,7 +31082,7 @@ async function applyNamespaceSync(targetDir, component, lockfile) {
     return [];
   const componentPath = getComponentPath2(component);
   const srcPath = resolveTemplatePath(componentPath);
-  const destPath = join14(targetDir, componentPath);
+  const destPath = join16(targetDir, componentPath);
   const fs3 = await import("node:fs/promises");
   const synced = [];
   const queue = [{ dir: srcPath, relDir: "" }];
@@ -30795,7 +31096,7 @@ async function applyNamespaceSync(targetDir, component, lockfile) {
     }
     for (const entry of entries) {
       const relPath = relDir ? `${relDir}/${entry.name}` : entry.name;
-      const fullSrcPath = join14(dir2, entry.name);
+      const fullSrcPath = join16(dir2, entry.name);
       if (entry.isDirectory()) {
         queue.push({ dir: fullSrcPath, relDir: relPath });
         continue;
@@ -30818,26 +31119,26 @@ function getComponentPath2(component) {
 }
 async function backupInstallation(targetDir) {
   const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
-  const backupDir = join14(targetDir, `.omcustom-backup-${timestamp}`);
+  const backupDir = join16(targetDir, `.omcustom-backup-${timestamp}`);
   const fs3 = await import("node:fs/promises");
   await ensureDirectory(backupDir);
   const layout = getProviderLayout();
   const dirsToBackup = [layout.rootDir, "guides"];
   for (const dir2 of dirsToBackup) {
-    const srcPath = join14(targetDir, dir2);
+    const srcPath = join16(targetDir, dir2);
     if (await fileExists(srcPath)) {
-      const destPath = join14(backupDir, dir2);
+      const destPath = join16(backupDir, dir2);
       await copyDirectory(srcPath, destPath, { overwrite: true });
     }
   }
-  const entryPath = join14(targetDir, layout.entryFile);
+  const entryPath = join16(targetDir, layout.entryFile);
   if (await fileExists(entryPath)) {
-    await fs3.copyFile(entryPath, join14(backupDir, layout.entryFile));
+    await fs3.copyFile(entryPath, join16(backupDir, layout.entryFile));
   }
   return backupDir;
 }
 async function loadCustomizationManifest(targetDir) {
-  const manifestPath = join14(targetDir, CUSTOMIZATION_MANIFEST_FILE);
+  const manifestPath = join16(targetDir, CUSTOMIZATION_MANIFEST_FILE);
   if (await fileExists(manifestPath)) {
     return readJsonFile(manifestPath);
   }
@@ -31078,7 +31379,7 @@ var packageJson = require2("../../package.json");
 function createProgram() {
   const program2 = new Command;
   program2.name("omcustom").description(i18n.t("cli.description")).version(packageJson.version, "-v, --version", i18n.t("cli.versionOption")).option("--skip-version-check", "Skip CLI version pre-flight check");
-  program2.command("init").description(i18n.t("cli.init.description")).option("-l, --lang <language>", i18n.t("cli.init.langOption")).option("--domain <domain>", "Install only agents/skills for specific domain (backend, frontend, data-engineering, devops)").option("--yes", "Skip interactive wizard, use defaults").action(async (options) => {
+  program2.command("init").description(i18n.t("cli.init.description")).option("-l, --lang <language>", i18n.t("cli.init.langOption")).option("--domain <domain>", "Install only agents/skills for specific domain (backend, frontend, data-engineering, devops)").option("--yes", "Skip interactive wizard, use defaults").option("--from-snapshot <path>", "Install from a pre-configured team snapshot directory").action(async (options) => {
     await initCommand(options);
   });
   program2.command("update").description(i18n.t("cli.update.description")).option("--dry-run", i18n.t("cli.update.dryRunOption")).option("--force", i18n.t("cli.update.forceOption")).option("--force-overwrite-all", i18n.t("cli.update.forceOverwriteAllOption")).option("--hard", i18n.t("cli.update.hardOption")).option("--backup", i18n.t("cli.update.backupOption")).option("--agents", i18n.t("cli.update.agentsOption")).option("--skills", i18n.t("cli.update.skillsOption")).option("--rules", i18n.t("cli.update.rulesOption")).option("--guides", i18n.t("cli.update.guidesOption")).option("--hooks", i18n.t("cli.update.hooksOption")).option("--contexts", i18n.t("cli.update.contextsOption")).option("--all", i18n.t("cli.update.allOption")).action(async (options) => {
@@ -31090,6 +31391,7 @@ function createProgram() {
       verbose: options.verbose
     });
   });
+  syncCommand(program2);
   program2.command("doctor").description(i18n.t("cli.doctor.description")).option("--fix", i18n.t("cli.doctor.fixOption")).option("--updates", i18n.t("cli.doctor.updatesOption")).action(async (options) => {
     await doctorCommand(options);
   });

package/dist/index.js

@@ -1820,7 +1820,7 @@ var package_default = {
   workspaces: [
     "packages/*"
   ],
-  version: "0.73.0",
+  version: "0.75.0",
   description: "Batteries-included agent harness for Claude Code",
   type: "module",
   bin: {

package/package.json

@@ -3,7 +3,7 @@
   "workspaces": [
     "packages/*"
   ],
-  "version": "0.73.0",
+  "version": "0.75.0",
   "description": "Batteries-included agent harness for Claude Code",
   "type": "module",
   "bin": {

package/templates/.claude/skills/analysis/SKILL.md

@@ -2,7 +2,7 @@
 name: omcustom:analysis
 description: Analyze project and auto-configure agents, skills, rules, and guides
 scope: harness
-argument-hint: "[--dry-run] [--verbose]"
+argument-hint: "[target-dir] [--interview]"
 user-invocable: true
 ---
 
@@ -13,12 +13,52 @@ Scan a project's tech stack, compare against installed agents/skills, and auto-c
 ## Options
 
 ```
---dry-run    Show what would be added without making changes
---verbose    Show detailed detection reasoning
+--dry-run      Show what would be added without making changes
+--verbose      Show detailed detection reasoning
+--interview, -i   Run interactive architecture interview before file-based detection
 ```
 
 ## Workflow
 
+### Step 0: Architecture Interview (--interview only)
+
+When `--interview` flag is provided, conduct an interactive AI interview before file-based detection. This captures human context that file scanning cannot determine.
+
+**Interview flow** (sequential, AI-guided):
+
+1. **프로젝트 유형**: "이 프로젝트는 어떤 종류입니까?"
+   → 옵션: web app, REST API, CLI tool, library, monorepo, data pipeline, mobile app
+
+2. **아키텍처 패턴**: "어떤 아키텍처를 따르고 있습니까?"
+   → 옵션: microservices, monolith, serverless, event-driven, layered, hexagonal
+
+3. **주요 언어**: "주로 사용하는 프로그래밍 언어는?"
+   → 자유 입력, 알려진 에이전트와 매칭
+
+4. **배포 대상**: "어디에 배포합니까?"
+   → 옵션: AWS, GCP, Azure, Vercel, on-premises, Docker/K8s, edge
+
+5. **팀 우선순위**: "팀의 주요 관심사는?"
+   → 옵션: performance, security, developer experience, cost, scalability
+
+**Interview results feed into Step 1 as weighted detection hints:**
+- File evidence + interview agreement = `confidence: high`
+- File evidence only = `confidence: medium` (unchanged from current)
+- Interview only (no file evidence) = `confidence: suggested`
+
+**Integration with report:**
+```
+Interview Insights (--interview):
+  Project type: REST API (user-specified, confirmed by file scan)
+  Architecture: microservices (user-specified)
+  Deployment: AWS + Docker (confirmed by file scan)
+  Team focus: security → sec-codeql-expert [suggested]
+
+Suggested (from interview, no file evidence):
+  ~ sec-codeql-expert  [suggested — no CodeQL config found]
+  ~ de-kafka-expert     [suggested — no kafka deps found]
+```
+
 ### Step 1: Project Scan
 
 Detect tech stack by checking indicator files and dependency manifests.

package/templates/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.73.0",
+  "version": "0.75.0",
   "lastUpdated": "2026-03-24T00:00:00.000Z",
   "components": [
     {

package/templates/workflows/auto-dev.yaml

@@ -7,16 +7,18 @@ mode: auto
 error: halt-and-report
 
 steps:
-  - name: pre-triage
-    skill: professor-triage
-    description: Run professor-triage on open issues that lack verify-done label
-    condition: "open issues without label:verify-done exist"
-
-  - name: triage
-    skill: professor-triage
-    description: Analyze verify-done issues against current codebase and perform automated triage
+  - name: issue-analysis
+    parallel:
+      - name: pre-triage
+        skill: professor-triage
+        description: Run professor-triage on open issues that lack verify-done label
+        condition: "open issues without label:verify-done exist"
+      - name: triage
+        skill: professor-triage
+        description: Analyze verify-done issues against current codebase and perform automated triage
 
   - name: plan
+    depends_on: issue-analysis
     skill: release-plan
     description: Group triaged issues into release units by priority and size
     input: triage-results