docs: rewrite agent-model matching as technical guide for agents

Rewrite agent-model-matching.md as a technical reference that:
- Documents actual fallback chains from model-requirements.ts
- Explains model-specific prompt routing (Prometheus/Atlas GPT detection)
- Covers safe vs dangerous model substitutions with rationale
- Includes task categories (visual-engineering, deep, quick, etc.)
- Guides agents on how to explain model choices to users
- Adds provider priority chain

Also update installation.md to reference the guide when users
want custom model configuration, with explanation of what is
safe to change and why.
This commit is contained in:
YeonGyu-Kim
2026-02-19 15:01:34 +09:00
parent 3b8846e956
commit d9ee0d9c0d
2 changed files with 148 additions and 126 deletions
+12
View File
@@ -259,6 +259,18 @@ opencode auth login
The plugin works perfectly by default. Do not change settings or turn off features without an explicit request.
### Custom Model Configuration
If the user wants to override which model an agent uses, refer to the **[Agent-Model Matching Guide](./agent-model-matching.md)** before making changes. That guide explains:
- **Why each agent uses its default model** — prompt optimization, model family compatibility
- **Which substitutions are safe** — staying within the same model family (e.g., Opus → Sonnet for Sisyphus)
- **Which substitutions are dangerous** — crossing model families without prompt support (e.g., GPT for Sisyphus)
- **How auto-routing works** — Prometheus and Atlas detect GPT models and switch to GPT-optimized prompts automatically
- **Full fallback chains** — what happens when the preferred model is unavailable
Always explain to the user *why* a model is assigned to an agent when making custom changes. The guide provides the rationale for every assignment.
### Verify the setup
Read this document again, think about you have done everything correctly.