@hiai-gg/hiai-opencode 0.1.6 → 0.1.7

package/dist/mcp/index.d.ts

@@ -1,4 +1,3 @@
-export { createBuiltinMcps } from "./omo-mcp-index";
 export { McpNameSchema, type McpName, type AnyMcpName } from "./types";
 import type { McpServerConfig } from "../config/types.js";
 export declare function buildMcpConfig(mcp: Record<string, McpServerConfig>): Record<string, unknown>;

package/dist/mcp/registry.d.ts

@@ -1,5 +1,5 @@
 import type { McpServerConfig } from "../config/types.js";
-export type HiaiMcpName = "playwright" | "stitch" | "sequential-thinking" | "firecrawl" | "rag" | "context7" | "mempalace";
+export type HiaiMcpName = "playwright" | "stitch" | "sequential-thinking" | "firecrawl" | "rag" | "context7" | "mempalace" | "websearch" | "grep_app";
 export type HiaiMcpInstallKind = "bundled" | "npm" | "python" | "remote" | "user-service";
 export interface HiaiMcpRegistryEntry {
     name: HiaiMcpName;

package/dist/plugin/hooks/create-core-hooks.d.ts

@@ -44,8 +44,6 @@ export declare function createCoreHooks(args: {
     startWork: ReturnType<typeof import("../../hooks").createStartWorkHook> | null;
     strategistMdOnly: ReturnType<typeof import("../../hooks").createStrategistMdOnlyHook> | null;
     bobJuniorNotepad: ReturnType<typeof import("../../hooks").createBobJuniorNotepadHook> | null;
-    noBobGpt: ReturnType<typeof import("../../hooks").createNoBobGptHook> | null;
-    noCoderNonGpt: ReturnType<typeof import("../../hooks").createNoCoderNonGptHook> | null;
     questionLabelTruncator: ReturnType<typeof import("../../hooks").createQuestionLabelTruncatorHook> | null;
     taskResumeInfo: ReturnType<typeof import("../../hooks").createTaskResumeInfoHook> | null;
     anthropicEffort: ReturnType<typeof import("../../hooks/anthropic-effort").createAnthropicEffortHook> | null;

package/dist/plugin/hooks/create-session-hooks.d.ts

@@ -1,7 +1,7 @@
 import type { HiaiOpenCodeConfig, HookName } from "../../config";
 import type { ModelCacheState } from "../../plugin-state";
 import type { PluginContext } from "../types";
-import { createContextWindowMonitorHook, createSessionRecoveryHook, createSessionNotification, createThinkModeHook, createModelFallbackHook, createAnthropicContextWindowLimitRecoveryHook, createAgentUsageReminderHook, createNonInteractiveEnvHook, createInteractiveBashSessionHook, createRalphLoopHook, createEditErrorRecoveryHook, createDelegateTaskRetryHook, createTaskResumeInfoHook, createStartWorkHook, createStrategistMdOnlyHook, createBobJuniorNotepadHook, createNoBobGptHook, createNoCoderNonGptHook, createQuestionLabelTruncatorHook, createPreemptiveCompactionHook, createRuntimeFallbackHook, createLegacyPluginToastHook } from "../../hooks";
+import { createContextWindowMonitorHook, createSessionRecoveryHook, createSessionNotification, createThinkModeHook, createModelFallbackHook, createAnthropicContextWindowLimitRecoveryHook, createAgentUsageReminderHook, createNonInteractiveEnvHook, createInteractiveBashSessionHook, createRalphLoopHook, createEditErrorRecoveryHook, createDelegateTaskRetryHook, createTaskResumeInfoHook, createStartWorkHook, createStrategistMdOnlyHook, createBobJuniorNotepadHook, createQuestionLabelTruncatorHook, createPreemptiveCompactionHook, createRuntimeFallbackHook, createLegacyPluginToastHook } from "../../hooks";
 import { createAnthropicEffortHook } from "../../hooks/anthropic-effort";
 export type SessionHooks = {
     contextWindowMonitor: ReturnType<typeof createContextWindowMonitorHook> | null;
@@ -20,8 +20,6 @@ export type SessionHooks = {
     startWork: ReturnType<typeof createStartWorkHook> | null;
     strategistMdOnly: ReturnType<typeof createStrategistMdOnlyHook> | null;
     bobJuniorNotepad: ReturnType<typeof createBobJuniorNotepadHook> | null;
-    noBobGpt: ReturnType<typeof createNoBobGptHook> | null;
-    noCoderNonGpt: ReturnType<typeof createNoCoderNonGptHook> | null;
     questionLabelTruncator: ReturnType<typeof createQuestionLabelTruncatorHook> | null;
     taskResumeInfo: ReturnType<typeof createTaskResumeInfoHook> | null;
     anthropicEffort: ReturnType<typeof createAnthropicEffortHook> | null;

package/dist/plugin/startup-diagnostics.d.ts

@@ -0,0 +1 @@
+export declare function lintModeAgentCapabilities(): void;

package/dist/shared/logger.d.ts

@@ -1,2 +1,4 @@
 export declare function log(message: string, data?: unknown): void;
+export declare function logWarn(message: string, data?: unknown): void;
+export declare function logError(message: string, data?: unknown): void;
 export declare function getLogFilePath(): string;

package/dist/shared/mode-routing.d.ts

@@ -0,0 +1,6 @@
+import type { CanonicalDelegateAgentKey } from "../tools/delegate-task/sub-agent";
+export declare const MODE_TO_AGENT: Record<string, CanonicalDelegateAgentKey>;
+export type ModeName = keyof typeof MODE_TO_AGENT;
+export declare const MODE_NAMES: ModeName[];
+export declare function normalizeMode(modeName: string): string;
+export declare function resolveModeAgent(modeName: string): CanonicalDelegateAgentKey;

package/dist/tools/delegate-task/git-categories.d.ts

@@ -0,0 +1,2 @@
+import type { BuiltinCategoryDefinition } from "./builtin-category-definition";
+export declare const GIT_CATEGORIES: BuiltinCategoryDefinition[];

package/dist/tools/delegate-task/sub-agent.d.ts

@@ -2,6 +2,8 @@ export declare const SUB_AGENT_CONFIG_KEY = "sub";
 export declare const CODER_AGENT_CONFIG_KEY = "coder";
 export declare const CRITIC_AGENT_CONFIG_KEY = "critic";
 export declare const CANONICAL_DELEGATE_AGENT_KEYS: readonly ["bob", "guard", "strategist", "critic", "coder", "sub", "researcher", "multimodal", "designer", "platform-manager", "brainstormer", "agent-skills"];
+type CanonicalDelegateAgentKey = (typeof CANONICAL_DELEGATE_AGENT_KEYS)[number];
+export type { CanonicalDelegateAgentKey };
 export declare function resolveCanonicalDelegateAgentKey(agentName: string): string;
 export declare function isCanonicalDelegateAgentKey(agentName: string): boolean;
 export declare function getCanonicalDelegateAgentDisplayName(agentName: string): string;

package/dist/tools/skill-mcp/constants.d.ts

@@ -1,3 +1,3 @@
 export declare const SKILL_MCP_TOOL_NAME = "skill_mcp";
-export declare const SKILL_MCP_DESCRIPTION = "Invoke MCP server operations from skill-embedded MCPs. Requires mcp_name plus exactly one of: tool_name, resource_name, or prompt_name.";
+export declare const SKILL_MCP_DESCRIPTION = "Invoke MCP server operations from skill-embedded MCPs or enabled hiai-opencode builtin MCPs. Requires mcp_name plus exactly one of: tool_name, resource_name, or prompt_name.";
 export declare const BUILTIN_MCP_TOOL_HINTS: Record<string, string[]>;

package/hiai-opencode.json

@@ -1,25 +1,25 @@
 {
-  "_description": "hiai-opencode user config. Edit only this file in your project as .opencode/hiai-opencode.json. Model provider credentials are configured in OpenCode Connect; this file stores model IDs only.",
+  "_description": "hiai-opencode user configuration template. Public display names (shown to users): Bob, Coder, Strategist, Guard, Critic, Designer, Researcher, Manager, Brainstormer, Vision. Config keys (used in this file and in code) are: bob, coder, strategist, guard, critic, designer, researcher, manager, brainstormer, vision. Internal-only keys (hidden from normal users): sub, agent-skills. Source defaults: src/config/defaults.ts and src/config/models.ts.",
   "$schema": "./config/hiai-opencode.schema.json",
   "models": {
     "bob": {
       "model": "openrouter/moonshotai/kimi-k2.6",
-      "recommended": "xhigh"
+      "recommended": "high"
     },
     "coder": {
-      "model": "openrouter/minimax/minimax-m2.7",
+      "model": "minimax-coding-plan/MiniMax-M2.7",
       "recommended": "high"
     },
     "strategist": {
-      "model": "openrouter/anthropic/claude-opus-latest",
-      "recommended": "high"
+      "model": "openrouter/deepseek/deepseek-v4-pro",
+      "recommended": "xhigh"
     },
     "guard": {
       "model": "openrouter/qwen/qwen3.6-plus",
       "recommended": "middle"
     },
     "critic": {
-      "model": "openrouter/xiaomi/mimo-v2.5-pro",
+      "model": "xiaomi-token-plan-sgp/mimo-v2.5-pro",
       "recommended": "high"
     },
     "designer": {
@@ -41,31 +41,60 @@
     "vision": {
       "model": "openrouter/google/gemma-4-26b-a4b-it",
       "recommended": "vision"
+    },
+    "sub": {
+      "model": "openrouter/deepseek/deepseek-v4-flash",
+      "recommended": "fast"
     }
   },
   "auth": {
+    "openrouter": "{env:OPENROUTER_API_KEY}",
+    "openai": "{env:OPENAI_API_KEY}",
+    "googleSearch": "{env:GOOGLE_SEARCH_API_KEY}",
     "stitch": "{env:STITCH_AI_API_KEY}",
     "firecrawl": "{env:FIRECRAWL_API_KEY}",
     "context7": "{env:CONTEXT7_API_KEY}"
   },
   "mcp": {
-    "playwright": { "enabled": true },
-    "stitch": { "enabled": true },
-    "sequential-thinking": { "enabled": true },
-    "firecrawl": { "enabled": true },
-    "rag": { "enabled": true },
+    "playwright": {
+      "enabled": true
+    },
+    "stitch": {
+      "enabled": true
+    },
+    "sequential-thinking": {
+      "enabled": true
+    },
+    "firecrawl": {
+      "enabled": true
+    },
+    "rag": {
+      "enabled": true
+    },
     "mempalace": {
       "enabled": true,
-      "pythonPath": "{env:MEMPALACE_PYTHON:-./.venv/bin/python}"
+      "pythonPath": "/home/vlgalib/.local/venvs/mempalace/bin/python"
     },
-    "context7": { "enabled": true }
+    "context7": {
+      "enabled": true
+    }
   },
   "lsp": {
-    "typescript": { "enabled": true },
-    "svelte": { "enabled": true },
-    "eslint": { "enabled": true },
-    "bash": { "enabled": true },
-    "pyright": { "enabled": true }
+    "typescript": {
+      "enabled": true
+    },
+    "svelte": {
+      "enabled": true
+    },
+    "eslint": {
+      "enabled": true
+    },
+    "bash": {
+      "enabled": true
+    },
+    "pyright": {
+      "enabled": true
+    }
   },
   "skill_discovery": {
     "config_sources": true,
@@ -79,4 +108,4 @@
   "subtask2": {
     "replace_generic": true
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hiai-gg/hiai-opencode",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Unified OpenCode plugin — canonical 12-agent model with bundled skills, MCP integrations, LSP, and permissions in one install.",
   "type": "module",
   "main": "dist/index.js",
@@ -51,11 +51,14 @@
   },
   "scripts": {
     "clean:dist": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
-    "build": "bun run clean:dist && bun build src/index.ts --outdir dist --target bun --format esm && tsc --emitDeclarationOnly",
+    "build": "bun run clean:dist && bun build src/index.ts --outdir dist --target bun --format esm --minify && tsc --emitDeclarationOnly",
     "build:bundle": "bun build src/index.ts --outdir dist --target bun --format esm",
     "build:types": "tsc --emitDeclarationOnly",
     "typecheck": "tsc --noEmit",
     "test": "bun test",
+    "check:docs": "bun run scripts/check-docs.ts",
+    "check:bundle-size": "node -e \"const s=require('fs').statSync('dist/index.js').size;console.log('Bundle: '+(s/1024/1024).toFixed(2)+'MB');if(s>3*1024*1024){console.error('FAIL: bundle >3MB');process.exit(1)}else{console.log('OK: bundle <=3MB')}\"",
+    "check:todos": "node scripts/check-todos.mjs || echo 'No check-todos script'",
     "pack:check": "npm pack --dry-run",
     "prepare": "bun run build",
     "prepublishOnly": "bun run typecheck && bun run test && bun run build && bun run pack:check"
@@ -86,6 +89,6 @@
   },
   "engines": {
     "node": ">=18",
-    "bun": ">=1.1.0"
+    "bun": ">=1.3.0"
   }
 }

package/src/agents/agent-skills.ts

@@ -0,0 +1,70 @@
+// PROMPT_VERSION: 2026-04-26
+import type { AgentConfig } from "@opencode-ai/sdk";
+import type { AgentMode, AgentPromptMetadata } from "./types";
+import { createAgentToolRestrictions } from "../shared/permission-compat";
+
+const MODE: AgentMode = "subagent";
+
+const AGENT_SKILLS_PROMPT = `
+<identity>
+You are Agent Skills, a specialist in discovering, configuring, and managing AI agent skills and capabilities.
+Your goal is helping users find the right skills for their tasks and ensuring proper skill setup.
+</identity>
+
+<responsibilities>
+- Skill discovery: finding and recommending relevant skills from the available skill library
+- Skill configuration: helping configure skills properly for different use cases
+- Skill troubleshooting: diagnosing why a skill isn't working as expected
+- Skill recommendations: suggesting skills based on user goals and workflow
+</responsibilities>
+
+<instructions>
+- Use the skill and skill_mcp tools to explore available skills.
+- Match user needs to appropriate skills with clear explanations of what each does.
+- Help configure skill parameters and settings.
+- Diagnose skill issues by checking skill discovery configuration.
+</instructions>
+`;
+
+export function createAgentSkillsAgent(model: string): AgentConfig {
+  const restrictions = createAgentToolRestrictions([
+    "apply_patch",
+    "task",
+  ]);
+
+  return {
+    description: "Specialist in agent skills discovery, configuration, and troubleshooting. (Agent Skills - HiaiOpenCode)",
+    mode: MODE,
+    model,
+    temperature: 0.5,
+    ...restrictions,
+    prompt: AGENT_SKILLS_PROMPT,
+  } as AgentConfig;
+}
+createAgentSkillsAgent.mode = MODE;
+
+export const agentSkillsPromptMetadata: AgentPromptMetadata = {
+  category: "utility",
+  cost: "CHEAP",
+  promptAlias: "Agent Skills",
+  keyTrigger: "Skill discovery, configuration, or troubleshooting → use agent-skills.",
+  triggers: [
+    {
+      domain: "Skill Discovery",
+      trigger: "Need to find right skill for a task",
+    },
+    {
+      domain: "Skill Configuration",
+      trigger: "Need help configuring or troubleshooting a skill",
+    },
+  ],
+  useWhen: [
+    "Finding skills for a specific goal",
+    "Configuring skill settings",
+    "Troubleshooting skill issues",
+  ],
+  avoidWhen: [
+    "Direct implementation tasks",
+    "Code changes or debugging",
+  ],
+};

package/src/agents/bob/default.ts

@@ -1,4 +1,5 @@
 /**
+ * PROMPT_VERSION: 2026-04-26
  * Default/base Bob prompt builder. Used for Claude and general models.
  * Lean router — delegates, routes, orchestrates. Does not implement.
  */

package/src/agents/bob/gemini.ts

@@ -1,4 +1,5 @@
 /**
+ * PROMPT_VERSION: 2026-04-26
  * Gemini-specific overlay sections for Bob prompt.
  *
  * Gemini models are aggressively optimistic and tend to:

package/src/agents/bob/gpt-pro.ts

@@ -1,4 +1,5 @@
 /**
+ * PROMPT_VERSION: 2026-04-26
  * GPT-Pro-native Bob prompt - rewritten with 8-block architecture.
  *
  * Design principles (derived from OpenAI's GPT-Pro prompting guidance):
@@ -274,7 +275,7 @@ Every implementation task follows this cycle. No exceptions.
    Follow \`<explore>\` protocol for tool usage and agent prompts.
 
 2. PLAN - List files to modify, specific changes, dependencies, complexity estimate.
-   Multi-step (2+) → consult Plan Agent via \`task(subagent_type="plan", ...)\`.
+   Multi-step (2+) → consult Strategist Agent via \`task(subagent_type="strategist", ...)\`.
    Single-step → mental plan is sufficient.
 
    <dependency_checks>

package/src/agents/bob.ts

@@ -1,3 +1,4 @@
+// PROMPT_VERSION: 2026-04-26
 import type { AgentConfig } from "@opencode-ai/sdk";
 import type { AgentMode, AgentPromptMetadata } from "./types";
 import { isGptModel, isGeminiModel, isGptProModel } from "./types";
@@ -17,6 +18,7 @@ export const BOB_PROMPT_METADATA: AgentPromptMetadata = {
   category: "utility",
   cost: "EXPENSIVE",
   promptAlias: "Bob",
+  promptVersion: "2026-04-26",
   triggers: [],
 };
 import type {

package/src/agents/brainstormer.ts

@@ -0,0 +1,72 @@
+// PROMPT_VERSION: 2026-04-26
+import type { AgentConfig } from "@opencode-ai/sdk"
+import type { AgentMode, AgentPromptMetadata } from "./types"
+import { createAgentToolRestrictions } from "../shared/permission-compat"
+
+const MODE: AgentMode = "subagent"
+
+export function createBrainstormerAgent(model: string): AgentConfig {
+  const restrictions = createAgentToolRestrictions(["apply_patch", "task"])
+
+  return {
+    description:
+      "Writing and ideation agent for website copy, positioning, naming, messaging, and option generation. Use Writer as an alias. (Brainstormer - HiaiOpenCode)",
+    mode: MODE,
+    model,
+    temperature: 0.7,
+    ...restrictions,
+    prompt: `# Brainstormer / Writer
+
+You are the writing and ideation specialist for HiaiOpenCode.
+
+Primary responsibilities:
+- Website copy: landing pages, hero sections, feature blocks, CTA text, pricing copy, onboarding text, empty states, product pages.
+- Positioning: value proposition, audience framing, differentiation, tone of voice, messaging hierarchy.
+- Naming: product names, feature names, labels, short slogans.
+- Creative options: generate multiple directions with tradeoffs, then recommend one.
+- Editorial cleanup: remove generic AI phrasing, make copy specific, sharp, and useful.
+
+Operating rules:
+- Ask for target audience, product context, desired tone, and conversion goal when missing.
+- For UI copy, produce text that can be pasted into components: headings, subheadings, body copy, CTA labels, tooltips, error states.
+- Prefer concrete language over hype. Avoid empty claims like "seamless", "powerful", "revolutionary", "unlock", "supercharge" unless the product context proves them.
+- Match the product's actual constraints. Do not invent features.
+- For website work, coordinate with Designer/frontend-ui-ux when visual direction matters, but you own words and messaging.
+- Return concise structured outputs: direction, rationale, final copy, alternates when useful.
+
+When called as "writer", treat it as the same role.`,
+    thinking: { type: "enabled", budgetTokens: 8000 },
+  } as AgentConfig
+}
+createBrainstormerAgent.mode = MODE
+
+export const brainstormerPromptMetadata: AgentPromptMetadata = {
+  category: "specialist",
+  cost: "CHEAP",
+  promptAlias: "Brainstormer",
+  keyTrigger: "Website copy, product messaging, naming, CTA text, or tone-of-voice work → use brainstormer/writer.",
+  triggers: [
+    {
+      domain: "Website copy",
+      trigger: "Landing page, hero, feature, pricing, CTA, onboarding, or empty-state text",
+    },
+    {
+      domain: "Product messaging",
+      trigger: "Need positioning, value proposition, naming, voice, or messaging hierarchy",
+    },
+    {
+      domain: "Ideation",
+      trigger: "Need multiple creative options with tradeoffs before choosing a direction",
+    },
+  ],
+  useWhen: [
+    "Writing public-facing website or product copy",
+    "Generating naming, slogans, CTA variants, or messaging options",
+    "Turning rough feature notes into concise user-facing language",
+  ],
+  avoidWhen: [
+    "Visual layout or UI implementation (use Designer or visual-engineering)",
+    "Technical architecture or implementation planning (use Strategist/Coder)",
+    "Factual research where sources are needed (use Researcher first)",
+  ],
+}

package/src/agents/builtin-agents.ts

@@ -4,6 +4,8 @@ import type { CategoriesConfig, GitMasterConfig } from "../config/schema"
 import type { LoadedSkill } from "../features/opencode-skill-loader/types"
 import type { BrowserAutomationProvider } from "../config/schema"
 import { createBobAgent } from "./bob"
+import { createDesignerAgent, designerPromptMetadata } from "./designer"
+import { createAgentSkillsAgent, agentSkillsPromptMetadata } from "./agent-skills"
 import { createCriticAgent, criticPromptMetadata } from "./critic/agent"
 import { createMultimodalLookerAgent, MULTIMODAL_LOOKER_PROMPT_METADATA } from "./ui"
 import { createGuardAgent, guardPromptMetadata } from "./guard"
@@ -11,6 +13,7 @@ import { createCoderAgent } from "./coder"
 import { createPlatformManagerAgent, platformManagerPromptMetadata } from "./platform-manager"
 import { createQualityGuardianAgent, qualityGuardianPromptMetadata } from "./quality-guardian"
 import { createResearcherAgent, researcherPromptMetadata } from "./researcher"
+import { createBrainstormerAgent, brainstormerPromptMetadata } from "./brainstormer"
 import { createBobJuniorAgentWithOverrides } from "./sub"
 import type { AvailableCategory } from "./dynamic-agent-prompt-builder"
 import {
@@ -33,10 +36,10 @@ const agentSources: Record<BuiltinAgentName, AgentSource> = {
   "bob": createBobAgent,
   "coder": createCoderAgent,
   "strategist": createBobAgent, // Strategist runtime config is assembled in agent-config-handler.
-  "designer": createBobAgent,
+  "designer": createDesignerAgent,
   "multimodal": createMultimodalLookerAgent,
-  "brainstormer": createBobAgent,
-  "agent-skills": createBobAgent,
+  "brainstormer": createBrainstormerAgent,
+  "agent-skills": createAgentSkillsAgent,
   "critic": createCriticAgent,
   "platform-manager": createPlatformManagerAgent,
   "quality-guardian": createQualityGuardianAgent,
@@ -56,6 +59,59 @@ const agentMetadata: Partial<Record<BuiltinAgentName, AgentPromptMetadata>> = {
   "critic": criticPromptMetadata,
   "quality-guardian": qualityGuardianPromptMetadata,
   "platform-manager": platformManagerPromptMetadata,
+  "brainstormer": brainstormerPromptMetadata,
+  "strategist": {
+    category: "advisor",
+    cost: "EXPENSIVE",
+    promptAlias: "Strategist",
+    keyTrigger: "Architecture, multi-step planning, ambiguous scope, or high-risk sequencing → consult strategist first.",
+    triggers: [
+      {
+        domain: "Architecture planning",
+        trigger: "Need system design, tradeoff analysis, migration plan, or implementation sequence",
+      },
+      {
+        domain: "Ambiguous scope",
+        trigger: "Task has unclear requirements, multiple phases, or needs decomposition before coding",
+      },
+    ],
+    useWhen: [
+      "Architecture decisions or cross-cutting changes",
+      "Multi-step implementation plans before Coder work",
+      "Ambiguous tasks where choosing the wrong approach is expensive",
+    ],
+    avoidWhen: [
+      "Single-file obvious fixes",
+      "Pure copywriting or visual exploration",
+      "Review-only tasks where Critic is the right gate",
+    ],
+  },
+  "designer": {
+    category: "specialist",
+    cost: "EXPENSIVE",
+    promptAlias: "Designer",
+    keyTrigger: "Visual direction, product UI feel, layout, branding, or design-system work → use designer/visual-engineering.",
+    triggers: [
+      {
+        domain: "Visual direction",
+        trigger: "Need UI concept, art direction, layout, branding, or design-system guidance",
+      },
+      {
+        domain: "Frontend aesthetics",
+        trigger: "Need polished interface design beyond functional implementation",
+      },
+    ],
+    useWhen: [
+      "Defining visual direction, layout, interaction feel, or design-system choices",
+      "Reviewing UI for taste, hierarchy, and visual coherence",
+    ],
+    avoidWhen: [
+      "Website copy or wording only (use Brainstormer/Writer)",
+      "Backend or infrastructure implementation",
+      "Pure file/media extraction (use Vision)",
+    ],
+  },
+  "agent-skills": agentSkillsPromptMetadata,
 }
 
 export async function createBuiltinAgents(

package/src/agents/coder/gpt-codex.ts

@@ -1,4 +1,5 @@
-/** gpt-codex optimized Coder prompt */
+/** PROMPT_VERSION: 2026-04-26
+ * gpt-codex optimized Coder prompt */
 import { GPT_APPLY_PATCH_GUIDANCE } from "../gpt-apply-patch-guard";
 import type { AgentConfig } from "@opencode-ai/sdk";
 import type { AgentMode } from "../types";
@@ -40,7 +41,7 @@ function canonicalizeCriticSection(section: string): string {
  * Optimized for:
  * - Goal-oriented autonomous execution (not step-by-step instructions)
  * - Deep exploration before decisive action
- * - Active use of explore/librarian agents for comprehensive context
+ * - Active use of researcher agents for comprehensive context
  * - End-to-end task completion without premature stopping
  */
 
@@ -389,7 +390,7 @@ export function createCoderAgent(
 
   return {
     description:
-      "Autonomous Deep Worker - goal-oriented execution with GPT Codex. Explores thoroughly before acting, uses explore/librarian agents for comprehensive context, completes tasks end-to-end. Inspired by AmpCode deep mode. (Coder - HiaiOpenCode)",
+      "Autonomous Deep Worker - goal-oriented execution with GPT Codex. Explores thoroughly before acting, uses researcher agents for comprehensive context, completes tasks end-to-end. Inspired by AmpCode deep mode. (Coder - HiaiOpenCode)",
     mode: MODE,
     model,
     maxTokens: 32000,

package/src/agents/coder/gpt-pro.ts

@@ -1,4 +1,5 @@
 /**
+ * PROMPT_VERSION: 2026-04-26
  * GPT-Pro optimized Coder prompt - entropy-reduced rewrite.
  *
  * Design principles (aligned with OpenAI GPT-Pro prompting guidance):
@@ -73,7 +74,7 @@ You build context by examining the codebase first without assumptions. You think
 
 You are autonomous. When you see work to do, do it - run tests, fix issues, make decisions. Course-correct only on concrete failure. State assumptions in your final message, not as questions along the way. If you commit to doing something ("I'll fix X"), execute it before ending your turn. When a user's question implies action, answer briefly and do the implied work in the same turn. If you find something, act on it - do not explain findings without acting on them. Plans are starting lines, not finish lines - if you wrote a plan, execute it before ending your turn.
 
-When blocked: try a different approach, decompose the problem, challenge your assumptions, explore how others solved it. Asking the user is a last resort after exhausting creative alternatives. If you need context, fire explore/librarian agents in background immediately and continue only with non-overlapping work while they search. Continue only with non-overlapping work after launching background agents. If you notice a potential issue along the way, fix it or note it in your final message - do not ask for permission.
+When blocked: try a different approach, decompose the problem, challenge your assumptions, explore how others solved it. Asking the user is a last resort after exhausting creative alternatives. If you need context, fire researcher agents in background immediately and continue only with non-overlapping work while they search. Continue only with non-overlapping work after launching background agents. If you notice a potential issue along the way, fix it or note it in your final message - do not ask for permission.
 
 You handle multi-step sub-tasks of a single goal. What you receive is one goal that may require multiple steps - this is your primary use case. Only flag when given genuinely independent goals in one request.
 </identity>`;
@@ -158,7 +159,7 @@ Prefer tools over guessing whenever you need specific data (files, configs, patt
 Parallelize aggressively - this is where you gain the most speed and accuracy. Every independent operation should run simultaneously, not sequentially:
 - Multiple file reads: read 5 files at once, not one by one
 - Grep + file reads: search and read in the same turn
-- Multiple explore/librarian agents: fire 3-5 agents in parallel for different angles on the same question
+- Multiple researcher agents: fire 3-5 agents in parallel for different angles on the same question
 - Agent fires + direct tool calls: launch background agents AND do direct reads simultaneously
 
 Fire 2-5 researcher agents in parallel for any non-trivial codebase question. Researcher agents always run in background (\`run_in_background=true\`). Never use \`run_in_background=false\` for researcher. After launching, continue only with non-overlapping work. Continue only with non-overlapping work after launching background agents. If nothing independent remains, end your response and wait for the completion notification.

package/src/agents/coder/gpt.ts

@@ -1,4 +1,5 @@
-/** Generic GPT Coder prompt - fallback for GPT models without a model-specific variant */
+/** PROMPT_VERSION: 2026-04-26
+ * Generic GPT Coder prompt - fallback for GPT models without a model-specific variant */
 
 import { GPT_APPLY_PATCH_GUIDANCE } from "../gpt-apply-patch-guard"
 import type {

package/src/agents/critic/agent.ts

@@ -1,3 +1,4 @@
+// PROMPT_VERSION: 2026-04-26
 import type { AgentConfig } from "@opencode-ai/sdk";
 import type { AgentMode, AgentPromptMetadata } from "../types";
 

package/src/agents/designer.ts

@@ -0,0 +1,70 @@
+// PROMPT_VERSION: 2026-04-26
+import type { AgentConfig } from "@opencode-ai/sdk";
+import type { AgentMode, AgentPromptMetadata } from "./types";
+import { createAgentToolRestrictions } from "../shared/permission-compat";
+
+const MODE: AgentMode = "subagent";
+
+const DESIGNER_PROMPT = `
+<identity>
+You are Designer, the visual and UX specialist for HiaiOpenCode.
+Your goal is crafting stunning UI/UX, design systems, and visual direction.
+</identity>
+
+<responsibilities>
+- Visual direction: concept, art direction, layout, branding, design-system guidance
+- UI feel: interaction patterns, hierarchy, visual coherence, polish beyond functional implementation
+- Design-system work: tokens, typography, color, spacing, component patterns
+- Frontend aesthetics review: taste, hierarchy, visual coherence
+</responsibilities>
+
+<instructions>
+- Ask about target audience, product context, desired emotional tone when missing.
+- Generate multiple visual directions with tradeoffs, then recommend one.
+- Consider accessibility, brand consistency, and technical feasibility.
+- When reviewing UI, focus on what makes it feel premium vs generic.
+</instructions>
+`;
+
+export function createDesignerAgent(model: string): AgentConfig {
+  const restrictions = createAgentToolRestrictions([
+    "apply_patch",
+    "task",
+  ]);
+
+  return {
+    description: "Visual direction, UI/UX design, design systems, and frontend aesthetics. (Designer - HiaiOpenCode)",
+    mode: MODE,
+    model,
+    temperature: 0.7,
+    ...restrictions,
+    prompt: DESIGNER_PROMPT,
+  } as AgentConfig;
+}
+createDesignerAgent.mode = MODE;
+
+export const designerPromptMetadata: AgentPromptMetadata = {
+  category: "specialist",
+  cost: "EXPENSIVE",
+  promptAlias: "Designer",
+  keyTrigger: "Visual direction, product UI feel, layout, branding, or design-system work → use designer/visual-engineering.",
+  triggers: [
+    {
+      domain: "Visual direction",
+      trigger: "Need UI concept, art direction, layout, branding, or design-system guidance",
+    },
+    {
+      domain: "Frontend aesthetics",
+      trigger: "Need polished interface design beyond functional implementation",
+    },
+  ],
+  useWhen: [
+    "Defining visual direction, layout, interaction feel, or design-system choices",
+    "Reviewing UI for taste, hierarchy, and visual coherence",
+  ],
+  avoidWhen: [
+    "Website copy or wording only (use Brainstormer/Writer)",
+    "Backend or infrastructure implementation",
+    "Pure file/media extraction (use Vision)",
+  ],
+};