From 7b7526e2f624dad8f46224b151f3aabeac860ab8 Mon Sep 17 00:00:00 2001 From: YeonGyu-Kim Date: Sun, 5 Apr 2026 14:04:42 +0900 Subject: [PATCH] docs(src): update counts across tools, features, config, cli AGENTS.md - tools: 15 -> 16 dirs, writing model kimi-k2p5 -> gemini-3-flash - features: builtin skills 6 -> 8 (+review-work, +ai-slop-remover) - config: schema files 24 -> 27 (+git-env-prefix, model-capabilities, openclaw) - cli: commands 5 -> 6 (+refresh-model-capabilities) - plugin-handlers: 13 -> 14 non-test files - shared: 95+ -> 100+ utility files --- src/agents/AGENTS.md | 25 +++++++++++++------- src/cli/AGENTS.md | 5 ++-- src/cli/config-manager/AGENTS.md | 2 +- src/cli/run/AGENTS.md | 2 +- src/config/AGENTS.md | 11 +++++---- src/features/AGENTS.md | 19 ++++++++------- src/features/background-agent/AGENTS.md | 2 +- src/features/claude-tasks/AGENTS.md | 2 +- src/features/mcp-oauth/AGENTS.md | 2 +- src/features/opencode-skill-loader/AGENTS.md | 2 +- src/features/tmux-subagent/AGENTS.md | 2 +- src/mcp/AGENTS.md | 2 +- src/plugin-handlers/AGENTS.md | 4 ++-- src/shared/AGENTS.md | 6 ++--- src/tools/AGENTS.md | 6 ++--- src/tools/background-task/AGENTS.md | 2 +- src/tools/call-omo-agent/AGENTS.md | 2 +- src/tools/delegate-task/AGENTS.md | 2 +- src/tools/hashline-edit/AGENTS.md | 2 +- src/tools/lsp/AGENTS.md | 2 +- 20 files changed, 58 insertions(+), 44 deletions(-) diff --git a/src/agents/AGENTS.md b/src/agents/AGENTS.md index bc7873233..b8486e545 100644 --- a/src/agents/AGENTS.md +++ b/src/agents/AGENTS.md @@ -1,6 +1,6 @@ # src/agents/ — 11 Agent Definitions -**Generated:** 2026-03-06 +**Generated:** 2026-04-05 ## OVERVIEW @@ -10,16 +10,16 @@ Agent factories following `createXXXAgent(model) → AgentConfig` pattern. Each | Agent | Model | Temp | Mode | Fallback Chain | Purpose | |-------|-------|------|------|----------------|---------| -| **Sisyphus** | claude-opus-4-6 max | 0.1 | all | k2p5 → kimi-k2.5 → gpt-5.4 medium → glm-5 → big-pickle | Main orchestrator, plans + delegates | +| **Sisyphus** | claude-opus-4-6 max | 0.1 | all | k2p5 -> kimi-k2.5 -> gpt-5.4 medium -> glm-5 -> big-pickle | Main orchestrator, plans + delegates | | **Hephaestus** | gpt-5.4 medium | 0.1 | all | — | Autonomous deep worker | -| **Oracle** | gpt-5.4 high | 0.1 | subagent | gemini-3.1-pro high → claude-opus-4-6 max | Read-only consultation | -| **Librarian** | minimax-m2.7 | 0.1 | subagent | minimax-m2.7-highspeed → claude-haiku-4-5 → gpt-5-nano | External docs/code search | -| **Explore** | grok-code-fast-1 | 0.1 | subagent | minimax-m2.7-highspeed → minimax-m2.7 → claude-haiku-4-5 → gpt-5-nano | Contextual grep | -| **Multimodal-Looker** | gpt-5.3-codex medium | 0.1 | subagent | k2p5 → gemini-3-flash → glm-4.6v → gpt-5-nano | PDF/image analysis | -| **Metis** | claude-opus-4-6 max | **0.3** | subagent | gpt-5.4 high → gemini-3.1-pro high | Pre-planning consultant | -| **Momus** | gpt-5.4 xhigh | 0.1 | subagent | claude-opus-4-6 max → gemini-3.1-pro high | Plan reviewer | +| **Oracle** | gpt-5.4 high | 0.1 | subagent | gemini-3.1-pro high -> claude-opus-4-6 max | Read-only consultation | +| **Librarian** | minimax-m2.7 | 0.1 | subagent | minimax-m2.7-highspeed -> claude-haiku-4-5 -> gpt-5-nano | External docs/code search | +| **Explore** | grok-code-fast-1 | 0.1 | subagent | minimax-m2.7-highspeed -> minimax-m2.7 -> claude-haiku-4-5 -> gpt-5-nano | Contextual grep | +| **Multimodal-Looker** | gpt-5.3-codex medium | 0.1 | subagent | k2p5 -> gemini-3-flash -> glm-4.6v -> gpt-5-nano | PDF/image analysis | +| **Metis** | claude-opus-4-6 max | **0.3** | subagent | gpt-5.4 high -> gemini-3.1-pro high | Pre-planning consultant | +| **Momus** | gpt-5.4 xhigh | 0.1 | subagent | claude-opus-4-6 max -> gemini-3.1-pro high | Plan reviewer | | **Atlas** | claude-sonnet-4-6 | 0.1 | primary | gpt-5.4 medium | Todo-list orchestrator | -| **Prometheus** | claude-opus-4-6 max | 0.1 | — | gpt-5.4 high → gemini-3.1-pro | Strategic planner (internal) | +| **Prometheus** | claude-opus-4-6 max | 0.1 | — | internal planner | Strategic planner (internal) | | **Sisyphus-Junior** | claude-sonnet-4-6 | 0.1 | all | user-configurable | Category-spawned executor | ## TOOL RESTRICTIONS @@ -50,6 +50,13 @@ agents/ ├── agent-builder.ts # buildAgent() composition ├── utils.ts # Agent utilities ├── builtin-agents.ts # createBuiltinAgents() registry +├── dynamic-agent-prompt-builder.ts # Dynamic prompt builder system +├── dynamic-agent-core-sections.ts # Core prompt sections +├── dynamic-agent-policy-sections.ts # Policy prompt sections +├── dynamic-agent-tool-categorization.ts # Tool categorization +├── dynamic-agent-category-skills-guide.ts # Category skills guide +├── custom-agent-summaries.ts # Custom agent summaries +├── env-context.ts # Environment context └── builtin-agents/ # maybeCreateXXXConfig conditional factories ├── sisyphus-agent.ts ├── hephaestus-agent.ts diff --git a/src/cli/AGENTS.md b/src/cli/AGENTS.md index 4ce8ddd4b..9d1f70bfb 100644 --- a/src/cli/AGENTS.md +++ b/src/cli/AGENTS.md @@ -1,10 +1,10 @@ # src/cli/ — CLI: install, run, doctor, mcp-oauth -**Generated:** 2026-03-06 +**Generated:** 2026-04-05 ## OVERVIEW -Commander.js CLI with 5 commands. Entry: `index.ts` → `runCli()` in `cli-program.ts`. +Commander.js CLI with 6 commands. Entry: `index.ts` → `runCli()` in `cli-program.ts`. ## COMMANDS @@ -15,6 +15,7 @@ Commander.js CLI with 5 commands. Entry: `index.ts` → `runCli()` in `cli-progr | `doctor` | 4-category health checks | System, Config, Tools, Models | | `get-local-version` | Version detection | Installed vs npm latest | | `mcp-oauth` | OAuth token management | login (PKCE), logout, status | +| `refresh-model-capabilities` | Refresh models.dev cache | Model capabilities refresh | ## STRUCTURE diff --git a/src/cli/config-manager/AGENTS.md b/src/cli/config-manager/AGENTS.md index 6fcd32550..0ff6c9945 100644 --- a/src/cli/config-manager/AGENTS.md +++ b/src/cli/config-manager/AGENTS.md @@ -1,6 +1,6 @@ # src/cli/config-manager/ — CLI Installation Utilities -**Generated:** 2026-03-06 +**Generated:** 2026-04-05 ## OVERVIEW diff --git a/src/cli/run/AGENTS.md b/src/cli/run/AGENTS.md index d15016d20..2a993db25 100644 --- a/src/cli/run/AGENTS.md +++ b/src/cli/run/AGENTS.md @@ -1,6 +1,6 @@ # src/cli/run/ — Non-Interactive Session Launcher -**Generated:** 2026-03-06 +**Generated:** 2026-04-05 ## OVERVIEW diff --git a/src/config/AGENTS.md b/src/config/AGENTS.md index 0b9e7e219..4a31284fc 100644 --- a/src/config/AGENTS.md +++ b/src/config/AGENTS.md @@ -1,10 +1,10 @@ # src/config/ — Zod v4 Schema System -**Generated:** 2026-03-06 +**Generated:** 2026-04-05 ## OVERVIEW -24 schema files composing `OhMyOpenCodeConfigSchema`. Zod v4 validation with `safeParse()`. All fields optional — omitted fields use plugin defaults. +27 schema files composing `OhMyOpenCodeConfigSchema`. Zod v4 validation with `safeParse()`. All fields optional — omitted fields use plugin defaults. ## SCHEMA TREE @@ -34,13 +34,16 @@ config/schema/ ├── babysitting.ts # Unstable agent monitoring ├── dynamic-context-pruning.ts # Context pruning settings ├── start-work.ts # StartWorkConfigSchema (auto_commit) +├── openclaw.ts # OpenClaw integration settings +├── git-env-prefix.ts # Git environment prefix config +├── model-capabilities.ts # Model capabilities config └── internal/permission.ts # AgentPermissionSchema ``` -## ROOT SCHEMA FIELDS (28) +## ROOT SCHEMA FIELDS (32) -`$schema`, `new_task_system_enabled`, `default_run_agent`, `disabled_mcps`, `disabled_agents`, `disabled_skills`, `disabled_hooks`, `disabled_commands`, `disabled_tools`, `hashline_edit`, `agents`, `categories`, `claude_code`, `sisyphus_agent`, `comment_checker`, `experimental`, `auto_update`, `skills`, `ralph_loop`, `background_task`, `notification`, `babysitting`, `git_master`, `browser_automation_engine`, `websearch`, `tmux`, `sisyphus`, `start_work`, `_migrations` +`$schema`, `new_task_system_enabled`, `default_run_agent`, `disabled_mcps`, `disabled_agents`, `disabled_skills`, `disabled_hooks`, `disabled_commands`, `disabled_tools`, `hashline_edit`, `agents`, `categories`, `claude_code`, `sisyphus_agent`, `comment_checker`, `experimental`, `auto_update`, `skills`, `ralph_loop`, `background_task`, `notification`, `babysitting`, `git_master`, `browser_automation_engine`, `websearch`, `tmux`, `sisyphus`, `start_work`, `_migrations`, `model_fallback`, `model_capabilities`, `openclaw`, `mcp_env_allowlist` ## AGENT OVERRIDE FIELDS (21) diff --git a/src/features/AGENTS.md b/src/features/AGENTS.md index f0f6a51e6..8a6890ec2 100644 --- a/src/features/AGENTS.md +++ b/src/features/AGENTS.md @@ -1,6 +1,6 @@ # src/features/ — 19 Feature Modules -**Generated:** 2026-03-06 +**Generated:** 2026-04-05 ## OVERVIEW @@ -11,11 +11,11 @@ Standalone feature modules wired into plugin/ layer. Each is self-contained with | Module | Files | Complexity | Purpose | |--------|-------|------------|---------| | **opencode-skill-loader** | 33 | HIGH | YAML frontmatter skill loading from 4 scopes | -| **background-agent** | 31 | HIGH | Task lifecycle, concurrency (5/model), polling, spawner pattern | -| **tmux-subagent** | 30 | HIGH | Tmux pane management, grid planning, session orchestration | +| **background-agent** | 47 | HIGH | Task lifecycle, concurrency (5/model), polling, spawner pattern, circuit breaker | +| **tmux-subagent** | 34 | HIGH | Tmux pane management, grid planning, session orchestration | | **mcp-oauth** | 18 | HIGH | OAuth 2.0 + PKCE + DCR (RFC 7591) for MCP servers | -| **builtin-skills** | 17 | LOW | 6 skills: git-master, playwright, playwright-cli, agent-browser, dev-browser, frontend-ui-ux | -| **skill-mcp-manager** | 12 | MEDIUM | MCP client lifecycle per session (stdio + HTTP) | +| **builtin-skills** | 17 | LOW | 8 skills: git-master, playwright, playwright-cli, agent-browser, dev-browser, frontend-ui-ux, review-work, ai-slop-remover | +| **skill-mcp-manager** | 14 | MEDIUM | MCP client lifecycle per session (stdio + HTTP) | | **claude-code-plugin-loader** | 10 | MEDIUM | Unified plugin discovery from .opencode/plugins/ | | **builtin-commands** | 11 | LOW | Command templates: refactor, init-deep, handoff, etc. | | **claude-tasks** | 7 | MEDIUM | Task schema + file storage + OpenCode todo sync | @@ -32,12 +32,13 @@ Standalone feature modules wired into plugin/ layer. Each is self-contained with ## KEY MODULES -### background-agent (31 files, ~10k LOC) +### background-agent (47 files, ~10k LOC) Core orchestration engine. `BackgroundManager` manages task lifecycle: - States: pending → running → completed/error/cancelled/interrupt - Concurrency: per-model/provider limits via `ConcurrencyManager` (FIFO queue) - Polling: 3s interval, completion via idle events + stability detection (10s unchanged) +- Circuit breaker: automatic failure detection and recovery - spawner/: 8 focused files composing via `SpawnerContext` interface ### opencode-skill-loader (33 files, ~3.2k LOC) @@ -48,7 +49,7 @@ Core orchestration engine. `BackgroundManager` manages task lifecycle: - Template resolution with variable substitution - Provider gating for model-specific skills -### tmux-subagent (30 files, ~3.6k LOC) +### tmux-subagent (34 files, ~3.6k LOC) State-first tmux integration: - `TmuxSessionManager`: pane lifecycle, grid planning @@ -56,7 +57,7 @@ State-first tmux integration: - Polling manager for session health - Event handlers for pane creation/destruction -### builtin-skills (6 skill objects) +### builtin-skills (8 skill objects) | Skill | Size | MCP | Tools | |-------|------|-----|-------| @@ -66,5 +67,7 @@ State-first tmux integration: | playwright-cli | 268 LOC | — | Bash(playwright-cli:*) | | dev-browser | 221 LOC | — | Bash | | frontend-ui-ux | 79 LOC | — | — | +| review-work | ~LOC | --- | --- | +| ai-slop-remover | ~LOC | --- | --- | Browser variant selected by `browserProvider` config: playwright (default) | playwright-cli | agent-browser. diff --git a/src/features/background-agent/AGENTS.md b/src/features/background-agent/AGENTS.md index 0f0fd7807..c62ab528d 100644 --- a/src/features/background-agent/AGENTS.md +++ b/src/features/background-agent/AGENTS.md @@ -1,6 +1,6 @@ # src/features/background-agent/ — Core Orchestration Engine -**Generated:** 2026-03-06 +**Generated:** 2026-04-05 ## OVERVIEW diff --git a/src/features/claude-tasks/AGENTS.md b/src/features/claude-tasks/AGENTS.md index 4586cf230..cf01491c2 100644 --- a/src/features/claude-tasks/AGENTS.md +++ b/src/features/claude-tasks/AGENTS.md @@ -1,6 +1,6 @@ # src/features/claude-tasks/ — Task Schema + Storage -**Generated:** 2026-03-06 +**Generated:** 2026-04-05 ## OVERVIEW diff --git a/src/features/mcp-oauth/AGENTS.md b/src/features/mcp-oauth/AGENTS.md index 1d243e0a5..79a1b8ba7 100644 --- a/src/features/mcp-oauth/AGENTS.md +++ b/src/features/mcp-oauth/AGENTS.md @@ -1,6 +1,6 @@ # src/features/mcp-oauth/ — OAuth 2.0 + PKCE + DCR for MCP Servers -**Generated:** 2026-03-06 +**Generated:** 2026-04-05 ## OVERVIEW diff --git a/src/features/opencode-skill-loader/AGENTS.md b/src/features/opencode-skill-loader/AGENTS.md index 4da44ed19..96cf36991 100644 --- a/src/features/opencode-skill-loader/AGENTS.md +++ b/src/features/opencode-skill-loader/AGENTS.md @@ -1,6 +1,6 @@ # src/features/opencode-skill-loader/ — 4-Scope Skill Discovery -**Generated:** 2026-03-06 +**Generated:** 2026-04-05 ## OVERVIEW diff --git a/src/features/tmux-subagent/AGENTS.md b/src/features/tmux-subagent/AGENTS.md index 9aa2be484..87293c960 100644 --- a/src/features/tmux-subagent/AGENTS.md +++ b/src/features/tmux-subagent/AGENTS.md @@ -1,6 +1,6 @@ # src/features/tmux-subagent/ — Tmux Pane Management -**Generated:** 2026-03-06 +**Generated:** 2026-04-05 ## OVERVIEW diff --git a/src/mcp/AGENTS.md b/src/mcp/AGENTS.md index acfe9d8ff..656fb2d67 100644 --- a/src/mcp/AGENTS.md +++ b/src/mcp/AGENTS.md @@ -1,6 +1,6 @@ # src/mcp/ — 3 Built-in Remote MCPs -**Generated:** 2026-03-06 +**Generated:** 2026-04-05 ## OVERVIEW diff --git a/src/plugin-handlers/AGENTS.md b/src/plugin-handlers/AGENTS.md index 77fcb9a27..8885c0dc3 100644 --- a/src/plugin-handlers/AGENTS.md +++ b/src/plugin-handlers/AGENTS.md @@ -1,10 +1,10 @@ # src/plugin-handlers/ — 6-Phase Config Loading Pipeline -**Generated:** 2026-03-06 +**Generated:** 2026-04-05 ## OVERVIEW -13 non-test files implementing the `ConfigHandler` — the `config` hook handler. Executes 6 sequential phases to register agents, tools, MCPs, and commands with OpenCode. +14 non-test files implementing the `ConfigHandler` — the `config` hook handler. Executes 6 sequential phases to register agents, tools, MCPs, and commands with OpenCode. ## 6-PHASE PIPELINE diff --git a/src/shared/AGENTS.md b/src/shared/AGENTS.md index eb8978f0f..1d1c53f4b 100644 --- a/src/shared/AGENTS.md +++ b/src/shared/AGENTS.md @@ -1,6 +1,6 @@ -# src/shared/ — 95+ Utility Files in 13 Categories +# src/shared/ — 100+ Utility Files -**Generated:** 2026-03-06 +**Generated:** 2026-04-05 ## OVERVIEW @@ -10,7 +10,7 @@ Cross-cutting utilities used throughout the plugin. Barrel-exported from `index. | Category | Files | Key Exports | |----------|-------|-------------| -| **Model Resolution** | 17 | `resolveModel()`, `checkModelAvailability()`, `AGENT_MODEL_REQUIREMENTS` | +| **Model Resolution** | ~22 | `resolveModel()`, `checkModelAvailability()`, `AGENT_MODEL_REQUIREMENTS` | | **Tmux Integration** | 11 | `createTmuxSession()`, `spawnPane()`, `closePane()`, server health | | **Configuration & Paths** | 10 | `resolveOpenCodeConfigDir()`, `getDataPath()`, `parseJSONC()` | | **Session Management** | 8 | `SessionCursor`, `trackInjectedPath()`, `SessionToolsStore` | diff --git a/src/tools/AGENTS.md b/src/tools/AGENTS.md index c55c5a5be..a6f84027e 100644 --- a/src/tools/AGENTS.md +++ b/src/tools/AGENTS.md @@ -1,6 +1,6 @@ -# src/tools/ - 26 Tools Across 15 Directories +# src/tools/ - 26 Tools Across 16 Directories -**Generated:** 2026-03-06 +**Generated:** 2026-04-05 ## OVERVIEW @@ -98,7 +98,7 @@ | quick | gpt-5.4-mini | Trivial tasks | | unspecified-low | claude-sonnet-4-6 | Moderate effort | | unspecified-high | claude-opus-4-6 max | High effort | -| writing | kimi-k2p5 | Documentation | +| writing | gemini-3-flash | Documentation | ## HOW TO ADD A TOOL diff --git a/src/tools/background-task/AGENTS.md b/src/tools/background-task/AGENTS.md index 1c478b4b4..10c1c5064 100644 --- a/src/tools/background-task/AGENTS.md +++ b/src/tools/background-task/AGENTS.md @@ -1,6 +1,6 @@ # src/tools/background-task/ — Background Task Tool Wrappers -**Generated:** 2026-03-06 +**Generated:** 2026-04-05 ## OVERVIEW diff --git a/src/tools/call-omo-agent/AGENTS.md b/src/tools/call-omo-agent/AGENTS.md index 8a8d4ba96..9041dc819 100644 --- a/src/tools/call-omo-agent/AGENTS.md +++ b/src/tools/call-omo-agent/AGENTS.md @@ -1,6 +1,6 @@ # src/tools/call-omo-agent/ — Direct Agent Invocation Tool -**Generated:** 2026-03-06 +**Generated:** 2026-04-05 ## OVERVIEW diff --git a/src/tools/delegate-task/AGENTS.md b/src/tools/delegate-task/AGENTS.md index 5dbbb0aac..0e545d30c 100644 --- a/src/tools/delegate-task/AGENTS.md +++ b/src/tools/delegate-task/AGENTS.md @@ -1,6 +1,6 @@ # src/tools/delegate-task/ — Task Delegation Engine -**Generated:** 2026-03-06 +**Generated:** 2026-04-05 ## OVERVIEW diff --git a/src/tools/hashline-edit/AGENTS.md b/src/tools/hashline-edit/AGENTS.md index b640ac460..d1b6515b2 100644 --- a/src/tools/hashline-edit/AGENTS.md +++ b/src/tools/hashline-edit/AGENTS.md @@ -1,6 +1,6 @@ # src/tools/hashline-edit/ — Hash-Anchored File Edit Tool -**Generated:** 2026-03-06 +**Generated:** 2026-04-05 ## OVERVIEW diff --git a/src/tools/lsp/AGENTS.md b/src/tools/lsp/AGENTS.md index 7649996fa..db29111a7 100644 --- a/src/tools/lsp/AGENTS.md +++ b/src/tools/lsp/AGENTS.md @@ -1,6 +1,6 @@ # src/tools/lsp/ — LSP Tool Implementations -**Generated:** 2026-03-06 +**Generated:** 2026-04-05 ## OVERVIEW