Imported from gabrielmoreira/agent-skills-mirror (mirrors/repos/code-yeongyu@oh-my-openagent/packages/omo-opencode/src/agents/atlas/AGENTS.md). Install upstream with npx skills add gabrielmoreira/agent-skills-mirror --skill atlas. Copyright stays with the author.

src/agents/atlas/ -- Todo-List Orchestrator

Generated: 2026-05-18

OVERVIEW

5 TypeScript files plus 8 markdown prompt variants in packages/prompts-core/prompts/atlas/. Atlas agent -- todo-list orchestrator that delegates via task() to complete every checkbox in a plan until fully done. Mode primary. Color #10B981.

FILES

MODEL VARIANT ROUTING

Parent agent.ts calls resolveVariant() from @oh-my-opencode/prompts-core against atlasPromptVariants:

• GPT family -> gpt.md
• Gemini family -> gemini.md
• Kimi K3 -> kimi-k3.md (checked first among Kimi)
• Kimi K2.7 -> kimi-k2-7.md
• Kimi K2.x family -> kimi.md
• GLM family -> glm.md
• Claude Opus 4.7 -> opus-4-7.md
• Default -> default.md (Claude Sonnet 5 family)

atlasPromptVariants is ordered with opus-4-7 before default so the specific Claude Opus 4.7 route wins before the generic fallback.

RUNTIME INJECTION

The markdown files keep live OpenCode sections as placeholders. agent.ts resolves them through loadPrompt() runtime injections:

• {CATEGORY_SECTION} -> buildCategorySection()
• {AGENT_SECTION} -> buildAgentSelectionSection()
• {DECISION_MATRIX} -> buildDecisionMatrix()
• {SKILLS_SECTION} -> buildSkillsSection()
• {{CATEGORY_SKILLS_DELEGATION_GUIDE}} -> buildCategorySkillsDelegationGuide()

prompt-section-builder.ts remains the resolver implementation in src/ because it depends on live category, agent, and skill state.

KEY BEHAVIORS

• Mode: primary (respects UI model selection)
• Temperature: 0.1
• Default model: claude-sonnet-5
• Denied tools: task, call_omo_agent (Atlas delegates; it does not run subagents directly)
• Checkbox enforcement in prompts
• Auto-continue: never asks user for approval between plan steps
• Parallel fan-out by default; sequential only for named blocking dependencies
• Post-delegation rule: edit plan checkbox, read plan to confirm, then dispatch next task
• Registered via createAtlasAgent in src/agents/builtin-agents/atlas-agent.ts
• Markdown prompts are imported with Bun's .md text loader so Atlas prompt content is bundled into dist/index.js.