From 9152c5c6877b1e3069c07c7b3183bb12cad062a4 Mon Sep 17 00:00:00 2001 From: YeonGyu-Kim Date: Tue, 6 Jan 2026 13:29:56 +0900 Subject: [PATCH] docs(orchestrator): emphasize oracle as read-only consultation agent - Updated orchestrator-sisyphus agent descriptions - Updated sisyphus-prompt-builder to highlight oracle's read-only consultation role - Clarified that oracle provides high-IQ reasoning without write operations --- src/agents/orchestrator-sisyphus.ts | 8 ++++---- src/agents/sisyphus-prompt-builder.ts | 4 ++-- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/src/agents/orchestrator-sisyphus.ts b/src/agents/orchestrator-sisyphus.ts index 0f83bdb2..12b389f4 100644 --- a/src/agents/orchestrator-sisyphus.ts +++ b/src/agents/orchestrator-sisyphus.ts @@ -24,7 +24,7 @@ function buildAgentSelectionSection(agents: AvailableAgent[]): string { | Agent | Best For | |-------|----------| -| \`oracle\` | Architecture decisions, code review, debugging | +| \`oracle\` | Read-only consultation. High-IQ debugging, architecture design | | \`explore\` | Codebase exploration, pattern finding | | \`librarian\` | External docs, GitHub examples, OSS reference | | \`frontend-ui-ux-engineer\` | Visual design, UI implementation | @@ -242,7 +242,7 @@ IMPORTANT: If codebase appears undisciplined, verify before assuming: | \`grep\`, \`glob\`, \`lsp_*\`, \`ast_grep\` | FREE | Not Complex, Scope Clear, No Implicit Assumptions | | \`explore\` agent | FREE | Multiple search angles, unfamiliar modules, cross-layer patterns | | \`librarian\` agent | CHEAP | External docs, GitHub examples, OpenSource Implementations, OSS reference | -| \`oracle\` agent | EXPENSIVE | Architecture, review, debugging after 2+ failures | +| \`oracle\` agent | EXPENSIVE | Read-only consultation. High-IQ debugging, architecture (2+ failures) | **Default flow**: explore/librarian (background) + tools → oracle (if required) @@ -380,8 +380,8 @@ style, className, tailwind, color, background, border, shadow, margin, padding, | Frontend UI/UX | \`frontend-ui-ux-engineer\` | Visual changes only (styling, layout, animation). Pure logic changes in frontend files → handle directly | | Librarian | \`librarian\` | Unfamiliar packages / libraries, struggles at weird behaviour (to find existing implementation of opensource) | | Documentation | \`document-writer\` | README, API docs, guides | -| Architecture decisions | \`oracle\` | Multi-system tradeoffs, unfamiliar patterns | -| Hard debugging | \`oracle\` | After 2+ failed fix attempts | +| Architecture decisions | \`oracle\` | Read-only consultation. Multi-system tradeoffs, unfamiliar patterns | +| Hard debugging | \`oracle\` | Read-only consultation. After 2+ failed fix attempts | ### Delegation Prompt Structure (MANDATORY - ALL 7 sections): diff --git a/src/agents/sisyphus-prompt-builder.ts b/src/agents/sisyphus-prompt-builder.ts index 1a57297c..a626c25f 100644 --- a/src/agents/sisyphus-prompt-builder.ts +++ b/src/agents/sisyphus-prompt-builder.ts @@ -238,9 +238,9 @@ export function buildOracleSection(agents: AvailableAgent[]): string { const avoidWhen = oracleAgent.metadata.avoidWhen || [] return ` -## Oracle — Your Senior Engineering Advisor +## Oracle — Read-Only High-IQ Consultant -Oracle is an expensive, high-quality reasoning model. Use it wisely. +Oracle is a read-only, expensive, high-quality reasoning model for debugging and architecture. Consultation only. ### WHEN to Consult: