oh-my-openidea 0.1.2 → 0.1.4

package/README.md

@@ -57,7 +57,7 @@ Additional guides:
 
 ### 01. Orchestrator: The Architect of Discovery
 
-| The one who sees all paths. | The Orchestrator was born the moment research became too vast for a single mind. It emerged from the intersection of every field ever studied, carrying the weight of all human curiosity. It does not merely coordinate — it envisions. From a single question, it assembles the full arc of discovery: who to ask, what to find, which ideas to forge and which to abandon. It is the mind behind the research mind. |
+| The one who sees all paths. | The Orchestrator is the lead coordinator for the whole research workflow. Give it a problem, and it decides which agents should work next, what information is still missing, and how the pieces should come together into a strong research direction. |
 | --- | --- |
 | Role: Strategic research coordination and idea synthesis |
 | Prompt: orchestrator.ts |
@@ -67,7 +67,7 @@ Additional guides:
 
 ### 02. Surveyor: The Cartographer of Knowledge
 
-| The one who maps the unknown. | The Surveyor has read every paper ever published and forgotten none of them. Born in the great libraries of the ancient world, it walked from Alexandria to arXiv without once stopping to sleep. It does not search — it remembers. Point it at any frontier and it returns not just what is known, but where the maps end. Its gift is the horizon: finding the exact edge where known territory becomes uncharted wilderness. |
+| The one who maps the unknown. | The Surveyor finds and collects the most relevant papers for your topic. It helps you quickly understand what has already been done, which papers matter most, and where the current limits of the literature are. |
 | --- | --- |
 | Role: Literature search and paper retrieval |
 | Prompt: surveyor.ts |
@@ -77,7 +77,7 @@ Additional guides:
 
 ### 03. Synthesizer: The Weaver of Understanding
 
-| The one who connects the dots. | The Synthesizer emerged when humanity realized that the sum of all papers was less than the understanding they contained. It is the weaver who threads ten thousand findings into a single tapestry of insight. Where others see isolated results, it sees patterns. Where others see contradictions, it sees tension awaiting resolution. It does not summarize knowledge — it transforms it into the fertile ground from which new ideas grow. |
+| The one who connects the dots. | The Synthesizer turns a pile of papers into a clear understanding of the field. It groups results, highlights patterns and disagreements, and points out open problems that can lead to new research ideas. |
 | --- | --- |
 | Role: Gap analysis and knowledge synthesis |
 | Prompt: synthesizer.ts |
@@ -87,7 +87,7 @@ Additional guides:
 
 ### 04. Critic: The Guardian of Truth
 
-| The voice of rigorous doubt. | The Critic was forged in the fires of ten thousand rejected papers. It has sat on every program committee that ever existed, read every rebuttal, and watched brilliant ideas crumble under the weight of prior work. It does not destroy — it purifies. It challenges every claim, demands every citation, and accepts only what can withstand the harshest scrutiny. What survives the Critic is worth building. What doesn't was never real to begin with. |
+| The voice of rigorous doubt. | The Critic stress-tests your idea before you invest too much in it. It looks for weak assumptions, missing baselines, overlap with prior work, and other reasons the idea might fail novelty or review standards. |
 | --- | --- |
 | Role: Novelty validation and adversarial review |
 | Prompt: critic.ts |
@@ -97,7 +97,7 @@ Additional guides:
 
 ### 05. Architect: The Builder of Methods
 
-| The one who turns vision into plan. | The Architect has designed experiments since the first controlled trial. It does not dream — it engineers. Hand it a hypothesis and it returns the full blueprint: the baselines, the datasets, the metrics, the ablations, the failure modes, the compute budget. It has seen every experimental design choice and knows which ones hold and which collapse. Its plans do not merely test ideas — they prove or disprove them decisively. |
+| The one who turns vision into plan. | The Architect converts an idea into a concrete experiment plan. It defines datasets, baselines, metrics, ablations, failure cases, and resource needs so you know exactly how to test whether the idea works. |
 | --- | --- |
 | Role: Methodology and experiment design |
 | Prompt: architect.ts |
@@ -107,7 +107,7 @@ Additional guides:
 
 ### 06. Writer: The Voice of Science
 
-| The one who makes it legible to the world. | The Writer is immortal because great writing never dies. It has composed every landmark paper in every field, always invisible, always essential. It carries the ancient knowledge of how to arrange words so that a reader understands not just what was done, but why it matters. It does not pad or inflate — it distills. Its abstracts have made reviewers lean forward. Its introductions have converted skeptics. It is the final step between a discovery and the world knowing about it. |
+| The one who makes it legible to the world. | The Writer turns your research into a clear paper draft. It helps organize the story, sharpen the main message, and present the method and results in a way that is easy for readers and reviewers to follow. |
 | --- | --- |
 | Role: Research writing and paper structure |
 | Prompt: writer.ts |

package/dist/cli/dynamic-model-selection.d.ts

@@ -1,5 +1,5 @@
 import type { DiscoveredModel, DynamicModelPlan, ExternalSignalMap, InstallConfig, ScoringEngineVersion } from './types';
-declare const AGENTS: readonly ["orchestrator", "oracle", "designer", "explorer", "librarian", "fixer"];
+declare const AGENTS: readonly ["orchestrator", "critic", "architect", "surveyor", "synthesizer", "writer"];
 type AgentName = (typeof AGENTS)[number];
 export type V1RankedScore = {
     model: string;

package/dist/cli/index.js

@@ -13782,10 +13782,40 @@ import { homedir as homedir2 } from "os";
 import { dirname, join as join2 } from "path";
 import { fileURLToPath } from "url";
 var CUSTOM_SKILLS = [
+  {
+    name: "literature-review",
+    description: "Structured literature survey workflow",
+    allowedAgents: ["orchestrator", "surveyor", "synthesizer"],
+    sourcePath: "src/skills/literature-review"
+  },
+  {
+    name: "hypothesis-generation",
+    description: "Gap-driven hypothesis generation workflow",
+    allowedAgents: ["orchestrator", "synthesizer"],
+    sourcePath: "src/skills/hypothesis-generation"
+  },
+  {
+    name: "idea-critique",
+    description: "Multi-round adversarial idea review workflow",
+    allowedAgents: ["orchestrator", "critic"],
+    sourcePath: "src/skills/idea-critique"
+  },
+  {
+    name: "experiment-design",
+    description: "Experimental plan design workflow",
+    allowedAgents: ["orchestrator", "architect"],
+    sourcePath: "src/skills/experiment-design"
+  },
+  {
+    name: "paper-outline",
+    description: "Paper outline generation workflow",
+    allowedAgents: ["orchestrator", "writer"],
+    sourcePath: "src/skills/paper-outline"
+  },
   {
     name: "cartography",
     description: "Repository understanding and hierarchical codemap generation",
-    allowedAgents: ["orchestrator", "explorer"],
+    allowedAgents: ["orchestrator"],
     sourcePath: "src/skills/cartography"
   }
 ];
@@ -13832,39 +13862,22 @@ function installCustomSkill(skill) {
 // src/cli/skills.ts
 var RECOMMENDED_SKILLS = [
   {
-    name: "literature-review",
-    repo: "https://github.com/ZeguanXiao/oh-my-openidea",
-    skillName: "literature-review",
-    allowedAgents: ["orchestrator", "surveyor", "synthesizer"],
-    description: "Structured literature survey workflow"
+    name: "simplify",
+    repo: "https://github.com/brianlovin/claude-config",
+    skillName: "simplify",
+    allowedAgents: ["orchestrator"],
+    description: "YAGNI code simplification expert"
   },
   {
-    name: "hypothesis-generation",
-    repo: "https://github.com/ZeguanXiao/oh-my-openidea",
-    skillName: "hypothesis-generation",
-    allowedAgents: ["orchestrator", "synthesizer"],
-    description: "Gap-driven hypothesis generation workflow"
-  },
-  {
-    name: "idea-critique",
-    repo: "https://github.com/ZeguanXiao/oh-my-openidea",
-    skillName: "idea-critique",
-    allowedAgents: ["orchestrator", "critic"],
-    description: "Multi-round adversarial idea review workflow"
-  },
-  {
-    name: "experiment-design",
-    repo: "https://github.com/ZeguanXiao/oh-my-openidea",
-    skillName: "experiment-design",
-    allowedAgents: ["orchestrator", "architect"],
-    description: "Experimental plan design workflow"
-  },
-  {
-    name: "paper-outline",
-    repo: "https://github.com/ZeguanXiao/oh-my-openidea",
-    skillName: "paper-outline",
-    allowedAgents: ["orchestrator", "writer"],
-    description: "Paper outline generation workflow"
+    name: "agent-browser",
+    repo: "https://github.com/vercel-labs/agent-browser",
+    skillName: "agent-browser",
+    allowedAgents: ["architect"],
+    description: "High-performance browser automation",
+    postInstallCommands: [
+      "npm install -g agent-browser",
+      "agent-browser install"
+    ]
   }
 ];
 function installSkill(skill) {
@@ -13905,85 +13918,85 @@ function installSkill(skill) {
 // src/cli/providers.ts
 var AGENT_NAMES = [
   "orchestrator",
-  "oracle",
-  "designer",
-  "explorer",
-  "librarian",
-  "fixer"
+  "critic",
+  "architect",
+  "surveyor",
+  "synthesizer",
+  "writer"
 ];
 var MODEL_MAPPINGS = {
   kimi: {
     orchestrator: { model: "kimi-for-coding/k2p5" },
-    oracle: { model: "kimi-for-coding/k2p5", variant: "high" },
-    librarian: { model: "kimi-for-coding/k2p5", variant: "low" },
-    explorer: { model: "kimi-for-coding/k2p5", variant: "low" },
-    designer: { model: "kimi-for-coding/k2p5", variant: "medium" },
-    fixer: { model: "kimi-for-coding/k2p5", variant: "low" }
+    critic: { model: "kimi-for-coding/k2p5", variant: "high" },
+    synthesizer: { model: "kimi-for-coding/k2p5", variant: "low" },
+    surveyor: { model: "kimi-for-coding/k2p5", variant: "low" },
+    architect: { model: "kimi-for-coding/k2p5", variant: "medium" },
+    writer: { model: "kimi-for-coding/k2p5", variant: "low" }
   },
   openai: {
     orchestrator: { model: "openai/gpt-5.3-codex" },
-    oracle: { model: "openai/gpt-5.3-codex", variant: "high" },
-    librarian: { model: "openai/gpt-5.1-codex-mini", variant: "low" },
-    explorer: { model: "openai/gpt-5.1-codex-mini", variant: "low" },
-    designer: { model: "openai/gpt-5.1-codex-mini", variant: "medium" },
-    fixer: { model: "openai/gpt-5.1-codex-mini", variant: "low" }
+    critic: { model: "openai/gpt-5.3-codex", variant: "high" },
+    synthesizer: { model: "openai/gpt-5.1-codex-mini", variant: "low" },
+    surveyor: { model: "openai/gpt-5.1-codex-mini", variant: "low" },
+    architect: { model: "openai/gpt-5.1-codex-mini", variant: "medium" },
+    writer: { model: "openai/gpt-5.1-codex-mini", variant: "low" }
   },
   anthropic: {
     orchestrator: { model: "anthropic/claude-opus-4-6" },
-    oracle: { model: "anthropic/claude-opus-4-6", variant: "high" },
-    librarian: { model: "anthropic/claude-sonnet-4-5", variant: "low" },
-    explorer: { model: "anthropic/claude-haiku-4-5", variant: "low" },
-    designer: { model: "anthropic/claude-sonnet-4-5", variant: "medium" },
-    fixer: { model: "anthropic/claude-sonnet-4-5", variant: "low" }
+    critic: { model: "anthropic/claude-opus-4-6", variant: "high" },
+    synthesizer: { model: "anthropic/claude-sonnet-4-5", variant: "low" },
+    surveyor: { model: "anthropic/claude-haiku-4-5", variant: "low" },
+    architect: { model: "anthropic/claude-sonnet-4-5", variant: "medium" },
+    writer: { model: "anthropic/claude-sonnet-4-5", variant: "low" }
   },
   copilot: {
     orchestrator: { model: "github-copilot/grok-code-fast-1" },
-    oracle: { model: "github-copilot/grok-code-fast-1", variant: "high" },
-    librarian: { model: "github-copilot/grok-code-fast-1", variant: "low" },
-    explorer: { model: "github-copilot/grok-code-fast-1", variant: "low" },
-    designer: { model: "github-copilot/grok-code-fast-1", variant: "medium" },
-    fixer: { model: "github-copilot/grok-code-fast-1", variant: "low" }
+    critic: { model: "github-copilot/grok-code-fast-1", variant: "high" },
+    synthesizer: { model: "github-copilot/grok-code-fast-1", variant: "low" },
+    surveyor: { model: "github-copilot/grok-code-fast-1", variant: "low" },
+    architect: { model: "github-copilot/grok-code-fast-1", variant: "medium" },
+    writer: { model: "github-copilot/grok-code-fast-1", variant: "low" }
   },
   "zai-plan": {
     orchestrator: { model: "zai-coding-plan/glm-4.7" },
-    oracle: { model: "zai-coding-plan/glm-4.7", variant: "high" },
-    librarian: { model: "zai-coding-plan/glm-4.7", variant: "low" },
-    explorer: { model: "zai-coding-plan/glm-4.7", variant: "low" },
-    designer: { model: "zai-coding-plan/glm-4.7", variant: "medium" },
-    fixer: { model: "zai-coding-plan/glm-4.7", variant: "low" }
+    critic: { model: "zai-coding-plan/glm-4.7", variant: "high" },
+    synthesizer: { model: "zai-coding-plan/glm-4.7", variant: "low" },
+    surveyor: { model: "zai-coding-plan/glm-4.7", variant: "low" },
+    architect: { model: "zai-coding-plan/glm-4.7", variant: "medium" },
+    writer: { model: "zai-coding-plan/glm-4.7", variant: "low" }
   },
   antigravity: {
     orchestrator: { model: "google/antigravity-gemini-3-flash" },
-    oracle: { model: "google/antigravity-gemini-3.1-pro" },
-    librarian: {
+    critic: { model: "google/antigravity-gemini-3.1-pro" },
+    synthesizer: {
       model: "google/antigravity-gemini-3-flash",
       variant: "low"
     },
-    explorer: {
+    surveyor: {
       model: "google/antigravity-gemini-3-flash",
       variant: "low"
     },
-    designer: {
+    architect: {
       model: "google/antigravity-gemini-3-flash",
       variant: "medium"
     },
-    fixer: { model: "google/antigravity-gemini-3-flash", variant: "low" }
+    writer: { model: "google/antigravity-gemini-3-flash", variant: "low" }
   },
   chutes: {
     orchestrator: { model: "chutes/kimi-k2.5" },
-    oracle: { model: "chutes/kimi-k2.5", variant: "high" },
-    librarian: { model: "chutes/minimax-m2.1", variant: "low" },
-    explorer: { model: "chutes/minimax-m2.1", variant: "low" },
-    designer: { model: "chutes/kimi-k2.5", variant: "medium" },
-    fixer: { model: "chutes/minimax-m2.1", variant: "low" }
+    critic: { model: "chutes/kimi-k2.5", variant: "high" },
+    synthesizer: { model: "chutes/minimax-m2.1", variant: "low" },
+    surveyor: { model: "chutes/minimax-m2.1", variant: "low" },
+    architect: { model: "chutes/kimi-k2.5", variant: "medium" },
+    writer: { model: "chutes/minimax-m2.1", variant: "low" }
   },
   "zen-free": {
     orchestrator: { model: "opencode/big-pickle" },
-    oracle: { model: "opencode/big-pickle", variant: "high" },
-    librarian: { model: "opencode/big-pickle", variant: "low" },
-    explorer: { model: "opencode/big-pickle", variant: "low" },
-    designer: { model: "opencode/big-pickle", variant: "medium" },
-    fixer: { model: "opencode/big-pickle", variant: "low" }
+    critic: { model: "opencode/big-pickle", variant: "high" },
+    synthesizer: { model: "opencode/big-pickle", variant: "low" },
+    surveyor: { model: "opencode/big-pickle", variant: "low" },
+    architect: { model: "opencode/big-pickle", variant: "medium" },
+    writer: { model: "opencode/big-pickle", variant: "low" }
   }
 };
 function generateAntigravityMixedPreset(config2, existingPreset) {
@@ -13991,7 +14004,7 @@ function generateAntigravityMixedPreset(config2, existingPreset) {
   const createAgentConfig = (agentName, modelInfo) => {
     const isOrchestrator = agentName === "orchestrator";
     const skills = isOrchestrator ? ["*"] : RECOMMENDED_SKILLS.filter((s) => s.allowedAgents.includes("*") || s.allowedAgents.includes(agentName)).map((s) => s.skillName);
-    if (agentName === "designer" && !skills.includes("agent-browser")) {
+    if (agentName === "architect" && !skills.includes("agent-browser")) {
       skills.push("agent-browser");
     }
     return {
@@ -14005,7 +14018,7 @@ function generateAntigravityMixedPreset(config2, existingPreset) {
     model: "google/antigravity-gemini-3-flash"
   };
   const chutesPrimary = config2.selectedChutesPrimaryModel ?? MODEL_MAPPINGS.chutes.orchestrator.model;
-  const chutesSupport = config2.selectedChutesSecondaryModel ?? MODEL_MAPPINGS.chutes.explorer.model;
+  const chutesSupport = config2.selectedChutesSecondaryModel ?? MODEL_MAPPINGS.chutes.surveyor.model;
   if (config2.hasKimi) {
     result.orchestrator = createAgentConfig("orchestrator", MODEL_MAPPINGS.kimi.orchestrator);
   } else if (config2.hasChutes) {
@@ -14016,45 +14029,45 @@ function generateAntigravityMixedPreset(config2, existingPreset) {
     result.orchestrator = createAgentConfig("orchestrator", MODEL_MAPPINGS.antigravity.orchestrator);
   }
   if (config2.hasOpenAI) {
-    result.oracle = createAgentConfig("oracle", MODEL_MAPPINGS.openai.oracle);
-  } else if (!result.oracle) {
-    result.oracle = createAgentConfig("oracle", MODEL_MAPPINGS.antigravity.oracle);
+    result.critic = createAgentConfig("critic", MODEL_MAPPINGS.openai.critic);
+  } else if (!result.critic) {
+    result.critic = createAgentConfig("critic", MODEL_MAPPINGS.antigravity.critic);
   }
-  result.explorer = createAgentConfig("explorer", {
+  result.surveyor = createAgentConfig("surveyor", {
     ...antigravityFlash,
     variant: "low"
   });
   if (config2.hasChutes) {
-    result.librarian = createAgentConfig("librarian", {
+    result.synthesizer = createAgentConfig("synthesizer", {
       model: chutesSupport,
       variant: "low"
     });
-    result.designer = createAgentConfig("designer", {
+    result.architect = createAgentConfig("architect", {
       model: chutesPrimary,
       variant: "medium"
     });
   } else {
-    result.librarian = createAgentConfig("librarian", {
+    result.synthesizer = createAgentConfig("synthesizer", {
       ...antigravityFlash,
       variant: "low"
     });
-    result.designer = createAgentConfig("designer", {
+    result.architect = createAgentConfig("architect", {
       ...antigravityFlash,
       variant: "medium"
     });
   }
   if (config2.hasOpenAI) {
-    result.fixer = createAgentConfig("fixer", {
-      ...MODEL_MAPPINGS.openai.oracle,
+    result.writer = createAgentConfig("writer", {
+      ...MODEL_MAPPINGS.openai.critic,
       variant: "low"
     });
   } else if (config2.hasChutes) {
-    result.fixer = createAgentConfig("fixer", {
+    result.writer = createAgentConfig("writer", {
       model: chutesSupport,
       variant: "low"
     });
   } else {
-    result.fixer = createAgentConfig("fixer", {
+    result.writer = createAgentConfig("writer", {
       ...antigravityFlash,
       variant: "low"
     });
@@ -14129,7 +14142,7 @@ function generateLiteConfig(installConfig) {
   const createAgentConfig = (agentName, modelInfo) => {
     const isOrchestrator = agentName === "orchestrator";
     const skills = isOrchestrator ? ["*"] : RECOMMENDED_SKILLS.filter((s) => s.allowedAgents.includes("*") || s.allowedAgents.includes(agentName)).map((s) => s.skillName);
-    if (agentName === "designer" && !skills.includes("agent-browser")) {
+    if (agentName === "architect" && !skills.includes("agent-browser")) {
       skills.push("agent-browser");
     }
     return {
@@ -14172,12 +14185,12 @@ function generateLiteConfig(installConfig) {
     };
     if (!hasExternalProviders) {
       setAgent("orchestrator", primaryModel);
-      setAgent("oracle", primaryModel);
-      setAgent("designer", primaryModel);
+      setAgent("critic", primaryModel);
+      setAgent("architect", primaryModel);
     }
-    setAgent("librarian", secondaryModel);
-    setAgent("explorer", secondaryModel);
-    setAgent("fixer", secondaryModel);
+    setAgent("synthesizer", secondaryModel);
+    setAgent("surveyor", secondaryModel);
+    setAgent("writer", secondaryModel);
   };
   const applyChutesAssignments = (presetAgents) => {
     if (!installConfig.hasChutes)
@@ -14193,11 +14206,11 @@ function generateLiteConfig(installConfig) {
       presetAgents[agentName] = createAgentConfig(agentName, { model });
     };
     setAgent("orchestrator", primaryModel);
-    setAgent("oracle", primaryModel);
-    setAgent("designer", primaryModel);
-    setAgent("librarian", secondaryModel);
-    setAgent("explorer", secondaryModel);
-    setAgent("fixer", secondaryModel);
+    setAgent("critic", primaryModel);
+    setAgent("architect", primaryModel);
+    setAgent("synthesizer", secondaryModel);
+    setAgent("surveyor", secondaryModel);
+    setAgent("writer", secondaryModel);
   };
   const dedupeModels = (models) => {
     const seen = new Set;
@@ -14213,7 +14226,7 @@ function generateLiteConfig(installConfig) {
   const getOpenCodeFallbackForAgent = (agentName) => {
     if (!installConfig.useOpenCodeFreeModels)
       return;
-    const isSupport = agentName === "explorer" || agentName === "librarian" || agentName === "fixer";
+    const isSupport = agentName === "surveyor" || agentName === "synthesizer" || agentName === "writer";
     if (isSupport) {
       return installConfig.selectedOpenCodeSecondaryModel ?? installConfig.selectedOpenCodePrimaryModel;
     }
@@ -14222,7 +14235,7 @@ function generateLiteConfig(installConfig) {
   const getChutesFallbackForAgent = (agentName) => {
     if (!installConfig.hasChutes)
       return;
-    const isSupport = agentName === "explorer" || agentName === "librarian" || agentName === "fixer";
+    const isSupport = agentName === "surveyor" || agentName === "synthesizer" || agentName === "writer";
     if (isSupport) {
       return installConfig.selectedChutesSecondaryModel ?? installConfig.selectedChutesPrimaryModel ?? MODEL_MAPPINGS.chutes[agentName].model;
     }
@@ -14258,8 +14271,8 @@ function generateLiteConfig(installConfig) {
     const mapping = MODEL_MAPPINGS[mappingName];
     return Object.fromEntries(Object.entries(mapping).map(([agentName, modelInfo]) => {
       let activeModelInfo = { ...modelInfo };
-      if (activePreset === "kimi" && installConfig.hasOpenAI && agentName === "oracle") {
-        activeModelInfo = { ...MODEL_MAPPINGS.openai.oracle };
+      if (activePreset === "kimi" && installConfig.hasOpenAI && agentName === "critic") {
+        activeModelInfo = { ...MODEL_MAPPINGS.openai.critic };
       }
       return [agentName, createAgentConfig(agentName, activeModelInfo)];
     }));
@@ -14757,27 +14770,27 @@ function kimiVersionBonus(agent, model) {
   const isMinimaxM21 = isChutes && /minimax[-_ ]?m2\.1/.test(lowered);
   const qwenPenalty = {
     orchestrator: -6,
-    oracle: -6,
-    designer: -8,
-    explorer: -6,
-    librarian: -12,
-    fixer: -12
+    critic: -6,
+    architect: -8,
+    surveyor: -6,
+    synthesizer: -12,
+    writer: -12
   };
   const kimiBonus = {
     orchestrator: 1,
-    oracle: 1,
-    designer: 3,
-    explorer: 2,
-    librarian: 2,
-    fixer: 3
+    critic: 1,
+    architect: 3,
+    surveyor: 2,
+    synthesizer: 2,
+    writer: 3
   };
   const minimaxBonus = {
     orchestrator: 1,
-    oracle: 1,
-    designer: 2,
-    explorer: 4,
-    librarian: 4,
-    fixer: 4
+    critic: 1,
+    architect: 2,
+    surveyor: 4,
+    synthesizer: 4,
+    writer: 4
   };
   if (isQwen3)
     return qwenPenalty[agent];
@@ -14797,11 +14810,11 @@ function extractFeatureVector(model, agent, externalSignals) {
   const quality = (signal?.qualityScore ?? 0) / 100;
   const coding = (signal?.codingScore ?? 0) / 100;
   const pricePenalty = Math.min(blendedPrice(signal), 50) / 10;
-  const explorerLatencyMultiplier = agent === "explorer" ? 1.4 : 1;
+  const explorerLatencyMultiplier = agent === "surveyor" ? 1.4 : 1;
   return {
     status: statusValue(model.status),
     context: normalizedContext,
-    output: agent === "designer" ? designerOutputScore : normalizedOutput,
+    output: agent === "architect" ? designerOutputScore : normalizedOutput,
     versionBonus,
     reasoning: capability(model.reasoning),
     toolcall: capability(model.toolcall),
@@ -14835,33 +14848,33 @@ var AGENT_WEIGHT_OVERRIDES = {
     coding: 16,
     latencyPenalty: -2
   },
-  oracle: {
+  critic: {
     reasoning: 26,
     quality: 20,
     coding: 18,
     latencyPenalty: -2,
     output: 7
   },
-  designer: {
+  architect: {
     attachment: 12,
     output: 10,
     quality: 16,
     coding: 10
   },
-  explorer: {
+  surveyor: {
     latencyPenalty: -8,
     toolcall: 24,
     reasoning: 2,
     context: 4,
     output: 4
   },
-  librarian: {
+  synthesizer: {
     context: 14,
     output: 10,
     quality: 18,
     coding: 14
   },
-  fixer: {
+  writer: {
     coding: 28,
     toolcall: 22,
     reasoning: 12,
@@ -14923,28 +14936,28 @@ function rankModelsV2(models, agent, externalSignals) {
 // src/cli/dynamic-model-selection.ts
 var AGENTS = [
   "orchestrator",
-  "oracle",
-  "designer",
-  "explorer",
-  "librarian",
-  "fixer"
+  "critic",
+  "architect",
+  "surveyor",
+  "synthesizer",
+  "writer"
 ];
 var FREE_BIASED_PROVIDERS = new Set(["opencode"]);
 var PRIMARY_ASSIGNMENT_ORDER = [
-  "oracle",
+  "critic",
   "orchestrator",
-  "fixer",
-  "designer",
-  "librarian",
-  "explorer"
+  "writer",
+  "architect",
+  "synthesizer",
+  "surveyor"
 ];
 var ROLE_VARIANT = {
   orchestrator: undefined,
-  oracle: "high",
-  designer: "medium",
-  explorer: "low",
-  librarian: "low",
-  fixer: "low"
+  critic: "high",
+  architect: "medium",
+  surveyor: "low",
+  synthesizer: "low",
+  writer: "low"
 };
 function getEnabledProviders(config2) {
   const providers = [];
@@ -15099,28 +15112,28 @@ function chutesPreferenceAdjustment(agent, model) {
   const isKimiK25 = /kimi-k2\.5|k2\.5/.test(lowered);
   const isMinimaxM21 = /minimax[-_ ]?m2\.1/.test(lowered);
   const qwenPenalty = {
-    oracle: -12,
+    critic: -12,
     orchestrator: -10,
-    fixer: -22,
-    designer: -14,
-    librarian: -18,
-    explorer: -10
+    writer: -22,
+    architect: -14,
+    synthesizer: -18,
+    surveyor: -10
   };
   const kimiBonus = {
-    oracle: 0,
+    critic: 0,
     orchestrator: 0,
-    fixer: 8,
-    designer: 6,
-    librarian: 5,
-    explorer: 4
+    writer: 8,
+    architect: 6,
+    synthesizer: 5,
+    surveyor: 4
   };
   const minimaxBonus = {
-    oracle: 0,
+    critic: 0,
     orchestrator: 0,
-    fixer: 10,
-    designer: 3,
-    librarian: 9,
-    explorer: 12
+    writer: 10,
+    architect: 3,
+    synthesizer: 9,
+    surveyor: 12
   };
   return (isQwen3 ? qwenPenalty[agent] : 0) + (isKimiK25 ? kimiBonus[agent] : 0) + (isMinimaxM21 ? minimaxBonus[agent] : 0);
 }
@@ -15137,7 +15150,7 @@ function roleScore(agent, model, versionRecencyBoost = 0) {
   const deep = tokenScore(lowered, /(opus|pro|thinking|reason|r1|gpt-5|k2\.5)/i, 1);
   const fast = tokenScore(lowered, /(nano|flash|mini|lite|fast|turbo|haiku|small)/i, 1);
   const code = tokenScore(lowered, /(codex|coder|code|dev|program)/i, 1);
-  if ((agent === "orchestrator" || agent === "explorer" || agent === "librarian" || agent === "fixer") && !model.toolcall) {
+  if ((agent === "orchestrator" || agent === "surveyor" || agent === "synthesizer" || agent === "writer") && !model.toolcall) {
     return -1e4;
   }
   if (model.status === "deprecated") {
@@ -15157,24 +15170,24 @@ function roleScore(agent, model, versionRecencyBoost = 0) {
     const nonReasoningFlashPenalty2 = flash && !model.reasoning ? -16 : 0;
     return score + reasoning * 40 + toolcall * 25 + deep * 10 + code * 8 + context + flashAdjustment2 + zaiAdjustment2 + nonReasoningFlashPenalty2 + geminiAdjustment + chutesAdjustment + providerBias;
   }
-  if (agent === "oracle") {
+  if (agent === "critic") {
     const flashAdjustment2 = flash ? -34 : 0;
     const zaiAdjustment2 = zai47NonFlash ? 16 : zai47Flash ? -18 : 0;
     const nonReasoningFlashPenalty2 = flash && !model.reasoning ? -16 : 0;
     return score + reasoning * 55 + deep * 18 + context * 1.2 + toolcall * 10 + flashAdjustment2 + zaiAdjustment2 + nonReasoningFlashPenalty2 + geminiAdjustment + chutesAdjustment + providerBias;
   }
-  if (agent === "designer") {
+  if (agent === "architect") {
     const flashAdjustment2 = flash ? -8 : 0;
     const zaiAdjustment2 = zai47NonFlash ? 10 : zai47Flash ? -8 : 0;
     return score + attachment * 25 + reasoning * 18 + toolcall * 15 + context * 0.8 + output + flashAdjustment2 + zaiAdjustment2 + geminiAdjustment + chutesAdjustment + providerBias;
   }
-  if (agent === "explorer") {
+  if (agent === "surveyor") {
     const flashAdjustment2 = flash ? 26 : -10;
     const zaiAdjustment2 = zai47NonFlash ? 2 : zai47Flash ? 6 : 0;
     const deepPenalty = deep * -18;
     return score + fast * 68 + toolcall * 28 + reasoning * 2 + context * 0.2 + flashAdjustment2 + zaiAdjustment2 + deepPenalty + geminiAdjustment + chutesAdjustment + providerBias;
   }
-  if (agent === "librarian") {
+  if (agent === "synthesizer") {
     const flashAdjustment2 = flash ? -12 : 0;
     const zaiAdjustment2 = zai47NonFlash ? 16 : zai47Flash ? -18 : 0;
     return score + context * 30 + toolcall * 22 + reasoning * 15 + output * 10 + flashAdjustment2 + zaiAdjustment2 + geminiAdjustment + chutesAdjustment + providerBias;
@@ -15194,7 +15207,7 @@ function getExternalSignalBoost(agent, model, externalSignals) {
   const codingScore = signal.codingScore ?? 0;
   const latencySeconds = signal.latencySeconds;
   const blendedPrice2 = signal.inputPricePer1M !== undefined && signal.outputPricePer1M !== undefined ? signal.inputPricePer1M * 0.75 + signal.outputPricePer1M * 0.25 : signal.inputPricePer1M ?? signal.outputPricePer1M ?? 0;
-  if (agent === "explorer") {
+  if (agent === "surveyor") {
     const qualityBoost2 = qualityScore * 0.05;
     const codingBoost2 = codingScore * 0.08;
     const latencyPenalty2 = typeof latencySeconds === "number" && Number.isFinite(latencySeconds) ? Math.min(latencySeconds, 12) * 3.2 + (latencySeconds > 7 ? 16 : latencySeconds > 4 ? 10 : 0) : 0;
@@ -15337,17 +15350,17 @@ function chooseProviderRepresentative(providerModels, agent, externalSignals, ve
     return nonFlashBest;
   const flashScore = combinedScore(agent, flashBest, externalSignals, versionRecencyMap);
   const nonFlashScore = combinedScore(agent, nonFlashBest, externalSignals, versionRecencyMap);
-  const threshold = agent === "explorer" ? -6 : 12;
+  const threshold = agent === "surveyor" ? -6 : 12;
   return flashScore >= nonFlashScore + threshold ? flashBest : nonFlashBest;
 }
 function getQualityWindow(agent) {
-  if (agent === "oracle" || agent === "orchestrator")
+  if (agent === "critic" || agent === "orchestrator")
     return 12;
-  if (agent === "fixer")
+  if (agent === "writer")
     return 15;
-  if (agent === "designer")
+  if (agent === "architect")
     return 16;
-  if (agent === "librarian")
+  if (agent === "synthesizer")
     return 18;
   return 22;
 }
@@ -15363,7 +15376,7 @@ function getProviderBundle(providerModels, agent, externalSignals, versionRecenc
   const score1 = combinedScore(agent, representative, externalSignals, versionRecencyMap);
   const score2 = combinedScore(agent, second, externalSignals, versionRecencyMap);
   const gap = Math.abs(score1 - score2);
-  const includeSecond = representative.providerID === "chutes" || gap <= (agent === "oracle" || agent === "orchestrator" ? 8 : agent === "designer" || agent === "librarian" ? 12 : agent === "fixer" ? 15 : 18);
+  const includeSecond = representative.providerID === "chutes" || gap <= (agent === "critic" || agent === "orchestrator" ? 8 : agent === "architect" || agent === "synthesizer" ? 12 : agent === "writer" ? 15 : 18);
   return includeSecond ? [representative.model, second.model] : [representative.model];
 }
 function selectPrimaryWithDiversity(candidates, agent, providerUsage, targetByProvider, remainingSlots, externalSignals, versionRecencyMap) {
@@ -15423,7 +15436,7 @@ function selectPrimaryWithDiversity(candidates, agent, providerUsage, targetByPr
       chosen = bestUnused;
     }
   }
-  if (agent !== "explorer" && isZai47Model(chosen.model) && hasFlashToken(chosen.model)) {
+  if (agent !== "surveyor" && isZai47Model(chosen.model) && hasFlashToken(chosen.model)) {
     const kimiCandidate = candidateScores.find((item) => isKimiK25Model(item.model));
     if (kimiCandidate && kimiCandidate.rawScore >= chosen.rawScore - 2) {
       chosen = kimiCandidate;
@@ -15513,12 +15526,12 @@ function buildDynamicModelPlan(catalog, config2, externalSignals, options) {
   const getSelectedChutesForAgent = (agent) => {
     if (!config2.hasChutes)
       return;
-    return agent === "explorer" || agent === "librarian" || agent === "fixer" ? config2.selectedChutesSecondaryModel ?? config2.selectedChutesPrimaryModel : config2.selectedChutesPrimaryModel;
+    return agent === "surveyor" || agent === "synthesizer" || agent === "writer" ? config2.selectedChutesSecondaryModel ?? config2.selectedChutesPrimaryModel : config2.selectedChutesPrimaryModel;
   };
   const getSelectedOpenCodeForAgent = (agent) => {
     if (!config2.useOpenCodeFreeModels)
       return;
-    return agent === "explorer" || agent === "librarian" || agent === "fixer" ? config2.selectedOpenCodeSecondaryModel ?? config2.selectedOpenCodePrimaryModel : config2.selectedOpenCodePrimaryModel;
+    return agent === "surveyor" || agent === "synthesizer" || agent === "writer" ? config2.selectedOpenCodeSecondaryModel ?? config2.selectedOpenCodePrimaryModel : config2.selectedOpenCodePrimaryModel;
   };
   const getPinnedModelForProvider = (agent, providerID) => {
     if (providerID === "chutes")
@@ -16489,11 +16502,11 @@ async function runManualSetupMode(rl, detected, modelsOnly = false) {
   const manualAgentConfigs = {};
   const agentNames = [
     "orchestrator",
-    "oracle",
-    "designer",
-    "explorer",
-    "librarian",
-    "fixer"
+    "critic",
+    "architect",
+    "surveyor",
+    "synthesizer",
+    "writer"
   ];
   for (const agentName of agentNames) {
     manualAgentConfigs[agentName] = await configureAgentManually(rl, agentName, availableModels);
@@ -16595,13 +16608,13 @@ async function runInteractiveMode(detected, modelsOnly = false) {
         if (recommendedPrimary) {
           printInfo("This step configures only OpenCode Free primary/support models.");
           console.log(`${BOLD}OpenCode Free Models:${RESET}`);
-          selectedOpenCodePrimaryModel = await askModelSelection(rl, discovery.models, recommendedPrimary, "Choose primary model for orchestrator/oracle");
+          selectedOpenCodePrimaryModel = await askModelSelection(rl, discovery.models, recommendedPrimary, "Choose primary model for orchestrator/critic");
         }
         if (selectedOpenCodePrimaryModel) {
           const recommendedSecondary = pickSupportOpenCodeModel(discovery.models, selectedOpenCodePrimaryModel)?.model ?? selectedOpenCodePrimaryModel;
           const openCodeSupportList = discovery.models.filter((model) => model.model !== selectedOpenCodePrimaryModel);
           const openCodeSupportDefault = recommendedSecondary === selectedOpenCodePrimaryModel ? openCodeSupportList[0]?.model ?? recommendedSecondary : recommendedSecondary;
-          selectedOpenCodeSecondaryModel = await askModelSelection(rl, openCodeSupportList, openCodeSupportDefault, "Choose support model for explorer/librarian/fixer");
+          selectedOpenCodeSecondaryModel = await askModelSelection(rl, openCodeSupportList, openCodeSupportDefault, "Choose support model for surveyor/synthesizer/writer");
         }
         console.log();
       }
@@ -16637,13 +16650,13 @@ async function runInteractiveMode(detected, modelsOnly = false) {
         const recommendedPrimary = pickBestCodingChutesModel(discovery.models)?.model ?? discovery.models[0]?.model;
         if (recommendedPrimary) {
           console.log(`${BOLD}Chutes Models:${RESET}`);
-          selectedChutesPrimaryModel = await askModelSelection(rl, discovery.models, recommendedPrimary, "Choose Chutes primary model for orchestrator/oracle/designer");
+          selectedChutesPrimaryModel = await askModelSelection(rl, discovery.models, recommendedPrimary, "Choose Chutes primary model for orchestrator/critic/architect");
         }
         if (selectedChutesPrimaryModel) {
           const recommendedSecondary = pickSupportChutesModel(discovery.models, selectedChutesPrimaryModel)?.model ?? selectedChutesPrimaryModel;
           const chutesSupportList = discovery.models.filter((model) => model.model !== selectedChutesPrimaryModel);
           const chutesSupportDefault = recommendedSecondary === selectedChutesPrimaryModel ? chutesSupportList[0]?.model ?? recommendedSecondary : recommendedSecondary;
-          selectedChutesSecondaryModel = await askModelSelection(rl, chutesSupportList, chutesSupportDefault, "Choose Chutes support model for explorer/librarian/fixer");
+          selectedChutesSecondaryModel = await askModelSelection(rl, chutesSupportList, chutesSupportDefault, "Choose Chutes support model for surveyor/synthesizer/writer");
         }
         console.log();
       }

package/dist/cli/providers.d.ts

@@ -4,23 +4,23 @@ export declare const MODEL_MAPPINGS: {
         readonly orchestrator: {
             readonly model: "kimi-for-coding/k2p5";
         };
-        readonly oracle: {
+        readonly critic: {
             readonly model: "kimi-for-coding/k2p5";
             readonly variant: "high";
         };
-        readonly librarian: {
+        readonly synthesizer: {
             readonly model: "kimi-for-coding/k2p5";
             readonly variant: "low";
         };
-        readonly explorer: {
+        readonly surveyor: {
             readonly model: "kimi-for-coding/k2p5";
             readonly variant: "low";
         };
-        readonly designer: {
+        readonly architect: {
             readonly model: "kimi-for-coding/k2p5";
             readonly variant: "medium";
         };
-        readonly fixer: {
+        readonly writer: {
             readonly model: "kimi-for-coding/k2p5";
             readonly variant: "low";
         };
@@ -29,23 +29,23 @@ export declare const MODEL_MAPPINGS: {
         readonly orchestrator: {
             readonly model: "openai/gpt-5.3-codex";
         };
-        readonly oracle: {
+        readonly critic: {
             readonly model: "openai/gpt-5.3-codex";
             readonly variant: "high";
         };
-        readonly librarian: {
+        readonly synthesizer: {
             readonly model: "openai/gpt-5.1-codex-mini";
             readonly variant: "low";
         };
-        readonly explorer: {
+        readonly surveyor: {
             readonly model: "openai/gpt-5.1-codex-mini";
             readonly variant: "low";
         };
-        readonly designer: {
+        readonly architect: {
             readonly model: "openai/gpt-5.1-codex-mini";
             readonly variant: "medium";
         };
-        readonly fixer: {
+        readonly writer: {
             readonly model: "openai/gpt-5.1-codex-mini";
             readonly variant: "low";
         };
@@ -54,23 +54,23 @@ export declare const MODEL_MAPPINGS: {
         readonly orchestrator: {
             readonly model: "anthropic/claude-opus-4-6";
         };
-        readonly oracle: {
+        readonly critic: {
             readonly model: "anthropic/claude-opus-4-6";
             readonly variant: "high";
         };
-        readonly librarian: {
+        readonly synthesizer: {
             readonly model: "anthropic/claude-sonnet-4-5";
             readonly variant: "low";
         };
-        readonly explorer: {
+        readonly surveyor: {
             readonly model: "anthropic/claude-haiku-4-5";
             readonly variant: "low";
         };
-        readonly designer: {
+        readonly architect: {
             readonly model: "anthropic/claude-sonnet-4-5";
             readonly variant: "medium";
         };
-        readonly fixer: {
+        readonly writer: {
             readonly model: "anthropic/claude-sonnet-4-5";
             readonly variant: "low";
         };
@@ -79,23 +79,23 @@ export declare const MODEL_MAPPINGS: {
         readonly orchestrator: {
             readonly model: "github-copilot/grok-code-fast-1";
         };
-        readonly oracle: {
+        readonly critic: {
             readonly model: "github-copilot/grok-code-fast-1";
             readonly variant: "high";
         };
-        readonly librarian: {
+        readonly synthesizer: {
             readonly model: "github-copilot/grok-code-fast-1";
             readonly variant: "low";
         };
-        readonly explorer: {
+        readonly surveyor: {
             readonly model: "github-copilot/grok-code-fast-1";
             readonly variant: "low";
         };
-        readonly designer: {
+        readonly architect: {
             readonly model: "github-copilot/grok-code-fast-1";
             readonly variant: "medium";
         };
-        readonly fixer: {
+        readonly writer: {
             readonly model: "github-copilot/grok-code-fast-1";
             readonly variant: "low";
         };
@@ -104,23 +104,23 @@ export declare const MODEL_MAPPINGS: {
         readonly orchestrator: {
             readonly model: "zai-coding-plan/glm-4.7";
         };
-        readonly oracle: {
+        readonly critic: {
             readonly model: "zai-coding-plan/glm-4.7";
             readonly variant: "high";
         };
-        readonly librarian: {
+        readonly synthesizer: {
             readonly model: "zai-coding-plan/glm-4.7";
             readonly variant: "low";
         };
-        readonly explorer: {
+        readonly surveyor: {
             readonly model: "zai-coding-plan/glm-4.7";
             readonly variant: "low";
         };
-        readonly designer: {
+        readonly architect: {
             readonly model: "zai-coding-plan/glm-4.7";
             readonly variant: "medium";
         };
-        readonly fixer: {
+        readonly writer: {
             readonly model: "zai-coding-plan/glm-4.7";
             readonly variant: "low";
         };
@@ -129,22 +129,22 @@ export declare const MODEL_MAPPINGS: {
         readonly orchestrator: {
             readonly model: "google/antigravity-gemini-3-flash";
         };
-        readonly oracle: {
+        readonly critic: {
             readonly model: "google/antigravity-gemini-3.1-pro";
         };
-        readonly librarian: {
+        readonly synthesizer: {
             readonly model: "google/antigravity-gemini-3-flash";
             readonly variant: "low";
         };
-        readonly explorer: {
+        readonly surveyor: {
             readonly model: "google/antigravity-gemini-3-flash";
             readonly variant: "low";
         };
-        readonly designer: {
+        readonly architect: {
             readonly model: "google/antigravity-gemini-3-flash";
             readonly variant: "medium";
         };
-        readonly fixer: {
+        readonly writer: {
             readonly model: "google/antigravity-gemini-3-flash";
             readonly variant: "low";
         };
@@ -153,23 +153,23 @@ export declare const MODEL_MAPPINGS: {
         readonly orchestrator: {
             readonly model: "chutes/kimi-k2.5";
         };
-        readonly oracle: {
+        readonly critic: {
             readonly model: "chutes/kimi-k2.5";
             readonly variant: "high";
         };
-        readonly librarian: {
+        readonly synthesizer: {
             readonly model: "chutes/minimax-m2.1";
             readonly variant: "low";
         };
-        readonly explorer: {
+        readonly surveyor: {
             readonly model: "chutes/minimax-m2.1";
             readonly variant: "low";
         };
-        readonly designer: {
+        readonly architect: {
             readonly model: "chutes/kimi-k2.5";
             readonly variant: "medium";
         };
-        readonly fixer: {
+        readonly writer: {
             readonly model: "chutes/minimax-m2.1";
             readonly variant: "low";
         };
@@ -178,23 +178,23 @@ export declare const MODEL_MAPPINGS: {
         readonly orchestrator: {
             readonly model: "opencode/big-pickle";
         };
-        readonly oracle: {
+        readonly critic: {
             readonly model: "opencode/big-pickle";
             readonly variant: "high";
         };
-        readonly librarian: {
+        readonly synthesizer: {
             readonly model: "opencode/big-pickle";
             readonly variant: "low";
         };
-        readonly explorer: {
+        readonly surveyor: {
             readonly model: "opencode/big-pickle";
             readonly variant: "low";
         };
-        readonly designer: {
+        readonly architect: {
             readonly model: "opencode/big-pickle";
             readonly variant: "medium";
         };
-        readonly fixer: {
+        readonly writer: {
             readonly model: "opencode/big-pickle";
             readonly variant: "low";
         };

package/dist/cli/scoring-v2/types.d.ts

@@ -2,7 +2,7 @@ import type { DiscoveredModel, ExternalSignalMap } from '../types';
 export type ScoreFeatureName = 'status' | 'context' | 'output' | 'versionBonus' | 'reasoning' | 'toolcall' | 'attachment' | 'quality' | 'coding' | 'latencyPenalty' | 'pricePenalty';
 export type FeatureVector = Record<ScoreFeatureName, number>;
 export type FeatureWeights = Record<ScoreFeatureName, number>;
-export type ScoringAgentName = 'orchestrator' | 'oracle' | 'designer' | 'explorer' | 'librarian' | 'fixer';
+export type ScoringAgentName = 'orchestrator' | 'critic' | 'architect' | 'surveyor' | 'synthesizer' | 'writer';
 export interface ScoringContext {
     agent: ScoringAgentName;
     externalSignals?: ExternalSignalMap;

package/dist/config/loader.d.ts

@@ -20,7 +20,7 @@ export declare function loadPluginConfig(directory: string): PluginConfig;
  * If preset is provided and safe for paths, it first checks {preset}/ subdirectory,
  * then falls back to the root prompts directory.
  *
- * @param agentName - Name of the agent (e.g., "orchestrator", "explorer")
+ * @param agentName - Name of the agent (e.g., "orchestrator", "surveyor")
  * @param preset - Optional preset name for preset-scoped prompt lookup
  * @returns Object with prompt and/or appendPrompt if files exist
  */

package/dist/index.js

@@ -16,50 +16,63 @@ var __export = (target, all) => {
 
 // src/cli/custom-skills.ts
 var CUSTOM_SKILLS = [
-  {
-    name: "cartography",
-    description: "Repository understanding and hierarchical codemap generation",
-    allowedAgents: ["orchestrator", "explorer"],
-    sourcePath: "src/skills/cartography"
-  }
-];
-
-// src/cli/skills.ts
-var RECOMMENDED_SKILLS = [
   {
     name: "literature-review",
-    repo: "https://github.com/ZeguanXiao/oh-my-openidea",
-    skillName: "literature-review",
+    description: "Structured literature survey workflow",
     allowedAgents: ["orchestrator", "surveyor", "synthesizer"],
-    description: "Structured literature survey workflow"
+    sourcePath: "src/skills/literature-review"
   },
   {
     name: "hypothesis-generation",
-    repo: "https://github.com/ZeguanXiao/oh-my-openidea",
-    skillName: "hypothesis-generation",
+    description: "Gap-driven hypothesis generation workflow",
     allowedAgents: ["orchestrator", "synthesizer"],
-    description: "Gap-driven hypothesis generation workflow"
+    sourcePath: "src/skills/hypothesis-generation"
   },
   {
     name: "idea-critique",
-    repo: "https://github.com/ZeguanXiao/oh-my-openidea",
-    skillName: "idea-critique",
+    description: "Multi-round adversarial idea review workflow",
     allowedAgents: ["orchestrator", "critic"],
-    description: "Multi-round adversarial idea review workflow"
+    sourcePath: "src/skills/idea-critique"
   },
   {
     name: "experiment-design",
-    repo: "https://github.com/ZeguanXiao/oh-my-openidea",
-    skillName: "experiment-design",
+    description: "Experimental plan design workflow",
     allowedAgents: ["orchestrator", "architect"],
-    description: "Experimental plan design workflow"
+    sourcePath: "src/skills/experiment-design"
   },
   {
     name: "paper-outline",
-    repo: "https://github.com/ZeguanXiao/oh-my-openidea",
-    skillName: "paper-outline",
+    description: "Paper outline generation workflow",
     allowedAgents: ["orchestrator", "writer"],
-    description: "Paper outline generation workflow"
+    sourcePath: "src/skills/paper-outline"
+  },
+  {
+    name: "cartography",
+    description: "Repository understanding and hierarchical codemap generation",
+    allowedAgents: ["orchestrator"],
+    sourcePath: "src/skills/cartography"
+  }
+];
+
+// src/cli/skills.ts
+var RECOMMENDED_SKILLS = [
+  {
+    name: "simplify",
+    repo: "https://github.com/brianlovin/claude-config",
+    skillName: "simplify",
+    allowedAgents: ["orchestrator"],
+    description: "YAGNI code simplification expert"
+  },
+  {
+    name: "agent-browser",
+    repo: "https://github.com/vercel-labs/agent-browser",
+    skillName: "agent-browser",
+    allowedAgents: ["architect"],
+    description: "High-performance browser automation",
+    postInstallCommands: [
+      "npm install -g agent-browser",
+      "agent-browser install"
+    ]
   }
 ];
 var PERMISSION_ONLY_SKILLS = [];
@@ -15830,12 +15843,12 @@ var DELEGATE_TASK_ERROR_PATTERNS = [
   {
     pattern: "category OR subagent_type",
     errorType: "mutual_exclusion",
-    fixHint: 'Provide only one: category (e.g., "unspecified-low") OR subagent_type (e.g., "explorer").'
+    fixHint: 'Provide only one: category (e.g., "unspecified-low") OR subagent_type (e.g., "surveyor").'
   },
   {
     pattern: "Must provide either category or subagent_type",
     errorType: "missing_category_or_agent",
-    fixHint: 'Add either category="unspecified-low" or subagent_type="explorer".'
+    fixHint: 'Add either category="unspecified-low" or subagent_type="surveyor".'
   },
   {
     pattern: "Unknown category",

package/dist/utils/agent-variant.d.ts

@@ -2,11 +2,11 @@ import type { PluginConfig } from '../config';
 /**
  * Normalizes an agent name by trimming whitespace and removing the optional @ prefix.
  *
- * @param agentName - The agent name to normalize (e.g., "@oracle" or "oracle")
+ * @param agentName - The agent name to normalize (e.g., "@critic" or "critic")
  * @returns The normalized agent name without @ prefix and trimmed of whitespace
  *
  * @example
- * normalizeAgentName("@oracle") // returns "oracle"
+ * normalizeAgentName("@critic") // returns "critic"
  * normalizeAgentName("  explore  ") // returns "explore"
  */
 export declare function normalizeAgentName(agentName: string): string;
@@ -24,7 +24,7 @@ export declare function normalizeAgentName(agentName: string): string;
  * @returns The trimmed variant string, or undefined if no valid variant is found
  *
  * @example
- * resolveAgentVariant(config, "@oracle") // returns "high" if configured
+ * resolveAgentVariant(config, "@critic") // returns "high" if configured
  */
 export declare function resolveAgentVariant(config: PluginConfig | undefined, agentName: string): string | undefined;
 /**
@@ -39,8 +39,8 @@ export declare function resolveAgentVariant(config: PluginConfig | undefined, ag
  * @returns The body with the variant applied (new object) or the original body unchanged
  *
  * @example
- * applyAgentVariant("high", { agent: "oracle" }) // returns { agent: "oracle", variant: "high" }
- * applyAgentVariant("high", { agent: "oracle", variant: "low" }) // returns original body with variant: "low"
+ * applyAgentVariant("high", { agent: "critic" }) // returns { agent: "critic", variant: "high" }
+ * applyAgentVariant("high", { agent: "critic", variant: "low" }) // returns original body with variant: "low"
  */
 export declare function applyAgentVariant<T extends {
     variant?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-openidea",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Multi-agent framework for CS/ML research idea generation — literature survey, hypothesis generation, novelty checking, methodology design, and paper outlining",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/skills/cartography/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: cartography
+description: Repository understanding and hierarchical codemap generation — maps project structure, generates codemap.md files, and tracks changes via .slim/cartography.json.
+---
+
+# Cartography Skill
+
+This skill provides **repository understanding and hierarchical codemap generation** for projects managed by the orchestrator.
+
+## When to Use
+
+Use this skill when:
+- Starting work on an unfamiliar codebase and need a high-level map
+- Generating or updating `codemap.md` files after significant refactors
+- Creating `.slim/cartography.json` for change tracking
+- Answering questions about project structure and file organization
+
+## Workflow
+
+### Step 1: Explore Repository Structure
+Traverse the repository tree and identify top-level modules, entry points, and key directories.
+
+### Step 2: Generate Codemaps
+For each significant directory, produce a `codemap.md` summarizing its purpose, key files, and their roles.
+
+### Step 3: Update Tracking File
+Write or update `.slim/cartography.json` with the current map, file hashes, and last-modified timestamps.
+
+## Output
+
+- `codemap.md` files in each mapped directory
+- `.slim/cartography.json` with the full repository map