Skip to content
Back to search

fable-orchestrator

Fable 5.2-first multi-agent orchestration for Claude Code: a token-frugal chair profile with tier routing (Sonnet 5.5 carries the volume, Opus 5.5 the hard slices), chair-sized effort per worker, delegation as the default, and hooks that notice when the chair does the work itself instead.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/rylaa--fable5-opus5-5-orchestrator/badge.svg)](/listings/rylaa--fable5-opus5-5-orchestrator)

HTML

<a href="/listings/rylaa--fable5-opus5-5-orchestrator"><img src="/api/listings/rylaa--fable5-opus5-5-orchestrator/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

/plugin marketplace add Rylaa/fable5.2-opus5.5-orchestrator
/plugin install orchestrator@fable-orchestrator

Restart Claude Code afterwards — hooks load when the CLI starts.

- Run the chair at `/effort medium`, `high` for the hardest planning. - Recommended: set `CLAUDE_CODE_SUBAGENT_MODEL=sonnet` under `"env"`, so a spawn that forgets `model` does not run on Fable. - Requires `python3` 3.10+ and macOS or Linux (the hooks use `ps` and `tmux`).

To watch the team, start `claude` inside tmux; the workers appear as panes in your window.

<details> <summary>Manual install (without the plugin system)</summary>

1. Copy `scripts/*.py` (except `stats.py`) to `~/.claude/hooks/`. 2. Merge into `~/.claude/settings.json`:

{
  "hooks": {
    "SessionStart": [
      { "hooks": [ { "type": "command", "command": "python3 ~/.claude/hooks/inject_instructions.py", "timeout": 10 } ] }
    ],
    "UserPromptSubmit": [
      { "hooks": [ { "type": "command", "command": "python3 ~/.claude/hooks/remind_chair.py", "timeout": 10 } ] }
    ],
    "PreToolUse": [
      {
        "matcher": "^(Agent|Task|Edit|Write|MultiEdit|NotebookEdit)$",
        "hooks": [ { "type": "command", "command": "python3 ~/.claude/hooks/solo_guard.py", "timeout": 10 } ]
      }
    ],
    "SessionEnd": [
      { "hooks": [ { "type": "command", "command": "python3 ~/.claude/hooks/cleanup_session_cache.py", "timeout": 20 } ] }
    ]
  }
}

3. Append `instructions/dynamic-workflow-fable.md` to `~/.claude/CLAUDE.md` and copy the playbook to `~/.claude/skills/playbook/SKILL.md`.

Don't run the plugin and the manual install together — every hook would fire twice.

</details>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines
  1. {
  2. "name": "fable-orchestrator",
  3. "description": "Fable 5.2-first multi-agent orchestration for Claude Code: a token-frugal chair profile with tier routing (Sonnet 5.5 carries the volume, Opus 5.5 the hard slices), chair-sized effort per worker, delegation as the default, and hooks that notice when the chair does the work itself instead.",
  4. "owner": {
  5. "name": "Yusuf Demirkoparan",
  6. "url": "https://github.com/Rylaa"
  7. },
  8. "plugins": [
  9. {
  10. "name": "orchestrator",
  11. "source": "./",
  12. "description": "Fable 5.2-first multi-agent orchestration: a token-frugal chair profile with tier routing, delegation as the default, a solo guard that denies the chair's third unshared edit, a per-prompt reminder, and automatic teammate reaping."
  13. }
  14. ]
  15. }
README.md · README · 157 lines
  1. # Fable Orchestrator
  2. [![CI](https://github.com/Rylaa/fable5.2-opus5.5-orchestrator/actions/workflows/ci.yml/badge.svg)](https://github.com/Rylaa/fable5.2-opus5.5-orchestrator/actions/workflows/ci.yml)
  3. **Run Claude Fable 5.2 all day — without watching the usage meter.**
  4. Fable 5.2 is the best chair a Claude Code session can have, and the most expensive one. This plugin keeps it on planning and decisions and sends the work to named workers: the volume to **Sonnet 5.5**, the hard slices (architecture, irreversible migrations, security review) straight to **Opus 5.5**. No tier ever runs above `high` effort.
  5. ## The division of labor
  6. ```
  7. ┌─────────────────────────────────┐
  8. │ FABLE 5.2 — chair │
  9. │ plan · arbitrate · decide │
  10. │ sizes tier + effort per task │
  11. └────────────────┬────────────────┘
  12. │
  13. specs down │ briefs up
  14. │
  15. ┌────────────────────────┬────┴───────────────────┬────────────────────────┐
  16. ▼ ▼ ▼ ▼
  17. ┌─────────────────────┐ ┌─────────────────────┐ ┌─────────────────────┐ ┌─────────────────────┐
  18. │SONNET 5.5 · low–med │ │SONNET 5.5 · med–high│ │SONNET 5.5 · med–high│ │ OPUS 5.5 · high │
  19. │ mechanical bulk │ │ implementation │ │ routine judgment │ │ hard work · direct │
  20. │ grep·fetch·scan │ │ code · tests │ │ briefs · review │ │ architecture │
  21. │ format · read │ │ debug · refactor │ │ filtering │ │ migrations·security│
  22. └─────────────────────┘ └─────────────────────┘ └──────────┬──────────┘ └──────────┬──────────┘
  23. │ uncertain / │ beyond
  24. │ high stakes │ opus
  25. ┌──▼────────────────────────▼──┐
  26. │ escalation · one way only │
  27. │ OPUS 5.5 → FABLE 5.2 → stop │
  28. └──────────────────────────────┘
  29. ```
  30. - **Escalation is one-way.** When `high` is not enough, the work moves up a tier, not up in effort. Sonnet's "uncertain" goes to Opus, never back to the chair.
  31. - **A declined task is re-run unchanged** on another tier, never reworded. If that tier declines too, the chair stops and tells you.
  32. ## What the plugin does
  33. **1 · The chair profile.** Every session starts with a ~3.7k-char core: delegate by default, hand off through `./.workflow/scratch/`, name the workers, set `model` and effort per spawn. The detail is in the `orchestrator:playbook` skill, loaded before the first delegation. Worker reports are capped at 40 lines; longer material goes to disk.
  34. **2 · The solo guard.** The chair's own `Edit` / `Write` / `MultiEdit` / `NotebookEdit` calls are counted. The 3rd one in a session that has spawned no worker is denied once, then the guard stays quiet. One spawned worker disarms it. A fork does not count as a worker.
  35. **3 · The naming gate.** The first unnamed spawn with a 1500+ char prompt is denied once. Named workers run in tmux panes you can watch; unnamed ones are invisible until they return.
  36. **4 · The per-prompt reminder.** One line rides every prompt: *You are the CHAIR. Delegate by default.*
  37. Workers (teammates) get none of this — the rules are for the chair. When a session ends, its teammate panes are killed.
  38. ## Two chairs
  39. Fable is primary. When its limit runs out, move the chair to Opus — the Opus profile keeps the same rules with the fable tier resting:
  40. ```
  41. claude --continue --model opus
  42. ```
  43. Do not use `/model` for this: it is invisible to hooks, so the session keeps the Fable profile. Run `/compact` on the new chair if the history is long.
  44. ## Install
  45. ```
  46. /plugin marketplace add Rylaa/fable5.2-opus5.5-orchestrator
  47. /plugin install orchestrator@fable-orchestrator
  48. ```
  49. Restart Claude Code afterwards — hooks load when the CLI starts.
  50. - Run the chair at `/effort medium`, `high` for the hardest planning.
  51. - Recommended: set `CLAUDE_CODE_SUBAGENT_MODEL=sonnet` under `"env"`, so a spawn that forgets `model` does not run on Fable.
  52. - Requires `python3` 3.10+ and macOS or Linux (the hooks use `ps` and `tmux`).
  53. To watch the team, start `claude` inside tmux; the workers appear as panes in your window.
  54. <details>
  55. <summary>Manual install (without the plugin system)</summary>
  56. 1. Copy `scripts/*.py` (except `stats.py`) to `~/.claude/hooks/`.
  57. 2. Merge into `~/.claude/settings.json`:
  58. ```json
  59. {
  60. "hooks": {
  61. "SessionStart": [
  62. { "hooks": [ { "type": "command", "command": "python3 ~/.claude/hooks/inject_instructions.py", "timeout": 10 } ] }
  63. ],
  64. "UserPromptSubmit": [
  65. { "hooks": [ { "type": "command", "command": "python3 ~/.claude/hooks/remind_chair.py", "timeout": 10 } ] }
  66. ],
  67. "PreToolUse": [
  68. {
  69. "matcher": "^(Agent|Task|Edit|Write|MultiEdit|NotebookEdit)$",
  70. "hooks": [ { "type": "command", "command": "python3 ~/.claude/hooks/solo_guard.py", "timeout": 10 } ]
  71. }
  72. ],
  73. "SessionEnd": [
  74. { "hooks": [ { "type": "command", "command": "python3 ~/.claude/hooks/cleanup_session_cache.py", "timeout": 20 } ] }
  75. ]
  76. }
  77. }
  78. ```
  79. 3. Append `instructions/dynamic-workflow-fable.md` to `~/.claude/CLAUDE.md` and copy the playbook to `~/.claude/skills/playbook/SKILL.md`.
  80. Don't run the plugin and the manual install together — every hook would fire twice.
  81. </details>
  82. ## Configuration
  83. Optional, in `~/.claude/settings.json` under `"env"`:
  84. ```
  85. ┌───────────────────────────────┬─────────┬────────────────────────────────────────────┐
  86. │ Env var │ Default │ Meaning │
  87. ├───────────────────────────────┼─────────┼────────────────────────────────────────────┤
  88. │ FABLE_ORCH_SOLO_EDITS │ 3 │ deny at the Nth chair edit; 0 disables │
  89. │ FABLE_ORCH_NAME_CHARS │ 1500 │ spawn prompt size that needs a name; 0 off │
  90. │ FABLE_ORCH_SOLO_GUARD │ (on) │ 0 disables the solo gate entirely │
  91. │ FABLE_ORCH_REMIND │ (on) │ 0 disables the per-prompt line │
  92. │ FABLE_ORCH_PROFILE │ auto │ pin the chair profile: auto | fable | opus │
  93. │ FABLE_ORCH_TEAMMATE_INJECT │ (off) │ 1 injects the profile into teammates too │
  94. │ FABLE_ORCH_METRICS │ (on) │ 0 disables local metrics logging │
  95. │ FABLE_ORCH_SWARM_CLEANUP │ (on) │ 0 disables all teammate reaping │
  96. │ FABLE_ORCH_SWARM_MAX_IDLE_H │ 48 │ sweep swarms idle ≥ N hours; 0 disables │
  97. └───────────────────────────────┴─────────┴────────────────────────────────────────────┘
  98. ```
  99. The profile is picked from, first match wins: `FABLE_ORCH_PROFILE`, the `--model` flag the session was launched with, `model` in `settings.json`. Any model that is not Opus gets the Fable profile.
  100. Metrics (events only, never prompt content) go to `~/.claude/fable-orch/metrics.jsonl`; `python3 scripts/stats.py` prints a summary.
  101. ## Upgrading to v0.17.2
  102. - Effort is capped at `high` for every tier; `xhigh` and `max` are gone.
  103. - The chair is detected from the `--model` launch flag. Move the chair by relaunching, not with `/model`.
  104. - Every spawn must set `model`.
  105. - Python 3.10+ is required.
  106. ## Tests
  107. ```
  108. python3 -m pytest tests/ -q
  109. ```
  110. The hooks run as real subprocesses. `tests/test_e2e_dry_run.py` replays a whole session through `hooks/hooks.json`, as Claude Code runs it.
  111. ## Limitations
  112. - **The solo guard counts edits, not work.** A chair that writes files through `Bash` never trips it.
  113. - **Each gate fires once per session.** A chair can ignore the nudge and carry on.
  114. - **`/model` is invisible to the hooks.** Relaunch with `--model`, or pin `FABLE_ORCH_PROFILE`.
  115. ## License
  116. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.