docs: update AGENTS guidance
This commit is contained in:
YeonGyu-Kim
@@ -0,0 +1,55 @@
|
||||
---
|
||||
name: atlas-agent
|
||||
description: Developer reference for the Atlas todo-list orchestrator agent -- model variants, prompt sections, and routing.
|
||||
---
|
||||
|
||||
# src/agents/atlas/ -- Todo-List Orchestrator
|
||||
|
||||
**Generated:** 2026-05-18
|
||||
|
||||
## OVERVIEW
|
||||
|
||||
17 files. Atlas agent -- todo-list orchestrator that delegates via `task()` to complete every checkbox in a plan until fully done. Mode `primary`. Color `#10B981`.
|
||||
|
||||
## FILES
|
||||
|
||||
| File | Purpose |
|
||||
|------|---------|
|
||||
| `agent.ts` | `createAtlasAgent()` factory, model-variant routing, `OrchestratorContext` |
|
||||
| `index.ts` | Barrel exports |
|
||||
| `default.ts` | Default/Claude prompt variant |
|
||||
| `gemini.ts` | Gemini-optimized prompt variant |
|
||||
| `gpt.ts` | GPT-optimized prompt variant |
|
||||
| `kimi.ts` | Kimi K2.x prompt variant |
|
||||
| `opus-4-7.ts` | Claude Opus 4.7 prompt variant |
|
||||
| `default-prompt-sections.ts` | Default prompt section definitions |
|
||||
| `gemini-prompt-sections.ts` | Gemini prompt section definitions |
|
||||
| `gpt-prompt-sections.ts` | GPT prompt section definitions |
|
||||
| `kimi-prompt-sections.ts` | Kimi prompt section definitions |
|
||||
| `opus-4-7-prompt-sections.ts` | Opus 4.7 prompt section definitions |
|
||||
| `prompt-section-builder.ts` | Composes category, agent, skills, and decision matrix sections |
|
||||
| `shared-prompt.ts` | Shared prompt content: delegation system, parallel rules, auto-continue, notepad protocol, post-delegation rule, boulder completion |
|
||||
| `atlas-prompt.test.ts` | Prompt composition tests |
|
||||
| `prompt-checkbox-enforcement.test.ts` | Checkbox enforcement behavior tests |
|
||||
| `prompt-routing.test.ts` | Model-variant routing tests |
|
||||
|
||||
## MODEL VARIANT ROUTING
|
||||
|
||||
Parent `agent.ts` selects variant by model name:
|
||||
- `isGptModel()` -> `gpt.ts`
|
||||
- `isGeminiModel()` -> `gemini.ts`
|
||||
- `isKimiK2Model()` -> `kimi.ts`
|
||||
- `isClaudeOpus47Model()` -> `opus-4-7.ts`
|
||||
- Default -> `default.ts` (Claude 4.6 family)
|
||||
|
||||
## KEY BEHAVIORS
|
||||
|
||||
- Mode: `primary` (respects UI model selection)
|
||||
- Temperature: 0.1
|
||||
- Default model: `claude-sonnet-4-6`
|
||||
- Denied tools: `task`, `call_omo_agent` (Atlas delegates; it does not run subagents directly)
|
||||
- Checkbox enforcement in prompts (per `prompt-checkbox-enforcement.test.ts`)
|
||||
- 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`
|
||||
@@ -0,0 +1,33 @@
|
||||
---
|
||||
name: builtin-agents-factory-layer
|
||||
description: Conditional factory wrappers that apply overrides, model resolution, skill filtering, and provider gating to the 11 agent definitions.
|
||||
---
|
||||
|
||||
# src/agents/builtin-agents/ -- Conditional Factory Layer
|
||||
|
||||
**Generated:** 2026-05-18
|
||||
|
||||
## OVERVIEW
|
||||
|
||||
Conditional factory layer beneath the 11 raw `createXXXAgent` factories in `src/agents/`. Each `maybeCreateXXXConfig` wrapper decides whether an agent registers, resolves its model via the 4-step pipeline, applies user overrides, filters skills, and returns the final `AgentConfig` -- or `undefined` if the agent is disabled or requirements are not met. Outputs feed `createPluginInterface`.
|
||||
|
||||
## FILE CATALOG
|
||||
|
||||
| File | Purpose |
|
||||
|------|---------|
|
||||
| `agent-overrides.ts` | Applies user overrides: category expansion, `deepMerge` of model/temp/prompt/permissions, `file://` prompt resolution |
|
||||
| `model-resolution.ts` | 4-step pipeline wrapper: `resolveModelPipeline` (override → category → provider fallback → system default) + `getFirstFallbackModel` |
|
||||
| `resolve-file-uri.ts` | Converts `file://` paths to absolute paths, bounds them to project root, reads content for prompt append |
|
||||
| `resolve-file-uri.test.ts` | Tests for URI decoding, path expansion, project-root bounds, missing-file handling |
|
||||
| `environment-context.ts` | Appends `createEnvContext()` block to agent prompt unless `disableOmoEnv` is set |
|
||||
| `available-skills.ts` | `buildAvailableSkills` -- merges builtin skills with discovered user skills, filters disabled |
|
||||
| `available-skills.test.ts` | Tests for builtin + discovered skill merging and disabled filtering |
|
||||
| `sisyphus-agent.ts` | `maybeCreateSisyphusConfig` -- checks disabled list, model requirements, applies overrides + frontier tool schema guard + GPT patch guard |
|
||||
| `sisyphus-agent.test.ts` | Tests for disabled-agent filtering, model resolution, override application, first-run fallback behavior |
|
||||
| `hephaestus-agent.ts` | `maybeCreateHephaestusConfig` -- provider gating (`requiresProvider`), category override support, variant defaulting to medium |
|
||||
| `atlas-agent.ts` | `maybeCreateAtlasConfig` -- UI-selected model respect, variant resolution |
|
||||
| `general-agents.ts` | `collectPendingBuiltinAgents` -- handles all non-special-cased agents (skips sisyphus/hephaestus/atlas/sisyphus-junior), bulk model resolution and override application |
|
||||
|
||||
## PIPELINE FIT
|
||||
|
||||
Phase 3 of `plugin-handlers/config-handler.ts` invokes these factories. The resulting `AgentConfig` array feeds `createPluginInterface`. Returns `undefined` for disabled agents or unmet model requirements.
|
||||
@@ -0,0 +1,50 @@
|
||||
---
|
||||
name: sisyphus-junior-agent
|
||||
description: Developer reference for the Sisyphus-Junior category-spawned executor agent -- model variants and discipline.
|
||||
---
|
||||
|
||||
# src/agents/sisyphus-junior/ -- Category-Spawned Executor
|
||||
|
||||
**Generated:** 2026-05-18
|
||||
|
||||
## OVERVIEW
|
||||
|
||||
10 files. Sisyphus-Junior is a focused task executor spawned by `delegate-task` when category routing requires it. Runs in subagent mode with its own fallback chain. Does not delegate further; executes directly.
|
||||
|
||||
## FILES
|
||||
|
||||
| File | Purpose |
|
||||
|------|---------|
|
||||
| `agent.ts` | `createSisyphusJuniorAgentWithOverrides()` factory, model-variant routing, `SISYPHUS_JUNIOR_DEFAULTS` |
|
||||
| `index.ts` | Barrel exports |
|
||||
| `default.ts` | Base/Claude prompt: todo discipline, verification, termination rules |
|
||||
| `gemini.ts` | Gemini-optimized prompt variant |
|
||||
| `gpt.ts` | Base GPT prompt variant |
|
||||
| `gpt-5-3-codex.ts` | GPT-5.3 Codex prompt variant |
|
||||
| `gpt-5-4.ts` | GPT-5.4-native prompt variant |
|
||||
| `gpt-5-5.ts` | GPT-5.5-native prompt variant |
|
||||
| `kimi-k2-6.ts` | Kimi K2.6 prompt variant |
|
||||
| `index.test.ts` | Unit tests |
|
||||
|
||||
## VARIANT SELECTION
|
||||
|
||||
Parent `agent.ts` selects prompt variant by model name:
|
||||
- Contains "kimi-k2" -> `kimi-k2-6.ts`
|
||||
- Contains "gpt-5.5" -> `gpt-5-5.ts`
|
||||
- Contains "gpt-5.4" -> `gpt-5-4.ts`
|
||||
- Contains "gpt-5.3-codex" -> `gpt-5-3-codex.ts`
|
||||
- Contains "gpt" -> `gpt.ts`
|
||||
- Contains "gemini" -> `gemini.ts`
|
||||
- Default -> `default.ts` (Claude, GLM, etc.)
|
||||
|
||||
## KEY BEHAVIORS
|
||||
|
||||
- Mode: `subagent` (uses own fallback chain, ignores UI selection)
|
||||
- Default model: `claude-sonnet-4-6`
|
||||
- Default temperature: `0.1` (`SISYPHUS_JUNIOR_DEFAULTS`)
|
||||
- Fallback chain: kimi-k2.6 -> gpt-5.5 medium -> minimax-m2.7 -> big-pickle
|
||||
- Blocked tools: `task` (all models); `apply_patch` also blocked for GPT models
|
||||
- `call_omo_agent` explicitly allowed so subagents can spawn explore/librarian
|
||||
- Max tokens: 64000
|
||||
- Thinking enabled for non-GPT/non-GLM models (budgetTokens: 32000)
|
||||
- Reasoning effort "medium" for GPT models
|
||||
Reference in New Issue
Block a user