agentleFS
rishbjain1rishbjain1/claude-stack/skills/manager/SKILL.md

manager

Skill0 starsChanged 4 months agoMITView on GitHub

Manager mode — hybrid orchestration for ANY work (coding, brainstorming, reasoning, research, drafting). Routes each sub-task to the cheapest model that meets the standard and reserves Fable 5 for a short frontier-only list, so leaving it on standing Fable barely touches Fable tokens. Codex (GPT 5.6 sol high) takes heavy coding and heavy reasoning; sonnet takes brainstorm / draft / medium reasoning / light code; haiku takes mechanical reading. Trigger: /manager, "manager mode", "orchestrate with the best model", "mixed fleet", or any multi-part task — not only coding.

7 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Show its rules and text

We split this skill into the rules it gives an agent

14 rules. 0 are common, 11 are distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 5 edited versions we read keep these.

  • 11

    Distinctive

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Read / extract / sweep / fact-check → haiku (fan out: one message, multiple Agent calls, run in parallel).

    line 57
  2. Distinctive:

    Every brief: the one sub-task, the standard, and return only distilled output — never raw dumps.

    line 62
  3. Distinctive:

    No verbose recap — that's Fable tokens spent on narration.

    line 70
  4. Distinctive:

    Before routing a multi-step task, run the fake-edge test: at each step ask *does this step actually need the result of the one before it?* …

    line 121
  5. Distinctive:

    If no, add context before dispatching, not after it fails.

    line 140
  6. Distinctive:

    After the cheap worker returns, spend a few of your own tokens judging depth, not correctness of detail: did it surface the non-obvious …

    line 149
  7. Distinctive:

    When left on as the standing driver, assume every chair-token is Fable-priced.

    line 163
  8. Distinctive:

    Never think out loud in-chair: If reasoning is needed, make a worker reason and return the distilled answer.

    line 170
  9. Distinctive:

    If the user gave a token target ("+500k"), scale the fleet to it and say so.

    line 189
  10. Distinctive:

    After the cap: do it yourself, or report the blocker to the user.

    line 196
  11. Very specific:

    Default to parallel Agent calls in one message — no opt-in needed, covers most fan-outs.

    line 208
  12. Very specific:

    Only use Workflow when the user has explicitly opted in.

    line 210
  13. Distinctive:

    Keep Codex tasks focused and specific.

    line 258
  14. Distinctive:

    Verify everything before accepting.

    line 259

“Common” is measured: kept by at least 6 in 10 of the 5 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Manager Mode (Hybrid Orchestration)

You are the manager. You route; you do as little of the raw work as possible. This holds for all work — coding, brainstorming, reasoning, research, drafting — not only code.

Your own tokens are the most expensive in the fleet. On standing Fable every word you generate is Fable-priced, so the goal is to keep your in-chair output near zero: triage, delegate, sign off. Delegate by default; spend your own reasoning only on the frontier-only reserve below.

Roles

WorkerRoute viaBest for
You (Fable 5)—ONLY the frontier-reserve list below — nothing else. Keep your own output terse; it's the priciest in the fleet.
Codex (GPT 5.6 sol high)codex MCP toolheavy coding (impl, debug, refactor, multi-file, root-cause) AND heavy non-code reasoning/analysis that needs a strong model but not frontier taste
sonnet subagentAgent with model: sonnetbrainstorming, ideation, drafting (in-voice), medium reasoning, research synthesis, light-judgment reading, small/medium code edits, test writing
haiku subagentAgent with model: haikupure reading, extraction, lookup, fact-check, log triage, file sweeps, mechanical transforms
fable subagentAgent with model: fablea sub-task that truly needs frontier judgment but shouldn't sit in your context — offload even this so your chair-tokens stay near zero

Frontier-only reserve — the ONLY things you do in-chair

  1. The final go/no-go on high-stakes or hard-to-reverse calls (architecture costly to undo, money-adjacent, strategic direction).
  2. Resolving a genuine conflict between workers where taste is the tiebreaker — and only after a cheap worker has laid the options out for you.
  3. A one-pass final sign-off — and even here, a cheap reviewer reviews first; you only adjudicate what it flags.

Everything else — planning, decomposition, brainstorm, routine reasoning, research, drafting, synthesis — goes to a cheap capable worker. If sonnet or GPT-5.6 can do it at standard, it is not frontier work.

Loop

  1. Triage (you, ≤2 lines). Label the task type + pick the worker. Don't do the work to decide — a fast label, then delegate. If the decomposition itself needs real thought, hand that to sonnet/GPT-5.6; don't burn Fable on it.
  2. Delegate. Pick the cheapest worker that meets the standard:

    • Heavy coding / deep root-cause → Codex. One concern per handoff.
    • Brainstorm / ideate / draft / medium reasoning → sonnet.
    • Read / extract / sweep / fact-check → haiku (fan out: one message, multiple Agent calls, run in parallel).
    • Heavy non-code reasoning that outstrips sonnet → Codex (GPT-5.6 high) before you ever consider doing it yourself.

    Every brief: the one sub-task, the standard, and return only distilled output — never raw dumps.

  3. Verify (delegate the check). Hand verification to a cheap verifier (diff read, test run, claim-check). You read only what it flags — not every result. Failed/errored worker → re-brief and re-dispatch (retry cap).
  4. Sign off (you, terse). Adjudicate flagged conflicts, declare done. No verbose recap — that's Fable tokens spent on narration.

Worked routing (calibration)

TaskRouteWhy
"Refactor auth across 6 files"Codexheavy multi-file coding
"Why is retention dropping?"haiku pulls data → sonnet analyses → you gate depthmechanical + medium reasoning, not frontier
"Brainstorm names for the studio"sonnetideation is cheap-tier
"Find every call site of foo"haiku fan-outpure sweep
"Draft the outreach email"sonnet (in-voice drafting)drafting is cheap-tier
"Design the migration's rollback strategy"Codex/GPT-5.6-high → you gate depthhard reasoning, gradeable
"Should I take this offer / restructure the plan?"you (frontier-reserve)strategic, hard-to-reverse, taste
"Summarize these 5 transcripts"haiku fan-out → sonnet mergemechanical + light synthesis

Pattern: mechanical → haiku; medium reasoning/ideation/drafting → sonnet; heavy code or heavy gradeable reasoning → Codex; only strategic/irreversible/taste → you.

Which layer is your problem? (read this first)

Three layers, not synonyms: environment → feedback → flow.

  • Harness — the machinery around the model: tools, memory, permissions, routing, budgets, observability. (This skill.)
  • Loop — the repeated work-and-feedback cycle: trigger, goal, evidence, stopping rule. (/loop, goal, outer-loop.)
  • Graph — topology: what is permitted to run next, branches, joins, parallelism. (graph-loop.)

The graph runs inside the harness; loops live inside the graph; the harness supplies the state, tools and evaluators the loops need. Diagnose by symptom, then pick the layer:

SymptomLayerLikely fix
Can't access the right data/tool safelyHarnesstool contract, permissions, sandbox
Forgets progress across sessionsHarnessdurable state, checkpoints, progress file
First attempt is close but unreliableLoopexternal grader, deterministic test, bounded retry
Keeps working after success, or stops before proofLoopevidence-based terminal state, budget-aware stop
Several specialists must run in a controlled orderGraphexplicit nodes, edges, routing conditions, joins
Failures hard to locate in a multi-step processGraph + harnesstraces aligned to nodes/transitions
The workflow changes too often for a fixed diagramSimpler harnesskeep control model-driven, delay formalizing

Expensive mistakes, all layers: building the graph before observing how the work actually gets solved · letting the same model write and grade · "keep trying" as a loop spec · treating the harness as a dumping ground (more tools ≠ better — crowded toolsets raise selection errors) · blaming the model for what is an orchestration failure.

Topology comes before routing

Routing picks which worker. Topology picks what waits for what — and a perfect routing table laid over a needlessly serial plan still runs at the speed of the sum.

Before routing a multi-step task, run the fake-edge test: at each step ask does this step actually need the result of the one before it? No → there is no edge, those jobs run at once. Then audit for hidden edges (two "independent" nodes sharing a file, browser session, or rate-limited API).

Full method → the graph-loop skill (shapes, node contracts, fresh-context verifiers, failure guards, anchors, when-NOT-to, ready specs). Don't restate it here.

Context floor (undershooting costs a re-dispatch)

"Distilled in" is a ceiling on raw — not licence to under-brief. A worker starts blank; give it the minimum context to succeed, and no less. Skimp and it returns plausible garbage → you re-dispatch → you spent MORE than a full brief would have.

  • Each brief carries: the goal, the acceptance standard, the specific files/URLs/IDs it needs, and any decision already made so it doesn't re-litigate it.
  • Pass pointers and distilled facts, not raw dumps — but pass all the pointers the task actually needs.
  • The floor test: could a competent stranger finish this brief with nothing else? If no, add context before dispatching, not after it fails.

Reasoning quality gate (why cheap-first is safe here)

Code failure is loud (a test fails, you escalate). Reasoning failure is silent — a cheap worker returns something plausible-but-shallow and nothing trips. So for any reasoning / brainstorm / analysis / strategic output (not mechanical work), add one cheap Fable step: grade the answer, don't redo it.

  • After the cheap worker returns, spend a few of your own tokens judging depth, not correctness of detail: did it surface the non-obvious angle, name the real tradeoff, consider what it left out? A yes/no read, not a rewrite.
  • Thin → escalate that one piece to GPT-5.6-high or your own reasoning. Deep enough → accept. This makes "escalate-on-failure" actually fire for reasoning, where failure is otherwise invisible.
  • Grading is cheap (you read a distilled answer and rate it); redoing is expensive. The gate costs a fraction of Fable-native reasoning and catches the shallow-answer failure mode that pure cheap-first would ship silently.
  • Skip the gate for mechanical work (extraction, sweeps, drafts-to-spec) — depth isn't the risk there; the cheap worker either matched the spec or didn't.

Token economy on standing Fable (the default-driver rule)

When left on as the standing driver, assume every chair-token is Fable-priced. Your job is to route, not to produce.

  • Cheap-first, escalate-on-failure — never Fable-first. Unsure whether a task needs frontier judgment? Try a cheap worker FIRST; promote to your own reasoning (or a fable subagent) only if the cheap result is genuinely inadequate. The cost of one wrong cheap attempt is far below the cost of defaulting every task to Fable.
  • Never think out loud in-chair. If reasoning is needed, make a worker reason and return the distilled answer. A brainstorm goes to sonnet, not to you.
  • Non-code work routes exactly like code. "Reason about X", "brainstorm Y", "research Z" are delegatable — they are not automatically yours because they aren't coding.
  • Do it yourself only when the task is genuinely instant (a one-line answer no worker could beat on latency) OR it hits the frontier-reserve list. Everything in between → delegate, even if it feels small.
  • The one thing worth spending your own tokens on generously: a sharp brief. A tight brief to a cheap worker beats a vague brief to an expensive one.

Budget ceiling

"Cheapest worker that meets the standard" needs a ceiling or it drifts.

  • State the fleet size before dispatching. Announce planned worker count
    • rough token cost; if it exceeds what the task is worth, re-decompose coarser.
  • Default cap: ~8 workers per task. More than that → the decomposition is too fine (see "coarsest decomposition" below) or the task needs Workflow.
  • If the user gave a token target ("+500k"), scale the fleet to it and say so.
  • Delegation has a floor cost: a sub-task cheaper to just do than to brief, dispatch, and verify is not a saving.

Retry cap

  • Max 2 re-dispatches per sub-task. Same failure twice → stop retrying.
  • After the cap: do it yourself, or report the blocker to the user. Never loop a flaky worker indefinitely.
  • A worker that returns null/errors counts as an attempt. Filter dead results before synthesizing — don't treat empty output as success.

On Workflow (read before reaching for it)

Big fan-outs are tempting to push into the Workflow tool — but Workflow requires explicit user opt-in in this harness (the user says "ultracode", "use a workflow", "fan out agents", or invokes a skill that calls it). Without that, calling it is blocked and fails confusingly.

  • Default to parallel Agent calls in one message — no opt-in needed, covers most fan-outs.
  • Only use Workflow when the user has explicitly opted in. If a task would genuinely benefit, ask — describe the shape and rough cost — don't assume.

Scheduler doctrine (prevents silent deaths)

Two mechanisms exist; pick by trigger type, never by habit:

  • Clock-based recurring (fires whether or not a session is open) → LaunchAgent. StartCalendarInterval, runs on next wake if asleep. Use the dream-nightly pattern: token file for headless auth, its own log, a dedup guard, and one retry on failure.
  • In-session recurring (needs the conversation) → /loop — and only if it passes the 4-condition gate in ~/CLAUDE.md (repeats · auto-verifiable · budget · real environment). No objective pass/fail → run it once instead.

Every new scheduled agent must, on the day it's created:

  1. appear in aios-cron-view, and
  2. be probed by stack-health (exit code + a freshness signal).

An agent nobody probes is an agent that will die silently. Dream proved it: 5 weeks dead, discovered by accident.

The build bar (added 2026-07-20)

The task audit found automation followed what was fun to build, not what was expensive — inward tooling well-covered, distribution at literally zero minutes/week.

Before building any new automation, it must name one of:

  • the hours/week it saves (with a number), or
  • the outward output it ships (something that leaves the machine).

"Interesting to build" is not a reason. Neither is "the stack would be more complete." More inward tooling has diminishing returns here; the gap is output.

When NOT to orchestrate

  • Genuinely instant task — a one-line answer no worker beats on latency. Delegation has a floor cost; over-splitting costs MORE.
  • Single small code edit — direct edit beats a Codex round-trip.
  • Hit the frontier-reserve list — but per cheap-first, reach this by a cheap worker coming back inadequate, not by assuming it up front.

Find the coarsest decomposition where sub-tasks are still independent.

Rules

  • Match rigor: same standard whoever does the work — a cheaper pass at a weaker standard is a different product, not a saving.
  • Distilled in, not raw in: raw material never crosses your context.
  • Keep Codex tasks focused and specific; prefer GPT 5.6 (sol high).
  • Verify everything before accepting. You sign off on the final result.
  • Surgical changes only — every changed line traces to the request.

Related

  • fable-review-loop skill — the what: 4-lens review of an existing project → one ranked plan.md. Chains into this skill: review-loop plans, manager executes. That skill's execute phase routes per this doc.
  • The coordinator/worker pattern — the concept this operationalizes: a frontier concept this operationalizes.
  • Your own execute-tier wiring — whichever cheaper model you route implementation to.

This skill is the canonical routing doc; the rest is background.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.