docs(copilot): add model selection reference

This commit is contained in:
Tibo De Peuter 2026-09-10 16:29:25 +02:00
parent ad22eee20e
commit 5b73af3aef

25
copilot/model-guide.md Normal file
View file

@ -0,0 +1,25 @@
# Model selection guide (Copilot CLI)
Reference for picking a model/agent per plan phase. Referenced from
`instructions/workflow.instructions.md` rather than inlined there, so this table can be
updated independently whenever the available model lineup or pricing changes.
Update this table directly when the model lineup changes — no need to touch the workflow
instructions to do so.
| Model | When to use it | 💡 Smartness | ⚡ Speed | 💲 Cost |
| --- | --- | --- | --- | --- |
| _(fill in current lineup here)_ | | | | |
## Rough guidance
- **Hardest, most open-ended tasks** (complex refactoring, ambiguous debugging, deep
architectural analysis, long multi-step reasoning): pick the highest-smartness model
available, accept lower speed/higher cost.
- **Routine, well-specified work** (mechanical edits, bulk reads/exploration, formatting,
straightforward test/lint fixes): pick a lower-cost, faster model — this is most of a
typical phase's work.
- **PR-feedback loops and unresolved-comment rechecks**: usually mechanical; only escalate
to a higher-smartness model if a review comment surfaces genuine ambiguity.
- When in doubt, the executing agent should state which tier it picked and why, so it can
be verified rather than silently over- or under-spending.