@dmsdc-ai/aigentry-deliberation 0.0.15 → 0.0.18

package/README.md

@@ -53,6 +53,21 @@ cd aigentry-deliberation && npm install && node install.js
 npx @dmsdc-ai/aigentry-deliberation uninstall
 ```
 
+## Forum Demo
+
+Deliberation이 완료되면 결과를 시각화하는 Forum View를 생성합니다.
+
+> **Deliberation = 프로세스, Forum = 출력물.**
+> Deliberation이 끝나면 Forum이 생성되고, 그게 끝입니다.
+
+![Forum Demo](demo/forum/assets/hero.png)
+
+정적 데모를 브라우저에서 확인하려면:
+
+```bash
+open demo/forum/index.html
+```
+
 ## MCP Tools
 
 | Tool | Description |
@@ -71,6 +86,7 @@ npx @dmsdc-ai/aigentry-deliberation uninstall
 | `deliberation_browser_auto_turn` | Auto-send turn to browser LLM |
 | `deliberation_route_turn` | Route turn to appropriate transport |
 | `deliberation_request_review` | Request code review |
+| `deliberation_cli_auto_turn` | Auto-send turn to CLI speaker |
 | `deliberation_cli_config` | Configure CLI settings |
 
 ## Speaker Ordering Strategies

package/browser-control-port.js

@@ -420,6 +420,10 @@ class DevToolsMcpAdapter extends BrowserControlPort {
               type: "rawKeyDown", key: "Enter", code: "Enter",
               windowsVirtualKeyCode: 13, nativeVirtualKeyCode: 13,
             });
+            await this._cdpCommand(binding, "Input.dispatchKeyEvent", {
+              type: "char", key: "\r", code: "Enter",
+              windowsVirtualKeyCode: 13, nativeVirtualKeyCode: 13,
+            });
             await this._cdpCommand(binding, "Input.dispatchKeyEvent", {
               type: "keyUp", key: "Enter", code: "Enter",
               windowsVirtualKeyCode: 13, nativeVirtualKeyCode: 13,

package/index.js

@@ -54,6 +54,7 @@ Usage:
  *   deliberation_speaker_candidates      선택 가능한 스피커 후보(로컬 CLI + 브라우저 LLM 탭) 조회
  *   deliberation_browser_llm_tabs      브라우저 LLM 탭 목록 조회
  *   deliberation_browser_auto_turn      브라우저 LLM에 자동으로 턴을 전송하고 응답을 수집 (CDP 기반)
+ *   deliberation_cli_auto_turn          CLI speaker에 자동으로 턴을 전송하고 응답을 수집
  *   deliberation_request_review         코드 리뷰 요청 (CLI 리뷰어 자동 호출, sync/async 모드)
  */
 
@@ -280,7 +281,7 @@ const DEGRADATION_TIERS = {
     tier3: { name: "manual", description: "완전 수동 복사/붙여넣기", check: () => true },
   },
   terminal: {
-    tier1: { name: "auto_open", description: "터미널 앱 자동 오픈", check: () => process.platform === "darwin" || process.platform === "win32" },
+    tier1: { name: "auto_open", description: "터미널 앱 자동 오픈", check: () => process.platform === "darwin" || process.platform === "linux" || process.platform === "win32" },
     tier2: { name: "none", description: "터미널 자동 오픈 불가", check: () => true },
     tier3: { name: "none", description: "터미널 자동 오픈 불가", check: () => true },
   },
@@ -869,37 +870,82 @@ async function ensureCdpAvailable() {
     } catch { /* not reachable */ }
   }
 
-  // If none respond and platform is macOS, try auto-launching Chrome with CDP
-  if (process.platform === "darwin") {
+  // Auto-launch Chrome with CDP on macOS, Linux, and Windows
+  {
+    let chromeBin, chromeUserDataDir;
+
+    if (process.platform === "darwin") {
+      chromeBin = "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome";
+      chromeUserDataDir = path.join(os.homedir(), "Library", "Application Support", "Google", "Chrome");
+    } else if (process.platform === "linux") {
+      const chromeCandidates = ["google-chrome", "google-chrome-stable", "google-chrome-beta", "chromium-browser", "chromium"];
+      chromeBin = chromeCandidates.find(c => commandExistsInPath(c)) || null;
+      if (!chromeBin) {
+        return {
+          available: false,
+          reason: "Chrome/Chromium을 찾을 수 없습니다. google-chrome 또는 chromium을 설치하고 --remote-debugging-port=9222 옵션과 함께 실행해주세요.",
+        };
+      }
+      const googleDir = path.join(os.homedir(), ".config", "google-chrome");
+      const chromiumDir = path.join(os.homedir(), ".config", "chromium");
+      chromeUserDataDir = fs.existsSync(googleDir) ? googleDir : fs.existsSync(chromiumDir) ? chromiumDir : null;
+    } else if (process.platform === "win32") {
+      const programFiles = process.env.PROGRAMFILES || "C:\\Program Files";
+      const programFilesX86 = process.env["PROGRAMFILES(X86)"] || "C:\\Program Files (x86)";
+      const localAppData = process.env.LOCALAPPDATA || path.join(os.homedir(), "AppData", "Local");
+      const winCandidates = [
+        path.join(programFiles, "Google", "Chrome", "Application", "chrome.exe"),
+        path.join(programFilesX86, "Google", "Chrome", "Application", "chrome.exe"),
+        path.join(localAppData, "Google", "Chrome", "Application", "chrome.exe"),
+        path.join(programFilesX86, "Microsoft", "Edge", "Application", "msedge.exe"),
+        path.join(programFiles, "Microsoft", "Edge", "Application", "msedge.exe"),
+      ];
+      chromeBin = winCandidates.find(p => fs.existsSync(p)) || null;
+      if (!chromeBin) {
+        return {
+          available: false,
+          reason: "Chrome/Edge를 찾을 수 없습니다. Chrome을 설치하거나 --remote-debugging-port=9222 옵션과 함께 실행해주세요.",
+        };
+      }
+      const chromeDir = path.join(localAppData, "Google", "Chrome", "User Data");
+      const edgeDir = path.join(localAppData, "Microsoft", "Edge", "User Data");
+      chromeUserDataDir = fs.existsSync(chromeDir) ? chromeDir : fs.existsSync(edgeDir) ? edgeDir : null;
+    } else {
+      return {
+        available: false,
+        reason: "Chrome CDP를 활성화할 수 없습니다. Chrome을 --remote-debugging-port=9222 옵션과 함께 실행해주세요.",
+      };
+    }
+
     // Chrome 145+ requires --user-data-dir for CDP to work.
     // The default data dir is rejected, so we copy the profile to ~/.chrome-cdp.
-    const chromeUserDataDir = path.join(os.homedir(), "Library", "Application Support", "Google", "Chrome");
     const cdpDataDir = path.join(os.homedir(), ".chrome-cdp");
     const profileDir = "Default";
 
     try {
-      const srcProfile = path.join(chromeUserDataDir, profileDir);
-      const dstProfile = path.join(cdpDataDir, profileDir);
-      if (!fs.existsSync(dstProfile) && fs.existsSync(srcProfile)) {
-        fs.mkdirSync(cdpDataDir, { recursive: true });
-        execFileSync("cp", ["-R", srcProfile, dstProfile], { timeout: 30000, stdio: "ignore" });
-        // Create minimal Local State with single profile to avoid profile picker
-        const localStateSrc = path.join(chromeUserDataDir, "Local State");
-        if (fs.existsSync(localStateSrc)) {
-          const state = JSON.parse(fs.readFileSync(localStateSrc, "utf8"));
-          state.profile.profiles_created = 1;
-          state.profile.last_used = profileDir;
-          if (state.profile.info_cache) {
-            const kept = {};
-            if (state.profile.info_cache[profileDir]) kept[profileDir] = state.profile.info_cache[profileDir];
-            state.profile.info_cache = kept;
+      if (chromeUserDataDir) {
+        const srcProfile = path.join(chromeUserDataDir, profileDir);
+        const dstProfile = path.join(cdpDataDir, profileDir);
+        if (!fs.existsSync(dstProfile) && fs.existsSync(srcProfile)) {
+          fs.mkdirSync(cdpDataDir, { recursive: true });
+          execFileSync("cp", ["-R", srcProfile, dstProfile], { timeout: 30000, stdio: "ignore" });
+          // Create minimal Local State with single profile to avoid profile picker
+          const localStateSrc = path.join(chromeUserDataDir, "Local State");
+          if (fs.existsSync(localStateSrc)) {
+            const state = JSON.parse(fs.readFileSync(localStateSrc, "utf8"));
+            state.profile.profiles_created = 1;
+            state.profile.last_used = profileDir;
+            if (state.profile.info_cache) {
+              const kept = {};
+              if (state.profile.info_cache[profileDir]) kept[profileDir] = state.profile.info_cache[profileDir];
+              state.profile.info_cache = kept;
+            }
+            fs.writeFileSync(path.join(cdpDataDir, "Local State"), JSON.stringify(state));
           }
-          fs.writeFileSync(path.join(cdpDataDir, "Local State"), JSON.stringify(state));
         }
       }
     } catch { /* proceed with launch attempt anyway */ }
 
-    const chromeBin = "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome";
     const launchArgs = [
       "--remote-debugging-port=9222",
       "--remote-allow-origins=*",
@@ -914,7 +960,7 @@ async function ensureCdpAvailable() {
     } catch {
       return {
         available: false,
-        reason: "Chrome 자동 실행에 실패했습니다. Chrome을 수동으로 --remote-debugging-port=9222 --user-data-dir=~/.chrome-cdp 옵션과 함께 실행해주세요.",
+        reason: `Chrome 자동 실행에 실패했습니다. Chrome을 수동으로 --remote-debugging-port=9222 --user-data-dir=~/.chrome-cdp 옵션과 함께 실행해주세요.`,
       };
     }
 
@@ -937,7 +983,7 @@ async function ensureCdpAvailable() {
     };
   }
 
-  // Non-macOS: cannot auto-launch
+  // Unreachable (all platforms handled above), but keep as safety net
   return {
     available: false,
     reason: "Chrome CDP를 활성화할 수 없습니다. Chrome을 --remote-debugging-port=9222 옵션과 함께 실행해주세요.",
@@ -2275,7 +2321,7 @@ function submitDeliberationTurn({ session_id, speaker, content, turn_id, channel
         return {
           content: [{
             type: "text",
-            text: `✅ [${state.id}] ${normalizedSpeaker} Round ${state.log[state.log.length - 1].round} 완료.\n\n🏁 **모든 라운드 종료!**\ndeliberation_synthesize(session_id: "${state.id}")로 합성 보고서를 작성하세요.`,
+            text: `✅ [${state.id}] ${normalizedSpeaker} Round ${state.log[state.log.length - 1].round} 완료. Forum 업데이트됨 (${state.log.length}건 응답 축적).\n\n🏁 **모든 라운드 종료!**\ndeliberation_synthesize(session_id: "${state.id}")로 합성 보고서를 작성하세요.`,
           }],
         };
       }
@@ -2290,7 +2336,7 @@ function submitDeliberationTurn({ session_id, speaker, content, turn_id, channel
     return {
       content: [{
         type: "text",
-        text: `✅ [${state.id}] ${normalizedSpeaker} Round ${state.log[state.log.length - 1].round} 완료.\n\n**다음:** ${state.current_speaker} (Round ${state.current_round})`,
+        text: `✅ [${state.id}] ${normalizedSpeaker} Round ${state.log[state.log.length - 1].round} 완료. Forum 업데이트됨 (${state.log.length}건 응답 축적).\n\n**다음:** ${state.current_speaker} (Round ${state.current_round})`,
       }],
     };
   });
@@ -2576,7 +2622,7 @@ server.tool(
     return {
       content: [{
         type: "text",
-        text: `✅ Deliberation 시작!\n\n**세션:** ${sessionId}\n**프로젝트:** ${state.project}\n**주제:** ${topic}\n**라운드:** ${rounds}\n**발언 순서:** ${state.ordering_strategy || "cyclic"}\n**참가자 구성:** ${participantMode}\n**참가자:** ${speakerOrder.join(", ")}\n**첫 발언:** ${state.current_speaker}\n**동시 진행 세션:** ${active.length}개${terminalMsg}${detectWarning}\n\n**역할 배정:**${role_preset ? ` (프리셋: ${role_preset})` : ""}\n${speakerOrder.map(s => `  - \`${s}\`: ${(state.speaker_roles || {})[s] || "free"}`).join("\n")}\n\n**환경 상태:**\n${formatDegradationReport(state.degradation)}\n\n**Transport 라우팅:**\n${transportSummary}\n\n💡 이후 도구 호출 시 session_id: "${sessionId}" 를 사용하세요.`,
+        text: `✅ Deliberation 시작! Forum이 생성되었습니다.\n\n**세션:** ${sessionId}\n**프로젝트:** ${state.project}\n**주제:** ${topic}\n**라운드:** ${rounds}\n**발언 순서:** ${state.ordering_strategy || "cyclic"}\n**참가자 구성:** ${participantMode}\n**참가자:** ${speakerOrder.join(", ")}\n**첫 발언:** ${state.current_speaker}\n**동시 진행 세션:** ${active.length}개${terminalMsg}${detectWarning}\n\n**역할 배정:**${role_preset ? ` (프리셋: ${role_preset})` : ""}\n${speakerOrder.map(s => `  - \`${s}\`: ${(state.speaker_roles || {})[s] || "free"}`).join("\n")}\n\n**환경 상태:**\n${formatDegradationReport(state.degradation)}\n\n**Transport 라우팅:**\n${transportSummary}\n\n💡 이후 도구 호출 시 session_id: "${sessionId}" 를 사용하세요.\n📋 Forum 상태 조회: \`deliberation_status(session_id: "${sessionId}")\``,
       }],
     };
   })
@@ -2637,7 +2683,7 @@ server.tool(
     return {
       content: [{
         type: "text",
-        text: `**세션:** ${state.id}\n**프로젝트:** ${state.project}\n**주제:** ${state.topic}\n**상태:** ${state.status}\n**라운드:** ${state.current_round}/${state.max_rounds}\n**참가자:** ${state.speakers.join(", ")}\n**현재 차례:** ${state.current_speaker}\n**응답 수:** ${state.log.length}${state.degradation ? `\n\n**환경 상태:**\n${formatDegradationReport(state.degradation)}` : ""}`,
+        text: `📋 **Forum 현황** — ${state.id}\n\n**프로젝트:** ${state.project}\n**주제:** ${state.topic}\n**상태:** ${state.status === "active" ? "진행 중" : state.status === "awaiting_synthesis" ? "합성 대기" : state.status === "completed" ? "완성" : state.status} (Round ${state.current_round}/${state.max_rounds})\n**참가자:** ${state.speakers.join(", ")}\n**현재 차례:** ${state.current_speaker}\n**축적 응답:** ${state.log.length}건${state.degradation ? `\n\n**환경 상태:**\n${formatDegradationReport(state.degradation)}` : ""}`,
       }],
     };
   }
@@ -2894,6 +2940,153 @@ server.tool(
   })
 );
 
+server.tool(
+  "deliberation_cli_auto_turn",
+  "CLI speaker에 자동으로 턴을 전송하고 응답을 수집합니다.",
+  {
+    session_id: z.string().optional().describe("세션 ID (여러 세션 진행 중이면 필수)"),
+    timeout_sec: z.number().optional().default(120).describe("CLI 응답 대기 타임아웃 (초)"),
+  },
+  safeToolHandler("deliberation_cli_auto_turn", async ({ session_id, timeout_sec }) => {
+    const resolved = resolveSessionId(session_id);
+    if (!resolved) {
+      return { content: [{ type: "text", text: "활성 deliberation이 없습니다." }] };
+    }
+    if (resolved === "MULTIPLE") {
+      return { content: [{ type: "text", text: multipleSessionsError() }] };
+    }
+
+    const state = loadSession(resolved);
+    if (!state || state.status !== "active") {
+      return { content: [{ type: "text", text: `세션 "${resolved}"이 활성 상태가 아닙니다.` }] };
+    }
+
+    const speaker = state.current_speaker;
+    if (speaker === "none") {
+      return { content: [{ type: "text", text: "현재 발언 차례인 speaker가 없습니다." }] };
+    }
+
+    const { transport } = resolveTransportForSpeaker(state, speaker);
+    if (transport !== "cli_respond") {
+      return { content: [{ type: "text", text: `speaker "${speaker}"는 CLI 타입이 아닙니다 (transport: ${transport}). 브라우저 speaker는 deliberation_browser_auto_turn을 사용하세요.` }] };
+    }
+
+    const hint = CLI_INVOCATION_HINTS[speaker];
+    if (!hint) {
+      return { content: [{ type: "text", text: `speaker "${speaker}"에 대한 CLI 호출 정보가 없습니다. CLI_INVOCATION_HINTS에 등록되지 않은 speaker입니다.` }] };
+    }
+
+    // Check CLI liveness
+    if (!checkCliLiveness(hint.cmd)) {
+      return { content: [{ type: "text", text: `❌ CLI "${hint.cmd}"가 설치되어 있지 않거나 실행할 수 없습니다.` }] };
+    }
+
+    const turnId = state.pending_turn_id || generateTurnId();
+    const turnPrompt = buildClipboardTurnPrompt(state, speaker, null, 3);
+
+    // Spawn CLI process
+    const startTime = Date.now();
+    try {
+      const response = await new Promise((resolve, reject) => {
+        const env = { ...process.env };
+        // Unset CLAUDECODE for claude to avoid nested session errors
+        if (hint.envPrefix?.includes("CLAUDECODE=")) {
+          delete env.CLAUDECODE;
+        }
+
+        let child;
+        let stdout = "";
+        let stderr = "";
+
+        // Different invocation patterns per CLI
+        switch (speaker) {
+          case "claude":
+            child = spawn("claude", ["-p", "--output-format", "text"], { env, windowsHide: true });
+            child.stdin.write(turnPrompt);
+            child.stdin.end();
+            break;
+          case "codex":
+            child = spawn("codex", ["exec", turnPrompt], { env, windowsHide: true });
+            break;
+          case "gemini":
+            child = spawn("gemini", ["-p", turnPrompt], { env, windowsHide: true });
+            break;
+          default: {
+            // Generic: try command with prompt as argument
+            const flags = hint.flags ? hint.flags.split(/\s+/) : [];
+            child = spawn(hint.cmd, [...flags, turnPrompt], { env, windowsHide: true });
+            break;
+          }
+        }
+
+        const timer = setTimeout(() => {
+          child.kill("SIGTERM");
+          reject(new Error(`CLI 타임아웃 (${timeout_sec}초)`));
+        }, timeout_sec * 1000);
+
+        child.stdout.on("data", (data) => { stdout += data.toString(); });
+        child.stderr.on("data", (data) => { stderr += data.toString(); });
+
+        child.on("close", (code) => {
+          clearTimeout(timer);
+          if (code !== 0 && !stdout.trim()) {
+            reject(new Error(`CLI exit code ${code}: ${stderr.slice(0, 500)}`));
+          } else {
+            // Clean up output noise
+            let cleaned = stdout;
+            if (speaker === "codex") {
+              cleaned = stdout.split("\n")
+                .filter(line => !/^(OpenAI Codex|--------|workdir:|model:|provider:|approval:|sandbox:|reasoning|session id:|user$|mcp:|thinking$|tokens used$|^[0-9,]*$)/.test(line))
+                .join("\n");
+            } else if (speaker === "gemini") {
+              cleaned = stdout.split("\n")
+                .filter(line => !/^(Loaded cached|Error during discovery)/.test(line))
+                .join("\n");
+            }
+            resolve(cleaned.trim());
+          }
+        });
+
+        child.on("error", (err) => {
+          clearTimeout(timer);
+          reject(err);
+        });
+      });
+
+      const elapsedMs = Date.now() - startTime;
+
+      if (!response) {
+        return { content: [{ type: "text", text: `⚠️ CLI "${speaker}"가 빈 응답을 반환했습니다.` }] };
+      }
+
+      // Submit the response
+      const result = submitDeliberationTurn({
+        session_id: resolved,
+        speaker,
+        content: response,
+        turn_id: turnId,
+        channel_used: "cli_auto",
+        fallback_reason: null,
+      });
+
+      return {
+        content: [{
+          type: "text",
+          text: `✅ CLI 자동 턴 완료!\n\n**Speaker:** ${speaker}\n**CLI:** ${hint.cmd}\n**Turn ID:** ${turnId}\n**응답 길이:** ${response.length}자\n**소요 시간:** ${elapsedMs}ms\n\n${result.content[0].text}`,
+        }],
+      };
+
+    } catch (err) {
+      return {
+        content: [{
+          type: "text",
+          text: `❌ CLI 자동 턴 실패: ${err.message}\n\n**Speaker:** ${speaker}\n**CLI:** ${hint.cmd}\n\ndeliberation_respond(speaker: "${speaker}", content: "...")로 수동 응답을 제출할 수 있습니다.`,
+        }],
+      };
+    }
+  })
+);
+
 server.tool(
   "deliberation_respond",
   "현재 턴의 응답을 제출합니다.",
@@ -2905,6 +3098,32 @@ server.tool(
     turn_id: z.string().optional().describe("턴 검증 ID (deliberation_route_turn에서 받은 값)"),
   },
   safeToolHandler("deliberation_respond", async ({ session_id, speaker, content, content_file, turn_id }) => {
+    // Guard: prevent orchestrator from fabricating responses for CLI/browser speakers
+    const resolved = resolveSessionId(session_id);
+    if (resolved && resolved !== "MULTIPLE") {
+      const state = loadSession(resolved);
+      if (state) {
+        const { transport } = resolveTransportForSpeaker(state, speaker);
+        if (transport === "cli_respond" || transport === "browser_auto") {
+          // Check if caller is the same speaker (legitimate self-response) or an impersonator
+          const callerIsSpeaker = (speaker === "claude"); // orchestrator can only legitimately respond as "claude"
+          if (!callerIsSpeaker) {
+            return {
+              content: [{
+                type: "text",
+                text: `⚠️ **대리 응답 차단**: speaker "${speaker}"는 ${transport} transport입니다.\n\n` +
+                  `오케스트레이터가 다른 speaker를 대신하여 응답을 작성하는 것은 허용되지 않습니다.\n` +
+                  `대신 다음 도구를 사용하세요:\n` +
+                  `- CLI speaker → \`deliberation_route_turn\` 또는 \`deliberation_cli_auto_turn\`\n` +
+                  `- 브라우저 speaker → \`deliberation_route_turn\` 또는 \`deliberation_browser_auto_turn\`\n\n` +
+                  `이 도구들이 실제 CLI/브라우저를 실행하여 진짜 응답을 수집합니다.`,
+              }],
+            };
+          }
+        }
+      }
+    }
+
     // Support reading content from file to avoid JSON escaping issues
     let finalContent = content;
     if (content_file && !content) {
@@ -3001,7 +3220,7 @@ server.tool(
     return {
       content: [{
         type: "text",
-        text: `✅ [${state.id}] Deliberation 완료!\n\n**프로젝트:** ${state.project}\n**주제:** ${state.topic}\n**라운드:** ${state.max_rounds}\n**응답:** ${state.log.length}건\n\n📁 ${archivePath}\n🖥️ 모니터 터미널이 즉시 강제 종료되었습니다.`,
+        text: `✅ [${state.id}] Deliberation 완료! Forum이 완성되었습니다.\n\n**프로젝트:** ${state.project}\n**주제:** ${state.topic}\n**라운드:** ${state.max_rounds}\n**응답:** ${state.log.length}건\n\n📁 Forum 최종본: ${archivePath}\n🖥️ 모니터 터미널이 즉시 강제 종료되었습니다.`,
       }],
     };
   })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dmsdc-ai/aigentry-deliberation",
-  "version": "0.0.15",
+  "version": "0.0.18",
   "description": "MCP Deliberation Server — Multi-session AI deliberation with smart speaker ordering and persona roles",
   "type": "module",
   "license": "MIT",

package/skills/deliberation/SKILL.md

@@ -54,11 +54,24 @@ Claude/Codex를 포함해 MCP를 지원하는 임의 CLI들이 구조화된 토
 - "크롬", "브라우저", "웹 LLM", "chrome", "browser LLM"
 - "{주제} 토론", "{주제} deliberation"
 
+## 절대 규칙 (MUST / NEVER)
+
+> **이 규칙은 예외 없이 반드시 지켜야 합니다.**
+
+1. **MUST** — 토론 시작 전 반드시 `deliberation_speaker_candidates`로 후보 조회 후 `AskUserQuestion(multiSelect)`으로 사용자에게 참가자 선택을 받아야 합니다.
+2. **MUST** — 각 턴 진행 시 반드시 `deliberation_route_turn`을 사용해야 합니다. 이 도구가 transport를 자동 감지합니다:
+   - CLI speaker → `deliberation_cli_auto_turn`으로 실제 CLI 실행
+   - browser_auto → CDP로 자동 전송/수집
+   - clipboard/manual → 클립보드 준비 + 사용자 안내
+3. **NEVER** — 오케스트레이터(자기 자신)가 다른 speaker를 대신하여 `deliberation_respond`에 응답을 작성하지 마세요. 이것은 "역할극"이며 실제 deliberation이 아닙니다. MCP 서버가 이를 감지하고 차단합니다.
+4. **NEVER** — `deliberation_respond`를 직접 호출하지 마세요 (자기 자신의 응답 제외). 다른 speaker의 턴은 반드시 `deliberation_route_turn` 또는 `deliberation_cli_auto_turn`/`deliberation_browser_auto_turn`을 통해 진행합니다.
+5. **MUST** — 자기 자신(오케스트레이터 역할의 claude)이 speaker인 경우에만 직접 `deliberation_respond`로 응답을 제출할 수 있습니다.
+
 ## 워크플로우
 
 ### A. 사용자 선택형 진행 (권장)
 1. `deliberation_speaker_candidates` → 참가 가능한 CLI/브라우저 speaker 확인
-2. **AskUserQuestion으로 참가자 선택** — 감지된 CLI/브라우저 speaker 목록을 `multiSelect: true`로 제시하여 사용자가 원하는 참가자만 체크. 예:
+2. **AskUserQuestion으로 참가자 선택 (필수)** — 감지된 CLI/브라우저 speaker 목록을 `multiSelect: true`로 제시하여 사용자가 원하는 참가자만 체크. 예:
    ```
    AskUserQuestion({
      questions: [{
@@ -77,9 +90,10 @@ Claude/Codex를 포함해 MCP를 지원하는 임의 CLI들이 구조화된 토
    })
    ```
 3. `deliberation_start` (선택된 speakers 전달) → session_id 획득
-4. `deliberation_route_turn` → 현재 차례 speaker transport 자동 결정
-   - CLI speaker → 자동 응답
+4. **`deliberation_route_turn` 호출 (필수)** → 현재 차례 speaker transport 자동 결정 및 실행
+   - CLI speaker → `deliberation_cli_auto_turn`이 실제 CLI를 실행하고 응답 수집
    - browser_auto → CDP로 자동 전송/수집
+   - 자기 자신(claude)이 speaker → 직접 `deliberation_respond`로 응답 제출
 5. 반복 후 `deliberation_synthesize(session_id)` → 합성 완료
 6. 구현이 필요하면 `deliberation-executor` 스킬로 handoff
    예: "session_id {id} 합의안 구현해줘"