11# PROJECT KNOWLEDGE BASE
22
3- ** Generated:** 2025-12-16T16:00 :00+09:00
4- ** Commit:** a2d2109
5- ** Branch:** master
3+ ** Generated:** 2025-12-22T02:23 :00+09:00
4+ ** Commit:** aad7a72
5+ ** Branch:** dev
66
77## OVERVIEW
88
@@ -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 (OmO , oracle, librarian, explore, frontend, document-writer, multimodal-looker)
16+ │ ├── agents/ # AI agents (Sisyphus , oracle, librarian, explore, frontend, document-writer, multimodal-looker)
1717│ ├── hooks/ # 21 lifecycle hooks (comment-checker, rules-injector, keyword-detector, etc.)
1818│ ├── tools/ # LSP (11), AST-Grep, Grep, Glob, background-task, look-at, skill, slashcommand, interactive-bash, call-omo-agent
1919│ ├── mcp/ # MCP servers (context7, websearch_exa, grep_app)
20- │ ├── features/ # Terminal, Background agent, Claude Code loaders (agent, command, skill, mcp, session-state), hook-message-injector
20+ │ ├── features/ # Background agent, Claude Code loaders (agent, command, skill, mcp, session-state), hook-message-injector
2121│ ├── config/ # Zod schema, TypeScript types
2222│ ├── auth/ # Google Antigravity OAuth
2323│ ├── shared/ # Utilities (deep-merge, pattern-matcher, logger, etc.)
2424│ └── index.ts # Main plugin entry (OhMyOpenCodePlugin)
25- ├── script/ # build-schema.ts, publish.ts
25+ ├── script/ # build-schema.ts, publish.ts, generate-changelog.ts
2626├── assets/ # JSON schema
2727└── dist/ # Build output (ESM + .d.ts)
2828```
@@ -52,6 +52,7 @@ oh-my-opencode/
5252- ** Directory naming** : kebab-case (` ast-grep/ ` , ` claude-code-hooks/ ` )
5353- ** Tool structure** : Each tool has index.ts, types.ts, constants.ts, tools.ts, utils.ts
5454- ** Hook pattern** : ` createXXXHook(input: PluginInput) ` returning event handlers
55+ - ** Test style** : BDD comments ` #given ` , ` #when ` , ` #then ` (same as AAA pattern)
5556
5657## ANTI-PATTERNS (THIS PROJECT)
5758
@@ -63,6 +64,7 @@ oh-my-opencode/
6364- ** Local version bump** : Version managed by CI workflow, never modify locally
6465- ** Rush completion** : Never mark tasks complete without verification
6566- ** Interrupting work** : Complete tasks fully before stopping
67+ - ** Over-exploration** : Stop searching when sufficient context found
6668
6769## UNIQUE STYLES
6870
@@ -73,12 +75,13 @@ oh-my-opencode/
7375- ** Agent tools restriction** : Use ` tools: { include: [...] } ` or ` tools: { exclude: [...] } `
7476- ** Temperature** : Most agents use ` 0.1 ` for consistency
7577- ** Hook naming** : ` createXXXHook ` function naming convention
78+ - ** Date references** : NEVER use 2024 in code/prompts (use current year)
7679
7780## AGENT MODELS
7881
7982| Agent | Model | Purpose |
8083| -------| -------| ---------|
81- | OmO | anthropic/claude-opus-4-5 | Primary orchestrator, team leader |
84+ | Sisyphus | anthropic/claude-opus-4-5 | Primary orchestrator, team leader |
8285| oracle | openai/gpt-5.2 | Strategic advisor, code review, architecture |
8386| librarian | anthropic/claude-sonnet-4-5 | Multi-repo analysis, docs lookup, GitHub examples |
8487| explore | opencode/grok-code | Fast codebase exploration, file patterns |
@@ -100,6 +103,9 @@ bun run rebuild
100103
101104# Build schema only
102105bun run build:schema
106+
107+ # Run tests
108+ bun test
103109```
104110
105111## DEPLOYMENT
@@ -124,11 +130,18 @@ gh run list --workflow=publish
124130- Never run ` bun publish ` directly (OIDC provenance issue)
125131- Never bump version locally
126132
133+ ## CI PIPELINE
134+
135+ - ** ci.yml** : Parallel test/typecheck jobs, build verification, auto-commit schema changes on master
136+ - ** publish.yml** : Manual workflow_dispatch, version bump, changelog generation, OIDC npm publishing
137+ - Schema auto-commit prevents build drift
138+ - Draft release creation on dev branch
139+
127140## NOTES
128141
129- - ** No tests ** : Test framework not configured
142+ - ** Testing ** : Bun native test framework ( ` bun test ` ), BDD-style with ` #given/#when/#then ` comments
130143- ** OpenCode version** : Requires >= 1.0.150 (earlier versions have config bugs)
131- - ** Multi-language docs** : README.md (EN), README.ko.md (KO), README.ja.md (JA)
144+ - ** Multi-language docs** : README.md (EN), README.ko.md (KO), README.ja.md (JA), README.zh-cn.md (ZH-CN)
132145- ** Config locations** : ` ~/.config/opencode/oh-my-opencode.json ` (user) or ` .opencode/oh-my-opencode.json ` (project)
133146- ** Schema autocomplete** : Add ` $schema ` field in config for IDE support
134147- ** Trusted dependencies** : @ast-grep/cli , @ast-grep/napi , @code-yeongyu/comment-checker
0 commit comments