From 56bc1697d2ff8469abc7e3ed8cbd05bb7abf7cfb Mon Sep 17 00:00:00 2001 From: YeonGyu-Kim Date: Tue, 6 Jan 2026 13:29:50 +0900 Subject: [PATCH] docs(agents): clarify oracle and metis agent descriptions emphasizing read-only consultation roles - Oracle: high-IQ reasoning specialist for debugging and architecture (read-only) - Metis: updated description to align with oracle's consultation-only model - Updated AGENTS.md with clarified agent responsibilities --- src/agents/AGENTS.md | 4 ++-- src/agents/metis.ts | 2 +- src/agents/oracle.ts | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/src/agents/AGENTS.md b/src/agents/AGENTS.md index 2713507a..4bfe0b69 100644 --- a/src/agents/AGENTS.md +++ b/src/agents/AGENTS.md @@ -2,7 +2,7 @@ ## OVERVIEW -AI agent definitions for multi-model orchestration. 7 specialized agents: Sisyphus (orchestrator), oracle (strategy), librarian (research), explore (grep), frontend-ui-ux-engineer, document-writer, multimodal-looker. +AI agent definitions for multi-model orchestration. 7 specialized agents: Sisyphus (orchestrator), oracle (read-only consultation), librarian (research), explore (grep), frontend-ui-ux-engineer, document-writer, multimodal-looker. ## STRUCTURE @@ -27,7 +27,7 @@ agents/ | Agent | Default Model | Fallback | Purpose | |-------|---------------|----------|---------| | Sisyphus | anthropic/claude-opus-4-5 | - | Primary orchestrator with extended thinking | -| oracle | openai/gpt-5.2 | - | Architecture, debugging, code review | +| oracle | openai/gpt-5.2 | - | Read-only consultation. High-IQ debugging, architecture | | librarian | anthropic/claude-sonnet-4-5 | google/gemini-3-flash | Docs, OSS research, GitHub examples | | explore | opencode/grok-code | google/gemini-3-flash, anthropic/claude-haiku-4-5 | Fast contextual grep | | frontend-ui-ux-engineer | google/gemini-3-pro-preview | - | UI/UX code generation | diff --git a/src/agents/metis.ts b/src/agents/metis.ts index 8c308be7..43664d5d 100644 --- a/src/agents/metis.ts +++ b/src/agents/metis.ts @@ -252,7 +252,7 @@ call_omo_agent(subagent_type="librarian", prompt="Find OSS implementations of Z. | \`ast_grep_search\` | Find structural patterns | Refactoring, Build | | \`explore\` agent | Codebase pattern discovery | Build, Research | | \`librarian\` agent | External docs, best practices | Build, Architecture, Research | -| \`oracle\` agent | Strategic decisions | Architecture | +| \`oracle\` agent | Read-only consultation. High-IQ debugging, architecture | Architecture | --- diff --git a/src/agents/oracle.ts b/src/agents/oracle.ts index e77503d5..db3814cb 100644 --- a/src/agents/oracle.ts +++ b/src/agents/oracle.ts @@ -106,7 +106,7 @@ export function createOracleAgent(model: string = DEFAULT_MODEL): AgentConfig { const base = { description: - "Expert technical advisor with deep reasoning for architecture decisions, code analysis, and engineering guidance.", + "Read-only consultation agent. High-IQ reasoning specialist for debugging hard problems and high-difficulty architecture design.", mode: "subagent" as const, model, temperature: 0.1,