f1887327ee
- Delete document-writer.ts agent file - Remove from types, schema, utils, index exports - Remove tool restrictions entry - Remove migration mappings - Update atlas.ts to use category="writing" instead of agent="document-writer" - Update init-deep command template - Update all documentation (AGENTS.md, README.*, docs/) - Regenerate schema.json document-writer functionality is now handled via delegate_task with category="writing" which uses the writing category's model config.
2.8 KiB
2.8 KiB
AGENTS KNOWLEDGE BASE
OVERVIEW
8 AI agents for multi-model orchestration. Sisyphus (primary), oracle, librarian, explore, multimodal-looker, Prometheus, Metis, Momus.
STRUCTURE
agents/
├── atlas.ts # Orchestrator (1531 lines) - 7-phase delegation
├── sisyphus.ts # Main prompt (640 lines)
├── sisyphus-junior.ts # Delegated task executor
├── dynamic-agent-prompt-builder.ts # Dynamic prompt generation
├── oracle.ts # Strategic advisor (GPT-5.2)
├── librarian.ts # Multi-repo research (GLM-4.7-free)
├── explore.ts # Fast grep (Grok Code)
├── multimodal-looker.ts # Media analyzer (Gemini 3 Flash)
├── prometheus-prompt.ts # Planning (1196 lines) - interview mode
├── metis.ts # Plan consultant - pre-planning analysis
├── momus.ts # Plan reviewer - validation
├── types.ts # AgentModelConfig interface
├── utils.ts # createBuiltinAgents(), getAgentName()
└── index.ts # builtinAgents export
AGENT MODELS
| Agent | Model | Temperature | Purpose |
|---|---|---|---|
| Sisyphus | anthropic/claude-opus-4-5 | 0.1 | Primary orchestrator, todo-driven |
| oracle | openai/gpt-5.2 | 0.1 | Read-only consultation, debugging |
| librarian | opencode/glm-4.7-free | 0.1 | Docs, GitHub search, OSS examples |
| explore | opencode/grok-code | 0.1 | Fast contextual grep |
| multimodal-looker | google/gemini-3-flash | 0.1 | PDF/image analysis |
| Prometheus | anthropic/claude-opus-4-5 | 0.1 | Strategic planning, interview mode |
| Metis | anthropic/claude-sonnet-4-5 | 0.1 | Pre-planning gap analysis |
| Momus | anthropic/claude-sonnet-4-5 | 0.1 | Plan validation |
HOW TO ADD
- Create
src/agents/my-agent.tsexportingAgentConfig - Add to
builtinAgentsinsrc/agents/index.ts - Update
AgentNameSchemainsrc/config/schema.ts - Register in
src/index.tsinitialization
TOOL RESTRICTIONS
| Agent | Denied Tools |
|---|---|
| oracle | write, edit, task, delegate_task |
| librarian | write, edit, task, delegate_task, call_omo_agent |
| explore | write, edit, task, delegate_task, call_omo_agent |
| multimodal-looker | Allowlist: read, glob, grep |
KEY PATTERNS
- Factory:
createXXXAgent(model?: string): AgentConfig - Metadata:
XXX_PROMPT_METADATA: AgentPromptMetadata - Tool restrictions:
permission: { edit: "deny", bash: "ask" } - Thinking: 32k budget tokens for Sisyphus, Oracle, Prometheus
ANTI-PATTERNS
- Trust reports: NEVER trust subagent "I'm done" - verify outputs
- High temp: Don't use >0.3 for code agents
- Sequential calls: Use
delegate_taskwithrun_in_background