elias/oh-my-opencode
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(orchestrator): emphasize oracle as read-only consultation agent

Browse Source 
- 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
This commit is contained in:
YeonGyu-Kim 2026-01-06 13:29:56 +09:00
parent 56bc1697d2
commit 9152c5c687
2 changed files with 6 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
src/agents/orchestrator-sisyphus.ts
View File

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

4
src/agents/sisyphus-prompt-builder.ts
View File

@ -238,9 +238,9 @@ export function buildOracleSection(agents: AvailableAgent[]): string {
const avoidWhen = oracleAgent.metadata.avoidWhen || []
return `<Oracle_Usage>
## 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: