11# PROJECT KNOWLEDGE BASE
22
3- ** Generated:** 2026-01-09T15:38 :00+09:00
4- ** Commit:** 0581793
3+ ** Generated:** 2026-01-13T14:45 :00+09:00
4+ ** Commit:** e47b5514
55** Branch:** dev
66
77## OVERVIEW
@@ -13,16 +13,16 @@ OpenCode plugin implementing Claude Code/AmpCode features. Multi-model agent orc
1313```
1414oh-my-opencode/
1515├── src/
16- │ ├── agents/ # AI agents (7): Sisyphus, oracle, librarian, explore, frontend, document-writer, multimodal-looker
17- │ ├── hooks/ # 22 lifecycle hooks - see src/hooks/AGENTS.md
16+ │ ├── agents/ # AI agents (7+ ): Sisyphus, oracle, librarian, explore, frontend, document-writer, multimodal-looker, prometheus, metis, momus
17+ │ ├── hooks/ # 22+ lifecycle hooks - see src/hooks/AGENTS.md
1818│ ├── tools/ # LSP, AST-Grep, Grep, Glob, session mgmt - see src/tools/AGENTS.md
1919│ ├── features/ # Claude Code compat layer - see src/features/AGENTS.md
2020│ ├── auth/ # Google Antigravity OAuth - see src/auth/AGENTS.md
2121│ ├── shared/ # Cross-cutting utilities - see src/shared/AGENTS.md
2222│ ├── cli/ # CLI installer, doctor - see src/cli/AGENTS.md
23- │ ├── mcp/ # MCP configs: context7, grep_app
24- │ ├── config/ # Zod schema, TypeScript types
25- │ └── index.ts # Main plugin entry (548 lines)
23+ │ ├── mcp/ # MCP configs: context7, grep_app, websearch
24+ │ ├── config/ # Zod schema (12k lines) , TypeScript types
25+ │ └── index.ts # Main plugin entry (563 lines)
2626├── script/ # build-schema.ts, publish.ts, generate-changelog.ts
2727├── assets/ # JSON schema
2828└── dist/ # Build output (ESM + .d.ts)
@@ -50,7 +50,7 @@ oh-my-opencode/
5050| Shared utilities | ` src/shared/ ` | Cross-cutting utilities |
5151| Slash commands | ` src/hooks/auto-slash-command/ ` | Auto-detect and execute ` /command ` patterns |
5252| Ralph Loop | ` src/hooks/ralph-loop/ ` | Self-referential dev loop until completion |
53- | Orchestrator | ` src/hooks/sisyphus-orchestrator/ ` | Main orchestration hook (660 lines) |
53+ | Orchestrator | ` src/hooks/sisyphus-orchestrator/ ` | Main orchestration hook (677 lines) |
5454
5555## TDD (Test-Driven Development)
5656
@@ -83,7 +83,7 @@ oh-my-opencode/
8383- ** Build** : ` bun build ` (ESM) + ` tsc --emitDeclarationOnly `
8484- ** Exports** : Barrel pattern in index.ts; explicit named exports for tools/hooks
8585- ** Naming** : kebab-case directories, createXXXHook/createXXXTool factories
86- - ** Testing** : BDD comments ` #given/#when/#then ` , TDD workflow (RED-GREEN-REFACTOR)
86+ - ** Testing** : BDD comments ` #given/#when/#then ` , TDD workflow (RED-GREEN-REFACTOR), 82 test files
8787- ** Temperature** : 0.1 for code agents, max 0.3
8888
8989## ANTI-PATTERNS (THIS PROJECT)
@@ -122,13 +122,16 @@ oh-my-opencode/
122122
123123| Agent | Default Model | Purpose |
124124| -------| ---------------| ---------|
125- | Sisyphus | anthropic/claude-opus-4-5 | Primary orchestrator |
125+ | Sisyphus | anthropic/claude-opus-4-5 | Primary orchestrator with extended thinking |
126126| oracle | openai/gpt-5.2 | Read-only consultation. High-IQ debugging, architecture |
127127| librarian | opencode/glm-4.7-free | Multi-repo analysis, docs |
128128| explore | opencode/grok-code | Fast codebase exploration |
129129| frontend-ui-ux-engineer | google/gemini-3-pro-preview | UI generation |
130130| document-writer | google/gemini-3-pro-preview | Technical docs |
131131| multimodal-looker | google/gemini-3-flash | PDF/image analysis |
132+ | Prometheus (Planner) | anthropic/claude-opus-4-5 | Strategic planning, interview-driven |
133+ | Metis (Plan Consultant) | anthropic/claude-sonnet-4-5 | Pre-planning analysis |
134+ | Momus (Plan Reviewer) | anthropic/claude-sonnet-4-5 | Plan validation |
132135
133136## COMMANDS
134137
@@ -137,7 +140,7 @@ bun run typecheck # Type check
137140bun run build # ESM + declarations + schema
138141bun run rebuild # Clean + Build
139142bun run build:schema # Schema only
140- bun test # Run tests (76 test files, 2559+ BDD assertions)
143+ bun test # Run tests (82 test files, 2559+ BDD assertions)
141144```
142145
143146## DEPLOYMENT
@@ -160,23 +163,38 @@ bun test # Run tests (76 test files, 2559+ BDD assertions)
160163
161164| File | Lines | Description |
162165| ------| -------| -------------|
163- | ` src/agents/orchestrator-sisyphus.ts ` | 1484 | Orchestrator agent, complex delegation |
166+ | ` src/agents/orchestrator-sisyphus.ts ` | 1486 | Orchestrator agent, 7-section delegation, accumulated wisdom |
164167| ` src/features/builtin-skills/skills.ts ` | 1230 | Skill definitions (frontend-ui-ux, playwright) |
165- | ` src/agents/prometheus-prompt.ts ` | 982 | Planning agent system prompt |
166- | ` src/auth/antigravity/fetch.ts ` | 798 | Token refresh, URL rewriting |
167- | ` src/auth/antigravity/thinking.ts ` | 755 | Thinking block extraction |
168- | ` src/cli/config-manager.ts ` | 725 | JSONC parsing, env detection |
169- | ` src/hooks/sisyphus-orchestrator/index.ts ` | 660 | Orchestrator hook impl |
170- | ` src/agents/sisyphus.ts ` | 641 | Main Sisyphus prompt |
171- | ` src/tools/lsp/client.ts ` | 612 | LSP protocol, JSON-RPC |
172- | ` src/features/background-agent/manager.ts ` | 608 | Task lifecycle |
173- | ` src/auth/antigravity/response.ts ` | 599 | Response transformation, streaming |
174- | ` src/hooks/anthropic-context-window-limit-recovery/executor.ts ` | 556 | Multi-stage recovery |
175- | ` src/index.ts ` | 548 | Main plugin, all hook/tool init |
168+ | ` src/agents/prometheus-prompt.ts ` | 988 | Planning agent, interview mode, multi-agent validation |
169+ | ` src/auth/antigravity/fetch.ts ` | 798 | Token refresh, multi-account rotation, endpoint fallback |
170+ | ` src/auth/antigravity/thinking.ts ` | 755 | Thinking block extraction, signature management |
171+ | ` src/cli/config-manager.ts ` | 725 | JSONC parsing, multi-level config, env detection |
172+ | ` src/hooks/sisyphus-orchestrator/index.ts ` | 677 | Orchestrator hook impl |
173+ | ` src/agents/sisyphus.ts ` | 643 | Main Sisyphus prompt |
174+ | ` src/tools/lsp/client.ts ` | 632 | LSP protocol, JSON-RPC |
175+ | ` src/features/background-agent/manager.ts ` | 825 | Task lifecycle, concurrency |
176+ | ` src/auth/antigravity/response.ts ` | 598 | Response transformation, streaming |
177+ | ` src/tools/sisyphus-task/tools.ts ` | 583 | Category-based task delegation |
178+ | ` src/index.ts ` | 563 | Main plugin, all hook/tool init |
179+ | ` src/hooks/anthropic-context-window-limit-recovery/executor.ts ` | 555 | Multi-stage recovery |
180+
181+ ## MCP ARCHITECTURE
182+
183+ Three-tier MCP system:
184+ 1 . ** Built-in** : ` websearch ` (Exa), ` context7 ` (docs), ` grep_app ` (GitHub search)
185+ 2 . ** Claude Code compatible** : ` .mcp.json ` files with ` ${VAR} ` expansion
186+ 3 . ** Skill-embedded** : YAML frontmatter in skills (e.g., playwright)
187+
188+ ## CONFIG SYSTEM
189+
190+ - ** Zod validation** : ` src/config/schema.ts ` (12k lines)
191+ - ** JSONC support** : Comments and trailing commas
192+ - ** Multi-level** : User (` ~/.config/opencode/ ` ) → Project (` .opencode/ ` )
193+ - ** CLI doctor** : Validates config and reports errors
176194
177195## NOTES
178196
179- - ** Testing** : Bun native test (` bun test ` ), BDD-style ` #given/#when/#then ` , 76 test files
197+ - ** Testing** : Bun native test (` bun test ` ), BDD-style ` #given/#when/#then ` , 82 test files
180198- ** OpenCode** : Requires >= 1.0.150
181199- ** Multi-lang docs** : README.md (EN), README.ko.md (KO), README.ja.md (JA), README.zh-cn.md (ZH-CN)
182200- ** Config** : ` ~/.config/opencode/oh-my-opencode.json ` (user) or ` .opencode/oh-my-opencode.json ` (project)
0 commit comments