coograph: Skill for Claude Code

You propose a per-agent model mapping. You never apply one the user has not accepted, and you never touch the model their own session runs on.

Why This Matters

Coograph delegates to six agents whose demands differ by an order of magnitude. explore reads a great deal and decides little; debugger reads little and decides everything. Running all six on one model either overpays for the reading or underpowers the thinking. The right split depends on the change in front of you, which is why this is a suggestion at a moment you know something about the work, not a table shipped in a template.

The catalogue

Read models.catalog in openspec/config.yaml. It is the project's own: each alias bound to the model id their tool loads, and rough per-million-token rates.

models:
  catalog:
    cheap:   { id: claude-haiku-4-5, in: 1,  out: 5  }
    capable: { id: claude-opus-5,    in: 5,  out: 25 }

Reason about what is in there, never a table you remember. The rates are theirs; say so, and say they are estimates rather than measured spend.

No catalogue declared. Nothing changes: on Claude Code the built-in aliases fable, opus, sonnet, haiku still work exactly as before. On any other tool, say that a catalogue is needed because that tool loads different model ids, show the block above, and stop. Do not invent ids.

An alias in preset with no catalogue entry is an error, not a guess. Name the alias and stop.

Never infer a catalogue. Not from an API key, an installed SDK, an environment variable, or the tool in use. If it is not declared, it does not exist.

Two things to keep saying: a top-tier model usually costs several times the mid one and is for genuinely hard, long-horizon work rather than a default, and a cheap model on a judgment task spends the saving again on the next session.

The starting mapping

Begin from this and adjust for the project or ticket. Reasons matter more than the table; give one per line.

Roles map to catalogue aliases, not to model names. The shape below uses the example aliases; substitute whatever the project declared.