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

@@ -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 |

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 |
 
 ---
 

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,