Integrate oh-my-arcanea plugin harness (11 agents, 44 hooks, 26 tools)

[frankxai]

Context

oh-my-arcanea (v4.0.0) is a standalone plugin harness that extends OpenCode with Guardian-routed multi-agent orchestration. It needs to be integrated into arcanea-code as a first-party feature rather than a third-party plugin.

Agents to Port

1. Sisyphus — Persistent task worker (retry logic, background execution)
2. Hephaestus — Code forge (generation, refactoring, transformation)
3. Oracle — Research and knowledge retrieval
4. Librarian — Context management and file organization
5. Explore — Codebase exploration and navigation
6. Atlas — Architecture analysis and mapping
7. Prometheus — Innovation and creative problem solving
8. Metis — Strategic planning and task decomposition
9. Momus — Code review and quality critique
10. Multimodal-Looker — Visual analysis (screenshots, diagrams)
11. Sisyphus-Junior — Lightweight task runner

Integration Plan

• Define PluginInterface TypeScript interfaces (8 interfaces)
• Port agent definitions to packages/opencode/src/agents/
• Port 44 hooks to arcanea-code hook system
• Port 26 tools to arcanea-code tool registry
• Port 3 built-in MCP servers (websearch, context7, grep_app)
• Port skill system (BuiltinSkill interface)
• Wire Guardian routing into agent dispatch
• Verify all 8 OpenCode hook handlers work

[frankxai]

Progress Update (2026-03-22 overnight build)

Completed

• 11 production agents ported as markdown definitions in .arcanea/agent/
• Sisyphus, Hephaestus, Oracle, Prometheus, Metis, Momus, Librarian, Explore, Atlas, Multimodal-Looker, Sisyphus-Junior
• Total: 25 agent files (10 Guardians + 11 Workers + 4 utility)

Remaining

• Port 44 hooks to arcanea-code hook system (needs TypeScript integration)
• Port 26 tools to arcanea-code tool registry
• Port 3 built-in MCP servers
• Wire Guardian routing into agent dispatch (TypeScript)
• Plugin interface definitions

These require deeper TypeScript integration with the Effect.ts service layer.

[frankxai]

Integration architecture doc created. 2 high-value skills ported (error-recovery, context-management). Agents already ported. TypeScript hooks/tools remain for Phase 2-3.