@mmerterden/multi-agent-pipeline 19.1.3 → 20.0.0

package/README.tr.md

@@ -43,12 +43,12 @@ bak, sonra sana uyan satırı uygula:
 node -v; npm -v; command -v node npm npx
 ```
 
-| Gördüğün | Yapılacak |
-|---|---|
-| hiçbiri yok | Node >= 20.11 kur: `brew install node` ya da nodejs.org'dan LTS installer |
-| `node` çalışıyor, `npx` çalışmıyor | `npm i -g @mmerterden/multi-agent-pipeline` sonra `multi-agent-pipeline install --claude` |
-| nvm kurulu ama kabuk görmüyor | `source ~/.nvm/nvm.sh && nvm use --lts`, ya da yeni bir terminal aç |
-| npm çok eski (< 5.2, npx'ten önceki sürümler) | `npm i -g npm@latest`, ya da üstteki global kurulum satırı |
+| Gördüğün                                      | Yapılacak                                                                                 |
+| --------------------------------------------- | ----------------------------------------------------------------------------------------- |
+| hiçbiri yok                                   | Node >= 20.11 kur: `brew install node` ya da nodejs.org'dan LTS installer                 |
+| `node` çalışıyor, `npx` çalışmıyor            | `npm i -g @mmerterden/multi-agent-pipeline` sonra `multi-agent-pipeline install --claude` |
+| nvm kurulu ama kabuk görmüyor                 | `source ~/.nvm/nvm.sh && nvm use --lts`, ya da yeni bir terminal aç                       |
+| npm çok eski (< 5.2, npx'ten önceki sürümler) | `npm i -g npm@latest`, ya da üstteki global kurulum satırı                                |
 
 Ne `npx` ne de global kurulum isteyen yol - klonla ve installer'ı doğrudan çalıştır:
 
@@ -82,7 +82,7 @@ Bir görev çalıştır - girdi tipi otomatik algılanır:
 
 Her girdi aynı kısa intake'ten geçer - **hesap → (repo) → maturity kontrolü → dev-context** - sonra Phase 0'a girer. Bir Jira id'si veya GitHub URL'i hiçbir kod yazılmadan _önce_ çekilir ve maturity-kontrol edilir; serbest-metin bu çekimi atlayıp doğrudan planlamaya geçer. Çoklu-repo görevleri dev-context adımında ekstra repo ekler.
 
-Onayları atlamak için `autopilot` ekle (örn. `/multi-agent:autopilot "PROJ-1234"`). Derinlik de çalışma alanı da artık bayrak değil, koşunun sorduğu iki soru: `/multi-agent` Faz 0'da önce nerede koşacağını (worktree/lokal), sonra ne kadar derin koşacağını (Tam/Kısa) sorar. `--local` ve `:local` ilkini baştan cevaplar.
+Onayları atlamak için `autopilot` ekle (örn. `/multi-agent:autopilot "PROJ-1234"`). Çalışma alanı bayrak değil: koşunun kendi şekli hakkında sorduğu tek soru, Faz 0'da nerede koşacağı - worktree mi, mevcut checkout'un mu. `autopilot` bu soruyu sormadan worktree'ye karar verir.
 
 Sonra `/multi-agent:update` ile güncelle. Kaldırmak için (tokenlar korunur) `npx @mmerterden/multi-agent-pipeline uninstall`.
 
@@ -90,13 +90,12 @@ Sonra `/multi-agent:update` ile güncelle. Kaldırmak için (tokenlar korunur) `
 
 ## Nasıl çalışır
 
-Tek komut en fazla 6 fazı çalıştırır, riskli olanlar arasında bir kapı ile. Faz
-0 geri kalanın şeklini belirleyen iki soru sorar: koşu ne kadar derin olacak
-(Tam mı Kısa mı) ve branch nerede yaşayacak (worktree mi, mevcut checkout'un
-mu):
+Tek komut 6 fazı çalıştırır, riskli olanlar arasında bir kapı ile. Her koşu
+tüm kümeyi taşır; Faz 0'ın şekil hakkında sorduğu tek soru branch'in nerede
+yaşayacağı: worktree mi, mevcut checkout'un mu.
 
 - **0 · Init** - girdiyi ayrıştır (Jira id / GitHub URL / serbest metin), hesap + repo(lar) seç, issue'yu çek, maturity kontrolü yap.
-- **1 · Plan** - stack'i tespit et, codebase'i tara ve analiz dokümanını yaz; sonra onu dosya seviyesinde hedefleri olan görevlere böl ve koda dokunmadan önce **onayın için dur**. Analiz ve planlama 19.0.0'a kadar iki ayrı fazdı; derinlik seçici ikisini hep birlikte atlıyordu, çünkü tek bir karar. Codebase taraması explorer persona'sı üzerinde koşar (Sonnet).
+- **1 · Plan** - stack'i tespit et, codebase'i tara ve analiz dokümanını yaz; sonra onu dosya seviyesinde hedefleri olan görevlere böl ve koda dokunmadan önce **onayın için dur**. Analiz ve planlama 19.0.0'a kadar iki ayrı fazdı; tek bir karar oldukları için tek faz. Codebase taraması explorer persona'sı üzerinde koşar (Sonnet).
 - **2 · Dev** - TDD: başarısız test → kod → yeşil, repo'nun stiline + aktif stack skill'lerine uyarak. Faz kendi kapısında biter: build, lint, test ve sır taraması, **bir kez** koşar. Review eskiden ikinci kez build ediyordu ve aradaki farkı kimse okumuyordu.
 - **3 · Review** - Dev'in ürettiği log'lara karşı **CLI-farkında paralel review** - Claude Code 3 model çalıştırır (Fable + Opus + Sonnet), Copilot CLI 3 (GPT-5.4 + Opus + Sonnet) - ve bir **Fable triage** sadece aksiyon alınabilir bulguları tutar; blocker'lar Phase 2'ye geri döner. Opsiyonel kullanıcı testi burada, bekleme durumunu koruyarak.
 - **4 · Commit/PR** - conventional commit, push (başarılı olmalı), bir PR aç (`Ref: #N`, asla otomatik kapatma).
@@ -137,7 +136,7 @@ Başarısız bir `git fetch` sessizce değil, yüksek sesle bozuluyor: liste lok
 
 ### Çalışma alanı: worktree mi lokal mi
 
-Faz 0 Adım 5b branch'in nerede yaşayacağını sorar. **Worktree** (`.worktrees/{id}/`) mevcut checkout'una dokunmaz; **Lokal** proje kökünde yeni bir branch'te çalışır, bu da Faz 5'i düşürür - kullanıcı-test kapısı değişikliği bir worktree'den checkout eder, ortada worktree yoktur - ve proje kökünün temiz olmasını ister. `/multi-agent:local` ve `--local` bu soruyu baştan cevaplar. Her autopilot girişi sormadan worktree'ye karar verir: gözetimsiz bir koşu nerede duruyorsa oradan commit'leyip push eder, ve bunu senin kendi checkout'unda yapmak tam olarak worktree'nin engellemek için var olduğu şeydir. `:local-autopilot` bunun açık opt-out'u.
+Faz 0 Adım 5b branch'in nerede yaşayacağını sorar. **Worktree** (`.worktrees/{id}/`) mevcut checkout'una dokunmaz; **Lokal** proje kökünde yeni bir branch'te çalışır ve proje kökünün temiz olmasını ister. Bu bir soru, bayrak değil: `:local` komutu da `--local` anahtarı da yok, yani cevap koşunun nasıl yazıldığına gömülmek yerine koşunun içinde görünür. `autopilot` sormadan worktree'ye karar verir: gözetimsiz bir koşu nerede duruyorsa oradan commit'leyip push eder, ve bunu senin kendi checkout'unda yapmak tam olarak worktree'nin engellemek için var olduğu şeydir. Review'ın sonundaki manuel test önerisi de aynı cevabı izler: worktree koşusuna branch'i checkout edip test etmek isteyip istemediği sorulur, lokal koşu zaten o checkout'un içindedir, yani önerilecek bir şey yoktur.
 
 Perde arkasında: her görev kendi **git worktree**'sinde çalışır (ya da lokal seçtiğinde mevcut branch'te), commit'ler **repo'nun origin URL'inden yönlendirilen git kimliğini** kullanır, ve **çoklu-repo** görevleri repo başına worktree artı bir integration build alır. Tokenlar OS keychain'de kalır; hiçbir şey commit edilmez ya da loglanmaz. `/multi-agent:review` mevcut bir GitHub/Bitbucket PR'ını da review edebilir - `file:line`'a bağlı bulgu-başına inline yorumlar + açık bir Approve / Needs-Work durumu.
 
@@ -148,39 +147,23 @@ Bunun arkasındaki disiplin - sınırlı loop'lar, kanıt kapıları, token-büt
 | Mod       | Komut                                | Akış                                                                                                                                                                       |
 | --------- | ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Full      | `/multi-agent "task"`                | Tüm 6 faz, interaktif                                                                                                                                                      |
-| Autopilot | `/multi-agent:autopilot "task"`      | 6 faz (interaktif Test kapısı atlanır), onaysız                                                                                                                            |
-| Local     | `/multi-agent:local "task"`          | İnteraktif Test kapısı hariç tam pipeline, mevcut branch (worktree yok)                                                                                                    |
-| Derinlik  | Faz 0 Adım 7.5'te sorulur            | Full (tüm fazlar) veya Short (Dev → Review → Test → Commit → Report). Komut adı değil - `/multi-agent` ve `:local` sorar, iki autopilot girişi de her zaman Full koşar     |
-| Ship      | `/multi-agent:resume-local`          | Lokal iş üzerinde review→test→commit→report kuyruğunu çalıştır                                                                                                             |
+| Autopilot | `/multi-agent:autopilot "task"`      | Aynı 6 faz, onaysız; çalışma alanı worktree'ye çözülür ve Review içindeki kullanıcı-test kapısı atlanır                                                                                                                            |
 | Audit     | `/multi-agent:design-check`          | Mock-mode vs Figma uygunluğu, yalnızca lokal                                                                                                                               |
 | Audit     | `/multi-agent:testflight-validation` | TestFlight build için pre-submission kapıları: statik archive denetimi → Apple'ın `altool --validate-app`'i → Review-Guidelines kontrolü. Yalnızca doğrular, asla yüklemez |
 
-Koşunun kendisinde ayarlanabilen tek şey derinlik, autopilot ve `--local`; geri kalan her şey kendi komutu. Tam katalog aşağıda.
-### Pipeline derinliği: Tam mı Kısa mı
-
-Derinlik, koşunun kendi şekli hakkında sorduğu tek soru. `/multi-agent` ve `/multi-agent:local` bunu Faz 0 Adım 7.5'te sorar - issue çekildikten ve görev tipi belirlendikten sonra, çünkü öneri onlardan çıkıyor.
-
-- **Tam** hepsini koşar: Analiz kod tabanını okuyup etki alanını çıkarır, Planlama görev kırılımını yazıp onayını bekler, Dev de o plandan çalışır.
-- **Kısa** doğrudan Dev'den başlar: Init → Dev → Review → Test → Commit → Report. Analiz ve Planlama koşmaz; plan kapısı ve analiz dokümanı yoktur, görev listesini Dev issue'dan kendi çıkarır ve takip edecek bir planı olmadığı için Sonnet yerine **Opus** üzerinde koşar. Review, deterministik kapılar ve test paketi aynen kalır - Kısa düşünmeyi atlar, kanıtı değil.
-
-Kısa'yı düzeltmeyi ve dosyayı zaten biliyorsan seç: tek satırlık bir guard, bir metin değişikliği, bir yeniden adlandırma, bir geri alma. Neden hâlâ bir hipotezse, görevde Figma referansı ya da analiz dokümanı varsa (bunları kırılıma çeviren şey Planlama'dır) ya da değişiklik birden fazla repoya yayılıyorsa yanlış seçim olur.
-
-Widget cevabı tahmin etmek yerine takip eder: sen seçmeden önce yalnızca Faz 0 karosu çizilir, Kısa koşu Analiz karosunu hiç çizmez. İki autopilot girişi de bu soruyu sormaz, her zaman Tam koşar. Hangisinin koştuğunu `agent-state.json` `onlyDevelop` alanında tutar.
-
+Koşunun kendisinde ayarlanabilen tek şey autopilot; geri kalan her şey kendi komutu. Tam katalog aşağıda.
 
 ## Komutlar
 
-`/multi-agent` ve 56 alt komut. `/multi-agent:help` aynı katalogu terminalde, `outputLanguage` ayarına göre gösterir.
+`/multi-agent` ve 57 alt komut. `/multi-agent:help` aynı katalogu terminalde, `outputLanguage` ayarına göre gösterir.
 
 ### Pipeline girişleri
 
 | Komut                                 | Ne yapar                                                                                        |
 | ------------------------------------- | ----------------------------------------------------------------------------------------------- |
-| `/multi-agent "task"`                 | Worktree'de tam pipeline. Faz 0'da Full mu Short mu diye sorar                                  |
-| `/multi-agent:local "task"`           | Aynı pipeline, mevcut branch üzerinde, worktree yok                                             |
-| `/multi-agent:autopilot "task"`       | Worktree, onay yok, her zaman Full                                                              |
-| `/multi-agent:local-autopilot "task"` | Mevcut branch, onay yok, her zaman Full                                                         |
-| `/multi-agent:resume-local`           | Lokalde bitmiş iş için pipeline kuyruğu: Review → Build+Test → Commit/PR → Report. Dev fazı yok |
+| `/multi-agent "task"`                 | Pipeline; branch'in nerede yaşayacağını Faz 0 sorar                                             |
+| `/multi-agent:autopilot "task"`       | Aynı pipeline, gözetimsiz: worktree'ye çözülür, onay sorulmaz                                   |
+| `/multi-agent:resume`                 | Yarım kalan iş, iki kaynaktan da: duran koşu kaldığı yerden devam eder, arkasında koşu olmayan branch kuyruğu alır (Review → Build+Test → Commit/PR → Report) |
 
 ### Görev kontrolü
 
@@ -188,7 +171,7 @@ Widget cevabı tahmin etmek yerine takip eder: sen seçmeden önce yalnızca Faz
 | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `/multi-agent:status`               | Her görevin ID'si, fazı, branch'i ve durumu                                                                                                            |
 | `/multi-agent:log [#N]`             | Görevin `agent-log.md` dosyası (varsayılan: en son görev)                                                                                              |
-| `/multi-agent:resume [#N]`          | Durmuş ya da hata almış görevi kaldığı fazdan sürdürür                                                                                                 |
+| `/multi-agent:resume [#N]`          | Durmuş ya da hata almış görevi kaldığı fazdan sürdürür; arkasında koşu olmayan branch için kuyruğu çalıştırır                                            |
 | `/multi-agent:kill [#N]`            | Görevi durdurur, worktree'sini ve branch'ini siler                                                                                                     |
 | `/multi-agent:steer #N "<talimat>"` | Koşan bir görevi durdurmadan düzeltir; talimat bir sonraki faz sınırında uygulanır                                                                     |
 | `/multi-agent:search`               | Tüm görev loglarında sıralamalı arama; `--semantic` triyaj corpus'unu sorgular                                                                         |
@@ -282,11 +265,37 @@ Yukarıdaki her şey sen başlattığında başlar. Sürekli mod, aynı pipeline
 **senin seçtiğin tek makinede**, **senin seçtiğin repolardan** işi kendi başına
 alması.
 
-| Komut | Ne yapar |
-| --- | --- |
-| `/multi-agent:autopilot-on` | Bu makinenin izleyeceği repoları seçersin. Etiketli GitHub issue'ları ve sana atanmış + etiketli Jira maddeleri worktree'de koşar, açık PR'da durur. Listeyi değiştirmek için tekrar çalıştır |
-| `/multi-agent:autopilot-status` | Ne koşuyor hangi fazda, sırada ne var, ne cevap bekliyor, son bir günün PR'ları ve yuvarlanan harcama |
-| `/multi-agent:autopilot-off` | Zamanlamayı kaldırır. Koşan iş biter; repo seçimi saklanır |
+| Komut                           | Ne yapar                                                                                                                                                                                      |
+| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `/multi-agent:autopilot-on`     | Bu makinenin izleyeceği repoları seçersin. Etiketli GitHub issue'ları ve sana atanmış + etiketli Jira maddeleri worktree'de koşar, açık PR'da durur. Listeyi değiştirmek için tekrar çalıştır |
+| `/multi-agent:autopilot-status` | Ne koşuyor hangi fazda, sırada ne var, ne cevap bekliyor, son bir günün PR'ları ve yuvarlanan harcama                                                                                         |
+| `/multi-agent:autopilot-off`    | Zamanlamayı kaldırır. Koşan iş biter; repo seçimi saklanır                                                                                                                                    |
+
+## Hangi model cevaplıyor
+
+Merdiven `fable -> opus -> sonnet -> haiku`; koşu başarısızlıkta merdiveni iner.
+Yönlendirme basamağı çağrı yeri başına bir politikaya seçtirir ve sen açana
+kadar kapalıdır.
+
+| Komut                       | Ne yapar                                                                                                                                                        |
+| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `/multi-agent:route-on`     | Strateji, kapsam ve hangi çağrının hangi basamağa düşeceğini söyleyen kuralları sorar. Hiçbir şey yazılmadan önce `route-config.schema.json`'a karşı doğrulanır |
+| `/multi-agent:route-off`    | Kapatır. Kurallar SAKLANIR, tekrar açıldığında aynı yapılandırma yeniden sorulmaz                                                                               |
+| `/multi-agent:route-status` | Açık mı, hangi kural nerede geçerli, son çağrılar hangi basamağa gitti, bu koşu ne tuttu                                                                        |
+| `/multi-agent:model`        | Üst basamağı açıp kapatır ve maliyet defterinin fiyatlamasını aynı adımda onunla taşır                                                                          |
+
+**Kapsam oturumun tamamı olamaz.** `scope` yalnız `subagent`, `bulk-read` ve
+`research` kabul eder; `host-session` diye bir değer yoktur ve bu bir teamül
+değil, şema kapısıdır. Host'un base URL'ini sahiplenmek, bu pipeline'la ilgisi
+olmayan işler dahil yaptığın her çağrıyı üçüncü bir katmandan geçirirdi.
+
+**Dürüst sınır, ve `route-status` bunu gizlemek yerine yazar.** Anthropic
+dışı bir sağlayıcıdaki basamak dağıtımda reddedilir. Hiçbir çağrı yeri model
+isteğini kendisi atmıyor: yönlendirilen tek yer olan `bulk-read.sh` işi `claude`
+CLI'ına devrediyor, o da yalnız bu merdiveni konuşuyor. Bir okumayı üçüncü bir
+sağlayıcıya göndermek ayrıca dosyanın tam metnini onu sahiplenen hesabın dışına
+çıkarırdı; bu yüzden varsayılan değil, kullanıcının verdiği bir karardır.
+Yönlendirme merdivenin içinde seçim yapar.
 
 **Varsayılan olarak hiçbir şey açık değil ve hiçbir repo kendiliğinden eklenmez.**
 Paketi kurmak ne durum yazar ne zamanlama kurar; bu bir gün değişirse
@@ -305,7 +314,7 @@ PR sayısına tavan yok; sınırlar 24 saatlik yuvarlanan `costCeilingUsd` ve
 makinenin kapasitesi.
 
 **`swiftc` varsa menü çubuğu göstergesi** aynı `status.json`'ı sağ üstte çizer ve
-kendi kendine tazelenir: madde başına tek satır - id, Full ya da Short, kesir
+kendi kendine tazelenir: madde başına tek satır - id, kesir
 olarak faz, geçen süre, stack. Madde biter bitmez satır kaybolur ve PR'ıyla
 Raporlar altında görünür. Yalnızca **çizer**; bir koşuyu başlatamaz, durduramaz,
 değiştiremez. ActivityKit macOS'ta yok, o yüzden bu bir `NSStatusItem` ve
@@ -341,17 +350,17 @@ Bu, ilgili plugin'i (+ ortak `ai-common` plugin'ini) repo'nun `.claude/settings.
 
 ## Araç desteği
 
-Pipeline **Claude Code**, **Copilot CLI** ve **Codex CLI** üzerinde native çalışır - üçü de aynı `pipeline/` kaynağından kurulur ve aynı 60 komutu alır.
+Pipeline **Claude Code**, **Copilot CLI** ve **Codex CLI** üzerinde native çalışır - üçü de aynı `pipeline/` kaynağından kurulur ve aynı 57 komutu alır.
 
 | Araç        | Bayrak                  | Ne kurar                                                                                                         |
 | ----------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------- |
 | Claude Code | `--claude` (varsayılan) | slash komutları + skill'ler + agent'lar + üç `PreToolUse` hook'u (secret scan, agent-guard, okuma-boyutu geçidi) |
-| Copilot CLI | `--copilot`             | talimatlar + 60 alt-komut skill'i + script'ler                                                                   |
-| Codex CLI   | `--codex`               | bir router skill + ref olarak 60 spec + 9 agent TOML + `AGENTS.md` bloğu + `codex mcp add`                       |
+| Copilot CLI | `--copilot`             | talimatlar + 57 alt-komut skill'i + script'ler                                                                   |
+| Codex CLI   | `--codex`               | bir router skill + ref olarak 57 spec + 9 agent TOML + `AGENTS.md` bloğu + `codex mcp add`                       |
 
 Skill'leri stack'e göre filtrele: `--platform=ios\|android\|all`.
 
-**Codex neden 60 değil de tek bir skill alıyor.** Codex, keşfettiği her skill'in adını
+**Codex neden 57 değil de tek bir skill alıyor.** Codex, keşfettiği her skill'in adını
 ve açıklamasını tek bir prompt bloğuna toplar ve blok taştığında girdileri hatasızca
 düşürür. 0.145 üzerinde ölçüldü: 142 skill deklare eden bir plugin kurulduğunda sadece
 75'i yüzeye çıktı ve alakasız bir kullanıcı skill'i tahliye edildi. Bu yüzden Codex'te

package/docs/adr/0002-instruction-driven-flag.md

@@ -1,6 +1,7 @@
 # 2. `instructionDriven` flag as explicit pipeline fork
 
 **Status:** Accepted · 2025
+
 > **Phase numbers below are the eight-phase ones.** [ADR-0014](./0014-six-phase-consolidation.md) renumbered the contract in v19.0.0 (Phase 6 Commit is now Phase 4, Phase 7 Report is now Phase 5). The decision this ADR records is unchanged; only the labels moved, and they are left as written because an ADR records what was decided.
 
 ## Context
@@ -27,11 +28,11 @@ phases that need to fork read this flag.
 Phase 6 uses a **deterministic truth table** (documented at
 `phase-6-commit.md:25`) to dispatch:
 
-| `instructionDriven` | `instructionFiles.commit` exists | Action |
-| ------------------- | -------------------------------- | ------ |
-| true  | yes | Instruction-driven path |
-| true  | no  | Log error, set `instructionDrivenFallback=true`, use standard path |
-| false | -   | Standard path |
+| `instructionDriven` | `instructionFiles.commit` exists | Action                                                             |
+| ------------------- | -------------------------------- | ------------------------------------------------------------------ |
+| true                | yes                              | Instruction-driven path                                            |
+| true                | no                               | Log error, set `instructionDrivenFallback=true`, use standard path |
+| false               | -                                | Standard path                                                      |
 
 ## Consequences
 

package/docs/adr/0005-lazy-phase-docs.md

@@ -27,10 +27,10 @@ Current budgets (v3.5.0):
 
 - Phase 0: warn 3500 / max 4000 (INIT is interactive + token-heavy)
 - Phase 1: warn 1200 / max 1500
-- Phase 2: warn  800 / max 1000
+- Phase 2: warn 800 / max 1000
 - Phase 3: warn 1500 / max 1800
 - Phase 4: warn 1800 / max 2200 (triage + 3-model review is verbose)
-- Phase 5: warn  600 / max  800
+- Phase 5: warn 600 / max 800
 - Phase 6: warn 2400 / max 2800 (commit + PR + issue body update)
 - Phase 7: warn 1800 / max 2200
 

package/docs/adr/0008-installer-modularization-and-secret-leak-defense.md

@@ -1,6 +1,7 @@
 # 8. Installer modularization + secret-leak defense
 
 **Status:** Accepted · 2026-04-27 (v8.0.0)
+
 > **Phase numbers below are the eight-phase ones.** [ADR-0014](./0014-six-phase-consolidation.md) renumbered the contract in v19.0.0 (the producer/consumer phase docs it names were renumbered). The decision this ADR records is unchanged; only the labels moved, and they are left as written because an ADR records what was decided.
 
 > **Amended v10.7.0:** the `_adapters.mjs` module and its third-party adapter dispatch were removed when the pipeline narrowed to Claude Code + Copilot CLI (see ADR 0007). `install/` now ships **8** modules, not 9; the module list below records the v8.0.0 decision as it shipped at the time.

package/docs/adr/0009-claude-stack-skills-plugin-only.md

@@ -9,7 +9,7 @@ ADR-0006 split the source tree into `shared/core/` + `shared/external/` but kept
 That left Claude Code receiving every stack skill **twice**:
 
 - 110 of 157 local skill dirs duplicated the enabled plugins byte-for-byte - ~10k tokens of duplicate descriptions per session, 4.4 MB on disk.
-- The local copy shadowed the plugin the moment it went stale, and it *was* stale in practice: the plugin cache and the local copy advanced on different schedules.
+- The local copy shadowed the plugin the moment it went stale, and it _was_ stale in practice: the plugin cache and the local copy advanced on different schedules.
 - The duplication hid real bugs: `skill-conformance.mjs` and `match-skills.mjs` only knew the local root, so they kept working by accident - against the stale copy.
 
 ## Decision

package/docs/adr/0010-own-code-graph.md

@@ -1,6 +1,7 @@
 # 10. Our own code graph, not a forked one
 
 **Status:** Accepted · 2026-08-28
+
 > **Phase numbers below are the eight-phase ones.** [ADR-0014](./0014-six-phase-consolidation.md) renumbered the contract in v19.0.0 (`phase-1-analysis.md` is now `phase-1-plan.md` and Phase 7 Report is now Phase 5). The decision this ADR records is unchanged; only the labels moved, and they are left as written because an ADR records what was decided.
 
 ## Context
@@ -85,10 +86,10 @@ a repo whose files are not in the page cache costs more: the first build of the
 30,000-token retrieval budget, ground truth derived by grep and path match so
 that the impact family is stacked against the graph on purpose.
 
-| Arm | Coverage | Tokens/question |
-|---|---|---|
-| grep + read | 66.0% | 24,555 |
-| code graph | 80.4% | 18,465 |
+| Arm         | Coverage | Tokens/question |
+| ----------- | -------- | --------------- |
+| grep + read | 66.0%    | 24,555          |
+| code graph  | 80.4%    | 18,465          |
 
 The aggregate passes the gate, but the split is the useful part. On questions
 naming an exact type, `grep -lw` is the oracle: it scored 100% and the graph

package/docs/adr/0012-macos-only.md

@@ -50,7 +50,7 @@ constructs look like cross-platform scaffolding and are load-bearing on macOS:
 
 1. `smoke-shell-portability.sh`'s `grep -P` ban. BSD grep has no `-P`, exits 2,
    and with `2>/dev/null` that reads as "found nothing". Two gates already
-   shipped green on macOS for exactly this reason. The rule is *more* relevant
+   shipped green on macOS for exactly this reason. The rule is _more_ relevant
    after this ADR, not less; only its header changes, from "supports macOS,
    Linux and Windows" to "the runtime is BSD userland and bash 3.2".
 2. The `sha256sum || shasum` ordering in seven scripts. The gate fails a file
@@ -63,7 +63,7 @@ constructs look like cross-platform scaffolding and are load-bearing on macOS:
    Together they are what keeps macOS writes on `security -i`, with the secret
    on stdin and never on argv. Simplifying one without the other silently moves
    the write onto the delegate.
-5. `github-ssh-setup.sh`'s Darwin arm. `UseKeychain yes` *is* the macOS
+5. `github-ssh-setup.sh`'s Darwin arm. `UseKeychain yes` _is_ the macOS
    behaviour; the other arm is an empty string.
 6. The `stat -c ... || stat -f ...` chains. GNU-first ordering is required
    because `stat -f` is a valid GNU flag (`--file-system`) that succeeds.

package/docs/adr/0013-lsp-code-intelligence.md

@@ -25,8 +25,8 @@ and answers exactly those questions.
 
 `swiftlens/swiftlens` demonstrated the idea as an MCP server. It could not be
 used: its licence is the "SwiftLens Non-Commercial Use License 1.0", which
-prohibits *"Use by a company or organization for internal development or
-production"*, and the repository has been archived since 2025-07-17. The
+prohibits _"Use by a company or organization for internal development or
+production"_, and the repository has been archived since 2025-07-17. The
 underlying technology is unencumbered - SourceKit-LSP is Apple's, Apache-2.0.
 
 ## Decision

package/docs/adr/0014-six-phase-consolidation.md

@@ -1,6 +1,6 @@
 # 14. Six phases, because two of the eight were doing the same work twice
 
-**Status:** Accepted · 2026-09-18 · amends [ADR-0005](./0005-lazy-phase-docs.md)
+**Status:** Accepted · 2026-09-18 · amends [ADR-0005](./0005-lazy-phase-docs.md) · amended by [ADR-0015](./0015-one-pipeline-no-depth-answer.md)
 
 Three further ADRs carry the old numbers in their bodies and now carry a pointer
 back here instead of being rewritten: [ADR-0002](./0002-instruction-driven-flag.md)
@@ -39,14 +39,14 @@ left the whole tree stale and the suite would have stayed green.
 
 Six phases. The mapping:
 
-| Was | Is | Name | What changed |
-|---|---|---|---|
-| 0 Init | **0** | Init | Nothing |
-| 1 Analysis + 2 Planning | **1** | Plan | One doc, one exit gate |
-| 3 Dev + 4 Review Stage 1 | **2** | Dev | Verify became Dev's exit gate; the build runs once |
-| 4 Review (Stage 2-3) + 5 Test | **3** | Review | The user test moved inside Review |
-| 6 Commit | **4** | Commit | Nothing |
-| 7 Report | **5** | Report | Nothing |
+| Was                           | Is    | Name   | What changed                                       |
+| ----------------------------- | ----- | ------ | -------------------------------------------------- |
+| 0 Init                        | **0** | Init   | Nothing                                            |
+| 1 Analysis + 2 Planning       | **1** | Plan   | One doc, one exit gate                             |
+| 3 Dev + 4 Review Stage 1      | **2** | Dev    | Verify became Dev's exit gate; the build runs once |
+| 4 Review (Stage 2-3) + 5 Test | **3** | Review | The user test moved inside Review                  |
+| 6 Commit                      | **4** | Commit | Nothing                                            |
+| 7 Report                      | **5** | Report | Nothing                                            |
 
 Analysis folds into Plan rather than into Init because of the token budget,
 not preference. Init is 733 lines with a 13,400-token ceiling, already the

package/docs/adr/0015-one-pipeline-no-depth-answer.md

@@ -0,0 +1,83 @@
+# 15. One pipeline: the depth question is removed
+
+**Status:** Accepted · 2026-09-21 · amends [ADR-0014](./0014-six-phase-consolidation.md) · extended by [ADR-0016](./0016-the-run-shape-is-asked-not-typed.md)
+
+## Context
+
+Two selectors decided how much work a run did, and neither read evidence.
+
+`analysisPhase.mode` chose between a full analysis document and a Lite one
+whose section list was fixed: seven sections regardless of what the feature
+carried. v19.0.0 removed it, because Locked 2 already decides section presence
+from evidence and a fixed list can only disagree with it - dropping a section a
+feature needed, keeping one it did not.
+
+`state.onlyDevelop` did the same thing one level up. A Phase 0 Step 7.5 picker
+asked Full or Short before the run had read anything, and Short skipped the plan
+phase outright. The question arrived after `taskType` and before any analysis,
+so the answer was a guess about work not yet examined, and it recommended itself
+from `taskType` alone: `bugfix` and `chore` were told to answer Short.
+
+The cost of keeping it was not only the branch. Phase 2 carried a second
+contract for Short runs - a different model, a different task source, five of
+its nine steps recorded `not-applicable` - and the tracker deferred half its
+tile registration to Step 7.5 because the phase set was unknown until the
+question was answered. One pipeline had two shapes, and only one of them was
+exercised by the documents that describe it.
+
+## Decision
+
+There is one pipeline. Every mode runs its whole phase set, and the set is a
+property of the command, known before the tracker boots.
+
+- The Step 7.5 depth question is gone, and with it `state.onlyDevelop`.
+- Phase 1 always runs. What it produces scales with the evidence the task
+  carries: the Locked 2 omission rule already drops a section with nothing
+  behind it, so a one-line chore yields a short document rather than a skipped
+  phase.
+- The Plan Approval Gate has exactly one skip left, `autopilot`, and it is a
+  skip because there is nobody to ask - not because the run is a lighter kind
+  of run.
+- Tracker registration is a single batch at Step -1. Nothing is deferred,
+  because no answer later in the run can add or remove a phase.
+- Phase 2 reads the analysis document in steps 1, 2, 3, 5 and 6. A step whose
+  section is absent records `not-applicable (no <section> in this document)`
+  instead of aborting, which is the same rule the document's own omission rule
+  produces.
+
+Two gates hold the line, and both assert the ABSENCE: `smoke-pipeline-surface.sh`
+fails if `phase-0-init` grows a depth step or writes a depth key, or if any of
+the four downstream readers reads one; `smoke-plan-approval-gate.sh` fails if
+the gate's scope clause widens past autopilot.
+
+## Consequences
+
+- **Breaking.** `state.onlyDevelop` is removed from the state schema, which has
+  `additionalProperties: false`, so a state file written before v20 no longer
+  validates. The floor is raised with `dist-tags.required` rather than a
+  migration: a run below the floor halts instead of reading a record written
+  under a contract that no longer exists.
+- Every run now produces an analysis document. For a one-line change that
+  document is short, and it is the thing Phase 2 steps 1, 2, 3, 5 and 6 read;
+  before, those steps had no input at all on a Short run and recorded
+  `not-applicable` for a reason that was a mode rather than a measurement.
+- The fastest path is no longer "answer Short". It is answering the Phase 0
+  workspace question with `local`, which changes where the work happens rather
+  than how much of the pipeline runs.
+- `gen-mode-dispatch.mjs` loses its deferred-registration branch, and every
+  generated tracker section shrinks to one registration loop.
+
+## Alternatives
+
+**Keep Short but derive it from evidence.** A run would have to read the
+codebase before deciding whether to read the codebase. The measurement that
+would justify skipping Phase 1 is the one Phase 1 makes.
+
+**Keep the question and make Phase 1 cheap on a Short run.** That is Phase 1
+running, with a second name. If the phase is cheap when there is little to say,
+the question buys nothing; if it is not, the question is a way to avoid work the
+review phase then has no record of.
+
+**Keep the key, stop writing it.** A reader left behind keeps a dead branch
+alive and invites the question back to feed it. The gates assert the key's
+absence for that reason, not merely the picker's.

package/docs/adr/0016-the-run-shape-is-asked-not-typed.md

@@ -0,0 +1,69 @@
+# 16. The shape of a run is asked, not typed into its name
+
+**Status:** Accepted · 2026-09-21 · extends [ADR-0015](./0015-one-pipeline-no-depth-answer.md)
+
+## Context
+
+ADR-0015 removed the depth answer, leaving one pipeline. Three command names
+still encoded a decision the run was able to ask about:
+
+- `/multi-agent:local` and `/multi-agent:local-autopilot` answered "where does
+  the branch live" before the run started. Phase 0 Step 5b asks the same
+  question, so the same answer had two entry points and the command names were
+  the one that never appeared in the run's own record: `workspaceSource` could
+  say `command`, and nothing downstream could tell which command.
+- `/multi-agent:resume-local` named the *kind* of unfinished work rather than
+  the work. A user who had stopped a run and a user who had hand-written a
+  change both wanted to continue; they had to know which of two commands
+  described their situation before they could ask for help with it.
+
+Each name also multiplied surface: two more command directories, two more
+Copilot mirrors, two more rows in seven gated inventories, and a preference
+block (`global.resumeLocal`) named after a command.
+
+## Decision
+
+The workspace question is asked at Phase 0 Step 5b and nowhere else. The
+`:local` and `:local-autopilot` commands are removed along with the `--local`
+flag. `autopilot` resolves the workspace to a worktree without asking, because
+an unattended run commits and pushes from wherever it stands.
+
+`:resume-local` folds into `/multi-agent:resume`, which now builds a list from
+both sources - tracked runs that stopped, and the current branch when it
+carries work no run produced - and asks which one to pick up. The tail path
+(Review → Commit → Report, no Plan and no Dev) is unchanged; only its entry
+point moved. `global.resumeLocal` becomes `global.resume` under preferences
+schema 2.8.0, carrying the `autoFix` value across.
+
+Command inventory: 60 → 57.
+
+## Consequences
+
+- A run's shape is visible in the run. `workspaceSource` and the Step 5b
+  answer are the record, and there is no second way to set them.
+- One fewer thing to know before asking. `/multi-agent:resume` with no argument
+  is a complete request; the list answers the question the command names used
+  to ask of the user.
+- The manual-test offer at the end of Review follows the workspace answer
+  rather than a command name: a worktree run is asked whether to check the
+  branch out and test it, a local run already is that checkout.
+- `phases.json` modes lose their `local` flag, since no mode sets it. The
+  generated dispatch blocks are byte-identical, so the drift gate holds.
+- Old names stay in `COMMAND_RENAMES`, so a snapshot naming them still
+  resolves and the removal cannot happen silently in a later release.
+
+## Alternatives
+
+**Keep the commands as aliases.** An alias that answers a question the run also
+asks is the exact shape this ADR removes; two paths to one answer is what made
+`workspaceSource: "command"` unreadable.
+
+**Keep `:resume-local` and have `:resume` delegate.** The user still has to
+know which situation they are in to pick a verb, which is the cost being paid.
+
+**Rename `:resume-local` to something clearer.** Any name still forces the
+distinction at typing time, and the run can see the difference by looking.
+
+**Leave `global.resumeLocal` alone.** A preference named after a command that
+no longer exists is a name nobody can resolve from the code; the migration is
+one hop and carries the value.

package/docs/adr/README.md

@@ -8,22 +8,24 @@ Format: lightly adapted from [Michael Nygard's ADR template](https://cognitect.c
 
 ## Index
 
-| # | Title | Status |
-|---|-------|--------|
-| [0001](./0001-three-model-triage.md)   | CLI-aware parallel review with top-tier triage      | Accepted (amended v5.2.2, v10.6.0 Fable) |
-| [0002](./0002-instruction-driven-flag.md) | instructionDriven flag as explicit pipeline fork  | Accepted |
-| [0003](./0003-unified-shared-skills.md) | Unified `skills/shared/` for Claude Code + Copilot | Accepted (amended v5.3.3) |
-| [0004](./0004-zero-dependency-philosophy.md) | Keep the package zero-runtime-deps                | Accepted |
-| [0005](./0005-lazy-phase-docs.md)      | Lazy-loaded phase docs with per-phase token budget | Accepted (amended by 0014: eight phase docs became six) |
-| [0006](./0006-skills-core-external-split.md) | `shared/core/` vs `shared/external/` source org    | Accepted |
-| [0007](./0007-multi-tool-adapter-framework.md) | Multi-tool adapter framework + token-preserving uninstall | Superseded by v10.7.0 (adapters removed; Claude Code + Copilot CLI only) |
-| [0008](./0008-installer-modularization-and-secret-leak-defense.md) | Installer modularization + secret-leak defense | Accepted (amended v10.7.0: adapter module removed) |
-| [0009](./0009-claude-stack-skills-plugin-only.md) | Claude Code stack skills are plugin-only; local copy retired | Accepted (supersedes ADR-0006 install-destination clause) |
-| [0010](./0010-own-code-graph.md) | Own code graph, referenced from graphify, not forked | Accepted |
-| [0011](./0011-dormant-ci.md) | CI dormant in-repo; pre-push gate is primary | Accepted |
-| [0012](./0012-macos-only.md) | macOS only; Linux and Windows support removed | Accepted |
-| [0013](./0013-lsp-code-intelligence.md) | A language server for the answers regex cannot give | Accepted |
-| [0014](./0014-six-phase-consolidation.md) | Six phases, because two of the eight were doing the same work twice | Accepted |
+| #                                                                  | Title                                                               | Status                                                                   |
+| ------------------------------------------------------------------ | ------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| [0001](./0001-three-model-triage.md)                               | CLI-aware parallel review with top-tier triage                      | Accepted (amended v5.2.2, v10.6.0 Fable)                                 |
+| [0002](./0002-instruction-driven-flag.md)                          | instructionDriven flag as explicit pipeline fork                    | Accepted                                                                 |
+| [0003](./0003-unified-shared-skills.md)                            | Unified `skills/shared/` for Claude Code + Copilot                  | Accepted (amended v5.3.3)                                                |
+| [0004](./0004-zero-dependency-philosophy.md)                       | Keep the package zero-runtime-deps                                  | Accepted                                                                 |
+| [0005](./0005-lazy-phase-docs.md)                                  | Lazy-loaded phase docs with per-phase token budget                  | Accepted (amended by 0014: eight phase docs became six)                  |
+| [0006](./0006-skills-core-external-split.md)                       | `shared/core/` vs `shared/external/` source org                     | Accepted                                                                 |
+| [0007](./0007-multi-tool-adapter-framework.md)                     | Multi-tool adapter framework + token-preserving uninstall           | Superseded by v10.7.0 (adapters removed; Claude Code + Copilot CLI only) |
+| [0008](./0008-installer-modularization-and-secret-leak-defense.md) | Installer modularization + secret-leak defense                      | Accepted (amended v10.7.0: adapter module removed)                       |
+| [0009](./0009-claude-stack-skills-plugin-only.md)                  | Claude Code stack skills are plugin-only; local copy retired        | Accepted (supersedes ADR-0006 install-destination clause)                |
+| [0010](./0010-own-code-graph.md)                                   | Own code graph, referenced from graphify, not forked                | Accepted                                                                 |
+| [0011](./0011-dormant-ci.md)                                       | CI dormant in-repo; pre-push gate is primary                        | Accepted                                                                 |
+| [0012](./0012-macos-only.md)                                       | macOS only; Linux and Windows support removed                       | Accepted                                                                 |
+| [0013](./0013-lsp-code-intelligence.md)                            | A language server for the answers regex cannot give                 | Accepted                                                                 |
+| [0014](./0014-six-phase-consolidation.md)                          | Six phases, because two of the eight were doing the same work twice | Accepted (amended by 0015: the depth answer is removed)                  |
+| [0015](./0015-one-pipeline-no-depth-answer.md)                     | One pipeline: the depth question is removed                         | Accepted (extended by 0016: the workspace and resume names go too)       |
+| [0016](./0016-the-run-shape-is-asked-not-typed.md)                  | The shape of a run is asked, not typed into its name                | Accepted                                                                 |
 
 ## Writing a New ADR
 

package/docs/architecture.md

@@ -113,7 +113,7 @@ graph TB
     end
 
     subgraph "Pipeline Specs"
-        CMD[commands/<br/>60 command files]
+        CMD[commands/<br/>57 command files]
         AGT[agents/<br/>8 agent personas]
         RUL[rules/<br/>12 domain rules]
         PHS[multi-agent-refs/phases/<br/>phase specs + contracts]
@@ -169,7 +169,7 @@ revisions of this diagram - Codex CLI and the two independently-shipped repos
 graph TD
     CC["Claude Code<br/>(source of truth)"]
     COP["Copilot CLI<br/>(instructions + 56 skills)"]
-    COD["Codex CLI<br/>(1 router skill + 60 refs)"]
+    COD["Codex CLI<br/>(1 router skill + 57 refs)"]
     REPO["Pipeline Repo<br/>(npm package)"]
     WEB["Website"]
     PLUGREPO["multi-agent-plugins<br/>(5 stack plugins, own repo)"]