Files

YeonGyu-Kim a1fe0f8517 docs(agents): regenerate all AGENTS.md files with comprehensive codebase analysis

- Regenerated root AGENTS.md with overview, structure, and complexity hotspots
- Regenerated all 7 subdirectory AGENTS.md files: hooks, tools, features, agents, cli, auth, shared
- Used 11 background explore agents for comprehensive feature and architecture analysis
- All files within size limits (root: 112 lines, subdirs: 57-68 lines)
- Includes where-to-look guide, conventions, anti-patterns, and agent model information

🤖 Generated with assistance of oh-my-opencode

2026-01-02 10:42:38 +09:00

2.2 KiB

Raw Blame History

AGENTS KNOWLEDGE BASE

OVERVIEW

7 AI agents for multi-model orchestration. Sisyphus orchestrates, specialists handle domains.

STRUCTURE

agents/
├── sisyphus.ts              # Primary orchestrator (504 lines)
├── oracle.ts                # Strategic advisor
├── librarian.ts             # Multi-repo research
├── explore.ts               # Fast codebase grep
├── frontend-ui-ux-engineer.ts  # UI generation
├── document-writer.ts       # Technical docs
├── multimodal-looker.ts     # PDF/image analysis
├── sisyphus-prompt-builder.ts  # Sisyphus prompt construction
├── build-prompt.ts          # Shared build agent prompt
├── plan-prompt.ts           # Shared plan agent prompt
├── types.ts                 # AgentModelConfig interface
├── utils.ts                 # createBuiltinAgents(), getAgentName()
└── index.ts                 # builtinAgents export

AGENT MODELS

Agent	Model	Fallback	Purpose
Sisyphus	anthropic/claude-opus-4-5	-	Orchestrator with extended thinking
oracle	openai/gpt-5.2	-	Architecture, debugging, review
librarian	anthropic/claude-sonnet-4-5	google/gemini-3-flash	Docs, GitHub research
explore	opencode/grok-code	gemini-3-flash, haiku-4-5	Contextual grep
frontend-ui-ux-engineer	google/gemini-3-pro-preview	-	Beautiful UI code
document-writer	google/gemini-3-pro-preview	-	Technical writing
multimodal-looker	google/gemini-3-flash	-	Visual analysis

HOW TO ADD

Create src/agents/my-agent.ts:

export const myAgent: AgentConfig = {
  model: "provider/model-name",
  temperature: 0.1,
  system: "...",
  tools: { include: ["tool1"] },
}

Add to builtinAgents in index.ts
Update types.ts if new config options

MODEL FALLBACK

createBuiltinAgents() handles fallback:

User config override
Installer settings (claude max20, gemini antigravity)
Default model

ANTI-PATTERNS

High temperature (>0.3) for code agents
Broad tool access (prefer explicit include)
Monolithic prompts (delegate to specialists)
Missing fallbacks for rate-limited models

2.2 KiB Raw Blame History