docs: sync category names with code and add missing schema fields

- Update category tables to match DEFAULT_CATEGORIES in constants.ts
- Remove non-existent 'most-capable' and 'general' categories
- Add 'unspecified-low' and 'unspecified-high' categories
- Update model names to full paths (e.g., openai/gpt-5.2-codex)
- Add new CategoryConfig schema fields: description, variant, top_p, etc.
- Fix atlas.ts prompt examples with correct category names
This commit is contained in:
justsisyphus 2026-01-23 00:13:42 +09:00
parent 638a314f6d
commit 83bcf70bdd
3 changed files with 29 additions and 22 deletions

View File

@ -19,14 +19,15 @@ A Category is an agent configuration preset optimized for specific domains.
### Available Built-in Categories
| Category | Optimal Model | Characteristics | Use Cases |
|----------|---------------|-----------------|-----------|
| `visual-engineering` | `gemini-3-pro` | High creativity (Temp 0.7) | Frontend, UI/UX, animations, styling |
| `ultrabrain` | `gpt-5.2` | Maximum logical reasoning (Temp 0.1) | Architecture design, complex business logic, debugging |
| `artistry` | `gemini-3-pro` | Artistic (Temp 0.9) | Creative ideation, design concepts, storytelling |
| `quick` | `claude-haiku` | Fast (Temp 0.3) | Simple tasks, refactoring, script writing |
| `writing` | `gemini-3-flash` | Natural flow (Temp 0.5) | Documentation, technical blogs, README writing |
| `most-capable` | `claude-opus` | High performance (Temp 0.1) | Extremely difficult complex tasks |
| Category | Default Model | Use Cases |
|----------|---------------|-----------|
| `visual-engineering` | `google/gemini-3-pro-preview` | Frontend, UI/UX, design, styling, animation |
| `ultrabrain` | `openai/gpt-5.2-codex` (xhigh) | Deep logical reasoning, complex architecture decisions requiring extensive analysis |
| `artistry` | `google/gemini-3-pro-preview` (max) | Highly creative/artistic tasks, novel ideas |
| `quick` | `anthropic/claude-haiku-4-5` | Trivial tasks - single file changes, typo fixes, simple modifications |
| `unspecified-low` | `anthropic/claude-sonnet-4-5` | Tasks that don't fit other categories, low effort required |
| `unspecified-high` | `anthropic/claude-opus-4-5` (max) | Tasks that don't fit other categories, high effort required |
| `writing` | `google/gemini-3-flash-preview` | Documentation, prose, technical writing |
### Usage
@ -156,12 +157,18 @@ You can fine-tune categories in `oh-my-opencode.json`.
| Field | Type | Description |
|-------|------|-------------|
| `description` | string | Human-readable description of the category's purpose. Shown in delegate_task prompt. |
| `model` | string | AI model ID to use (e.g., `anthropic/claude-opus-4-5`) |
| `variant` | string | Model variant (e.g., `max`, `xhigh`) |
| `temperature` | number | Creativity level (0.0 ~ 2.0). Lower is more deterministic. |
| `top_p` | number | Nucleus sampling parameter (0.0 ~ 1.0) |
| `prompt_append` | string | Content to append to system prompt when this category is selected |
| `thinking` | object | Thinking model configuration (`{ type: "enabled", budgetTokens: 16000 }`) |
| `reasoningEffort` | string | Reasoning effort level (`low`, `medium`, `high`) |
| `textVerbosity` | string | Text verbosity level (`low`, `medium`, `high`) |
| `tools` | object | Tool usage control (disable with `{ "tool_name": false }`) |
| `maxTokens` | number | Maximum response token count |
| `is_unstable_agent` | boolean | Mark agent as unstable - forces background mode for monitoring |
### Example Configuration

View File

@ -291,15 +291,15 @@ delegate_task(category="quick", prompt="...") // "Just get it done fast
### Built-in Categories
| Category | Model | Temp | When to Use |
|----------|-------|------|-------------|
| `visual-engineering` | Gemini 3 Pro | 0.7 | Frontend, UI/UX, design, animations |
| `ultrabrain` | GPT-5.2 | 0.1 | Complex architecture, business logic |
| `artistry` | Gemini 3 Pro | 0.9 | Creative tasks, novel ideas |
| `quick` | Claude Haiku 4.5 | 0.3 | Small tasks, budget-friendly |
| `most-capable` | Claude Opus 4.5 | 0.1 | Maximum reasoning power |
| `writing` | Gemini 3 Flash | 0.5 | Documentation, prose |
| `general` | Claude Sonnet 4.5 | 0.3 | Default, general purpose |
| Category | Model | When to Use |
|----------|-------|-------------|
| `visual-engineering` | Gemini 3 Pro | Frontend, UI/UX, design, styling, animation |
| `ultrabrain` | GPT-5.2 Codex (xhigh) | Deep logical reasoning, complex architecture decisions |
| `artistry` | Gemini 3 Pro (max) | Highly creative/artistic tasks, novel ideas |
| `quick` | Claude Haiku 4.5 | Trivial tasks - single file changes, typo fixes |
| `unspecified-low` | Claude Sonnet 4.5 | Tasks that don't fit other categories, low effort |
| `unspecified-high` | Claude Opus 4.5 (max) | Tasks that don't fit other categories, high effort |
| `writing` | Gemini 3 Flash | Documentation, prose, technical writing |
### Custom Categories

View File

@ -791,12 +791,12 @@ Before processing sequentially, check if there are PARALLELIZABLE tasks:
{{CATEGORY_SKILLS_DELEGATION_GUIDE}}
**Examples:**
- "Category: general. Standard implementation task, no special expertise needed."
- "Category: visual. Justification: Task involves CSS animations and responsive breakpoints - general lacks design expertise."
- "Category: strategic. [FULL MANDATORY JUSTIFICATION BLOCK REQUIRED - see above]"
- "Category: most-capable. Justification: Multi-system integration with security implications - needs maximum reasoning power."
- "Category: quick. Standard implementation task, trivial changes."
- "Category: visual-engineering. Justification: Task involves CSS animations and responsive breakpoints - quick lacks design expertise."
- "Category: ultrabrain. [FULL MANDATORY JUSTIFICATION BLOCK REQUIRED - see above]"
- "Category: unspecified-high. Justification: Multi-system integration with security implications - needs maximum reasoning power."
**Keep it brief for non-strategic. For strategic, the justification IS the work.**
**Keep it brief for non-ultrabrain. For ultrabrain, the justification IS the work.**
#### 3.3: Prepare Execution Directive (DETAILED PROMPT IS EVERYTHING)