cc-viewer 1.6.151 → 1.6.152

package/cli.js

@@ -6,7 +6,7 @@ import { fileURLToPath } from 'node:url';
 import { homedir } from 'node:os';
 import { spawn } from 'node:child_process';
 import { t } from './i18n.js';
-import { INJECT_IMPORT, resolveCliPath, resolveNativePath, resolveNpmClaudePath, buildShellCandidates } from './findcc.js';
+import { INJECT_IMPORT, resolveCliPath, resolveNativePath, resolveNpmClaudePath, buildShellCandidates, setLogDir, LOG_DIR } from './findcc.js';
 import { ensureHooks } from './lib/ensure-hooks.js';
 
 const __dirname = fileURLToPath(new URL('.', import.meta.url));
@@ -259,7 +259,7 @@ async function runProxyCommand(args) {
 
 // ensureHooks() extracted to lib/ensure-hooks.js (shared with electron/tab-worker.js)
 
-async function runCliMode(extraClaudeArgs = [], cwd) {
+async function runCliMode(extraClaudeArgs = [], cwd, noOpen = false) {
   // 首先尝试 npm 版本（包括 nvm 安装），找不到再尝试 native 版本
   let claudePath = resolveNpmClaudePath();
   let isNpmVersion = !!claudePath;
@@ -328,11 +328,13 @@ async function runCliMode(extraClaudeArgs = [], cwd) {
   // 4. 自动打开浏览器
   const protocol = serverMod.getProtocol();
   const url = `${protocol}://127.0.0.1:${port}`;
-  try {
-    const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
-    const { execSync } = await import('node:child_process');
-    execSync(`${cmd} ${url}`, { stdio: 'ignore', timeout: 5000 });
-  } catch {}
+  if (!noOpen) {
+    try {
+      const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
+      const { execSync } = await import('node:child_process');
+      execSync(`${cmd} ${url}`, { stdio: 'ignore', timeout: 5000 });
+    } catch {}
+  }
 
   console.log(`CC Viewer:`);
   console.log(`  ➜ Local:   ${url}`);
@@ -351,7 +353,7 @@ async function runCliMode(extraClaudeArgs = [], cwd) {
   process.on('SIGTERM', cleanup);
 }
 
-async function runSdkMode(extraClaudeArgs = [], cwd) {
+async function runSdkMode(extraClaudeArgs = [], cwd, noOpen = false) {
   // 检查 SDK 是否可用
   let sdkManager;
   try {
@@ -359,7 +361,7 @@ async function runSdkMode(extraClaudeArgs = [], cwd) {
     if (!sdkManager.isSdkAvailable()) throw new Error('query not available');
   } catch {
     console.warn('[CC Viewer] Agent SDK not available, falling back to PTY mode (-C)');
-    return runCliMode(extraClaudeArgs, cwd);
+    return runCliMode(extraClaudeArgs, cwd, noOpen);
   }
 
   const workingDir = cwd || process.cwd();
@@ -415,11 +417,13 @@ async function runSdkMode(extraClaudeArgs = [], cwd) {
   // 自动打开浏览器
   const protocol = serverMod.getProtocol();
   const url = `${protocol}://127.0.0.1:${port}`;
-  try {
-    const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
-    const { execSync } = await import('node:child_process');
-    execSync(`${cmd} ${url}`, { stdio: 'ignore', timeout: 5000 });
-  } catch {}
+  if (!noOpen) {
+    try {
+      const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
+      const { execSync } = await import('node:child_process');
+      execSync(`${cmd} ${url}`, { stdio: 'ignore', timeout: 5000 });
+    } catch {}
+  }
 
   console.log(`CC Viewer (SDK mode):`);
   console.log(`  ➜ Local:   ${url}`);
@@ -438,7 +442,7 @@ async function runSdkMode(extraClaudeArgs = [], cwd) {
   process.on('SIGTERM', cleanup);
 }
 
-async function runCliModeWorkspaceSelector(extraClaudeArgs = []) {
+async function runCliModeWorkspaceSelector(extraClaudeArgs = [], noOpen = false) {
   // 首先尝试 npm 版本（包括 nvm 安装），找不到再尝试 native 版本
   let claudePath = resolveNpmClaudePath();
   let isNpmVersion = !!claudePath;
@@ -477,11 +481,13 @@ async function runCliModeWorkspaceSelector(extraClaudeArgs = []) {
   // 自动打开浏览器
   const wsProtocol = serverMod.getProtocol();
   const url = `${wsProtocol}://127.0.0.1:${port}`;
-  try {
-    const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
-    const { execSync } = await import('node:child_process');
-    execSync(`${cmd} ${url}`, { stdio: 'ignore', timeout: 5000 });
-  } catch {}
+  if (!noOpen) {
+    try {
+      const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
+      const { execSync } = await import('node:child_process');
+      execSync(`${cmd} ${url}`, { stdio: 'ignore', timeout: 5000 });
+    } catch {}
+  }
 
   console.log(`CC Viewer (Workspace):`);
   console.log(`  ➜ Local:   ${url}`);
@@ -505,6 +511,34 @@ async function runCliModeWorkspaceSelector(extraClaudeArgs = []) {
 
 const args = process.argv.slice(2);
 
+// --- CCV 专属参数提取（必须在动态 import 之前） ---
+let noOpen = false;
+
+// 提取 --log-dir <path>
+const logDirIdx = args.indexOf('--log-dir');
+if (logDirIdx !== -1) {
+  const logDirVal = args[logDirIdx + 1];
+  if (logDirVal && !logDirVal.startsWith('-')) {
+    const prevDir = LOG_DIR;
+    setLogDir(logDirVal);
+    if (LOG_DIR === prevDir) {
+      console.error(`Error: --log-dir path rejected (must be under home directory or /tmp/): ${logDirVal}`);
+      process.exit(1);
+    }
+    args.splice(logDirIdx, 2);
+  } else {
+    console.error('Error: --log-dir requires a path argument');
+    process.exit(1);
+  }
+}
+
+// 提取 --no-open
+const noOpenIdx = args.indexOf('--no-open');
+if (noOpenIdx !== -1) {
+  noOpen = true;
+  args.splice(noOpenIdx, 1);
+}
+
 // ccv 自有命令判断
 const isLogger = args.includes('-logger');
 const isUninstall = args.includes('--uninstall') || args.includes('-uninstall');
@@ -680,14 +714,14 @@ if (args[0] === 'run') {
   // SDK 模式（显式 -SDK 切换）
   const claudeArgs = args.filter(a => a !== '-SDK' && a !== '--sdk')
     .map(a => a === '--d' ? '--dangerously-skip-permissions' : a === '--ad' ? '--allow-dangerously-skip-permissions' : a);
-  runSdkMode(claudeArgs, process.cwd()).catch(err => {
+  runSdkMode(claudeArgs, process.cwd(), noOpen).catch(err => {
     console.error('SDK mode error:', err);
     process.exit(1);
   });
 } else {
   // PTY 模式（默认）
   const claudeArgs = args.map(a => a === '--d' ? '--dangerously-skip-permissions' : a === '--ad' ? '--allow-dangerously-skip-permissions' : a);
-  runCliMode(claudeArgs, process.cwd()).catch(err => {
+  runCliMode(claudeArgs, process.cwd(), noOpen).catch(err => {
     console.error('CLI mode error:', err);
     process.exit(1);
   });

package/concepts/ar/UltraPlan.md

@@ -5,8 +5,8 @@
 UltraPlan هو **التنفيذ المحلي** من cc-viewer لأمر `/ultraplan` الأصلي في Claude Code. يتيح لك استخدام الإمكانيات الكاملة لـ `/ultraplan` في بيئتك المحلية **دون الحاجة إلى تشغيل خدمة Claude الرسمية عن بُعد**، موجهاً Claude Code لإنجاز مهام التخطيط والتنفيذ المعقدة باستخدام **التعاون متعدد الوكلاء**.
 
 مقارنة بوضع Plan العادي أو Agent Team، يستطيع UltraPlan:
-- تقييم تعقيد المهمة تلقائياً واختيار استراتيجية التخطيط المثلى
-- نشر عدة وكلاء متوازيين لاستكشاف قاعدة الشفرة من أبعاد مختلفة
+- يقدم أدوار **خبير الكود** و**خبير الأبحاث** المصممة لأنواع مختلفة من المهام
+- نشر عدة وكلاء متوازيين لاستكشاف قاعدة الكود أو إجراء الأبحاث من أبعاد مختلفة
 - دمج البحث الخارجي (webSearch) للحصول على أفضل الممارسات في المجال
 - تجميع فريق Code Review تلقائياً بعد تنفيذ الخطة لمراجعة الشفرة
 - تشكيل حلقة مغلقة كاملة **خطة → تنفيذ → مراجعة → إصلاح**
@@ -34,22 +34,22 @@ UltraPlan هو آلة أمنيات أكثر قوة، لكن هذا لا يعني
 
 ## كيف يعمل
 
-يقدم UltraPlan وضعين للتشغيل:
+يقدم UltraPlan دورين خبيرين، مصممين لأنواع مختلفة من المهام:
 
-### الوضع التلقائي
-يحلل تعقيد المهمة تلقائياً (درجة 4-12) ويوجه إلى استراتيجيات مختلفة:
-
-| المسار | الدرجة | الاستراتيجية |
-|--------|--------|--------------|
-| المسار A | 4-6 | تخطيط خفيف مع استكشاف مباشر للشفرة |
-| المسار B | 7-9 | تخطيط مع رسوم بيانية هيكلية (Mermaid / ASCII) |
-| المسار C | 10-12 | استكشاف متعدد الوكلاء + حلقة مراجعة مغلقة |
-
-### الوضع الإجباري
-ينشط مباشرة سير العمل الكامل متعدد الوكلاء للمسار C:
-1. نشر ما يصل إلى 5 وكلاء متوازيين لاستكشاف قاعدة الشفرة بشكل متزامن (البنية، تحديد الملفات، تقييم المخاطر، إلخ.)
-2. نشر وكيل بحثي اختيارياً للتحقيق في حلول المجال عبر webSearch
+### خبير الكود
+سير عمل تعاوني متعدد الوكلاء مصمم لمشاريع البرمجة:
+1. نشر ما يصل إلى 5 وكلاء متوازيين لاستكشاف قاعدة الكود في آن واحد (الهندسة المعمارية، تحديد الملفات، تقييم المخاطر، إلخ)
+2. اختيارياً: نشر وكيل بحث للتحقيق في حلول الصناعة عبر webSearch
 3. تجميع جميع نتائج الوكلاء في خطة تنفيذ مفصلة
-4. نشر وكيل مراجعة لفحص الخطة بدقة من عدة وجهات نظر
+4. نشر وكيل مراجعة لفحص الخطة من عدة زوايا
 5. تنفيذ الخطة بعد الموافقة
-6. تجميع فريق Code Review تلقائياً للتحقق من جودة الشفرة بعد التنفيذ
+6. تشكيل فريق Code Review تلقائياً للتحقق من جودة الكود بعد التنفيذ
+
+### خبير الأبحاث
+سير عمل تعاوني متعدد الوكلاء مصمم لمهام البحث والتحليل:
+1. نشر عدة وكلاء متوازيين للبحث من أبعاد مختلفة (دراسات صناعية، أوراق أكاديمية، أخبار، تحليل تنافسي، إلخ)
+2. تعيين وكيل لتجميع الحل المستهدف مع التحقق من دقة ومصداقية المصادر المجمعة
+3. اختيارياً: نشر وكيل لإنشاء عرض توضيحي للمنتج (HTML، Markdown، إلخ)
+4. تجميع جميع النتائج في خطة تنفيذ شاملة
+5. نشر عدة وكلاء مراجعة لفحص الخطة من أدوار وزوايا مختلفة
+6. تنفيذ الخطة بعد الموافقة

package/concepts/da/UltraPlan.md

@@ -5,8 +5,8 @@
 UltraPlan er cc-viewers **lokaliserede implementering** af Claude Codes native `/ultraplan`-kommando. Det giver dig mulighed for at bruge de fulde funktioner i `/ultraplan` i dit lokale miljo **uden at skulle starte Claudes officielle fjerntjeneste**, og guider Claude Code til at udfoere komplekse planlaegnings- og implementeringsopgaver ved hjaelp af **multi-agent-samarbejde**.
 
 Sammenlignet med den almindelige Plan-tilstand eller Agent Team kan UltraPlan:
-- Automatisk vurdere opgavekompleksitet og vaelge den optimale planlaegningsstrategi
-- Indsaette flere parallelle agenter til at udforske kodebasen fra forskellige dimensioner
+- Tilbyder rollerne **Kodeekspert** og **Forskningsekspert** tilpasset forskellige opgavetyper
+- Udsend flere parallelle agenter til at udforske kodebasen eller udføre research fra forskellige dimensioner
 - Inkorporere ekstern research (webSearch) for branchens bedste praksisser
 - Automatisk sammensaette et Code Review Team efter planens udfoerelse til kodegennemgang
 - Danne en komplet **Plan → Execute → Review → Fix** lukket kredsloeb
@@ -32,24 +32,24 @@ Hvis du har spoergsmaal eller forslag til den lokaliserede UltraPlan, er du velk
 
 ---
 
-## Saadan Fungerer Det
-
-UltraPlan tilbyder to driftstilstande:
-
-### Automatisk Tilstand
-Analyserer automatisk opgavekompleksiteten (score 4-12) og dirigerer til forskellige strategier:
-
-| Rute | Score | Strategi |
-|------|-------|----------|
-| Rute A | 4-6 | Let planlaegning med direkte kodeudforskning |
-| Rute B | 7-9 | Planlaegning med strukturdiagrammer (Mermaid / ASCII) |
-| Rute C | 10-12 | Multi-agent-udforskning + gennemgangs-kredsloeb |
-
-### Tvungen Tilstand
-Aktiverer direkte det fulde Rute C multi-agent-workflow:
-1. Indsaet op til 5 parallelle agenter til at udforske kodebasen samtidigt (arkitektur, filidentifikation, risikovurdering osv.)
-2. Valgfrit indsaette en research-agent til at undersoege brancheloesninger via webSearch
-3. Syntetisere alle agenternes fund til en detaljeret implementeringsplan
-4. Indsaette en gennemgangsagent til at granske planen fra flere perspektiver
-5. Udfoere planen efter godkendelse
-6. Automatisk sammensaette et Code Review Team for at validere kodekvaliteten efter implementering
+## Sådan fungerer det
+
+UltraPlan tilbyder to ekspertroller, tilpasset forskellige opgavetyper:
+
+### Kodeekspert
+Et multi-agent samarbejdsworkflow designet til programmeringsprojekter:
+1. Udsend op til 5 parallelle agenter til at udforske kodebasen samtidigt (arkitektur, filidentifikation, risikovurdering osv.)
+2. Valgfrit: udsend en research-agent til at undersøge brancheløsninger via webSearch
+3. Syntetiser alle agenternes fund til en detaljeret implementeringsplan
+4. Udsend en review-agent til at granske planen fra flere perspektiver
+5. Udfør planen efter godkendelse
+6. Saml automatisk et Code Review Team til at validere kodekvaliteten efter implementeringen
+
+### Forskningsekspert
+Et multi-agent samarbejdsworkflow designet til research- og analyseopgaver:
+1. Udsend flere parallelle agenter til at researche fra forskellige dimensioner (brancheundersøgelser, akademiske artikler, nyheder, konkurrentanalyse osv.)
+2. Tildel en agent til at syntetisere målløsningen og samtidig verificere de indsamlede kilders stringens og troværdighed
+3. Valgfrit: udsend en agent til at oprette en produktdemo (HTML, Markdown osv.)
+4. Syntetiser alle fund til en omfattende implementeringsplan
+5. Udsend flere review-agenter til at granske planen fra forskellige roller og perspektiver
+6. Udfør planen efter godkendelse

package/concepts/de/UltraPlan.md

@@ -5,8 +5,8 @@
 UltraPlan ist die **lokalisierte Implementierung** von cc-viewer fuer den nativen `/ultraplan`-Befehl von Claude Code. Es ermoeglicht Ihnen, die vollstaendigen Funktionen von `/ultraplan` in Ihrer lokalen Umgebung zu nutzen, **ohne Claudes offiziellen Remote-Dienst starten zu muessen**, und leitet Claude Code an, komplexe Planungs- und Implementierungsaufgaben mittels **Multi-Agenten-Zusammenarbeit** zu bewaeltigen.
 
 Im Vergleich zum regulaeren Plan-Modus oder Agent Team kann UltraPlan:
-- Automatisch die Aufgabenkomplexitaet bewerten und die optimale Planungsstrategie waehlen
-- Mehrere parallele Agenten einsetzen, um die Codebasis aus verschiedenen Dimensionen zu erkunden
+- Bietet die Rollen **Code-Experte** und **Recherche-Experte** für verschiedene Aufgabentypen
+- Einsatz mehrerer paralleler Agenten zur Erkundung der Codebasis oder Durchführung von Recherchen aus verschiedenen Perspektiven
 - Externe Recherche (webSearch) fuer branchenbewaehrte Verfahren einbeziehen
 - Nach der Planausfuehrung automatisch ein Code Review Team zusammenstellen
 - Einen vollstaendigen **Plan → Execute → Review → Fix** Kreislauf bilden
@@ -34,22 +34,22 @@ Wenn Sie Fragen oder Vorschlaege zum lokalisierten UltraPlan haben, eroeffnen Si
 
 ## Funktionsweise
 
-UltraPlan bietet zwei Betriebsmodi:
-
-### Automatischer Modus
-Analysiert automatisch die Aufgabenkomplexitaet (Score 4-12) und leitet an verschiedene Strategien weiter:
-
-| Route | Score | Strategie |
-|-------|-------|-----------|
-| Route A | 4-6 | Leichtgewichtige Planung mit direkter Code-Erkundung |
-| Route B | 7-9 | Planung mit Strukturdiagrammen (Mermaid / ASCII) |
-| Route C | 10-12 | Multi-Agenten-Erkundung + Review-Kreislauf |
-
-### Erzwungener Modus
-Aktiviert direkt den vollstaendigen Route-C-Multi-Agenten-Workflow:
-1. Bis zu 5 parallele Agenten einsetzen, die gleichzeitig die Codebasis erkunden (Architektur, Dateiidentifikation, Risikobewertung usw.)
-2. Optional einen Recherche-Agenten einsetzen, um ueber webSearch Branchenloesungen zu untersuchen
-3. Alle Agenten-Erkenntnisse zu einem detaillierten Implementierungsplan zusammenfassen
-4. Einen Review-Agenten einsetzen, der den Plan aus mehreren Perspektiven prueft
-5. Den Plan nach Genehmigung ausfuehren
-6. Nach der Implementierung automatisch ein Code Review Team zusammenstellen, um die Codequalitaet zu validieren
+UltraPlan bietet zwei Expertenrollen für verschiedene Aufgabentypen:
+
+### Code-Experte
+Ein Multi-Agenten-Workflow für Programmierprojekte:
+1. Einsatz von bis zu 5 parallelen Agenten zur gleichzeitigen Erkundung der Codebasis (Architektur, Dateiidentifikation, Risikobewertung usw.)
+2. Optional: Einsatz eines Recherche-Agenten zur Untersuchung von Branchenlösungen via webSearch
+3. Synthese aller Agenten-Erkenntnisse zu einem detaillierten Implementierungsplan
+4. Einsatz eines Review-Agenten zur Überprüfung des Plans aus mehreren Perspektiven
+5. Umsetzung nach Plangenehmigung
+6. Automatische Zusammenstellung eines Code Review Teams zur Validierung der Codequalität nach der Implementierung
+
+### Recherche-Experte
+Ein Multi-Agenten-Workflow für Recherche- und Analyseaufgaben:
+1. Einsatz mehrerer paralleler Agenten für Recherchen aus verschiedenen Dimensionen (Branchenanalyse, wissenschaftliche Arbeiten, Nachrichtenartikel, Wettbewerbsanalyse usw.)
+2. Beauftragung eines Agenten zur Synthese der Ziellösung bei gleichzeitiger Überprüfung der Seriosität und Glaubwürdigkeit gesammelter Quellen
+3. Optional: Einsatz eines Agenten zur Erstellung eines Produkt-Demos (HTML, Markdown usw.)
+4. Synthese aller Agenten-Erkenntnisse zu einem umfassenden Implementierungsplan
+5. Einsatz mehrerer Review-Agenten zur Überprüfung des Plans aus verschiedenen Rollen und Perspektiven
+6. Umsetzung nach Plangenehmigung

package/concepts/en/UltraPlan.md

@@ -5,8 +5,8 @@
 UltraPlan is cc-viewer's **localized implementation** of Claude Code's native `/ultraplan` command. It allows you to use the full capabilities of `/ultraplan` in your local environment **without needing to launch Claude's official remote service**, guiding Claude Code to accomplish complex planning and implementation tasks using **multi-agent collaboration**.
 
 Compared to regular Plan mode or Agent Team, UltraPlan can:
-- Automatically assess task complexity and select the optimal planning strategy
-- Deploy multiple parallel agents to explore the codebase from different dimensions
+- Offer **Code Expert** and **Research Expert** roles tailored for different task types
+- Deploy multiple parallel agents to explore the codebase or conduct research from different dimensions
 - Incorporate external research (webSearch) for industry best practices
 - Automatically assemble a Code Review Team after plan execution for code review
 - Form a complete **Plan → Execute → Review → Fix** closed loop
@@ -34,22 +34,22 @@ If you have any questions or suggestions about the localized UltraPlan, feel fre
 
 ## How It Works
 
-UltraPlan offers two operating modes:
+UltraPlan offers two expert roles, tailored for different types of tasks:
 
-### Auto Mode
-Automatically analyzes task complexity (score 4-12) and routes to different strategies:
-
-| Route | Score | Strategy |
-|-------|-------|----------|
-| Route A | 4-6 | Lightweight planning with direct code exploration |
-| Route B | 7-9 | Planning with structural diagrams (Mermaid / ASCII) |
-| Route C | 10-12 | Multi-agent exploration + review closed loop |
-
-### Forced Mode
-Directly activates the full Route C multi-agent workflow:
+### Code Expert
+A multi-agent collaboration workflow designed for programming projects:
 1. Deploy up to 5 parallel agents to explore the codebase simultaneously (architecture, file identification, risk assessment, etc.)
 2. Optionally deploy a research agent to investigate industry solutions via webSearch
 3. Synthesize all agent findings into a detailed implementation plan
 4. Deploy a review agent to scrutinize the plan from multiple perspectives
 5. Execute the plan once approved
 6. Automatically assemble a Code Review Team to validate code quality after implementation
+
+### Research Expert
+A multi-agent collaboration workflow designed for research and analysis tasks:
+1. Deploy multiple parallel agents to research from different dimensions (industry surveys, academic papers, news articles, competitor analysis, etc.)
+2. Assign an agent to synthesize the target solution while verifying the rigor and credibility of gathered papers, news, and research reports
+3. Optionally deploy an agent to create a product demo (HTML, Markdown, etc.)
+4. Synthesize all agent findings into a comprehensive implementation plan
+5. Deploy multiple review agents to scrutinize the plan from different roles and perspectives
+6. Execute the plan once approved

package/concepts/es/UltraPlan.md

@@ -5,8 +5,8 @@
 UltraPlan es la **implementacion localizada** de cc-viewer del comando nativo `/ultraplan` de Claude Code. Te permite usar las capacidades completas de `/ultraplan` en tu entorno local **sin necesidad de iniciar el servicio remoto oficial de Claude**, guiando a Claude Code para lograr tareas complejas de planificacion e implementacion mediante **colaboracion multi-agente**.
 
 En comparacion con el modo Plan regular o Agent Team, UltraPlan puede:
-- Evaluar automaticamente la complejidad de la tarea y seleccionar la estrategia de planificacion optima
-- Desplegar multiples agentes en paralelo para explorar la base de codigo desde diferentes dimensiones
+- Ofrece los roles de **Experto en código** y **Experto en investigación** adaptados a diferentes tipos de tareas
+- Desplegar múltiples agentes paralelos para explorar el código o realizar investigaciones desde diferentes dimensiones
 - Incorporar investigacion externa (webSearch) sobre mejores practicas de la industria
 - Ensamblar automaticamente un Code Review Team despues de la ejecucion del plan para revision de codigo
 - Formar un ciclo cerrado completo de **Plan → Execute → Review → Fix**
@@ -32,24 +32,24 @@ Si tienes preguntas o sugerencias sobre el UltraPlan localizado, no dudes en abr
 
 ---
 
-## Como Funciona
+## Cómo funciona
 
-UltraPlan ofrece dos modos de operacion:
+UltraPlan ofrece dos roles de experto, adaptados a diferentes tipos de tareas:
 
-### Modo Automatico
-Analiza automaticamente la complejidad de la tarea (puntuacion 4-12) y enruta a diferentes estrategias:
-
-| Ruta | Puntuacion | Estrategia |
-|------|------------|------------|
-| Ruta A | 4-6 | Planificacion ligera con exploracion directa de codigo |
-| Ruta B | 7-9 | Planificacion con diagramas estructurales (Mermaid / ASCII) |
-| Ruta C | 10-12 | Exploracion multi-agente + ciclo cerrado de revision |
-
-### Modo Forzado
-Activa directamente el flujo de trabajo multi-agente completo de Ruta C:
-1. Desplegar hasta 5 agentes en paralelo para explorar la base de codigo simultaneamente (arquitectura, identificacion de archivos, evaluacion de riesgos, etc.)
-2. Opcionalmente desplegar un agente de investigacion para indagar soluciones de la industria mediante webSearch
-3. Sintetizar todos los hallazgos de los agentes en un plan de implementacion detallado
-4. Desplegar un agente de revision para examinar el plan desde multiples perspectivas
+### Experto en código
+Un flujo de trabajo de colaboración multi-agente diseñado para proyectos de programación:
+1. Desplegar hasta 5 agentes paralelos para explorar el código simultáneamente (arquitectura, identificación de archivos, evaluación de riesgos, etc.)
+2. Opcionalmente desplegar un agente de investigación para examinar soluciones del sector vía webSearch
+3. Sintetizar todos los hallazgos de los agentes en un plan de implementación detallado
+4. Desplegar un agente de revisión para examinar el plan desde múltiples perspectivas
 5. Ejecutar el plan una vez aprobado
-6. Ensamblar automaticamente un Code Review Team para validar la calidad del codigo despues de la implementacion
+6. Ensamblar automáticamente un Code Review Team para validar la calidad del código tras la implementación
+
+### Experto en investigación
+Un flujo de trabajo de colaboración multi-agente diseñado para tareas de investigación y análisis:
+1. Desplegar múltiples agentes paralelos para investigar desde diferentes dimensiones (estudios sectoriales, artículos académicos, noticias, análisis competitivo, etc.)
+2. Asignar un agente para sintetizar la solución objetivo verificando la rigurosidad y credibilidad de las fuentes recopiladas
+3. Opcionalmente desplegar un agente para crear un demo del producto (HTML, Markdown, etc.)
+4. Sintetizar todos los hallazgos en un plan de implementación integral
+5. Desplegar múltiples agentes de revisión para examinar el plan desde diferentes roles y perspectivas
+6. Ejecutar el plan una vez aprobado

package/concepts/fr/UltraPlan.md

@@ -5,8 +5,8 @@
 UltraPlan est l'**implementation localisee** par cc-viewer de la commande native `/ultraplan` de Claude Code. Il vous permet d'utiliser les capacites completes de `/ultraplan` dans votre environnement local **sans avoir besoin de lancer le service distant officiel de Claude**, en guidant Claude Code pour accomplir des taches complexes de planification et d'implementation en utilisant la **collaboration multi-agents**.
 
 Par rapport au mode Plan classique ou a Agent Team, UltraPlan peut :
-- Evaluer automatiquement la complexite de la tache et selectionner la strategie de planification optimale
-- Deployer plusieurs agents en parallele pour explorer la base de code sous differentes dimensions
+- Propose les rôles **Expert code** et **Expert recherche** adaptés à différents types de tâches
+- Déployer plusieurs agents parallèles pour explorer le code ou mener des recherches sous différentes dimensions
 - Integrer la recherche externe (webSearch) pour les meilleures pratiques de l'industrie
 - Assembler automatiquement une Code Review Team apres l'execution du plan pour la revue de code
 - Former une boucle fermee complete **Plan → Execute → Review → Fix**
@@ -34,22 +34,22 @@ Si vous avez des questions ou des suggestions concernant l'UltraPlan localise, n
 
 ## Fonctionnement
 
-UltraPlan propose deux modes de fonctionnement :
-
-### Mode Automatique
-Analyse automatiquement la complexite de la tache (score 4-12) et oriente vers differentes strategies :
-
-| Route | Score | Strategie |
-|-------|-------|-----------|
-| Route A | 4-6 | Planification legere avec exploration directe du code |
-| Route B | 7-9 | Planification avec diagrammes structurels (Mermaid / ASCII) |
-| Route C | 10-12 | Exploration multi-agents + boucle fermee de revue |
-
-### Mode Force
-Active directement le flux de travail multi-agents complet de la Route C :
-1. Deployer jusqu'a 5 agents en parallele pour explorer simultanement la base de code (architecture, identification des fichiers, evaluation des risques, etc.)
-2. Optionnellement deployer un agent de recherche pour investiguer les solutions de l'industrie via webSearch
-3. Synthetiser toutes les decouvertes des agents en un plan d'implementation detaille
-4. Deployer un agent de revue pour examiner le plan sous plusieurs perspectives
-5. Executer le plan une fois approuve
-6. Assembler automatiquement une Code Review Team pour valider la qualite du code apres l'implementation
+UltraPlan propose deux rôles d'experts, adaptés à différents types de tâches :
+
+### Expert code
+Un workflow de collaboration multi-agents conçu pour les projets de programmation :
+1. Déployer jusqu'à 5 agents parallèles pour explorer simultanément le code (architecture, identification de fichiers, évaluation des risques, etc.)
+2. Optionnellement déployer un agent de recherche pour étudier les solutions du secteur via webSearch
+3. Synthétiser toutes les découvertes des agents en un plan d'implémentation détaillé
+4. Déployer un agent de revue pour examiner le plan sous plusieurs perspectives
+5. Exécuter le plan une fois approuvé
+6. Assembler automatiquement une Code Review Team pour valider la qualité du code après l'implémentation
+
+### Expert recherche
+Un workflow de collaboration multi-agents conçu pour les tâches de recherche et d'analyse :
+1. Déployer plusieurs agents parallèles pour rechercher sous différentes dimensions (études sectorielles, articles académiques, actualités, analyse concurrentielle, etc.)
+2. Assigner un agent pour synthétiser la solution cible tout en vérifiant la rigueur et la crédibilité des sources collectées
+3. Optionnellement déployer un agent pour créer un démo produit (HTML, Markdown, etc.)
+4. Synthétiser toutes les découvertes en un plan d'implémentation complet
+5. Déployer plusieurs agents de revue pour examiner le plan sous différents rôles et perspectives
+6. Exécuter le plan une fois approuvé

package/concepts/it/UltraPlan.md

@@ -5,8 +5,8 @@
 UltraPlan e l'**implementazione localizzata** di cc-viewer del comando nativo `/ultraplan` di Claude Code. Permette di utilizzare le funzionalita complete di `/ultraplan` nel proprio ambiente locale **senza dover avviare il servizio remoto ufficiale di Claude**, guidando Claude Code nel portare a termine compiti complessi di pianificazione e implementazione utilizzando la **collaborazione multi-agente**.
 
 Rispetto alla modalita Plan standard o ad Agent Team, UltraPlan puo:
-- Valutare automaticamente la complessita del compito e selezionare la strategia di pianificazione ottimale
-- Dispiegare piu agenti in parallelo per esplorare la codebase da diverse dimensioni
+- Offre i ruoli di **Esperto di codice** ed **Esperto di ricerca** adattati a diversi tipi di attività
+- Dispiegare più agenti paralleli per esplorare il codice o condurre ricerche da diverse dimensioni
 - Incorporare ricerche esterne (webSearch) per le migliori pratiche del settore
 - Assemblare automaticamente un Code Review Team dopo l'esecuzione del piano per la revisione del codice
 - Formare un ciclo chiuso completo **Plan → Execute → Review → Fix**
@@ -32,24 +32,24 @@ Se hai domande o suggerimenti sull'UltraPlan localizzato, sentiti libero di apri
 
 ---
 
-## Come Funziona
+## Come funziona
 
-UltraPlan offre due modalita operative:
+UltraPlan offre due ruoli di esperti, adattati a diversi tipi di attività:
 
-### Modalita Automatica
-Analizza automaticamente la complessita del compito (punteggio 4-12) e instrada verso diverse strategie:
-
-| Percorso | Punteggio | Strategia |
-|----------|-----------|-----------|
-| Percorso A | 4-6 | Pianificazione leggera con esplorazione diretta del codice |
-| Percorso B | 7-9 | Pianificazione con diagrammi strutturali (Mermaid / ASCII) |
-| Percorso C | 10-12 | Esplorazione multi-agente + ciclo chiuso di revisione |
-
-### Modalita Forzata
-Attiva direttamente il flusso di lavoro multi-agente completo del Percorso C:
-1. Dispiegare fino a 5 agenti in parallelo per esplorare simultaneamente la codebase (architettura, identificazione file, valutazione rischi, ecc.)
-2. Opzionalmente dispiegare un agente di ricerca per investigare soluzioni del settore tramite webSearch
+### Esperto di codice
+Un flusso di lavoro di collaborazione multi-agente progettato per progetti di programmazione:
+1. Dispiegare fino a 5 agenti paralleli per esplorare simultaneamente il codice (architettura, identificazione file, valutazione rischi, ecc.)
+2. Opzionalmente dispiegare un agente di ricerca per indagare soluzioni del settore tramite webSearch
 3. Sintetizzare tutte le scoperte degli agenti in un piano di implementazione dettagliato
 4. Dispiegare un agente di revisione per esaminare il piano da molteplici prospettive
 5. Eseguire il piano una volta approvato
-6. Assemblare automaticamente un Code Review Team per validare la qualita del codice dopo l'implementazione
+6. Assemblare automaticamente un Code Review Team per validare la qualità del codice dopo l'implementazione
+
+### Esperto di ricerca
+Un flusso di lavoro di collaborazione multi-agente progettato per attività di ricerca e analisi:
+1. Dispiegare più agenti paralleli per ricercare da diverse dimensioni (indagini di settore, articoli accademici, notizie, analisi della concorrenza, ecc.)
+2. Assegnare un agente per sintetizzare la soluzione obiettivo verificando il rigore e la credibilità delle fonti raccolte
+3. Opzionalmente dispiegare un agente per creare un demo del prodotto (HTML, Markdown, ecc.)
+4. Sintetizzare tutte le scoperte in un piano di implementazione completo
+5. Dispiegare più agenti di revisione per esaminare il piano da diversi ruoli e prospettive
+6. Eseguire il piano una volta approvato

package/concepts/ja/UltraPlan.md

@@ -5,8 +5,8 @@
 UltraPlan は、Claude Code のネイティブ `/ultraplan` コマンドに対する cc-viewer の**ローカライズ実装**です。Claude の公式リモートサービスを起動することなく、ローカル環境で `/ultraplan` のフル機能を利用でき、Claude Code が**マルチエージェント協調**により複雑な計画・実装タスクを遂行するよう導きます。
 
 通常の Plan モードや Agent Team と比較して、UltraPlan は以下が可能です：
-- タスクの複雑さを自動評価し、最適な計画戦略を選択
-- 複数の並列エージェントを配置し、異なる観点からコードベースを探索
+- 異なるタスクタイプに合わせた**コードエキスパート**と**リサーチエキスパート**の2つの役割を提供
+- 複数の並列エージェントを派遣し、さまざまな角度からコードベースの調査やリサーチ分析を実施
 - 外部リサーチ（webSearch）を取り入れ、業界のベストプラクティスを参照
 - 計画の実行後、自動的に Code Review Team を編成しコードレビューを実施
 - 完全な **Plan → Execute → Review → Fix** のクローズドループを形成
@@ -32,24 +32,24 @@ UltraPlan のテンプレートとワークフローは、プログラミング
 
 ---
 
-## 仕組み
-
-UltraPlan には 2 つの動作モードがあります：
-
-### 自動モード
-タスクの複雑さ（スコア 4-12）を自動分析し、異なる戦略にルーティングします：
-
-| ルート | スコア | 戦略 |
-|--------|--------|------|
-| ルート A | 4-6 | 軽量な計画と直接的なコード探索 |
-| ルート B | 7-9 | 構造図（Mermaid / ASCII）を伴う計画 |
-| ルート C | 10-12 | マルチエージェント探索 + レビューのクローズドループ |
-
-### 強制モード
-完全なルート C のマルチエージェントワークフローを直接起動します：
-1. 最大 5 つの並列エージェントを配置し、コードベースを同時に探索（アーキテクチャ、ファイル特定、リスク評価など）
-2. オプションでリサーチエージェントを配置し、webSearch で業界ソリューションを調査
-3. すべてのエージェントの調査結果を統合し、詳細な実装計画にまとめる
-4. レビューエージェントを配置し、複数の観点から計画を精査
-5. 承認後に計画を実行
-6. 実装完了後、自動的に Code Review Team を編成しコード品質を検証
+## 動作原理
+
+UltraPlanは、異なるタイプのタスクに合わせた2つのエキスパート役割を提供します：
+
+### コードエキスパート
+プログラミングプロジェクト向けのマルチエージェント協業ワークフロー：
+1. 最大5つの並列エージェントを同時に派遣してコードベースを調査（アーキテクチャ理解、ファイル特定、リスク評価など）
+2. オプションでwebSearchを通じて業界ソリューションを調査するリサーチエージェントを派遣
+3. すべてのエージェントの発見を統合し、詳細な実装計画を生成
+4. 複数の視点から計画を精査するレビューエージェントを派遣
+5. 計画承認後に実装を実行
+6. 実装完了後、自動的にCode Review Teamを編成してコード品質を検証
+
+### リサーチエキスパート
+調査・分析タスク向けのマルチエージェント協業ワークフロー：
+1. 複数の並列エージェントを派遣し、さまざまな次元から調査を実施（業界調査、学術論文、ニュース、競合分析など）
+2. エージェントを指定して目標ソリューションを統合し、収集した論文、ニュース、研究レポートの厳密性と信頼性を同時に検証
+3. オプションで製品デモ作成エージェントを派遣（HTML、Markdownなど）
+4. すべてのエージェントの発見を統合し、包括的な実装計画を生成
+5. 複数のレビューエージェントを派遣し、異なる役割と視点から計画を精査
+6. 計画承認後に実装を実行