docs: update documentation for Prometheus and new features

Update documentation across all language versions: - Rename Planner-Sisyphus to Prometheus (Planner) - Add Metis (Plan Consultant) agent documentation - Add Categories section with usage examples - Add sisyphus_task tool documentation - Update AGENTS.md with new structure and complexity hotspots - Update src/tools/AGENTS.md with sisyphus_task category 🤖 GENERATED WITH ASSISTANCE OF [OhMyOpenCode](https://github.com/code-yeongyu/oh-my-opencode)
2026-01-05 13:52:30 +09:00
parent b9b8adc11c
commit 29ffdccbe6
5 changed files with 190 additions and 78 deletions
@@ -6,16 +6,16 @@

 ## OVERVIEW

-OpenCode plugin: multi-model agent orchestration (Claude Opus 4.5, GPT-5.2, Gemini 3, Grok), 11 LSP tools, AST-Grep, Claude Code compatibility layer. "oh-my-zsh" for OpenCode.
+OpenCode plugin implementing Claude Code/AmpCode features. Multi-model agent orchestration (GPT-5.2, Claude, Gemini, Grok), LSP tools (11), AST-Grep search, MCP integrations (context7, websearch_exa, grep_app). "oh-my-zsh" for OpenCode.

 ## STRUCTURE

 ```
 oh-my-opencode/
 ├── src/
-│   ├── agents/        # 7 AI agents - see src/agents/AGENTS.md
+│   ├── agents/        # AI agents (7): Sisyphus, oracle, librarian, explore, frontend, document-writer, multimodal-looker
 │   ├── hooks/         # 22 lifecycle hooks - see src/hooks/AGENTS.md
-│   ├── tools/         # LSP, AST-Grep, session mgmt - see src/tools/AGENTS.md
+│   ├── tools/         # LSP, AST-Grep, Grep, Glob, session mgmt - see src/tools/AGENTS.md
 │   ├── features/      # Claude Code compat layer - see src/features/AGENTS.md
 │   ├── auth/          # Google Antigravity OAuth - see src/auth/AGENTS.md
 │   ├── shared/        # Cross-cutting utilities - see src/shared/AGENTS.md
@@ -24,6 +24,7 @@ oh-my-opencode/
 │   ├── config/        # Zod schema, TypeScript types
 │   └── index.ts       # Main plugin entry (464 lines)
 ├── script/            # build-schema.ts, publish.ts, generate-changelog.ts
+├── assets/            # JSON schema
 └── dist/              # Build output (ESM + .d.ts)
 ```

@@ -31,13 +32,24 @@ oh-my-opencode/

 | Task | Location | Notes |
 |------|----------|-------|
-| Add agent | `src/agents/` | Create .ts, add to builtinAgents, update types.ts |
-| Add hook | `src/hooks/` | Dir with createXXXHook(), export from index.ts |
-| Add tool | `src/tools/` | Dir with constants/types/tools.ts, add to builtinTools |
-| Add MCP | `src/mcp/` | Create config, add to index.ts |
-| Add skill | `src/features/builtin-skills/` | Dir with SKILL.md |
-| Config schema | `src/config/schema.ts` | Run `bun run build:schema` after |
+| Add agent | `src/agents/` | Create .ts, add to builtinAgents in index.ts, update types.ts |
+| Add hook | `src/hooks/` | Create dir with createXXXHook(), export from index.ts |
+| Add tool | `src/tools/` | Dir with index/types/constants/tools.ts, add to builtinTools |
+| Add MCP | `src/mcp/` | Create config, add to index.ts and types.ts |
+| Add skill | `src/features/builtin-skills/` | Create skill dir with SKILL.md |
+| LSP behavior | `src/tools/lsp/` | client.ts (connection), tools.ts (handlers) |
+| AST-Grep | `src/tools/ast-grep/` | napi.ts for @ast-grep/napi binding |
+| Google OAuth | `src/auth/antigravity/` | OAuth plugin for Google/Gemini models |
+| Config schema | `src/config/schema.ts` | Zod schema, run `bun run build:schema` after changes |
 | Claude Code compat | `src/features/claude-code-*-loader/` | Command, skill, agent, mcp loaders |
+| Background agents | `src/features/background-agent/` | manager.ts for task management |
+| Skill MCP | `src/features/skill-mcp-manager/` | MCP servers embedded in skills |
+| Interactive terminal | `src/tools/interactive-bash/` | tmux session management |
+| CLI installer | `src/cli/install.ts` | Interactive TUI installation |
+| Doctor checks | `src/cli/doctor/checks/` | Health checks for environment |
+| Shared utilities | `src/shared/` | Cross-cutting utilities |
+| Slash commands | `src/hooks/auto-slash-command/` | Auto-detect and execute `/command` patterns |
+| Ralph Loop | `src/hooks/ralph-loop/` | Self-referential dev loop until completion |

 ## TDD (Test-Driven Development)

@@ -64,7 +76,7 @@ oh-my-opencode/

 ## CONVENTIONS

- **Bun only**: `bun run`, `bun test`, `bunx` (NEVER npm/npx)
+- **Package manager**: Bun only (`bun run`, `bun build`, `bunx`)
 - **Types**: bun-types (not @types/node)
 - **Build**: `bun build` (ESM) + `tsc --emitDeclarationOnly`
 - **Exports**: Barrel pattern in index.ts; explicit named exports for tools/hooks
@@ -72,26 +84,41 @@ oh-my-opencode/
 - **Testing**: BDD comments `#given`, `#when`, `#then` (same as AAA); TDD workflow (RED-GREEN-REFACTOR)
 - **Temperature**: 0.1 for code agents, max 0.3

-## ANTI-PATTERNS
+## ANTI-PATTERNS (THIS PROJECT)

-| Category | Forbidden |
-|----------|-----------|
-| Type Safety | `as any`, `@ts-ignore`, `@ts-expect-error` |
-| Package Manager | npm, yarn, npx |
-| File Ops | Bash mkdir/touch/rm for code file creation |
-| Publishing | Direct `bun publish`, local version bump |
-| Agent Behavior | High temp (>0.3), broad tool access, sequential agent calls |
-| Hooks | Heavy PreToolUse logic, blocking without reason |
-| Year | 2024 in code/prompts (use current year) |
+- **npm/yarn**: Use bun exclusively
+- **@types/node**: Use bun-types
+- **Bash file ops**: Never mkdir/touch/rm/cp/mv for file creation in code
+- **Direct bun publish**: GitHub Actions workflow_dispatch only (OIDC provenance)
+- **Local version bump**: Version managed by CI workflow
+- **Year 2024**: NEVER use 2024 in code/prompts (use current year)
+- **Rush completion**: Never mark tasks complete without verification
+- **Over-exploration**: Stop searching when sufficient context found
+- **High temperature**: Don't use >0.3 for code-related agents
+- **Broad tool access**: Prefer explicit `include` over unrestricted access
+- **Sequential agent calls**: Use `sisyphus_task` for parallel execution
+- **Heavy PreToolUse logic**: Slows every tool call
+- **Self-planning for complex tasks**: Spawn planning agent (Prometheus) instead
+
+## UNIQUE STYLES
+
+- **Platform**: Union type `"darwin" | "linux" | "win32" | "unsupported"`
+- **Optional props**: Extensive `?` for optional interface properties
+- **Flexible objects**: `Record<string, unknown>` for dynamic configs
+- **Error handling**: Consistent try/catch with async/await
+- **Agent tools**: `tools: { include: [...] }` or `tools: { exclude: [...] }`
+- **Temperature**: Most agents use `0.1` for consistency
+- **Hook naming**: `createXXXHook` function convention
+- **Factory pattern**: Components created via `createXXX()` functions

 ## AGENT MODELS

 | Agent | Default Model | Purpose |
 |-------|-------|---------|
 | Sisyphus | anthropic/claude-opus-4-5 | Primary orchestrator |
-| oracle | openai/gpt-5.2 | Strategy, code review |
-| librarian | anthropic/claude-sonnet-4-5 | Docs, OSS research |
-| explore | opencode/grok-code | Fast codebase grep |
+| oracle | openai/gpt-5.2 | Strategic advisor, code review |
+| librarian | anthropic/claude-sonnet-4-5 | Multi-repo analysis, docs |
+| explore | opencode/grok-code | Fast codebase exploration |
 | frontend-ui-ux-engineer | google/gemini-3-pro-preview | UI generation |
 | document-writer | google/gemini-3-pro-preview | Technical docs |
 | multimodal-looker | google/gemini-3-flash | PDF/image analysis |
@@ -102,7 +129,8 @@ oh-my-opencode/
 bun run typecheck      # Type check
 bun run build          # ESM + declarations + schema
 bun run rebuild        # Clean + Build
-bun test               # Run tests (380+)
+bun run build:schema   # Schema only
+bun test               # Run tests
 ```

 ## DEPLOYMENT
@@ -110,10 +138,16 @@ bun test               # Run tests (380+)
 **GitHub Actions workflow_dispatch only**

 1. Never modify package.json version locally
-2. Commit & push to dev
-3. Trigger: `gh workflow run publish -f bump=patch|minor|major`
+2. Commit & push changes
+3. Trigger `publish` workflow: `gh workflow run publish -f bump=patch`

-CI auto-commits schema changes on master, maintains rolling `next` draft release on dev.
+**Critical**: Never `bun publish` directly. Never bump version locally.
+
+## CI PIPELINE
+
+- **ci.yml**: Parallel test/typecheck, build verification, auto-commit schema on master, rolling `next` draft release
+- **publish.yml**: Manual workflow_dispatch, version bump, changelog, OIDC npm publish
+- **sisyphus-agent.yml**: Agent-in-CI for automated issue handling via `@sisyphus-dev-ai` mentions

 ## COMPLEXITY HOTSPOTS

@@ -123,13 +157,18 @@ CI auto-commits schema changes on master, maintains rolling `next` draft release
 | `src/cli/config-manager.ts` | 669 | JSONC parsing, env detection |
 | `src/auth/antigravity/fetch.ts` | 621 | Token refresh, URL rewriting |
 | `src/tools/lsp/client.ts` | 611 | LSP protocol, JSON-RPC |
+| `src/auth/antigravity/response.ts` | 598 | Response transformation, streaming |
+| `src/auth/antigravity/thinking.ts` | 571 | Thinking block extraction/transformation |
 | `src/hooks/anthropic-context-window-limit-recovery/executor.ts` | 564 | Multi-stage recovery |
 | `src/agents/sisyphus.ts` | 504 | Orchestrator prompt |

 ## NOTES

+- **Testing**: Bun native test (`bun test`), BDD-style `#given/#when/#then`, 360+ tests
 - **OpenCode**: Requires >= 1.0.150
- **Config**: `~/.config/opencode/oh-my-opencode.json` or `.opencode/oh-my-opencode.json`
- **JSONC**: Config files support comments and trailing commas
- **Claude Code**: Full compat layer for settings.json hooks, commands, skills, agents, MCPs
+- **Multi-lang docs**: README.md (EN), README.ko.md (KO), README.ja.md (JA), README.zh-cn.md (ZH-CN)
+- **Config**: `~/.config/opencode/oh-my-opencode.json` (user) or `.opencode/oh-my-opencode.json` (project)
+- **Trusted deps**: @ast-grep/cli, @ast-grep/napi, @code-yeongyu/comment-checker
+- **JSONC support**: Config files support comments (`// comment`, `/* block */`) and trailing commas
+- **Claude Code Compat**: Full compatibility layer for settings.json hooks, commands, skills, agents, MCPs
 - **Skill MCP**: Skills can embed MCP server configs in YAML frontmatter