orchestration-cost-policy
Skill0 starsChanged 5 months agoMITView on GitHub
Use when deciding HOW to execute non-trivial work: which orchestration mechanism (inline, subagent fan-out, workflow) and which model tier per task. Applies before dispatching agents, spawning workflows, or doing large work in the main loop. The rule: maximize results per token, weighting model effectiveness against cost for the specific task.
In this repository34 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- architectureSkill
- code-reviewSkill
- debugSkill
- dep-auditSkill
- deploy-checklistSkill
- documentationSkill
- end-agent-sessionSkill
- incident-responseSkill
- likec4-dslSkill
- load-agentSkill
- manual-testSkill
- market-scanSkill
- new-agentSkill
- new-goal-loopSkill
- nexus-microSkill
- nexusSkill
- nexus-sprintSkill
- persona-forgeSkill
- project-onboardSkill
- prompt-refinerSkill
- public-readinessSkill
- release-prepSkill
- render-mermaidSkill
- secrets-syncSkill
- standupSkill
- system-designSkill
- tech-debtSkill
- testing-strategySkill
- tmux-session-captureSkill
- tsdocSkill
- web-ui-automation-componentsSkill
- web-ui-automation-surveySkill
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 4 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 22
When unsure between two tiers, ask: "would the cheaper model's failure be caught by an existing gate (tests, lint, drift check)?" If yes, …
- Distinctive: line 33
Do not re-read or re-verify what a subagent already verified under a gate.
- Distinctive: line 35
Prefer existing gates (tests, lint, CI checks, drift ledgers) over reviewer agents for mechanical correctness.
- Distinctive: line 39
If best-results and cheapest genuinely conflict (quality bar not reachable at the affordable tier), surface the tradeoff to the user with a …
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Orchestration Cost Policy
One rule, globally: pick the mechanism and model tier that produce the best results for the fewest tokens, evaluated per task as (model effectiveness for this task) vs (token cost). No loyalty to any tool. This is a standing directive from Wes -- he works against a 5-hour usage window, so orchestration overhead directly costs working time.
Model tier selection
| Task shape | Tier |
| Judgment-heavy: contract/API semantics, state machines, architecture, gnarly merges, security-sensitive code, establishing a pattern others copy | Opus (or the session's top model) |
| Pattern-following: CRUD against an established exemplar, porting per a written work order, test scaffolding, docs, mechanical refactors | Sonnet |
| Pure-mechanical sweeps: renames, inventory/grep summarization, format fixes at scale | Haiku |
When unsure between two tiers, ask: "would the cheaper model's failure be caught by an existing gate (tests, lint, drift check)?" If yes, go cheaper -- the gate converts quality risk into a cheap retry.
Mechanism selection
- Inline (main loop): small known edits, adjudication, merges requiring judgment. Never burn main-loop context on bulk file reading a subagent could summarize.
- Subagent fan-out (Agent tool): iteration count known and small; each unit independently verifiable; parallelize only when writers touch disjoint files (or use worktrees + planned merges).
- Workflow: unknown-size work discovered as you go (loop-until-dry), or when deterministic control flow over many stages saves repeated main-loop reasoning. Do not use it to automate a loop whose expensive step is human/orchestrator judgment -- the script only automates the cheap part.
Token hygiene (all mechanisms)
- Brief agents with pointers to files + a written work order, not pasted bulk content -- unless the content is small and saves the agent a discovery pass.
- Do not re-read or re-verify what a subagent already verified under a gate; spot-check the gate instead.
- Batch verification into single commands; batch independent tool calls into one message.
- Prefer existing gates (tests, lint, CI checks, drift ledgers) over reviewer agents for mechanical correctness; spend reviewer agents on semantics only.
Escalation
If best-results and cheapest genuinely conflict (quality bar not reachable at the affordable tier), surface the tradeoff to the user with a recommendation instead of silently picking either.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

