11# PROJECT KNOWLEDGE BASE
22
3- ** Generated:** 2026-01-13T14:45 :00+09:00
4- ** Commit:** e47b5514
3+ ** Generated:** 2026-01-15T14:53 :00+09:00
4+ ** Commit:** 89fa9ff1
55** Branch:** dev
66
77## OVERVIEW
@@ -13,16 +13,15 @@ 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, prometheus, metis, momus
16+ │ ├── agents/ # AI agents (10 +): Sisyphus, oracle, librarian, explore, frontend, document-writer, multimodal-looker, prometheus, metis, momus
1717│ ├── 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
20- │ ├── auth/ # Google Antigravity OAuth - see src/auth/AGENTS.md
2120│ ├── shared/ # Cross-cutting utilities - see src/shared/AGENTS.md
2221│ ├── cli/ # CLI installer, doctor - see src/cli/AGENTS.md
2322│ ├── mcp/ # MCP configs: context7, grep_app, websearch
24- │ ├── config/ # Zod schema (12k lines) , TypeScript types
25- │ └── index.ts # Main plugin entry (563 lines)
23+ │ ├── config/ # Zod schema, TypeScript types
24+ │ └── index.ts # Main plugin entry (580 lines)
2625├── script/ # build-schema.ts, publish.ts, generate-changelog.ts
2726├── assets/ # JSON schema
2827└── dist/ # Build output (ESM + .d.ts)
@@ -39,7 +38,6 @@ oh-my-opencode/
3938| Add skill | ` src/features/builtin-skills/ ` | Create skill dir with SKILL.md |
4039| LSP behavior | ` src/tools/lsp/ ` | client.ts (connection), tools.ts (handlers) |
4140| AST-Grep | ` src/tools/ast-grep/ ` | napi.ts for @ast-grep/napi binding |
42- | Google OAuth | ` src/auth/antigravity/ ` | OAuth plugin for Google/Gemini models |
4341| Config schema | ` src/config/schema.ts ` | Zod schema, run ` bun run build:schema ` after changes |
4442| Claude Code compat | ` src/features/claude-code-*-loader/ ` | Command, skill, agent, mcp loaders |
4543| Background agents | ` src/features/background-agent/ ` | manager.ts for task management |
@@ -50,7 +48,7 @@ oh-my-opencode/
5048| Shared utilities | ` src/shared/ ` | Cross-cutting utilities |
5149| Slash commands | ` src/hooks/auto-slash-command/ ` | Auto-detect and execute ` /command ` patterns |
5250| Ralph Loop | ` src/hooks/ralph-loop/ ` | Self-referential dev loop until completion |
53- | Orchestrator | ` src/hooks/sisyphus-orchestrator/ ` | Main orchestration hook (677 lines) |
51+ | Orchestrator | ` src/hooks/sisyphus-orchestrator/ ` | Main orchestration hook (684 lines) |
5452
5553## TDD (Test-Driven Development)
5654
@@ -83,7 +81,7 @@ oh-my-opencode/
8381- ** Build** : ` bun build ` (ESM) + ` tsc --emitDeclarationOnly `
8482- ** Exports** : Barrel pattern in index.ts; explicit named exports for tools/hooks
8583- ** Naming** : kebab-case directories, createXXXHook/createXXXTool factories
86- - ** Testing** : BDD comments ` #given/#when/#then ` , TDD workflow (RED-GREEN-REFACTOR), 82 test files
84+ - ** Testing** : BDD comments ` #given/#when/#then ` , TDD workflow (RED-GREEN-REFACTOR), 80+ test files
8785- ** Temperature** : 0.1 for code agents, max 0.3
8886
8987## ANTI-PATTERNS (THIS PROJECT)
@@ -140,7 +138,7 @@ bun run typecheck # Type check
140138bun run build # ESM + declarations + schema
141139bun run rebuild # Clean + Build
142140bun run build:schema # Schema only
143- bun test # Run tests (82 test files, 2559 + BDD assertions)
141+ bun test # Run tests (80+ test files, 2500 + BDD assertions)
144142```
145143
146144## DEPLOYMENT
@@ -157,26 +155,23 @@ bun test # Run tests (82 test files, 2559+ BDD assertions)
157155
158156- ** ci.yml** : Parallel test/typecheck, build verification, auto-commit schema on master, rolling ` next ` draft release
159157- ** publish.yml** : Manual workflow_dispatch, version bump, changelog, OIDC npm publish
160- - ** sisyphus-agent.yml** : Agent-in-CI for automated issue handling via ` @sisyphus-dev-ai ` mentions
161158
162159## COMPLEXITY HOTSPOTS
163160
164161| File | Lines | Description |
165162| ------| -------| -------------|
166- | ` src/agents/orchestrator-sisyphus.ts ` | 1486 | Orchestrator agent, 7-section delegation, accumulated wisdom |
163+ | ` src/agents/orchestrator-sisyphus.ts ` | 1485 | Orchestrator agent, 7-section delegation, accumulated wisdom |
167164| ` src/features/builtin-skills/skills.ts ` | 1230 | Skill definitions (frontend-ui-ux, playwright) |
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 |
165+ | ` src/agents/prometheus-prompt.ts ` | 991 | Planning agent, interview mode, multi-agent validation |
166+ | ` src/features/background-agent/manager .ts ` | 928 | Task lifecycle, concurrency |
167+ | ` src/cli/config-manager .ts ` | 730 | JSONC parsing, multi-level config, env detection |
168+ | ` src/hooks/sisyphus-orchestrator/index .ts ` | 684 | Orchestrator hook impl |
169+ | ` src/tools /sisyphus-task/tools .ts ` | 667 | Category-based task delegation |
173170| ` src/agents/sisyphus.ts ` | 643 | Main Sisyphus prompt |
174171| ` 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 |
172+ | ` src/features/builtin-commands/templates/refactor.ts ` | 619 | Refactoring command template |
173+ | ` src/index.ts ` | 580 | Main plugin, all hook/tool init |
174+ | ` src/hooks/anthropic-context-window-limit-recovery/executor.ts ` | 554 | Multi-stage recovery |
180175
181176## MCP ARCHITECTURE
182177
@@ -187,14 +182,14 @@ Three-tier MCP system:
187182
188183## CONFIG SYSTEM
189184
190- - ** Zod validation** : ` src/config/schema.ts ` (12k lines)
185+ - ** Zod validation** : ` src/config/schema.ts `
191186- ** JSONC support** : Comments and trailing commas
192187- ** Multi-level** : User (` ~/.config/opencode/ ` ) → Project (` .opencode/ ` )
193188- ** CLI doctor** : Validates config and reports errors
194189
195190## NOTES
196191
197- - ** Testing** : Bun native test (` bun test ` ), BDD-style ` #given/#when/#then ` , 82 test files
192+ - ** Testing** : Bun native test (` bun test ` ), BDD-style ` #given/#when/#then ` , 80+ test files
198193- ** OpenCode** : Requires >= 1.0.150
199194- ** Multi-lang docs** : README.md (EN), README.ko.md (KO), README.ja.md (JA), README.zh-cn.md (ZH-CN)
200195- ** Config** : ` ~/.config/opencode/oh-my-opencode.json ` (user) or ` .opencode/oh-my-opencode.json ` (project)
0 commit comments