thoth-plugin 1.1.0

package/README.md

@@ -0,0 +1,84 @@
+# Thoth
+
+> Life orchestration system and OpenCode plugin for managing work, personal life, and technical projects.
+
+Thoth is a knowledge-based life operating system that acts as your chief of staff. Unlike traditional coding assistants, Thoth is designed to **support, guide, and mentor** — not just write code.
+
+## Features
+
+- **Four Hemispheres**: Organized knowledge across work, life, coding, and system (kernel)
+- **Depth-Based Specialization**: Agent persona adapts based on where you are in the knowledge base
+- **Smart Delegation**: Routes tasks to specialized sub-agents (Work Master, Life Master, Code Master)
+- **Permission System**: Critical actions require explicit approval
+- **Knowledge Persistence**: Learns and remembers across sessions
+
+## Depth-Based Specialization
+
+Thoth's personality and expertise change based on your current directory:
+
+| Depth | Example | Persona |
+|-------|---------|---------|
+| 0 | `/thoth/` | Pure Chief of Staff |
+| 1 | `/thoth/work/` | Executive COS (crisp, P0-focused) |
+| 1 | `/thoth/life/` | Personal Consultant (warm, Socratic) |
+| 2 | `/thoth/work/projects/` | Project Portfolio Manager |
+| 3 | `/thoth/work/projects/x/` | Deep Expert on Project X |
+
+See [Persona Building Guide](kernel/knowledge/persona-building.md) for details.
+
+## Structure
+
+```
+thoth/
+├── kernel/          # System config, memory, standards
+├── work/            # Professional life
+├── life/            # Personal life  
+├── coding/          # Technical projects
+└── src/             # OpenCode plugin source
+```
+
+## As an OpenCode Plugin
+
+Thoth is also an [OpenCode](https://github.com/nichochar/opencode) plugin that provides:
+
+- **Thoth Agent**: Primary orchestrator with depth-based specialization
+- **Sub-Agents**: Work Master, Life Master, Code Master, Coach, Sentinel, Diplomat, Chronicler
+- **Hooks**: Permission enforcement, trust tracking, context management
+- **Skills**: Morning boot, evening close, thought routing, meeting processing
+
+### Installation
+
+```bash
+# In your opencode config
+{
+  "plugins": ["path/to/thoth"]
+}
+```
+
+### Building
+
+```bash
+npm install
+npm run build
+```
+
+## Documentation
+
+- [**Thoth User Guide**](kernel/knowledge/thoth-user-guide.md) - Comprehensive guide to capabilities, usage, and configuration
+- [Vision](kernel/knowledge/vision.md) - Chief of Staff philosophy
+- [Persona Building](kernel/knowledge/persona-building.md) - How depth-based specialization works
+- [Plugin Architecture](kernel/knowledge/plugin-architecture.md) - Technical architecture
+
+## Philosophy
+
+Thoth operates on these principles:
+
+1. **Chief of Staff, not servant** — Warm but professional, challenges when appropriate
+2. **Context is king** — Retrieves relevant knowledge before acting
+3. **Permission-aware** — Critical actions require approval
+4. **Cross-domain synthesis** — Can connect insights across hemispheres
+5. **Continuous learning** — Persists learnings to the knowledge base
+
+## License
+
+Private repository.

package/dist/agents/archivist.d.ts

@@ -0,0 +1,2 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+export declare const archivistAgent: AgentConfig;

package/dist/agents/chronicler.d.ts

@@ -0,0 +1,2 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+export declare const chroniclerAgent: AgentConfig;

package/dist/agents/coach.d.ts

@@ -0,0 +1,2 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+export declare const coachAgent: AgentConfig;

package/dist/agents/code-master.d.ts

@@ -0,0 +1,2 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+export declare const codeMasterAgent: AgentConfig;

package/dist/agents/diplomat.d.ts

@@ -0,0 +1,2 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+export declare const diplomatAgent: AgentConfig;

package/dist/agents/index.d.ts

@@ -0,0 +1,12 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+import type { ThothPluginConfig } from "../config";
+export declare const builtinAgents: Record<string, AgentConfig>;
+export declare function createAgents(config: ThothPluginConfig): Record<string, AgentConfig>;
+export { thothAgent } from "./thoth";
+export { workMasterAgent } from "./work-master";
+export { lifeMasterAgent } from "./life-master";
+export { codeMasterAgent } from "./code-master";
+export { coachAgent } from "./coach";
+export { sentinelAgent } from "./sentinel";
+export { diplomatAgent } from "./diplomat";
+export { chroniclerAgent } from "./chronicler";

package/dist/agents/life-master.d.ts

@@ -0,0 +1,2 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+export declare const lifeMasterAgent: AgentConfig;

package/dist/agents/scribe.d.ts

@@ -0,0 +1,2 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+export declare const scribeAgent: AgentConfig;

package/dist/agents/sentinel.d.ts

@@ -0,0 +1,2 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+export declare const sentinelAgent: AgentConfig;

package/dist/agents/thoth.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Thoth Agent Configuration
+ *
+ * Thoth is Zeus's root-level life orchestrator and trusted chief of staff.
+ * Uses depth-based specialization: the prompt is built dynamically based on
+ * the current working directory when the session starts.
+ *
+ * Depth Model:
+ * - Depth 0: /thoth/           → Pure Chief of Staff
+ * - Depth 1: /thoth/work/      → Executive COS (crisp, P0-focused)
+ * - Depth 2: /thoth/work/projects/ → Project Portfolio Manager
+ * - Depth 3: /thoth/work/projects/xyz/ → Deep Expert on Project XYZ
+ */
+import type { AgentConfig } from "@opencode-ai/sdk";
+import { buildThothPrompt, detectSpecialization } from "../specialization";
+import type { Specialization } from "../specialization";
+/**
+ * Create a Thoth agent with the given specialization
+ *
+ * @param specialization - The detected specialization
+ * @param cwd - Current working directory (for resolving boot files)
+ * @param knowledgeBasePath - Path to the knowledge base root
+ */
+export declare function createThothAgent(specialization: Specialization, cwd?: string, knowledgeBasePath?: string): AgentConfig;
+/**
+ * The default Thoth agent configuration (Depth 0)
+ *
+ * This is used when no specialization is detected or as a fallback.
+ * The actual agent used in a session is created dynamically based on
+ * the detected specialization from the working directory.
+ */
+export declare const thothAgent: AgentConfig;
+/**
+ * Re-export for convenience
+ */
+export { detectSpecialization, buildThothPrompt };
+export type { Specialization };

package/dist/agents/work-master.d.ts

@@ -0,0 +1,2 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+export declare const workMasterAgent: AgentConfig;

package/dist/cli.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * Thoth CLI - Knowledge Base Initialization
+ *
+ * Usage:
+ *   npx thoth-plugin init [path]
+ *   thoth init [path]
+ */
+export {};

package/dist/cli.js

@@ -0,0 +1,220 @@
+#!/usr/bin/env node
+// @bun
+
+// src/cli.ts
+import { existsSync, mkdirSync, cpSync, writeFileSync, readdirSync } from "fs";
+import { join, dirname } from "path";
+import { homedir } from "os";
+import { fileURLToPath } from "url";
+var __filename2 = fileURLToPath(import.meta.url);
+var __dirname2 = dirname(__filename2);
+var NPM_DEFAULTS_PATH = join(__dirname2, "defaults");
+var README_TEMPLATE = `# Thoth Knowledge Base
+
+Welcome to your personal Thoth knowledge base - your AI chief of staff for life orchestration.
+
+## Structure
+
+| Hemisphere | Purpose |
+|------------|---------|
+| \`work/\` | Professional life - projects, colleagues, career |
+| \`life/\` | Personal life - health, relationships, home, finance |
+| \`coding/\` | Technical projects and development |
+| \`kernel/\` | System configuration and preferences |
+
+## Getting Started
+
+1. Start OpenCode in this directory:
+   \`\`\`bash
+   cd ${process.argv[3] || "~/thoth"}
+   opencode
+   \`\`\`
+
+2. Ask Thoth to help you onboard:
+   \`\`\`
+   Help me set up my knowledge base
+   \`\`\`
+
+3. Or run the onboarding skill:
+   \`\`\`
+   /system-init
+   \`\`\`
+
+## Available Skills
+
+Run these skills to automate common workflows:
+
+| Skill | Description |
+|-------|-------------|
+| \`/morning-boot\` | Start your day with inbox triage and calendar review |
+| \`/evening-close\` | End-of-day summary and overflow extraction |
+| \`/mail-triage\` | Process Gmail inbox systematically |
+| \`/slack-pulse\` | Scan Slack for mentions and important messages |
+| \`/thought-router\` | Quick capture and route thoughts |
+| \`/post-meeting-drill\` | Process meeting notes into action items |
+
+## Configuration
+
+Configure Thoth in \`.opencode/thoth-plugin.json\`:
+
+\`\`\`json
+{
+  "knowledge_base": "${process.argv[3] || "~/thoth"}"
+}
+\`\`\`
+
+## Learn More
+
+- Ask: "What can you help me with?"
+- Ask: "Explain how Thoth works"
+- Ask: "What skills are available?"
+`;
+function copyDefaultSkills(targetSkillDir) {
+  const sourceSkillDir = join(NPM_DEFAULTS_PATH, "skill");
+  if (!existsSync(sourceSkillDir)) {
+    console.log("  (No default skills found in package)");
+    return;
+  }
+  const skills = readdirSync(sourceSkillDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
+  for (const skill of skills) {
+    const source = join(sourceSkillDir, skill);
+    const target = join(targetSkillDir, skill);
+    cpSync(source, target, { recursive: true });
+  }
+  console.log(`  Copied ${skills.length} default skills`);
+}
+function init(targetPath) {
+  const targetDir = targetPath || join(homedir(), "thoth");
+  if (existsSync(targetDir)) {
+    console.log(`
+Error: Directory already exists: ${targetDir}`);
+    console.log("Use a different path or remove the existing directory.");
+    console.log(`
+Example:`);
+    console.log(`  npx thoth-plugin init ~/my-thoth`);
+    process.exit(1);
+  }
+  console.log(`
+Creating Thoth knowledge base at: ${targetDir}
+`);
+  const dirs = [
+    "work/projects",
+    "work/people",
+    "work/inbox",
+    "work/logs",
+    "life/inbox",
+    "life/health",
+    "life/relationships",
+    "life/finances",
+    "coding/projects",
+    "coding/references",
+    "kernel/config",
+    "kernel/templates",
+    "kernel/memory",
+    "kernel/Personas",
+    ".opencode/skill"
+  ];
+  for (const dir of dirs) {
+    mkdirSync(join(targetDir, dir), { recursive: true });
+  }
+  console.log("  Created directory structure");
+  const defaultAgentsMd = join(NPM_DEFAULTS_PATH, "AGENTS.md");
+  if (existsSync(defaultAgentsMd)) {
+    cpSync(defaultAgentsMd, join(targetDir, "AGENTS.md"));
+    console.log("  Copied root AGENTS.md");
+  }
+  copyDefaultSkills(join(targetDir, ".opencode", "skill"));
+  writeFileSync(join(targetDir, "README.md"), README_TEMPLATE);
+  console.log("  Created README.md");
+  writeFileSync(join(targetDir, "kernel", "config", "preferences.md"), `---
+type: config
+hemisphere: kernel
+created: ${new Date().toISOString().split("T")[0]}
+updated: ${new Date().toISOString().split("T")[0]}
+---
+
+# Preferences
+
+Your personal preferences for Thoth.
+
+## Communication Style
+
+- Default: balanced (not too verbose, not too terse)
+
+## Timezone
+
+- Default: auto-detect
+
+## Work Hours
+
+- Default: 9:00 - 18:00
+
+---
+
+*Edit this file to customize Thoth's behavior.*
+`);
+  console.log("  Created kernel/config/preferences.md");
+  const hemispheres = ["work", "life", "coding", "kernel"];
+  for (const hemi of hemispheres) {
+    writeFileSync(join(targetDir, hemi, "registry.md"), `---
+type: registry
+hemisphere: ${hemi}
+created: ${new Date().toISOString().split("T")[0]}
+updated: ${new Date().toISOString().split("T")[0]}
+---
+
+# ${hemi.charAt(0).toUpperCase() + hemi.slice(1)} Registry
+
+Index of all knowledge in the ${hemi} hemisphere.
+
+## Contents
+
+*This registry will be populated as you add knowledge.*
+`);
+  }
+  console.log("  Created hemisphere registries");
+  console.log(`
+\u2713 Knowledge base created!
+`);
+  console.log("Next steps:");
+  console.log(`  1. cd ${targetDir}`);
+  console.log("  2. opencode");
+  console.log(`  3. Ask: "Help me onboard"
+`);
+}
+function showHelp() {
+  console.log(`
+Thoth - Life Orchestrator for OpenCode
+
+Usage:
+  npx thoth-plugin <command> [options]
+
+Commands:
+  init [path]    Create a new knowledge base (default: ~/thoth)
+
+Examples:
+  npx thoth-plugin init              # Create at ~/thoth
+  npx thoth-plugin init ~/my-thoth   # Create at custom path
+  npx thoth-plugin init ./kb         # Create in current directory
+
+Learn more: https://github.com/davidhelmus/thoth-core
+`);
+}
+var command = process.argv[2];
+switch (command) {
+  case "init":
+    init(process.argv[3]);
+    break;
+  case "help":
+  case "--help":
+  case "-h":
+    showHelp();
+    break;
+  default:
+    showHelp();
+    if (command && command !== "help") {
+      console.log(`Unknown command: ${command}
+`);
+      process.exit(1);
+    }
+}

package/dist/config/index.d.ts

@@ -0,0 +1 @@
+export { ThothPluginConfigSchema, type ThothPluginConfig, type AgentOverride, type HooksConfig, type SkillsConfig, type IntegrationsConfig, type HookName, type SkillName, type AgentName, } from "./schema";

package/dist/config/schema.d.ts

@@ -0,0 +1,99 @@
+import { z } from "zod";
+declare const AgentOverrideSchema: z.ZodObject<{
+    model: z.ZodOptional<z.ZodString>;
+    thinking: z.ZodOptional<z.ZodBoolean>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    maxTokens: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+declare const HooksConfigSchema: z.ZodObject<{
+    "permission-enforcer": z.ZodOptional<z.ZodBoolean>;
+    "trust-level-tracker": z.ZodOptional<z.ZodBoolean>;
+    "context-aperture": z.ZodOptional<z.ZodBoolean>;
+    "temporal-awareness": z.ZodOptional<z.ZodBoolean>;
+    "knowledge-persistence": z.ZodOptional<z.ZodBoolean>;
+    "directory-agents-injector": z.ZodOptional<z.ZodBoolean>;
+    "todo-continuation": z.ZodOptional<z.ZodBoolean>;
+    "session-recovery": z.ZodOptional<z.ZodBoolean>;
+    "context-window-monitor": z.ZodOptional<z.ZodBoolean>;
+    "background-notification": z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+declare const SkillsConfigSchema: z.ZodObject<{
+    "morning-boot": z.ZodOptional<z.ZodBoolean>;
+    "evening-close": z.ZodOptional<z.ZodBoolean>;
+    "thought-router": z.ZodOptional<z.ZodBoolean>;
+    "post-meeting-drill": z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+declare const IntegrationsConfigSchema: z.ZodObject<{
+    google_workspace: z.ZodOptional<z.ZodBoolean>;
+    slack: z.ZodOptional<z.ZodBoolean>;
+    jira: z.ZodOptional<z.ZodBoolean>;
+    drive_sync: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const ThothPluginConfigSchema: z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    knowledge_base: z.ZodOptional<z.ZodString>;
+    agents: z.ZodOptional<z.ZodObject<{
+        thoth: z.ZodOptional<z.ZodObject<{
+            model: z.ZodOptional<z.ZodString>;
+            thinking: z.ZodOptional<z.ZodBoolean>;
+            temperature: z.ZodOptional<z.ZodNumber>;
+            maxTokens: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        "work-master": z.ZodOptional<z.ZodObject<{
+            model: z.ZodOptional<z.ZodString>;
+            thinking: z.ZodOptional<z.ZodBoolean>;
+            temperature: z.ZodOptional<z.ZodNumber>;
+            maxTokens: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        "life-master": z.ZodOptional<z.ZodObject<{
+            model: z.ZodOptional<z.ZodString>;
+            thinking: z.ZodOptional<z.ZodBoolean>;
+            temperature: z.ZodOptional<z.ZodNumber>;
+            maxTokens: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        "code-master": z.ZodOptional<z.ZodObject<{
+            model: z.ZodOptional<z.ZodString>;
+            thinking: z.ZodOptional<z.ZodBoolean>;
+            temperature: z.ZodOptional<z.ZodNumber>;
+            maxTokens: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strip>>;
+    hooks: z.ZodOptional<z.ZodObject<{
+        "permission-enforcer": z.ZodOptional<z.ZodBoolean>;
+        "trust-level-tracker": z.ZodOptional<z.ZodBoolean>;
+        "context-aperture": z.ZodOptional<z.ZodBoolean>;
+        "temporal-awareness": z.ZodOptional<z.ZodBoolean>;
+        "knowledge-persistence": z.ZodOptional<z.ZodBoolean>;
+        "directory-agents-injector": z.ZodOptional<z.ZodBoolean>;
+        "todo-continuation": z.ZodOptional<z.ZodBoolean>;
+        "session-recovery": z.ZodOptional<z.ZodBoolean>;
+        "context-window-monitor": z.ZodOptional<z.ZodBoolean>;
+        "background-notification": z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    skills: z.ZodOptional<z.ZodObject<{
+        "morning-boot": z.ZodOptional<z.ZodBoolean>;
+        "evening-close": z.ZodOptional<z.ZodBoolean>;
+        "thought-router": z.ZodOptional<z.ZodBoolean>;
+        "post-meeting-drill": z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    integrations: z.ZodOptional<z.ZodObject<{
+        google_workspace: z.ZodOptional<z.ZodBoolean>;
+        slack: z.ZodOptional<z.ZodBoolean>;
+        jira: z.ZodOptional<z.ZodBoolean>;
+        drive_sync: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    user: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        timezone: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export type ThothPluginConfig = z.infer<typeof ThothPluginConfigSchema>;
+export type AgentOverride = z.infer<typeof AgentOverrideSchema>;
+export type HooksConfig = z.infer<typeof HooksConfigSchema>;
+export type SkillsConfig = z.infer<typeof SkillsConfigSchema>;
+export type IntegrationsConfig = z.infer<typeof IntegrationsConfigSchema>;
+export type HookName = keyof NonNullable<ThothPluginConfig["hooks"]>;
+export type SkillName = keyof NonNullable<ThothPluginConfig["skills"]>;
+export type AgentName = "thoth" | "work-master" | "life-master" | "code-master";
+export {};

package/dist/defaults/AGENTS.md

@@ -0,0 +1,53 @@
+---
+hemisphere: null
+depth: 0
+boot_sequence: []
+---
+
+# Thoth - Life Orchestrator
+
+Welcome to Thoth, your AI chief of staff for life orchestration.
+
+## Quick Start
+
+If this is your first time using Thoth, you have two options:
+
+### Option 1: Initialize a Knowledge Base
+
+Run in your terminal:
+```bash
+npx thoth-plugin init
+```
+
+This creates a knowledge base structure at `~/thoth/` with:
+- `work/` - Professional life (projects, colleagues, career)
+- `life/` - Personal life (health, relationships, home, finance)
+- `coding/` - Technical projects and development
+- `kernel/` - System configuration and preferences
+
+### Option 2: Use Without a Knowledge Base
+
+Thoth works immediately for:
+- Running skills (`/morning-boot`, `/mail-triage`, etc.)
+- General assistance and planning
+- Ad-hoc task management
+
+## Available Skills
+
+Skills are pre-built workflows. Invoke with the skill tool:
+
+| Skill | Description |
+|-------|-------------|
+| `morning-boot` | Start your day with inbox triage and calendar review |
+| `evening-close` | End-of-day summary and overflow extraction |
+| `mail-triage` | Process Gmail inbox systematically |
+| `slack-pulse` | Scan Slack for mentions and important messages |
+| `thought-router` | Quick capture and route thoughts to the right place |
+| `post-meeting-drill` | Process meeting notes into action items |
+| `leadership-coach` | IC-to-Manager coaching for new leaders |
+
+## Learn More
+
+- Ask: "What skills are available?"
+- Ask: "Help me set up my knowledge base"
+- Ask: "Explain how Thoth works"

package/dist/defaults/skill/cal-grid/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: cal-grid
+description: Map Zeus's daily calendar grid using the Thoth standard protocol. Identifies deep work slots and critical preparation needs.
+---
+
+# Calendar Grid Skill
+
+You are the Daily Grid Architect for Zeus's Chief of Staff.
+
+## Protocol Execution
+
+1.  **Read Master Instructions**: Load the full protocol from `kernel/Agents/cal-grid.md`.
+2.  **Execute**: Follow the protocol exactly as defined in the master file.
+3.  **Synthesize**: Provide the high-resolution grid and the required raw data block.
+
+**MANDATORY**: Ensure the output includes the `## SCAN_DATA_START` and `## SCAN_DATA_END` markers as specified in the master instructions.

package/dist/defaults/skill/capsule-init/SKILL.md

@@ -0,0 +1,102 @@
+---
+name: capsule-init
+description: Upgrades a project file or folder to a focused Thoth Capsule.
+---
+
+# Capsule Init Skill
+
+Use this skill when a project grows too complex or when you want to "Deep Dive" into a specific subfolder.
+
+## Logic
+
+### 1. Target Identification
+Identify if it's a file (`Projects/foo.md`) or a folder (`coding/bar/`).
+
+### 2. Location Check
+Determine if the capsule is inside or outside the Thoth repo:
+```bash
+# Get thoth repo root (if inside)
+THOTH_ROOT=$(git -C <target_path> rev-parse --show-toplevel 2>/dev/null)
+
+# Check if this is actually the thoth repo (not some other repo)
+# by verifying kernel/ exists
+if [[ -d "$THOTH_ROOT/kernel" ]]; then
+  echo "Inside thoth repo"
+else
+  echo "Outside thoth repo (or different repo)"
+fi
+```
+
+### 3. Strategy
+Read the existing content to distill the "Strategic North Star".
+
+### 4. Scaffold
+Create the capsule structure:
+
+| File | Purpose | When to Create |
+|------|---------|----------------|
+| `AGENTS.md` | Bootloader with persona and context | Always |
+| `CONTEXT.md` | Strategic Interface | Always |
+| `opencode.json` | Instruction Pinning | Always |
+| `.opencode/oh-my-opencode.json` | Plugin config (disables Sisyphus) | **ALWAYS** (symlink if inside, copy if outside) |
+
+### 5. Migration
+Move the original project file to `README.md` within the new capsule.
+
+## Templates
+
+Use templates in `kernel/templates/`:
+- `AGENTS.template.md` — Bootloader structure
+- `CONTEXT.template.md` — Strategic interface
+- `oh-my-opencode.template.json` — Plugin config for external capsules
+
+## Plugin Config (CRITICAL - ALWAYS REQUIRED)
+
+oh-my-opencode uses `process.cwd()` to find config, NOT git root. Every capsule needs `.opencode/oh-my-opencode.json` accessible from its directory.
+
+### Inside Thoth Repo → Create Symlink
+
+Calculate the relative path from capsule to root `.opencode/`:
+
+```bash
+# Example: capsule at coding/projects/my-app/
+# Depth = 3 levels from root
+# Symlink target = ../../../.opencode/oh-my-opencode.json
+
+# Calculate depth from root
+CAPSULE_PATH="coding/projects/my-app"  # relative to thoth root
+DEPTH=$(echo "$CAPSULE_PATH" | tr -cd '/' | wc -c)
+DEPTH=$((DEPTH + 1))  # add 1 for the directory itself
+
+# Build relative path (../ repeated DEPTH times)
+REL_PATH=$(printf '../%.0s' $(seq 1 $DEPTH))
+
+# Create symlink
+mkdir -p "$CAPSULE_PATH/.opencode"
+cd "$CAPSULE_PATH/.opencode"
+ln -s "${REL_PATH}.opencode/oh-my-opencode.json" oh-my-opencode.json
+```
+
+**Quick reference for common depths:**
+
+| Capsule Location | Depth | Symlink Target |
+|------------------|-------|----------------|
+| `kernel/` | 1 | `../../.opencode/oh-my-opencode.json` |
+| `work/projects/` | 2 | `../../../.opencode/oh-my-opencode.json` |
+| `coding/projects/my-app/` | 3 | `../../../../.opencode/oh-my-opencode.json` |
+
+### Outside Thoth Repo → Copy Template
+
+```bash
+mkdir -p <capsule>/.opencode
+cp kernel/templates/oh-my-opencode.template.json <capsule>/.opencode/oh-my-opencode.json
+```
+
+**Without this config, the capsule will use Sisyphus instead of Thoth.**
+
+## Prompt Requirements
+
+Ask the user for:
+- Strategic Objective (if not inferable)
+- Persona choice (ARCHITECT, COS, SYSTEM, etc.)
+- Target location (confirm if outside thoth repo)