@zcy2nn/agent-forge 1.0.6 → 1.1.1

package/dist/cli/custom-skills.d.ts

@@ -1,6 +1,6 @@
 /**
  * A custom skill bundled in this repository.
- * Unlike npx-installed skills, these are copied from src/skills/ to the OpenCode skills directory
+ * Built-in skills are read directly from the package at runtime (no file copy needed).
  */
 export interface CustomSkill {
     /** Skill name (folder name) */
@@ -16,14 +16,3 @@ export interface CustomSkill {
  * Registry of custom skills bundled in this repository.
  */
 export declare const CUSTOM_SKILLS: CustomSkill[];
-/**
- * Get the target directory for custom skills installation.
- */
-export declare function getCustomSkillsDir(): string;
-/**
- * Install a custom skill by copying from src/skills/ to the OpenCode skills directory
- * @param skill - The custom skill to install
- * @param projectRoot - Root directory of agent-forge project
- * @returns True if installation succeeded, false otherwise
- */
-export declare function installCustomSkill(skill: CustomSkill): boolean;

package/dist/cli/index.js

@@ -13,14 +13,14 @@ import * as path from "node:path";
 
 // src/cli/config-io.ts
 import {
-  copyFileSync as copyFileSync2,
-  existsSync as existsSync3,
+  copyFileSync,
+  existsSync as existsSync2,
   readFileSync,
   renameSync,
-  statSync as statSync2,
+  statSync,
   writeFileSync
 } from "node:fs";
-import { dirname as dirname3, join as join3 } from "node:path";
+import { dirname as dirname2, join as join2 } from "node:path";
 
 // src/cli/paths.ts
 import { existsSync, mkdirSync } from "node:fs";
@@ -390,15 +390,6 @@ var DEFAULT_AGENT_MCPS = {
 };
 
 // src/cli/custom-skills.ts
-import {
-  copyFileSync,
-  existsSync as existsSync2,
-  mkdirSync as mkdirSync2,
-  readdirSync,
-  statSync
-} from "node:fs";
-import { dirname as dirname2, join as join2 } from "node:path";
-import { fileURLToPath } from "node:url";
 var CUSTOM_SKILLS = [
   {
     name: "simplify",
@@ -491,45 +482,6 @@ var CUSTOM_SKILLS = [
     sourcePath: "src/skills/writing-skills"
   }
 ];
-function getCustomSkillsDir() {
-  return join2(getConfigDir(), "skills");
-}
-function copyDirRecursive(src, dest) {
-  if (!existsSync2(dest)) {
-    mkdirSync2(dest, { recursive: true });
-  }
-  const entries = readdirSync(src);
-  for (const entry of entries) {
-    const srcPath = join2(src, entry);
-    const destPath = join2(dest, entry);
-    const stat = statSync(srcPath);
-    if (stat.isDirectory()) {
-      copyDirRecursive(srcPath, destPath);
-    } else {
-      const destDir = dirname2(destPath);
-      if (!existsSync2(destDir)) {
-        mkdirSync2(destDir, { recursive: true });
-      }
-      copyFileSync(srcPath, destPath);
-    }
-  }
-}
-function installCustomSkill(skill) {
-  try {
-    const packageRoot = fileURLToPath(new URL("../..", import.meta.url));
-    const sourcePath = join2(packageRoot, skill.sourcePath);
-    const targetPath = join2(getCustomSkillsDir(), skill.name);
-    if (!existsSync2(sourcePath)) {
-      console.error(`Custom skill source not found: ${sourcePath}`);
-      return false;
-    }
-    copyDirRecursive(sourcePath, targetPath);
-    return true;
-  } catch (error) {
-    console.error(`Failed to install custom skill: ${skill.name}`, error);
-    return false;
-  }
-}
 
 // src/cli/skills.ts
 import { spawnSync } from "node:child_process";
@@ -642,7 +594,7 @@ function generateLiteConfig(installConfig) {
       ...RECOMMENDED_SKILLS.filter((s) => s.allowedAgents.includes("*") || s.allowedAgents.includes(agentName)).map((s) => s.skillName),
       ...CUSTOM_SKILLS.filter((s) => s.allowedAgents.includes("*") || s.allowedAgents.includes(agentName)).map((s) => s.name)
     ];
-    if (agentName === "implementer" && !skills.includes("agent-browser")) {
+    if (installConfig.installSkills && agentName === "implementer" && !skills.includes("agent-browser")) {
       skills.push("agent-browser");
     }
     return {
@@ -696,10 +648,10 @@ function normalizePathForMatch(path) {
   return path.replaceAll("\\", "/");
 }
 function findPackageRoot(startPath) {
-  let currentPath = dirname3(startPath);
+  let currentPath = dirname2(startPath);
   while (true) {
-    const packageJsonPath = join3(currentPath, "package.json");
-    if (existsSync3(packageJsonPath)) {
+    const packageJsonPath = join2(currentPath, "package.json");
+    if (existsSync2(packageJsonPath)) {
       try {
         const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
         if (packageJson.name === PACKAGE_NAME) {
@@ -707,7 +659,7 @@ function findPackageRoot(startPath) {
         }
       } catch {}
     }
-    const parentPath = dirname3(currentPath);
+    const parentPath = dirname2(currentPath);
     if (parentPath === currentPath) {
       return null;
     }
@@ -722,8 +674,8 @@ function isLocalPackageRootEntry(entry) {
   if (!entry || entry.startsWith("file://")) {
     return false;
   }
-  const packageJsonPath = join3(entry, "package.json");
-  if (!existsSync3(packageJsonPath)) {
+  const packageJsonPath = join2(entry, "package.json");
+  if (!existsSync2(packageJsonPath)) {
     return false;
   }
   try {
@@ -762,9 +714,9 @@ function stripJsonComments(json) {
 }
 function parseConfigFile(path) {
   try {
-    if (!existsSync3(path))
+    if (!existsSync2(path))
       return { config: null };
-    const stat = statSync2(path);
+    const stat = statSync(path);
     if (stat.size === 0)
       return { config: null };
     const content = readFileSync(path, "utf-8");
@@ -793,8 +745,8 @@ function writeConfig(configPath, config) {
   const bakPath = `${configPath}.bak`;
   const content = `${JSON.stringify(config, null, 2)}
 `;
-  if (existsSync3(configPath)) {
-    copyFileSync2(configPath, bakPath);
+  if (existsSync2(configPath)) {
+    copyFileSync(configPath, bakPath);
   }
   writeFileSync(tmpPath, content);
   renameSync(tmpPath, configPath);
@@ -880,8 +832,8 @@ function writeLiteConfig(installConfig, targetPath) {
     const bakPath = `${configPath}.bak`;
     const content = `${JSON.stringify(config, null, 2)}
 `;
-    if (existsSync3(configPath)) {
-      copyFileSync2(configPath, bakPath);
+    if (existsSync2(configPath)) {
+      copyFileSync(configPath, bakPath);
     }
     writeFileSync(tmpPath, content);
     renameSync(tmpPath, configPath);
@@ -1256,11 +1208,11 @@ Options:
 }
 
 // src/cli/install.ts
-import { existsSync as existsSync5 } from "node:fs";
+import { existsSync as existsSync4 } from "node:fs";
 import { createInterface } from "node:readline/promises";
 // src/cli/system.ts
 import { spawnSync as spawnSync2 } from "node:child_process";
-import { statSync as statSync4 } from "node:fs";
+import { statSync as statSync3 } from "node:fs";
 
 // src/utils/compat.ts
 import { spawn as nodeSpawn } from "node:child_process";
@@ -1381,7 +1333,7 @@ function resolveOpenCodePath() {
     if (opencodePath === "opencode")
       continue;
     try {
-      const stat = statSync4(opencodePath);
+      const stat = statSync3(opencodePath);
       if (stat.isFile()) {
         cachedOpenCodePath = opencodePath;
         return opencodePath;
@@ -1532,8 +1484,6 @@ async function runInstall(config) {
   let totalSteps = 6;
   if (config.installSkills)
     totalSteps += 1;
-  if (config.installCustomSkills)
-    totalSteps += 1;
   let step = 1;
   printStep(step++, totalSteps, "Checking OpenCode installation...");
   if (config.dryRun) {
@@ -1587,7 +1537,7 @@ ${JSON.stringify(liteConfig, null, 2)}
 `);
   } else {
     const configPath2 = getExistingLiteConfigPath();
-    const configExists = existsSync5(configPath2);
+    const configExists = existsSync4(configPath2);
     if (configExists && !config.reset) {
       printInfo(`Configuration already exists at ${configPath2}. Use --reset to overwrite.`);
     } else {
@@ -1616,28 +1566,8 @@ ${JSON.stringify(liteConfig, null, 2)}
       }
       printSuccess(`${skillsInstalled}/${RECOMMENDED_SKILLS.length} skills processed`);
     }
-  }
-  if (config.installCustomSkills) {
-    printStep(step++, totalSteps, "Installing custom skills...");
-    if (config.dryRun) {
-      printInfo("Dry run mode - would install custom skills:");
-      for (const skill of CUSTOM_SKILLS) {
-        printInfo(`  - ${skill.name}`);
-      }
-    } else {
-      let customSkillsInstalled = 0;
-      for (const skill of CUSTOM_SKILLS) {
-        printInfo(`Installing ${skill.name}...`);
-        if (installCustomSkill(skill)) {
-          printSuccess(`Installed: ${skill.name}`);
-          customSkillsInstalled++;
-        } else {
-          printInfo(`Skipped: ${skill.name} (already installed)`);
-        }
-      }
-      const totalCustom = CUSTOM_SKILLS.length;
-      printSuccess(`${customSkillsInstalled}/${totalCustom} custom skills processed`);
-    }
+  } else {
+    printInfo("Recommended skills (e.g. agent-browser) not installed. Use --skills=yes to install them.");
   }
   const statusMsg = isUpdate ? "Configuration updated!" : "Installation complete!";
   console.log(`${SYMBOLS.star} ${BOLD}${GREEN}${statusMsg}${RESET}`);
@@ -1674,7 +1604,6 @@ async function install(args) {
   const config = {
     hasTmux: false,
     installSkills: args.skills === "yes",
-    installCustomSkills: args.skills === "yes",
     preset: args.preset,
     promptForStar: args.tui,
     dryRun: args.dryRun,
@@ -1696,7 +1625,7 @@ function getGeneratedPresetNames2() {
 function parseArgs(args) {
   const result = {
     tui: true,
-    skills: "yes"
+    skills: "no"
   };
   for (const arg of args) {
     if (arg === "--no-tui") {
@@ -1730,7 +1659,7 @@ Usage:
   bunx @zcy2nn/agent-forge doctor [OPTIONS]
 
 Options:
-  --skills=yes|no        Install recommended and bundled skills (default: yes)
+  --skills=yes|no        Install recommended skills like agent-browser (default: no)
   --preset=<name>        Active generated config preset (default: openai)
   --no-tui               Non-interactive mode
   --dry-run              Simulate install without writing files

package/dist/cli/types.d.ts

@@ -15,7 +15,6 @@ export interface OpenCodeConfig {
 export interface InstallConfig {
     hasTmux: boolean;
     installSkills: boolean;
-    installCustomSkills: boolean;
     preset?: string;
     promptForStar?: boolean;
     dryRun?: boolean;

package/dist/hooks/filter-available-skills/index.d.ts

@@ -1,7 +1,8 @@
 /**
- * Filter available_skills block based on the current agent's permission.skill rules.
- * OpenCode core injects `<available_skills>` globally, so this hook rewrites that
- * block before the prompt is sent.
+ * Filter and inject available_skills block based on the current agent's permission.skill rules.
+ * OpenCode core injects `<available_skills>` from installed skills, so this hook rewrites that
+ * block before the prompt is sent. Built-in skills from the package are also injected so they
+ * are always visible even without being copied to the OpenCode skills directory.
  */
 import type { PluginInput } from '@opencode-ai/plugin';
 import { type PluginConfig } from '../../config';
@@ -19,6 +20,14 @@ interface MessageWithParts {
     parts: MessagePart[];
 }
 type SkillRule = 'allow' | 'ask' | 'deny';
+interface SkillEntry {
+    name: string;
+    block: string;
+}
+/**
+ * Merge installed skill entries with built-in entries (dedup by name, installed takes precedence).
+ */
+declare function mergeWithBuiltinSkills(installedEntries: SkillEntry[]): SkillEntry[];
 declare function filterAvailableSkillsText(text: string, permissionRules: Record<string, SkillRule>): string;
 /**
  * Creates the experimental.chat.messages.transform hook for filtering available skills.
@@ -29,4 +38,4 @@ export declare function createFilterAvailableSkillsHook(_ctx: PluginInput, confi
         messages: MessageWithParts[];
     }) => Promise<void>;
 };
-export { filterAvailableSkillsText };
+export { filterAvailableSkillsText, mergeWithBuiltinSkills };

package/dist/hooks/index.d.ts

@@ -9,5 +9,6 @@ export { processImageAttachments } from './image-hook';
 export { createJsonErrorRecoveryHook } from './json-error-recovery';
 export { createPhaseReminderHook } from './phase-reminder';
 export { createPostFileToolNudgeHook } from './post-file-tool-nudge';
+export { createSessionBootstrapHook } from './session-bootstrap';
 export { createTaskSessionManagerHook } from './task-session-manager';
 export { createTodoContinuationHook } from './todo-continuation';

package/dist/hooks/session-bootstrap/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Session bootstrap hook — injects lightweight assessment framework
+ * into the first user message of each session.
+ *
+ * This gives the orchestrator a "work manual front page" so it assesses
+ * task complexity before jumping into implementation.
+ * Only injected for the orchestrator agent, only once per session.
+ */
+interface MessageInfo {
+    role: string;
+    agent?: string;
+    sessionID?: string;
+}
+interface MessagePart {
+    type: string;
+    text?: string;
+    [key: string]: unknown;
+}
+interface MessageWithParts {
+    info: MessageInfo;
+    parts: MessagePart[];
+}
+/**
+ * Creates the experimental.chat.messages.transform hook for session bootstrap.
+ * Injects the assessment framework into the first user message, orchestrator only.
+ */
+export declare function createSessionBootstrapHook(): {
+    'experimental.chat.messages.transform': (_input: Record<string, never>, output: {
+        messages: MessageWithParts[];
+    }) => Promise<void>;
+};
+export {};

package/dist/index.js

@@ -18150,14 +18150,14 @@ var require_turndown_cjs = __commonJS((exports, module) => {
       } else if (node.nodeType === 1) {
         replacement = replacementForNode.call(self, node);
       }
-      return join15(output, replacement);
+      return join14(output, replacement);
     }, "");
   }
   function postProcess(output) {
     var self = this;
     this.rules.forEach(function(rule) {
       if (typeof rule.append === "function") {
-        output = join15(output, rule.append(self.options));
+        output = join14(output, rule.append(self.options));
       }
     });
     return output.replace(/^[\t\r\n]+/, "").replace(/[\t\r\n\s]+$/, "");
@@ -18170,7 +18170,7 @@ var require_turndown_cjs = __commonJS((exports, module) => {
       content = content.trim();
     return whitespace.leading + rule.replacement(content, node, this.options) + whitespace.trailing;
   }
-  function join15(output, replacement) {
+  function join14(output, replacement) {
     var s1 = trimTrailingNewlines(output);
     var s2 = trimLeadingNewlines(replacement);
     var nls = Math.max(output.length - s1.length, replacement.length - s2.length);
@@ -18185,38 +18185,6 @@ var require_turndown_cjs = __commonJS((exports, module) => {
   module.exports = TurndownService;
 });
 
-// src/cli/custom-skills.ts
-import { dirname as dirname2, join as join2 } from "node:path";
-
-// src/cli/paths.ts
-import { homedir } from "node:os";
-import { dirname, join } from "node:path";
-function getDefaultOpenCodeConfigDir() {
-  const userConfigDir = process.env.XDG_CONFIG_HOME ? process.env.XDG_CONFIG_HOME : join(homedir(), ".config");
-  return join(userConfigDir, "opencode");
-}
-function getCustomOpenCodeConfigDir() {
-  const configDir = process.env.OPENCODE_CONFIG_DIR?.trim();
-  return configDir || undefined;
-}
-function getConfigDir() {
-  const customConfigDir = getCustomOpenCodeConfigDir();
-  if (customConfigDir) {
-    return customConfigDir;
-  }
-  return getDefaultOpenCodeConfigDir();
-}
-function getConfigSearchDirs() {
-  const dirs = [getCustomOpenCodeConfigDir(), getDefaultOpenCodeConfigDir()];
-  return dirs.filter((dir, index) => {
-    return Boolean(dir) && dirs.indexOf(dir) === index;
-  });
-}
-function getOpenCodeConfigPaths() {
-  const configDir = getDefaultOpenCodeConfigDir();
-  return [join(configDir, "opencode.json"), join(configDir, "opencode.jsonc")];
-}
-
 // src/cli/custom-skills.ts
 var CUSTOM_SKILLS = [
   {
@@ -18310,9 +18278,6 @@ var CUSTOM_SKILLS = [
     sourcePath: "src/skills/writing-skills"
   }
 ];
-function getCustomSkillsDir() {
-  return join2(getConfigDir(), "skills");
-}
 
 // src/cli/skills.ts
 var RECOMMENDED_SKILLS = [
@@ -18474,6 +18439,28 @@ var CouncilConfigSchema = z.object({
 import * as fs from "node:fs";
 import * as path from "node:path";
 
+// src/cli/paths.ts
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+function getDefaultOpenCodeConfigDir() {
+  const userConfigDir = process.env.XDG_CONFIG_HOME ? process.env.XDG_CONFIG_HOME : join(homedir(), ".config");
+  return join(userConfigDir, "opencode");
+}
+function getCustomOpenCodeConfigDir() {
+  const configDir = process.env.OPENCODE_CONFIG_DIR?.trim();
+  return configDir || undefined;
+}
+function getConfigSearchDirs() {
+  const dirs = [getCustomOpenCodeConfigDir(), getDefaultOpenCodeConfigDir()];
+  return dirs.filter((dir, index) => {
+    return Boolean(dir) && dirs.indexOf(dir) === index;
+  });
+}
+function getOpenCodeConfigPaths() {
+  const configDir = getDefaultOpenCodeConfigDir();
+  return [join(configDir, "opencode.json"), join(configDir, "opencode.jsonc")];
+}
+
 // src/config/agent-mcps.ts
 var DEFAULT_AGENT_MCPS = {
   orchestrator: ["*", "!context7"],
@@ -22810,6 +22797,19 @@ ${buildRetryGuidance(detected)}`;
 // src/hooks/filter-available-skills/index.ts
 var AVAILABLE_SKILLS_BLOCK_REGEX = /<available_skills>\s*([\s\S]*?)\s*<\/available_skills>/g;
 var SKILL_NAME_REGEX = /<name>([^<]+)<\/name>/;
+function builtinSkillBlock(name, description) {
+  return `<skill>
+  <name>${name}</name>
+  <description>${description}</description>
+  <location>builtin</location>
+</skill>`;
+}
+function getBuiltinSkillEntries() {
+  return CUSTOM_SKILLS.map((skill) => ({
+    name: skill.name,
+    block: builtinSkillBlock(skill.name, skill.description)
+  }));
+}
 function getCurrentAgent(messages) {
   for (let index = messages.length - 1;index >= 0; index -= 1) {
     const message = messages[index];
@@ -22842,9 +22842,21 @@ function isSkillAllowed(skillName, permissionRules) {
   }
   return permissionRules["*"] === "allow";
 }
+function mergeWithBuiltinSkills(installedEntries) {
+  const builtinEntries = getBuiltinSkillEntries();
+  const installedNames = new Set(installedEntries.map((e) => e.name));
+  for (const entry of builtinEntries) {
+    if (!installedNames.has(entry.name)) {
+      installedEntries.push(entry);
+    }
+  }
+  return installedEntries;
+}
 function filterAvailableSkillsText(text, permissionRules) {
   return text.replace(AVAILABLE_SKILLS_BLOCK_REGEX, (_fullMatch, blockContent) => {
-    const allowedEntries = extractSkillEntries(blockContent).filter((entry) => isSkillAllowed(entry.name, permissionRules));
+    let allEntries = extractSkillEntries(blockContent);
+    allEntries = mergeWithBuiltinSkills(allEntries);
+    const allowedEntries = allEntries.filter((entry) => isSkillAllowed(entry.name, permissionRules));
     if (allowedEntries.length === 0) {
       return `<available_skills>
 No skills available.
@@ -22856,6 +22868,22 @@ ${allowedEntries.map((entry) => entry.block).join(`
 </available_skills>`;
   });
 }
+function injectBuiltinSkillsIfMissing(text, permissionRules) {
+  if (text.includes("<available_skills>")) {
+    return text;
+  }
+  const builtinEntries = getBuiltinSkillEntries();
+  const allowedEntries = builtinEntries.filter((entry) => isSkillAllowed(entry.name, permissionRules));
+  if (allowedEntries.length === 0) {
+    return text;
+  }
+  const block = `<available_skills>
+${allowedEntries.map((entry) => entry.block).join(`
+`)}
+</available_skills>`;
+  return `${text}
+${block}`;
+}
 function createFilterAvailableSkillsHook(_ctx, config) {
   const permissionRulesByAgent = new Map;
   const getPermissionRules = (agentName) => {
@@ -22878,10 +22906,14 @@ function createFilterAvailableSkillsHook(_ctx, config) {
       const permissionRules = getPermissionRules(agentName);
       for (const message of messages) {
         for (const part of message.parts) {
-          if (part.type !== "text" || !part.text || !part.text.includes("<available_skills>")) {
+          if (part.type !== "text" || !part.text) {
             continue;
           }
-          part.text = filterAvailableSkillsText(part.text, permissionRules);
+          if (part.text.includes("<available_skills>")) {
+            part.text = filterAvailableSkillsText(part.text, permissionRules);
+          } else {
+            part.text = injectBuiltinSkillsIfMissing(part.text, permissionRules);
+          }
         }
       }
     }
@@ -23123,7 +23155,7 @@ import {
   unlinkSync as unlinkSync2,
   writeFileSync as writeFileSync3
 } from "node:fs";
-import { basename as basename2, extname, join as join8 } from "node:path";
+import { basename as basename2, extname, join as join7 } from "node:path";
 var lastCleanupByDir = new Map;
 var CLEANUP_INTERVAL = 10 * 60 * 1000;
 function isImagePart(p) {
@@ -23171,7 +23203,7 @@ function cleanupAllSessions(saveDir) {
   const dirsToScan = [];
   try {
     for (const entry of readdirSync2(saveDir, { withFileTypes: true })) {
-      const fp = join8(saveDir, entry.name);
+      const fp = join7(saveDir, entry.name);
       if (entry.isDirectory()) {
         dirsToScan.push(fp);
       } else {
@@ -23188,7 +23220,7 @@ function cleanupAllSessions(saveDir) {
       let allRemoved = true;
       for (const f of readdirSync2(dir)) {
         isEmpty = false;
-        const fp = join8(dir, f);
+        const fp = join7(dir, f);
         try {
           if (now - statSync3(fp).mtimeMs > maxAge) {
             unlinkSync2(fp);
@@ -23210,7 +23242,7 @@ function cleanupAllSessions(saveDir) {
 function writeUniqueFile(dir, name, data, log2) {
   const ext = extname(name);
   const base = basename2(name, ext) || name;
-  let candidate = join8(dir, name);
+  let candidate = join7(dir, name);
   if (existsSync5(candidate)) {
     return candidate;
   }
@@ -23223,7 +23255,7 @@ function writeUniqueFile(dir, name, data, log2) {
     } catch (e) {
       if (e instanceof Error && e.code === "EEXIST") {
         counter += 1;
-        candidate = join8(dir, `${base}-${counter}${ext}`);
+        candidate = join7(dir, `${base}-${counter}${ext}`);
         continue;
       }
       log2(`[image-hook] failed to save image: ${e}`);
@@ -23247,13 +23279,13 @@ function processImageAttachments(args) {
       messagesWithImages.push({ msg, imageParts });
     }
   }
-  const saveDir = join8(workDir, ".opencode", "images");
+  const saveDir = join7(workDir, ".opencode", "images");
   if (messagesWithImages.length === 0) {
     if (existsSync5(saveDir))
       cleanupAllSessions(saveDir);
     return;
   }
-  const gitignorePath = join8(workDir, ".opencode", ".gitignore");
+  const gitignorePath = join7(workDir, ".opencode", ".gitignore");
   try {
     mkdirSync3(saveDir, { recursive: true });
     if (!existsSync5(gitignorePath))
@@ -23265,7 +23297,7 @@ function processImageAttachments(args) {
   cleanupAllSessions(saveDir);
   for (const { msg, imageParts } of messagesWithImages) {
     const sessionSubdir = msg.info.sessionID ? sanitizeFilename(msg.info.sessionID) : undefined;
-    const targetDir = sessionSubdir ? join8(saveDir, sessionSubdir) : saveDir;
+    const targetDir = sessionSubdir ? join7(saveDir, sessionSubdir) : saveDir;
     try {
       mkdirSync3(targetDir, { recursive: true });
     } catch (e) {
@@ -23425,6 +23457,80 @@ function createPostFileToolNudgeHook(options = {}) {
     }
   };
 }
+// src/hooks/session-bootstrap/index.ts
+var BOOTSTRAP_MARKER = "<session_bootstrap>";
+var BOOTSTRAP_CONTENT = `${BOOTSTRAP_MARKER}
+## Instruction Priority
+1. User's explicit instructions (CLAUDE.md, AGENTS.md, direct requests) — highest
+2. Superpowers skills — override default system behavior where they conflict
+3. Default system prompt — lowest
+
+## Subagents
+Subagents dispatched to execute a specific task skip this flow.
+
+## Task Complexity Assessment
+Assess task complexity before responding:
+**Simple (direct answer):** Single step, knowledge question, small edit, config change, debug single error
+**Medium or Complex (proposal flow):** Multi-file changes, design decisions, new features, cross-module, architecture changes
+
+## Proposal Flow
+Present three tiers:
+Suggested approach:
+── Lightweight ── [Phase]
+── Recommended ── [Phase] → [Phase] → [Phase] → [Phase]
+── Full ── [Phase (strategy)] → [Phase] → [Phase (strategy)] → [Phase + Review]
+Pick one, or tell me custom steps.
+
+## Phase & Skill Mapping
+[Design] = brainstorming
+[Plan] = writing-plans
+[Implement] = test-driven-development / subagent-driven-development / dispatching-parallel-agents
+[Verify] = verification-before-completion
+[Review] = requesting-code-review
+Encounter bug → systematic-debugging (available at any phase)
+
+## Proposal Guidance
+- Don't over-simplify: if the task involves multi-file changes or design decisions, don't suggest "implement directly"
+- Don't over-complicate: simple questions don't need the proposal flow
+- Lightweight must include [Verify]: even a single-phase approach must run verification commands. Lightweight means fewer phases, not skipping discipline.
+- Be specific: describe what will be done clearly, avoid vague terms
+
+## Skill Types
+**Rigid** (TDD, debugging): Follow the spirit at all tiers. Simple tasks may use abbreviated forms (test-after, quick fix with verification), but the discipline of verify-before-claim always applies.
+**Flexible** (brainstorming, writing-plans): Adapt principles to context. Simple tasks may skip these entirely.
+
+## Skill Access
+Use the skill tool to list and load skills on demand.
+${BOOTSTRAP_MARKER}`;
+function createSessionBootstrapHook() {
+  return {
+    "experimental.chat.messages.transform": async (_input, output) => {
+      const { messages } = output;
+      if (messages.length === 0) {
+        return;
+      }
+      const firstUserMessage = messages.find((m) => m.info.role === "user");
+      if (!firstUserMessage) {
+        return;
+      }
+      const agent = firstUserMessage.info.agent;
+      if (agent && agent !== "orchestrator") {
+        return;
+      }
+      const textPartIndex = firstUserMessage.parts.findIndex((p) => p.type === "text" && typeof p.text === "string");
+      if (textPartIndex === -1) {
+        return;
+      }
+      const originalText = firstUserMessage.parts[textPartIndex].text ?? "";
+      if (originalText.includes(BOOTSTRAP_MARKER)) {
+        return;
+      }
+      firstUserMessage.parts[textPartIndex].text = `${BOOTSTRAP_CONTENT}
+
+${originalText}`;
+    }
+  };
+}
 // src/hooks/task-session-manager/index.ts
 import path9 from "node:path";
 var AGENT_NAME_SET = new Set([
@@ -29162,13 +29268,13 @@ import { existsSync as existsSync9 } from "node:fs";
 // src/tools/ast-grep/constants.ts
 import { existsSync as existsSync8, statSync as statSync4 } from "node:fs";
 import { createRequire as createRequire3 } from "node:module";
-import { dirname as dirname7, join as join12 } from "node:path";
+import { dirname as dirname6, join as join11 } from "node:path";
 
 // src/tools/ast-grep/downloader.ts
 import { chmodSync, existsSync as existsSync7, mkdirSync as mkdirSync5, unlinkSync as unlinkSync4 } from "node:fs";
 import { createRequire as createRequire2 } from "node:module";
 import { homedir as homedir5 } from "node:os";
-import { join as join11 } from "node:path";
+import { join as join10 } from "node:path";
 var REPO = "ast-grep/ast-grep";
 var DEFAULT_VERSION = "0.40.0";
 function getAstGrepVersion() {
@@ -29192,18 +29298,18 @@ var PLATFORM_MAP = {
 function getCacheDir2() {
   if (process.platform === "win32") {
     const localAppData = process.env.LOCALAPPDATA || process.env.APPDATA;
-    const base2 = localAppData || join11(homedir5(), "AppData", "Local");
-    return join11(base2, "agent-forge", "bin");
+    const base2 = localAppData || join10(homedir5(), "AppData", "Local");
+    return join10(base2, "agent-forge", "bin");
   }
   const xdgCache = process.env.XDG_CACHE_HOME;
-  const base = xdgCache || join11(homedir5(), ".cache");
-  return join11(base, "agent-forge", "bin");
+  const base = xdgCache || join10(homedir5(), ".cache");
+  return join10(base, "agent-forge", "bin");
 }
 function getBinaryName() {
   return process.platform === "win32" ? "sg.exe" : "sg";
 }
 function getCachedBinaryPath() {
-  const binaryPath = join11(getCacheDir2(), getBinaryName());
+  const binaryPath = join10(getCacheDir2(), getBinaryName());
   return existsSync7(binaryPath) ? binaryPath : null;
 }
 async function downloadAstGrep(version = DEFAULT_VERSION) {
@@ -29215,7 +29321,7 @@ async function downloadAstGrep(version = DEFAULT_VERSION) {
   }
   const cacheDir = getCacheDir2();
   const binaryName = getBinaryName();
-  const binaryPath = join11(cacheDir, binaryName);
+  const binaryPath = join10(cacheDir, binaryName);
   if (existsSync7(binaryPath)) {
     return binaryPath;
   }
@@ -29231,7 +29337,7 @@ async function downloadAstGrep(version = DEFAULT_VERSION) {
     if (!response.ok) {
       throw new Error(`HTTP ${response.status}: ${response.statusText}`);
     }
-    const archivePath = join11(cacheDir, assetName);
+    const archivePath = join10(cacheDir, assetName);
     const arrayBuffer = await response.arrayBuffer();
     await crossWrite(archivePath, arrayBuffer);
     await extractZip(archivePath, cacheDir);
@@ -29319,8 +29425,8 @@ function findSgCliPathSync() {
   try {
     const require2 = createRequire3(import.meta.url);
     const cliPkgPath = require2.resolve("@ast-grep/cli/package.json");
-    const cliDir = dirname7(cliPkgPath);
-    const sgPath = join12(cliDir, binaryName);
+    const cliDir = dirname6(cliPkgPath);
+    const sgPath = join11(cliDir, binaryName);
     if (existsSync8(sgPath) && isValidBinary(sgPath)) {
       return sgPath;
     }
@@ -29330,9 +29436,9 @@ function findSgCliPathSync() {
     try {
       const require2 = createRequire3(import.meta.url);
       const pkgPath = require2.resolve(`${platformPkg}/package.json`);
-      const pkgDir = dirname7(pkgPath);
+      const pkgDir = dirname6(pkgPath);
       const astGrepName = process.platform === "win32" ? "ast-grep.exe" : "ast-grep";
-      const binaryPath = join12(pkgDir, astGrepName);
+      const binaryPath = join11(pkgDir, astGrepName);
       if (existsSync8(binaryPath) && isValidBinary(binaryPath)) {
         return binaryPath;
       }
@@ -29999,16 +30105,12 @@ Usage: /preset <name> to switch.`);
 }
 // src/tools/skill.ts
 import { existsSync as existsSync10, readFileSync as readFileSync5 } from "node:fs";
-import { join as join14 } from "node:path";
+import { join as join13 } from "node:path";
 import { tool as tool4 } from "@opencode-ai/plugin/tool";
 var z5 = tool4.schema;
 function resolveSkillPath(skillName) {
-  const installedPath = join14(getCustomSkillsDir(), skillName, "SKILL.md");
-  if (existsSync10(installedPath)) {
-    return installedPath;
-  }
-  const packageRoot = join14(import.meta.dirname, "..", "..");
-  const bundledPath = join14(packageRoot, "src", "skills", skillName, "SKILL.md");
+  const packageRoot = join13(import.meta.dirname, "..", "..");
+  const bundledPath = join13(packageRoot, "src", "skills", skillName, "SKILL.md");
   if (existsSync10(bundledPath)) {
     return bundledPath;
   }
@@ -32455,6 +32557,7 @@ var OhMyOpenCodeLite = async (ctx) => {
   let multiplexerSessionManager;
   let autoUpdateChecker;
   let phaseReminderHook;
+  let sessionBootstrapHook;
   let filterAvailableSkillsHook;
   let sessionAgentMap;
   let postFileToolNudgeHook;
@@ -32540,6 +32643,7 @@ var OhMyOpenCodeLite = async (ctx) => {
       autoUpdate: config.autoUpdate ?? true
     });
     phaseReminderHook = createPhaseReminderHook();
+    sessionBootstrapHook = createSessionBootstrapHook();
     filterAvailableSkillsHook = createFilterAvailableSkillsHook(ctx, config);
     sessionAgentMap = new Map;
     postFileToolNudgeHook = createPostFileToolNudgeHook({
@@ -32922,6 +33026,7 @@ ${output.system[0]}` : "");
     },
     "experimental.chat.messages.transform": async (input, output) => {
       const typedOutput = output;
+      await sessionBootstrapHook["experimental.chat.messages.transform"](input, typedOutput);
       for (const message of typedOutput.messages) {
         if (message.info.role !== "user") {
           continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zcy2nn/agent-forge",
-  "version": "1.0.6",
+  "version": "1.1.1",
   "description": "Lightweight agent orchestration plugin for OpenCode - a slimmed-down fork of oh-my-opencode",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/skills/brainstorming/SKILL.md

@@ -10,12 +10,20 @@ Help turn ideas into fully formed designs and specs through natural collaborativ
 Start by understanding the current project context, then ask questions one at a time to refine the idea. Once you understand what you're building, present the design and get user approval.
 
 <HARD-GATE>
-Do NOT invoke any implementation skill, write any code, scaffold any project, or take any implementation action until you have presented a design and the user has approved it. This applies to EVERY project regardless of perceived simplicity.
+For Medium/Complex tasks: Do NOT invoke any implementation skill, write any code, scaffold any project, or take any implementation action until you have presented a design and the user has approved it.
+
+For Simple tasks: You may proceed directly if the task is a knowledge question, small config change, or single-file edit with no design decisions. If uncertain whether a design is needed, err on the side of presenting a Lightweight design (2-3 sentences) and getting oral confirmation.
 </HARD-GATE>
 
-## Anti-Pattern: "This Is Too Simple To Need A Design"
+## Complexity Adaptation
+
+This skill adapts to the complexity tier determined by session-bootstrap:
+
+- **Simple tasks** (direct answer tier): Skip this skill entirely unless the task involves design decisions. If a Simple task does need design, use Lightweight mode.
+- **Medium tasks**: Use Lightweight or Standard mode.
+- **Complex tasks**: Use Standard or Deep mode. The HARD-GATE above applies in full.
 
-Every project goes through this process. A todo list, a single-function utility, a config change — all of them. "Simple" projects are where unexamined assumptions cause the most wasted work. The design can be short (a few sentences for truly simple projects), but you MUST present it and get approval.
+Don't skip design when it matters — "simple" tasks with unexamined assumptions cause the most wasted work. But don't force ceremony when it genuinely doesn't add value.
 
 ## Checklist
 
@@ -150,6 +158,7 @@ Wait for the user's response. If they request changes, make them and re-run the
 - Skip context exploration, skip one-by-one questions
 - Give 2-3 options directly for user to pick
 - No spec document — oral confirmation is enough
+- Applies when session-bootstrap classifies the task as Simple and design is still warranted
 
 **Standard usage:**
 - Full flow: explore context → one-by-one questions → compare approaches → present design → write spec

package/src/skills/systematic-debugging/SKILL.md

@@ -16,10 +16,13 @@ Random fixes waste time and create new bugs. Quick patches mask underlying issue
 ## The Iron Law
 
 ```
-NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST
+For Medium/Complex bugs: NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST
+For Simple bugs: Quick fix is acceptable if the cause is obvious, but verify the fix works
 ```
 
-If you haven't completed Phase 1, you cannot propose fixes.
+If you haven't completed Phase 1 for a Medium/Complex bug, you cannot propose fixes.
+
+For Simple bugs (single error, obvious symptom, config typo, known pattern): you may fix directly, but must verify the fix resolves the issue. If the quick fix doesn't work, escalate to full investigation immediately.
 
 ## When to Use
 
@@ -39,9 +42,14 @@ Use for ANY technical issue:
 - You don't fully understand the issue
 
 **Don't skip when:**
-- Issue seems simple (simple bugs have root causes too)
 - You're in a hurry (rushing guarantees rework)
 - Manager wants it fixed NOW (systematic is faster than thrashing)
+- Previous fix didn't work (symptom fixing masks root cause)
+
+**When abbreviated investigation is acceptable:**
+- session-bootstrap classifies the task as Simple
+- The cause is obvious from the error message (e.g., config typo, missing import)
+- If the quick fix doesn't work, immediately escalate to full investigation
 
 ## The Four Phases
 
@@ -290,8 +298,10 @@ These techniques are part of systematic debugging and available in this director
 ## Complexity Assessment
 
 **Lightweight usage:**
-- Reproduce → read error → fix directly
+- Reproduce → read error → fix directly (only when cause is obvious)
 - Skip hypothesis verification and root cause analysis
+- Applies when session-bootstrap classifies the task as Simple
+- If quick fix doesn't work, escalate to Standard immediately
 
 **Standard usage:**
 - Full flow: reproduce → gather evidence → hypothesize → verify → fix → regression test

package/src/skills/test-driven-development/SKILL.md

@@ -15,34 +15,43 @@ Write the test first. Watch it fail. Write minimal code to pass.
 
 ## When to Use
 
-**Always:**
+**Always (for Medium/Complex tasks):**
 - New features
 - Bug fixes
 - Refactoring
 - Behavior changes
 
+**Simple tasks (test-after acceptable):**
+- Config changes
+- Typo fixes
+- Single-line corrections
+- Obvious corrections with no logic change
+
 **Exceptions (ask your human partner):**
 - Throwaway prototypes
 - Generated code
 - Configuration files
+- Simple edits classified by session-bootstrap (config changes, typos, single-line fixes)
 
 Thinking "skip TDD just this once"? Stop. That's rationalization.
 
 ## The Iron Law
 
 ```
-NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST
+For Medium/Complex tasks: NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST
+For Simple tasks: Test-after is acceptable, but verification is still required
 ```
 
-Write code before the test? Delete it. Start over.
+**Medium/Complex tasks:** Write code before the test? Delete it. Start over.
 
-**No exceptions:**
 - Don't keep it as "reference"
 - Don't "adapt" it while writing tests
 - Don't look at it
 - Delete means delete
 
-Implement fresh from tests. Period.
+**Simple tasks** (as classified by session-bootstrap): If the change is a config change, typo fix, single-line correction, or similar trivial edit — implement first, then write a test or run verification. If the change affects behavior or logic, TDD still applies.
+
+Implement fresh from tests. Period (for Medium/Complex).
 
 ## Red-Green-Refactor
 

package/src/skills/verification-before-completion/SKILL.md

@@ -21,6 +21,10 @@ NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE
 
 If you haven't run the verification command in this message, you cannot claim it passes.
 
+**This applies at ALL complexity tiers.** What varies is the depth of verification:
+- **Simple tasks:** Run the relevant verification command (tests, linter, build) and confirm it passes
+- **Medium/Complex tasks:** Run full verification suite, check coverage, verify edge cases, review against requirements
+
 ## The Gate Function
 
 ```
@@ -134,14 +138,16 @@ From 24 failure memories:
 
 **Lightweight usage:**
 - Run core tests, confirm pass
+- Applies when session-bootstrap classifies the task as Simple
 
 **Standard usage:**
 - Run all tests + check coverage + verify edge cases
 
-## The Bottom Line
+**Deep usage:**
+- Standard + requirements checklist + line-by-line verification + cross-reference with design spec
 
-**No shortcuts for verification.**
+## The Bottom Line
 
-Run the command. Read the output. THEN claim the result.
+**No shortcuts for verification.** The principle is non-negotiable; the depth adapts to complexity.
 
-This is non-negotiable.
+Run the command. Read the output. THEN claim the result. Whether you run one test or the full suite depends on the task's complexity tier, but you must ALWAYS run something before claiming completion.

package/dist/cli/migration.d.ts

@@ -1,46 +0,0 @@
-/** Result of a migration attempt. */
-export interface MigrationResult {
-    /** Whether a legacy config was detected. */
-    detected: boolean;
-    /** Whether the migration was performed. */
-    migrated: boolean;
-    /** Path to the new config file, if migrated. */
-    newPath?: string;
-    /** Path to the legacy config file that was found. */
-    legacyPath?: string;
-    /** Error message if migration failed. */
-    error?: string;
-}
-/**
- * Get all possible legacy config file paths (json and jsonc).
- */
-export declare function getLegacyConfigPaths(): string[];
-/**
- * Detect whether a legacy `oh-my-opencode-slim.json` config exists.
- * Returns the path if found, or undefined.
- */
-export declare function detectLegacyConfig(): string | undefined;
-/**
- * Check if a config object contains any legacy agent names
- * in its presets or agents sections.
- */
-export declare function hasLegacyAgentNames(config: Record<string, unknown>): boolean;
-/**
- * Migrate agent names in a config object.
- *
- * - Renames primary mapping keys (explorer→researcher, oracle→reviewer,
- *   designer→implementer).
- * - For secondary mappings (librarian→researcher, fixer→implementer),
- *   only applies if the primary mapping target doesn't already exist.
- * - Removes observer entries entirely.
- * - Preserves all non-agent config keys unchanged.
- */
-export declare function migrateAgentNames(config: Record<string, unknown>): Record<string, unknown>;
-/**
- * Perform the full migration:
- * 1. Read legacy config
- * 2. Migrate agent names
- * 3. Write to `agent-forge.json`
- * 4. Rename legacy file to `.bak`
- */
-export declare function performMigration(legacyPath: string): MigrationResult;