docs: regenerate all AGENTS.md files from comprehensive codebase exploration

- Fired 33 parallel explore agents across all major directories
- Analyzed 1164 TS files, 133k LOC, 41 hooks, 26 tools, 11 agents, 18 features
- Regenerated 13 AGENTS.md files with 905 total lines
- Root: plugin architecture, initialization flow, 7 OpenCode hook handlers
- src/: entry point orchestration, hook composition pipeline
- agents/: 11 agent inventory with tool restrictions and factory patterns
- hooks/: 41 hooks organized by 5 tiers, key complex hooks documented
- tools/: 26 tools across 14 directories, delegation categories
- features/: 18 modules mapped by complexity (HIGH/MEDIUM/LOW)
- shared/: 101 utilities in 13 categories, model resolution pipeline
- config/: 22 schema files, Zod v4 validation system
- cli/: 5 commands, doctor checks, model fallback system
- mcp/: 3-tier MCP system architecture
- plugin-handlers/: 6-phase config loading pipeline
- claude-code-hooks/: CC settings.json compatibility layer
- claude-tasks/: task schema + file-based persistence

🤖 Generated with assistance of oh-my-opencode

src/plugin-handlers/AGENTS.md

@@ -1,65 +1,58 @@
-# PLUGIN-HANDLERS KNOWLEDGE BASE
+# src/plugin-handlers/ — 6-Phase Config Loading Pipeline
+
+**Generated:** 2026-02-17
 
 ## OVERVIEW
 
-Configuration orchestration layer. Runs once at plugin init — transforms raw OpenCode config into resolved agent/tool/permission structures via 6-phase sequential loading.
+13 non-test files implementing the `ConfigHandler` — the `config` hook handler. Executes 6 sequential phases to register agents, tools, MCPs, and commands with OpenCode.
 
-## STRUCTURE
-```
-plugin-handlers/
-├── config-handler.ts                  # Main orchestrator (45 lines) — 6-phase loading
-├── agent-config-handler.ts            # Agent loading pipeline (197 lines)
-├── plan-model-inheritance.ts          # Plan demotion logic (28 lines)
-├── prometheus-agent-config-builder.ts # Prometheus config builder (99 lines)
-├── plugin-components-loader.ts        # Claude Code plugin discovery (71 lines, 10s timeout)
-├── provider-config-handler.ts         # Provider config + model context limits cache
-├── tool-config-handler.ts             # Permission migration (101 lines)
-├── mcp-config-handler.ts              # Builtin + CC + plugin MCP merge
-├── command-config-handler.ts          # Command/skill parallel discovery
-├── category-config-resolver.ts        # Category lookup
-├── agent-priority-order.ts            # Agent ordering (sisyphus, hephaestus, prometheus, atlas first)
-├── plan-model-inheritance.test.ts     # 3696 lines of tests
-├── config-handler.test.ts             # 1061 lines of tests
-└── index.ts                           # Barrel exports
-```
+## 6-PHASE PIPELINE
 
-## CONFIG LOADING FLOW (6 phases, sequential)
+| Phase | Handler | Purpose |
+|-------|---------|---------|
+| 1 | `applyProviderConfig` | Cache model context limits, detect anthropic-beta headers |
+| 2 | `loadPluginComponents` | Discover Claude Code plugins (10s timeout, error isolation) |
+| 3 | `applyAgentConfig` | Load agents from 5 sources, skill discovery, plan demotion |
+| 4 | `applyToolConfig` | Agent-specific tool permissions |
+| 5 | `applyMcpConfig` | Merge builtin + CC + plugin MCPs |
+| 6 | `applyCommandConfig` | Merge commands/skills from 9 parallel sources |
 
-1. `applyProviderConfig` → Cache model context limits, detect anthropic-beta headers
-2. `loadPluginComponents` → Discover Claude Code plugins (10s timeout, error isolation)
-3. `applyAgentConfig` → Load all agents, sisyphus/prometheus/plan demotion
-4. `applyToolConfig` → Agent-specific tool permissions (grep_app, task, teammate)
-5. `applyMcpConfig` → Merge builtin + Claude Code + plugin MCPs
-6. `applyCommandConfig` → Merge builtin + user + project + opencode commands/skills
+## FILES
 
-## PLAN MODEL INHERITANCE
-
-When `sisyphus_agent.planner_enabled === true`:
-1. Prometheus config → extract model settings (model, variant, temperature, ...)
-2. Apply user `agents.plan` overrides (plan override wins)
-3. Set `mode: "subagent"` (plan becomes subagent, not primary)
-4. Strip prompt/permission/description (only model settings inherited)
-
-## AGENT LOADING ORDER
-
-1. Builtin agents (sisyphus, hephaestus, oracle, ...)
-2. Sisyphus-Junior (if sisyphus enabled)
-3. OpenCode-Builder (if `default_builder_enabled`)
-4. Prometheus (if `planner_enabled`)
-5. User agents → Project agents → Plugin agents → Custom agents
-
-**Reordered** by `reorderAgentsByPriority()`: sisyphus, hephaestus, prometheus, atlas first.
+| File | Lines | Purpose |
+|------|-------|---------|
+| `config-handler.ts` | ~200 | Main orchestrator, 6-phase sequential |
+| `plugin-components-loader.ts` | ~100 | CC plugin discovery (10s timeout) |
+| `agent-config-handler.ts` | ~300 | Agent loading + skill discovery from 5 sources |
+| `mcp-config-handler.ts` | ~150 | Builtin + CC + plugin MCP merge |
+| `command-config-handler.ts` | ~200 | 9 parallel sources for commands/skills |
+| `tool-config-handler.ts` | ~100 | Agent-specific tool grants/denials |
+| `provider-config-handler.ts` | ~80 | Provider config + model cache |
+| `prometheus-agent-config-builder.ts` | ~100 | Prometheus config with model resolution |
+| `plan-model-inheritance.ts` | 28 | Plan demotion logic |
+| `agent-priority-order.ts` | ~30 | sisyphus, hephaestus, prometheus, atlas first |
+| `agent-key-remapper.ts` | ~30 | Agent key → display name |
+| `category-config-resolver.ts` | ~40 | User vs default category lookup |
+| `index.ts` | ~10 | Barrel exports |
 
 ## TOOL PERMISSIONS
 
-| Agent | Special Permissions |
-|-------|---------------------|
-| librarian | grep_app_* allowed |
-| atlas | task, task_*, teammate allowed |
-| sisyphus | task, task_*, teammate, question allowed |
-| hephaestus | task, question allowed |
-| multimodal-looker | Denies task, look_at |
+| Agent | Granted | Denied |
+|-------|---------|--------|
+| Librarian | grep_app_* | — |
+| Atlas, Sisyphus, Prometheus | task, task_*, teammate | — |
+| Hephaestus | task | — |
+| Default (all others) | — | grep_app_*, task_*, teammate, LSP |
 
-## INTEGRATION
+## MULTI-LEVEL CONFIG MERGE
 
-Created in `create-managers.ts`, exposed as `config` hook in `plugin-interface.ts`. OpenCode calls it during session init.
+```
+User (~/.config/opencode/oh-my-opencode.jsonc)
+  ↓ deepMerge
+Project (.opencode/oh-my-opencode.jsonc)
+  ↓ Zod defaults
+Final Config
+```
+
+- `agents`, `categories`, `claude_code`: deep merged
+- `disabled_*` arrays: Set union