Skip to content
Back to search

ultimate-orchestration-skills

Multi-agent orchestration skills for Claude Code, Codex & Antigravity — capability-based routing, subscription quota handoffs & cross-family review.

Safety scan

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

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ahmedkececi--ultimate-orchestration-skills/badge.svg)](/listings/ahmedkececi--ultimate-orchestration-skills)

HTML

<a href="/listings/ahmedkececi--ultimate-orchestration-skills"><img src="/api/listings/ahmedkececi--ultimate-orchestration-skills/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.

From your project, choose the command for your client. The Codex and Claude Code commands each copy both coordinator options and the measurement updater. Choose one coordinator when starting a session. To install a single coordinator, omit the other coordinator's `--skill` flag. Add the optional provider skill by appending `--skill add-provider-orchestration-skills`.

# Codex
npx skills add ahmedkececi/ultimate-orchestration-skills --agent codex --copy \
  --skill sol-orchestration --skill astra-orchestration --skill update-orchestration-skills

# Claude Code
npx skills add ahmedkececi/ultimate-orchestration-skills --agent claude-code --copy \
  --skill opus-orchestration --skill fable-orchestration --skill update-orchestration-skills

For Antigravity, another coordinator, or an install without Node.js, clone once and copy the folders into your project (keep the original folder names):

# Manual / Antigravity (replace neon-orchestration or target directory as needed)
(
  set -eu
  install_dir=$(mktemp -d "${TMPDIR:-/tmp}/ultimate-orchestration-skills.XXXXXXXX")
  trap 'rm -rf -- "$install_dir"' 0
  git clone --depth 1 https://github.com/ahmedkececi/ultimate-orchestration-skills.git "$install_dir/repo"
  mkdir -p .agents/skills
  cp -R "$install_dir/repo/skills/neon-orchestration" \
    "$install_dir/repo/skills/update-orchestration-skills" .agents/skills/
)

Each coordinator preset uses progressive disclosure (`SKILL.md` plus on-demand `references/` files to save context tokens), so keep the full folder including `references/` when copying.

[Skills CLI options](https://github.com/vercel-labs/skills#usage)

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.

README.md · README · 387 lines · 4 findings marked
  1. # Ultimate Orchestration Skills
  2. [![CI](https://github.com/ahmedkececi/ultimate-orchestration-skills/actions/workflows/ci.yml/badge.svg)](https://github.com/ahmedkececi/ultimate-orchestration-skills/actions/workflows/ci.yml)
  3. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
  4. [![Clients](https://img.shields.io/badge/Clients-Claude%20Code%20%7C%20Codex%20%7C%20Antigravity-6366f1)](#choose-a-coordinator)
  5. [![Python 3.9+](https://img.shields.io/badge/Python-3.9%2B-3776ab)](#refresh-model-data-on-demand)
  6. [![GitHub Stars](https://img.shields.io/github/stars/ahmedkececi/ultimate-orchestration-skills?style=social)](https://github.com/ahmedkececi/ultimate-orchestration-skills)
  7. [English](#english) · [Türkçe](#türkçe) · [Offline demo](examples/first-run.md) · [Contributing](CONTRIBUTING.md) · [Changelog](CHANGELOG.md)
  8. ## English
  9. **Keep your agents working when a model hits its quota.** Add capability-based routing, quota balancing, independent review and restartable handoffs to Claude Code, Codex or Antigravity. The presets guide your coordinator using the model runners and permissions you configure.
  10. - **Right model for each unit:** Routes every task to the most capable and efficient model across four separate benchmark profiles (coding, reasoning, factual accuracy, knowledge/PDF work) using ±3-point equivalence, latency, input type and permissions.
  11. - **Subscription quota balancing & handoffs:** Balances rolling 5-hour and weekly windows across Claude, ChatGPT/Codex, Gemini/Antigravity and optional DeepSeek API, resuming from `.orchestration/` checkpoints when a window closes.
  12. - **Independent cross-family review:** Verifies deliverables with a fresh reviewer from another model family — without exposing the author's reasoning — and adds an extra verification step whenever a fallback drops a tier.
  13. **What this is & prerequisites:** These are portable Markdown Agent Skills plus zero-dependency Python 3.9+ helper scripts for benchmark tracking — not an MCP server, proxy, or background daemon. You can start with 1–2 authorized model pools and add more subscriptions or APIs later; record your authorized lanes in `.orchestration/project-profile.md`, and any unconfigured lane is skipped in favor of your authorized pools.
  14. [Try the offline benchmark preview](examples/first-run.md#preview-model-data-offline) · [Resolve lanes offline](examples/first-run.md#resolve-lanes-deterministically-offline) · [See a quota handoff](examples/first-run.md#follow-a-quota-handoff)
  15. ### Quick install
  16. From your project, choose the command for your client. The Codex and Claude Code commands each copy both coordinator options and the measurement updater. Choose one coordinator when starting a session. To install a single coordinator, omit the other coordinator's `--skill` flag. Add the optional provider skill by appending `--skill add-provider-orchestration-skills`.
  17. ```sh
  18. # Codex
  19. npx skills add ahmedkececi/ultimate-orchestration-skills --agent codex --copy \
  20. --skill sol-orchestration --skill astra-orchestration --skill update-orchestration-skills
  21. # Claude Code
  22. npx skills add ahmedkececi/ultimate-orchestration-skills --agent claude-code --copy \
  23. --skill opus-orchestration --skill fable-orchestration --skill update-orchestration-skills
  24. ```
  25. For Antigravity, another coordinator, or an install without Node.js, clone once and copy the folders into your project (keep the original folder names):
  26. ```sh
  27. # Manual / Antigravity (replace neon-orchestration or target directory as needed)
  28. (
  29. set -eu
  30. install_dir=$(mktemp -d "${TMPDIR:-/tmp}/ultimate-orchestration-skills.XXXXXXXX")
  31. trap 'rm -rf -- "$install_dir"' 0
  32. git clone --depth 1 https://github.com/ahmedkececi/ultimate-orchestration-skills.git "$install_dir/repo"
  33. mkdir -p .agents/skills
  34. cp -R "$install_dir/repo/skills/neon-orchestration" \
  35. "$install_dir/repo/skills/update-orchestration-skills" .agents/skills/
  36. )
  37. ```
  38. Each coordinator preset uses progressive disclosure (`SKILL.md` plus on-demand `references/` files to save context tokens), so keep the full folder including `references/` when copying.
  39. [Skills CLI options](https://github.com/vercel-labs/skills#usage)
  40. ### How it works
  41. ```mermaid
  42. flowchart LR
  43. C["Coordinator\n(Opus / Sol / Astra / Neon / Mythos/Fable)"] --> R{"Route by task,\npermissions & quota"}
  44. R -->|"Capacity available"| W["Authorized Worker"]
  45. R -->|"Quota window closes"| H["Write Checkpoint\n(.orchestration/)"]
  46. H --> C2["New Coordinator\nresumes from artifact"]
  47. W --> REV["Independent Reviewer\n(other model family)"]
  48. REV -->|"Passes checks"| OK["Accept & Merge"]
  49. REV -->|"Finds issues"| R
  50. ```
  51. ### What makes it different
  52. | Design choice | Why it matters |
  53. | --- | --- |
  54. | Route by the task and the quota pool | A fast implementation model, a reviewer who can check a PDF, and the worker with capacity left may be three different choices. The presets account for difficulty, input type, read/write permissions and available allowance. |
  55. | Compare the profiles that matter | Coding, reasoning, factual accuracy and knowledge work are separate signals. Pick a replacement on the evidence that matters for this unit and compare task times only where they were measured on the same basis. |
  56. | Make reviews independent | Give a fresh reviewer from another model family the artifact and acceptance checks. The coordinator sees both the result and its limits before accepting it. |
  57. | Resume from artifacts | The handoff records ownership, accepted decisions, remaining units and the next check. A new coordinator can pick up from the checkpoint when a quota window closes. |
  58. | Refresh without waiting for a release | The updater verifies model releases and measurements from their sources and refreshes the current workspace. The next routing decision can use that data immediately. |
  59. | Deterministic routing & safety guardrails | Rank authorized models offline with `resolve_lanes.py` from live measurements and quota state, while enforcing `BLOCKER`/`NIT` review circuit breakers (max 2 rounds), hung-lane timeout and compaction recovery, test integrity, and an external action gate (`git push`/publish forbidden for workers). |
  60. ### Why this instead of a framework or proxy?
  61. | Approach | Built for | Trade-off compared to Ultimate Orchestration Skills |
  62. | --- | --- | --- |
  63. | **Agent frameworks** (`LangGraph`, `CrewAI`) | Building custom multi-agent backend apps | Requires SDKs, orchestration code, state storage and API keys instead of working inside your existing Claude Code, Codex or Antigravity CLI sessions. |
  64. | **Local AI gateways / proxies** (`OmniRoute`, `LiteLLM`) | Unifying API keys and OAuth tokens behind a local proxy with HTTP load balancing and `429` failover | Runs a local daemon, redirects CLI traffic through a proxy/token store, and swaps raw HTTP requests reactively on `429` — without preserving each native CLI's tools, proactive subscription thresholds, benchmark-profile routing, cross-family review, or client-to-client checkpoint handoffs. |
  65. | **Hosted API routers** (`OpenRouter`) | Pay-per-token cloud API routing | Optimizes token price on metered API calls rather than rolling 5-hour/weekly subscription allowances, native CLI agents, or cross-family verification. |
  66. | **Single-client subagents** (default `Claude Code` / `Codex`) | Parallel work within one provider pool | Shares one quota pool and usually reviews with the same model family; stalls when that pool hits its cap. |
  67. | **Ultimate Orchestration Skills** | Daily engineering across existing subscriptions | Zero infrastructure, zero proxy, native CLI sessions only; routes each task unit by benchmark profile and proactive quota headroom, verifies cross-family, hands off across clients via files, and refreshes benchmarks live. |
  68. > **How it stands out from open-source local proxies like OmniRoute:**
  69. > - **Zero daemon, zero proxy, zero token vault:** Never runs a local server or SQLite token store and never intercepts CLI OAuth traffic. `claude`, `codex`, and `agy` stay on their official native sign-ins and tool sandboxes.
  70. > - **Task-level orchestration, not HTTP request swapping:** Splits work into owned units with writable-path boundaries and routes each unit across 4 separate benchmark profiles (coding, reasoning, factual accuracy, knowledge/PDF) — instead of blindly rerouting a mid-session HTTP call after a `429`.
  71. > - **Proactive quota balancing & clean client handoffs:** Moves new units *before* exhaustion (85% weekly / 90% 5-hour) and transfers full manager ownership to another client via `.orchestration/orchestration-checkpoint.md` when a window closes.
  72. > - **Independent cross-family review & safety guardrails:** Verifies deliverables with a fresh reviewer from another model family, enforces a 2-round `BLOCKER`/`NIT` circuit breaker and test-integrity checks, blocks workers from external actions (`git push`/publish), and ranks lanes deterministically offline with `resolve_lanes.py` plus live benchmark updates.
  73. ### Choose a coordinator
  74. | Preset | Command | Client & Model | When to pick | Project location |
  75. | --- | --- | --- | --- | --- |
  76. | [Astra](skills/astra-orchestration/) | `$astra-orchestration` | Codex (`gpt-6.2-astra`, medium) | Maximum Codex coordinator reasoning when ChatGPT/Codex allowance is plentiful | `.agents/skills/` |
  77. | [Sol](skills/sol-orchestration/) | `$sol-orchestration` | Codex (`gpt-6.2-sol`, xhigh) | Quota-efficient Codex coordinator (~2.5x lighter on ChatGPT/Codex allowance than Astra) | `.agents/skills/` |
  78. | [Neon](skills/neon-orchestration/) | `/neon-orchestration` | Antigravity (`gemini-4-neon`, high / Orchestrator) | Antigravity main loop with Native Swarm, PDF/media intake and balanced Codex + Claude workers | `.agents/skills/` |
  79. | [Mythos/Fable](skills/fable-orchestration/) | `/fable-orchestration` | Claude Code (`Mythos` or `Fable`) | Frontier Claude coordinator with scarce allowance; offloads routine execution to Codex and Sonnet | `.claude/skills/` |
  80. | [Opus](skills/opus-orchestration/) | `/opus-orchestration` | Claude Code (`Claude Opus 5.5`, high/xhigh) | Everyday Claude Code coordinator, or failover when Mythos/Fable allowance is spent | `.claude/skills/` |
  81. 1. Install the chosen coordinator folder and the [update skill folder](skills/update-orchestration-skills/) into the **Project location** above (via `npx skills add` or the manual copy snippet). Keep all skill folder names unchanged.
  82. 2. Start a chat in your project root using the **Command** column above (`/<folder-name>` in Claude Code or Antigravity, `$<folder-name>` in Codex). On a fresh repository where `.orchestration/` does not exist yet, the coordinator automatically checks which worker CLIs (`claude`, `codex`, `agy`) are installed and signed in, asks which pools you want to enable, helps you install (with your approval) and sign in to any missing or signed-out CLI you want to use, and then creates `.orchestration/project-profile.md` (with its `<!-- orchestration-lanes:v1 -->` block) and `.orchestration/provider-state.json` before starting your task. *(If you prefer manual setup first, copy `project-profile.example.md` from your coordinator folder to `.orchestration/project-profile.md` and reference it from `CLAUDE.md` or `AGENTS.md`.)*
  83. #### What to type in chat
  84. Right after installing, open chat in your project folder and paste the setup prompt for your client — no placeholders to edit and no manual file copying required:
  85. ```text
  86. # Claude Code — first-run setup & CLI readiness
  87. /opus-orchestration Check my installed CLIs (claude, codex, agy) and sign-in status, guide me through installing or signing in to the ones I want to use, set up .orchestration/ if missing, and wait for me to give you a task to delegate.
  88. # Codex — first-run setup & CLI readiness
  89. $sol-orchestration Check my installed CLIs (claude, codex, agy) and sign-in status, guide me through installing or signing in to the ones I want to use, set up .orchestration/ if missing, and wait for me to give you a task to delegate.
  90. # Antigravity — first-run setup & CLI readiness
  91. /neon-orchestration Check my installed CLIs (claude, codex, agy) and sign-in status, guide me through installing or signing in to the ones I want to use, set up .orchestration/ if missing, and wait for me to give you a task to delegate.
  92. # Any client — resume after a quota handoff (swap command for your client)
  93. $sol-orchestration Read .orchestration/orchestration-checkpoint.md and .orchestration/provider-state.json, run git status --short, and continue the remaining units.
  94. ```
  95. <details>
  96. <summary>CLI install &amp; sign-in quick reference (optional — your coordinator also checks these on first run)</summary>
  97. ```sh
  98. # 1. Check installed binaries & sign-in status
  99. command -v claude codex agy
  100. CI=true claude auth status --text
  101. codex login status
  102. agy --help
  103. # 2. Install only the CLIs you plan to use
  104. npm install -g @anthropic-ai/claude-code # Claude Code
  105. npm install -g @openai/codex # Codex
  106. curl -fsSL https://antigravity.google/cli/install.sh | bash # Antigravity (macOS/Linux)
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 140 on GitHub
  107. # Windows PowerShell: irm https://antigravity.google/cli/install.ps1 | iex
  108. # 3. Sign in interactively in your terminal (never paste tokens into chat)
  109. claude # then run /login (or: claude auth login)
  110. codex login # or: codex login --device-auth
  111. agy auth login # or launch: agy (use --no-browser over SSH)
  112. ```
  113. </details>
  114. See more ready-to-paste examples (including setup-only preflight and Turkish prompts) in [examples/first-run.md](examples/first-run.md#what-to-type-in-chat).
  115. ### Refresh model data on demand
  116. Run `/update-orchestration-skills` in Claude Code or Antigravity. In Codex use `$update-orchestration-skills`.
  117. - **No model name:** Lists verified releases newer than the presets' reference models and asks which to add. The update looks up benchmarks and saves data for the models you choose. Incomplete catalog coverage is reported alongside the list.
  118. - **One model name:** For example, `/update-orchestration-skills Claude Opus 4.8` requests just that model (showing that named lookups accept any release date — both backfilling older releases and checking brand-new ones). Its exact model ID and any published scores are verified before saving. You can also ask for a preview or import your own measurements.
  119. For each model and effort, the update checks every raw test from the bundled benchmark suite. The output uses `-` for any test result it could not verify. The command uses the client's live source tools and the included Python 3.9+ helper. It merges verified source observations into `.orchestration/model-measurements.md` in the current workspace. Newly announced models can appear with unknown scores. Comparable observations have source links, a date, model and effort, version or cohort, and a count and range for averaged results. The project's access and routing rules still determine which models can run.
  120. The [historical snapshot](skills/update-orchestration-skills/references/model-measurements.md) combines benchmark scores and profile averages in one Markdown file. The [collection guide](skills/update-orchestration-skills/references/collection.md) describes live lookup and custom imports.
  121. ### Add a provider
  122. Install [add-provider-orchestration-skills](skills/add-provider-orchestration-skills/) alongside the updater. Run `/add-provider-orchestration-skills PROVIDER` in Claude Code or Antigravity, or `$add-provider-orchestration-skills PROVIDER` in Codex. The agent checks the provider's public catalog and how to call its models. It asks which models you want, then looks up the full benchmark suite for your choices. The provider's sources and setup details go in `.orchestration/provider-catalogs.json`. Future catalog checks include that provider. The project profile still controls which runners can receive work.
  123. ### Workspace files, `.gitignore` & FAQ
  124. All runtime artifacts live under `.orchestration/`:
  125. | File | Git status | Purpose |
  126. | --- | --- | --- |
  127. | `.orchestration/project-profile.md` | **Commit** | Authorized runners, data policy, writable paths, budget and verification commands (no secret values) |
  128. | `.orchestration/model-measurements.md` | **Commit** | Verified benchmark snapshot refreshed for this workspace |
  129. | `.orchestration/provider-catalogs.json` | **Commit** | Registered provider catalog sources added via `add-provider-orchestration-skills` |
  130. | `.orchestration/provider-state.json` | **Ignore** | Local account quota readings and reset windows |
  131. | `.orchestration/orchestration-checkpoint.md` | **Ignore** | Active session handoff state |
  132. | `.orchestration/orchestration-ledger.md` | **Ignore** | Sanitized local routing history |
  133. Add the ephemeral local state files to your repository's `.gitignore`:
  134. ```gitignore
  135. # Ephemeral local orchestration state
  136. .orchestration/provider-state.json
  137. .orchestration/orchestration-checkpoint.md
  138. .orchestration/orchestration-ledger.md
  139. ```
  140. **FAQ**
  141. - **Do I need all four model providers?** Start with 1–2 pools and record the permitted model, effort, pool and roles for each worker in `.orchestration/project-profile.md`. Without the authorization block, the offline resolver shows an advisory ranking and leaves its recommendation empty.
  142. - **Can I use metered API keys instead of subscriptions?** Yes. The default thresholds (weekly 85% move / 90% stop; 5-hour 90% move / 95% stop) are tuned for rolling subscription pools, and you can record explicit API spending caps in `.orchestration/project-profile.md`.
  143. - **Why didn't my client detect the skill?** Verify the folder name was kept intact (`sol-orchestration`, `opus-orchestration`, etc.) inside `.claude/skills/` (Claude Code) or `.agents/skills/` (Codex / Antigravity), then start a fresh session.
  144. Client docs [Claude Code](https://code.claude.com/docs/en/skills) · [Codex](https://learn.chatgpt.com/docs/build-skills) · [Antigravity](https://antigravity.google/docs/migration/workflows-to-skills/)
  145. ## Türkçe
  146. **Bir modelin kotası dolduğunda iş devam etsin.** Claude Code, Codex veya Antigravity’de işe göre en verimli modele yönlendirme, kota dengeleme, bağımsız inceleme ve dosyadan devir ekle. Hazır profiller, projene tanımladığın model çalıştırıcılarını ve yetkileri kullanır.
  147. - **Doğru işe en yetenekli ve verimli model:** Her iş birimini dört ayrı ölçüm profiline (kodlama, muhakeme, olgusal doğruluk, bilgi/PDF işi), ±3 puan eşdeğerlik kuralına, süreye, girdi türüne ve yetkilere göre en uygun modele yönlendirir.
  148. - **Abonelik kota dengeleme ve devir:** Claude, ChatGPT/Codex, Gemini/Antigravity ve isteğe bağlı DeepSeek API havuzlarındaki 5 saatlik ve haftalık pencereleri dengeler; pencere dolduğunda `.orchestration/` devir kayıtlarıyla kesintisiz devam eder.
  149. - **Farklı model ailesinden bağımsız doğrulama:** Çıktıyı yazarın gerekçesini göstermeden başka bir model ailesinden yeni bir inceleyiciye doğrulattırır; yedek modelde kademe düşerse otomatik ek doğrulama adımı uygular.
  150. **Bu nedir ve gereksinimler:** Bu depo, bir MCP sunucusu, vekil (proxy) veya arka plan servisi değil; taşınabilir Markdown Agent Skill’leri ile benchmark takibi için sıfır bağımlılıklı Python 3.9+ yardımcı betiklerinden oluşur. 1–2 yetkili model havuzuyla başlayıp daha sonra yeni abonelikler veya API’ler ekleyebilirsin; yetkili hatlarını `.orchestration/project-profile.md` dosyasına kaydettiğinde yapılandırılmamış her hat atlanarak yetkili havuzların kullanılır.
  151. [API anahtarı gerektirmeyen demo](examples/first-run.md#türkçe-kısa-başlangıç) · [Çevrimdışı hat seçimi](examples/first-run.md#resolve-lanes-deterministically-offline) · [Kota devri örneği](examples/first-run.md#follow-a-quota-handoff)
  152. ### Hızlı kurulum
  153. Proje dizininde istemcine uygun komutu seç. Codex ve Claude Code komutları ikişer koordinatör seçeneğini ve ölçüm güncelleyicisini projeye kopyalar. Oturum başında bir koordinatör seç. Tek bir koordinatör kurmak için diğer koordinatörün `--skill` seçeneğini kaldır. Sağlayıcı ekleme skill’ini de kurmak için komutun sonuna `--skill add-provider-orchestration-skills` ekle.
  154. ```sh
  155. # Codex
  156. npx skills add ahmedkececi/ultimate-orchestration-skills --agent codex --copy \
  157. --skill sol-orchestration --skill astra-orchestration --skill update-orchestration-skills
  158. # Claude Code
  159. npx skills add ahmedkececi/ultimate-orchestration-skills --agent claude-code --copy \
  160. --skill opus-orchestration --skill fable-orchestration --skill update-orchestration-skills
  161. ```
  162. Antigravity, farklı bir koordinatör veya Node.js olmadan kurulum için depoyu bir kez klonlayıp ilgili klasörleri projene kopyala (orijinal klasör adlarını koru):
  163. ```sh
  164. # Elle kurulum / Antigravity (neon-orchestration veya hedef dizini ihtiyacına göre değiştir)
  165. (
  166. set -eu
  167. install_dir=$(mktemp -d "${TMPDIR:-/tmp}/ultimate-orchestration-skills.XXXXXXXX")
  168. trap 'rm -rf -- "$install_dir"' 0
  169. git clone --depth 1 https://github.com/ahmedkececi/ultimate-orchestration-skills.git "$install_dir/repo"
  170. mkdir -p .agents/skills
  171. cp -R "$install_dir/repo/skills/neon-orchestration" \
  172. "$install_dir/repo/skills/update-orchestration-skills" .agents/skills/
  173. )
  174. ```
  175. Her koordinatör profili aşamalı yükleme (`SKILL.md` ve bağlam token’larından tasarruf etmek için gerektiğinde yüklenen `references/` dosyaları) kullanır; bu nedenle kopyalarken `references/` dahil klasörün tamamını koru.
  176. [Skills CLI seçenekleri](https://github.com/vercel-labs/skills#usage)
  177. ### Nasıl çalışır?
  178. ```mermaid
  179. flowchart LR
  180. C["Koordinatör\n(Opus / Sol / Astra / Neon / Mythos/Fable)"] --> R{"Görev, yetki ve\nkota kontrolü"}
  181. R -->|"Kota müsait"| W["Yetkili Ajan"]
  182. R -->|"Kota doldu"| H["Devir Kaydı Yaz\n(.orchestration/)"]
  183. H --> C2["Yeni Koordinatör\nkaldığı yerden devam eder"]
  184. W --> REV["Bağımsız İnceleyici\n(farklı model ailesi)"]
  185. REV -->|"Kontroller geçti"| OK["Kabul Et ve Birleştir"]
  186. REV -->|"Eksik bulundu"| R
  187. ```
  188. ### Neyi farklı yapıyor?
  189. | Tasarım tercihi | Ne kazandırır? |
  190. | --- | --- |
  191. | Göreve ve kota havuzuna göre yönlendirme | Hızlı kod yazan model, PDF doğrulayabilen model ve kotası müsait model farklı olabilir. Hazır profiller işin zorluğunu, girdi türünü, okuma ve yazma yetkilerini ve kalan kotayı hesaba katar. |
  192. | İşe uygun ölçümleri karşılaştırma | Kodlama, muhakeme, olgusal doğruluk ve bilgi işi ayrı değerlendirilir. Yedek seçerken göreve uygun ölçümleri kullanır, süreleri yalnızca aynı koşullarda ölçüldüklerinde karşılaştırırsın. |
  193. | Bağımsız inceleme | Başka bir model ailesinden yeni bir inceleyiciye çıktıyı ve kabul ölçütlerini verirsin. Koordinatör işi kabul etmeden önce sonucu ve doğrulamanın sınırlarını görür. |
  194. | Dosyalardan devam etme | Devir kaydı, sorumluları, alınan kararları, kalan işleri ve sıradaki kontrolü içerir. Kota penceresi dolduğunda yeni koordinatör kaldığı yerden devam edebilir. |
  195. | Yeni sürüm beklemeden güncelleme | Yenileme skill’i yeni çıkan modelleri ve ölçümlerini kaynaklarından doğrular. Bir sonraki yönlendirme kararı, çalışma alanındaki güncel veriyi kullanabilir. |
  196. | Deterministik yönlendirme ve güvenlik kuralları | Canlı ölçümler ve kota durumundan `resolve_lanes.py` ile yetkili modelleri çevrimdışı sıralar; `BLOCKER`/`NIT` inceleme devre kesicisini (en fazla 2 tur), zaman aşımı ve sıkıştırma kurtarmasını, test bütünlüğünü ve harici işlem kapısını (ajanlar için `git push`/yayınlama yasak) uygular. |
  197. ### Neden bir framework veya proxy yerine bu?
  198. | Yaklaşım | Ne için tasarlandı | Ultimate Orchestration Skills’e göre farkı |
  199. | --- | --- | --- |
  200. | **Ajan framework’leri** (`LangGraph`, `CrewAI`) | Özel çoklu ajan arka uç uygulamaları yazmak | Mevcut Claude Code, Codex veya Antigravity oturumlarınla doğrudan çalışmak yerine SDK, orkestrasyon kodu, durum veritabanı ve API anahtarı gerektirir. |
  201. | **Yerel AI gateway / proxy’ler** (`OmniRoute`, `LiteLLM`) | API anahtarlarını ve OAuth oturumlarını yerel bir proxy arkasında toplayıp HTTP yük dengeleme ve `429` yedeği sunmak | Yerel bir arka plan servisi/token deposu çalıştırır, CLI trafiğini proxy’den geçirir ve `429` geldiğinde ham HTTP isteğini tepkisel olarak değiştirir; her CLI’ın kendi yerel araçlarını, proaktif abonelik eşiklerini, benchmark profili bazlı yönlendirmeyi, çapraz aile incelemesini veya istemciler arası devir kaydını sağlamaz. |
  202. | **Bulut API yönlendiricileri** (`OpenRouter`) | Token başına ücretli bulut API yönlendirme | Dönen 5 saatlik/haftalık abonelik kotaları, yerel CLI ajanları veya çapraz aile doğrulaması yerine ücretli API çağrılarında token maliyetini optimize eder. |
  203. | **Tek istemcili alt ajanlar** (varsayılan `Claude Code` / `Codex`) | Tek sağlayıcı havuzu içinde paralel çalışma | Tek kota havuzunu paylaşır ve genelde aynı model ailesiyle inceleme yapar; o havuz dolduğunda akış durur. |
  204. | **Ultimate Orchestration Skills** | Mevcut aboneliklerle günlük mühendislik akışı | Sıfır altyapı, sıfır proxy, yalnızca resmî CLI oturumları; her iş birimini benchmark profiline ve proaktif kalan kotaya göre yönlendirir, farklı model ailesiyle doğrular, dosyadan başka istemciye devreder ve benchmark’ları canlı günceller. |
  205. > **OmniRoute gibi açık kaynaklı yerel proxy’lerden nasıl ayrışır?**
  206. > - **Sıfır arka plan servisi, sıfır proxy, sıfır token deposu:** Yerel sunucu veya SQLite token kasası çalıştırmaz, CLI OAuth trafiğini araya girerek yönlendirmez. `claude`, `codex` ve `agy` kendi resmî oturumları ve yerel araç/sandbox ortamlarıyla doğrudan çalışır.
  207. > - **Ham HTTP isteği değiştirme değil, görev düzeyinde orkestrasyon:** `429` hatası gelince oturum ortasında körü körüne API isteği yönlendirmek yerine, işi yazılabilir dosya sınırlarıyla birimlere böler ve her birimi 4 ayrı benchmark profiline (kodlama, muhakeme, olgusal doğruluk, bilgi/PDF) göre en uygun ajana verir.
  208. > - **Proaktif kota dengeleme ve temiz istemci devri:** Kota tükenmeden *önce* yeni birimleri taşır (haftalık %85 / 5 saatlik %90) ve pencere kapandığında koordinatörlüğü `.orchestration/orchestration-checkpoint.md` üzerinden başka bir istemciye kayıpsız devreder.
  209. > - **Farklı model ailesinden bağımsız inceleme ve güvenlik kapıları:** Çıktıyı başka bir model ailesinden taze bir inceleyiciye doğrulattırır, en fazla 2 turluk `BLOCKER`/`NIT` devre kesicisi ve test bütünlüğü kontrolü uygular, ajanların harici işlemlerini (`git push`/yayınlama) engeller ve `resolve_lanes.py` + canlı benchmark güncellemesiyle çevrimdışı deterministik sıralama yapar.
  210. ### Koordinatör seç
  211. | Hazır profil | Komut | İstemci ve Model | Ne zaman seçmeli | Projedeki konumu |
  212. | --- | --- | --- | --- | --- |
  213. | [Astra](skills/astra-orchestration/) | `$astra-orchestration` | Codex (`gpt-6.2-astra`, medium) | ChatGPT/Codex kotası bolken en yüksek Codex koordinatör muhakemesi için | `.agents/skills/` |
  214. | [Sol](skills/sol-orchestration/) | `$sol-orchestration` | Codex (`gpt-6.2-sol`, xhigh) | Kota tasarruflu Codex koordinatörü (ChatGPT/Codex kotasında Astra’dan ~2,5 kat daha hafif) | `.agents/skills/` |
  215. | [Neon](skills/neon-orchestration/) | `/neon-orchestration` | Antigravity (`gemini-4-neon`, high / Orchestrator) | Native Swarm, PDF/medya işleme ve dengeli Codex + Claude ajanlarıyla Antigravity ana döngüsü | `.agents/skills/` |
  216. | [Mythos/Fable](skills/fable-orchestration/) | `/fable-orchestration` | Claude Code (`Mythos` veya `Fable`) | Kısıtlı kotalı en üst düzey Claude koordinatörü; rutin uygulamayı Codex ve Sonnet’e devreder | `.claude/skills/` |
  217. | [Opus](skills/opus-orchestration/) | `/opus-orchestration` | Claude Code (`Claude Opus 5.5`, high/xhigh) | Günlük Claude Code koordinatörü veya Mythos/Fable kotası dolduğunda devralma seçeneği | `.claude/skills/` |
  218. 1. Seçtiğin koordinatör klasörünü ve [yenileme skill’i klasörünü](skills/update-orchestration-skills/) yukarıdaki **Projedeki konumu** dizinine kur (`npx skills add` veya elle kopyalama komutuyla). Tüm skill klasör adlarını olduğu gibi koru.
  219. 2. Proje dizininde istemcini aç ve yukarıdaki **Komut** sütunundaki adla sohbeti başlat (Claude Code ve Antigravity’de `/<klasör-adı>`, Codex’te `$<klasör-adı>`). Çalışma alanında `.orchestration/` henüz yoksa koordinatör durmak yerine önce hangi çalışan CLI’ların (`claude`, `codex`, `agy`) kurulu ve oturum açık olduğunu kontrol eder, hangi havuzları kullanmak istediğini sorar, eksik veya oturumu kapalı olanlar için (onayınla) kurulum ve oturum açma adımlarında seni yönlendirir; ardından `.orchestration/project-profile.md` (JSON yetki bloğuyla) ve `.orchestration/provider-state.json` dosyalarını oluşturup görevine başlar. *(İstersen önceden elle de `project-profile.example.md` dosyasını `.orchestration/project-profile.md` olarak kopyalayıp `CLAUDE.md` veya `AGENTS.md` içinden referans verebilirsin.)*
  220. #### Chate ne yazarak başlarsın?
  221. Kurulumdan hemen sonra yer tutucu düzenlemeye veya elle dosya kopyalamaya gerek kalmadan istemcine uygun başlangıç mesajını doğrudan yapıştırabilirsin:
  222. ```text
  223. # Claude Code — ilk kurulum ve CLI kontrolü
  224. /opus-orchestration Kurulu CLI'ları (claude, codex, agy) ve oturum durumlarını kontrol et, kullanmak istediklerimin kurulumu/oturum açması için beni yönlendir, .orchestration/ henüz yoksa kur; delege etmek için sana görev vermemi bekle.
  225. # Codex — ilk kurulum ve CLI kontrolü
  226. $sol-orchestration Kurulu CLI'ları (claude, codex, agy) ve oturum durumlarını kontrol et, kullanmak istediklerimin kurulumu/oturum açması için beni yönlendir, .orchestration/ henüz yoksa kur; delege etmek için sana görev vermemi bekle.
  227. # Antigravity — ilk kurulum ve CLI kontrolü
  228. /neon-orchestration Kurulu CLI'ları (claude, codex, agy) ve oturum durumlarını kontrol et, kullanmak istediklerimin kurulumu/oturum açması için beni yönlendir, .orchestration/ henüz yoksa kur; delege etmek için sana görev vermemi bekle.
  229. # Kota devri sonrası başka istemciden devam et (komutu istemcine göre değiştir)
  230. $sol-orchestration .orchestration/orchestration-checkpoint.md ve .orchestration/provider-state.json dosyalarını oku, git status --short çalıştır ve kalan iş birimlerinden devam et.
  231. ```
  232. <details>
  233. <summary>CLI kurulum ve oturum açma hızlı başvuru (isteğe bağlı — koordinatör ilk çalıştırmada bunları da kontrol eder)</summary>
  234. ```sh
  235. # 1. Kurulu CLI'ları ve oturum durumunu kontrol et
  236. command -v claude codex agy
  237. CI=true claude auth status --text
  238. codex login status
  239. agy --help
  240. # 2. Yalnızca kullanmak istediğin CLI'ları kur
  241. npm install -g @anthropic-ai/claude-code # Claude Code
  242. npm install -g @openai/codex # Codex
  243. curl -fsSL https://antigravity.google/cli/install.sh | bash # Antigravity (macOS/Linux)
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 327 on GitHub
  244. # Windows PowerShell: irm https://antigravity.google/cli/install.ps1 | iex
  245. # 3. Kendi terminalinde etkileşimli oturum aç (sohbete asla anahtar/token yapıştırma)
  246. claude # ardından /login yaz (veya: claude auth login)
  247. codex login # veya: codex login --device-auth
  248. agy auth login # veya başlat: agy (SSH üzerinde --no-browser kullan)
  249. ```
  250. </details>
  251. Yalnızca kurulum ön kontrolü ve ek örnek komutlar için [examples/first-run.md](examples/first-run.md#chate-ne-yazarak-başlarsın) dosyasına bakabilirsin.
  252. ### Model verilerini istediğin anda yenile
  253. Claude Code veya Antigravity’de `/update-orchestration-skills`, Codex’te `$update-orchestration-skills` yaz.
  254. - **Model adı yoksa:** Hazır profillerdeki referans sürümlerden daha yeni, doğrulanmış modelleri listeler ve hangilerini eklemek istediğini sorar. Sadece seçtiğin modellerin benchmark sonuçlarını araştırır ve kaydeder. Eksik taramalar listede belirtilir.
  255. - **Bir model adı varsa:** Örneğin `/update-orchestration-skills Claude Opus 4.8` yalnızca o modeli arar (ad verilerek yapılan aramalarda tarih sınırı olmadığını — hem eski sürümleri geriye dönük doldurmayı hem de yepyeni modelleri sorgulamayı — gösterir). Tam model kimliğini ve yayımlanmış skorları doğrulayıp kaydeder. Önizleme isteyebilir veya kendi ölçüm verini de içe aktarabilirsin.
  256. Güncelleme, her model ve efor seviyesi için arşivdeki testlerin tamamını arar. Doğrulanamayan test sonuçlarını tabloda `-` ile gösterir. Komut, istemcinin canlı kaynak araçlarını ve paketteki Python 3.9+ yardımcısını kullanır. Doğrulanan ölçümleri çalışma alanındaki `.orchestration/model-measurements.md` dosyasına yazar. Yeni duyurulmuş bir modelin skoru henüz yoksa bu alan bilinmiyor olarak kalır. Karşılaştırılabilir ölçümler kaynak bağlantısı, tarih, model, efor ve ölçüm sürümüyle birlikte gösterilir. Ortalamalarda ölçüm sayısı ve aralığı yer alır. Hangi modellerin kullanılabileceğini projenin yetki ve yönlendirme kuralları belirler.
  257. [Arşiv](skills/update-orchestration-skills/references/model-measurements.md), benchmark skorlarını ve profil ortalamalarını tek Markdown dosyasında birleştirir. [Veri toplama kılavuzu](skills/update-orchestration-skills/references/collection.md) canlı aramayı ve özel veri aktarmayı açıklar.
  258. ### Sağlayıcı ekle
  259. [add-provider-orchestration-skills](skills/add-provider-orchestration-skills/) klasörünü güncelleyicinin yanına kur. Claude Code veya Antigravity’de `/add-provider-orchestration-skills SAĞLAYICI`, Codex’te `$add-provider-orchestration-skills SAĞLAYICI` yaz. Ajan resmî kataloğu ve modellerin nasıl çağrıldığını araştırır. Hangilerini eklemek istediğini sorar, ardından seçtiklerin için benchmark listesinin tamamını kontrol eder. Sağlayıcının kaynaklarını ve kurulum bilgilerini `.orchestration/provider-catalogs.json` dosyasına kaydeder. Sonraki katalog taramaları bu sağlayıcıyı da içerir. Hangi çalıştırıcılara görev verilebileceğini proje profili belirler.
  260. ### Çalışma alanı dosyaları, `.gitignore` ve SSS
  261. Tüm çalışma zamanı dosyaları `.orchestration/` altında tutulur:
  262. | Dosya | Git durumu | Amaç |
  263. | --- | --- | --- |
  264. | `.orchestration/project-profile.md` | **Commit et** | Yetkili çalıştırıcılar, veri politikası, yazılabilir yollar, bütçe ve doğrulama komutları (gizli anahtar değerleri olmadan) |
  265. | `.orchestration/model-measurements.md` | **Commit et** | Bu çalışma alanı için yenilenmiş doğrulanmış benchmark özeti |
  266. | `.orchestration/provider-catalogs.json` | **Commit et** | `add-provider-orchestration-skills` ile kaydedilmiş sağlayıcı katalog kaynakları |
  267. | `.orchestration/provider-state.json` | **Yoksay** | Yerel hesap kota okumaları ve sıfırlanma pencereleri |
  268. | `.orchestration/orchestration-checkpoint.md` | **Yoksay** | Aktif oturum devir kaydı |
  269. | `.orchestration/orchestration-ledger.md` | **Yoksay** | Temizlenmiş yerel yönlendirme geçmişi |
  270. Geçici yerel durum dosyalarını deponun `.gitignore` dosyasına ekle:
  271. ```gitignore
  272. # Geçici yerel orkestrasyon durumu
  273. .orchestration/provider-state.json
  274. .orchestration/orchestration-checkpoint.md
  275. .orchestration/orchestration-ledger.md
  276. ```
  277. **SSS**
  278. - **Dört model sağlayıcısının hepsine ihtiyacım var mı?** 1–2 havuzla başlayabilir, her işçi için izin verdiğin model, efor, havuz ve rolleri `.orchestration/project-profile.md` dosyasına yazabilirsin. Yetki bloğu eksikse çevrimdışı yönlendirici bilgi amaçlı bir sıralama gösterir ve öneri alanını boş bırakır.
  279. - **Abonelik yerine ücretli API anahtarları kullanabilir miyim?** Evet. Varsayılan eşikler (haftalık %85 taşıma / %90 durdurma; 5 saatlik %90 taşıma / %95 durdurma) yenilenen abonelik havuzlarına göre ayarlanmıştır; `.orchestration/project-profile.md` içine açık API harcama sınırları da yazabilirsin.
  280. - **İstemcim skill’i neden görmüyor?** Klasör adının değiştirilmediğini (`sol-orchestration`, `opus-orchestration` vb.) ve Claude Code için `.claude/skills/`, Codex / Antigravity için `.agents/skills/` altında bulunduğunu doğrula, ardından yeni bir oturum başlat.
  281. İstemci belgeleri [Claude Code](https://code.claude.com/docs/en/skills) · [Codex](https://learn.chatgpt.com/docs/build-skills) · [Antigravity](https://antigravity.google/docs/migration/workflows-to-skills/)
  282. ## License · Lisans
  283. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

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