pai-zero 0.13.0 → 0.13.2

package/dist/bin/pai.js

@@ -54,6 +54,13 @@ var init_logger = __esm({
 });
 
 // src/core/config.ts
+var config_exports = {};
+__export(config_exports, {
+  createDefaultConfig: () => createDefaultConfig,
+  loadConfig: () => loadConfig,
+  normalizeMode: () => normalizeMode,
+  saveConfig: () => saveConfig
+});
 import path from "path";
 import { createRequire } from "module";
 import fs from "fs-extra";
@@ -3598,2070 +3605,2200 @@ var init_detector = __esm({
   }
 });
 
-// src/stages/environment/doctor.ts
-var doctor_exports = {};
-__export(doctor_exports, {
-  runDoctor: () => runDoctor
-});
-import { join as join6 } from "path";
-import { homedir } from "os";
+// src/core/roboco.ts
+import os2 from "os";
+import path5 from "path";
 import fs10 from "fs-extra";
-async function runDoctor() {
-  section("PAI Doctor \u2014 \uD658\uACBD \uC9C4\uB2E8");
-  const checks = [];
-  const nodeVersion = process.version;
-  const nodeMajor = parseInt(nodeVersion.slice(1).split(".")[0], 10);
-  checks.push({
-    label: "Node.js \uBC84\uC804",
-    ok: nodeMajor >= 20,
-    detail: `${nodeVersion} ${nodeMajor >= 20 ? "(>=20 OK)" : "(\uC5C5\uADF8\uB808\uC774\uB4DC \uD544\uC694)"}`,
-    fix: nodeMajor < 20 ? "Node.js 20 \uC774\uC0C1\uC73C\uB85C \uC5C5\uADF8\uB808\uC774\uB4DC\uD558\uC138\uC694" : void 0
-  });
-  const claudeCheck = await checkCommand("claude", ["--version"]);
-  checks.push({
-    label: "Claude Code CLI",
-    ok: claudeCheck.ok,
-    detail: claudeCheck.detail,
-    fix: claudeCheck.ok ? void 0 : "npm install -g @anthropic-ai/claude-code"
-  });
-  const globalConfigPath = join6(homedir(), ".pai", "config.json");
-  const hasGlobalConfig = await fs10.pathExists(globalConfigPath);
-  checks.push({
-    label: "\uAE00\uB85C\uBC8C \uC124\uC815",
-    ok: true,
-    detail: hasGlobalConfig ? globalConfigPath : "\uBBF8\uC124\uC815 (\uAE30\uBCF8\uAC12 \uC0AC\uC6A9)"
-  });
-  let hasSdk = false;
+function robocoPath(cwd) {
+  return path5.join(cwd, ROBOCO_PATH);
+}
+async function loadRobocoState(cwd) {
+  const p = robocoPath(cwd);
+  if (!await fs10.pathExists(p)) return freshState();
   try {
-    await import("@anthropic-ai/claude-agent-sdk");
-    hasSdk = true;
+    const raw = await fs10.readJson(p);
+    if (raw?.version !== "2.0") return freshState();
+    return raw;
   } catch {
-  }
-  checks.push({
-    label: "Agent SDK",
-    ok: true,
-    // optional이므로 항상 OK
-    detail: hasSdk ? "\uC124\uCE58\uB428 (AI \uAE30\uB2A5 \uD65C\uC131\uD654)" : "\uBBF8\uC124\uCE58 (\uC815\uC801 \uBD84\uC11D \uBAA8\uB4DC)"
-  });
-  console.log("");
-  let passed = 0;
-  for (const check of checks) {
-    const icon = check.ok ? "\u2713" : "\u2717";
-    const pad = " ".repeat(Math.max(1, 20 - check.label.length));
-    if (check.ok) {
-      success(`${icon} ${check.label}${pad}${check.detail}`);
-      passed++;
-    } else {
-      error(`${icon} ${check.label}${pad}${check.detail}`);
-      if (check.fix) {
-        info(`  \u2192 ${check.fix}`);
-      }
-    }
-  }
-  console.log("");
-  info(`${passed}/${checks.length} \uD56D\uBAA9 \uD1B5\uACFC`);
-  if (passed < checks.length) {
-    process.exitCode = 1;
+    return freshState();
   }
 }
-async function checkCommand(cmd, args) {
+async function saveRobocoState(cwd, state) {
+  const p = robocoPath(cwd);
+  await fs10.ensureDir(path5.dirname(p));
+  await fs10.writeJson(p, state, { spaces: 2 });
+}
+function freshState() {
+  return {
+    version: "2.0",
+    currentStage: "environment",
+    stageHistory: [],
+    lock: null,
+    gates: {}
+  };
+}
+function isProcessAlive(pid) {
   try {
-    const { execa } = await import("execa");
-    const { stdout } = await execa(cmd, args, { timeout: 1e4 });
-    return { ok: true, detail: stdout.trim().split("\n")[0] ?? "ok" };
+    process.kill(pid, 0);
+    return true;
   } catch {
-    return { ok: false, detail: "not found" };
+    return false;
   }
 }
-var init_doctor = __esm({
-  "src/stages/environment/doctor.ts"() {
-    "use strict";
-    init_ui();
-  }
-});
-
-// src/utils/github-fetch.ts
-import path5 from "path";
-import fs11 from "fs-extra";
-async function httpGet(url, timeoutMs, accept) {
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), timeoutMs);
-  try {
-    return await fetch(url, {
-      signal: controller.signal,
-      headers: { "Accept": accept, "User-Agent": "pai-zero" }
-    });
-  } finally {
-    clearTimeout(timer);
-  }
+function isLockStale(lock, now2 = /* @__PURE__ */ new Date()) {
+  if (!isProcessAlive(lock.pid)) return true;
+  if (new Date(lock.expiresAt).getTime() < now2.getTime()) return true;
+  return false;
 }
-async function listDir(repo, ref, dirPath, timeoutMs) {
-  const url = `https://api.github.com/repos/${repo}/contents/${encodeURI(dirPath)}?ref=${encodeURIComponent(ref)}`;
-  const res = await httpGet(url, timeoutMs, "application/vnd.github+json");
-  if (!res.ok) {
-    throw new Error(`GitHub API ${res.status} ${res.statusText} (${url})`);
-  }
-  const data = await res.json();
-  if (!Array.isArray(data)) {
-    throw new Error(`Expected directory, got single entry at ${dirPath}`);
+async function acquireLock(cwd, stage, command, ttlMs = DEFAULT_TTL_MS) {
+  const state = await loadRobocoState(cwd);
+  if (state.lock) {
+    if (!isLockStale(state.lock)) {
+      throw new RobocoLockError(formatLockError(state.lock), state.lock);
+    }
   }
-  return data;
+  const now2 = /* @__PURE__ */ new Date();
+  const newLock = {
+    pid: process.pid,
+    stage,
+    command,
+    acquiredAt: now2.toISOString(),
+    expiresAt: new Date(now2.getTime() + ttlMs).toISOString(),
+    host: os2.hostname()
+  };
+  state.lock = newLock;
+  await saveRobocoState(cwd, state);
+  return state;
 }
-async function downloadFile(downloadUrl, destPath, timeoutMs) {
-  const res = await httpGet(downloadUrl, timeoutMs, "*/*");
-  if (!res.ok) {
-    throw new Error(`Download failed ${res.status} ${res.statusText} (${downloadUrl})`);
+async function releaseLock(cwd) {
+  const state = await loadRobocoState(cwd);
+  if (state.lock && state.lock.pid === process.pid) {
+    state.lock = null;
+    await saveRobocoState(cwd, state);
   }
-  const buf = Buffer.from(await res.arrayBuffer());
-  await fs11.ensureDir(path5.dirname(destPath));
-  await fs11.writeFile(destPath, buf);
 }
-async function fetchGithubDir(opts) {
-  const {
-    repo,
-    ref = "main",
-    srcPath,
-    destDir,
-    overwrite = false,
-    timeoutMs = 1e4
-  } = opts;
-  const result = { written: [], skipped: [], errors: [] };
-  async function walk(currentSrc, currentDest) {
-    let entries;
-    try {
-      entries = await listDir(repo, ref, currentSrc, timeoutMs);
-    } catch (err) {
-      const msg = err instanceof Error ? err.message : String(err);
-      result.errors.push({ path: currentSrc, error: msg });
-      return;
+function formatLockError(lock) {
+  const started = new Date(lock.acquiredAt);
+  const mins = Math.round((Date.now() - started.getTime()) / 6e4);
+  return [
+    "\uB2E4\uB978 PAI \uBA85\uB839\uC774 \uC9C4\uD589 \uC911\uC785\uB2C8\uB2E4",
+    `  stage:    ${lock.stage}`,
+    `  command:  ${lock.command}`,
+    `  \uC2DC\uC791:     ${mins}\uBD84 \uC804 (PID ${lock.pid}${lock.host ? ", host " + lock.host : ""})`,
+    "  \uB300\uAE30\uD558\uC9C0 \uC54A\uACE0 \uC989\uC2DC \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4. \uC644\uB8CC \uD6C4 \uC7AC\uC2DC\uB3C4\uD558\uC138\uC694."
+  ].join("\n");
+}
+async function markStageStart(cwd, stage, command) {
+  const state = await loadRobocoState(cwd);
+  state.currentStage = stage;
+  state.stageHistory.push({
+    stage,
+    status: "in_progress",
+    startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    by: command
+  });
+  await saveRobocoState(cwd, state);
+}
+async function markStageEnd(cwd, stage, success2, reason) {
+  const state = await loadRobocoState(cwd);
+  for (let i = state.stageHistory.length - 1; i >= 0; i--) {
+    const entry = state.stageHistory[i];
+    if (entry.stage === stage && entry.status === "in_progress") {
+      entry.status = success2 ? "done" : "failed";
+      entry.endedAt = (/* @__PURE__ */ new Date()).toISOString();
+      if (reason) entry.reason = reason;
+      break;
     }
-    for (const entry of entries) {
-      const relName = entry.name;
-      if (entry.type === "dir") {
-        await walk(`${currentSrc}/${relName}`, path5.join(currentDest, relName));
-      } else if (entry.type === "file") {
-        const destFile = path5.join(currentDest, relName);
-        if (!overwrite && await fs11.pathExists(destFile)) {
-          result.skipped.push(destFile);
-          continue;
-        }
-        if (!entry.download_url) {
-          result.errors.push({ path: entry.path, error: "no download_url" });
-          continue;
-        }
-        try {
-          await downloadFile(entry.download_url, destFile, timeoutMs);
-          result.written.push(destFile);
-        } catch (err) {
-          const msg = err instanceof Error ? err.message : String(err);
-          result.errors.push({ path: entry.path, error: msg });
-        }
+  }
+  await saveRobocoState(cwd, state);
+}
+async function saveGateResult(cwd, key, result) {
+  const state = await loadRobocoState(cwd);
+  state.gates[key] = result;
+  await saveRobocoState(cwd, state);
+}
+async function withRoboco(cwd, stage, command, options, fn) {
+  await acquireLock(cwd, stage, command, options.ttlMs);
+  try {
+    if (options.gate && !options.force) {
+      const result = await options.gate(cwd);
+      await saveGateResult(cwd, `${stage}.entry`, result);
+      if (!result.passed && !options.skipGates) {
+        await markStageEnd(cwd, stage, false, `\uAC8C\uC774\uD2B8 \uC2E4\uD328: ${result.name}`);
+        throw new GateFailedError(result);
+      }
+      if (!result.passed && options.skipGates) {
       }
     }
+    await markStageStart(cwd, stage, command);
+    const value = await fn();
+    await markStageEnd(cwd, stage, true);
+    return value;
+  } catch (err) {
+    if (!(err instanceof GateFailedError)) {
+      const msg = err instanceof Error ? err.message : String(err);
+      await markStageEnd(cwd, stage, false, msg).catch(() => {
+      });
+    }
+    throw err;
+  } finally {
+    await releaseLock(cwd).catch(() => {
+    });
   }
-  await walk(srcPath, destDir);
-  return result;
 }
-var init_github_fetch = __esm({
-  "src/utils/github-fetch.ts"() {
+async function syncHandoff(cwd) {
+  const handoffPath = path5.join(cwd, "handoff.md");
+  if (!await fs10.pathExists(handoffPath)) return;
+  const state = await loadRobocoState(cwd);
+  const block = buildHandoffBlock(state);
+  const content = await fs10.readFile(handoffPath, "utf8");
+  const startIdx = content.indexOf(HANDOFF_START);
+  const endIdx = content.indexOf(HANDOFF_END);
+  let next;
+  if (startIdx >= 0 && endIdx > startIdx) {
+    next = content.slice(0, startIdx) + block + content.slice(endIdx + HANDOFF_END.length);
+  } else {
+    const sep = content.endsWith("\n") ? "\n" : "\n\n";
+    next = content + sep + block + "\n";
+  }
+  await fs10.writeFile(handoffPath, next);
+}
+function buildHandoffBlock(state) {
+  const lines = [HANDOFF_START, "## \uD30C\uC774\uD504\uB77C\uC778 \uC9C4\uD589 \uC0C1\uD0DC (roboco \uC790\uB3D9 \uAD00\uB9AC)", ""];
+  const done = state.stageHistory.filter((h) => h.status === "done");
+  const inProgress = state.stageHistory.filter((h) => h.status === "in_progress");
+  const failed = state.stageHistory.filter((h) => h.status === "failed");
+  if (inProgress.length > 0) {
+    lines.push("### \uC9C4\uD589 \uC911");
+    for (const h of inProgress) {
+      lines.push(`- [ ] ${h.stage} (${h.by}, \uC2DC\uC791 ${fmtDate(h.startedAt)})`);
+    }
+    lines.push("");
+  }
+  if (failed.length > 0) {
+    lines.push("### \uC2E4\uD328");
+    for (const h of failed) {
+      lines.push(`- [x] ${h.stage} \u2014 ${h.reason ?? "\uC6D0\uC778 \uBD88\uBA85"} (${fmtDate(h.startedAt)})`);
+    }
+    lines.push("");
+  }
+  if (done.length > 0) {
+    lines.push("### \uC644\uB8CC");
+    for (const h of done) {
+      lines.push(`- [x] ${h.stage} (${h.by}, ${fmtDate(h.endedAt ?? h.startedAt)})`);
+    }
+    lines.push("");
+  }
+  lines.push(`\uD604\uC7AC \uB2E8\uACC4: **${state.currentStage}**`);
+  lines.push(HANDOFF_END);
+  return lines.join("\n");
+}
+function fmtDate(iso) {
+  try {
+    const d = new Date(iso);
+    return d.toISOString().slice(0, 16).replace("T", " ");
+  } catch {
+    return iso;
+  }
+}
+var ROBOCO_PATH, DEFAULT_TTL_MS, RobocoLockError, GateFailedError, HANDOFF_START, HANDOFF_END;
+var init_roboco = __esm({
+  "src/core/roboco.ts"() {
     "use strict";
+    ROBOCO_PATH = path5.join(".pai", "roboco.json");
+    DEFAULT_TTL_MS = 10 * 60 * 1e3;
+    RobocoLockError = class extends Error {
+      constructor(message, holder) {
+        super(message);
+        this.holder = holder;
+        this.name = "RobocoLockError";
+      }
+      holder;
+    };
+    GateFailedError = class extends Error {
+      constructor(result) {
+        super(`\uAC8C\uC774\uD2B8 \uC2E4\uD328 (${result.name}): ${result.violations.length}\uAC74 \uC704\uBC18`);
+        this.result = result;
+        this.name = "GateFailedError";
+      }
+      result;
+    };
+    HANDOFF_START = "<!-- roboco:start -->";
+    HANDOFF_END = "<!-- roboco:end -->";
   }
 });
 
-// src/cli/commands/fetch.cmd.ts
-var fetch_cmd_exports = {};
-__export(fetch_cmd_exports, {
-  fetchCommand: () => fetchCommand
+// src/core/gates.ts
+var gates_exports = {};
+__export(gates_exports, {
+  STAGE_GATES: () => STAGE_GATES,
+  countBusinessRules: () => countBusinessRules,
+  countDomainObjects: () => countDomainObjects,
+  countEndpoints: () => countEndpoints,
+  designEntryGate: () => designEntryGate,
+  evaluationEntryGate: () => evaluationEntryGate,
+  executionEntryGate: () => executionEntryGate,
+  validateEdges: () => validateEdges,
+  validationEntryGate: () => validationEntryGate
 });
 import path6 from "path";
-import fs12 from "fs-extra";
-import chalk4 from "chalk";
-async function fetchCommand(cwd, recipeKey, options) {
-  if (options.list) {
-    section("\uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uB808\uC2DC\uD53C");
-    for (const key of listRecipeKeys()) {
-      const r = RECIPES[key];
-      console.log(`  ${colors.accent(key.padEnd(14))} ${r.label}`);
-      console.log(`  ${colors.dim("               " + r.description)}`);
-      console.log(`  ${colors.dim("               \uC18C\uC2A4: github.com/" + r.source.repo + "/tree/" + r.source.ref + "/" + r.source.path)}`);
-      console.log("");
-    }
-    hint("\uC0AC\uC6A9: pai fetch <key>  \uB610\uB294  pai fetch --all");
-    return;
+import fs11 from "fs-extra";
+function now() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function makeResult(name, violations) {
+  return {
+    name,
+    passed: violations.length === 0,
+    checkedAt: now(),
+    violations
+  };
+}
+async function designEntryGate(cwd) {
+  const violations = [];
+  const claudeMd = path6.join(cwd, "CLAUDE.md");
+  if (!await fs11.pathExists(claudeMd)) {
+    violations.push({
+      rule: "claude-md-exists",
+      message: "CLAUDE.md\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 `pai init`\uC744 \uC2E4\uD589\uD558\uC138\uC694.",
+      location: "CLAUDE.md"
+    });
   }
-  let keys;
-  if (options.all) {
-    keys = listRecipeKeys();
+  const configJson = path6.join(cwd, ".pai", "config.json");
+  if (!await fs11.pathExists(configJson)) {
+    violations.push({
+      rule: "pai-config-exists",
+      message: "PAI \uC124\uC815\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. `pai init`\uC744 \uC2E4\uD589\uD558\uC138\uC694.",
+      location: ".pai/config.json"
+    });
+  }
+  return makeResult("design.entry", violations);
+}
+async function executionEntryGate(cwd) {
+  const violations = [];
+  const openspec = path6.join(cwd, "docs", "openspec.md");
+  const hasOpenspec = await fs11.pathExists(openspec);
+  if (!hasOpenspec) {
+    violations.push({
+      rule: "openspec-exists",
+      message: "docs/openspec.md\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
+      location: "docs/openspec.md"
+    });
   } else {
-    if (!recipeKey) {
-      error("\uB808\uC2DC\uD53C \uD0A4\uB97C \uC9C0\uC815\uD558\uC138\uC694.");
-      hint(`\uC0AC\uC6A9 \uAC00\uB2A5: ${listRecipeKeys().join(", ")}`);
-      hint("\uBAA9\uB85D: pai fetch --list");
-      process.exitCode = 1;
-      return;
-    }
-    if (!getRecipe(recipeKey)) {
-      error(`\uC54C \uC218 \uC5C6\uB294 \uB808\uC2DC\uD53C: ${recipeKey}`);
-      hint(`\uC0AC\uC6A9 \uAC00\uB2A5: ${listRecipeKeys().join(", ")}`);
-      process.exitCode = 1;
-      return;
+    const content = await fs11.readFile(openspec, "utf8");
+    const endpointCount = countEndpoints(content);
+    if (endpointCount < 1) {
+      violations.push({
+        rule: "openspec-endpoints-min",
+        message: `openspec.md\uC5D0 \uC815\uC758\uB41C API \uC5D4\uB4DC\uD3EC\uC778\uD2B8\uAC00 0\uAC1C\uC785\uB2C8\uB2E4. \uCD5C\uC18C 1\uAC1C \uD544\uC694. /pai design \uC2E4\uD589 \uAD8C\uC7A5.`,
+        location: "docs/openspec.md \xA7 5. API \uC5D4\uB4DC\uD3EC\uC778\uD2B8"
+      });
     }
-    keys = [recipeKey.toLowerCase()];
   }
-  section("\uB808\uC2DC\uD53C \uB2E4\uC6B4\uB85C\uB4DC");
-  const installed = [];
-  for (const key of keys) {
-    const recipe = RECIPES[key];
-    const targetDir = path6.join(cwd, recipe.target);
-    console.log("");
-    console.log(`  ${colors.accent(key)} \u2014 ${recipe.label}`);
-    const result = await withSpinner(`\uB2E4\uC6B4\uB85C\uB4DC \uC911...`, async () => {
-      return fetchGithubDir({
-        repo: recipe.source.repo,
-        ref: recipe.source.ref,
-        srcPath: recipe.source.path,
-        destDir: targetDir,
-        overwrite: options.overwrite ?? false
+  const omc = path6.join(cwd, ".pai", "omc.md");
+  if (await fs11.pathExists(omc)) {
+    const content = await fs11.readFile(omc, "utf8");
+    const domainCount = countDomainObjects(content);
+    if (domainCount < 1) {
+      violations.push({
+        rule: "omc-domain-min",
+        message: "omc.md\uC5D0 \uB3C4\uBA54\uC778 \uAC1D\uCCB4\uAC00 0\uAC1C\uC785\uB2C8\uB2E4. \uCD5C\uC18C 1\uAC1C \uD544\uC694.",
+        location: ".pai/omc.md \xA7 \uB3C4\uBA54\uC778 \uAC1D\uCCB4"
       });
-    });
-    if (result.errors.length > 0) {
-      error(`\uB2E4\uC6B4\uB85C\uB4DC \uC2E4\uD328: ${result.errors[0].error}`);
-      for (const e of result.errors.slice(1)) {
-        console.log(chalk4.gray(`    ${e.path}: ${e.error}`));
-      }
-      continue;
-    }
-    if (result.written.length > 0) {
-      success(`${result.written.length}\uAC1C \uD30C\uC77C \uC800\uC7A5`);
-      for (const f of result.written) {
-        console.log(chalk4.gray(`    ${path6.relative(cwd, f)}`));
-      }
-    }
-    if (result.skipped.length > 0) {
-      info(`${result.skipped.length}\uAC1C \uD30C\uC77C \uAC74\uB108\uB700 (\uC774\uBBF8 \uC874\uC7AC \u2014 \uB36E\uC5B4\uC4F0\uAE30: --overwrite)`);
     }
-    await appendEnvKeys(cwd, recipe);
-    installed.push(key);
   }
-  if (installed.length === 0) {
-    return;
+  const edgeViolations = await validateEdges(cwd);
+  for (const ev of edgeViolations) {
+    violations.push({
+      rule: `edge-${ev.edge.from}-${ev.edge.to}`,
+      message: ev.message,
+      location: ev.edge.path
+    });
   }
-  await upsertRecipesSkill(cwd, installed);
-  await upsertClaudeMdBlock(cwd, installed);
-  console.log("");
-  success(`\uB808\uC2DC\uD53C ${installed.length}\uAC1C \uC124\uCE58 \uC644\uB8CC: ${installed.join(", ")}`);
-  console.log("");
-  console.log(colors.accent("  \uB2E4\uC74C \uB2E8\uACC4"));
-  console.log(colors.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
-  console.log(`  ${colors.success("1.")} ${colors.dim(".env.local \uD30C\uC77C\uC744 \uC5F4\uC5B4 \uD658\uACBD\uBCC0\uC218 \uAC12\uC744 \uCC44\uC6B0\uC138\uC694")}`);
-  for (const key of installed) {
-    const recipe = RECIPES[key];
-    for (const ek of recipe.envKeys) {
-      console.log(`     ${chalk4.cyan(ek.key.padEnd(22))} ${colors.dim(ek.hint ?? "")}`);
+  return makeResult("execution.entry", violations);
+}
+async function validationEntryGate(cwd) {
+  const violations = [];
+  const srcDir = path6.join(cwd, "src");
+  if (!await fs11.pathExists(srcDir)) {
+    violations.push({
+      rule: "src-dir-exists",
+      message: "src/ \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
+      location: "src/"
+    });
+  } else {
+    const codeFileCount = await countCodeFiles(srcDir);
+    if (codeFileCount === 0) {
+      violations.push({
+        rule: "code-files-min",
+        message: "src/ \uB0B4\uBD80\uC5D0 \uCF54\uB4DC \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. \uCD5C\uC18C 1\uAC1C \uD544\uC694.",
+        location: "src/"
+      });
     }
   }
-  console.log("");
-  console.log(`  ${colors.success("2.")} ${colors.dim("Claude Code\uC5D0\uC11C \uAD00\uB828 \uAE30\uB2A5 \uAD6C\uD604 \uC2DC \uC790\uB3D9\uC73C\uB85C \uB808\uC2DC\uD53C \uBB38\uC11C\uB97C \uCC38\uC870\uD569\uB2C8\uB2E4")}`);
-  for (const key of installed) {
-    const recipe = RECIPES[key];
-    console.log(`     ${chalk4.cyan(recipe.target + "/")}`);
+  const edgeViolations = await validateEdges(cwd);
+  for (const ev of edgeViolations) {
+    violations.push({
+      rule: `edge-${ev.edge.from}-${ev.edge.to}`,
+      message: ev.message,
+      location: ev.edge.path
+    });
   }
-  console.log("");
+  return makeResult("validation.entry", violations);
 }
-async function appendEnvKeys(cwd, recipe) {
-  if (recipe.envKeys.length === 0) return;
-  const envPath = path6.join(cwd, ".env.local");
-  let content = "";
-  if (await fs12.pathExists(envPath)) {
-    content = await fs12.readFile(envPath, "utf8");
+async function evaluationEntryGate(cwd) {
+  const violations = [];
+  const state = await loadRobocoState(cwd);
+  const recentValidation = [...state.stageHistory].reverse().find((h) => h.stage === "validation");
+  if (!recentValidation) {
+    violations.push({
+      rule: "validation-executed",
+      message: "validation \uB2E8\uACC4\uAC00 \uD55C \uBC88\uB3C4 \uC2E4\uD589\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 `pai test`\uB97C \uC2E4\uD589\uD558\uC138\uC694."
+    });
+  } else if (recentValidation.status !== "done") {
+    violations.push({
+      rule: "validation-passed",
+      message: `\uCD5C\uADFC validation\uC774 ${recentValidation.status} \uC0C1\uD0DC\uC785\uB2C8\uB2E4. \uD14C\uC2A4\uD2B8\uB97C \uC131\uACF5\uC2DC\uD0A8 \uB4A4 \uC2DC\uB3C4\uD558\uC138\uC694.`
+    });
+  } else {
+    const endedAt = recentValidation.endedAt ?? recentValidation.startedAt;
+    const age = Date.now() - new Date(endedAt).getTime();
+    if (age > EVAL_GATE_WINDOW_MS) {
+      const mins = Math.round(age / 6e4);
+      violations.push({
+        rule: "validation-recent",
+        message: `\uCD5C\uADFC validation \uD1B5\uACFC\uAC00 ${mins}\uBD84 \uC804\uC785\uB2C8\uB2E4 (1\uC2DC\uAC04 \uC774\uB0B4\uC5EC\uC57C \uD568). --force\uB85C \uC6B0\uD68C \uAC00\uB2A5.`
+      });
+    }
   }
-  const missingKeys = recipe.envKeys.filter((ek) => !content.includes(`${ek.key}=`));
-  if (missingKeys.length === 0) return;
-  const lines = [];
-  if (content.length > 0 && !content.endsWith("\n")) lines.push("");
-  lines.push("");
-  lines.push(`# \u2500\u2500 ${recipe.label} \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`);
-  lines.push(`# \uAC00\uC774\uB4DC: ${recipe.target}/guideline.md`);
-  for (const ek of missingKeys) {
-    if (ek.hint) lines.push(`# ${ek.hint}`);
-    lines.push(`${ek.key}=${ek.default ?? ""}`);
+  return makeResult("evaluation.entry", violations);
+}
+function countEndpoints(openspecContent) {
+  const lines = openspecContent.split("\n");
+  let inTable = false;
+  let count = 0;
+  for (const rawLine of lines) {
+    const line = rawLine.trim();
+    if (/^##\s*5\.|^##\s*API|API 엔드포인트/i.test(line)) {
+      inTable = true;
+      continue;
+    }
+    if (!inTable) continue;
+    if (/^##\s/.test(line) && !/5\.|API/i.test(line)) {
+      inTable = false;
+      continue;
+    }
+    if (/^\|\s*Method/i.test(line)) continue;
+    if (/^\|\s*[-:]+\s*\|/.test(line)) continue;
+    const m = line.match(/^\|\s*(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)\s*\|\s*(\/\S+)\s*\|/i);
+    if (m) count++;
   }
-  await fs12.ensureFile(envPath);
-  await fs12.appendFile(envPath, lines.join("\n") + "\n");
+  return count;
 }
-async function upsertRecipesSkill(cwd, installedKeys) {
-  const skillDir = path6.join(cwd, ".claude", "skills", "recipes");
-  await fs12.ensureDir(skillDir);
-  const skillPath = path6.join(skillDir, "SKILL.md");
-  const recipes = installedKeys.map((k) => RECIPES[k]);
-  const triggers = recipes.map((r) => r.skillDescription ?? `${r.label} \uAD00\uB828 \uAE30\uB2A5 \uAD6C\uD604 \uC2DC ${r.target}/ \uCC38\uC870`).join("\n- ");
-  const body = [
-    "---",
-    "name: recipes",
-    `description: "\uC0AC\uB0B4 \uC2DC\uC2A4\uD15C \uC5F0\uB3D9 \uB808\uC2DC\uD53C \u2014 ${recipes.map((r) => r.label).join(", ")}"`,
-    "---",
-    "",
-    "# \uC0AC\uB0B4 \uC2DC\uC2A4\uD15C \uC5F0\uB3D9 \uB808\uC2DC\uD53C",
-    "",
-    "\uC774 \uD504\uB85C\uC81D\uD2B8\uC5D0\uB294 \uB2E4\uC74C \uC0AC\uB0B4 \uC5F0\uB3D9 \uB808\uC2DC\uD53C\uAC00 \uC124\uCE58\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4.",
-    "\uAD00\uB828 \uC694\uCCAD\uC744 \uBC1B\uC73C\uBA74 \uD574\uB2F9 \uACBD\uB85C\uC758 `guideline.md`\uB97C **\uBC18\uB4DC\uC2DC \uBA3C\uC800 \uC77D\uACE0**",
-    "\uC9C0\uCE68\uC5D0 \uB9DE\uAC8C \uAD6C\uD604\uD558\uC138\uC694.",
-    "",
-    "## \uD2B8\uB9AC\uAC70",
-    "",
-    "- " + triggers,
-    "",
-    "## \uC124\uCE58\uB41C \uB808\uC2DC\uD53C",
-    "",
-    ...recipes.map((r) => [
-      `### ${r.label}`,
-      "",
-      `- \uACBD\uB85C: \`${r.target}/\``,
-      `- \uC8FC\uC694 \uBB38\uC11C: \`${r.target}/guideline.md\``,
-      `- \uD658\uACBD\uBCC0\uC218: ${r.envKeys.map((e) => "`" + e.key + "`").join(", ")}`,
-      ""
-    ].join("\n")),
-    "",
-    "## \uC791\uC5C5 \uC21C\uC11C",
-    "",
-    "1. \uC0AC\uC6A9\uC790\uC758 \uC694\uCCAD\uC774 \uC704 \uD2B8\uB9AC\uAC70 \uC911 \uD558\uB098\uC5D0 \uD574\uB2F9\uD558\uB294\uC9C0 \uD310\uB2E8",
-    "2. \uD574\uB2F9 \uB808\uC2DC\uD53C\uC758 `guideline.md`\uB97C Read \uB3C4\uAD6C\uB85C \uC77D\uAE30",
-    "3. \uC0D8\uD50C \uCF54\uB4DC(`*.html`, `*.ts` \uB4F1)\uAC00 \uC788\uC73C\uBA74 \uD568\uAED8 \uD655\uC778",
-    "4. `.env.local`\uC5D0 \uAD00\uB828 \uD658\uACBD\uBCC0\uC218\uAC00 \uCC44\uC6CC\uC838 \uC788\uB294\uC9C0 \uD655\uC778",
-    "5. \uAC00\uC774\uB4DC \uC21C\uC11C\uC5D0 \uB530\uB77C \uAD6C\uD604 \u2014 \uB808\uC2DC\uD53C \uADDC\uCE59\uC744 \uC808\uB300 \uC6B0\uD68C\uD558\uC9C0 \uB9D0 \uAC83",
-    ""
-  ].join("\n");
-  await fs12.writeFile(skillPath, body);
+function countDomainObjects(omcContent) {
+  const lines = omcContent.split("\n");
+  let count = 0;
+  let inDomainSection = false;
+  for (const rawLine of lines) {
+    const line = rawLine.trim();
+    if (/^##\s*도메인 객체|^##\s*Domain Objects/i.test(line)) {
+      inDomainSection = true;
+      continue;
+    }
+    if (!inDomainSection) continue;
+    if (/^##\s/.test(line) && !/도메인|Domain/i.test(line)) {
+      inDomainSection = false;
+      continue;
+    }
+    if (/^###\s+\w/.test(line)) count++;
+  }
+  return count;
 }
-async function upsertClaudeMdBlock(cwd, installedKeys) {
-  const claudeMdPath = path6.join(cwd, "CLAUDE.md");
-  const BLOCK_START = "<!-- pai:recipes:start -->";
-  const BLOCK_END = "<!-- pai:recipes:end -->";
-  const lines = [];
-  lines.push(BLOCK_START);
-  lines.push("## \uC0AC\uB0B4 \uC2DC\uC2A4\uD15C \uC5F0\uB3D9");
-  lines.push("");
-  lines.push("\uB2E4\uC74C \uB808\uC2DC\uD53C\uAC00 \uC124\uCE58\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4. \uAD00\uB828 \uAE30\uB2A5 \uAD6C\uD604 \uC2DC **\uBC18\uB4DC\uC2DC** \uD574\uB2F9 \uACBD\uB85C\uC758");
-  lines.push("`guideline.md`\uB97C \uBA3C\uC800 \uC77D\uACE0 \uC9C0\uCE68\uC744 \uB530\uB974\uC138\uC694:");
-  lines.push("");
-  for (const key of installedKeys) {
-    const r = RECIPES[key];
-    lines.push(`- **${r.label}** \u2014 \`${r.target}/\``);
-    lines.push(`  \uD658\uACBD\uBCC0\uC218: ${r.envKeys.map((e) => "`" + e.key + "`").join(", ")}`);
+async function validateEdges(cwd) {
+  const config = await loadConfig(cwd);
+  if (!config?.edges || config.edges.length === 0) return [];
+  const violations = [];
+  for (const edge of config.edges) {
+    if (edge.path) {
+      const fullPath = path6.join(cwd, edge.path);
+      if (!await fs11.pathExists(fullPath)) {
+        violations.push({
+          edge,
+          message: `${edge.from}\u2192${edge.to} \uACC4\uC57D \uD30C\uC77C \uC5C6\uC74C: ${edge.path}`
+        });
+        continue;
+      }
+    }
+    switch (edge.via) {
+      case "specFile":
+      case "endpoints": {
+        const specPath = edge.path ? path6.join(cwd, edge.path) : path6.join(cwd, "docs", "openspec.md");
+        if (await fs11.pathExists(specPath)) {
+          const content = await fs11.readFile(specPath, "utf8");
+          const count = countEndpoints(content);
+          if (count === 0) {
+            violations.push({
+              edge,
+              message: `${edge.from}\u2192${edge.to}: openspec.md\uC5D0 \uC815\uC758\uB41C \uC5D4\uB4DC\uD3EC\uC778\uD2B8\uAC00 0\uAC1C (\uCD5C\uC18C 1\uAC1C \uD544\uC694)`
+            });
+          }
+        }
+        break;
+      }
+      case "domain": {
+        const omcPath = edge.path ? path6.join(cwd, edge.path) : path6.join(cwd, ".pai", "omc.md");
+        if (await fs11.pathExists(omcPath)) {
+          const content = await fs11.readFile(omcPath, "utf8");
+          const count = countDomainObjects(content);
+          if (count === 0) {
+            violations.push({
+              edge,
+              message: `${edge.from}\u2192${edge.to}: omc.md\uC5D0 \uB3C4\uBA54\uC778 \uAC1D\uCCB4\uAC00 0\uAC1C (\uCD5C\uC18C 1\uAC1C \uD544\uC694)`
+            });
+          }
+        }
+        break;
+      }
+      case "businessRules": {
+        const omcPath = edge.path ? path6.join(cwd, edge.path) : path6.join(cwd, ".pai", "omc.md");
+        if (await fs11.pathExists(omcPath)) {
+          const content = await fs11.readFile(omcPath, "utf8");
+          const ruleCount = countBusinessRules(content);
+          if (ruleCount === 0) {
+            violations.push({
+              edge,
+              message: `${edge.from}\u2192${edge.to}: omc.md\uC5D0 \uBE44\uC988\uB2C8\uC2A4 \uADDC\uCE59\uC774 0\uAC1C \u2014 harness \uAC80\uC99D \uB300\uC0C1 \uC5C6\uC74C`
+            });
+          }
+        }
+        break;
+      }
+    }
   }
-  lines.push("");
-  lines.push("\uD658\uACBD\uBCC0\uC218 \uAC12\uC740 `.env.local`\uC5D0 \uCC44\uC6CC\uC838 \uC788\uC5B4\uC57C \uD569\uB2C8\uB2E4.");
-  lines.push(BLOCK_END);
-  const block = lines.join("\n");
-  let content = "";
-  if (await fs12.pathExists(claudeMdPath)) {
-    content = await fs12.readFile(claudeMdPath, "utf8");
+  return violations;
+}
+function countBusinessRules(omcContent) {
+  const lines = omcContent.split("\n");
+  let inSection = false;
+  let count = 0;
+  for (const rawLine of lines) {
+    const line = rawLine.trim();
+    if (/^##\s*비즈니스 규칙|^##\s*Business Rules/i.test(line)) {
+      inSection = true;
+      continue;
+    }
+    if (!inSection) continue;
+    if (/^##\s/.test(line) && !/비즈니스|Business/i.test(line)) {
+      inSection = false;
+      continue;
+    }
+    if (/^-\s+\*\*/.test(line) || /^-\s+[^\s]/.test(line)) count++;
   }
-  const startIdx = content.indexOf(BLOCK_START);
-  const endIdx = content.indexOf(BLOCK_END);
-  if (startIdx >= 0 && endIdx > startIdx) {
-    const before = content.slice(0, startIdx);
-    const after = content.slice(endIdx + BLOCK_END.length);
-    content = before + block + after;
-  } else {
-    if (content.length > 0 && !content.endsWith("\n")) content += "\n";
-    if (content.length > 0) content += "\n";
-    content += block + "\n";
+  return count;
+}
+async function countCodeFiles(srcDir) {
+  const exts = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".py", ".go", ".rs", ".java", ".kt"]);
+  let count = 0;
+  async function walk(dir) {
+    let entries;
+    try {
+      entries = await fs11.readdir(dir);
+    } catch {
+      return;
+    }
+    for (const name of entries) {
+      if (name.startsWith(".") || name === "node_modules") continue;
+      const full = path6.join(dir, name);
+      const stat = await fs11.stat(full).catch(() => null);
+      if (!stat) continue;
+      if (stat.isDirectory()) {
+        await walk(full);
+      } else if (exts.has(path6.extname(name))) {
+        count++;
+      }
+    }
   }
-  await fs12.ensureFile(claudeMdPath);
-  await fs12.writeFile(claudeMdPath, content);
+  await walk(srcDir);
+  return count;
 }
-var init_fetch_cmd = __esm({
-  "src/cli/commands/fetch.cmd.ts"() {
+var EVAL_GATE_WINDOW_MS, STAGE_GATES;
+var init_gates = __esm({
+  "src/core/gates.ts"() {
     "use strict";
-    init_ui();
-    init_logger();
-    init_recipes();
-    init_github_fetch();
-    init_progress();
+    init_roboco();
+    init_config();
+    EVAL_GATE_WINDOW_MS = 60 * 60 * 1e3;
+    STAGE_GATES = {
+      environment: async () => makeResult("environment.entry", []),
+      // 항상 통과
+      design: designEntryGate,
+      execution: executionEntryGate,
+      validation: validationEntryGate,
+      evaluation: evaluationEntryGate
+    };
   }
 });
 
-// src/stages/environment/index.ts
-var environmentStage;
-var init_environment = __esm({
-  "src/stages/environment/index.ts"() {
-    "use strict";
-    init_analyzer();
-    init_interviewer();
-    init_generator();
-    init_installer();
-    init_registry();
-    init_claude_commands();
-    init_detector();
-    init_config();
-    init_progress();
-    init_ui();
-    init_analyzer();
-    init_interviewer();
-    init_doctor();
-    environmentStage = {
-      name: "environment",
-      canSkip(input) {
-        return input.config.plugins.length > 0;
-      },
-      async run(input) {
-        const start = Date.now();
-        const artifacts = [];
-        const errors = [];
-        try {
-          console.log("");
-          const analysis = await withSpinner("\uD504\uB85C\uC81D\uD2B8 \uBD84\uC11D \uC911...", async () => {
-            const result = await analyzeProject(input.cwd);
-            await sleep(500);
-            return result;
-          });
-          console.log("");
-          if (analysis.stack.languages.length > 0) {
-            success(`\uC2A4\uD0DD: ${analysis.stack.languages.join(", ")}`);
-          }
-          if (analysis.stack.frameworks.length > 0) {
-            success(`\uD504\uB808\uC784\uC6CC\uD06C: ${analysis.stack.frameworks.join(", ")}`);
-          }
-          success(`Git: ${analysis.git.isGitRepo ? `${analysis.git.repoName ?? "local"}` : "\uBBF8\uCD08\uAE30\uD654"}`);
-          const interview = await runInterview(analysis, input.cwd, input.config.projectName);
-          console.log("");
-          const configFiles = [
-            "CLAUDE.md",
-            ".claude/settings.json",
-            "docs/vibe-coding/01-intent.md",
-            "docs/vibe-coding/02-requirements.md",
-            "docs/vibe-coding/03-research.md",
-            "docs/vibe-coding/04-plan.md",
-            "docs/vibe-coding/05-implement.md"
-          ];
-          const generated = await withFileSpinner("\uC124\uC815 \uD30C\uC77C \uC0DD\uC131 \uC911...", configFiles, async () => {
-            const files = await generateFiles(input.cwd, analysis, interview);
-            await sleep(400);
-            return files;
-          });
-          artifacts.push(...generated);
-          const basePlugins = ["github", "openspec", "roboco"];
-          const pluginKeys = [.../* @__PURE__ */ new Set([...basePlugins, ...interview.extraTools])];
-          const provCtx = {
-            cwd: input.cwd,
-            projectName: interview.projectName,
-            mode: interview.mode,
-            envEntries: {
-              PAI_PROJECT_NAME: interview.projectName,
-              PAI_MODE: interview.mode
-            },
-            analysis,
-            mcp: interview.mcp
-          };
-          if (interview.authMethods.includes("custom")) {
-            provCtx.envEntries["OAUTH_CLIENT_ID"] = interview.customAuth?.clientId || "YOUR_CLIENT_ID_HERE";
-            provCtx.envEntries["OAUTH_CLIENT_SECRET"] = interview.customAuth?.clientSecret || "YOUR_CLIENT_SECRET_HERE";
-            provCtx.envEntries["OAUTH_REDIRECT_URI"] = "http://localhost:3000/auth/callback";
-          }
-          const pluginFileNames = [
-            ".gitignore",
-            "src/",
-            "docs/",
-            "tests/",
-            "public/",
-            "docs/openspec.md",
-            ".pai/roboco.json",
-            ...interview.extraTools.includes("omc") ? [".pai/omc.md", ".omc/"] : [],
-            ...interview.extraTools.includes("vercel") ? ["vercel.json"] : [],
-            ...interview.extraTools.includes("supabase") ? ["supabase/config.toml"] : [],
-            ...interview.extraTools.includes("gstack") ? [".pai/gstack.json"] : [],
-            ...interview.extraTools.includes("harness") ? [".pai/harness.json"] : [],
-            ...interview.extraTools.includes("mcp") ? ["mcp-server/", ".mcp.json"] : [],
-            ".env.local"
-          ];
-          console.log("");
-          await withFileSpinner("\uD504\uB85C\uC81D\uD2B8 \uAD6C\uC870 \uC124\uCE58 \uC911...", pluginFileNames, async () => {
-            await runProvisioners(pluginKeys, provCtx);
-            await sleep(500);
-          });
-          const cmdFiles = [
-            "SKILL.md",
-            "info.md",
-            "init.md",
-            "status.md",
-            "doctor.md",
-            "design.md",
-            "validate.md",
-            "evaluate.md",
-            "install.md"
-          ];
-          console.log("");
-          await withFileSpinner("\uC2AC\uB798\uC2DC \uCEE4\uB9E8\uB4DC \uC124\uCE58 \uC911...", cmdFiles, async () => {
-            await provisionClaudeCommands(input.cwd);
-            await sleep(400);
-          });
-          console.log("");
-          const installResults = await installTools(interview.tools, input.cwd);
-          printInstallReport(installResults, interview.tools);
-          if (interview.recipes && interview.recipes.length > 0) {
-            console.log("");
-            const { fetchCommand: fetchCommand2 } = await Promise.resolve().then(() => (init_fetch_cmd(), fetch_cmd_exports));
-            for (const recipeKey of interview.recipes) {
-              try {
-                await fetchCommand2(input.cwd, recipeKey, {});
-              } catch (err) {
-                const msg = err instanceof Error ? err.message : String(err);
-                warn(`\uB808\uC2DC\uD53C '${recipeKey}' \uB2E4\uC6B4\uB85C\uB4DC \uC2E4\uD328 \u2014 ${msg}`);
-                hint(`\uB098\uC911\uC5D0 \uC218\uB3D9: pai fetch ${recipeKey}`);
-              }
-            }
-          }
-          console.log("");
-          await withSpinner("\uC124\uC815 \uC800\uC7A5 \uC911...", async () => {
-            const config = createDefaultConfig(interview.projectName, interview.mode);
-            config.plugins = pluginKeys;
-            config.edges = deriveEdges(pluginKeys);
-            if (interview.mcp) config.mcp = interview.mcp;
-            await saveConfig(input.cwd, config);
-            await sleep(300);
-          });
-          return {
-            stage: "environment",
-            status: "success",
-            data: { analysis, interview, installResults },
-            artifacts,
-            duration: Date.now() - start,
-            errors
-          };
-        } catch (err) {
-          const msg = err instanceof Error ? err.message : String(err);
-          errors.push({ code: "ENV_SETUP_FAILED", message: msg, recoverable: true });
-          return {
-            stage: "environment",
-            status: "failed",
-            data: {},
-            artifacts,
-            duration: Date.now() - start,
-            errors
-          };
-        }
-      }
-    };
-  }
-});
-
-// src/stages/evaluation/prompts/analyze.ts
-var analyze_exports = {};
-__export(analyze_exports, {
-  buildAnalysisPrompt: () => buildAnalysisPrompt
+// src/stages/environment/doctor.ts
+var doctor_exports = {};
+__export(doctor_exports, {
+  runDoctor: () => runDoctor
 });
-function buildAnalysisPrompt(repoPath) {
-  return `Analyze the repository at "${repoPath}" for vibe coding readiness.
-
-Use only Read, Glob, and Grep tools. Complete in ~20 tool calls.
-Focus on config files, not source code.
-
-Evaluate these 6 categories:
-
-### Must-Have (60% weight)
-1. **\uD14C\uC2A4\uD2B8 \uCEE4\uBC84\uB9AC\uC9C0**: test framework config, test dirs, coverage thresholds
-   - 0=none, 20=config only, 40=minimal files, 60=moderate, 80=good, 100=comprehensive
-2. **CI/CD**: pipeline configs, quality gates, multi-stage
-   - 0=none, 20=exists but minimal, 40=basic, 60=tests+lint, 80=tests+lint+build, 100=comprehensive
-3. **\uD6C5 \uAE30\uBC18 \uAC80\uC99D**: git hooks, lint-staged, AI agent hooks (.claude/settings.json)
-   - 0=none, 20=framework only, 40=single hook, 60=lint+format, 80=lint+test+format, 100=comprehensive+AI
-
-### Nice-to-Have (40% weight)
-4. **\uB9AC\uD3EC\uC9C0\uD1A0\uB9AC \uAD6C\uC870**: dir organization, deps management, env config
-   - 0=flat/chaotic, 20=minimal, 40=basic, 60=reasonable, 80=well-organized, 100=exemplary
-5. **\uBB38\uC11C\uD654 \uC218\uC900**: README, CONTRIBUTING, API docs, architecture docs
-   - 0=none, 20=minimal, 40=basic, 60=good README, 80=README+API, 100=comprehensive
-6. **\uD558\uB124\uC2A4 \uC5D4\uC9C0\uB2C8\uC5B4\uB9C1**: CLAUDE.md, AGENTS.md, .claude/ config, skills, commands
-   - 0=none, 20=basic, 40=one AI config, 60=context+config, 80=context+safety+skills, 100=comprehensive
-
-Output ONLY a JSON block:
-\`\`\`json
-{
-  "categories": [
-    {
-      "name": "\uCE74\uD14C\uACE0\uB9AC\uBA85 (Korean)",
-      "tier": "must" | "nice",
-      "score": 0-100,
-      "recommendations": [{ "severity": "critical"|"warning"|"info", "message": "...", "action": "..." }],
-      "rawFindings": [{ "item": "filename or concept", "found": true|false, "details": "..." }]
+import { join as join6 } from "path";
+import { homedir } from "os";
+import fs12 from "fs-extra";
+async function runDoctor() {
+  section("PAI Doctor \u2014 \uD658\uACBD \uC9C4\uB2E8");
+  const checks = [];
+  const nodeVersion = process.version;
+  const nodeMajor = parseInt(nodeVersion.slice(1).split(".")[0], 10);
+  checks.push({
+    label: "Node.js \uBC84\uC804",
+    ok: nodeMajor >= 20,
+    detail: `${nodeVersion} ${nodeMajor >= 20 ? "(>=20 OK)" : "(\uC5C5\uADF8\uB808\uC774\uB4DC \uD544\uC694)"}`,
+    fix: nodeMajor < 20 ? "Node.js 20 \uC774\uC0C1\uC73C\uB85C \uC5C5\uADF8\uB808\uC774\uB4DC\uD558\uC138\uC694" : void 0
+  });
+  const claudeCheck = await checkCommand("claude", ["--version"]);
+  checks.push({
+    label: "Claude Code CLI",
+    ok: claudeCheck.ok,
+    detail: claudeCheck.detail,
+    fix: claudeCheck.ok ? void 0 : "npm install -g @anthropic-ai/claude-code"
+  });
+  const globalConfigPath = join6(homedir(), ".pai", "config.json");
+  const hasGlobalConfig = await fs12.pathExists(globalConfigPath);
+  checks.push({
+    label: "\uAE00\uB85C\uBC8C \uC124\uC815",
+    ok: true,
+    detail: hasGlobalConfig ? globalConfigPath : "\uBBF8\uC124\uC815 (\uAE30\uBCF8\uAC12 \uC0AC\uC6A9)"
+  });
+  let hasSdk = false;
+  try {
+    await import("@anthropic-ai/claude-agent-sdk");
+    hasSdk = true;
+  } catch {
+  }
+  checks.push({
+    label: "Agent SDK",
+    ok: true,
+    // optional이므로 항상 OK
+    detail: hasSdk ? "\uC124\uCE58\uB428 (AI \uAE30\uB2A5 \uD65C\uC131\uD654)" : "\uBBF8\uC124\uCE58 (\uC815\uC801 \uBD84\uC11D \uBAA8\uB4DC)"
+  });
+  const { validateEdges: validateEdges2 } = await Promise.resolve().then(() => (init_gates(), gates_exports));
+  const edgeViolations = await validateEdges2(process.cwd());
+  if (edgeViolations.length > 0) {
+    checks.push({
+      label: "\uACC4\uC57D \uBB34\uACB0\uC131 (edges)",
+      ok: false,
+      detail: `${edgeViolations.length}\uAC74 \uC704\uBC18`,
+      fix: edgeViolations.map((v) => v.message).join("; ")
+    });
+  } else {
+    const { loadConfig: loadCfg } = await Promise.resolve().then(() => (init_config(), config_exports));
+    const cfg = await loadCfg(process.cwd());
+    const edgeCount = cfg?.edges?.length ?? 0;
+    checks.push({
+      label: "\uACC4\uC57D \uBB34\uACB0\uC131 (edges)",
+      ok: true,
+      detail: edgeCount > 0 ? `${edgeCount}\uAC1C \uC5E3\uC9C0 \uBAA8\uB450 \uC720\uD6A8` : "\uC5E3\uC9C0 \uC5C6\uC74C (\uC815\uC0C1)"
+    });
+  }
+  console.log("");
+  let passed = 0;
+  for (const check of checks) {
+    const icon = check.ok ? "\u2713" : "\u2717";
+    const pad = " ".repeat(Math.max(1, 20 - check.label.length));
+    if (check.ok) {
+      success(`${icon} ${check.label}${pad}${check.detail}`);
+      passed++;
+    } else {
+      error(`${icon} ${check.label}${pad}${check.detail}`);
+      if (check.fix) {
+        info(`  \u2192 ${check.fix}`);
+      }
     }
-  ],
-  "summary": "2-3 sentence Korean summary"
+  }
+  console.log("");
+  info(`${passed}/${checks.length} \uD56D\uBAA9 \uD1B5\uACFC`);
+  if (passed < checks.length) {
+    process.exitCode = 1;
+  }
 }
-\`\`\``;
+async function checkCommand(cmd, args) {
+  try {
+    const { execa } = await import("execa");
+    const { stdout } = await execa(cmd, args, { timeout: 1e4 });
+    return { ok: true, detail: stdout.trim().split("\n")[0] ?? "ok" };
+  } catch {
+    return { ok: false, detail: "not found" };
+  }
 }
-var init_analyze = __esm({
-  "src/stages/evaluation/prompts/analyze.ts"() {
+var init_doctor = __esm({
+  "src/stages/environment/doctor.ts"() {
     "use strict";
+    init_ui();
   }
 });
 
-// src/stages/evaluation/analyzer.ts
-var analyzer_exports2 = {};
-__export(analyzer_exports2, {
-  analyzeRepository: () => analyzeRepository
-});
-import { join as join7 } from "path";
+// src/utils/github-fetch.ts
+import path7 from "path";
 import fs13 from "fs-extra";
-async function analyzeRepository(repoPath) {
+async function httpGet(url, timeoutMs, accept) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
   try {
-    return await aiAnalysis(repoPath);
-  } catch {
-    return staticAnalysis(repoPath);
+    return await fetch(url, {
+      signal: controller.signal,
+      headers: { "Accept": accept, "User-Agent": "pai-zero" }
+    });
+  } finally {
+    clearTimeout(timer);
   }
 }
-async function aiAnalysis(repoPath) {
-  const { query } = await import("@anthropic-ai/claude-agent-sdk");
-  const { buildAnalysisPrompt: buildAnalysisPrompt2 } = await Promise.resolve().then(() => (init_analyze(), analyze_exports));
-  const prompt = buildAnalysisPrompt2(repoPath);
-  let resultText = "";
-  for await (const message of query({
-    prompt,
-    options: {
-      maxTurns: 200,
-      systemPrompt: "You are a vibe coding readiness analyzer. Analyze the repository and output JSON.",
-      allowedTools: ["Read", "Glob", "Grep"],
-      permissionMode: "plan"
-    }
-  })) {
-    if ("result" in message) {
-      resultText = message.result;
-    }
-  }
-  return parseJsonFromText(resultText);
-}
-function parseJsonFromText(text) {
-  const jsonMatch = text.match(/```json\s*([\s\S]*?)```/);
-  if (jsonMatch?.[1]) {
-    return JSON.parse(jsonMatch[1]);
-  }
-  return JSON.parse(text);
-}
-async function staticAnalysis(repoPath) {
-  const categories = [];
-  categories.push(await checkTestCoverage(repoPath));
-  categories.push(await checkCiCd(repoPath));
-  categories.push(await checkHooks(repoPath));
-  categories.push(await checkRepoStructure(repoPath));
-  categories.push(await checkDocumentation(repoPath));
-  categories.push(await checkHarnessEngineering(repoPath));
-  return {
-    categories,
-    summary: `\uC815\uC801 \uBD84\uC11D \uC644\uB8CC. ${categories.filter((c2) => c2.score >= 60).length}/6 \uCE74\uD14C\uACE0\uB9AC \uD1B5\uACFC.`
-  };
-}
-async function checkTestCoverage(repoPath) {
-  const findings = [];
-  let score = 0;
-  const testConfigs = [
-    "jest.config.ts",
-    "jest.config.js",
-    "vitest.config.ts",
-    "vitest.config.js",
-    "pytest.ini",
-    "phpunit.xml",
-    ".nycrc"
-  ];
-  for (const f of testConfigs) {
-    const found = await fs13.pathExists(join7(repoPath, f));
-    findings.push({ item: f, found, details: found ? "\uC874\uC7AC" : "\uC5C6\uC74C" });
-    if (found) score += 20;
-  }
-  const testDirs = ["tests", "test", "__tests__", "spec"];
-  let hasTestDir = false;
-  for (const d of testDirs) {
-    if (await fs13.pathExists(join7(repoPath, d))) {
-      findings.push({ item: d, found: true, details: "\uD14C\uC2A4\uD2B8 \uB514\uB809\uD1A0\uB9AC \uC874\uC7AC" });
-      hasTestDir = true;
-      score += 30;
-      break;
-    }
-  }
-  if (!hasTestDir) {
-    findings.push({ item: "test directory", found: false, details: "\uD14C\uC2A4\uD2B8 \uB514\uB809\uD1A0\uB9AC \uC5C6\uC74C" });
-  }
-  score = Math.min(100, score);
-  const recommendations = score < 60 ? [{ severity: "critical", message: "\uD14C\uC2A4\uD2B8 \uD658\uACBD \uBBF8\uAD6C\uC131", action: "\uD14C\uC2A4\uD2B8 \uD504\uB808\uC784\uC6CC\uD06C\uC640 \uD14C\uC2A4\uD2B8 \uB514\uB809\uD1A0\uB9AC\uB97C \uCD94\uAC00\uD558\uC138\uC694" }] : [];
-  return { name: "\uD14C\uC2A4\uD2B8 \uCEE4\uBC84\uB9AC\uC9C0", tier: "must", score, recommendations, rawFindings: findings };
-}
-async function checkCiCd(repoPath) {
-  const findings = [];
-  let score = 0;
-  const ciConfigs = [
-    { path: ".github/workflows", label: "GitHub Actions" },
-    { path: ".gitlab-ci.yml", label: "GitLab CI" },
-    { path: "Jenkinsfile", label: "Jenkins" },
-    { path: ".circleci", label: "CircleCI" }
-  ];
-  for (const { path: path10, label } of ciConfigs) {
-    const found = await fs13.pathExists(join7(repoPath, path10));
-    findings.push({ item: label, found, details: found ? "\uC874\uC7AC" : "\uC5C6\uC74C" });
-    if (found) score += 40;
-  }
-  score = Math.min(100, score);
-  const recommendations = score === 0 ? [{ severity: "critical", message: "CI/CD \uBBF8\uAD6C\uC131", action: "GitHub Actions \uB610\uB294 \uB2E4\uB978 CI \uD30C\uC774\uD504\uB77C\uC778\uC744 \uC124\uC815\uD558\uC138\uC694" }] : [];
-  return { name: "CI/CD", tier: "must", score, recommendations, rawFindings: findings };
-}
-async function checkHooks(repoPath) {
-  const findings = [];
-  let score = 0;
-  const hookConfigs = [
-    { path: ".husky", label: "Husky" },
-    { path: ".lintstagedrc", label: "lint-staged" },
-    { path: ".lintstagedrc.json", label: "lint-staged (json)" },
-    { path: "commitlint.config.js", label: "commitlint" },
-    { path: ".claude/settings.json", label: "Claude Code settings" }
-  ];
-  for (const { path: path10, label } of hookConfigs) {
-    const found = await fs13.pathExists(join7(repoPath, path10));
-    findings.push({ item: label, found, details: found ? "\uC874\uC7AC" : "\uC5C6\uC74C" });
-    if (found) score += 20;
+async function listDir(repo, ref, dirPath, timeoutMs) {
+  const url = `https://api.github.com/repos/${repo}/contents/${encodeURI(dirPath)}?ref=${encodeURIComponent(ref)}`;
+  const res = await httpGet(url, timeoutMs, "application/vnd.github+json");
+  if (!res.ok) {
+    throw new Error(`GitHub API ${res.status} ${res.statusText} (${url})`);
   }
-  score = Math.min(100, score);
-  const recommendations = score < 40 ? [{ severity: "warning", message: "\uD6C5 \uAE30\uBC18 \uAC80\uC99D \uBD80\uC871", action: "Husky + lint-staged\uB97C \uC124\uC815\uD558\uC5EC \uCEE4\uBC0B \uC804 \uAC80\uC99D\uC744 \uCD94\uAC00\uD558\uC138\uC694" }] : [];
-  return { name: "\uD6C5 \uAE30\uBC18 \uAC80\uC99D", tier: "must", score, recommendations, rawFindings: findings };
-}
-async function checkRepoStructure(repoPath) {
-  const findings = [];
-  let score = 0;
-  const structureChecks = [
-    { path: "src", label: "src/ \uB514\uB809\uD1A0\uB9AC" },
-    { path: "package.json", label: "\uC758\uC874\uC131 \uAD00\uB9AC" },
-    { path: ".env.example", label: "\uD658\uACBD\uBCC0\uC218 \uC608\uC2DC" },
-    { path: ".gitignore", label: ".gitignore" }
-  ];
-  for (const { path: path10, label } of structureChecks) {
-    const found = await fs13.pathExists(join7(repoPath, path10));
-    findings.push({ item: label, found, details: found ? "\uC874\uC7AC" : "\uC5C6\uC74C" });
-    if (found) score += 25;
+  const data = await res.json();
+  if (!Array.isArray(data)) {
+    throw new Error(`Expected directory, got single entry at ${dirPath}`);
   }
-  score = Math.min(100, score);
-  return { name: "\uB9AC\uD3EC\uC9C0\uD1A0\uB9AC \uAD6C\uC870", tier: "nice", score, recommendations: [], rawFindings: findings };
+  return data;
 }
-async function checkDocumentation(repoPath) {
-  const findings = [];
-  let score = 0;
-  const docChecks = [
-    { path: "README.md", label: "README.md", points: 30 },
-    { path: "CONTRIBUTING.md", label: "CONTRIBUTING.md", points: 20 },
-    { path: "docs", label: "docs/ \uB514\uB809\uD1A0\uB9AC", points: 25 },
-    { path: "docs/openspec.md", label: "OpenSpec PRD", points: 25 }
-  ];
-  for (const { path: path10, label, points } of docChecks) {
-    const found = await fs13.pathExists(join7(repoPath, path10));
-    findings.push({ item: label, found, details: found ? "\uC874\uC7AC" : "\uC5C6\uC74C" });
-    if (found) score += points;
+async function downloadFile(downloadUrl, destPath, timeoutMs) {
+  const res = await httpGet(downloadUrl, timeoutMs, "*/*");
+  if (!res.ok) {
+    throw new Error(`Download failed ${res.status} ${res.statusText} (${downloadUrl})`);
   }
-  score = Math.min(100, score);
-  return { name: "\uBB38\uC11C\uD654 \uC218\uC900", tier: "nice", score, recommendations: [], rawFindings: findings };
+  const buf = Buffer.from(await res.arrayBuffer());
+  await fs13.ensureDir(path7.dirname(destPath));
+  await fs13.writeFile(destPath, buf);
 }
-async function checkHarnessEngineering(repoPath) {
-  const findings = [];
-  let score = 0;
-  const harnessChecks = [
-    { path: "CLAUDE.md", label: "CLAUDE.md", points: 25 },
-    { path: "AGENTS.md", label: "AGENTS.md", points: 15 },
-    { path: ".claude/settings.json", label: ".claude/settings.json", points: 20 },
-    { path: ".claude/skills", label: ".claude/skills/", points: 20 },
-    { path: ".claude/commands", label: ".claude/commands/", points: 10 },
-    { path: ".pai/config.json", label: "PAI config", points: 10 }
-  ];
-  for (const { path: path10, label, points } of harnessChecks) {
-    const found = await fs13.pathExists(join7(repoPath, path10));
-    findings.push({ item: label, found, details: found ? "\uC874\uC7AC" : "\uC5C6\uC74C" });
-    if (found) score += points;
+async function fetchGithubDir(opts) {
+  const {
+    repo,
+    ref = "main",
+    srcPath,
+    destDir,
+    overwrite = false,
+    timeoutMs = 1e4
+  } = opts;
+  const result = { written: [], skipped: [], errors: [] };
+  async function walk(currentSrc, currentDest) {
+    let entries;
+    try {
+      entries = await listDir(repo, ref, currentSrc, timeoutMs);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      result.errors.push({ path: currentSrc, error: msg });
+      return;
+    }
+    for (const entry of entries) {
+      const relName = entry.name;
+      if (entry.type === "dir") {
+        await walk(`${currentSrc}/${relName}`, path7.join(currentDest, relName));
+      } else if (entry.type === "file") {
+        const destFile = path7.join(currentDest, relName);
+        if (!overwrite && await fs13.pathExists(destFile)) {
+          result.skipped.push(destFile);
+          continue;
+        }
+        if (!entry.download_url) {
+          result.errors.push({ path: entry.path, error: "no download_url" });
+          continue;
+        }
+        try {
+          await downloadFile(entry.download_url, destFile, timeoutMs);
+          result.written.push(destFile);
+        } catch (err) {
+          const msg = err instanceof Error ? err.message : String(err);
+          result.errors.push({ path: entry.path, error: msg });
+        }
+      }
+    }
   }
-  score = Math.min(100, score);
-  return { name: "\uD558\uB124\uC2A4 \uC5D4\uC9C0\uB2C8\uC5B4\uB9C1", tier: "nice", score, recommendations: [], rawFindings: findings };
+  await walk(srcPath, destDir);
+  return result;
 }
-var init_analyzer2 = __esm({
-  "src/stages/evaluation/analyzer.ts"() {
-    "use strict";
-  }
-});
-
-// src/core/types/stage.ts
-var STAGE_ORDER;
-var init_stage = __esm({
-  "src/core/types/stage.ts"() {
+var init_github_fetch = __esm({
+  "src/utils/github-fetch.ts"() {
     "use strict";
-    STAGE_ORDER = [
-      "environment",
-      "design",
-      "execution",
-      "validation",
-      "evaluation"
-    ];
   }
 });
 
-// src/core/types/scoring.ts
-function gradeFromScore(score) {
-  if (score >= 90) return "A";
-  if (score >= 80) return "B";
-  if (score >= 70) return "C";
-  if (score >= 50) return "D";
-  return "F";
-}
-var DEFAULT_CATEGORY_WEIGHTS;
-var init_scoring = __esm({
-  "src/core/types/scoring.ts"() {
-    "use strict";
-    DEFAULT_CATEGORY_WEIGHTS = [
-      { name: "\uD14C\uC2A4\uD2B8 \uCEE4\uBC84\uB9AC\uC9C0", tier: "must", weight: 0.2 },
-      { name: "CI/CD", tier: "must", weight: 0.2 },
-      { name: "\uD6C5 \uAE30\uBC18 \uAC80\uC99D", tier: "must", weight: 0.2 },
-      { name: "\uB9AC\uD3EC\uC9C0\uD1A0\uB9AC \uAD6C\uC870", tier: "nice", weight: 0.133 },
-      { name: "\uBB38\uC11C\uD654 \uC218\uC900", tier: "nice", weight: 0.133 },
-      { name: "\uD558\uB124\uC2A4 \uC5D4\uC9C0\uB2C8\uC5B4\uB9C1", tier: "nice", weight: 0.134 }
-    ];
-  }
+// src/cli/commands/fetch.cmd.ts
+var fetch_cmd_exports = {};
+__export(fetch_cmd_exports, {
+  fetchCommand: () => fetchCommand
 });
-
-// src/core/types/index.ts
-var init_types = __esm({
-  "src/core/types/index.ts"() {
-    "use strict";
-    init_stage();
-    init_scoring();
+import path8 from "path";
+import fs14 from "fs-extra";
+import chalk4 from "chalk";
+async function fetchCommand(cwd, recipeKey, options) {
+  if (options.list) {
+    section("\uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uB808\uC2DC\uD53C");
+    for (const key of listRecipeKeys()) {
+      const r = RECIPES[key];
+      console.log(`  ${colors.accent(key.padEnd(14))} ${r.label}`);
+      console.log(`  ${colors.dim("               " + r.description)}`);
+      console.log(`  ${colors.dim("               \uC18C\uC2A4: github.com/" + r.source.repo + "/tree/" + r.source.ref + "/" + r.source.path)}`);
+      console.log("");
+    }
+    hint("\uC0AC\uC6A9: pai fetch <key>  \uB610\uB294  pai fetch --all");
+    return;
   }
-});
-
-// src/stages/evaluation/scorer.ts
-var scorer_exports = {};
-__export(scorer_exports, {
-  computeResult: () => computeResult
-});
-function computeResult(llmOutput, customWeights) {
-  const weights = customWeights ?? DEFAULT_CATEGORY_WEIGHTS;
-  const categories = llmOutput.categories.map((cat) => ({
-    name: cat.name,
-    tier: cat.tier,
-    score: Math.round(Math.max(0, Math.min(100, cat.score))),
-    grade: gradeFromScore(Math.max(0, Math.min(100, cat.score))),
-    recommendations: cat.recommendations,
-    rawFindings: cat.rawFindings
-  }));
-  const totalScore = computeWeightedAverage(categories, weights);
-  let totalGrade = gradeFromScore(totalScore);
-  const { penaltyApplied, penaltyReason } = checkPenalty(categories);
-  if (penaltyApplied && gradeRank(totalGrade) > gradeRank("C")) {
-    totalGrade = "C";
-  }
-  return {
-    categories,
-    totalScore,
-    totalGrade,
-    summary: llmOutput.summary,
-    penaltyApplied,
-    penaltyReason
-  };
-}
-function computeWeightedAverage(categories, weights) {
-  let weightedSum = 0;
-  let totalWeight = 0;
-  for (const cat of categories) {
-    const config = weights.find((w) => w.name === cat.name);
-    const weight = config?.weight ?? (cat.tier === "must" ? 0.2 : 0.133);
-    weightedSum += cat.score * weight;
-    totalWeight += weight;
+  let keys;
+  if (options.all) {
+    keys = listRecipeKeys();
+  } else {
+    if (!recipeKey) {
+      error("\uB808\uC2DC\uD53C \uD0A4\uB97C \uC9C0\uC815\uD558\uC138\uC694.");
+      hint(`\uC0AC\uC6A9 \uAC00\uB2A5: ${listRecipeKeys().join(", ")}`);
+      hint("\uBAA9\uB85D: pai fetch --list");
+      process.exitCode = 1;
+      return;
+    }
+    if (!getRecipe(recipeKey)) {
+      error(`\uC54C \uC218 \uC5C6\uB294 \uB808\uC2DC\uD53C: ${recipeKey}`);
+      hint(`\uC0AC\uC6A9 \uAC00\uB2A5: ${listRecipeKeys().join(", ")}`);
+      process.exitCode = 1;
+      return;
+    }
+    keys = [recipeKey.toLowerCase()];
   }
-  if (totalWeight === 0) return 0;
-  return Math.round(weightedSum / totalWeight * 100) / 100;
-}
-function checkPenalty(categories) {
-  const failedMust = categories.filter(
-    (c2) => c2.tier === "must" && c2.grade === "F"
-  );
-  if (failedMust.length > 0) {
-    const names = failedMust.map((c2) => c2.name).join(", ");
-    return {
-      penaltyApplied: true,
-      penaltyReason: `\uD544\uC218 \uCE74\uD14C\uACE0\uB9AC F \uB4F1\uAE09: ${names} \u2192 \uC804\uCCB4 \uB4F1\uAE09 \uCD5C\uB300 C\uB85C \uC81C\uD55C`
-    };
+  section("\uB808\uC2DC\uD53C \uB2E4\uC6B4\uB85C\uB4DC");
+  const installed = [];
+  for (const key of keys) {
+    const recipe = RECIPES[key];
+    const targetDir = path8.join(cwd, recipe.target);
+    console.log("");
+    console.log(`  ${colors.accent(key)} \u2014 ${recipe.label}`);
+    const result = await withSpinner(`\uB2E4\uC6B4\uB85C\uB4DC \uC911...`, async () => {
+      return fetchGithubDir({
+        repo: recipe.source.repo,
+        ref: recipe.source.ref,
+        srcPath: recipe.source.path,
+        destDir: targetDir,
+        overwrite: options.overwrite ?? false
+      });
+    });
+    if (result.errors.length > 0) {
+      error(`\uB2E4\uC6B4\uB85C\uB4DC \uC2E4\uD328: ${result.errors[0].error}`);
+      for (const e of result.errors.slice(1)) {
+        console.log(chalk4.gray(`    ${e.path}: ${e.error}`));
+      }
+      continue;
+    }
+    if (result.written.length > 0) {
+      success(`${result.written.length}\uAC1C \uD30C\uC77C \uC800\uC7A5`);
+      for (const f of result.written) {
+        console.log(chalk4.gray(`    ${path8.relative(cwd, f)}`));
+      }
+    }
+    if (result.skipped.length > 0) {
+      info(`${result.skipped.length}\uAC1C \uD30C\uC77C \uAC74\uB108\uB700 (\uC774\uBBF8 \uC874\uC7AC \u2014 \uB36E\uC5B4\uC4F0\uAE30: --overwrite)`);
+    }
+    await appendEnvKeys(cwd, recipe);
+    installed.push(key);
   }
-  return { penaltyApplied: false };
-}
-function gradeRank(grade) {
-  const ranks = { A: 4, B: 3, C: 2, D: 1, F: 0 };
-  return ranks[grade];
-}
-var init_scorer = __esm({
-  "src/stages/evaluation/scorer.ts"() {
-    "use strict";
-    init_types();
+  if (installed.length === 0) {
+    return;
   }
-});
-
-// src/stages/evaluation/reporter.ts
-var reporter_exports = {};
-__export(reporter_exports, {
-  buildDetailedReport: () => buildDetailedReport,
-  buildMarkdownReport: () => buildMarkdownReport,
-  printReport: () => printReport,
-  printVerboseFindings: () => printVerboseFindings
-});
-import chalk5 from "chalk";
-function printReport(result) {
+  await upsertRecipesSkill(cwd, installed);
+  await upsertClaudeMdBlock(cwd, installed);
   console.log("");
-  console.log(chalk5.hex("#7B93DB")("  PAI Evaluation Report"));
-  console.log(chalk5.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  success(`\uB808\uC2DC\uD53C ${installed.length}\uAC1C \uC124\uCE58 \uC644\uB8CC: ${installed.join(", ")}`);
   console.log("");
-  const gradeColor = GRADE_COLORS[result.totalGrade];
-  console.log(`  \uC885\uD569 \uC810\uC218: ${gradeColor(String(result.totalScore))} / 100  \uB4F1\uAE09: ${gradeColor(result.totalGrade)}`);
-  if (result.penaltyApplied) {
-    console.log(chalk5.red(`  \u26A0 ${result.penaltyReason}`));
+  console.log(colors.accent("  \uB2E4\uC74C \uB2E8\uACC4"));
+  console.log(colors.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(`  ${colors.success("1.")} ${colors.dim(".env.local \uD30C\uC77C\uC744 \uC5F4\uC5B4 \uD658\uACBD\uBCC0\uC218 \uAC12\uC744 \uCC44\uC6B0\uC138\uC694")}`);
+  for (const key of installed) {
+    const recipe = RECIPES[key];
+    for (const ek of recipe.envKeys) {
+      console.log(`     ${chalk4.cyan(ek.key.padEnd(22))} ${colors.dim(ek.hint ?? "")}`);
+    }
   }
   console.log("");
-  console.log(chalk5.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
-  for (const cat of result.categories) {
-    const color = GRADE_COLORS[cat.grade];
-    const tierLabel = cat.tier === "must" ? chalk5.hex("#E06C75")("[\uD544\uC218]") : chalk5.gray("[\uC120\uD0DD]");
-    const bar = renderBar(cat.score);
-    console.log(`  ${tierLabel} ${cat.name.padEnd(16)} ${bar} ${color(`${cat.score}`).padStart(12)} ${color(cat.grade)}`);
+  console.log(`  ${colors.success("2.")} ${colors.dim("Claude Code\uC5D0\uC11C \uAD00\uB828 \uAE30\uB2A5 \uAD6C\uD604 \uC2DC \uC790\uB3D9\uC73C\uB85C \uB808\uC2DC\uD53C \uBB38\uC11C\uB97C \uCC38\uC870\uD569\uB2C8\uB2E4")}`);
+  for (const key of installed) {
+    const recipe = RECIPES[key];
+    console.log(`     ${chalk4.cyan(recipe.target + "/")}`);
   }
   console.log("");
-  console.log(chalk5.gray(`  ${result.summary}`));
-  console.log("");
-}
-function printVerboseFindings(result) {
-  for (const cat of result.categories) {
-    console.log("");
-    console.log(chalk5.bold(`  ${cat.name} (${cat.grade}, ${cat.score}\uC810)`));
-    for (const f of cat.rawFindings) {
-      const icon = f.found ? chalk5.green("\u2713") : chalk5.red("\u2717");
-      console.log(`    ${icon} ${f.item} \u2014 ${f.details}`);
-    }
-    for (const r of cat.recommendations) {
-      const severity = r.severity === "critical" ? chalk5.red("!") : r.severity === "warning" ? chalk5.yellow("!") : chalk5.gray("i");
-      console.log(`    ${severity} ${r.message}`);
-      console.log(chalk5.gray(`      \u2192 ${r.action}`));
-    }
-  }
 }
-function renderBar(score) {
-  const width = 20;
-  const filled = Math.round(score / 100 * width);
-  const empty = width - filled;
-  const color = score >= 80 ? chalk5.hex("#6BCB77") : score >= 60 ? chalk5.hex("#E2B340") : chalk5.hex("#E06C75");
-  return color("\u2588".repeat(filled)) + chalk5.gray("\u2591".repeat(empty));
-}
-function buildMarkdownReport(result) {
-  const lines = [
-    "# PAI Evaluation Report",
-    "",
-    `> \uC0DD\uC131\uC77C\uC2DC: ${(/* @__PURE__ */ new Date()).toLocaleString("ko-KR")}`,
-    "",
-    `## \uC885\uD569 \uC810\uC218: ${result.totalScore}/100 \u2014 \uB4F1\uAE09 ${result.totalGrade}`,
-    ""
-  ];
-  if (result.penaltyApplied) {
-    lines.push(`> \u26A0 ${result.penaltyReason}`);
-    lines.push("");
-  }
-  lines.push("## \uCE74\uD14C\uACE0\uB9AC\uBCC4 \uC0C1\uC138");
-  lines.push("");
-  lines.push("| \uCE74\uD14C\uACE0\uB9AC | \uBD84\uB958 | \uC810\uC218 | \uB4F1\uAE09 |");
-  lines.push("|---------|------|------|------|");
-  for (const cat of result.categories) {
-    const tier = cat.tier === "must" ? "\uD544\uC218" : "\uC120\uD0DD";
-    lines.push(`| ${cat.name} | ${tier} | ${cat.score} | ${cat.grade} |`);
+async function appendEnvKeys(cwd, recipe) {
+  if (recipe.envKeys.length === 0) return;
+  const envPath = path8.join(cwd, ".env.local");
+  let content = "";
+  if (await fs14.pathExists(envPath)) {
+    content = await fs14.readFile(envPath, "utf8");
   }
+  const missingKeys = recipe.envKeys.filter((ek) => !content.includes(`${ek.key}=`));
+  if (missingKeys.length === 0) return;
+  const lines = [];
+  if (content.length > 0 && !content.endsWith("\n")) lines.push("");
   lines.push("");
-  lines.push("## \uAD8C\uACE0\uC0AC\uD56D");
-  lines.push("");
-  const allRecs = result.categories.flatMap(
-    (c2) => c2.recommendations.map((r) => ({ ...r, category: c2.name }))
-  );
-  if (allRecs.length === 0) {
-    lines.push("\uBAA8\uB4E0 \uD56D\uBAA9\uC774 \uC591\uD638\uD569\uB2C8\uB2E4!");
-  } else {
-    for (const r of allRecs) {
-      const icon = r.severity === "critical" ? "\u{1F534}" : r.severity === "warning" ? "\u{1F7E1}" : "\u2139\uFE0F";
-      lines.push(`- ${icon} **${r.category}**: ${r.message}`);
-      lines.push(`  - ${r.action}`);
-    }
+  lines.push(`# \u2500\u2500 ${recipe.label} \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`);
+  lines.push(`# \uAC00\uC774\uB4DC: ${recipe.target}/guideline.md`);
+  for (const ek of missingKeys) {
+    if (ek.hint) lines.push(`# ${ek.hint}`);
+    lines.push(`${ek.key}=${ek.default ?? ""}`);
   }
-  lines.push("");
-  lines.push(`## \uC694\uC57D`);
-  lines.push("");
-  lines.push(result.summary);
-  lines.push("");
-  lines.push("---");
-  lines.push("*Generated by PAI (Plugin-based AI)*");
-  return lines.join("\n") + "\n";
+  await fs14.ensureFile(envPath);
+  await fs14.appendFile(envPath, lines.join("\n") + "\n");
 }
-function buildDetailedReport(result, projectName) {
-  const now2 = (/* @__PURE__ */ new Date()).toLocaleString("ko-KR");
-  const mustCats = result.categories.filter((c2) => c2.tier === "must");
-  const niceCats = result.categories.filter((c2) => c2.tier === "nice");
-  const lines = [
-    `# ${projectName} \uBC14\uC774\uBE0C \uCF54\uB529 \uC900\uBE44\uB3C4 \uBD84\uC11D \uB9AC\uD3EC\uD2B8`,
+async function upsertRecipesSkill(cwd, installedKeys) {
+  const skillDir = path8.join(cwd, ".claude", "skills", "recipes");
+  await fs14.ensureDir(skillDir);
+  const skillPath = path8.join(skillDir, "SKILL.md");
+  const recipes = installedKeys.map((k) => RECIPES[k]);
+  const triggers = recipes.map((r) => r.skillDescription ?? `${r.label} \uAD00\uB828 \uAE30\uB2A5 \uAD6C\uD604 \uC2DC ${r.target}/ \uCC38\uC870`).join("\n- ");
+  const body = [
+    "---",
+    "name: recipes",
+    `description: "\uC0AC\uB0B4 \uC2DC\uC2A4\uD15C \uC5F0\uB3D9 \uB808\uC2DC\uD53C \u2014 ${recipes.map((r) => r.label).join(", ")}"`,
+    "---",
     "",
-    `> \uC2A4\uCE94 \uC77C\uC2DC: ${now2}`,
-    `> \uBD84\uC11D \uB300\uC0C1: ${projectName}`,
+    "# \uC0AC\uB0B4 \uC2DC\uC2A4\uD15C \uC5F0\uB3D9 \uB808\uC2DC\uD53C",
     "",
-    "---",
+    "\uC774 \uD504\uB85C\uC81D\uD2B8\uC5D0\uB294 \uB2E4\uC74C \uC0AC\uB0B4 \uC5F0\uB3D9 \uB808\uC2DC\uD53C\uAC00 \uC124\uCE58\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4.",
+    "\uAD00\uB828 \uC694\uCCAD\uC744 \uBC1B\uC73C\uBA74 \uD574\uB2F9 \uACBD\uB85C\uC758 `guideline.md`\uB97C **\uBC18\uB4DC\uC2DC \uBA3C\uC800 \uC77D\uACE0**",
+    "\uC9C0\uCE68\uC5D0 \uB9DE\uAC8C \uAD6C\uD604\uD558\uC138\uC694.",
     "",
-    "## \uC694\uC57D",
+    "## \uD2B8\uB9AC\uAC70",
     "",
-    `${projectName}\uC758 \uBC14\uC774\uBE0C \uCF54\uB529 \uC900\uBE44\uB3C4 \uC885\uD569 \uC810\uC218\uB294 **${result.totalScore}/100 (${result.totalGrade}\uB4F1\uAE09)**\uC785\uB2C8\uB2E4.`,
-    ""
-  ];
-  if (result.penaltyApplied) {
-    lines.push(`> \u26A0 ${result.penaltyReason}`);
-    lines.push("");
-  }
-  if (result.totalGrade === "A") {
-    lines.push("AI \uC9C0\uC6D0 \uCF54\uB529 \uC6CC\uD06C\uD50C\uB85C\uC6B0\uB97C \uD65C\uC6A9\uD560 \uC900\uBE44\uAC00 \uC798 \uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4.");
-  } else if (result.totalGrade === "B") {
-    lines.push("\uB300\uBD80\uBD84 \uC900\uBE44\uB418\uC5B4 \uC788\uC73C\uBA70, \uC77C\uBD80 \uAC1C\uC120\uC73C\uB85C \uCD5C\uC801\uC758 \uBC14\uC774\uBE0C \uCF54\uB529 \uD658\uACBD\uC744 \uAD6C\uCD95\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.");
-  } else if (result.totalGrade === "C") {
-    lines.push("\uAE30\uBCF8\uC801\uC778 \uAD6C\uC870\uB294 \uAC16\uCD94\uACE0 \uC788\uC73C\uB098, \uBC14\uC774\uBE0C \uCF54\uB529\uC758 \uC7A0\uC7AC\uB825\uC744 \uCDA9\uBD84\uD788 \uD65C\uC6A9\uD558\uB824\uBA74 \uAC1C\uC120\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.");
-  } else if (result.totalGrade === "D") {
-    lines.push("AI \uC9C0\uC6D0 \uCF54\uB529 \uC6CC\uD06C\uD50C\uB85C\uC6B0\uB97C \uBCF8\uACA9\uC801\uC73C\uB85C \uD65C\uC6A9\uD558\uAE30\uC5D0\uB294 \uC0C1\uB2F9\uD55C \uAC1C\uC120\uC774 \uD544\uC694\uD55C \uC0C1\uD0DC\uC785\uB2C8\uB2E4.");
-  } else {
-    lines.push("\uBC14\uC774\uBE0C \uCF54\uB529 \uD658\uACBD\uC774 \uAC70\uC758 \uAD6C\uC131\uB418\uC9C0 \uC54A\uC740 \uC0C1\uD0DC\uB85C, \uAE30\uBCF8 \uC124\uC815\uBD80\uD130 \uC2DC\uC791\uD574\uC57C \uD569\uB2C8\uB2E4.");
-  }
-  lines.push("");
-  lines.push("---");
-  lines.push("");
-  lines.push("## \uD56D\uBAA9\uBCC4 \uD604\uD669");
-  lines.push("");
-  lines.push("| \uD56D\uBAA9 | \uBD84\uB958 | \uC810\uC218 | \uB4F1\uAE09 | \uAC00\uC911\uCE58 |");
-  lines.push("|------|------|------|------|--------|");
-  for (const cat of result.categories) {
-    const tier = cat.tier === "must" ? "**\uD544\uC218**" : "\uC120\uD0DD";
-    lines.push(`| ${cat.name} | ${tier} | ${cat.score}/100 | ${cat.grade} | ${cat.tier === "must" ? "20%" : "13.3%"} |`);
-  }
-  lines.push("");
-  lines.push("---");
+    "- " + triggers,
+    "",
+    "## \uC124\uCE58\uB41C \uB808\uC2DC\uD53C",
+    "",
+    ...recipes.map((r) => [
+      `### ${r.label}`,
+      "",
+      `- \uACBD\uB85C: \`${r.target}/\``,
+      `- \uC8FC\uC694 \uBB38\uC11C: \`${r.target}/guideline.md\``,
+      `- \uD658\uACBD\uBCC0\uC218: ${r.envKeys.map((e) => "`" + e.key + "`").join(", ")}`,
+      ""
+    ].join("\n")),
+    "",
+    "## \uC791\uC5C5 \uC21C\uC11C",
+    "",
+    "1. \uC0AC\uC6A9\uC790\uC758 \uC694\uCCAD\uC774 \uC704 \uD2B8\uB9AC\uAC70 \uC911 \uD558\uB098\uC5D0 \uD574\uB2F9\uD558\uB294\uC9C0 \uD310\uB2E8",
+    "2. \uD574\uB2F9 \uB808\uC2DC\uD53C\uC758 `guideline.md`\uB97C Read \uB3C4\uAD6C\uB85C \uC77D\uAE30",
+    "3. \uC0D8\uD50C \uCF54\uB4DC(`*.html`, `*.ts` \uB4F1)\uAC00 \uC788\uC73C\uBA74 \uD568\uAED8 \uD655\uC778",
+    "4. `.env.local`\uC5D0 \uAD00\uB828 \uD658\uACBD\uBCC0\uC218\uAC00 \uCC44\uC6CC\uC838 \uC788\uB294\uC9C0 \uD655\uC778",
+    "5. \uAC00\uC774\uB4DC \uC21C\uC11C\uC5D0 \uB530\uB77C \uAD6C\uD604 \u2014 \uB808\uC2DC\uD53C \uADDC\uCE59\uC744 \uC808\uB300 \uC6B0\uD68C\uD558\uC9C0 \uB9D0 \uAC83",
+    ""
+  ].join("\n");
+  await fs14.writeFile(skillPath, body);
+}
+async function upsertClaudeMdBlock(cwd, installedKeys) {
+  const claudeMdPath = path8.join(cwd, "CLAUDE.md");
+  const BLOCK_START = "<!-- pai:recipes:start -->";
+  const BLOCK_END = "<!-- pai:recipes:end -->";
+  const lines = [];
+  lines.push(BLOCK_START);
+  lines.push("## \uC0AC\uB0B4 \uC2DC\uC2A4\uD15C \uC5F0\uB3D9");
   lines.push("");
-  lines.push("## \uD56D\uBAA9\uBCC4 \uC0C1\uC138 \uBD84\uC11D");
+  lines.push("\uB2E4\uC74C \uB808\uC2DC\uD53C\uAC00 \uC124\uCE58\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4. \uAD00\uB828 \uAE30\uB2A5 \uAD6C\uD604 \uC2DC **\uBC18\uB4DC\uC2DC** \uD574\uB2F9 \uACBD\uB85C\uC758");
+  lines.push("`guideline.md`\uB97C \uBA3C\uC800 \uC77D\uACE0 \uC9C0\uCE68\uC744 \uB530\uB974\uC138\uC694:");
   lines.push("");
-  for (const cat of result.categories) {
-    const tierLabel = cat.tier === "must" ? "\uD544\uC218" : "\uC120\uD0DD";
-    lines.push(`### ${cat.name} (${tierLabel}, \uAC00\uC911\uCE58 ${cat.tier === "must" ? "20%" : "13.3%"}) \u2014 ${cat.grade}\uB4F1\uAE09`);
-    lines.push("");
-    if (cat.rawFindings.length > 0) {
-      lines.push("**\uC810\uAC80 \uACB0\uACFC:**");
-      lines.push("");
-      for (const f of cat.rawFindings) {
-        const icon = f.found ? "\u2705" : "\u274C";
-        lines.push(`- ${icon} ${f.item} \u2014 ${f.details}`);
-      }
-      lines.push("");
-    }
-    if (cat.grade === "A" || cat.grade === "B") {
-      lines.push(`**\uD3C9\uAC00:** \uC591\uD638\uD55C \uC0C1\uD0DC\uC785\uB2C8\uB2E4.`);
-    } else if (cat.grade === "C") {
-      lines.push(`**\uD3C9\uAC00:** \uAE30\uBCF8\uC740 \uAC16\uCD94\uACE0 \uC788\uC73C\uB098 \uCD94\uAC00 \uAC1C\uC120\uC774 \uAD8C\uC7A5\uB429\uB2C8\uB2E4.`);
-    } else if (cat.grade === "D") {
-      lines.push(`**\uD3C9\uAC00:** \uAC1C\uC120\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.`);
-    } else {
-      lines.push(`**\uD3C9\uAC00:** \uC2DC\uAE09\uD55C \uAC1C\uC120\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.`);
-    }
-    lines.push("");
-    if (cat.recommendations.length > 0) {
-      lines.push("**\uAD8C\uACE0\uC0AC\uD56D:**");
-      lines.push("");
-      for (const r of cat.recommendations) {
-        const icon = r.severity === "critical" ? "\u{1F534}" : r.severity === "warning" ? "\u{1F7E1}" : "\u2139\uFE0F";
-        lines.push(`- ${icon} ${r.message}`);
-        lines.push(`  - \u2192 ${r.action}`);
-      }
-      lines.push("");
-    }
-    lines.push("---");
-    lines.push("");
+  for (const key of installedKeys) {
+    const r = RECIPES[key];
+    lines.push(`- **${r.label}** \u2014 \`${r.target}/\``);
+    lines.push(`  \uD658\uACBD\uBCC0\uC218: ${r.envKeys.map((e) => "`" + e.key + "`").join(", ")}`);
   }
-  lines.push("## \uAC1C\uC120 \uB85C\uB4DC\uB9F5");
   lines.push("");
-  const critical = result.categories.filter((c2) => c2.grade === "F");
-  const warning = result.categories.filter((c2) => c2.grade === "D");
-  const ok = result.categories.filter((c2) => c2.grade === "C" || c2.grade === "B" || c2.grade === "A");
-  if (critical.length > 0) {
-    lines.push("### \uC989\uC2DC \uAC1C\uC120 \uD544\uC694 (F\uB4F1\uAE09)");
-    lines.push("");
-    lines.push("| \uD56D\uBAA9 | \uD604\uC7AC \uC810\uC218 | \uBAA9\uD45C | \uC870\uCE58 |");
-    lines.push("|------|----------|------|------|");
-    for (const c2 of critical) {
-      const action = c2.recommendations[0]?.action ?? "\uC124\uC815 \uCD94\uAC00 \uD544\uC694";
-      lines.push(`| ${c2.name} | ${c2.score}\uC810 (F) | 50\uC810+ (D) | ${action} |`);
-    }
-    lines.push("");
-  }
-  if (warning.length > 0) {
-    lines.push("### \uB2E8\uAE30 \uAC1C\uC120 \uAD8C\uC7A5 (D\uB4F1\uAE09)");
-    lines.push("");
-    lines.push("| \uD56D\uBAA9 | \uD604\uC7AC \uC810\uC218 | \uBAA9\uD45C | \uC870\uCE58 |");
-    lines.push("|------|----------|------|------|");
-    for (const c2 of warning) {
-      const action = c2.recommendations[0]?.action ?? "\uCD94\uAC00 \uC124\uC815 \uAD8C\uC7A5";
-      lines.push(`| ${c2.name} | ${c2.score}\uC810 (D) | 70\uC810+ (C) | ${action} |`);
-    }
-    lines.push("");
-  }
-  if (ok.length > 0) {
-    lines.push("### \uC591\uD638 (C\uB4F1\uAE09 \uC774\uC0C1)");
-    lines.push("");
-    for (const c2 of ok) {
-      lines.push(`- \u2705 ${c2.name}: ${c2.score}\uC810 (${c2.grade})`);
-    }
-    lines.push("");
+  lines.push("\uD658\uACBD\uBCC0\uC218 \uAC12\uC740 `.env.local`\uC5D0 \uCC44\uC6CC\uC838 \uC788\uC5B4\uC57C \uD569\uB2C8\uB2E4.");
+  lines.push(BLOCK_END);
+  const block = lines.join("\n");
+  let content = "";
+  if (await fs14.pathExists(claudeMdPath)) {
+    content = await fs14.readFile(claudeMdPath, "utf8");
   }
-  lines.push("---");
-  lines.push("");
-  lines.push("## \uACB0\uB860");
-  lines.push("");
-  lines.push(result.summary);
-  lines.push("");
-  if (result.totalGrade === "F" || result.totalGrade === "D") {
-    const immediateActions = critical.length + warning.length;
-    lines.push(`\uC989\uC2DC \uAC1C\uC120 \uAC00\uB2A5\uD55C ${immediateActions}\uAC1C \uD56D\uBAA9\uC744 \uC644\uB8CC\uD558\uBA74 \uC810\uC218\uB97C \uD06C\uAC8C \uB04C\uC5B4\uC62C\uB9B4 \uC218 \uC788\uC2B5\uB2C8\uB2E4.`);
-  } else if (result.totalGrade === "C") {
-    lines.push("\uAE30\uBCF8 \uAD6C\uC870\uAC00 \uC798 \uAC16\uCD94\uC5B4\uC838 \uC788\uC73C\uBA70, \uB2E8\uAE30 \uAC1C\uC120 \uD56D\uBAA9\uC744 \uB9C8\uBB34\uB9AC\uD558\uBA74 B\uB4F1\uAE09 \uB2EC\uC131\uC774 \uAC00\uB2A5\uD569\uB2C8\uB2E4.");
+  const startIdx = content.indexOf(BLOCK_START);
+  const endIdx = content.indexOf(BLOCK_END);
+  if (startIdx >= 0 && endIdx > startIdx) {
+    const before = content.slice(0, startIdx);
+    const after = content.slice(endIdx + BLOCK_END.length);
+    content = before + block + after;
   } else {
-    lines.push("\uBC14\uC774\uBE0C \uCF54\uB529 \uD658\uACBD\uC774 \uC798 \uAD6C\uC131\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4. \uC9C0\uC18D\uC801\uC778 \uD488\uC9C8 \uAD00\uB9AC\uB97C \uAD8C\uC7A5\uD569\uB2C8\uB2E4.");
-  }
-  lines.push("");
-  lines.push("---");
-  lines.push("");
-  lines.push("*PAI Zero (Plugin AI for ProjectZero) + Claude Code\uB85C \uC0DD\uC131\uB428*");
-  return lines.join("\n") + "\n";
-}
-var GRADE_COLORS;
-var init_reporter = __esm({
-  "src/stages/evaluation/reporter.ts"() {
-    "use strict";
-    GRADE_COLORS = {
-      A: chalk5.hex("#6BCB77"),
-      B: chalk5.hex("#7B93DB"),
-      C: chalk5.hex("#E2B340"),
-      D: chalk5.hex("#E06C75"),
-      F: chalk5.hex("#CC4444")
-    };
-  }
-});
-
-// src/utils/shell-cd.ts
-var shell_cd_exports = {};
-__export(shell_cd_exports, {
-  installShellHelper: () => installShellHelper,
-  requestCdAfter: () => requestCdAfter
-});
-import { join as join8 } from "path";
-import { homedir as homedir2 } from "os";
-import fs14 from "fs-extra";
-async function requestCdAfter(targetDir) {
-  await fs14.ensureDir(PAI_DIR);
-  await fs14.writeFile(CD_FILE, targetDir);
-}
-async function installShellHelper() {
-  await fs14.ensureDir(PAI_DIR);
-  if (isWindows) {
-    return installPowerShellHelper();
-  }
-  return installBashHelper();
-}
-async function installBashHelper() {
-  await fs14.writeFile(HELPER_FILE_SH, BASH_HELPER);
-  const rcFile = getShellRcPath();
-  const sourceLine = 'source "$HOME/.pai/shell-helper.sh"';
-  if (await fs14.pathExists(rcFile)) {
-    const content = await fs14.readFile(rcFile, "utf8");
-    if (content.includes("shell-helper.sh")) {
-      return true;
-    }
-    await fs14.appendFile(rcFile, `
-# PAI \u2014 \uC790\uB3D9 \uB514\uB809\uD1A0\uB9AC \uC774\uB3D9
-${sourceLine}
-`);
-    return false;
-  }
-  await fs14.writeFile(rcFile, `${sourceLine}
-`);
-  return false;
-}
-async function installPowerShellHelper() {
-  await fs14.writeFile(HELPER_FILE_PS1, POWERSHELL_HELPER);
-  const rcFile = getShellRcPath();
-  const sourceLine = '. "$env:USERPROFILE\\.pai\\shell-helper.ps1"';
-  await fs14.ensureDir(join8(rcFile, ".."));
-  if (await fs14.pathExists(rcFile)) {
-    const content = await fs14.readFile(rcFile, "utf8");
-    if (content.includes("shell-helper.ps1")) {
-      return true;
-    }
-    await fs14.appendFile(rcFile, `
-# PAI \u2014 \uC790\uB3D9 \uB514\uB809\uD1A0\uB9AC \uC774\uB3D9
-${sourceLine}
-`);
-    return false;
+    if (content.length > 0 && !content.endsWith("\n")) content += "\n";
+    if (content.length > 0) content += "\n";
+    content += block + "\n";
   }
-  await fs14.writeFile(rcFile, `${sourceLine}
-`);
-  return false;
+  await fs14.ensureFile(claudeMdPath);
+  await fs14.writeFile(claudeMdPath, content);
 }
-var PAI_DIR, CD_FILE, HELPER_FILE_SH, HELPER_FILE_PS1, BASH_HELPER, POWERSHELL_HELPER;
-var init_shell_cd = __esm({
-  "src/utils/shell-cd.ts"() {
+var init_fetch_cmd = __esm({
+  "src/cli/commands/fetch.cmd.ts"() {
     "use strict";
-    init_platform();
-    PAI_DIR = join8(homedir2(), ".pai");
-    CD_FILE = join8(PAI_DIR, ".cd-after");
-    HELPER_FILE_SH = join8(PAI_DIR, "shell-helper.sh");
-    HELPER_FILE_PS1 = join8(PAI_DIR, "shell-helper.ps1");
-    BASH_HELPER = `# PAI shell helper \u2014 \uC790\uB3D9 \uB514\uB809\uD1A0\uB9AC \uC774\uB3D9 \uC9C0\uC6D0
-pai() {
-  local cd_target="$HOME/.pai/.cd-after"
-  rm -f "$cd_target"
-  PAI_CD_AFTER="$cd_target" command npx pai-zero "$@"
-  local exit_code=$?
-  if [ -f "$cd_target" ]; then
-    local dir
-    dir="$(cat "$cd_target")"
-    rm -f "$cd_target"
-    if [ -n "$dir" ] && [ -d "$dir" ]; then
-      cd "$dir" || true
-      echo "  \u2192 cd $dir"
-    fi
-  fi
-  return $exit_code
-}
-`;
-    POWERSHELL_HELPER = `# PAI shell helper \u2014 \uC790\uB3D9 \uB514\uB809\uD1A0\uB9AC \uC774\uB3D9 \uC9C0\uC6D0
-function pai {
-  $cdTarget = Join-Path $env:USERPROFILE '.pai\\.cd-after'
-  Remove-Item $cdTarget -ErrorAction SilentlyContinue
-  $env:PAI_CD_AFTER = $cdTarget
-  & npx pai-zero @args
-  $exitCode = $LASTEXITCODE
-  if (Test-Path $cdTarget) {
-    $dir = Get-Content $cdTarget -Raw
-    Remove-Item $cdTarget -ErrorAction SilentlyContinue
-    if ($dir -and (Test-Path $dir)) {
-      Set-Location $dir
-      Write-Host "  -> cd $dir"
-    }
-  }
-  return $exitCode
-}
-`;
+    init_ui();
+    init_logger();
+    init_recipes();
+    init_github_fetch();
+    init_progress();
   }
 });
 
-// src/utils/claude-settings.ts
-var claude_settings_exports = {};
-__export(claude_settings_exports, {
-  ClaudeSettingsError: () => ClaudeSettingsError,
-  buildSkeleton: () => buildSkeleton,
-  enableOmcPlugin: () => enableOmcPlugin,
-  getClaudeSettingsPath: () => getClaudeSettingsPath,
-  isAlreadyEnabled: () => isAlreadyEnabled,
-  mergeOmcIntoSettings: () => mergeOmcIntoSettings
-});
-import os2 from "os";
-import path7 from "path";
-import fs15 from "fs-extra";
-function getClaudeSettingsPath(homeDir = os2.homedir()) {
-  return path7.join(homeDir, ".claude", "settings.json");
-}
-function parseJsonWithBom(raw) {
-  const stripped = raw.charCodeAt(0) === 65279 ? raw.slice(1) : raw;
-  return JSON.parse(stripped);
-}
-function timestampSuffix() {
-  return sanitizeFilenameForWindows((/* @__PURE__ */ new Date()).toISOString());
-}
-async function enableOmcPlugin(options = {}) {
-  const marketplaceId = options.marketplaceId ?? DEFAULT_MARKETPLACE_ID;
-  const marketplaceUrl = options.marketplaceUrl ?? DEFAULT_MARKETPLACE_URL;
-  const pluginId = options.pluginId ?? DEFAULT_PLUGIN_ID;
-  const wantBackup = options.backup ?? true;
-  const settingsPath = getClaudeSettingsPath();
-  await fs15.ensureDir(path7.dirname(settingsPath));
-  if (!await fs15.pathExists(settingsPath)) {
-    const skeleton = buildSkeleton(marketplaceId, marketplaceUrl, pluginId);
-    await fs15.writeFile(settingsPath, JSON.stringify(skeleton, null, 2) + "\n", "utf8");
-    return { action: "created", settingsPath };
-  }
-  const raw = await fs15.readFile(settingsPath, "utf8");
-  let parsed;
-  try {
-    const value = parseJsonWithBom(raw);
-    if (!value || typeof value !== "object" || Array.isArray(value)) {
-      throw new Error("settings.json is not a JSON object");
-    }
-    parsed = value;
-  } catch (err) {
-    const backupPath2 = `${settingsPath}.backup-${timestampSuffix()}`;
-    await fs15.copy(settingsPath, backupPath2);
-    throw new ClaudeSettingsError(
-      `settings.json \uD30C\uC2F1 \uC2E4\uD328: ${err.message}. \uBC31\uC5C5: ${backupPath2}`,
-      backupPath2
-    );
-  }
-  if (isAlreadyEnabled(parsed, marketplaceId, pluginId)) {
-    return { action: "already-enabled", settingsPath };
-  }
-  let backupPath;
-  if (wantBackup) {
-    backupPath = `${settingsPath}.backup-${timestampSuffix()}`;
-    await fs15.copy(settingsPath, backupPath);
-  }
-  const merged = mergeOmcIntoSettings(parsed, marketplaceId, marketplaceUrl, pluginId);
-  await fs15.writeFile(settingsPath, JSON.stringify(merged, null, 2) + "\n", "utf8");
-  return { action: "added", settingsPath, backupPath };
-}
-function buildSkeleton(marketplaceId, marketplaceUrl, pluginId) {
-  return {
-    extraKnownMarketplaces: {
-      [marketplaceId]: {
-        source: { source: "git", url: marketplaceUrl }
-      }
-    },
-    enabledPlugins: {
-      [pluginId]: true
-    }
-  };
-}
-function isAlreadyEnabled(settings, marketplaceId, pluginId) {
-  const markets = settings["extraKnownMarketplaces"];
-  const enabled = settings["enabledPlugins"];
-  const hasMarket = typeof markets === "object" && markets !== null && marketplaceId in markets;
-  const hasPlugin = typeof enabled === "object" && enabled !== null && enabled[pluginId] === true;
-  return hasMarket && hasPlugin;
-}
-function mergeOmcIntoSettings(settings, marketplaceId, marketplaceUrl, pluginId) {
-  const next = { ...settings };
-  const existingMarkets = typeof next["extraKnownMarketplaces"] === "object" && next["extraKnownMarketplaces"] !== null ? { ...next["extraKnownMarketplaces"] } : {};
-  existingMarkets[marketplaceId] = {
-    source: { source: "git", url: marketplaceUrl }
-  };
-  next["extraKnownMarketplaces"] = existingMarkets;
-  const existingPlugins = typeof next["enabledPlugins"] === "object" && next["enabledPlugins"] !== null ? { ...next["enabledPlugins"] } : {};
-  existingPlugins[pluginId] = true;
-  next["enabledPlugins"] = existingPlugins;
-  return next;
-}
-var DEFAULT_MARKETPLACE_ID, DEFAULT_MARKETPLACE_URL, DEFAULT_PLUGIN_ID, ClaudeSettingsError;
-var init_claude_settings = __esm({
-  "src/utils/claude-settings.ts"() {
+// src/stages/environment/index.ts
+var environmentStage;
+var init_environment = __esm({
+  "src/stages/environment/index.ts"() {
     "use strict";
-    init_platform();
-    DEFAULT_MARKETPLACE_ID = "omc";
-    DEFAULT_MARKETPLACE_URL = "https://github.com/SoInKyu/oh-my-claudecode.git";
-    DEFAULT_PLUGIN_ID = "oh-my-claudecode@omc";
-    ClaudeSettingsError = class extends Error {
-      constructor(message, backupPath) {
-        super(message);
-        this.backupPath = backupPath;
-        this.name = "ClaudeSettingsError";
+    init_analyzer();
+    init_interviewer();
+    init_generator();
+    init_installer();
+    init_registry();
+    init_claude_commands();
+    init_detector();
+    init_config();
+    init_progress();
+    init_ui();
+    init_analyzer();
+    init_interviewer();
+    init_doctor();
+    environmentStage = {
+      name: "environment",
+      canSkip(input) {
+        return input.config.plugins.length > 0;
+      },
+      async run(input) {
+        const start = Date.now();
+        const artifacts = [];
+        const errors = [];
+        try {
+          console.log("");
+          const analysis = await withSpinner("\uD504\uB85C\uC81D\uD2B8 \uBD84\uC11D \uC911...", async () => {
+            const result = await analyzeProject(input.cwd);
+            await sleep(500);
+            return result;
+          });
+          console.log("");
+          if (analysis.stack.languages.length > 0) {
+            success(`\uC2A4\uD0DD: ${analysis.stack.languages.join(", ")}`);
+          }
+          if (analysis.stack.frameworks.length > 0) {
+            success(`\uD504\uB808\uC784\uC6CC\uD06C: ${analysis.stack.frameworks.join(", ")}`);
+          }
+          success(`Git: ${analysis.git.isGitRepo ? `${analysis.git.repoName ?? "local"}` : "\uBBF8\uCD08\uAE30\uD654"}`);
+          const interview = await runInterview(analysis, input.cwd, input.config.projectName);
+          console.log("");
+          const configFiles = [
+            "CLAUDE.md",
+            ".claude/settings.json",
+            "docs/vibe-coding/01-intent.md",
+            "docs/vibe-coding/02-requirements.md",
+            "docs/vibe-coding/03-research.md",
+            "docs/vibe-coding/04-plan.md",
+            "docs/vibe-coding/05-implement.md"
+          ];
+          const generated = await withFileSpinner("\uC124\uC815 \uD30C\uC77C \uC0DD\uC131 \uC911...", configFiles, async () => {
+            const files = await generateFiles(input.cwd, analysis, interview);
+            await sleep(400);
+            return files;
+          });
+          artifacts.push(...generated);
+          const basePlugins = ["github", "openspec", "roboco"];
+          const pluginKeys = [.../* @__PURE__ */ new Set([...basePlugins, ...interview.extraTools])];
+          const provCtx = {
+            cwd: input.cwd,
+            projectName: interview.projectName,
+            mode: interview.mode,
+            envEntries: {
+              PAI_PROJECT_NAME: interview.projectName,
+              PAI_MODE: interview.mode
+            },
+            analysis,
+            mcp: interview.mcp
+          };
+          if (interview.authMethods.includes("custom")) {
+            provCtx.envEntries["OAUTH_CLIENT_ID"] = interview.customAuth?.clientId || "YOUR_CLIENT_ID_HERE";
+            provCtx.envEntries["OAUTH_CLIENT_SECRET"] = interview.customAuth?.clientSecret || "YOUR_CLIENT_SECRET_HERE";
+            provCtx.envEntries["OAUTH_REDIRECT_URI"] = "http://localhost:3000/auth/callback";
+          }
+          const pluginFileNames = [
+            ".gitignore",
+            "src/",
+            "docs/",
+            "tests/",
+            "public/",
+            "docs/openspec.md",
+            ".pai/roboco.json",
+            ...interview.extraTools.includes("omc") ? [".pai/omc.md", ".omc/"] : [],
+            ...interview.extraTools.includes("vercel") ? ["vercel.json"] : [],
+            ...interview.extraTools.includes("supabase") ? ["supabase/config.toml"] : [],
+            ...interview.extraTools.includes("gstack") ? [".pai/gstack.json"] : [],
+            ...interview.extraTools.includes("harness") ? [".pai/harness.json"] : [],
+            ...interview.extraTools.includes("mcp") ? ["mcp-server/", ".mcp.json"] : [],
+            ".env.local"
+          ];
+          console.log("");
+          await withFileSpinner("\uD504\uB85C\uC81D\uD2B8 \uAD6C\uC870 \uC124\uCE58 \uC911...", pluginFileNames, async () => {
+            await runProvisioners(pluginKeys, provCtx);
+            await sleep(500);
+          });
+          const cmdFiles = [
+            "SKILL.md",
+            "info.md",
+            "init.md",
+            "status.md",
+            "doctor.md",
+            "design.md",
+            "validate.md",
+            "evaluate.md",
+            "install.md"
+          ];
+          console.log("");
+          await withFileSpinner("\uC2AC\uB798\uC2DC \uCEE4\uB9E8\uB4DC \uC124\uCE58 \uC911...", cmdFiles, async () => {
+            await provisionClaudeCommands(input.cwd);
+            await sleep(400);
+          });
+          console.log("");
+          const installResults = await installTools(interview.tools, input.cwd);
+          printInstallReport(installResults, interview.tools);
+          if (interview.recipes && interview.recipes.length > 0) {
+            console.log("");
+            const { fetchCommand: fetchCommand2 } = await Promise.resolve().then(() => (init_fetch_cmd(), fetch_cmd_exports));
+            for (const recipeKey of interview.recipes) {
+              try {
+                await fetchCommand2(input.cwd, recipeKey, {});
+              } catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                warn(`\uB808\uC2DC\uD53C '${recipeKey}' \uB2E4\uC6B4\uB85C\uB4DC \uC2E4\uD328 \u2014 ${msg}`);
+                hint(`\uB098\uC911\uC5D0 \uC218\uB3D9: pai fetch ${recipeKey}`);
+              }
+            }
+          }
+          console.log("");
+          await withSpinner("\uC124\uC815 \uC800\uC7A5 \uC911...", async () => {
+            const config = createDefaultConfig(interview.projectName, interview.mode);
+            config.plugins = pluginKeys;
+            config.edges = deriveEdges(pluginKeys);
+            if (interview.mcp) config.mcp = interview.mcp;
+            await saveConfig(input.cwd, config);
+            await sleep(300);
+          });
+          return {
+            stage: "environment",
+            status: "success",
+            data: { analysis, interview, installResults },
+            artifacts,
+            duration: Date.now() - start,
+            errors
+          };
+        } catch (err) {
+          const msg = err instanceof Error ? err.message : String(err);
+          errors.push({ code: "ENV_SETUP_FAILED", message: msg, recoverable: true });
+          return {
+            stage: "environment",
+            status: "failed",
+            data: {},
+            artifacts,
+            duration: Date.now() - start,
+            errors
+          };
+        }
       }
-      backupPath;
     };
   }
 });
 
-// src/stages/evaluation/cache.ts
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
-import { join as join9 } from "path";
-import { createHash } from "crypto";
-function computeRepoHash(repoPath) {
-  const hash = createHash("sha256");
-  for (const file of FILES_TO_HASH) {
-    const fullPath = join9(repoPath, file);
+// src/stages/validation/runner.ts
+import { join as join7 } from "path";
+import fs15 from "fs-extra";
+async function runTests(cwd) {
+  const start = Date.now();
+  const gstackPath = join7(cwd, ".pai", "gstack.json");
+  let runner = "npm test";
+  if (await fs15.pathExists(gstackPath)) {
     try {
-      const content = readFileSync(fullPath);
-      hash.update(`${file}:${content.length}`);
+      const config = await fs15.readJson(gstackPath);
+      if (config.testRunner === "vitest") runner = "npx vitest run";
+      else if (config.testRunner === "jest") runner = "npx jest";
+      else if (config.testRunner === "mocha") runner = "npx mocha";
     } catch {
-      hash.update(`${file}:missing`);
     }
   }
-  return hash.digest("hex").slice(0, 16);
-}
-function getCachePath(repoPath) {
-  return join9(repoPath, CACHE_DIR, CACHE_FILE);
+  const pkgPath = join7(cwd, "package.json");
+  if (await fs15.pathExists(pkgPath)) {
+    try {
+      const pkg5 = await fs15.readJson(pkgPath);
+      if (!pkg5.scripts?.test || pkg5.scripts.test.includes("no test specified")) {
+        return {
+          runner,
+          passed: false,
+          output: "\uD14C\uC2A4\uD2B8 \uC2A4\uD06C\uB9BD\uD2B8\uAC00 \uC815\uC758\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. package.json\uC758 scripts.test\uB97C \uC124\uC815\uD558\uC138\uC694.",
+          duration: Date.now() - start
+        };
+      }
+    } catch {
+    }
+  }
+  try {
+    const { execa } = await import("execa");
+    const { stdout, stderr } = await execa("npm", ["test"], {
+      cwd,
+      timeout: 12e4,
+      env: { ...process.env, CI: "true" }
+    });
+    return {
+      runner,
+      passed: true,
+      output: stdout || stderr,
+      duration: Date.now() - start
+    };
+  } catch (err) {
+    const output = err instanceof Error ? err.message : String(err);
+    return {
+      runner,
+      passed: false,
+      output,
+      duration: Date.now() - start
+    };
+  }
 }
-function loadCache(repoPath) {
+var init_runner = __esm({
+  "src/stages/validation/runner.ts"() {
+    "use strict";
+  }
+});
+
+// src/stages/validation/harness.ts
+import { join as join8 } from "path";
+import fs16 from "fs-extra";
+async function runHarnessCheck(cwd) {
+  const harnessPath = join8(cwd, ".pai", "harness.json");
+  if (!await fs16.pathExists(harnessPath)) {
+    return { enabled: false, specFile: null, rules: [], checks: [] };
+  }
+  let config;
   try {
-    const data = readFileSync(getCachePath(repoPath), "utf-8");
-    return JSON.parse(data);
+    config = await fs16.readJson(harnessPath);
   } catch {
-    return { version: 1, entries: {} };
+    return { enabled: false, specFile: null, rules: [], checks: [] };
   }
-}
-function saveCache(repoPath, store) {
-  const cacheDir = join9(repoPath, CACHE_DIR, "cache");
-  if (!existsSync(cacheDir)) {
-    mkdirSync(cacheDir, { recursive: true });
+  const specFile = config.specFile ?? "docs/openspec.md";
+  const rules = config.rules ?? [];
+  const checks = [];
+  if (rules.includes("spec-implementation-match")) {
+    const specExists = await fs16.pathExists(join8(cwd, specFile));
+    const srcExists = await fs16.pathExists(join8(cwd, "src"));
+    checks.push({
+      rule: "spec-implementation-match",
+      passed: specExists && srcExists,
+      detail: specExists && srcExists ? "\uC124\uACC4 \uBB38\uC11C\uC640 \uC18C\uC2A4 \uB514\uB809\uD1A0\uB9AC \uC874\uC7AC" : `${!specExists ? specFile + " \uC5C6\uC74C" : ""} ${!srcExists ? "src/ \uC5C6\uC74C" : ""}`.trim()
+    });
   }
-  writeFileSync(getCachePath(repoPath), JSON.stringify(store, null, 2));
+  if (rules.includes("api-contract-test")) {
+    const testDir = await fs16.pathExists(join8(cwd, "tests"));
+    const testDir2 = await fs16.pathExists(join8(cwd, "test"));
+    checks.push({
+      rule: "api-contract-test",
+      passed: testDir || testDir2,
+      detail: testDir || testDir2 ? "\uD14C\uC2A4\uD2B8 \uB514\uB809\uD1A0\uB9AC \uC874\uC7AC" : "\uD14C\uC2A4\uD2B8 \uB514\uB809\uD1A0\uB9AC(tests/ \uB610\uB294 test/) \uC5C6\uC74C"
+    });
+  }
+  return { enabled: true, specFile, rules, checks };
 }
-function getCachedResult(repoPath) {
-  const store = loadCache(repoPath);
-  const repoHash = computeRepoHash(repoPath);
-  const entry = store.entries[repoHash];
-  if (!entry) return null;
-  if (Date.now() - entry.timestamp > CACHE_TTL_MS) return null;
-  return entry.llmOutput;
+var init_harness = __esm({
+  "src/stages/validation/harness.ts"() {
+    "use strict";
+  }
+});
+
+// src/cli/commands/validate.cmd.ts
+var validate_cmd_exports = {};
+__export(validate_cmd_exports, {
+  handleRobocoCliError: () => handleRobocoError,
+  validateCommand: () => validateCommand
+});
+async function validateCommand(cwd, options = {}) {
+  try {
+    await withRoboco(
+      cwd,
+      "validation",
+      "pai test",
+      { skipGates: options.skipGates, force: options.force, gate: STAGE_GATES.validation },
+      async () => {
+        section("\uD14C\uC2A4\uD2B8 \uC2E4\uD589");
+        const testResult = await runTests(cwd);
+        if (testResult.passed) {
+          success(`\uD14C\uC2A4\uD2B8 \uD1B5\uACFC (${testResult.runner}, ${testResult.duration}ms)`);
+        } else {
+          error("\uD14C\uC2A4\uD2B8 \uC2E4\uD328");
+          info(testResult.output.slice(0, 300));
+        }
+        section("\uD558\uB124\uC2A4 \uAC80\uC99D");
+        const harness = await runHarnessCheck(cwd);
+        if (!harness.enabled) {
+          info("Harness \uC124\uC815 \uC5C6\uC74C \u2014 \uAC74\uB108\uB700");
+          info("\uC124\uC815 \uCD94\uAC00: `pai add` \uC5D0\uC11C Harness Engineering \uC120\uD0DD");
+        } else {
+          for (const check of harness.checks) {
+            if (check.passed) {
+              success(`${check.rule}: ${check.detail}`);
+            } else {
+              warn(`${check.rule}: ${check.detail}`);
+            }
+          }
+        }
+        const allPassed = testResult.passed && harness.checks.every((c2) => c2.passed);
+        console.log("");
+        if (allPassed) {
+          success("\uAC80\uC99D \uD1B5\uACFC!");
+        } else if (!testResult.passed) {
+          error("\uAC80\uC99D \uC2E4\uD328 \u2014 \uD14C\uC2A4\uD2B8\uB97C \uC218\uC815\uD558\uC138\uC694.");
+          throw new Error("tests-failed");
+        } else {
+          warn("\uBD80\uBD84 \uD1B5\uACFC \u2014 \uD558\uB124\uC2A4 \uAC80\uC99D \uD56D\uBAA9\uC744 \uD655\uC778\uD558\uC138\uC694.");
+        }
+      }
+    );
+    await syncHandoff(cwd).catch(() => {
+    });
+  } catch (err) {
+    handleRobocoError(err);
+  }
 }
-function setCachedResult(repoPath, llmOutput) {
-  const store = loadCache(repoPath);
-  const repoHash = computeRepoHash(repoPath);
-  const now2 = Date.now();
-  for (const [key, entry] of Object.entries(store.entries)) {
-    if (now2 - entry.timestamp > CACHE_TTL_MS) {
-      delete store.entries[key];
+function handleRobocoError(err) {
+  if (err instanceof RobocoLockError) {
+    error(err.message);
+    process.exitCode = 1;
+    return;
+  }
+  if (err instanceof GateFailedError) {
+    error(`\uB2E8\uACC4 \uC9C4\uC785 \uC2E4\uD328 (${err.result.name})`);
+    for (const v of err.result.violations) {
+      warn(`  \xB7 ${v.message}${v.location ? ` [${v.location}]` : ""}`);
+    }
+    hint("\uC6B0\uD68C \uC635\uC158: --skip-gates (\uACBD\uACE0\uB9CC) / --force (\uAC8C\uC774\uD2B8 \uBB34\uC2DC)");
+    process.exitCode = 1;
+    return;
+  }
+  if (err instanceof Error) {
+    if (err.message === "tests-failed") {
+      process.exitCode = 1;
+      return;
     }
+    error(err.message);
+    process.exitCode = 1;
+    return;
   }
-  store.entries[repoHash] = { repoPath, repoHash, timestamp: now2, llmOutput };
-  saveCache(repoPath, store);
+  throw err;
+}
+var init_validate_cmd = __esm({
+  "src/cli/commands/validate.cmd.ts"() {
+    "use strict";
+    init_ui();
+    init_runner();
+    init_harness();
+    init_roboco();
+    init_gates();
+  }
+});
+
+// src/stages/evaluation/prompts/analyze.ts
+var analyze_exports = {};
+__export(analyze_exports, {
+  buildAnalysisPrompt: () => buildAnalysisPrompt
+});
+function buildAnalysisPrompt(repoPath) {
+  return `Analyze the repository at "${repoPath}" for vibe coding readiness.
+
+Use only Read, Glob, and Grep tools. Complete in ~20 tool calls.
+Focus on config files, not source code.
+
+Evaluate these 6 categories:
+
+### Must-Have (60% weight)
+1. **\uD14C\uC2A4\uD2B8 \uCEE4\uBC84\uB9AC\uC9C0**: test framework config, test dirs, coverage thresholds
+   - 0=none, 20=config only, 40=minimal files, 60=moderate, 80=good, 100=comprehensive
+2. **CI/CD**: pipeline configs, quality gates, multi-stage
+   - 0=none, 20=exists but minimal, 40=basic, 60=tests+lint, 80=tests+lint+build, 100=comprehensive
+3. **\uD6C5 \uAE30\uBC18 \uAC80\uC99D**: git hooks, lint-staged, AI agent hooks (.claude/settings.json)
+   - 0=none, 20=framework only, 40=single hook, 60=lint+format, 80=lint+test+format, 100=comprehensive+AI
+
+### Nice-to-Have (40% weight)
+4. **\uB9AC\uD3EC\uC9C0\uD1A0\uB9AC \uAD6C\uC870**: dir organization, deps management, env config
+   - 0=flat/chaotic, 20=minimal, 40=basic, 60=reasonable, 80=well-organized, 100=exemplary
+5. **\uBB38\uC11C\uD654 \uC218\uC900**: README, CONTRIBUTING, API docs, architecture docs
+   - 0=none, 20=minimal, 40=basic, 60=good README, 80=README+API, 100=comprehensive
+6. **\uD558\uB124\uC2A4 \uC5D4\uC9C0\uB2C8\uC5B4\uB9C1**: CLAUDE.md, AGENTS.md, .claude/ config, skills, commands
+   - 0=none, 20=basic, 40=one AI config, 60=context+config, 80=context+safety+skills, 100=comprehensive
+
+Output ONLY a JSON block:
+\`\`\`json
+{
+  "categories": [
+    {
+      "name": "\uCE74\uD14C\uACE0\uB9AC\uBA85 (Korean)",
+      "tier": "must" | "nice",
+      "score": 0-100,
+      "recommendations": [{ "severity": "critical"|"warning"|"info", "message": "...", "action": "..." }],
+      "rawFindings": [{ "item": "filename or concept", "found": true|false, "details": "..." }]
+    }
+  ],
+  "summary": "2-3 sentence Korean summary"
 }
-var CACHE_DIR, CACHE_FILE, CACHE_TTL_MS, FILES_TO_HASH;
-var init_cache = __esm({
-  "src/stages/evaluation/cache.ts"() {
+\`\`\``;
+}
+var init_analyze = __esm({
+  "src/stages/evaluation/prompts/analyze.ts"() {
     "use strict";
-    CACHE_DIR = ".pai";
-    CACHE_FILE = "cache/evaluation.json";
-    CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
-    FILES_TO_HASH = [
-      "package.json",
-      "pyproject.toml",
-      "go.mod",
-      "Cargo.toml",
-      "tsconfig.json",
-      "jest.config.ts",
-      "vitest.config.ts",
-      ".github/workflows",
-      ".gitlab-ci.yml",
-      ".husky",
-      ".lintstagedrc",
-      "CLAUDE.md",
-      "AGENTS.md",
-      ".cursorrules",
-      "README.md",
-      "CONTRIBUTING.md"
-    ];
   }
 });
 
-// src/core/roboco.ts
-import os3 from "os";
-import path8 from "path";
-import fs16 from "fs-extra";
-function robocoPath(cwd) {
-  return path8.join(cwd, ROBOCO_PATH);
-}
-async function loadRobocoState(cwd) {
-  const p = robocoPath(cwd);
-  if (!await fs16.pathExists(p)) return freshState();
+// src/stages/evaluation/analyzer.ts
+var analyzer_exports2 = {};
+__export(analyzer_exports2, {
+  analyzeRepository: () => analyzeRepository
+});
+import { join as join9 } from "path";
+import fs17 from "fs-extra";
+async function analyzeRepository(repoPath) {
   try {
-    const raw = await fs16.readJson(p);
-    if (raw?.version !== "2.0") return freshState();
-    return raw;
+    return await aiAnalysis(repoPath);
   } catch {
-    return freshState();
+    return staticAnalysis(repoPath);
   }
 }
-async function saveRobocoState(cwd, state) {
-  const p = robocoPath(cwd);
-  await fs16.ensureDir(path8.dirname(p));
-  await fs16.writeJson(p, state, { spaces: 2 });
+async function aiAnalysis(repoPath) {
+  const { query } = await import("@anthropic-ai/claude-agent-sdk");
+  const { buildAnalysisPrompt: buildAnalysisPrompt2 } = await Promise.resolve().then(() => (init_analyze(), analyze_exports));
+  const prompt = buildAnalysisPrompt2(repoPath);
+  let resultText = "";
+  for await (const message of query({
+    prompt,
+    options: {
+      maxTurns: 200,
+      systemPrompt: "You are a vibe coding readiness analyzer. Analyze the repository and output JSON.",
+      allowedTools: ["Read", "Glob", "Grep"],
+      permissionMode: "plan"
+    }
+  })) {
+    if ("result" in message) {
+      resultText = message.result;
+    }
+  }
+  return parseJsonFromText(resultText);
 }
-function freshState() {
+function parseJsonFromText(text) {
+  const jsonMatch = text.match(/```json\s*([\s\S]*?)```/);
+  if (jsonMatch?.[1]) {
+    return JSON.parse(jsonMatch[1]);
+  }
+  return JSON.parse(text);
+}
+async function staticAnalysis(repoPath) {
+  const categories = [];
+  categories.push(await checkTestCoverage(repoPath));
+  categories.push(await checkCiCd(repoPath));
+  categories.push(await checkHooks(repoPath));
+  categories.push(await checkRepoStructure(repoPath));
+  categories.push(await checkDocumentation(repoPath));
+  categories.push(await checkHarnessEngineering(repoPath));
   return {
-    version: "2.0",
-    currentStage: "environment",
-    stageHistory: [],
-    lock: null,
-    gates: {}
+    categories,
+    summary: `\uC815\uC801 \uBD84\uC11D \uC644\uB8CC. ${categories.filter((c2) => c2.score >= 60).length}/6 \uCE74\uD14C\uACE0\uB9AC \uD1B5\uACFC.`
   };
 }
-function isProcessAlive(pid) {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch {
-    return false;
+async function checkTestCoverage(repoPath) {
+  const findings = [];
+  let score = 0;
+  const testConfigs = [
+    "jest.config.ts",
+    "jest.config.js",
+    "vitest.config.ts",
+    "vitest.config.js",
+    "pytest.ini",
+    "phpunit.xml",
+    ".nycrc"
+  ];
+  for (const f of testConfigs) {
+    const found = await fs17.pathExists(join9(repoPath, f));
+    findings.push({ item: f, found, details: found ? "\uC874\uC7AC" : "\uC5C6\uC74C" });
+    if (found) score += 20;
   }
-}
-function isLockStale(lock, now2 = /* @__PURE__ */ new Date()) {
-  if (!isProcessAlive(lock.pid)) return true;
-  if (new Date(lock.expiresAt).getTime() < now2.getTime()) return true;
-  return false;
-}
-async function acquireLock(cwd, stage, command, ttlMs = DEFAULT_TTL_MS) {
-  const state = await loadRobocoState(cwd);
-  if (state.lock) {
-    if (!isLockStale(state.lock)) {
-      throw new RobocoLockError(formatLockError(state.lock), state.lock);
+  const testDirs = ["tests", "test", "__tests__", "spec"];
+  let hasTestDir = false;
+  for (const d of testDirs) {
+    if (await fs17.pathExists(join9(repoPath, d))) {
+      findings.push({ item: d, found: true, details: "\uD14C\uC2A4\uD2B8 \uB514\uB809\uD1A0\uB9AC \uC874\uC7AC" });
+      hasTestDir = true;
+      score += 30;
+      break;
     }
   }
-  const now2 = /* @__PURE__ */ new Date();
-  const newLock = {
-    pid: process.pid,
-    stage,
-    command,
-    acquiredAt: now2.toISOString(),
-    expiresAt: new Date(now2.getTime() + ttlMs).toISOString(),
-    host: os3.hostname()
-  };
-  state.lock = newLock;
-  await saveRobocoState(cwd, state);
-  return state;
-}
-async function releaseLock(cwd) {
-  const state = await loadRobocoState(cwd);
-  if (state.lock && state.lock.pid === process.pid) {
-    state.lock = null;
-    await saveRobocoState(cwd, state);
+  if (!hasTestDir) {
+    findings.push({ item: "test directory", found: false, details: "\uD14C\uC2A4\uD2B8 \uB514\uB809\uD1A0\uB9AC \uC5C6\uC74C" });
   }
+  score = Math.min(100, score);
+  const recommendations = score < 60 ? [{ severity: "critical", message: "\uD14C\uC2A4\uD2B8 \uD658\uACBD \uBBF8\uAD6C\uC131", action: "\uD14C\uC2A4\uD2B8 \uD504\uB808\uC784\uC6CC\uD06C\uC640 \uD14C\uC2A4\uD2B8 \uB514\uB809\uD1A0\uB9AC\uB97C \uCD94\uAC00\uD558\uC138\uC694" }] : [];
+  return { name: "\uD14C\uC2A4\uD2B8 \uCEE4\uBC84\uB9AC\uC9C0", tier: "must", score, recommendations, rawFindings: findings };
 }
-function formatLockError(lock) {
-  const started = new Date(lock.acquiredAt);
-  const mins = Math.round((Date.now() - started.getTime()) / 6e4);
-  return [
-    "\uB2E4\uB978 PAI \uBA85\uB839\uC774 \uC9C4\uD589 \uC911\uC785\uB2C8\uB2E4",
-    `  stage:    ${lock.stage}`,
-    `  command:  ${lock.command}`,
-    `  \uC2DC\uC791:     ${mins}\uBD84 \uC804 (PID ${lock.pid}${lock.host ? ", host " + lock.host : ""})`,
-    "  \uB300\uAE30\uD558\uC9C0 \uC54A\uACE0 \uC989\uC2DC \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4. \uC644\uB8CC \uD6C4 \uC7AC\uC2DC\uB3C4\uD558\uC138\uC694."
-  ].join("\n");
-}
-async function markStageStart(cwd, stage, command) {
-  const state = await loadRobocoState(cwd);
-  state.currentStage = stage;
-  state.stageHistory.push({
-    stage,
-    status: "in_progress",
-    startedAt: (/* @__PURE__ */ new Date()).toISOString(),
-    by: command
-  });
-  await saveRobocoState(cwd, state);
-}
-async function markStageEnd(cwd, stage, success2, reason) {
-  const state = await loadRobocoState(cwd);
-  for (let i = state.stageHistory.length - 1; i >= 0; i--) {
-    const entry = state.stageHistory[i];
-    if (entry.stage === stage && entry.status === "in_progress") {
-      entry.status = success2 ? "done" : "failed";
-      entry.endedAt = (/* @__PURE__ */ new Date()).toISOString();
-      if (reason) entry.reason = reason;
-      break;
-    }
+async function checkCiCd(repoPath) {
+  const findings = [];
+  let score = 0;
+  const ciConfigs = [
+    { path: ".github/workflows", label: "GitHub Actions" },
+    { path: ".gitlab-ci.yml", label: "GitLab CI" },
+    { path: "Jenkinsfile", label: "Jenkins" },
+    { path: ".circleci", label: "CircleCI" }
+  ];
+  for (const { path: path10, label } of ciConfigs) {
+    const found = await fs17.pathExists(join9(repoPath, path10));
+    findings.push({ item: label, found, details: found ? "\uC874\uC7AC" : "\uC5C6\uC74C" });
+    if (found) score += 40;
   }
-  await saveRobocoState(cwd, state);
+  score = Math.min(100, score);
+  const recommendations = score === 0 ? [{ severity: "critical", message: "CI/CD \uBBF8\uAD6C\uC131", action: "GitHub Actions \uB610\uB294 \uB2E4\uB978 CI \uD30C\uC774\uD504\uB77C\uC778\uC744 \uC124\uC815\uD558\uC138\uC694" }] : [];
+  return { name: "CI/CD", tier: "must", score, recommendations, rawFindings: findings };
 }
-async function saveGateResult(cwd, key, result) {
-  const state = await loadRobocoState(cwd);
-  state.gates[key] = result;
-  await saveRobocoState(cwd, state);
+async function checkHooks(repoPath) {
+  const findings = [];
+  let score = 0;
+  const hookConfigs = [
+    { path: ".husky", label: "Husky" },
+    { path: ".lintstagedrc", label: "lint-staged" },
+    { path: ".lintstagedrc.json", label: "lint-staged (json)" },
+    { path: "commitlint.config.js", label: "commitlint" },
+    { path: ".claude/settings.json", label: "Claude Code settings" }
+  ];
+  for (const { path: path10, label } of hookConfigs) {
+    const found = await fs17.pathExists(join9(repoPath, path10));
+    findings.push({ item: label, found, details: found ? "\uC874\uC7AC" : "\uC5C6\uC74C" });
+    if (found) score += 20;
+  }
+  score = Math.min(100, score);
+  const recommendations = score < 40 ? [{ severity: "warning", message: "\uD6C5 \uAE30\uBC18 \uAC80\uC99D \uBD80\uC871", action: "Husky + lint-staged\uB97C \uC124\uC815\uD558\uC5EC \uCEE4\uBC0B \uC804 \uAC80\uC99D\uC744 \uCD94\uAC00\uD558\uC138\uC694" }] : [];
+  return { name: "\uD6C5 \uAE30\uBC18 \uAC80\uC99D", tier: "must", score, recommendations, rawFindings: findings };
 }
-async function withRoboco(cwd, stage, command, options, fn) {
-  await acquireLock(cwd, stage, command, options.ttlMs);
-  try {
-    if (options.gate && !options.force) {
-      const result = await options.gate(cwd);
-      await saveGateResult(cwd, `${stage}.entry`, result);
-      if (!result.passed && !options.skipGates) {
-        await markStageEnd(cwd, stage, false, `\uAC8C\uC774\uD2B8 \uC2E4\uD328: ${result.name}`);
-        throw new GateFailedError(result);
-      }
-      if (!result.passed && options.skipGates) {
-      }
-    }
-    await markStageStart(cwd, stage, command);
-    const value = await fn();
-    await markStageEnd(cwd, stage, true);
-    return value;
-  } catch (err) {
-    if (!(err instanceof GateFailedError)) {
-      const msg = err instanceof Error ? err.message : String(err);
-      await markStageEnd(cwd, stage, false, msg).catch(() => {
-      });
-    }
-    throw err;
-  } finally {
-    await releaseLock(cwd).catch(() => {
-    });
+async function checkRepoStructure(repoPath) {
+  const findings = [];
+  let score = 0;
+  const structureChecks = [
+    { path: "src", label: "src/ \uB514\uB809\uD1A0\uB9AC" },
+    { path: "package.json", label: "\uC758\uC874\uC131 \uAD00\uB9AC" },
+    { path: ".env.example", label: "\uD658\uACBD\uBCC0\uC218 \uC608\uC2DC" },
+    { path: ".gitignore", label: ".gitignore" }
+  ];
+  for (const { path: path10, label } of structureChecks) {
+    const found = await fs17.pathExists(join9(repoPath, path10));
+    findings.push({ item: label, found, details: found ? "\uC874\uC7AC" : "\uC5C6\uC74C" });
+    if (found) score += 25;
   }
+  score = Math.min(100, score);
+  return { name: "\uB9AC\uD3EC\uC9C0\uD1A0\uB9AC \uAD6C\uC870", tier: "nice", score, recommendations: [], rawFindings: findings };
 }
-async function syncHandoff(cwd) {
-  const handoffPath = path8.join(cwd, "handoff.md");
-  if (!await fs16.pathExists(handoffPath)) return;
-  const state = await loadRobocoState(cwd);
-  const block = buildHandoffBlock(state);
-  const content = await fs16.readFile(handoffPath, "utf8");
-  const startIdx = content.indexOf(HANDOFF_START);
-  const endIdx = content.indexOf(HANDOFF_END);
-  let next;
-  if (startIdx >= 0 && endIdx > startIdx) {
-    next = content.slice(0, startIdx) + block + content.slice(endIdx + HANDOFF_END.length);
-  } else {
-    const sep = content.endsWith("\n") ? "\n" : "\n\n";
-    next = content + sep + block + "\n";
+async function checkDocumentation(repoPath) {
+  const findings = [];
+  let score = 0;
+  const docChecks = [
+    { path: "README.md", label: "README.md", points: 30 },
+    { path: "CONTRIBUTING.md", label: "CONTRIBUTING.md", points: 20 },
+    { path: "docs", label: "docs/ \uB514\uB809\uD1A0\uB9AC", points: 25 },
+    { path: "docs/openspec.md", label: "OpenSpec PRD", points: 25 }
+  ];
+  for (const { path: path10, label, points } of docChecks) {
+    const found = await fs17.pathExists(join9(repoPath, path10));
+    findings.push({ item: label, found, details: found ? "\uC874\uC7AC" : "\uC5C6\uC74C" });
+    if (found) score += points;
   }
-  await fs16.writeFile(handoffPath, next);
+  score = Math.min(100, score);
+  return { name: "\uBB38\uC11C\uD654 \uC218\uC900", tier: "nice", score, recommendations: [], rawFindings: findings };
 }
-function buildHandoffBlock(state) {
-  const lines = [HANDOFF_START, "## \uD30C\uC774\uD504\uB77C\uC778 \uC9C4\uD589 \uC0C1\uD0DC (roboco \uC790\uB3D9 \uAD00\uB9AC)", ""];
-  const done = state.stageHistory.filter((h) => h.status === "done");
-  const inProgress = state.stageHistory.filter((h) => h.status === "in_progress");
-  const failed = state.stageHistory.filter((h) => h.status === "failed");
-  if (inProgress.length > 0) {
-    lines.push("### \uC9C4\uD589 \uC911");
-    for (const h of inProgress) {
-      lines.push(`- [ ] ${h.stage} (${h.by}, \uC2DC\uC791 ${fmtDate(h.startedAt)})`);
-    }
-    lines.push("");
+async function checkHarnessEngineering(repoPath) {
+  const findings = [];
+  let score = 0;
+  const harnessChecks = [
+    { path: "CLAUDE.md", label: "CLAUDE.md", points: 25 },
+    { path: "AGENTS.md", label: "AGENTS.md", points: 15 },
+    { path: ".claude/settings.json", label: ".claude/settings.json", points: 20 },
+    { path: ".claude/skills", label: ".claude/skills/", points: 20 },
+    { path: ".claude/commands", label: ".claude/commands/", points: 10 },
+    { path: ".pai/config.json", label: "PAI config", points: 10 }
+  ];
+  for (const { path: path10, label, points } of harnessChecks) {
+    const found = await fs17.pathExists(join9(repoPath, path10));
+    findings.push({ item: label, found, details: found ? "\uC874\uC7AC" : "\uC5C6\uC74C" });
+    if (found) score += points;
   }
-  if (failed.length > 0) {
-    lines.push("### \uC2E4\uD328");
-    for (const h of failed) {
-      lines.push(`- [x] ${h.stage} \u2014 ${h.reason ?? "\uC6D0\uC778 \uBD88\uBA85"} (${fmtDate(h.startedAt)})`);
-    }
-    lines.push("");
+  score = Math.min(100, score);
+  return { name: "\uD558\uB124\uC2A4 \uC5D4\uC9C0\uB2C8\uC5B4\uB9C1", tier: "nice", score, recommendations: [], rawFindings: findings };
+}
+var init_analyzer2 = __esm({
+  "src/stages/evaluation/analyzer.ts"() {
+    "use strict";
   }
-  if (done.length > 0) {
-    lines.push("### \uC644\uB8CC");
-    for (const h of done) {
-      lines.push(`- [x] ${h.stage} (${h.by}, ${fmtDate(h.endedAt ?? h.startedAt)})`);
-    }
-    lines.push("");
+});
+
+// src/core/types/stage.ts
+var STAGE_ORDER;
+var init_stage = __esm({
+  "src/core/types/stage.ts"() {
+    "use strict";
+    STAGE_ORDER = [
+      "environment",
+      "design",
+      "execution",
+      "validation",
+      "evaluation"
+    ];
   }
-  lines.push(`\uD604\uC7AC \uB2E8\uACC4: **${state.currentStage}**`);
-  lines.push(HANDOFF_END);
-  return lines.join("\n");
+});
+
+// src/core/types/scoring.ts
+function gradeFromScore(score) {
+  if (score >= 90) return "A";
+  if (score >= 80) return "B";
+  if (score >= 70) return "C";
+  if (score >= 50) return "D";
+  return "F";
 }
-function fmtDate(iso) {
-  try {
-    const d = new Date(iso);
-    return d.toISOString().slice(0, 16).replace("T", " ");
-  } catch {
-    return iso;
+var DEFAULT_CATEGORY_WEIGHTS;
+var init_scoring = __esm({
+  "src/core/types/scoring.ts"() {
+    "use strict";
+    DEFAULT_CATEGORY_WEIGHTS = [
+      { name: "\uD14C\uC2A4\uD2B8 \uCEE4\uBC84\uB9AC\uC9C0", tier: "must", weight: 0.2 },
+      { name: "CI/CD", tier: "must", weight: 0.2 },
+      { name: "\uD6C5 \uAE30\uBC18 \uAC80\uC99D", tier: "must", weight: 0.2 },
+      { name: "\uB9AC\uD3EC\uC9C0\uD1A0\uB9AC \uAD6C\uC870", tier: "nice", weight: 0.133 },
+      { name: "\uBB38\uC11C\uD654 \uC218\uC900", tier: "nice", weight: 0.133 },
+      { name: "\uD558\uB124\uC2A4 \uC5D4\uC9C0\uB2C8\uC5B4\uB9C1", tier: "nice", weight: 0.134 }
+    ];
   }
-}
-var ROBOCO_PATH, DEFAULT_TTL_MS, RobocoLockError, GateFailedError, HANDOFF_START, HANDOFF_END;
-var init_roboco = __esm({
-  "src/core/roboco.ts"() {
+});
+
+// src/core/types/index.ts
+var init_types = __esm({
+  "src/core/types/index.ts"() {
     "use strict";
-    ROBOCO_PATH = path8.join(".pai", "roboco.json");
-    DEFAULT_TTL_MS = 10 * 60 * 1e3;
-    RobocoLockError = class extends Error {
-      constructor(message, holder) {
-        super(message);
-        this.holder = holder;
-        this.name = "RobocoLockError";
-      }
-      holder;
-    };
-    GateFailedError = class extends Error {
-      constructor(result) {
-        super(`\uAC8C\uC774\uD2B8 \uC2E4\uD328 (${result.name}): ${result.violations.length}\uAC74 \uC704\uBC18`);
-        this.result = result;
-        this.name = "GateFailedError";
-      }
-      result;
-    };
-    HANDOFF_START = "<!-- roboco:start -->";
-    HANDOFF_END = "<!-- roboco:end -->";
+    init_stage();
+    init_scoring();
   }
 });
 
-// src/core/gates.ts
-import path9 from "path";
-import fs17 from "fs-extra";
-function now() {
-  return (/* @__PURE__ */ new Date()).toISOString();
-}
-function makeResult(name, violations) {
+// src/stages/evaluation/scorer.ts
+var scorer_exports = {};
+__export(scorer_exports, {
+  computeResult: () => computeResult
+});
+function computeResult(llmOutput, customWeights) {
+  const weights = customWeights ?? DEFAULT_CATEGORY_WEIGHTS;
+  const categories = llmOutput.categories.map((cat) => ({
+    name: cat.name,
+    tier: cat.tier,
+    score: Math.round(Math.max(0, Math.min(100, cat.score))),
+    grade: gradeFromScore(Math.max(0, Math.min(100, cat.score))),
+    recommendations: cat.recommendations,
+    rawFindings: cat.rawFindings
+  }));
+  const totalScore = computeWeightedAverage(categories, weights);
+  let totalGrade = gradeFromScore(totalScore);
+  const { penaltyApplied, penaltyReason } = checkPenalty(categories);
+  if (penaltyApplied && gradeRank(totalGrade) > gradeRank("C")) {
+    totalGrade = "C";
+  }
   return {
-    name,
-    passed: violations.length === 0,
-    checkedAt: now(),
-    violations
+    categories,
+    totalScore,
+    totalGrade,
+    summary: llmOutput.summary,
+    penaltyApplied,
+    penaltyReason
   };
 }
-async function designEntryGate(cwd) {
-  const violations = [];
-  const claudeMd = path9.join(cwd, "CLAUDE.md");
-  if (!await fs17.pathExists(claudeMd)) {
-    violations.push({
-      rule: "claude-md-exists",
-      message: "CLAUDE.md\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 `pai init`\uC744 \uC2E4\uD589\uD558\uC138\uC694.",
-      location: "CLAUDE.md"
-    });
+function computeWeightedAverage(categories, weights) {
+  let weightedSum = 0;
+  let totalWeight = 0;
+  for (const cat of categories) {
+    const config = weights.find((w) => w.name === cat.name);
+    const weight = config?.weight ?? (cat.tier === "must" ? 0.2 : 0.133);
+    weightedSum += cat.score * weight;
+    totalWeight += weight;
   }
-  const configJson = path9.join(cwd, ".pai", "config.json");
-  if (!await fs17.pathExists(configJson)) {
-    violations.push({
-      rule: "pai-config-exists",
-      message: "PAI \uC124\uC815\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. `pai init`\uC744 \uC2E4\uD589\uD558\uC138\uC694.",
-      location: ".pai/config.json"
-    });
+  if (totalWeight === 0) return 0;
+  return Math.round(weightedSum / totalWeight * 100) / 100;
+}
+function checkPenalty(categories) {
+  const failedMust = categories.filter(
+    (c2) => c2.tier === "must" && c2.grade === "F"
+  );
+  if (failedMust.length > 0) {
+    const names = failedMust.map((c2) => c2.name).join(", ");
+    return {
+      penaltyApplied: true,
+      penaltyReason: `\uD544\uC218 \uCE74\uD14C\uACE0\uB9AC F \uB4F1\uAE09: ${names} \u2192 \uC804\uCCB4 \uB4F1\uAE09 \uCD5C\uB300 C\uB85C \uC81C\uD55C`
+    };
+  }
+  return { penaltyApplied: false };
+}
+function gradeRank(grade) {
+  const ranks = { A: 4, B: 3, C: 2, D: 1, F: 0 };
+  return ranks[grade];
+}
+var init_scorer = __esm({
+  "src/stages/evaluation/scorer.ts"() {
+    "use strict";
+    init_types();
+  }
+});
+
+// src/stages/evaluation/reporter.ts
+var reporter_exports = {};
+__export(reporter_exports, {
+  buildDetailedReport: () => buildDetailedReport,
+  buildMarkdownReport: () => buildMarkdownReport,
+  printReport: () => printReport,
+  printVerboseFindings: () => printVerboseFindings
+});
+import chalk5 from "chalk";
+function printReport(result) {
+  console.log("");
+  console.log(chalk5.hex("#7B93DB")("  PAI Evaluation Report"));
+  console.log(chalk5.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log("");
+  const gradeColor = GRADE_COLORS[result.totalGrade];
+  console.log(`  \uC885\uD569 \uC810\uC218: ${gradeColor(String(result.totalScore))} / 100  \uB4F1\uAE09: ${gradeColor(result.totalGrade)}`);
+  if (result.penaltyApplied) {
+    console.log(chalk5.red(`  \u26A0 ${result.penaltyReason}`));
+  }
+  console.log("");
+  console.log(chalk5.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  for (const cat of result.categories) {
+    const color = GRADE_COLORS[cat.grade];
+    const tierLabel = cat.tier === "must" ? chalk5.hex("#E06C75")("[\uD544\uC218]") : chalk5.gray("[\uC120\uD0DD]");
+    const bar = renderBar(cat.score);
+    console.log(`  ${tierLabel} ${cat.name.padEnd(16)} ${bar} ${color(`${cat.score}`).padStart(12)} ${color(cat.grade)}`);
   }
-  return makeResult("design.entry", violations);
+  console.log("");
+  console.log(chalk5.gray(`  ${result.summary}`));
+  console.log("");
 }
-async function executionEntryGate(cwd) {
-  const violations = [];
-  const openspec = path9.join(cwd, "docs", "openspec.md");
-  const hasOpenspec = await fs17.pathExists(openspec);
-  if (!hasOpenspec) {
-    violations.push({
-      rule: "openspec-exists",
-      message: "docs/openspec.md\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
-      location: "docs/openspec.md"
-    });
-  } else {
-    const content = await fs17.readFile(openspec, "utf8");
-    const endpointCount = countEndpoints(content);
-    if (endpointCount < 1) {
-      violations.push({
-        rule: "openspec-endpoints-min",
-        message: `openspec.md\uC5D0 \uC815\uC758\uB41C API \uC5D4\uB4DC\uD3EC\uC778\uD2B8\uAC00 0\uAC1C\uC785\uB2C8\uB2E4. \uCD5C\uC18C 1\uAC1C \uD544\uC694 (\uD604\uC7AC: 0). /pai design \uC2E4\uD589 \uAD8C\uC7A5.`,
-        location: "docs/openspec.md \xA7 5. API \uC5D4\uB4DC\uD3EC\uC778\uD2B8"
-      });
+function printVerboseFindings(result) {
+  for (const cat of result.categories) {
+    console.log("");
+    console.log(chalk5.bold(`  ${cat.name} (${cat.grade}, ${cat.score}\uC810)`));
+    for (const f of cat.rawFindings) {
+      const icon = f.found ? chalk5.green("\u2713") : chalk5.red("\u2717");
+      console.log(`    ${icon} ${f.item} \u2014 ${f.details}`);
     }
-  }
-  const omc = path9.join(cwd, ".pai", "omc.md");
-  if (await fs17.pathExists(omc)) {
-    const content = await fs17.readFile(omc, "utf8");
-    const domainCount = countDomainObjects(content);
-    if (domainCount < 1) {
-      violations.push({
-        rule: "omc-domain-min",
-        message: "omc.md\uC5D0 \uB3C4\uBA54\uC778 \uAC1D\uCCB4\uAC00 0\uAC1C\uC785\uB2C8\uB2E4. \uCD5C\uC18C 1\uAC1C \uD544\uC694.",
-        location: ".pai/omc.md \xA7 \uB3C4\uBA54\uC778 \uAC1D\uCCB4"
-      });
+    for (const r of cat.recommendations) {
+      const severity = r.severity === "critical" ? chalk5.red("!") : r.severity === "warning" ? chalk5.yellow("!") : chalk5.gray("i");
+      console.log(`    ${severity} ${r.message}`);
+      console.log(chalk5.gray(`      \u2192 ${r.action}`));
     }
   }
-  return makeResult("execution.entry", violations);
 }
-async function validationEntryGate(cwd) {
-  const violations = [];
-  const srcDir = path9.join(cwd, "src");
-  if (!await fs17.pathExists(srcDir)) {
-    violations.push({
-      rule: "src-dir-exists",
-      message: "src/ \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
-      location: "src/"
-    });
+function renderBar(score) {
+  const width = 20;
+  const filled = Math.round(score / 100 * width);
+  const empty = width - filled;
+  const color = score >= 80 ? chalk5.hex("#6BCB77") : score >= 60 ? chalk5.hex("#E2B340") : chalk5.hex("#E06C75");
+  return color("\u2588".repeat(filled)) + chalk5.gray("\u2591".repeat(empty));
+}
+function buildMarkdownReport(result) {
+  const lines = [
+    "# PAI Evaluation Report",
+    "",
+    `> \uC0DD\uC131\uC77C\uC2DC: ${(/* @__PURE__ */ new Date()).toLocaleString("ko-KR")}`,
+    "",
+    `## \uC885\uD569 \uC810\uC218: ${result.totalScore}/100 \u2014 \uB4F1\uAE09 ${result.totalGrade}`,
+    ""
+  ];
+  if (result.penaltyApplied) {
+    lines.push(`> \u26A0 ${result.penaltyReason}`);
+    lines.push("");
+  }
+  lines.push("## \uCE74\uD14C\uACE0\uB9AC\uBCC4 \uC0C1\uC138");
+  lines.push("");
+  lines.push("| \uCE74\uD14C\uACE0\uB9AC | \uBD84\uB958 | \uC810\uC218 | \uB4F1\uAE09 |");
+  lines.push("|---------|------|------|------|");
+  for (const cat of result.categories) {
+    const tier = cat.tier === "must" ? "\uD544\uC218" : "\uC120\uD0DD";
+    lines.push(`| ${cat.name} | ${tier} | ${cat.score} | ${cat.grade} |`);
+  }
+  lines.push("");
+  lines.push("## \uAD8C\uACE0\uC0AC\uD56D");
+  lines.push("");
+  const allRecs = result.categories.flatMap(
+    (c2) => c2.recommendations.map((r) => ({ ...r, category: c2.name }))
+  );
+  if (allRecs.length === 0) {
+    lines.push("\uBAA8\uB4E0 \uD56D\uBAA9\uC774 \uC591\uD638\uD569\uB2C8\uB2E4!");
   } else {
-    const codeFileCount = await countCodeFiles(srcDir);
-    if (codeFileCount === 0) {
-      violations.push({
-        rule: "code-files-min",
-        message: "src/ \uB0B4\uBD80\uC5D0 \uCF54\uB4DC \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. \uCD5C\uC18C 1\uAC1C \uD544\uC694.",
-        location: "src/"
-      });
+    for (const r of allRecs) {
+      const icon = r.severity === "critical" ? "\u{1F534}" : r.severity === "warning" ? "\u{1F7E1}" : "\u2139\uFE0F";
+      lines.push(`- ${icon} **${r.category}**: ${r.message}`);
+      lines.push(`  - ${r.action}`);
     }
   }
-  return makeResult("validation.entry", violations);
+  lines.push("");
+  lines.push(`## \uC694\uC57D`);
+  lines.push("");
+  lines.push(result.summary);
+  lines.push("");
+  lines.push("---");
+  lines.push("*Generated by PAI (Plugin-based AI)*");
+  return lines.join("\n") + "\n";
 }
-async function evaluationEntryGate(cwd) {
-  const violations = [];
-  const state = await loadRobocoState(cwd);
-  const recentValidation = [...state.stageHistory].reverse().find((h) => h.stage === "validation");
-  if (!recentValidation) {
-    violations.push({
-      rule: "validation-executed",
-      message: "validation \uB2E8\uACC4\uAC00 \uD55C \uBC88\uB3C4 \uC2E4\uD589\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 `pai test`\uB97C \uC2E4\uD589\uD558\uC138\uC694."
-    });
-  } else if (recentValidation.status !== "done") {
-    violations.push({
-      rule: "validation-passed",
-      message: `\uCD5C\uADFC validation\uC774 ${recentValidation.status} \uC0C1\uD0DC\uC785\uB2C8\uB2E4. \uD14C\uC2A4\uD2B8\uB97C \uC131\uACF5\uC2DC\uD0A8 \uB4A4 \uC2DC\uB3C4\uD558\uC138\uC694.`
-    });
+function buildDetailedReport(result, projectName) {
+  const now2 = (/* @__PURE__ */ new Date()).toLocaleString("ko-KR");
+  const mustCats = result.categories.filter((c2) => c2.tier === "must");
+  const niceCats = result.categories.filter((c2) => c2.tier === "nice");
+  const lines = [
+    `# ${projectName} \uBC14\uC774\uBE0C \uCF54\uB529 \uC900\uBE44\uB3C4 \uBD84\uC11D \uB9AC\uD3EC\uD2B8`,
+    "",
+    `> \uC2A4\uCE94 \uC77C\uC2DC: ${now2}`,
+    `> \uBD84\uC11D \uB300\uC0C1: ${projectName}`,
+    "",
+    "---",
+    "",
+    "## \uC694\uC57D",
+    "",
+    `${projectName}\uC758 \uBC14\uC774\uBE0C \uCF54\uB529 \uC900\uBE44\uB3C4 \uC885\uD569 \uC810\uC218\uB294 **${result.totalScore}/100 (${result.totalGrade}\uB4F1\uAE09)**\uC785\uB2C8\uB2E4.`,
+    ""
+  ];
+  if (result.penaltyApplied) {
+    lines.push(`> \u26A0 ${result.penaltyReason}`);
+    lines.push("");
+  }
+  if (result.totalGrade === "A") {
+    lines.push("AI \uC9C0\uC6D0 \uCF54\uB529 \uC6CC\uD06C\uD50C\uB85C\uC6B0\uB97C \uD65C\uC6A9\uD560 \uC900\uBE44\uAC00 \uC798 \uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4.");
+  } else if (result.totalGrade === "B") {
+    lines.push("\uB300\uBD80\uBD84 \uC900\uBE44\uB418\uC5B4 \uC788\uC73C\uBA70, \uC77C\uBD80 \uAC1C\uC120\uC73C\uB85C \uCD5C\uC801\uC758 \uBC14\uC774\uBE0C \uCF54\uB529 \uD658\uACBD\uC744 \uAD6C\uCD95\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.");
+  } else if (result.totalGrade === "C") {
+    lines.push("\uAE30\uBCF8\uC801\uC778 \uAD6C\uC870\uB294 \uAC16\uCD94\uACE0 \uC788\uC73C\uB098, \uBC14\uC774\uBE0C \uCF54\uB529\uC758 \uC7A0\uC7AC\uB825\uC744 \uCDA9\uBD84\uD788 \uD65C\uC6A9\uD558\uB824\uBA74 \uAC1C\uC120\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.");
+  } else if (result.totalGrade === "D") {
+    lines.push("AI \uC9C0\uC6D0 \uCF54\uB529 \uC6CC\uD06C\uD50C\uB85C\uC6B0\uB97C \uBCF8\uACA9\uC801\uC73C\uB85C \uD65C\uC6A9\uD558\uAE30\uC5D0\uB294 \uC0C1\uB2F9\uD55C \uAC1C\uC120\uC774 \uD544\uC694\uD55C \uC0C1\uD0DC\uC785\uB2C8\uB2E4.");
   } else {
-    const endedAt = recentValidation.endedAt ?? recentValidation.startedAt;
-    const age = Date.now() - new Date(endedAt).getTime();
-    if (age > EVAL_GATE_WINDOW_MS) {
-      const mins = Math.round(age / 6e4);
-      violations.push({
-        rule: "validation-recent",
-        message: `\uCD5C\uADFC validation \uD1B5\uACFC\uAC00 ${mins}\uBD84 \uC804\uC785\uB2C8\uB2E4 (1\uC2DC\uAC04 \uC774\uB0B4\uC5EC\uC57C \uD568). --force\uB85C \uC6B0\uD68C \uAC00\uB2A5.`
-      });
-    }
+    lines.push("\uBC14\uC774\uBE0C \uCF54\uB529 \uD658\uACBD\uC774 \uAC70\uC758 \uAD6C\uC131\uB418\uC9C0 \uC54A\uC740 \uC0C1\uD0DC\uB85C, \uAE30\uBCF8 \uC124\uC815\uBD80\uD130 \uC2DC\uC791\uD574\uC57C \uD569\uB2C8\uB2E4.");
   }
-  return makeResult("evaluation.entry", violations);
-}
-function countEndpoints(openspecContent) {
-  const lines = openspecContent.split("\n");
-  let inTable = false;
-  let count = 0;
-  for (const rawLine of lines) {
-    const line = rawLine.trim();
-    if (/^##\s*5\.|^##\s*API|API 엔드포인트/i.test(line)) {
-      inTable = true;
-      continue;
+  lines.push("");
+  lines.push("---");
+  lines.push("");
+  lines.push("## \uD56D\uBAA9\uBCC4 \uD604\uD669");
+  lines.push("");
+  lines.push("| \uD56D\uBAA9 | \uBD84\uB958 | \uC810\uC218 | \uB4F1\uAE09 | \uAC00\uC911\uCE58 |");
+  lines.push("|------|------|------|------|--------|");
+  for (const cat of result.categories) {
+    const tier = cat.tier === "must" ? "**\uD544\uC218**" : "\uC120\uD0DD";
+    lines.push(`| ${cat.name} | ${tier} | ${cat.score}/100 | ${cat.grade} | ${cat.tier === "must" ? "20%" : "13.3%"} |`);
+  }
+  lines.push("");
+  lines.push("---");
+  lines.push("");
+  lines.push("## \uD56D\uBAA9\uBCC4 \uC0C1\uC138 \uBD84\uC11D");
+  lines.push("");
+  for (const cat of result.categories) {
+    const tierLabel = cat.tier === "must" ? "\uD544\uC218" : "\uC120\uD0DD";
+    lines.push(`### ${cat.name} (${tierLabel}, \uAC00\uC911\uCE58 ${cat.tier === "must" ? "20%" : "13.3%"}) \u2014 ${cat.grade}\uB4F1\uAE09`);
+    lines.push("");
+    if (cat.rawFindings.length > 0) {
+      lines.push("**\uC810\uAC80 \uACB0\uACFC:**");
+      lines.push("");
+      for (const f of cat.rawFindings) {
+        const icon = f.found ? "\u2705" : "\u274C";
+        lines.push(`- ${icon} ${f.item} \u2014 ${f.details}`);
+      }
+      lines.push("");
     }
-    if (!inTable) continue;
-    if (/^##\s/.test(line) && !/5\.|API/i.test(line)) {
-      inTable = false;
-      continue;
+    if (cat.grade === "A" || cat.grade === "B") {
+      lines.push(`**\uD3C9\uAC00:** \uC591\uD638\uD55C \uC0C1\uD0DC\uC785\uB2C8\uB2E4.`);
+    } else if (cat.grade === "C") {
+      lines.push(`**\uD3C9\uAC00:** \uAE30\uBCF8\uC740 \uAC16\uCD94\uACE0 \uC788\uC73C\uB098 \uCD94\uAC00 \uAC1C\uC120\uC774 \uAD8C\uC7A5\uB429\uB2C8\uB2E4.`);
+    } else if (cat.grade === "D") {
+      lines.push(`**\uD3C9\uAC00:** \uAC1C\uC120\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.`);
+    } else {
+      lines.push(`**\uD3C9\uAC00:** \uC2DC\uAE09\uD55C \uAC1C\uC120\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.`);
     }
-    if (/^\|\s*Method/i.test(line)) continue;
-    if (/^\|\s*[-:]+\s*\|/.test(line)) continue;
-    const m = line.match(/^\|\s*(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)\s*\|\s*(\/\S+)\s*\|/i);
-    if (m) count++;
-  }
-  return count;
-}
-function countDomainObjects(omcContent) {
-  const lines = omcContent.split("\n");
-  let count = 0;
-  let inDomainSection = false;
-  for (const rawLine of lines) {
-    const line = rawLine.trim();
-    if (/^##\s*도메인 객체|^##\s*Domain Objects/i.test(line)) {
-      inDomainSection = true;
-      continue;
+    lines.push("");
+    if (cat.recommendations.length > 0) {
+      lines.push("**\uAD8C\uACE0\uC0AC\uD56D:**");
+      lines.push("");
+      for (const r of cat.recommendations) {
+        const icon = r.severity === "critical" ? "\u{1F534}" : r.severity === "warning" ? "\u{1F7E1}" : "\u2139\uFE0F";
+        lines.push(`- ${icon} ${r.message}`);
+        lines.push(`  - \u2192 ${r.action}`);
+      }
+      lines.push("");
     }
-    if (!inDomainSection) continue;
-    if (/^##\s/.test(line) && !/도메인|Domain/i.test(line)) {
-      inDomainSection = false;
-      continue;
+    lines.push("---");
+    lines.push("");
+  }
+  lines.push("## \uAC1C\uC120 \uB85C\uB4DC\uB9F5");
+  lines.push("");
+  const critical = result.categories.filter((c2) => c2.grade === "F");
+  const warning = result.categories.filter((c2) => c2.grade === "D");
+  const ok = result.categories.filter((c2) => c2.grade === "C" || c2.grade === "B" || c2.grade === "A");
+  if (critical.length > 0) {
+    lines.push("### \uC989\uC2DC \uAC1C\uC120 \uD544\uC694 (F\uB4F1\uAE09)");
+    lines.push("");
+    lines.push("| \uD56D\uBAA9 | \uD604\uC7AC \uC810\uC218 | \uBAA9\uD45C | \uC870\uCE58 |");
+    lines.push("|------|----------|------|------|");
+    for (const c2 of critical) {
+      const action = c2.recommendations[0]?.action ?? "\uC124\uC815 \uCD94\uAC00 \uD544\uC694";
+      lines.push(`| ${c2.name} | ${c2.score}\uC810 (F) | 50\uC810+ (D) | ${action} |`);
     }
-    if (/^###\s+\w/.test(line)) count++;
+    lines.push("");
   }
-  return count;
-}
-async function countCodeFiles(srcDir) {
-  const exts = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".py", ".go", ".rs", ".java", ".kt"]);
-  let count = 0;
-  async function walk(dir) {
-    let entries;
-    try {
-      entries = await fs17.readdir(dir);
-    } catch {
-      return;
+  if (warning.length > 0) {
+    lines.push("### \uB2E8\uAE30 \uAC1C\uC120 \uAD8C\uC7A5 (D\uB4F1\uAE09)");
+    lines.push("");
+    lines.push("| \uD56D\uBAA9 | \uD604\uC7AC \uC810\uC218 | \uBAA9\uD45C | \uC870\uCE58 |");
+    lines.push("|------|----------|------|------|");
+    for (const c2 of warning) {
+      const action = c2.recommendations[0]?.action ?? "\uCD94\uAC00 \uC124\uC815 \uAD8C\uC7A5";
+      lines.push(`| ${c2.name} | ${c2.score}\uC810 (D) | 70\uC810+ (C) | ${action} |`);
     }
-    for (const name of entries) {
-      if (name.startsWith(".") || name === "node_modules") continue;
-      const full = path9.join(dir, name);
-      const stat = await fs17.stat(full).catch(() => null);
-      if (!stat) continue;
-      if (stat.isDirectory()) {
-        await walk(full);
-      } else if (exts.has(path9.extname(name))) {
-        count++;
-      }
+    lines.push("");
+  }
+  if (ok.length > 0) {
+    lines.push("### \uC591\uD638 (C\uB4F1\uAE09 \uC774\uC0C1)");
+    lines.push("");
+    for (const c2 of ok) {
+      lines.push(`- \u2705 ${c2.name}: ${c2.score}\uC810 (${c2.grade})`);
     }
+    lines.push("");
   }
-  await walk(srcDir);
-  return count;
+  lines.push("---");
+  lines.push("");
+  lines.push("## \uACB0\uB860");
+  lines.push("");
+  lines.push(result.summary);
+  lines.push("");
+  if (result.totalGrade === "F" || result.totalGrade === "D") {
+    const immediateActions = critical.length + warning.length;
+    lines.push(`\uC989\uC2DC \uAC1C\uC120 \uAC00\uB2A5\uD55C ${immediateActions}\uAC1C \uD56D\uBAA9\uC744 \uC644\uB8CC\uD558\uBA74 \uC810\uC218\uB97C \uD06C\uAC8C \uB04C\uC5B4\uC62C\uB9B4 \uC218 \uC788\uC2B5\uB2C8\uB2E4.`);
+  } else if (result.totalGrade === "C") {
+    lines.push("\uAE30\uBCF8 \uAD6C\uC870\uAC00 \uC798 \uAC16\uCD94\uC5B4\uC838 \uC788\uC73C\uBA70, \uB2E8\uAE30 \uAC1C\uC120 \uD56D\uBAA9\uC744 \uB9C8\uBB34\uB9AC\uD558\uBA74 B\uB4F1\uAE09 \uB2EC\uC131\uC774 \uAC00\uB2A5\uD569\uB2C8\uB2E4.");
+  } else {
+    lines.push("\uBC14\uC774\uBE0C \uCF54\uB529 \uD658\uACBD\uC774 \uC798 \uAD6C\uC131\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4. \uC9C0\uC18D\uC801\uC778 \uD488\uC9C8 \uAD00\uB9AC\uB97C \uAD8C\uC7A5\uD569\uB2C8\uB2E4.");
+  }
+  lines.push("");
+  lines.push("---");
+  lines.push("");
+  lines.push("*PAI Zero (Plugin AI for ProjectZero) + Claude Code\uB85C \uC0DD\uC131\uB428*");
+  return lines.join("\n") + "\n";
 }
-var EVAL_GATE_WINDOW_MS, STAGE_GATES;
-var init_gates = __esm({
-  "src/core/gates.ts"() {
+var GRADE_COLORS;
+var init_reporter = __esm({
+  "src/stages/evaluation/reporter.ts"() {
     "use strict";
-    init_roboco();
-    EVAL_GATE_WINDOW_MS = 60 * 60 * 1e3;
-    STAGE_GATES = {
-      environment: async () => makeResult("environment.entry", []),
-      // 항상 통과
-      design: designEntryGate,
-      execution: executionEntryGate,
-      validation: validationEntryGate,
-      evaluation: evaluationEntryGate
+    GRADE_COLORS = {
+      A: chalk5.hex("#6BCB77"),
+      B: chalk5.hex("#7B93DB"),
+      C: chalk5.hex("#E2B340"),
+      D: chalk5.hex("#E06C75"),
+      F: chalk5.hex("#CC4444")
     };
   }
 });
 
-// src/stages/validation/runner.ts
+// src/utils/shell-cd.ts
+var shell_cd_exports = {};
+__export(shell_cd_exports, {
+  installShellHelper: () => installShellHelper,
+  requestCdAfter: () => requestCdAfter
+});
 import { join as join10 } from "path";
+import { homedir as homedir2 } from "os";
 import fs18 from "fs-extra";
-async function runTests(cwd) {
-  const start = Date.now();
-  const gstackPath = join10(cwd, ".pai", "gstack.json");
-  let runner = "npm test";
-  if (await fs18.pathExists(gstackPath)) {
-    try {
-      const config = await fs18.readJson(gstackPath);
-      if (config.testRunner === "vitest") runner = "npx vitest run";
-      else if (config.testRunner === "jest") runner = "npx jest";
-      else if (config.testRunner === "mocha") runner = "npx mocha";
-    } catch {
+async function requestCdAfter(targetDir) {
+  await fs18.ensureDir(PAI_DIR);
+  await fs18.writeFile(CD_FILE, targetDir);
+}
+async function installShellHelper() {
+  await fs18.ensureDir(PAI_DIR);
+  if (isWindows) {
+    return installPowerShellHelper();
+  }
+  return installBashHelper();
+}
+async function installBashHelper() {
+  await fs18.writeFile(HELPER_FILE_SH, BASH_HELPER);
+  const rcFile = getShellRcPath();
+  const sourceLine = 'source "$HOME/.pai/shell-helper.sh"';
+  if (await fs18.pathExists(rcFile)) {
+    const content = await fs18.readFile(rcFile, "utf8");
+    if (content.includes("shell-helper.sh")) {
+      return true;
     }
+    await fs18.appendFile(rcFile, `
+# PAI \u2014 \uC790\uB3D9 \uB514\uB809\uD1A0\uB9AC \uC774\uB3D9
+${sourceLine}
+`);
+    return false;
   }
-  const pkgPath = join10(cwd, "package.json");
-  if (await fs18.pathExists(pkgPath)) {
-    try {
-      const pkg5 = await fs18.readJson(pkgPath);
-      if (!pkg5.scripts?.test || pkg5.scripts.test.includes("no test specified")) {
-        return {
-          runner,
-          passed: false,
-          output: "\uD14C\uC2A4\uD2B8 \uC2A4\uD06C\uB9BD\uD2B8\uAC00 \uC815\uC758\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. package.json\uC758 scripts.test\uB97C \uC124\uC815\uD558\uC138\uC694.",
-          duration: Date.now() - start
-        };
-      }
-    } catch {
+  await fs18.writeFile(rcFile, `${sourceLine}
+`);
+  return false;
+}
+async function installPowerShellHelper() {
+  await fs18.writeFile(HELPER_FILE_PS1, POWERSHELL_HELPER);
+  const rcFile = getShellRcPath();
+  const sourceLine = '. "$env:USERPROFILE\\.pai\\shell-helper.ps1"';
+  await fs18.ensureDir(join10(rcFile, ".."));
+  if (await fs18.pathExists(rcFile)) {
+    const content = await fs18.readFile(rcFile, "utf8");
+    if (content.includes("shell-helper.ps1")) {
+      return true;
+    }
+    await fs18.appendFile(rcFile, `
+# PAI \u2014 \uC790\uB3D9 \uB514\uB809\uD1A0\uB9AC \uC774\uB3D9
+${sourceLine}
+`);
+    return false;
+  }
+  await fs18.writeFile(rcFile, `${sourceLine}
+`);
+  return false;
+}
+var PAI_DIR, CD_FILE, HELPER_FILE_SH, HELPER_FILE_PS1, BASH_HELPER, POWERSHELL_HELPER;
+var init_shell_cd = __esm({
+  "src/utils/shell-cd.ts"() {
+    "use strict";
+    init_platform();
+    PAI_DIR = join10(homedir2(), ".pai");
+    CD_FILE = join10(PAI_DIR, ".cd-after");
+    HELPER_FILE_SH = join10(PAI_DIR, "shell-helper.sh");
+    HELPER_FILE_PS1 = join10(PAI_DIR, "shell-helper.ps1");
+    BASH_HELPER = `# PAI shell helper \u2014 \uC790\uB3D9 \uB514\uB809\uD1A0\uB9AC \uC774\uB3D9 \uC9C0\uC6D0
+pai() {
+  local cd_target="$HOME/.pai/.cd-after"
+  rm -f "$cd_target"
+  PAI_CD_AFTER="$cd_target" command npx pai-zero "$@"
+  local exit_code=$?
+  if [ -f "$cd_target" ]; then
+    local dir
+    dir="$(cat "$cd_target")"
+    rm -f "$cd_target"
+    if [ -n "$dir" ] && [ -d "$dir" ]; then
+      cd "$dir" || true
+      echo "  \u2192 cd $dir"
+    fi
+  fi
+  return $exit_code
+}
+`;
+    POWERSHELL_HELPER = `# PAI shell helper \u2014 \uC790\uB3D9 \uB514\uB809\uD1A0\uB9AC \uC774\uB3D9 \uC9C0\uC6D0
+function pai {
+  $cdTarget = Join-Path $env:USERPROFILE '.pai\\.cd-after'
+  Remove-Item $cdTarget -ErrorAction SilentlyContinue
+  $env:PAI_CD_AFTER = $cdTarget
+  & npx pai-zero @args
+  $exitCode = $LASTEXITCODE
+  if (Test-Path $cdTarget) {
+    $dir = Get-Content $cdTarget -Raw
+    Remove-Item $cdTarget -ErrorAction SilentlyContinue
+    if ($dir -and (Test-Path $dir)) {
+      Set-Location $dir
+      Write-Host "  -> cd $dir"
     }
   }
+  return $exitCode
+}
+`;
+  }
+});
+
+// src/utils/claude-settings.ts
+var claude_settings_exports = {};
+__export(claude_settings_exports, {
+  ClaudeSettingsError: () => ClaudeSettingsError,
+  buildSkeleton: () => buildSkeleton,
+  enableOmcPlugin: () => enableOmcPlugin,
+  getClaudeSettingsPath: () => getClaudeSettingsPath,
+  isAlreadyEnabled: () => isAlreadyEnabled,
+  mergeOmcIntoSettings: () => mergeOmcIntoSettings
+});
+import os3 from "os";
+import path9 from "path";
+import fs19 from "fs-extra";
+function getClaudeSettingsPath(homeDir = os3.homedir()) {
+  return path9.join(homeDir, ".claude", "settings.json");
+}
+function parseJsonWithBom(raw) {
+  const stripped = raw.charCodeAt(0) === 65279 ? raw.slice(1) : raw;
+  return JSON.parse(stripped);
+}
+function timestampSuffix() {
+  return sanitizeFilenameForWindows((/* @__PURE__ */ new Date()).toISOString());
+}
+async function enableOmcPlugin(options = {}) {
+  const marketplaceId = options.marketplaceId ?? DEFAULT_MARKETPLACE_ID;
+  const marketplaceUrl = options.marketplaceUrl ?? DEFAULT_MARKETPLACE_URL;
+  const pluginId = options.pluginId ?? DEFAULT_PLUGIN_ID;
+  const wantBackup = options.backup ?? true;
+  const settingsPath = getClaudeSettingsPath();
+  await fs19.ensureDir(path9.dirname(settingsPath));
+  if (!await fs19.pathExists(settingsPath)) {
+    const skeleton = buildSkeleton(marketplaceId, marketplaceUrl, pluginId);
+    await fs19.writeFile(settingsPath, JSON.stringify(skeleton, null, 2) + "\n", "utf8");
+    return { action: "created", settingsPath };
+  }
+  const raw = await fs19.readFile(settingsPath, "utf8");
+  let parsed;
   try {
-    const { execa } = await import("execa");
-    const { stdout, stderr } = await execa("npm", ["test"], {
-      cwd,
-      timeout: 12e4,
-      env: { ...process.env, CI: "true" }
-    });
-    return {
-      runner,
-      passed: true,
-      output: stdout || stderr,
-      duration: Date.now() - start
-    };
+    const value = parseJsonWithBom(raw);
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+      throw new Error("settings.json is not a JSON object");
+    }
+    parsed = value;
   } catch (err) {
-    const output = err instanceof Error ? err.message : String(err);
-    return {
-      runner,
-      passed: false,
-      output,
-      duration: Date.now() - start
-    };
+    const backupPath2 = `${settingsPath}.backup-${timestampSuffix()}`;
+    await fs19.copy(settingsPath, backupPath2);
+    throw new ClaudeSettingsError(
+      `settings.json \uD30C\uC2F1 \uC2E4\uD328: ${err.message}. \uBC31\uC5C5: ${backupPath2}`,
+      backupPath2
+    );
+  }
+  if (isAlreadyEnabled(parsed, marketplaceId, pluginId)) {
+    return { action: "already-enabled", settingsPath };
+  }
+  let backupPath;
+  if (wantBackup) {
+    backupPath = `${settingsPath}.backup-${timestampSuffix()}`;
+    await fs19.copy(settingsPath, backupPath);
   }
+  const merged = mergeOmcIntoSettings(parsed, marketplaceId, marketplaceUrl, pluginId);
+  await fs19.writeFile(settingsPath, JSON.stringify(merged, null, 2) + "\n", "utf8");
+  return { action: "added", settingsPath, backupPath };
+}
+function buildSkeleton(marketplaceId, marketplaceUrl, pluginId) {
+  return {
+    extraKnownMarketplaces: {
+      [marketplaceId]: {
+        source: { source: "git", url: marketplaceUrl }
+      }
+    },
+    enabledPlugins: {
+      [pluginId]: true
+    }
+  };
 }
-var init_runner = __esm({
-  "src/stages/validation/runner.ts"() {
+function isAlreadyEnabled(settings, marketplaceId, pluginId) {
+  const markets = settings["extraKnownMarketplaces"];
+  const enabled = settings["enabledPlugins"];
+  const hasMarket = typeof markets === "object" && markets !== null && marketplaceId in markets;
+  const hasPlugin = typeof enabled === "object" && enabled !== null && enabled[pluginId] === true;
+  return hasMarket && hasPlugin;
+}
+function mergeOmcIntoSettings(settings, marketplaceId, marketplaceUrl, pluginId) {
+  const next = { ...settings };
+  const existingMarkets = typeof next["extraKnownMarketplaces"] === "object" && next["extraKnownMarketplaces"] !== null ? { ...next["extraKnownMarketplaces"] } : {};
+  existingMarkets[marketplaceId] = {
+    source: { source: "git", url: marketplaceUrl }
+  };
+  next["extraKnownMarketplaces"] = existingMarkets;
+  const existingPlugins = typeof next["enabledPlugins"] === "object" && next["enabledPlugins"] !== null ? { ...next["enabledPlugins"] } : {};
+  existingPlugins[pluginId] = true;
+  next["enabledPlugins"] = existingPlugins;
+  return next;
+}
+var DEFAULT_MARKETPLACE_ID, DEFAULT_MARKETPLACE_URL, DEFAULT_PLUGIN_ID, ClaudeSettingsError;
+var init_claude_settings = __esm({
+  "src/utils/claude-settings.ts"() {
     "use strict";
+    init_platform();
+    DEFAULT_MARKETPLACE_ID = "omc";
+    DEFAULT_MARKETPLACE_URL = "https://github.com/SoInKyu/oh-my-claudecode.git";
+    DEFAULT_PLUGIN_ID = "oh-my-claudecode@omc";
+    ClaudeSettingsError = class extends Error {
+      constructor(message, backupPath) {
+        super(message);
+        this.backupPath = backupPath;
+        this.name = "ClaudeSettingsError";
+      }
+      backupPath;
+    };
   }
 });
 
-// src/stages/validation/harness.ts
+// src/stages/evaluation/cache.ts
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
 import { join as join11 } from "path";
-import fs19 from "fs-extra";
-async function runHarnessCheck(cwd) {
-  const harnessPath = join11(cwd, ".pai", "harness.json");
-  if (!await fs19.pathExists(harnessPath)) {
-    return { enabled: false, specFile: null, rules: [], checks: [] };
+import { createHash } from "crypto";
+function computeRepoHash(repoPath) {
+  const hash = createHash("sha256");
+  for (const file of FILES_TO_HASH) {
+    const fullPath = join11(repoPath, file);
+    try {
+      const content = readFileSync(fullPath);
+      hash.update(`${file}:${content.length}`);
+    } catch {
+      hash.update(`${file}:missing`);
+    }
   }
-  let config;
+  return hash.digest("hex").slice(0, 16);
+}
+function getCachePath(repoPath) {
+  return join11(repoPath, CACHE_DIR, CACHE_FILE);
+}
+function loadCache(repoPath) {
   try {
-    config = await fs19.readJson(harnessPath);
+    const data = readFileSync(getCachePath(repoPath), "utf-8");
+    return JSON.parse(data);
   } catch {
-    return { enabled: false, specFile: null, rules: [], checks: [] };
-  }
-  const specFile = config.specFile ?? "docs/openspec.md";
-  const rules = config.rules ?? [];
-  const checks = [];
-  if (rules.includes("spec-implementation-match")) {
-    const specExists = await fs19.pathExists(join11(cwd, specFile));
-    const srcExists = await fs19.pathExists(join11(cwd, "src"));
-    checks.push({
-      rule: "spec-implementation-match",
-      passed: specExists && srcExists,
-      detail: specExists && srcExists ? "\uC124\uACC4 \uBB38\uC11C\uC640 \uC18C\uC2A4 \uB514\uB809\uD1A0\uB9AC \uC874\uC7AC" : `${!specExists ? specFile + " \uC5C6\uC74C" : ""} ${!srcExists ? "src/ \uC5C6\uC74C" : ""}`.trim()
-    });
-  }
-  if (rules.includes("api-contract-test")) {
-    const testDir = await fs19.pathExists(join11(cwd, "tests"));
-    const testDir2 = await fs19.pathExists(join11(cwd, "test"));
-    checks.push({
-      rule: "api-contract-test",
-      passed: testDir || testDir2,
-      detail: testDir || testDir2 ? "\uD14C\uC2A4\uD2B8 \uB514\uB809\uD1A0\uB9AC \uC874\uC7AC" : "\uD14C\uC2A4\uD2B8 \uB514\uB809\uD1A0\uB9AC(tests/ \uB610\uB294 test/) \uC5C6\uC74C"
-    });
+    return { version: 1, entries: {} };
   }
-  return { enabled: true, specFile, rules, checks };
 }
-var init_harness = __esm({
-  "src/stages/validation/harness.ts"() {
-    "use strict";
-  }
-});
-
-// src/cli/commands/validate.cmd.ts
-var validate_cmd_exports = {};
-__export(validate_cmd_exports, {
-  handleRobocoCliError: () => handleRobocoError,
-  validateCommand: () => validateCommand
-});
-async function validateCommand(cwd, options = {}) {
-  try {
-    await withRoboco(
-      cwd,
-      "validation",
-      "pai test",
-      { skipGates: options.skipGates, force: options.force, gate: STAGE_GATES.validation },
-      async () => {
-        section("\uD14C\uC2A4\uD2B8 \uC2E4\uD589");
-        const testResult = await runTests(cwd);
-        if (testResult.passed) {
-          success(`\uD14C\uC2A4\uD2B8 \uD1B5\uACFC (${testResult.runner}, ${testResult.duration}ms)`);
-        } else {
-          error("\uD14C\uC2A4\uD2B8 \uC2E4\uD328");
-          info(testResult.output.slice(0, 300));
-        }
-        section("\uD558\uB124\uC2A4 \uAC80\uC99D");
-        const harness = await runHarnessCheck(cwd);
-        if (!harness.enabled) {
-          info("Harness \uC124\uC815 \uC5C6\uC74C \u2014 \uAC74\uB108\uB700");
-          info("\uC124\uC815 \uCD94\uAC00: `pai add` \uC5D0\uC11C Harness Engineering \uC120\uD0DD");
-        } else {
-          for (const check of harness.checks) {
-            if (check.passed) {
-              success(`${check.rule}: ${check.detail}`);
-            } else {
-              warn(`${check.rule}: ${check.detail}`);
-            }
-          }
-        }
-        const allPassed = testResult.passed && harness.checks.every((c2) => c2.passed);
-        console.log("");
-        if (allPassed) {
-          success("\uAC80\uC99D \uD1B5\uACFC!");
-        } else if (!testResult.passed) {
-          error("\uAC80\uC99D \uC2E4\uD328 \u2014 \uD14C\uC2A4\uD2B8\uB97C \uC218\uC815\uD558\uC138\uC694.");
-          throw new Error("tests-failed");
-        } else {
-          warn("\uBD80\uBD84 \uD1B5\uACFC \u2014 \uD558\uB124\uC2A4 \uAC80\uC99D \uD56D\uBAA9\uC744 \uD655\uC778\uD558\uC138\uC694.");
-        }
-      }
-    );
-    await syncHandoff(cwd).catch(() => {
-    });
-  } catch (err) {
-    handleRobocoError(err);
+function saveCache(repoPath, store) {
+  const cacheDir = join11(repoPath, CACHE_DIR, "cache");
+  if (!existsSync(cacheDir)) {
+    mkdirSync(cacheDir, { recursive: true });
   }
+  writeFileSync(getCachePath(repoPath), JSON.stringify(store, null, 2));
 }
-function handleRobocoError(err) {
-  if (err instanceof RobocoLockError) {
-    error(err.message);
-    process.exitCode = 1;
-    return;
-  }
-  if (err instanceof GateFailedError) {
-    error(`\uB2E8\uACC4 \uC9C4\uC785 \uC2E4\uD328 (${err.result.name})`);
-    for (const v of err.result.violations) {
-      warn(`  \xB7 ${v.message}${v.location ? ` [${v.location}]` : ""}`);
-    }
-    hint("\uC6B0\uD68C \uC635\uC158: --skip-gates (\uACBD\uACE0\uB9CC) / --force (\uAC8C\uC774\uD2B8 \uBB34\uC2DC)");
-    process.exitCode = 1;
-    return;
-  }
-  if (err instanceof Error) {
-    if (err.message === "tests-failed") {
-      process.exitCode = 1;
-      return;
+function getCachedResult(repoPath) {
+  const store = loadCache(repoPath);
+  const repoHash = computeRepoHash(repoPath);
+  const entry = store.entries[repoHash];
+  if (!entry) return null;
+  if (Date.now() - entry.timestamp > CACHE_TTL_MS) return null;
+  return entry.llmOutput;
+}
+function setCachedResult(repoPath, llmOutput) {
+  const store = loadCache(repoPath);
+  const repoHash = computeRepoHash(repoPath);
+  const now2 = Date.now();
+  for (const [key, entry] of Object.entries(store.entries)) {
+    if (now2 - entry.timestamp > CACHE_TTL_MS) {
+      delete store.entries[key];
     }
-    error(err.message);
-    process.exitCode = 1;
-    return;
   }
-  throw err;
+  store.entries[repoHash] = { repoPath, repoHash, timestamp: now2, llmOutput };
+  saveCache(repoPath, store);
 }
-var init_validate_cmd = __esm({
-  "src/cli/commands/validate.cmd.ts"() {
+var CACHE_DIR, CACHE_FILE, CACHE_TTL_MS, FILES_TO_HASH;
+var init_cache = __esm({
+  "src/stages/evaluation/cache.ts"() {
     "use strict";
-    init_ui();
-    init_runner();
-    init_harness();
-    init_roboco();
-    init_gates();
+    CACHE_DIR = ".pai";
+    CACHE_FILE = "cache/evaluation.json";
+    CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
+    FILES_TO_HASH = [
+      "package.json",
+      "pyproject.toml",
+      "go.mod",
+      "Cargo.toml",
+      "tsconfig.json",
+      "jest.config.ts",
+      "vitest.config.ts",
+      ".github/workflows",
+      ".gitlab-ci.yml",
+      ".husky",
+      ".lintstagedrc",
+      "CLAUDE.md",
+      "AGENTS.md",
+      ".cursorrules",
+      "README.md",
+      "CONTRIBUTING.md"
+    ];
   }
 });
 
@@ -6097,7 +6234,24 @@ async function setupInDirectory(projectDir, projectName) {
     config,
     previousResults: /* @__PURE__ */ new Map()
   };
-  const result = await environmentStage.run(input);
+  let stageResult;
+  try {
+    await withRoboco(
+      projectDir,
+      "environment",
+      "pai init",
+      {},
+      async () => {
+        stageResult = await environmentStage.run(input);
+      }
+    );
+    await syncHandoff(projectDir).catch(() => {
+    });
+  } catch (err) {
+    handleRobocoError(err);
+    return;
+  }
+  const result = stageResult;
   if (result.status === "success") {
     try {
       const { requestCdAfter: requestCdAfter2 } = await Promise.resolve().then(() => (init_shell_cd(), shell_cd_exports));
@@ -6520,6 +6674,8 @@ var init_init_cmd = __esm({
     init_environment();
     init_config();
     init_detector();
+    init_roboco();
+    init_validate_cmd();
     init_ui();
     init_logger();
   }
@@ -7123,6 +7279,29 @@ async function runPipeline(cwd, config, options = {}) {
       config,
       previousResults: ctx.getResults()
     };
+    if (!options.force) {
+      const gateResult = await STAGE_GATES[stageName](cwd).catch(() => null);
+      if (gateResult) {
+        await saveGateResult(cwd, `${stageName}.entry`, gateResult).catch(() => {
+        });
+        if (!gateResult.passed && !options.skipGates) {
+          error(`${stageName} \uAC8C\uC774\uD2B8 \uC2E4\uD328 \u2014 \uD30C\uC774\uD504\uB77C\uC778 \uC911\uB2E8`);
+          for (const v of gateResult.violations) {
+            warn(`  \xB7 ${v.message}${v.location ? ` [${v.location}]` : ""}`);
+          }
+          hint("\uC6B0\uD68C: pai run --skip-gates (\uACBD\uACE0) / --force (\uBB34\uC2DC)");
+          await markStageEnd(cwd, stageName, false, `\uAC8C\uC774\uD2B8 \uC2E4\uD328: ${gateResult.name}`).catch(() => {
+          });
+          shouldStop = true;
+          break;
+        }
+        if (!gateResult.passed && options.skipGates) {
+          for (const v of gateResult.violations) {
+            warn(`  [\uAC8C\uC774\uD2B8 \uACBD\uACE0] ${v.message}`);
+          }
+        }
+      }
+    }
     if (stage.canSkip(input)) {
       info(`${stageName} \u2014 \uAC74\uB108\uB700 (\uC774\uBBF8 \uC644\uB8CC)`);
       ctx.setResult(stageName, {
@@ -7135,8 +7314,14 @@ async function runPipeline(cwd, config, options = {}) {
       });
       continue;
     }
+    await markStageStart(cwd, stageName, "pai run").catch(() => {
+    });
     const result = await stage.run(input);
     ctx.setResult(stageName, result);
+    const stageSuccess = result.status !== "failed";
+    const failReason = result.errors[0]?.message;
+    await markStageEnd(cwd, stageName, stageSuccess, failReason).catch(() => {
+    });
     switch (result.status) {
       case "success":
         success(`${stageName} \uC644\uB8CC (${result.duration}ms)`);
@@ -7184,6 +7369,8 @@ var init_pipeline = __esm({
     init_execution();
     init_validation();
     init_evaluation();
+    init_roboco();
+    init_gates();
     init_ui();
     STAGES = {
       environment: environmentStage,
@@ -7203,23 +7390,17 @@ __export(pipeline_cmd_exports, {
 async function pipelineCommand(cwd, options) {
   printBanner();
   try {
-    await withRoboco(
-      cwd,
-      "environment",
-      "pai run",
-      {
-        skipGates: options.skipGates,
-        force: options.force,
-        ttlMs: PIPELINE_TTL_MS
-      },
-      async () => {
-        const config = await loadConfig(cwd) ?? createDefaultConfig("my-project", "prototype");
-        const pipelineOpts = {};
-        if (options.from) pipelineOpts.from = options.from;
-        if (options.only) pipelineOpts.only = options.only.split(",").map((s) => s.trim());
-        await runPipeline(cwd, config, pipelineOpts);
-      }
-    );
+    await acquireLock(cwd, "environment", "pai run", PIPELINE_TTL_MS);
+    try {
+      const config = await loadConfig(cwd) ?? createDefaultConfig("my-project", "prototype");
+      const pipelineOpts = { skipGates: options.skipGates, force: options.force };
+      if (options.from) pipelineOpts.from = options.from;
+      if (options.only) pipelineOpts.only = options.only.split(",").map((s) => s.trim());
+      await runPipeline(cwd, config, pipelineOpts);
+    } finally {
+      await releaseLock(cwd).catch(() => {
+      });
+    }
     await syncHandoff(cwd).catch(() => {
     });
   } catch (err) {