pai-zero 0.12.0 → 0.13.0

package/dist/bin/pai.js

@@ -890,20 +890,22 @@ function generateClaudeMd(cwd, analysis, interview) {
 
 ## Project Overview
 
-Describe your project here.
+<!-- TODO: \uC774 \uD504\uB85C\uC81D\uD2B8\uAC00 \uBB34\uC5C7\uC744 \uD574\uACB0\uD558\uB294\uC9C0 2-3\uBB38\uC7A5\uC73C\uB85C \uAE30\uC220. \uC0C1\uC138 \uB0B4\uC6A9\uC740 docs/openspec.md \uCC38\uC870. -->
+
+\uC790\uC138\uD55C \uC81C\uD488 \uC694\uAD6C\uC0AC\uD56D: \`docs/openspec.md\` \xB7 \uB3C4\uBA54\uC778 \uBAA8\uB378: \`.pai/omc.md\`
 
 <pai>
 ## PAI Configuration
 
 This project uses PAI (Plugin-based AI) for structured AI development.
 
-### Pipeline: \uC124\uACC4-\uC2E4\uD589-\uAC80\uC99D-\uD3C9\uAC00-\uD658\uACBD
+### Pipeline: Environment \u2192 Design \u2192 Execution \u2192 Validation \u2192 Evaluation
 
-1. **Environment** \u2014 \uD504\uB85C\uC81D\uD2B8 \uD658\uACBD \uAD6C\uC131 (\uC774 \uB2E8\uACC4)
-2. **Design** \u2014 OpenSpec/OMC \uAE30\uBC18 \uC124\uACC4
-3. **Execution** \u2014 AI \uCF54\uB4DC \uC0DD\uC131
-4. **Validation** \u2014 gstack \uD14C\uC2A4\uD2B8 / harness \uAC80\uC99D
-5. **Evaluation** \u2014 \uD488\uC9C8 \uD3C9\uAC00 (6\uCE74\uD14C\uACE0\uB9AC)
+1. **Environment** \u2014 \uD504\uB85C\uC81D\uD2B8 \uD658\uACBD \uAD6C\uC131 (\uC644\uB8CC)
+2. **Design** \u2014 OpenSpec (\`docs/openspec.md\`) + OMC (\`.pai/omc.md\`) \uAE30\uBC18 \uC124\uACC4
+3. **Execution** \u2014 AI \uCF54\uB4DC \uC0DD\uC131 (\uC774 \uB2E8\uACC4 Claude\uAC00 \uB2F4\uB2F9)
+4. **Validation** \u2014 gstack \uD14C\uC2A4\uD2B8 + harness(\uC124\uACC4\u2194\uAD6C\uD604) \uAC80\uC99D
+5. **Evaluation** \u2014 6\uCE74\uD14C\uACE0\uB9AC \uD488\uC9C8 \uD3C9\uAC00
 
 ### Stack
 - **Languages**: ${stack}
@@ -911,15 +913,30 @@ This project uses PAI (Plugin-based AI) for structured AI development.
 - **Mode**: ${interview.mode}
 - **Config**: \`.pai/config.json\`
 
-Run \`pai env status\` to check setup, \`pai evaluate\` for quality scoring.
+### \uD50C\uB7EC\uADF8\uC778 \uAC04 \uACC4\uC57D (\uD30C\uC774\uD504\uB77C\uC778 \uC5E3\uC9C0)
+
+\`.pai/config.json\`\uC758 \`edges\` \uBC30\uC5F4\uC774 \uD50C\uB7EC\uADF8\uC778 \uAC04 \uBA85\uC2DC\uC801 \uACC4\uC57D\uC744 \uC815\uC758\uD569\uB2C8\uB2E4.
+\uCF54\uB4DC \uC791\uC131 \uC2DC \uBC18\uB4DC\uC2DC \uACC4\uC57D\uC744 \uC9C0\uD0A4\uC138\uC694:
+
+- **harness \u2192 openspec**: \`docs/openspec.md\`\uC758 \uC5D4\uB4DC\uD3EC\uC778\uD2B8 \uD14C\uC774\uBE14\uC774 \uAD6C\uD604\uACFC \uC77C\uCE58\uD574\uC57C \uD568 (\`pai test\` \uC2E4\uD328)
+- **gstack \u2192 openspec**: \uAC01 \uC5D4\uB4DC\uD3EC\uC778\uD2B8\uB294 \uD14C\uC2A4\uD2B8\uAC00 \uC874\uC7AC\uD574\uC57C \uD568
+- **omc \u2192 openspec**: \uB3C4\uBA54\uC778 \uAC1D\uCCB4\uB294 API \uC694\uCCAD/\uC751\uB2F5 \uBAA8\uB378\uACFC \uC815\uD569 (\uC0C8 \uC5D4\uB4DC\uD3EC\uC778\uD2B8 \uCD94\uAC00 \uC2DC omc.md\uB3C4 \uC5C5\uB370\uC774\uD2B8)
+- **harness \u2192 omc**: \`.pai/omc.md\`\uC758 \uBE44\uC988\uB2C8\uC2A4 \uADDC\uCE59\uC774 \uCF54\uB4DC\uB85C \uAD6C\uD604\uB418\uC5B4\uC57C \uD568
 
 ### Global Rules
 
-- **\uC2EC\uCE35 \uC778\uD130\uBDF0 \uC790\uB3D9 \uC218\uD589**: \uCEE8\uD14D\uC2A4\uD2B8\uAC00 \uBD80\uC871\uD558\uAC70\uB098 \uBAA8\uD638\uD55C \uACBD\uC6B0, AskUserQuestion \uB3C4\uAD6C\uB97C \uC0AC\uC6A9\uD558\uC5EC \uC2EC\uCE35 \uC778\uD130\uBDF0\uB97C \uC790\uB3D9\uC73C\uB85C \uC9C4\uD589\uD569\uB2C8\uB2E4. \uCD94\uCE21\uD558\uC9C0 \uB9D0\uACE0 \uBC18\uB4DC\uC2DC \uC9C8\uBB38\uD558\uC138\uC694.
-- **Ideation \u2192 PRD \uD30C\uC774\uD504\uB77C\uC778**: \`/pai design\` \uC2E4\uD589 \uC2DC ideation.md \u2192 openspec.md \uC21C\uC11C\uB85C \uC2EC\uCE35 \uC778\uD130\uBDF0\uB97C \uD1B5\uD574 \uC791\uC131\uD569\uB2C8\uB2E4.
-- **\uAE30\uC220 \uC81C\uC57D \uD30C\uC545**: \uCF54\uB4DC \uC0DD\uC131 \uC804 \uAE30\uC220\uC801 \uC81C\uC57D \uC0AC\uD56D\uC744 \uC2EC\uCE35 \uC778\uD130\uBDF0\uB85C \uD655\uC778\uD569\uB2C8\uB2E4.
-- **\uD558\uB124\uC2A4 \uC5D4\uC9C0\uB2C8\uC5B4\uB9C1**: AI \uC5D0\uC774\uC804\uD2B8\uAC00 \uC548\uC804\uD558\uAC8C \uC791\uC5C5\uD560 \uC218 \uC788\uB3C4\uB85D \uD14C\uC2A4\uD2B8/\uAC80\uC99D \uD658\uACBD\uC744 \uAD6C\uC131\uD569\uB2C8\uB2E4.
-- **Git \uCEE4\uBC0B \uADDC\uCE59**: \uC791\uC5C5 \uB2E8\uC704\uBCC4\uB85C \uC758\uBBF8 \uC788\uB294 \uCEE4\uBC0B \uBA54\uC2DC\uC9C0\uB97C \uC791\uC131\uD569\uB2C8\uB2E4.
+- **\uC2EC\uCE35 \uC778\uD130\uBDF0 \uC790\uB3D9 \uC218\uD589**: \uBAA8\uD638\uD55C \uACBD\uC6B0 AskUserQuestion\uC73C\uB85C \uC989\uC2DC \uC9C8\uBB38. \uCD94\uCE21 \uAE08\uC9C0.
+- **\uC124\uACC4 \uBA3C\uC800**: \uCF54\uB4DC \uC804 \`docs/openspec.md\`\uB97C \uBA3C\uC800 \uC77D\uACE0, \uD544\uC694\uD55C \uC5D4\uB4DC\uD3EC\uC778\uD2B8/\uBAA8\uB378\uC744 \uC815\uC758.
+- **\uACC4\uC57D \uC591\uBC29\uD5A5 \uC5C5\uB370\uC774\uD2B8**: API \uCD94\uAC00 \uC2DC openspec.md + omc.md \uB3D9\uC2DC \uC218\uC815. \uD558\uB098\uB9CC \uC5C5\uB370\uC774\uD2B8\uD558\uB294 PR \uAE08\uC9C0.
+- **\uAC80\uC99D \uC6B0\uC120**: \`pai test\` \uC2E4\uD328 \uC2DC \uC218\uC815 \uBC94\uC704\uB97C \uC881\uD788\uACE0 \uC6D0\uC778\uC744 \uC815\uD655\uD788 \uC774\uD574\uD560 \uAC83. \`--skip\`/ disable \uAE08\uC9C0.
+- **Git \uCEE4\uBC0B \uADDC\uCE59**: \uC791\uC5C5 \uB2E8\uC704\uBCC4\uB85C \uC758\uBBF8 \uC788\uB294 \uCEE4\uBC0B \uBA54\uC2DC\uC9C0.
+
+### \uBA85\uB839\uC5B4
+
+- \`pai status\` \u2014 \uD604\uC7AC \uD50C\uB7EC\uADF8\uC778/\uBAA8\uB4DC \uD655\uC778
+- \`pai test\` \u2014 \uD14C\uC2A4\uD2B8 + \uD558\uB124\uC2A4 \uAC80\uC99D
+- \`pai grade\` \u2014 6\uCE74\uD14C\uACE0\uB9AC \uD488\uC9C8 \uD3C9\uAC00
+- \`pai add\` \u2014 \uD50C\uB7EC\uADF8\uC778 \uCD94\uAC00 / \uBAA8\uB4DC \uC2B9\uACA9
 
 ### Contribution Guide
 
@@ -2070,34 +2087,33 @@ async function provisionGitHub(ctx) {
   await Promise.all(dirs.map((d) => fs7.ensureDir(join4(ctx.cwd, d))));
   const handoffPath = join4(ctx.cwd, "handoff.md");
   if (!await fs7.pathExists(handoffPath)) {
-    const now = (/* @__PURE__ */ new Date()).toLocaleString("ko-KR");
+    const now2 = (/* @__PURE__ */ new Date()).toLocaleString("ko-KR");
     await fs7.writeFile(handoffPath, [
       `# Handoff \u2014 ${ctx.projectName}`,
       "",
-      `> \uB9C8\uC9C0\uB9C9 \uC5C5\uB370\uC774\uD2B8: ${now}`,
+      `> \uB9C8\uC9C0\uB9C9 \uC5C5\uB370\uC774\uD2B8: ${now2}`,
+      `> **\uCC38\uACE0**: \`<!-- roboco:start -->\` \uBE14\uB85D\uC740 \uD30C\uC774\uD504\uB77C\uC778 \uC9C4\uD589 \uC2DC \uC790\uB3D9 \uAC31\uC2E0\uB429\uB2C8\uB2E4.`,
+      `>          \uADF8 \uC678 \uC139\uC158(\uB2E4\uC74C \uB2E8\uACC4, \uBA54\uBAA8)\uC740 \uC790\uC720\uB86D\uAC8C \uC218\uB3D9 \uD3B8\uC9D1 \uAC00\uB2A5.`,
       "",
-      "## \uC9C4\uD589 \uC911",
-      "- [ ] Ideation \uBB38\uC11C \uC791\uC131 \u2014 \uC2EC\uCE35 \uC778\uD130\uBDF0\uB97C \uD1B5\uD574 \uC544\uC774\uB514\uC5B4\uB97C \uAD6C\uCCB4\uD654 (\uB2F4\uB2F9: PAI > Design)",
+      "<!-- roboco:start -->",
+      "## \uD30C\uC774\uD504\uB77C\uC778 \uC9C4\uD589 \uC0C1\uD0DC (roboco \uC790\uB3D9 \uAD00\uB9AC)",
       "",
-      "## \uB2E4\uC74C \uB2E8\uACC4",
-      "- [ ] Ideation \uAE30\uBC18 PRD \uC791\uC131 \u2014 \uC2EC\uCE35 \uC778\uD130\uBDF0\uB85C \uB9E5\uB77D/\uAE30\uC220 \uC81C\uC57D \uBCF4\uAC15",
-      "- [ ] \uD558\uB124\uC2A4 \uC5D4\uC9C0\uB2C8\uC5B4\uB9C1 \uAD6C\uC131 \uD655\uC778 \u2014 \uC5D0\uC774\uC804\uD2B8 \uC791\uC5C5 \uD658\uACBD \uAC80\uC99D",
-      "- [ ] AI \uCF54\uB4DC \uC0DD\uC131 \uC2DC\uC791",
+      "\uD604\uC7AC \uB2E8\uACC4: **environment**",
       "",
-      "## \uC644\uB8CC",
-      `- [x] \uD504\uB85C\uC81D\uD2B8 \uCD08\uAE30\uD654 (${now}) (\uB2F4\uB2F9: PAI > Environment)`,
+      "### \uC644\uB8CC",
+      `- [x] environment (pai init, ${now2.slice(0, 10)})`,
+      "<!-- roboco:end -->",
       "",
-      "## \uC791\uC5C5 \uD30C\uC774\uD504\uB77C\uC778",
-      "```",
-      "1. /pai design \u2192 Ideation \uC2EC\uCE35 \uC778\uD130\uBDF0 \u2192 docs/ideation.md \uC0DD\uC131",
-      "2. /pai design \u2192 PRD \uC2EC\uCE35 \uC778\uD130\uBDF0 \u2192 docs/openspec.md \uC791\uC131",
-      "3. /pai design \u2192 \uAE30\uC220 \uC81C\uC57D \uC2EC\uCE35 \uC778\uD130\uBDF0 \u2192 \uD558\uB124\uC2A4 \uC5D4\uC9C0\uB2C8\uC5B4\uB9C1 \uD655\uC778",
-      "4. AI \uCF54\uB4DC \uC0DD\uC131 \u2192 \uAC80\uC99D \u2192 \uD3C9\uAC00",
-      "```",
+      "## \uB2E4\uC74C \uB2E8\uACC4",
+      "- [ ] `/pai design` \u2014 Ideation + PRD \uC2EC\uCE35 \uC778\uD130\uBDF0",
+      "- [ ] Claude Code\uB85C \uCF54\uB4DC \uC0DD\uC131",
+      "- [ ] `pai test` \u2014 \uD14C\uC2A4\uD2B8 + \uD558\uB124\uC2A4 \uAC80\uC99D",
+      "- [ ] `pai grade` \u2014 AI \uC900\uBE44\uB3C4 6\uCE74\uD14C\uACE0\uB9AC \uD3C9\uAC00",
       "",
       "## \uBA54\uBAA8",
       `- \uBAA8\uB4DC: ${ctx.mode}`,
-      "- \uCEE8\uD14D\uC2A4\uD2B8\uAC00 \uBD80\uC871\uD558\uBA74 AI\uAC00 \uC790\uB3D9\uC73C\uB85C \uC2EC\uCE35 \uC778\uD130\uBDF0\uB97C \uC9C4\uD589\uD569\uB2C8\uB2E4"
+      "- \uCEE8\uD14D\uC2A4\uD2B8\uAC00 \uBD80\uC871\uD558\uBA74 AI\uAC00 \uC790\uB3D9\uC73C\uB85C \uC2EC\uCE35 \uC778\uD130\uBDF0\uB97C \uC9C4\uD589\uD569\uB2C8\uB2E4",
+      "- \uB77D \uCDA9\uB3CC \uC2DC \uC989\uC2DC \uC2E4\uD328 (\uB2E4\uB978 PAI \uBA85\uB839\uC774 \uC9C4\uD589 \uC911\uC774\uBA74 \uC644\uB8CC \uD6C4 \uC7AC\uC2DC\uB3C4)"
     ].join("\n") + "\n");
   }
   const contribPath = join4(ctx.cwd, "CONTRIBUTING.md");
@@ -2244,54 +2260,189 @@ async function provisionSupabase(ctx) {
 async function provisionOpenSpec(ctx) {
   await fs7.ensureDir(join4(ctx.cwd, "docs"));
   const openspecPath = join4(ctx.cwd, "docs", "openspec.md");
-  if (!await fs7.pathExists(openspecPath)) {
-    await fs7.writeFile(openspecPath, [
-      `# OpenSpec \u2014 ${ctx.projectName}`,
-      "",
-      "## 1. \uBAA9\uC801 (Purpose)",
-      "> \uC774 \uC11C\uBE44\uC2A4\uB294 \uBB34\uC5C7\uC744 \uD574\uACB0\uD558\uB294\uAC00?",
-      "",
-      "## 2. \uC0AC\uC6A9\uC790 (Users)",
-      "| \uC5ED\uD560 | \uC124\uBA85 |",
-      "|------|------|",
-      "| - | - |",
-      "",
-      "## 3. \uD575\uC2EC \uAE30\uB2A5 (Features)",
-      "- [ ] Feature 1",
+  if (await fs7.pathExists(openspecPath)) return;
+  const langs = ctx.analysis?.stack.languages ?? [];
+  const frameworks = ctx.analysis?.stack.frameworks ?? [];
+  const pkgMgr = ctx.analysis?.stack.packageManager;
+  const frontendFrameworks = frameworks.filter(
+    (f) => ["React", "Vue", "Next.js", "Nuxt", "Svelte", "Angular"].includes(f)
+  );
+  const backendFrameworks = frameworks.filter(
+    (f) => ["Express", "Fastify", "NestJS", "Koa", "Django", "Flask", "FastAPI", "Rails", "Spring"].includes(f)
+  );
+  const frontendLine = frontendFrameworks.length > 0 ? frontendFrameworks.join(" + ") : "<!-- TODO: \uD504\uB860\uD2B8\uC5D4\uB4DC \uD504\uB808\uC784\uC6CC\uD06C (React / Vue / Next.js \uB4F1) -->";
+  const backendLine = backendFrameworks.length > 0 ? backendFrameworks.join(" + ") : langs.includes("TypeScript") || langs.includes("JavaScript") ? "<!-- TODO: Node.js \uBC31\uC5D4\uB4DC \uD504\uB808\uC784\uC6CC\uD06C (Express / Fastify / NestJS \uB4F1) -->" : "<!-- TODO: \uBC31\uC5D4\uB4DC \uD504\uB808\uC784\uC6CC\uD06C -->";
+  const modeHint = ctx.mode === "prototype" ? "\uD504\uB85C\uD1A0\uD0C0\uC785 \u2014 \uBE60\uB978 \uAC80\uC99D \uBAA9\uC801. \uD575\uC2EC \uC2DC\uB098\uB9AC\uC624 1-2\uAC1C\uB9CC \uC815\uC758\uD574\uB3C4 \uCDA9\uBD84." : ctx.mode === "poc" ? "PoC \u2014 \uB3D9\uC791 \uB370\uBAA8. \uC8FC\uC694 \uAE30\uB2A5 3-5\uAC1C + \uD575\uC2EC API \uC5D4\uB4DC\uD3EC\uC778\uD2B8 \uC815\uC758 \uD544\uC694." : "\uC6B4\uC601 \u2014 \uD14C\uC2A4\uD2B8/QA \uB300\uC0C1. \uBAA8\uB4E0 \uAE30\uB2A5\uACFC API \uACC4\uC57D\uC744 \uC644\uC804\uD788 \uC815\uC758\uD574\uC57C \uD568.";
+  await fs7.writeFile(openspecPath, [
+    `# OpenSpec \u2014 ${ctx.projectName}`,
+    "",
+    `> **\uBAA8\uB4DC**: ${ctx.mode} \xB7 ${modeHint}`,
+    `> **\uC704\uCE58**: \uC774 \uBB38\uC11C\uAC00 \uD30C\uC774\uD504\uB77C\uC778\uC758 \uC911\uC559 \uD5C8\uBE0C\uC785\uB2C8\uB2E4 \u2014 gstack, harness, omc\uAC00 \uBAA8\uB450 \uCC38\uC870.`,
+    `> **\uC791\uC131 \uAC00\uC774\uB4DC**: \`/pai design\` \uC2E4\uD589 \uC2DC Claude\uAC00 \uC2EC\uCE35 \uC778\uD130\uBDF0\uB85C \uBE48 \uC139\uC158\uC744 \uCC44\uC6C1\uB2C8\uB2E4.`,
+    "",
+    "---",
+    "",
+    "## 1. \uBAA9\uC801 (Purpose)",
+    "",
+    "<!-- TODO: \uC774 \uC11C\uBE44\uC2A4\uAC00 \uBB34\uC5C7\uC744 \uD574\uACB0\uD558\uB294\uC9C0 2-3\uBB38\uC7A5\uC73C\uB85C \uAE30\uC220 -->",
+    "<!-- \uC608\uC2DC:",
+    "     - \uB204\uAD6C\uC758 \uC5B4\uB5A4 \uBB38\uC81C\uB97C \uD574\uACB0\uD558\uB294\uAC00?",
+    "     - \uAE30\uC874 \uB300\uC548(\uC788\uB2E4\uBA74) \uB300\uBE44 \uCC28\uBCC4\uC810\uC740?",
+    "-->",
+    "",
+    "## 2. \uC0AC\uC6A9\uC790 (Users)",
+    "",
+    "<!-- TODO: \uC2E4\uC81C \uC0AC\uC6A9\uC790 \uC5ED\uD560\uC744 \uC815\uC758 \u2014 role, \uAD8C\uD55C, \uC8FC\uC694 \uC0AC\uC6A9 \uC2DC\uB098\uB9AC\uC624 -->",
+    "",
+    "| \uC5ED\uD560 | \uAD8C\uD55C | \uC8FC\uC694 \uC0AC\uC6A9 \uC2DC\uB098\uB9AC\uC624 |",
+    "|------|------|-------------------|",
+    "| \uC77C\uBC18 \uC0AC\uC6A9\uC790 | \uC77D\uAE30/\uC4F0\uAE30 | (\uC608: \uAC8C\uC2DC\uAE00 \uC791\uC131, \uAC80\uC0C9) |",
+    "| \uAD00\uB9AC\uC790 | \uC804\uCCB4 | (\uC608: \uC0AC\uC6A9\uC790 \uAD00\uB9AC, \uD1B5\uACC4 \uC870\uD68C) |",
+    "",
+    "## 3. \uD575\uC2EC \uAE30\uB2A5 (Features)",
+    "",
+    "<!-- TODO: MVP \uAE30\uB2A5 \uBAA9\uB85D. \uCCB4\uD06C\uBC15\uC2A4\uB85C \uC9C4\uD589\uC0C1\uD0DC \uD45C\uC2DC -->",
+    "",
+    "- [ ] \uC0AC\uC6A9\uC790 \uC778\uC99D (\uB85C\uADF8\uC778/\uB85C\uADF8\uC544\uC6C3)",
+    "- [ ] \uD575\uC2EC \uAE30\uB2A5 1",
+    "- [ ] \uD575\uC2EC \uAE30\uB2A5 2",
+    "",
+    "## 4. \uAE30\uC220 \uC2A4\uD0DD (Stack)",
+    "",
+    `- **Language**: ${langs.length > 0 ? langs.join(", ") : "<!-- TODO: \uC5B8\uC5B4 -->"}`,
+    `- **Frontend**: ${frontendLine}`,
+    `- **Backend**: ${backendLine}`,
+    `- **Database**: <!-- TODO: PostgreSQL / MySQL / SQLite / MongoDB \uB4F1 -->`,
+    `- **Package Manager**: ${pkgMgr ?? "<!-- TODO -->"}`,
+    `- **Deployment**: <!-- TODO: Vercel / AWS / Docker \uB4F1 -->`,
+    "",
+    "## 5. API \uC5D4\uB4DC\uD3EC\uC778\uD2B8 (Endpoints)",
+    "",
+    "<!-- \uC911\uC694: \uC774 \uD45C\uAC00 gstack \uD14C\uC2A4\uD2B8 \uD0C0\uAC9F + harness \uAC80\uC99D \uD0C0\uAC9F\uC785\uB2C8\uB2E4.",
+    "     \uC2E0\uADDC \uC5D4\uB4DC\uD3EC\uC778\uD2B8 \uCD94\uAC00 \uC2DC \uBC18\uB4DC\uC2DC \uC5EC\uAE30 \uBA3C\uC800 \uC120\uC5B8. -->",
+    "",
+    "| Method | Path | \uC124\uBA85 | \uC694\uCCAD \uBAA8\uB378 | \uC751\uB2F5 \uBAA8\uB378 |",
+    "|--------|------|------|-----------|-----------|",
+    "| GET    | /api/health | \uD5EC\uC2A4\uCCB4\uD06C | - | `{ ok: true }` |",
+    "| POST   | /api/auth/login | \uB85C\uADF8\uC778 | `{ email, password }` | `{ token }` |",
+    "<!-- TODO: \uD504\uB85C\uC81D\uD2B8 \uACE0\uC720 \uC5D4\uB4DC\uD3EC\uC778\uD2B8 \uCD94\uAC00 -->",
+    "",
+    "## 6. \uBE44\uAE30\uB2A5 \uC694\uAD6C\uC0AC\uD56D (\uC120\uD0DD)",
+    "",
+    "<!-- TODO: \uC131\uB2A5/\uBCF4\uC548/\uD655\uC7A5\uC131 \uC694\uAD6C \u2014 production \uBAA8\uB4DC\uC5D0\uC11C \uAD8C\uC7A5 -->",
+    "",
+    "---",
+    "",
+    "## \uD30C\uC774\uD504\uB77C\uC778 \uACC4\uC57D (\uC774 \uBB38\uC11C\uAC00 \uCC38\uC870\uB418\uB294 \uACF3)",
+    "",
+    "- `harness.json` \u2192 `specFile`\uB85C \uC774 \uBB38\uC11C \uCC38\uC870 (\uC124\uACC4\u2194\uAD6C\uD604 \uC77C\uCE58 \uAC80\uC99D)",
+    "- `gstack.json` \u2192 \uAC01 \uC5D4\uB4DC\uD3EC\uC778\uD2B8\uC5D0 \uB300\uD55C \uD14C\uC2A4\uD2B8 \uC874\uC7AC \uD655\uC778",
+    "- `.pai/omc.md` \u2192 \uB3C4\uBA54\uC778 \uAC1D\uCCB4\uAC00 \uC694\uCCAD/\uC751\uB2F5 \uBAA8\uB378\uACFC \uC815\uD569\uD558\uB294\uC9C0 \uD655\uC778",
+    ""
+  ].join("\n") + "\n");
+}
+function buildOMCSkeleton(projectName, mode) {
+  const lines = [
+    `# OMC \u2014 Object Model Context (${projectName})`,
+    "",
+    `> **\uBAA8\uB4DC**: ${mode}`,
+    "> **\uC5ED\uD560**: AI\uAC00 \uC774 \uD504\uB85C\uC81D\uD2B8\uC758 \uB3C4\uBA54\uC778\uC744 \uC774\uD574\uD558\uAE30 \uC704\uD55C \uD575\uC2EC \uAC1D\uCCB4 \uBAA8\uB378.",
+    "> **\uD30C\uC774\uD504\uB77C\uC778 \uACC4\uC57D**:",
+    ">   - \uC5EC\uAE30 \uC815\uC758\uB41C \uB3C4\uBA54\uC778 \uAC1D\uCCB4\uB294 `docs/openspec.md`\uC758 API \uC694\uCCAD/\uC751\uB2F5 \uBAA8\uB378\uACFC \uC815\uD569\uD574\uC57C \uD568",
+    ">   - `.pai/harness.json`\uC758 `businessRules` \uAC80\uC99D\uC774 \uC774 \uBB38\uC11C\uB97C \uCC38\uC870",
+    "> **\uC791\uC131 \uAC00\uC774\uB4DC**: `/pai design` \uC2E4\uD589 \uC2DC Claude\uAC00 openspec.md \uC5D4\uB4DC\uD3EC\uC778\uD2B8\uC5D0 \uB9DE\uCDB0 \uBE48 \uC139\uC158\uC744 \uCC44\uC6C1\uB2C8\uB2E4.",
+    "",
+    "---",
+    "",
+    "## \uB3C4\uBA54\uC778 \uAC1D\uCCB4",
+    "",
+    "### User",
+    "",
+    "```ts",
+    "interface User {",
+    "  id: string;",
+    "  email: string;",
+    "  name: string;",
+    "  role: 'admin' | 'member';",
+    "  createdAt: Date;",
+    "}",
+    "```",
+    "",
+    "<!-- TODO: \uD504\uB85C\uC81D\uD2B8 \uACE0\uC720 \uB3C4\uBA54\uC778 \uAC1D\uCCB4 \uCD94\uAC00. openspec.md\uC758 \uC5D4\uB4DC\uD3EC\uC778\uD2B8\uAC00 \uC694\uAD6C\uD558\uB294 \uBAA8\uB378\uC744 \uC5EC\uAE30 \uBA3C\uC800 \uC815\uC758 -->",
+    ""
+  ];
+  if (mode === "poc" || mode === "production") {
+    lines.push(
+      "### Session",
       "",
-      "## 4. \uAE30\uC220 \uC2A4\uD0DD (Stack)",
-      "- Frontend:",
-      "- Backend:",
-      "- DB:",
+      "```ts",
+      "interface Session {",
+      "  token: string;",
+      "  userId: string;",
+      "  expiresAt: Date;",
+      "}",
+      "```",
+      ""
+    );
+  }
+  if (mode === "production") {
+    lines.push(
+      "### AuditLog",
       "",
-      "## 5. API \uC5D4\uB4DC\uD3EC\uC778\uD2B8 (Endpoints)",
-      "| Method | Path | \uC124\uBA85 |",
-      "|--------|------|------|",
-      "| GET | /api/health | \uD5EC\uC2A4\uCCB4\uD06C |"
-    ].join("\n") + "\n");
+      "```ts",
+      "interface AuditLog {",
+      "  id: string;",
+      "  userId: string;",
+      "  action: 'create' | 'update' | 'delete' | 'read';",
+      "  resource: string;",
+      "  at: Date;",
+      "  metadata?: Record<string, unknown>;",
+      "}",
+      "```",
+      ""
+    );
+  }
+  lines.push(
+    "## \uBE44\uC988\uB2C8\uC2A4 \uADDC\uCE59",
+    "",
+    '<!-- \uADDC\uCE59\uC740 harness\uAC00 \uAC80\uC99D \uB300\uC0C1\uC73C\uB85C \uCC38\uC870. \uAC01 \uADDC\uCE59\uC740 "\uBB34\uC5C7\uC774 \uCC38\uC774\uC5B4\uC57C \uD558\uB294\uAC00"\uB85C \uAE30\uC220. -->',
+    "",
+    "- **\uC778\uC99D \uD544\uC218**: `User.id`\uAC00 \uC5C6\uB294 \uC694\uCCAD\uC740 \uAD00\uB9AC\uC790 API \uC811\uADFC \uBD88\uAC00",
+    "- **\uC774\uBA54\uC77C \uC720\uC77C\uC131**: `User.email`\uC740 \uC2DC\uC2A4\uD15C \uC804\uCCB4\uC5D0\uC11C \uC720\uC77C"
+  );
+  if (mode === "poc" || mode === "production") {
+    lines.push(
+      "- **\uC138\uC158 \uB9CC\uB8CC**: `Session.expiresAt < now()` \uC774\uBA74 \uBAA8\uB4E0 API 401"
+    );
   }
+  if (mode === "production") {
+    lines.push(
+      "- **\uAC10\uC0AC \uB85C\uADF8**: \uBAA8\uB4E0 \uC4F0\uAE30 \uC561\uC158(create/update/delete)\uC740 `AuditLog`\uC5D0 \uAE30\uB85D",
+      '- **\uAD8C\uD55C \uBD84\uB9AC**: `role === "member"` \uC0AC\uC6A9\uC790\uB294 \uB2E4\uB978 \uC0AC\uC6A9\uC790\uC758 \uB9AC\uC18C\uC2A4 \uC218\uC815 \uBD88\uAC00'
+    );
+  }
+  lines.push(
+    "",
+    "<!-- TODO: \uD504\uB85C\uC81D\uD2B8 \uACE0\uC720 \uBE44\uC988\uB2C8\uC2A4 \uADDC\uCE59 \uCD94\uAC00. \uAC01 \uADDC\uCE59\uC740 \uAC00\uB2A5\uD558\uBA74 \uD14C\uC2A4\uD2B8 \uAC00\uB2A5\uD55C \uD615\uD0DC\uB85C. -->",
+    "",
+    "## \uB3C4\uBA54\uC778 - API \uB9E4\uD551 (\uC120\uD0DD)",
+    "",
+    "<!-- openspec.md \uC5D4\uB4DC\uD3EC\uC778\uD2B8\uC640 \uB3C4\uBA54\uC778 \uAC1D\uCCB4 \uC5F0\uACB0. harness \uAC80\uC99D \uC6A9. -->",
+    "",
+    "| Endpoint | \uC694\uCCAD \uBAA8\uB378 | \uC751\uB2F5 \uBAA8\uB378 | \uBE44\uACE0 |",
+    "|----------|-----------|-----------|------|",
+    "| POST /api/auth/login | `{ email, password }` | `Session` | \uC131\uACF5 \uC2DC token \uBC1C\uAE09 |",
+    "<!-- TODO: \uCD94\uAC00 \uC5D4\uB4DC\uD3EC\uC778\uD2B8 \uB9E4\uD551 -->",
+    ""
+  );
+  return lines.join("\n") + "\n";
 }
 async function provisionOMC(ctx) {
   await fs7.ensureDir(join4(ctx.cwd, ".pai"));
   const omcPath = join4(ctx.cwd, ".pai", "omc.md");
   if (!await fs7.pathExists(omcPath)) {
-    await fs7.writeFile(omcPath, [
-      `# OMC \u2014 Object Model Context (${ctx.projectName})`,
-      "",
-      "> AI\uAC00 \uC774 \uD504\uB85C\uC81D\uD2B8\uC758 \uB3C4\uBA54\uC778\uC744 \uC774\uD574\uD558\uAE30 \uC704\uD55C \uD575\uC2EC \uAC1D\uCCB4 \uBAA8\uB378",
-      "",
-      "## \uB3C4\uBA54\uC778 \uAC1D\uCCB4",
-      "",
-      "### User",
-      "```",
-      "id: string",
-      "email: string",
-      'role: "admin" | "member"',
-      "```",
-      "",
-      "## \uBE44\uC988\uB2C8\uC2A4 \uADDC\uCE59",
-      "- (\uC5EC\uAE30\uC5D0 \uD575\uC2EC \uBE44\uC988\uB2C8\uC2A4 \uB85C\uC9C1\uC744 \uAE30\uC220)"
-    ].join("\n") + "\n");
+    const skeleton = buildOMCSkeleton(ctx.projectName, ctx.mode);
+    await fs7.writeFile(omcPath, skeleton);
   }
   const omcDir = join4(ctx.cwd, ".omc");
   await fs7.ensureDir(omcDir);
@@ -2333,13 +2484,20 @@ async function provisionGstack(ctx) {
 }
 async function provisionRoboco(ctx) {
   await fs7.ensureDir(join4(ctx.cwd, ".pai"));
-  const robocoPath = join4(ctx.cwd, ".pai", "roboco.json");
-  if (await fs7.pathExists(robocoPath)) return;
-  await fs7.writeJson(robocoPath, {
-    version: "1.0",
-    checks: ["github", "vercel", "supabase", "openspec", "omc"],
-    reportOutput: "AI_READINESS_REPORT.md",
-    note: "PAI Zero\uC5D0 \uB0B4\uC7AC\uD654\uB428. `pai evaluate`\uB85C \uC9C4\uB2E8 \uAC00\uB2A5."
+  const robocoPath2 = join4(ctx.cwd, ".pai", "roboco.json");
+  if (await fs7.pathExists(robocoPath2)) {
+    try {
+      const existing = await fs7.readJson(robocoPath2);
+      if (existing?.version === "2.0") return;
+    } catch {
+    }
+  }
+  await fs7.writeJson(robocoPath2, {
+    version: "2.0",
+    currentStage: "environment",
+    stageHistory: [],
+    lock: null,
+    gates: {}
   }, { spaces: 2 });
 }
 async function provisionHarness(ctx) {
@@ -3263,6 +3421,183 @@ description: "\uD50C\uB7EC\uADF8\uC778 \uCD94\uAC00 \uC124\uCE58 \u2014 Mockup\u
   }
 });
 
+// src/core/detector.ts
+var detector_exports = {};
+__export(detector_exports, {
+  PLUGIN_META: () => PLUGIN_META,
+  PLUGIN_SIGNATURES: () => PLUGIN_SIGNATURES,
+  deriveEdges: () => deriveEdges,
+  getBasePluginsForMode: () => getBasePluginsForMode,
+  getPluginsForMode: () => getPluginsForMode,
+  nextMode: () => nextMode,
+  pluginsAddedByPromotion: () => pluginsAddedByPromotion,
+  scanProjectState: () => scanProjectState
+});
+import path4 from "path";
+import fs9 from "fs-extra";
+async function scanProjectState(cwd) {
+  const result = {
+    isNewProject: true,
+    hasPaiConfig: false,
+    projectMode: null,
+    installedPlugins: [],
+    missingPlugins: [],
+    details: {}
+  };
+  const paiConfigPath = path4.join(cwd, ".pai", "config.json");
+  if (await fs9.pathExists(paiConfigPath)) {
+    result.hasPaiConfig = true;
+    try {
+      const config = await fs9.readJson(paiConfigPath);
+      result.projectMode = config.mode != null ? normalizeMode(config.mode) : null;
+    } catch {
+    }
+  }
+  for (const [key, signatures] of Object.entries(PLUGIN_SIGNATURES)) {
+    const installed = await Promise.any(
+      signatures.map(async (sig) => {
+        if (await fs9.pathExists(path4.join(cwd, sig))) return true;
+        throw new Error("not found");
+      })
+    ).catch(() => false);
+    result.details[key] = { installed, signatures };
+    if (installed) {
+      result.installedPlugins.push(key);
+    } else {
+      result.missingPlugins.push(key);
+    }
+  }
+  const hasAnyContent = result.installedPlugins.length > 0 || await fs9.pathExists(path4.join(cwd, "package.json")) || await fs9.pathExists(path4.join(cwd, "src")) || await fs9.pathExists(path4.join(cwd, "README.md"));
+  result.isNewProject = !hasAnyContent;
+  return result;
+}
+function getPluginsForMode(mode) {
+  return Object.entries(PLUGIN_META).filter(([, meta]) => meta.modes.includes(mode)).map(([key, meta]) => ({ key, ...meta }));
+}
+function getBasePluginsForMode(mode) {
+  return Object.entries(PLUGIN_META).filter(([, meta]) => meta.modes.includes(mode) && meta.required).map(([key]) => key);
+}
+function nextMode(current) {
+  if (current === "prototype") return "poc";
+  if (current === "poc") return "production";
+  return null;
+}
+function pluginsAddedByPromotion(from, to) {
+  const fromSet = new Set(getPluginsForMode(from).map((p) => p.key));
+  return getPluginsForMode(to).map((p) => p.key).filter((k) => !fromSet.has(k));
+}
+function deriveEdges(installedPlugins) {
+  const has = new Set(installedPlugins);
+  const edges = [];
+  if (has.has("harness") && has.has("openspec")) {
+    edges.push({
+      from: "harness",
+      to: "openspec",
+      via: "specFile",
+      path: "docs/openspec.md",
+      description: "harness\uAC00 openspec\uC758 API \uC5D4\uB4DC\uD3EC\uC778\uD2B8 \uBAA9\uB85D\uC744 \uC77D\uC5B4 \uAD6C\uD604 \uC77C\uCE58 \uAC80\uC99D"
+    });
+  }
+  if (has.has("gstack") && has.has("openspec")) {
+    edges.push({
+      from: "gstack",
+      to: "openspec",
+      via: "endpoints",
+      path: "docs/openspec.md",
+      description: "gstack \uD14C\uC2A4\uD2B8\uAC00 openspec\uC758 \uAC01 \uC5D4\uB4DC\uD3EC\uC778\uD2B8\uC5D0 \uB300\uD55C \uD14C\uC2A4\uD2B8 \uC874\uC7AC\uB97C \uC694\uAD6C"
+    });
+  }
+  if (has.has("omc") && has.has("openspec")) {
+    edges.push({
+      from: "omc",
+      to: "openspec",
+      via: "domain",
+      path: ".pai/omc.md",
+      description: "omc\uC758 \uB3C4\uBA54\uC778 \uAC1D\uCCB4\uAC00 openspec\uC758 API \uC694\uCCAD/\uC751\uB2F5 \uBAA8\uB378\uACFC \uC815\uD569"
+    });
+  }
+  if (has.has("harness") && has.has("omc")) {
+    edges.push({
+      from: "harness",
+      to: "omc",
+      via: "businessRules",
+      path: ".pai/omc.md",
+      description: "harness\uAC00 omc\uC758 \uBE44\uC988\uB2C8\uC2A4 \uADDC\uCE59\uC744 \uAC80\uC99D \uADDC\uCE59\uC73C\uB85C \uCC38\uC870"
+    });
+  }
+  return edges;
+}
+var PLUGIN_SIGNATURES, PLUGIN_META;
+var init_detector = __esm({
+  "src/core/detector.ts"() {
+    "use strict";
+    init_config();
+    PLUGIN_SIGNATURES = {
+      github: [".git", ".github"],
+      vercel: [".vercel", "vercel.json"],
+      supabase: ["supabase", ".supabase"],
+      openspec: ["openspec.md", "docs/openspec.md", ".pai/openspec.md"],
+      omc: [".pai/omc.md", "omc.config.js", "omc.config.json"],
+      gstack: [".pai/gstack.json", "gstack.config.js"],
+      roboco: [".pai/roboco.json", "roboco.config.js", ".roboco"],
+      harness: [".pai/harness.json", "harness.config.js", ".harness"]
+    };
+    PLUGIN_META = {
+      github: {
+        label: "GitHub \uB808\uD3EC & \uD3F4\uB354 \uAD6C\uC870",
+        description: "\uB808\uD3EC \uCD08\uAE30\uD654, .gitignore, \uAE30\uBCF8 \uBE0C\uB79C\uCE58 \uC124\uC815",
+        modes: ["prototype", "poc", "production"],
+        required: true
+      },
+      openspec: {
+        label: "OpenSpec (PRD \uC124\uACC4)",
+        description: "AI \uAE30\uBC18 PRD \uC0DD\uC131 \uBC0F \uC2A4\uD399 \uBB38\uC11C\uD654",
+        modes: ["prototype", "poc", "production"],
+        required: true
+      },
+      roboco: {
+        label: "roboco (AI \uC9C4\uB2E8)",
+        description: "\uC124\uCE58 \uC0C1\uD0DC \uD3C9\uAC00 \uBC0F AI \uC900\uBE44\uB3C4 \uB9AC\uD3EC\uD2B8 \uC0DD\uC131",
+        modes: ["prototype", "poc", "production"],
+        required: false,
+        url: "https://github.com/SoInKyu/roboco-cli"
+      },
+      omc: {
+        label: "OMC (oh-my-claudecode)",
+        description: "\uAC1D\uCCB4 \uBAA8\uB378 \uCEE8\uD14D\uC2A4\uD2B8 + Claude Code \uBA40\uD2F0 \uC5D0\uC774\uC804\uD2B8 \uC624\uCF00\uC2A4\uD2B8\uB808\uC774\uC158",
+        modes: ["poc", "production"],
+        required: false,
+        url: "https://github.com/SoInKyu/oh-my-claudecode"
+      },
+      vercel: {
+        label: "Vercel \uBC30\uD3EC \uC5F0\uB3D9",
+        description: "\uC790\uB3D9 \uBC30\uD3EC \uD30C\uC774\uD504\uB77C\uC778 \uBC0F Preview URL \uC124\uC815",
+        modes: ["poc", "production"],
+        required: false
+      },
+      gstack: {
+        label: "gstack (QA / \uD488\uC9C8\uAD00\uB9AC)",
+        description: "\uD14C\uC2A4\uD2B8 \uC790\uB3D9\uD654 \uBC0F \uD488\uC9C8 \uAE30\uC900 \uC124\uC815",
+        modes: ["production"],
+        required: false,
+        url: "https://github.com/SoInKyu/gstack"
+      },
+      harness: {
+        label: "Harness Engineering (\uAC80\uC99D \uC790\uB3D9\uD654)",
+        description: "\uC124\uACC4(OpenSpec)\uC640 \uAD6C\uD604 \uC77C\uCE58 \uC5EC\uBD80 \uC790\uB3D9 \uCCB4\uD06C",
+        modes: ["production"],
+        required: false
+      },
+      supabase: {
+        label: "Supabase (DB & Auth)",
+        description: "\uB370\uC774\uD130\uBCA0\uC774\uC2A4, \uC778\uC99D, API \uD0A4 \uC790\uB3D9 \uC5F0\uB3D9",
+        modes: ["production"],
+        required: false
+      }
+    };
+  }
+});
+
 // src/stages/environment/doctor.ts
 var doctor_exports = {};
 __export(doctor_exports, {
@@ -3270,7 +3605,7 @@ __export(doctor_exports, {
 });
 import { join as join6 } from "path";
 import { homedir } from "os";
-import fs9 from "fs-extra";
+import fs10 from "fs-extra";
 async function runDoctor() {
   section("PAI Doctor \u2014 \uD658\uACBD \uC9C4\uB2E8");
   const checks = [];
@@ -3290,7 +3625,7 @@ async function runDoctor() {
     fix: claudeCheck.ok ? void 0 : "npm install -g @anthropic-ai/claude-code"
   });
   const globalConfigPath = join6(homedir(), ".pai", "config.json");
-  const hasGlobalConfig = await fs9.pathExists(globalConfigPath);
+  const hasGlobalConfig = await fs10.pathExists(globalConfigPath);
   checks.push({
     label: "\uAE00\uB85C\uBC8C \uC124\uC815",
     ok: true,
@@ -3346,8 +3681,8 @@ var init_doctor = __esm({
 });
 
 // src/utils/github-fetch.ts
-import path4 from "path";
-import fs10 from "fs-extra";
+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);
@@ -3378,8 +3713,8 @@ async function downloadFile(downloadUrl, destPath, timeoutMs) {
     throw new Error(`Download failed ${res.status} ${res.statusText} (${downloadUrl})`);
   }
   const buf = Buffer.from(await res.arrayBuffer());
-  await fs10.ensureDir(path4.dirname(destPath));
-  await fs10.writeFile(destPath, buf);
+  await fs11.ensureDir(path5.dirname(destPath));
+  await fs11.writeFile(destPath, buf);
 }
 async function fetchGithubDir(opts) {
   const {
@@ -3403,10 +3738,10 @@ async function fetchGithubDir(opts) {
     for (const entry of entries) {
       const relName = entry.name;
       if (entry.type === "dir") {
-        await walk(`${currentSrc}/${relName}`, path4.join(currentDest, relName));
+        await walk(`${currentSrc}/${relName}`, path5.join(currentDest, relName));
       } else if (entry.type === "file") {
-        const destFile = path4.join(currentDest, relName);
-        if (!overwrite && await fs10.pathExists(destFile)) {
+        const destFile = path5.join(currentDest, relName);
+        if (!overwrite && await fs11.pathExists(destFile)) {
           result.skipped.push(destFile);
           continue;
         }
@@ -3438,8 +3773,8 @@ var fetch_cmd_exports = {};
 __export(fetch_cmd_exports, {
   fetchCommand: () => fetchCommand
 });
-import path5 from "path";
-import fs11 from "fs-extra";
+import path6 from "path";
+import fs12 from "fs-extra";
 import chalk4 from "chalk";
 async function fetchCommand(cwd, recipeKey, options) {
   if (options.list) {
@@ -3477,7 +3812,7 @@ async function fetchCommand(cwd, recipeKey, options) {
   const installed = [];
   for (const key of keys) {
     const recipe = RECIPES[key];
-    const targetDir = path5.join(cwd, recipe.target);
+    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 () => {
@@ -3499,7 +3834,7 @@ async function fetchCommand(cwd, recipeKey, options) {
     if (result.written.length > 0) {
       success(`${result.written.length}\uAC1C \uD30C\uC77C \uC800\uC7A5`);
       for (const f of result.written) {
-        console.log(chalk4.gray(`    ${path5.relative(cwd, f)}`));
+        console.log(chalk4.gray(`    ${path6.relative(cwd, f)}`));
       }
     }
     if (result.skipped.length > 0) {
@@ -3535,10 +3870,10 @@ async function fetchCommand(cwd, recipeKey, options) {
 }
 async function appendEnvKeys(cwd, recipe) {
   if (recipe.envKeys.length === 0) return;
-  const envPath = path5.join(cwd, ".env.local");
+  const envPath = path6.join(cwd, ".env.local");
   let content = "";
-  if (await fs11.pathExists(envPath)) {
-    content = await fs11.readFile(envPath, "utf8");
+  if (await fs12.pathExists(envPath)) {
+    content = await fs12.readFile(envPath, "utf8");
   }
   const missingKeys = recipe.envKeys.filter((ek) => !content.includes(`${ek.key}=`));
   if (missingKeys.length === 0) return;
@@ -3551,13 +3886,13 @@ async function appendEnvKeys(cwd, recipe) {
     if (ek.hint) lines.push(`# ${ek.hint}`);
     lines.push(`${ek.key}=${ek.default ?? ""}`);
   }
-  await fs11.ensureFile(envPath);
-  await fs11.appendFile(envPath, lines.join("\n") + "\n");
+  await fs12.ensureFile(envPath);
+  await fs12.appendFile(envPath, lines.join("\n") + "\n");
 }
 async function upsertRecipesSkill(cwd, installedKeys) {
-  const skillDir = path5.join(cwd, ".claude", "skills", "recipes");
-  await fs11.ensureDir(skillDir);
-  const skillPath = path5.join(skillDir, "SKILL.md");
+  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 = [
@@ -3596,10 +3931,10 @@ async function upsertRecipesSkill(cwd, installedKeys) {
     "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 fs11.writeFile(skillPath, body);
+  await fs12.writeFile(skillPath, body);
 }
 async function upsertClaudeMdBlock(cwd, installedKeys) {
-  const claudeMdPath = path5.join(cwd, "CLAUDE.md");
+  const claudeMdPath = path6.join(cwd, "CLAUDE.md");
   const BLOCK_START = "<!-- pai:recipes:start -->";
   const BLOCK_END = "<!-- pai:recipes:end -->";
   const lines = [];
@@ -3619,8 +3954,8 @@ async function upsertClaudeMdBlock(cwd, installedKeys) {
   lines.push(BLOCK_END);
   const block = lines.join("\n");
   let content = "";
-  if (await fs11.pathExists(claudeMdPath)) {
-    content = await fs11.readFile(claudeMdPath, "utf8");
+  if (await fs12.pathExists(claudeMdPath)) {
+    content = await fs12.readFile(claudeMdPath, "utf8");
   }
   const startIdx = content.indexOf(BLOCK_START);
   const endIdx = content.indexOf(BLOCK_END);
@@ -3633,8 +3968,8 @@ async function upsertClaudeMdBlock(cwd, installedKeys) {
     if (content.length > 0) content += "\n";
     content += block + "\n";
   }
-  await fs11.ensureFile(claudeMdPath);
-  await fs11.writeFile(claudeMdPath, content);
+  await fs12.ensureFile(claudeMdPath);
+  await fs12.writeFile(claudeMdPath, content);
 }
 var init_fetch_cmd = __esm({
   "src/cli/commands/fetch.cmd.ts"() {
@@ -3658,6 +3993,7 @@ var init_environment = __esm({
     init_installer();
     init_registry();
     init_claude_commands();
+    init_detector();
     init_config();
     init_progress();
     init_ui();
@@ -3715,6 +4051,7 @@ var init_environment = __esm({
               PAI_PROJECT_NAME: interview.projectName,
               PAI_MODE: interview.mode
             },
+            analysis,
             mcp: interview.mcp
           };
           if (interview.authMethods.includes("custom")) {
@@ -3779,6 +4116,7 @@ var init_environment = __esm({
           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);
@@ -3808,141 +4146,6 @@ var init_environment = __esm({
   }
 });
 
-// src/core/detector.ts
-var detector_exports = {};
-__export(detector_exports, {
-  PLUGIN_META: () => PLUGIN_META,
-  PLUGIN_SIGNATURES: () => PLUGIN_SIGNATURES,
-  getBasePluginsForMode: () => getBasePluginsForMode,
-  getPluginsForMode: () => getPluginsForMode,
-  nextMode: () => nextMode,
-  pluginsAddedByPromotion: () => pluginsAddedByPromotion,
-  scanProjectState: () => scanProjectState
-});
-import path6 from "path";
-import fs12 from "fs-extra";
-async function scanProjectState(cwd) {
-  const result = {
-    isNewProject: true,
-    hasPaiConfig: false,
-    projectMode: null,
-    installedPlugins: [],
-    missingPlugins: [],
-    details: {}
-  };
-  const paiConfigPath = path6.join(cwd, ".pai", "config.json");
-  if (await fs12.pathExists(paiConfigPath)) {
-    result.hasPaiConfig = true;
-    try {
-      const config = await fs12.readJson(paiConfigPath);
-      result.projectMode = config.mode != null ? normalizeMode(config.mode) : null;
-    } catch {
-    }
-  }
-  for (const [key, signatures] of Object.entries(PLUGIN_SIGNATURES)) {
-    const installed = await Promise.any(
-      signatures.map(async (sig) => {
-        if (await fs12.pathExists(path6.join(cwd, sig))) return true;
-        throw new Error("not found");
-      })
-    ).catch(() => false);
-    result.details[key] = { installed, signatures };
-    if (installed) {
-      result.installedPlugins.push(key);
-    } else {
-      result.missingPlugins.push(key);
-    }
-  }
-  const hasAnyContent = result.installedPlugins.length > 0 || await fs12.pathExists(path6.join(cwd, "package.json")) || await fs12.pathExists(path6.join(cwd, "src")) || await fs12.pathExists(path6.join(cwd, "README.md"));
-  result.isNewProject = !hasAnyContent;
-  return result;
-}
-function getPluginsForMode(mode) {
-  return Object.entries(PLUGIN_META).filter(([, meta]) => meta.modes.includes(mode)).map(([key, meta]) => ({ key, ...meta }));
-}
-function getBasePluginsForMode(mode) {
-  return Object.entries(PLUGIN_META).filter(([, meta]) => meta.modes.includes(mode) && meta.required).map(([key]) => key);
-}
-function nextMode(current) {
-  if (current === "prototype") return "poc";
-  if (current === "poc") return "production";
-  return null;
-}
-function pluginsAddedByPromotion(from, to) {
-  const fromSet = new Set(getPluginsForMode(from).map((p) => p.key));
-  return getPluginsForMode(to).map((p) => p.key).filter((k) => !fromSet.has(k));
-}
-var PLUGIN_SIGNATURES, PLUGIN_META;
-var init_detector = __esm({
-  "src/core/detector.ts"() {
-    "use strict";
-    init_config();
-    PLUGIN_SIGNATURES = {
-      github: [".git", ".github"],
-      vercel: [".vercel", "vercel.json"],
-      supabase: ["supabase", ".supabase"],
-      openspec: ["openspec.md", "docs/openspec.md", ".pai/openspec.md"],
-      omc: [".pai/omc.md", "omc.config.js", "omc.config.json"],
-      gstack: [".pai/gstack.json", "gstack.config.js"],
-      roboco: [".pai/roboco.json", "roboco.config.js", ".roboco"],
-      harness: [".pai/harness.json", "harness.config.js", ".harness"]
-    };
-    PLUGIN_META = {
-      github: {
-        label: "GitHub \uB808\uD3EC & \uD3F4\uB354 \uAD6C\uC870",
-        description: "\uB808\uD3EC \uCD08\uAE30\uD654, .gitignore, \uAE30\uBCF8 \uBE0C\uB79C\uCE58 \uC124\uC815",
-        modes: ["prototype", "poc", "production"],
-        required: true
-      },
-      openspec: {
-        label: "OpenSpec (PRD \uC124\uACC4)",
-        description: "AI \uAE30\uBC18 PRD \uC0DD\uC131 \uBC0F \uC2A4\uD399 \uBB38\uC11C\uD654",
-        modes: ["prototype", "poc", "production"],
-        required: true
-      },
-      roboco: {
-        label: "roboco (AI \uC9C4\uB2E8)",
-        description: "\uC124\uCE58 \uC0C1\uD0DC \uD3C9\uAC00 \uBC0F AI \uC900\uBE44\uB3C4 \uB9AC\uD3EC\uD2B8 \uC0DD\uC131",
-        modes: ["prototype", "poc", "production"],
-        required: false,
-        url: "https://github.com/SoInKyu/roboco-cli"
-      },
-      omc: {
-        label: "OMC (oh-my-claudecode)",
-        description: "\uAC1D\uCCB4 \uBAA8\uB378 \uCEE8\uD14D\uC2A4\uD2B8 + Claude Code \uBA40\uD2F0 \uC5D0\uC774\uC804\uD2B8 \uC624\uCF00\uC2A4\uD2B8\uB808\uC774\uC158",
-        modes: ["poc", "production"],
-        required: false,
-        url: "https://github.com/SoInKyu/oh-my-claudecode"
-      },
-      vercel: {
-        label: "Vercel \uBC30\uD3EC \uC5F0\uB3D9",
-        description: "\uC790\uB3D9 \uBC30\uD3EC \uD30C\uC774\uD504\uB77C\uC778 \uBC0F Preview URL \uC124\uC815",
-        modes: ["poc", "production"],
-        required: false
-      },
-      gstack: {
-        label: "gstack (QA / \uD488\uC9C8\uAD00\uB9AC)",
-        description: "\uD14C\uC2A4\uD2B8 \uC790\uB3D9\uD654 \uBC0F \uD488\uC9C8 \uAE30\uC900 \uC124\uC815",
-        modes: ["production"],
-        required: false,
-        url: "https://github.com/SoInKyu/gstack"
-      },
-      harness: {
-        label: "Harness Engineering (\uAC80\uC99D \uC790\uB3D9\uD654)",
-        description: "\uC124\uACC4(OpenSpec)\uC640 \uAD6C\uD604 \uC77C\uCE58 \uC5EC\uBD80 \uC790\uB3D9 \uCCB4\uD06C",
-        modes: ["production"],
-        required: false
-      },
-      supabase: {
-        label: "Supabase (DB & Auth)",
-        description: "\uB370\uC774\uD130\uBCA0\uC774\uC2A4, \uC778\uC99D, API \uD0A4 \uC790\uB3D9 \uC5F0\uB3D9",
-        modes: ["production"],
-        required: false
-      }
-    };
-  }
-});
-
 // src/stages/evaluation/prompts/analyze.ts
 var analyze_exports = {};
 __export(analyze_exports, {
@@ -4091,8 +4294,8 @@ async function checkCiCd(repoPath) {
     { path: "Jenkinsfile", label: "Jenkins" },
     { path: ".circleci", label: "CircleCI" }
   ];
-  for (const { path: path8, label } of ciConfigs) {
-    const found = await fs13.pathExists(join7(repoPath, path8));
+  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;
   }
@@ -4110,8 +4313,8 @@ async function checkHooks(repoPath) {
     { path: "commitlint.config.js", label: "commitlint" },
     { path: ".claude/settings.json", label: "Claude Code settings" }
   ];
-  for (const { path: path8, label } of hookConfigs) {
-    const found = await fs13.pathExists(join7(repoPath, path8));
+  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;
   }
@@ -4128,8 +4331,8 @@ async function checkRepoStructure(repoPath) {
     { path: ".env.example", label: "\uD658\uACBD\uBCC0\uC218 \uC608\uC2DC" },
     { path: ".gitignore", label: ".gitignore" }
   ];
-  for (const { path: path8, label } of structureChecks) {
-    const found = await fs13.pathExists(join7(repoPath, path8));
+  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;
   }
@@ -4145,8 +4348,8 @@ async function checkDocumentation(repoPath) {
     { path: "docs", label: "docs/ \uB514\uB809\uD1A0\uB9AC", points: 25 },
     { path: "docs/openspec.md", label: "OpenSpec PRD", points: 25 }
   ];
-  for (const { path: path8, label, points } of docChecks) {
-    const found = await fs13.pathExists(join7(repoPath, path8));
+  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;
   }
@@ -4164,8 +4367,8 @@ async function checkHarnessEngineering(repoPath) {
     { path: ".claude/commands", label: ".claude/commands/", points: 10 },
     { path: ".pai/config.json", label: "PAI config", points: 10 }
   ];
-  for (const { path: path8, label, points } of harnessChecks) {
-    const found = await fs13.pathExists(join7(repoPath, path8));
+  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;
   }
@@ -4390,13 +4593,13 @@ function buildMarkdownReport(result) {
   return lines.join("\n") + "\n";
 }
 function buildDetailedReport(result, projectName) {
-  const now = (/* @__PURE__ */ new Date()).toLocaleString("ko-KR");
+  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: ${now}`,
+    `> \uC2A4\uCE94 \uC77C\uC2DC: ${now2}`,
     `> \uBD84\uC11D \uB300\uC0C1: ${projectName}`,
     "",
     "---",
@@ -4808,40 +5011,657 @@ function getCachedResult(repoPath) {
 function setCachedResult(repoPath, llmOutput) {
   const store = loadCache(repoPath);
   const repoHash = computeRepoHash(repoPath);
-  const now = Date.now();
+  const now2 = Date.now();
   for (const [key, entry] of Object.entries(store.entries)) {
-    if (now - entry.timestamp > CACHE_TTL_MS) {
+    if (now2 - entry.timestamp > CACHE_TTL_MS) {
       delete store.entries[key];
     }
   }
-  store.entries[repoHash] = { repoPath, repoHash, timestamp: now, llmOutput };
-  saveCache(repoPath, store);
+  store.entries[repoHash] = { repoPath, repoHash, timestamp: now2, llmOutput };
+  saveCache(repoPath, store);
+}
+var CACHE_DIR, CACHE_FILE, CACHE_TTL_MS, FILES_TO_HASH;
+var init_cache = __esm({
+  "src/stages/evaluation/cache.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();
+  try {
+    const raw = await fs16.readJson(p);
+    if (raw?.version !== "2.0") return freshState();
+    return raw;
+  } catch {
+    return freshState();
+  }
+}
+async function saveRobocoState(cwd, state) {
+  const p = robocoPath(cwd);
+  await fs16.ensureDir(path8.dirname(p));
+  await fs16.writeJson(p, state, { spaces: 2 });
+}
+function freshState() {
+  return {
+    version: "2.0",
+    currentStage: "environment",
+    stageHistory: [],
+    lock: null,
+    gates: {}
+  };
+}
+function isProcessAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+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 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);
+  }
+}
+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;
+    }
+  }
+  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(() => {
+    });
+  }
+}
+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";
+  }
+  await fs16.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 = 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 -->";
+  }
+});
+
+// src/core/gates.ts
+import path9 from "path";
+import fs17 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 = 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"
+    });
+  }
+  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"
+    });
+  }
+  return makeResult("design.entry", violations);
+}
+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"
+      });
+    }
+  }
+  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"
+      });
+    }
+  }
+  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/"
+    });
+  } 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/"
+      });
+    }
+  }
+  return makeResult("validation.entry", violations);
+}
+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.`
+      });
+    }
+  }
+  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++;
+  }
+  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;
+    }
+    if (!inDomainSection) continue;
+    if (/^##\s/.test(line) && !/도메인|Domain/i.test(line)) {
+      inDomainSection = false;
+      continue;
+    }
+    if (/^###\s+\w/.test(line)) count++;
+  }
+  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;
+    }
+    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++;
+      }
+    }
+  }
+  await walk(srcDir);
+  return count;
+}
+var EVAL_GATE_WINDOW_MS, STAGE_GATES;
+var init_gates = __esm({
+  "src/core/gates.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
+    };
+  }
+});
+
+// src/stages/validation/runner.ts
+import { join as join10 } from "path";
+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 {
+    }
+  }
+  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 {
+    }
+  }
+  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
+    };
+  }
+}
+var init_runner = __esm({
+  "src/stages/validation/runner.ts"() {
+    "use strict";
+  }
+});
+
+// src/stages/validation/harness.ts
+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: [] };
+  }
+  let config;
+  try {
+    config = await fs19.readJson(harnessPath);
+  } 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 { 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 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;
+  }
+  throw err;
 }
-var CACHE_DIR, CACHE_FILE, CACHE_TTL_MS, FILES_TO_HASH;
-var init_cache = __esm({
-  "src/stages/evaluation/cache.ts"() {
+var init_validate_cmd = __esm({
+  "src/cli/commands/validate.cmd.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"
-    ];
+    init_ui();
+    init_runner();
+    init_harness();
+    init_roboco();
+    init_gates();
   }
 });
 
@@ -4850,43 +5670,57 @@ var evaluate_cmd_exports = {};
 __export(evaluate_cmd_exports, {
   evaluateCommand: () => evaluateCommand
 });
-import { join as join10, basename } from "path";
-import fs16 from "fs-extra";
+import { join as join12, basename } from "path";
+import fs20 from "fs-extra";
 async function evaluateCommand(cwd, options) {
   const useCache = options.cache !== false;
-  let llmOutput = useCache ? getCachedResult(cwd) : null;
-  if (llmOutput) {
-    info("\uCE90\uC2DC\uB41C \uACB0\uACFC \uC0AC\uC6A9 (24\uC2DC\uAC04 \uC774\uB0B4)");
-  } else {
-    llmOutput = await analyzeRepository(cwd);
-    if (useCache) {
-      setCachedResult(cwd, llmOutput);
+  try {
+    await withRoboco(
+      cwd,
+      "evaluation",
+      "pai grade",
+      { skipGates: options.skipGates, force: options.force, gate: STAGE_GATES.evaluation },
+      async () => {
+        let llmOutput = useCache ? getCachedResult(cwd) : null;
+        if (llmOutput) {
+          info("\uCE90\uC2DC\uB41C \uACB0\uACFC \uC0AC\uC6A9 (24\uC2DC\uAC04 \uC774\uB0B4)");
+        } else {
+          llmOutput = await analyzeRepository(cwd);
+          if (useCache) setCachedResult(cwd, llmOutput);
+        }
+        const result = computeResult(llmOutput);
+        printReport(result);
+        if (options.verbose) printVerboseFindings(result);
+        const config = await loadConfig(cwd);
+        const projectName = config?.projectName ?? basename(cwd);
+        const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+        const reportDir = join12(cwd, "docs", "p-reports");
+        const reportPath = join12(reportDir, `${today}.md`);
+        await fs20.ensureDir(reportDir);
+        const detailedReport = buildDetailedReport(result, projectName);
+        await fs20.writeFile(reportPath, detailedReport, "utf8");
+        console.log("");
+        success(`\uB9AC\uD3EC\uD2B8 \uC800\uC7A5: docs/p-reports/${today}.md`);
+        console.log("");
+        console.log(detailedReport);
+        if (options.output) {
+          await fs20.writeFile(options.output, detailedReport, "utf8");
+          success(`\uCD94\uAC00 \uC800\uC7A5: ${options.output}`);
+        }
+        if (options.failUnder && result.totalScore < options.failUnder) {
+          error(`\uC810\uC218 ${result.totalScore}\uC774 \uCD5C\uC18C \uAE30\uC900 ${options.failUnder}\uC5D0 \uBBF8\uB2EC\uD569\uB2C8\uB2E4.`);
+          throw new Error("score-below-threshold");
+        }
+      }
+    );
+    await syncHandoff(cwd).catch(() => {
+    });
+  } catch (err) {
+    if (err instanceof Error && err.message === "score-below-threshold") {
+      process.exitCode = 1;
+      return;
     }
-  }
-  const result = computeResult(llmOutput);
-  printReport(result);
-  if (options.verbose) {
-    printVerboseFindings(result);
-  }
-  const config = await loadConfig(cwd);
-  const projectName = config?.projectName ?? basename(cwd);
-  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-  const reportDir = join10(cwd, "docs", "p-reports");
-  const reportPath = join10(reportDir, `${today}.md`);
-  await fs16.ensureDir(reportDir);
-  const detailedReport = buildDetailedReport(result, projectName);
-  await fs16.writeFile(reportPath, detailedReport, "utf8");
-  console.log("");
-  success(`\uB9AC\uD3EC\uD2B8 \uC800\uC7A5: docs/p-reports/${today}.md`);
-  console.log("");
-  console.log(detailedReport);
-  if (options.output) {
-    await fs16.writeFile(options.output, detailedReport, "utf8");
-    success(`\uCD94\uAC00 \uC800\uC7A5: ${options.output}`);
-  }
-  if (options.failUnder && result.totalScore < options.failUnder) {
-    error(`\uC810\uC218 ${result.totalScore}\uC774 \uCD5C\uC18C \uAE30\uC900 ${options.failUnder}\uC5D0 \uBBF8\uB2EC\uD569\uB2C8\uB2E4.`);
-    process.exitCode = 1;
+    handleRobocoError(err);
   }
 }
 var init_evaluate_cmd = __esm({
@@ -4898,6 +5732,9 @@ var init_evaluate_cmd = __esm({
     init_cache();
     init_reporter();
     init_config();
+    init_roboco();
+    init_gates();
+    init_validate_cmd();
   }
 });
 
@@ -4908,7 +5745,22 @@ __export(env_cmd_exports, {
   envSetupCommand: () => envSetupCommand,
   envStatusCommand: () => envStatusCommand
 });
-async function envSetupCommand(cwd) {
+async function envSetupCommand(cwd, options = {}) {
+  try {
+    await withRoboco(
+      cwd,
+      "environment",
+      "pai add",
+      { skipGates: options.skipGates, force: options.force },
+      async () => envSetupCommandInner(cwd)
+    );
+    await syncHandoff(cwd).catch(() => {
+    });
+  } catch (err) {
+    handleRobocoError(err);
+  }
+}
+async function envSetupCommandInner(cwd) {
   const { default: inquirer } = await import("inquirer");
   const { basename: basename5 } = await import("path");
   section("\uD50C\uB7EC\uADF8\uC778 \uCD94\uAC00 \xB7 \uBAA8\uB4DC \uC2B9\uACA9");
@@ -5034,6 +5886,54 @@ async function envStatusCommand(cwd) {
       hint(`\uC2B9\uACA9 \uACBD\uB85C: ${state.projectMode} \u2192 ${next} (pai add \uC5D0\uC11C \uC2B9\uACA9 \uAC00\uB2A5)`);
     }
   }
+  const robo = await loadRobocoState(cwd);
+  console.log("");
+  console.log(colors.accent("  \uD30C\uC774\uD504\uB77C\uC778 \uC9C4\uD589 (roboco)"));
+  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"));
+  const stages = ["environment", "design", "execution", "validation", "evaluation"];
+  for (const s of stages) {
+    const latest = [...robo.stageHistory].reverse().find((h) => h.stage === s);
+    const gate = robo.gates[`${s}.entry`];
+    let mark = "\u25CB";
+    let label = "\uB300\uAE30";
+    if (latest?.status === "done") {
+      mark = "\u2713";
+      label = "\uC644\uB8CC";
+    } else if (latest?.status === "in_progress") {
+      mark = "\u25B8";
+      label = "\uC9C4\uD589 \uC911";
+    } else if (latest?.status === "failed") {
+      mark = "\u2717";
+      label = `\uC2E4\uD328 (${latest.reason ?? "\uC6D0\uC778 \uBD88\uBA85"})`;
+    } else if (gate && !gate.passed) {
+      mark = "\u25CB";
+      label = `\uB300\uAE30 (\uAC8C\uC774\uD2B8 ${gate.violations.length}\uAC74 \uBBF8\uD1B5\uACFC)`;
+    }
+    console.log(`  ${mark} ${s.padEnd(12)} ${colors.dim(label)}`);
+  }
+  const failedGates = Object.values(robo.gates).filter((g) => !g.passed);
+  if (failedGates.length > 0) {
+    console.log("");
+    console.log(colors.accent("  \uBBF8\uD1B5\uACFC \uAC8C\uC774\uD2B8"));
+    for (const g of failedGates) {
+      console.log(`  \u2717 ${g.name}`);
+      for (const v of g.violations) {
+        console.log(colors.dim(`      \xB7 ${v.message}`));
+      }
+    }
+  }
+  console.log("");
+  if (robo.lock) {
+    const stale = isLockStale(robo.lock);
+    const mins = Math.round((Date.now() - new Date(robo.lock.acquiredAt).getTime()) / 6e4);
+    if (stale) {
+      warn(`\uB77D stale (${robo.lock.command}, PID ${robo.lock.pid}) \u2014 \uB2E4\uC74C \uBA85\uB839 \uC2DC \uC790\uB3D9 \uD574\uC81C\uB428`);
+    } else {
+      warn(`\uC9C4\uD589 \uC911: ${robo.lock.command} (PID ${robo.lock.pid}, ${mins}\uBD84 \uC804)`);
+    }
+  } else {
+    success("\uB77D \uC5C6\uC74C (\uC5B4\uB290 \uBA85\uB839\uC774\uB4E0 \uC2E4\uD589 \uAC00\uB2A5)");
+  }
 }
 var init_env_cmd = __esm({
   "src/cli/commands/env.cmd.ts"() {
@@ -5045,6 +5945,8 @@ var init_env_cmd = __esm({
     init_doctor();
     init_analyzer();
     init_logger();
+    init_roboco();
+    init_validate_cmd();
   }
 });
 
@@ -5053,8 +5955,8 @@ var init_cmd_exports = {};
 __export(init_cmd_exports, {
   initCommand: () => initCommand
 });
-import { join as join11, basename as basename2 } from "path";
-import fs17 from "fs-extra";
+import { join as join13, basename as basename2 } from "path";
+import fs21 from "fs-extra";
 async function initCommand(cwd, nameArg) {
   printWelcomeBanner();
   const { isWindows: isWindows2, diagnoseWindowsEnv: diagnoseWindowsEnv2 } = await Promise.resolve().then(() => (init_platform(), platform_exports));
@@ -5112,11 +6014,11 @@ async function initCommand(cwd, nameArg) {
           const evalResult = computeResult2(llmOutput);
           printReport2(evalResult);
           const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-          const reportDir = join11(cwd, "docs", "p-reports");
-          await fs17.ensureDir(reportDir);
+          const reportDir = join13(cwd, "docs", "p-reports");
+          await fs21.ensureDir(reportDir);
           const legacyName = basename2(cwd);
           const detailedReport = buildDetailedReport3(evalResult, legacyName);
-          await fs17.writeFile(join11(reportDir, `${today}.md`), detailedReport, "utf8");
+          await fs21.writeFile(join13(reportDir, `${today}.md`), detailedReport, "utf8");
           console.log("");
           success(`\uB9AC\uD3EC\uD2B8 \uC800\uC7A5: docs/p-reports/${today}.md`);
         } catch {
@@ -5161,8 +6063,8 @@ async function initCommand(cwd, nameArg) {
     }]);
     projectName = answer.name.trim();
   }
-  const projectDir = join11(cwd, projectName);
-  if (await fs17.pathExists(projectDir)) {
+  const projectDir = join13(cwd, projectName);
+  if (await fs21.pathExists(projectDir)) {
     const existingConfig = await loadConfig(projectDir);
     if (existingConfig) {
       console.log("");
@@ -5175,7 +6077,7 @@ async function initCommand(cwd, nameArg) {
     warn(`${projectName}/ \uD3F4\uB354\uAC00 \uC774\uBBF8 \uC874\uC7AC\uD569\uB2C8\uB2E4.`);
     hint("\uC774 \uD3F4\uB354\uC5D0 PAI\uB97C \uC124\uCE58\uD569\uB2C8\uB2E4.");
   } else {
-    await fs17.ensureDir(projectDir);
+    await fs21.ensureDir(projectDir);
     success(`${projectName}/ \uD3F4\uB354 \uC0DD\uC131`);
   }
   await setupInDirectory(projectDir, projectName);
@@ -5260,7 +6162,7 @@ async function showCompletion(projectName, projectDir, extraTools, isCurrentDir)
     ...extraTools.includes("omc") ? [{ label: "OMC \uB7F0\uD0C0\uC784", path: ".omc" }] : []
   ];
   for (const check of checks) {
-    const exists = await fs17.pathExists(join11(projectDir, check.path));
+    const exists = await fs21.pathExists(join13(projectDir, check.path));
     console.log(`  ${exists ? colors.success("\u2713") : colors.err("\u2717")} ${check.label.padEnd(16)} ${colors.dim(check.path)}`);
   }
   console.log("");
@@ -5285,10 +6187,10 @@ async function showCompletion(projectName, projectDir, extraTools, isCurrentDir)
       printReport2(evalResult);
       await sleep2(500);
       const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-      const reportDir = join11(projectDir, "docs", "p-reports");
-      await fs17.ensureDir(reportDir);
+      const reportDir = join13(projectDir, "docs", "p-reports");
+      await fs21.ensureDir(reportDir);
       const detailedReport = buildDetailedReport3(evalResult, projectName);
-      await fs17.writeFile(join11(reportDir, `${today}.md`), detailedReport, "utf8");
+      await fs21.writeFile(join13(reportDir, `${today}.md`), detailedReport, "utf8");
       await sleep2(500);
       console.log("");
       success(`\uB9AC\uD3EC\uD2B8 \uC800\uC7A5: docs/p-reports/${today}.md`);
@@ -5339,7 +6241,7 @@ async function showCompletion(projectName, projectDir, extraTools, isCurrentDir)
   const shellRc = getShellRcPath2();
   let yoloAlreadyAliased = false;
   try {
-    const rcContent = await fs17.readFile(shellRc, "utf8");
+    const rcContent = await fs21.readFile(shellRc, "utf8");
     yoloAlreadyAliased = checkYolo(rcContent);
   } catch {
   }
@@ -5359,10 +6261,10 @@ async function showCompletion(projectName, projectDir, extraTools, isCurrentDir)
     try {
       const { getYoloAliasLine: getYoloAliasLine2 } = await Promise.resolve().then(() => (init_platform(), platform_exports));
       const aliasLine = getYoloAliasLine2();
-      const rcContent = await fs17.readFile(shellRc, "utf8").catch(() => "");
+      const rcContent = await fs21.readFile(shellRc, "utf8").catch(() => "");
       if (!rcContent.includes("claude-yolo")) {
-        await fs17.ensureDir(join11(shellRc, ".."));
-        await fs17.appendFile(shellRc, `
+        await fs21.ensureDir(join13(shellRc, ".."));
+        await fs21.appendFile(shellRc, `
 # PAI \u2014 claude-YOLO mode
 ${aliasLine}
 `);
@@ -5555,9 +6457,9 @@ async function installOrchestratorOnly(projectDir, projectName) {
     const evalResult = computeResult2(llmOutput);
     printReport2(evalResult);
     const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-    const reportDir = join11(projectDir, "docs", "p-reports");
-    await fs17.ensureDir(reportDir);
-    await fs17.writeFile(join11(reportDir, `${today}.md`), buildDetailedReport3(evalResult, projectName), "utf8");
+    const reportDir = join13(projectDir, "docs", "p-reports");
+    await fs21.ensureDir(reportDir);
+    await fs21.writeFile(join13(reportDir, `${today}.md`), buildDetailedReport3(evalResult, projectName), "utf8");
     console.log("");
     hint(`\uC0C1\uC138 \uB9AC\uD3EC\uD2B8: docs/p-reports/${today}.md`);
   } catch {
@@ -5607,7 +6509,7 @@ async function detectLegacyProject(cwd) {
     ".gitignore"
   ];
   for (const signal of signals) {
-    if (await fs17.pathExists(join11(cwd, signal))) return true;
+    if (await fs21.pathExists(join13(cwd, signal))) return true;
   }
   return false;
 }
@@ -5698,17 +6600,17 @@ var init_help_cmd = __esm({
 });
 
 // src/stages/design/openspec.ts
-import { join as join12 } from "path";
-import fs18 from "fs-extra";
+import { join as join14 } from "path";
+import fs22 from "fs-extra";
 async function initOpenSpec(cwd, projectName) {
-  const docsDir = join12(cwd, "docs");
-  await fs18.ensureDir(docsDir);
-  const openspecPath = join12(docsDir, "openspec.md");
-  if (await fs18.pathExists(openspecPath)) {
+  const docsDir = join14(cwd, "docs");
+  await fs22.ensureDir(docsDir);
+  const openspecPath = join14(docsDir, "openspec.md");
+  if (await fs22.pathExists(openspecPath)) {
     info("docs/openspec.md \uC774\uBBF8 \uC874\uC7AC \u2014 \uAC74\uB108\uB700");
     return;
   }
-  await fs18.writeFile(openspecPath, [
+  await fs22.writeFile(openspecPath, [
     `# OpenSpec \u2014 ${projectName}`,
     "",
     "## 1. \uBAA9\uC801 (Purpose)",
@@ -5736,13 +6638,13 @@ async function initOpenSpec(cwd, projectName) {
 }
 async function validateOpenSpec(cwd) {
   const candidates = [
-    join12(cwd, "docs", "openspec.md"),
-    join12(cwd, "openspec.md"),
-    join12(cwd, ".pai", "openspec.md")
+    join14(cwd, "docs", "openspec.md"),
+    join14(cwd, "openspec.md"),
+    join14(cwd, ".pai", "openspec.md")
   ];
   let specPath = null;
   for (const p of candidates) {
-    if (await fs18.pathExists(p)) {
+    if (await fs22.pathExists(p)) {
       specPath = p;
       break;
     }
@@ -5756,7 +6658,7 @@ async function validateOpenSpec(cwd) {
       warnings: ["openspec.md \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. `pai design init` \uC744 \uC2E4\uD589\uD558\uC138\uC694."]
     };
   }
-  const content = await fs18.readFile(specPath, "utf8");
+  const content = await fs22.readFile(specPath, "utf8");
   const missing = [];
   let filled = 0;
   for (const section2 of REQUIRED_SECTIONS) {
@@ -5804,17 +6706,17 @@ var init_openspec = __esm({
 });
 
 // src/stages/design/omc.ts
-import { join as join13 } from "path";
-import fs19 from "fs-extra";
+import { join as join15 } from "path";
+import fs23 from "fs-extra";
 async function initOMC(cwd, projectName) {
-  const paiDir = join13(cwd, ".pai");
-  await fs19.ensureDir(paiDir);
-  const omcPath = join13(paiDir, "omc.md");
-  if (await fs19.pathExists(omcPath)) {
+  const paiDir = join15(cwd, ".pai");
+  await fs23.ensureDir(paiDir);
+  const omcPath = join15(paiDir, "omc.md");
+  if (await fs23.pathExists(omcPath)) {
     info(".pai/omc.md \uC774\uBBF8 \uC874\uC7AC \u2014 \uAC74\uB108\uB700");
     return;
   }
-  await fs19.writeFile(omcPath, [
+  await fs23.writeFile(omcPath, [
     `# OMC \u2014 Object Model Context (${projectName})`,
     "",
     "> AI\uAC00 \uC774 \uD504\uB85C\uC81D\uD2B8\uC758 \uB3C4\uBA54\uC778\uC744 \uC774\uD574\uD558\uAE30 \uC704\uD55C \uD575\uC2EC \uAC1D\uCCB4 \uBAA8\uB378",
@@ -5854,195 +6756,71 @@ __export(design_cmd_exports, {
   designValidateCommand: () => designValidateCommand
 });
 import { basename as basename3 } from "path";
-async function designInitCommand(cwd) {
-  section("\uC124\uACC4 \uD15C\uD50C\uB9BF \uC0DD\uC131");
-  const config = await loadConfig(cwd);
-  const projectName = config?.projectName ?? basename3(cwd);
-  await initOpenSpec(cwd, projectName);
-  await initOMC(cwd, projectName);
-  info("");
-  info("\uB2E4\uC74C \uB2E8\uACC4: docs/openspec.md\uB97C \uC5F4\uC5B4 PRD\uB97C \uC791\uC131\uD558\uC138\uC694.");
-}
-async function designValidateCommand(cwd) {
-  section("PRD \uC644\uC131\uB3C4 \uAC80\uC99D");
-  const result = await validateOpenSpec(cwd);
-  info(`\uC139\uC158 \uC644\uC131\uB3C4: ${result.filledSections}/${result.totalSections}`);
-  if (result.missing.length > 0) {
-    console.log("");
-    warn("\uBBF8\uC791\uC131 \uC139\uC158:");
-    for (const m of result.missing) {
-      warn(`  - ${m}`);
-    }
-  }
-  for (const w of result.warnings) {
-    warn(w);
-  }
-  if (result.complete) {
-    console.log("");
-    success("PRD \uC644\uC131\uB3C4 \uAC80\uC99D \uD1B5\uACFC!");
-  } else {
-    console.log("");
-    info("docs/openspec.md\uB97C \uC5F4\uC5B4 \uBBF8\uC791\uC131 \uC139\uC158\uC744 \uCC44\uC6CC\uC8FC\uC138\uC694.");
-  }
-}
-var init_design_cmd = __esm({
-  "src/cli/commands/design.cmd.ts"() {
-    "use strict";
-    init_ui();
-    init_openspec();
-    init_omc();
-    init_config();
-  }
-});
-
-// src/stages/validation/runner.ts
-import { join as join14 } from "path";
-import fs20 from "fs-extra";
-async function runTests(cwd) {
-  const start = Date.now();
-  const gstackPath = join14(cwd, ".pai", "gstack.json");
-  let runner = "npm test";
-  if (await fs20.pathExists(gstackPath)) {
-    try {
-      const config = await fs20.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 {
-    }
-  }
-  const pkgPath = join14(cwd, "package.json");
-  if (await fs20.pathExists(pkgPath)) {
-    try {
-      const pkg5 = await fs20.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 {
-    }
-  }
+async function designInitCommand(cwd, options = {}) {
   try {
-    const { execa } = await import("execa");
-    const { stdout, stderr } = await execa("npm", ["test"], {
+    await withRoboco(
       cwd,
-      timeout: 12e4,
-      env: { ...process.env, CI: "true" }
+      "design",
+      "pai design init",
+      { skipGates: options.skipGates, force: options.force, gate: STAGE_GATES.design },
+      async () => {
+        section("\uC124\uACC4 \uD15C\uD50C\uB9BF \uC0DD\uC131");
+        const config = await loadConfig(cwd);
+        const projectName = config?.projectName ?? basename3(cwd);
+        await initOpenSpec(cwd, projectName);
+        await initOMC(cwd, projectName);
+        info("");
+        info("\uB2E4\uC74C \uB2E8\uACC4: docs/openspec.md\uB97C \uC5F4\uC5B4 PRD\uB97C \uC791\uC131\uD558\uC138\uC694.");
+      }
+    );
+    await syncHandoff(cwd).catch(() => {
     });
-    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
-    };
+    handleRobocoError(err);
   }
 }
-var init_runner = __esm({
-  "src/stages/validation/runner.ts"() {
-    "use strict";
-  }
-});
-
-// src/stages/validation/harness.ts
-import { join as join15 } from "path";
-import fs21 from "fs-extra";
-async function runHarnessCheck(cwd) {
-  const harnessPath = join15(cwd, ".pai", "harness.json");
-  if (!await fs21.pathExists(harnessPath)) {
-    return { enabled: false, specFile: null, rules: [], checks: [] };
-  }
-  let config;
+async function designValidateCommand(cwd, options = {}) {
   try {
-    config = await fs21.readJson(harnessPath);
-  } 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 fs21.pathExists(join15(cwd, specFile));
-    const srcExists = await fs21.pathExists(join15(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 fs21.pathExists(join15(cwd, "tests"));
-    const testDir2 = await fs21.pathExists(join15(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 };
-}
-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, {
-  validateCommand: () => validateCommand
-});
-async function validateCommand(cwd) {
-  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 env setup` \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}`);
+    await withRoboco(
+      cwd,
+      "design",
+      "pai design validate",
+      { skipGates: options.skipGates, force: options.force, gate: STAGE_GATES.design },
+      async () => {
+        section("PRD \uC644\uC131\uB3C4 \uAC80\uC99D");
+        const result = await validateOpenSpec(cwd);
+        info(`\uC139\uC158 \uC644\uC131\uB3C4: ${result.filledSections}/${result.totalSections}`);
+        if (result.missing.length > 0) {
+          console.log("");
+          warn("\uBBF8\uC791\uC131 \uC139\uC158:");
+          for (const m of result.missing) warn(`  - ${m}`);
+        }
+        for (const w of result.warnings) warn(w);
+        if (result.complete) {
+          console.log("");
+          success("PRD \uC644\uC131\uB3C4 \uAC80\uC99D \uD1B5\uACFC!");
+        } else {
+          console.log("");
+          info("docs/openspec.md\uB97C \uC5F4\uC5B4 \uBBF8\uC791\uC131 \uC139\uC158\uC744 \uCC44\uC6CC\uC8FC\uC138\uC694.");
+        }
       }
-    }
-  }
-  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.");
-    process.exitCode = 1;
-  } 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);
   }
 }
-var init_validate_cmd = __esm({
-  "src/cli/commands/validate.cmd.ts"() {
+var init_design_cmd = __esm({
+  "src/cli/commands/design.cmd.ts"() {
     "use strict";
     init_ui();
-    init_runner();
-    init_harness();
+    init_openspec();
+    init_omc();
+    init_config();
+    init_roboco();
+    init_gates();
+    init_validate_cmd();
   }
 });
 
@@ -6098,13 +6876,13 @@ var init_context = __esm({
 
 // src/stages/design/index.ts
 import { join as join16 } from "path";
-import fs22 from "fs-extra";
+import fs24 from "fs-extra";
 async function autoInstallHarness(cwd) {
   const harnessPath = join16(cwd, ".pai", "harness.json");
-  if (await fs22.pathExists(harnessPath)) return;
+  if (await fs24.pathExists(harnessPath)) return;
   await withSpinner("Harness Engineering \uC790\uB3D9 \uC124\uC815 \uC911...", async () => {
-    await fs22.ensureDir(join16(cwd, ".pai"));
-    await fs22.writeJson(harnessPath, {
+    await fs24.ensureDir(join16(cwd, ".pai"));
+    await fs24.writeJson(harnessPath, {
       version: "1.0",
       specFile: "docs/openspec.md",
       checkOn: ["pre-commit", "ci"],
@@ -6424,22 +7202,41 @@ __export(pipeline_cmd_exports, {
 });
 async function pipelineCommand(cwd, options) {
   printBanner();
-  const config = await loadConfig(cwd) ?? createDefaultConfig("my-project", "mockup");
-  const pipelineOpts = {};
-  if (options.from) {
-    pipelineOpts.from = options.from;
-  }
-  if (options.only) {
-    pipelineOpts.only = options.only.split(",").map((s) => s.trim());
+  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 syncHandoff(cwd).catch(() => {
+    });
+  } catch (err) {
+    handleRobocoError(err);
   }
-  await runPipeline(cwd, config, pipelineOpts);
 }
+var PIPELINE_TTL_MS;
 var init_pipeline_cmd = __esm({
   "src/cli/commands/pipeline.cmd.ts"() {
     "use strict";
+    init_ui();
     init_pipeline();
     init_config();
     init_ui();
+    init_roboco();
+    init_validate_cmd();
+    PIPELINE_TTL_MS = 30 * 60 * 1e3;
   }
 });
 
@@ -6461,7 +7258,7 @@ __export(remove_cmd_exports, {
   removeCommand: () => removeCommand
 });
 import { basename as basename4, dirname } from "path";
-import fs23 from "fs-extra";
+import fs25 from "fs-extra";
 async function removeCommand(cwd, options) {
   section("\uD504\uB85C\uC81D\uD2B8 \uC0AD\uC81C");
   const config = await loadConfig(cwd);
@@ -6479,7 +7276,7 @@ async function removeCommand(cwd, options) {
   console.log(colors.err(`  ${folderName}/ \uD3F4\uB354 \uC804\uCCB4\uAC00 \uC0AD\uC81C\uB429\uB2C8\uB2E4.`));
   hint("\uC774 \uC791\uC5C5\uC740 \uB418\uB3CC\uB9B4 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
   console.log("");
-  const items = await fs23.readdir(cwd);
+  const items = await fs25.readdir(cwd);
   const fileCount = items.filter((i) => !i.startsWith(".")).length;
   const hiddenCount = items.filter((i) => i.startsWith(".")).length;
   info(`\uD30C\uC77C/\uD3F4\uB354 ${fileCount}\uAC1C, \uC228\uAE40 \uD56D\uBAA9 ${hiddenCount}\uAC1C`);
@@ -6498,7 +7295,7 @@ async function removeCommand(cwd, options) {
   }
   process.chdir(parentDir);
   try {
-    await fs23.remove(cwd);
+    await fs25.remove(cwd);
     console.log("");
     success(`${folderName}/ \uD504\uB85C\uC81D\uD2B8\uAC00 \uC0AD\uC81C\uB418\uC5C8\uC2B5\uB2C8\uB2E4.`);
     try {
@@ -6777,7 +7574,7 @@ __export(savetoken_cmd_exports, {
   savetokenCommand: () => savetokenCommand
 });
 import { join as join17, relative } from "path";
-import fs24 from "fs-extra";
+import fs26 from "fs-extra";
 import chalk7 from "chalk";
 async function savetokenCommand(cwd) {
   const { createSpinner: createSpinner2 } = await Promise.resolve().then(() => (init_progress(), progress_exports));
@@ -6847,10 +7644,10 @@ async function savetokenCommand(cwd) {
   console.log(`  ${chalk7.red("\u25CF")} \uB192\uC74C   \uCF54\uB4DC \uC0DD\uC131, \uBCF5\uC7A1\uD55C \uCD94\uB860, \uCC3D\uC758\uC801 \uC0DD\uC131`);
   console.log(`         \u2192 ${colors.dim("AI \uD544\uC218 \u2014 \uD504\uB86C\uD504\uD2B8 \uCD5C\uC801\uD654\uB85C \uD1A0\uD070 \uC808\uAC10")}`);
   const reportDir = join17(cwd, ".pai");
-  await fs24.ensureDir(reportDir);
+  await fs26.ensureDir(reportDir);
   const report = buildReport(callSites, cwd);
   const reportPath = join17(reportDir, "savetoken-report.md");
-  await fs24.writeFile(reportPath, report, "utf8");
+  await fs26.writeFile(reportPath, report, "utf8");
   console.log("");
   success("\uC2A4\uCE94 \uB9AC\uD3EC\uD2B8 \uC800\uC7A5: .pai/savetoken-report.md");
   console.log("");
@@ -7008,7 +7805,7 @@ __export(wakeup_cmd_exports, {
 });
 import { join as join18 } from "path";
 import { homedir as homedir3, platform as osPlatform } from "os";
-import fs25 from "fs-extra";
+import fs27 from "fs-extra";
 import chalk8 from "chalk";
 async function wakeupCommand(timeOrAction, schedule = "\uD3C9\uC77C") {
   if (timeOrAction === "off") {
@@ -7055,9 +7852,9 @@ async function wakeupCommand(timeOrAction, schedule = "\uD3C9\uC77C") {
     projectDir,
     launchMode
   };
-  await fs25.ensureDir(PAI_DIR2);
-  await fs25.writeJson(CONFIG_FILE2, config, { spaces: 2 });
-  await fs25.writeJson(MESSAGES_FILE, MESSAGES);
+  await fs27.ensureDir(PAI_DIR2);
+  await fs27.writeJson(CONFIG_FILE2, config, { spaces: 2 });
+  await fs27.writeJson(MESSAGES_FILE, MESSAGES);
   await createWakeupScript(config);
   if (osPlatform() === "darwin") {
     await setupMacOS(config);
@@ -7088,7 +7885,7 @@ async function setupMacOS(config) {
   const { execa } = await import("execa");
   const [hour, minute] = config.time.split(":").map(Number);
   const plistDir = join18(homedir3(), "Library", "LaunchAgents");
-  await fs25.ensureDir(plistDir);
+  await fs27.ensureDir(plistDir);
   const weekdays = scheduleToWeekdays(config.schedule);
   let calendarEntries;
   if (weekdays.length === 7) {
@@ -7124,7 +7921,7 @@ ${calendarEntries}
   <string>${PAI_DIR2}/wakeup.log</string>
 </dict>
 </plist>`;
-  await fs25.writeFile(PLIST_PATH, plist);
+  await fs27.writeFile(PLIST_PATH, plist);
   await execa("launchctl", ["unload", PLIST_PATH]).catch(() => {
   });
   await execa("launchctl", ["load", PLIST_PATH]);
@@ -7147,7 +7944,7 @@ async function setupWindows(config) {
   const { execa } = await import("execa");
   const [hour, minute] = config.time.split(":").map(Number);
   const psScriptDir = join18(homedir3(), ".pai");
-  await fs25.ensureDir(psScriptDir);
+  await fs27.ensureDir(psScriptDir);
   const psScriptPath = join18(psScriptDir, "wakeup.ps1");
   const claudeCmd = config.launchMode === "yolo" ? "claude --dangerously-skip-permissions" : "claude";
   const psScript = `# PAI Wakeup \u2014 Claude Code \uC138\uC158 \uC790\uB3D9 \uC2DC\uC791
@@ -7177,7 +7974,7 @@ $notifier.Show([Windows.UI.Notifications.ToastNotification]::new($xml))
 # Open PowerShell with Claude Code
 Start-Process powershell -ArgumentList "-NoExit", "-Command", "Get-Content '$todayFile'; Write-Host ''; Set-Location '${config.projectDir}'; ${claudeCmd}"
 `;
-  await fs25.writeFile(psScriptPath, psScript, "utf8");
+  await fs27.writeFile(psScriptPath, psScript, "utf8");
   const daysMap = {
     "\uD3C9\uC77C": "MON,TUE,WED,THU,FRI",
     "\uB9E4\uC77C": "MON,TUE,WED,THU,FRI,SAT,SUN",
@@ -7225,7 +8022,7 @@ async function disableWakeup() {
   if (osPlatform() === "darwin") {
     await execa("launchctl", ["unload", PLIST_PATH]).catch(() => {
     });
-    await fs25.remove(PLIST_PATH).catch(() => {
+    await fs27.remove(PLIST_PATH).catch(() => {
     });
     success("launchd \uC2A4\uCF00\uC904 \uC81C\uAC70");
     console.log("");
@@ -7246,14 +8043,14 @@ async function disableWakeup() {
   } else {
     await removeCronEntry();
   }
-  await fs25.remove(CONFIG_FILE2).catch(() => {
+  await fs27.remove(CONFIG_FILE2).catch(() => {
   });
   console.log("");
   success("\u2600\uFE0F \uC6E8\uC774\uD06C\uC5C5 \uD574\uC81C \uC644\uB8CC");
 }
 async function showStatus() {
-  if (await fs25.pathExists(CONFIG_FILE2)) {
-    const config = await fs25.readJson(CONFIG_FILE2);
+  if (await fs27.pathExists(CONFIG_FILE2)) {
+    const config = await fs27.readJson(CONFIG_FILE2);
     console.log("");
     success("\u2600\uFE0F \uC6E8\uC774\uD06C\uC5C5 \uD65C\uC131\uD654");
     console.log(`  \uC2DC\uAC04       ${chalk8.white(config.time)}`);
@@ -7261,7 +8058,7 @@ async function showStatus() {
     console.log(`  \uD504\uB85C\uC81D\uD2B8   ${chalk8.white(config.projectDir)}`);
     console.log(`  \uBAA8\uB4DC       ${chalk8.white(config.launchMode === "yolo" ? "claude-YOLO mode" : "\uC77C\uBC18 \uBAA8\uB4DC")}`);
     if (osPlatform() === "darwin") {
-      const plistExists = await fs25.pathExists(PLIST_PATH);
+      const plistExists = await fs27.pathExists(PLIST_PATH);
       console.log(`  launchd    ${plistExists ? chalk8.green("\uD65C\uC131") : chalk8.red("\uBE44\uD65C\uC131")}`);
     }
     console.log("");
@@ -7414,7 +8211,7 @@ fi
 
 echo "[$(date)] PAI Wakeup completed" >> "$LOG_FILE"
 `;
-  await fs25.writeFile(SCRIPT_FILE, script, { mode: 493 });
+  await fs27.writeFile(SCRIPT_FILE, script, { mode: 493 });
 }
 var PAI_DIR2, CONFIG_FILE2, MESSAGES_FILE, SCRIPT_FILE, PLIST_NAME, PLIST_PATH, CRON_MARKER, MESSAGES;
 var init_wakeup_cmd = __esm({
@@ -7514,9 +8311,9 @@ function createProgram() {
     const { initCommand: initCommand2 } = await Promise.resolve().then(() => (init_init_cmd(), init_cmd_exports));
     await initCommand2(process.cwd(), projectName);
   });
-  program2.command("add").description("\uD50C\uB7EC\uADF8\uC778 \uCD94\uAC00 (Mockup \u2192 Production \uD655\uC7A5)").action(async () => {
+  program2.command("add").description("\uD50C\uB7EC\uADF8\uC778 \uCD94\uAC00 (Mockup \u2192 Production \uD655\uC7A5)").option("--skip-gates", "\uAC8C\uC774\uD2B8 \uACBD\uACE0\uB9CC \uCD9C\uB825\uD558\uACE0 \uC9C4\uD589").option("--force", "\uAC8C\uC774\uD2B8 \uC804\uBA74 \uBB34\uC2DC").action(async (options) => {
     const { addCommand } = await Promise.resolve().then(() => (init_add_cmd(), add_cmd_exports));
-    await addCommand(process.cwd());
+    await addCommand(process.cwd(), options);
   });
   program2.command("check").description("\uD658\uACBD \uC810\uAC80 (Node / Git / Claude Code)").action(async () => {
     const { checkCommand: checkCommand2 } = await Promise.resolve().then(() => (init_check_cmd(), check_cmd_exports));
@@ -7531,23 +8328,23 @@ function createProgram() {
     await helpCommand2();
   });
   const design = program2.command("design").description("\uC124\uACC4 \uAD00\uB9AC (OpenSpec / OMC)");
-  design.command("init").description("PRD/OMC \uD15C\uD50C\uB9BF \uC0DD\uC131").action(async () => {
+  design.command("init").description("PRD/OMC \uD15C\uD50C\uB9BF \uC0DD\uC131").option("--skip-gates", "\uAC8C\uC774\uD2B8 \uACBD\uACE0\uB9CC \uCD9C\uB825\uD558\uACE0 \uC9C4\uD589").option("--force", "\uAC8C\uC774\uD2B8 \uC804\uBA74 \uBB34\uC2DC").action(async (options) => {
     const { designInitCommand: designInitCommand2 } = await Promise.resolve().then(() => (init_design_cmd(), design_cmd_exports));
-    await designInitCommand2(process.cwd());
+    await designInitCommand2(process.cwd(), options);
   });
-  design.command("validate").description("PRD \uC644\uC131\uB3C4 \uAC80\uC99D").action(async () => {
+  design.command("validate").description("PRD \uC644\uC131\uB3C4 \uAC80\uC99D").option("--skip-gates", "\uAC8C\uC774\uD2B8 \uACBD\uACE0\uB9CC \uCD9C\uB825\uD558\uACE0 \uC9C4\uD589").option("--force", "\uAC8C\uC774\uD2B8 \uC804\uBA74 \uBB34\uC2DC").action(async (options) => {
     const { designValidateCommand: designValidateCommand2 } = await Promise.resolve().then(() => (init_design_cmd(), design_cmd_exports));
-    await designValidateCommand2(process.cwd());
+    await designValidateCommand2(process.cwd(), options);
   });
-  program2.command("test").description("\uD14C\uC2A4\uD2B8 / \uD558\uB124\uC2A4 \uAC80\uC99D \uC2E4\uD589").action(async () => {
+  program2.command("test").description("\uD14C\uC2A4\uD2B8 / \uD558\uB124\uC2A4 \uAC80\uC99D \uC2E4\uD589").option("--skip-gates", "\uAC8C\uC774\uD2B8 \uACBD\uACE0\uB9CC \uCD9C\uB825\uD558\uACE0 \uC9C4\uD589").option("--force", "\uAC8C\uC774\uD2B8 \uC804\uBA74 \uBB34\uC2DC").action(async (options) => {
     const { testCommand } = await Promise.resolve().then(() => (init_test_cmd(), test_cmd_exports));
-    await testCommand(process.cwd());
+    await testCommand(process.cwd(), options);
   });
-  program2.command("grade").description("AI \uAC1C\uBC1C \uC900\uBE44\uB3C4 \uD3C9\uAC00 (6\uCE74\uD14C\uACE0\uB9AC \uC810\uC218)").option("--fail-under <score>", "\uCD5C\uC18C \uC810\uC218 (\uBBF8\uB2EC \uC2DC exit 1)", parseInt).option("--verbose", "\uC0C1\uC138 findings \uCD9C\uB825").option("-o, --output <file>", "\uACB0\uACFC\uB97C \uD30C\uC77C\uB85C \uC800\uC7A5").option("--no-cache", "\uCE90\uC2DC \uBB34\uC2DC\uD558\uACE0 \uC0C8\uB85C \uBD84\uC11D").action(async (options) => {
+  program2.command("grade").description("AI \uAC1C\uBC1C \uC900\uBE44\uB3C4 \uD3C9\uAC00 (6\uCE74\uD14C\uACE0\uB9AC \uC810\uC218)").option("--fail-under <score>", "\uCD5C\uC18C \uC810\uC218 (\uBBF8\uB2EC \uC2DC exit 1)", parseInt).option("--verbose", "\uC0C1\uC138 findings \uCD9C\uB825").option("-o, --output <file>", "\uACB0\uACFC\uB97C \uD30C\uC77C\uB85C \uC800\uC7A5").option("--no-cache", "\uCE90\uC2DC \uBB34\uC2DC\uD558\uACE0 \uC0C8\uB85C \uBD84\uC11D").option("--skip-gates", "\uAC8C\uC774\uD2B8 \uACBD\uACE0\uB9CC \uCD9C\uB825\uD558\uACE0 \uC9C4\uD589").option("--force", "\uAC8C\uC774\uD2B8 \uC804\uBA74 \uBB34\uC2DC (\uCD5C\uADFC validation \uC5C6\uC5B4\uB3C4 \uC2E4\uD589)").action(async (options) => {
     const { gradeCommand } = await Promise.resolve().then(() => (init_grade_cmd(), grade_cmd_exports));
     await gradeCommand(process.cwd(), options);
   });
-  program2.command("run").description("\uC804\uCCB4 5\uB2E8\uACC4 \uD30C\uC774\uD504\uB77C\uC778 \uC2E4\uD589").option("--from <stage>", "\uD2B9\uC815 \uB2E8\uACC4\uBD80\uD130 \uC2E4\uD589").option("--only <stages>", "\uC120\uD0DD\uC801 \uB2E8\uACC4 \uC2E4\uD589 (\uC27C\uD45C \uAD6C\uBD84)").action(async (options) => {
+  program2.command("run").description("\uC804\uCCB4 5\uB2E8\uACC4 \uD30C\uC774\uD504\uB77C\uC778 \uC2E4\uD589").option("--from <stage>", "\uD2B9\uC815 \uB2E8\uACC4\uBD80\uD130 \uC2E4\uD589").option("--only <stages>", "\uC120\uD0DD\uC801 \uB2E8\uACC4 \uC2E4\uD589 (\uC27C\uD45C \uAD6C\uBD84)").option("--skip-gates", "\uAC8C\uC774\uD2B8 \uACBD\uACE0\uB9CC \uCD9C\uB825\uD558\uACE0 \uC9C4\uD589").option("--force", "\uAC8C\uC774\uD2B8 \uC804\uBA74 \uBB34\uC2DC").action(async (options) => {
     const { runCommand } = await Promise.resolve().then(() => (init_run_cmd(), run_cmd_exports));
     await runCommand(process.cwd(), options);
   });