@mmerterden/multi-agent-pipeline 20.2.0 → 20.3.0

package/README.tr.md

@@ -17,7 +17,7 @@ Claude Code, Copilot CLI ve Codex CLI üzerinde native çalışır. Yalnızca ma
 ### Önkoşullar
 
 - **Node.js >= 20.11** - zorunlu; pipeline'ın kendi araçları bunun üzerinde koşuyor.
-- **`jq`** - opsiyonel ama önerilir. On üç kabuk yardımcısı ona başvuruyor ve yokken sessizce atlıyor: maliyet özetleri, faz izleyicisinin JSON okumaları, konvansiyon çıkarımı, skill imzalama. Kurulum, eksikse bir not basıyor.
+- **`jq`** - dokuz yol için zorunlu, geri kalanı için opsiyonel. 89 kabuk dosyası ona başvuruyor. Yayınlayan ya da karar veren dokuzu - autopilot kuyruğu, Jira yorumları, PR review'ları, issue güncellemeleri, plan dosyası, iki Figma fetcher'ı, log araması ve Jira auth - `jq` yokken çalışmak yerine exit 3 ile reddediyor, çünkü eksik bir `jq` boş VERİ olarak görünür ve iş onunla devam eder. Diğer yerlerde `jq` olmadan da çalışıyor, yalnızca daha az şey yapıyor. Kurulum, eksikse bir not basıyor.
 - **`gh`** - GitHub issue ve PR işleri için. Kendi dahili `--jq`'su, `jq` ikilisinden bağımsız.
 
 ## Hızlı Başlangıç
@@ -95,36 +95,38 @@ tüm kümeyi taşır; Faz 0'ın şekil hakkında sorduğu tek soru branch'in ner
 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ı; 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).
-- **5 · Report** - teknik özet + test senaryolarıyla bir Jira yorumu, channels katmanından gönderilir. Autopilot'un her modda hâlâ durduğu tek adım bu.
+- **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 tek bir karar, bu yüzden tek faz ([ADR-0014](./docs/adr/0014-six-phase-consolidation.md)). 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 yeniden build etmek yerine o log'u okur.
+- **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; fable basamağı kapalıyken 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). Gözetimsiz bir koşu commit'te durur ve bir PR isteğini autopilot koşucusuna bırakır; koşucu isteği doğrular ve taslak bir PR açar.
+- **5 · Report** - teknik özet + test senaryolarıyla bir Jira yorumu, channels katmanından gönderilir. Terminalden başlatılan bir autopilot koşusunun hâlâ durduğu tek adım bu; gözetimsiz bir koşu Faz 4 devrinde biter ve koşucu, PR açıldıktan sonra yapılandırdığın raporları gönderir.
 
-`/multi-agent:analysis` kendi kısa zincirini koşar ve v16.12.0'dan beri yazdığını yayınlamadan önce review ediyor: taslak, bir kod diff'iyle aynı üç-reviewer setinden ve triyajdan geçiyor, bloklayıcı bulgu dokümanı sentez fazına geri gönderip dispatch'i kapatıyor, hayatta kalan boşluklar ya aranıyor ya sana soruluyor ya da sahibiyle birlikte kayda giriyor. Önceden yalnızca yapısal bir validator'ın arkasından yayınlıyordu.
+Faz listesi `pipeline/schemas/phases.json`'da duruyor; `smoke-phase-contract.sh` onun diğer her kopyasını - üreticinin çıktısını, token bütçesini, state-şema sınırlarını, örnek çıktılardaki ilerleme kesirlerini - bu tek dosyaya bağlı tutuyor.
 
-### 18.0.0: tek bir durum dizini, ve kurulumun gerçekten o kurulum olup olmadığını sorma yolu
+`/multi-agent:analysis` kendi kısa zincirini koşar ve yazdığını yayınlamadan önce review eder: taslak, bir kod diff'iyle aynı üç-reviewer setinden ve triyajdan geçer, bloklayıcı bulgu dokümanı sentez fazına geri gönderip dispatch'i kapatır, hayatta kalan boşluklar ya aranır ya sana sorulur ya da sahibiyle birlikte kayda girer.
+
+### Kurulum doğrulama, maliyet ve tek bir durum dizini
 
 - **`multi-agent-pipeline verify`.** Kurulum bir kopyadır ve yazıldığı andan itibaren iki taraf birbirinden bağımsız kayar: kurulu ağaçtaki bir düzenleme kaynağı olmayan bir davranıştır, kurulumun atladığı dosya ise dokümanın anlattığı ama kimsede olmayan bir script. `verify` ikisini de paketleme anında üretilen bir manifest'e karşı karşılaştırır. Yeşil sonucun ne kanıtladığı açıkça yazılıdır: baytlar yayıncının kaydettiğiyle aynıdır, kimin yayınladığı değil.
 - **Maliyet, tek koşunun ötesinde.** Görev başına tavan, bütçeyi gerçekten bitiren iki şeyi göremez: hiçbir koşuyu aşmayan kayma, ve her koşu tavanın altında kalırken bir saatte bir haftayı yakan tek oturum. `cost-analyze` projeksiyon yapar, medyan mutlak sapmayla aileden ayrılan günü bulur ve ivmeyi raporlar - liste fiyatından tahmin olarak, ve bunu dipnotta değil her koşuda söyler.
 - **Bir koşunun durumu tek yerde.** `{project}/{taskId}/` kanonik, düz yerleşim hâlâ okunuyor, ve iki yerde birden duran koşu bir kez sayılıyor.
-- **Sunucu hazırlığı, tamamen opt-in.** `doctor --profile=server` yalnızca klavyede kimse yokken anlamı olan dört kontrol ekler, `install --unattended` izin profilini yazmadan önce gösterir, autopilot runner artık bir ay gözetimsiz ayakta kalır. Varsayılan kurulum hiçbir izin yazmaz ve varsayılan doctor koşusu değişmez: sunucu kontrolünden kaldığı söylenen bir dizüstü, doctor'ı görmezden gelmeyi öğrenir.
+- **Sunucu hazırlığı, tamamen opt-in.** `doctor --profile=server` yalnızca klavyede kimse yokken anlamı olan dört kontrol ekler, `install --unattended` izin profilini yazmadan önce gösterir. Varsayılan kurulum hiçbir izin yazmaz ve varsayılan doctor koşusu sunucu kontrollerini dışarıda bırakır: sunucu kontrolünden kaldığı söylenen bir dizüstü, doctor'ı görmezden gelmeyi öğrenir.
 
 ### Paket yöneticisi, hook'lar ve MCP yüzeyi
 
-17.6.0'da üç küçük iş; üçü de pipeline'ın bakmak yerine varsaydığı bir yeri kapatıyor:
+Pipeline'ın varsaymak yerine baktığı üç yer:
 
-- **Faz 3 artık `npm` yazmıyor.** pnpm, yarn ya da bun kullanan bir repo geliştirme fazında, worktree ve branch zaten açılmışken patlıyordu. Yönetici artık reponun kendisinden çözülüyor: önce ortam değişkeni, sonra `package.json#packageManager`, sonra lock dosyası, sonra kanıt değil varsayılan olarak bildirilen npm. iOS ve Android'e dokunulmadı.
-- **Compaction bir fazın öğrendiğini artık yemiyor.** Yakalama hook'u oturum sonunda koşuyordu; otomatik compaction ise uzun bir review ya da geliştirme fazını tam koşarken özetliyor ve henüz yazılmamış olan her şey oturum sonu hiç gelmeden kayboluyordu. Hook şablonu artık `PreCompact`'te de yazıyor.
-- **`doctor` MCP sunucularını sayıyor.** Kayıtlı her sunucu her turda araç listesini gönderiyor ve sunucular teker teker ekleniyor, yani toplamı kimse görmüyor. Sadece sayıyı bildiriyor: uyarı yok, engelleme yok, kapatma yok.
+- **Faz 2 reponun paket yöneticisini kullanır.** Yönetici reponun kendisinden çözülür: önce ortam değişkeni, sonra `package.json#packageManager`, sonra lock dosyası, sonra kanıt değil varsayılan olarak bildirilen npm - böylece pnpm, yarn ya da bun kullanan bir repo worktree ve branch açıldıktan sonra patlamaz. iOS ve Android'e dokunulmaz.
+- **Compaction bir fazın öğrendiğini korur.** Hook şablonu yakalamaları oturum sonunun yanında `PreCompact`'te de yazar, çünkü otomatik compaction uzun bir review ya da geliştirme fazını tam koşarken özetler.
+- **`doctor` MCP sunucularını sayar.** Kayıtlı her sunucu her turda araç listesini gönderir ve sunucular teker teker eklenir, yani toplamı kimse görmez. Sadece sayıyı bildirir: uyarı yok, engelleme yok, kapatma yok.
 
-### Olgunluk: kontrolün artık bir sonucu var
+### Olgunluk: kontrolün bir sonucu var
 
-Faz 0 hiçbir şey inşa edilmeden önce maddenin ne kadar hazır olduğunu puanlıyor, ve 17.6.0'a kadar puanlayıp duruyordu: bir blocker koşuyu durduruyor, autopilot sırası bir sonraki maddeye geçiyor, madde bulunduğu kadar olgunlaşmamış kalıyordu. Kimseye söylenmediği için hiçbir şey değişmiyor, bir sonraki tarama aynı maddede aynı sebeple duruyordu.
+Faz 0 hiçbir şey inşa edilmeden önce maddenin ne kadar hazır olduğunu puanlar. Yalnızca duran bir puan maddeyi bulunduğu kadar olgunlaşmamış bırakır ve bir sonraki tarama aynı maddede aynı sebeple durur; bu yüzden sonuç bir sonraki adımı belirler.
 
-İnteraktif koşu artık **o adımda soruyor** - maddeyi açıp düzelt, onsuz devam et, ya da iptal - ve yalnızca devam ettiğini değil, hangi eksiği görmezden geldiğini kaydediyor. Autopilot koşusuna ise **maddenin kendisine sorması** söylenebiliyor (`prefs.global.maturityFollowup.autopilotCommentsOnIssue`, varsayılan kapalı): eksiği adıyla söyleyen tek bir yorum, sonra durup bekliyor. Durum değişmiyor, atanan kişi değişmiyor, kapatma yok; `Ref:` var, `Closes:` yok.
+İnteraktif koşu **o adımda sorar** - maddeyi açıp düzelt, onsuz devam et, ya da iptal - ve yalnızca devam ettiğini değil, hangi eksiği görmezden geldiğini kaydeder. Autopilot koşusu maddeyi park eder ve ona **maddenin kendisine sorması** söylenebilir (`prefs.global.maturityFollowup.autopilotCommentsOnIssue`, varsayılan kapalı): eksiği adıyla söyleyen tek bir yorum. Durum değişmez, atanan kişi değişmez, kapatma yok; `Ref:` var, `Closes:` yok.
 
-Maddeyi düzenlediğinde bir sonraki tarama yeniden kontrol ediyor; eksik kapandıysa geliştirme kendiliğinden başlıyor. Düzenleme yalnızca yeniden bakma sebebi - "sonra yaparım" diyen bir yorum da damgayı ilerletir ve hiçbir şeyi düzeltmez, o yüzden kontrol yeni içerik üzerinde yeniden koşup karar veriyor. Aynı soru iki kez sorulmuyor.
+`resume`, maddeyi yeniden çekerek olgunluk adımına geri girer ve kararı kontrol verir. Düzenleme yalnızca yeniden bakma sebebidir - "sonra yaparım" diyen bir yorum da damgayı ilerletir ve hiçbir şeyi düzeltmez. Aynı soru iki kez sorulmaz.
 
 ### Temel branch: önce kanıt, sonra soru
 
@@ -132,7 +134,7 @@ Faz 0 Adım 3 sormadan önce adayları **her birinin arkasındaki kanıtla** top
 
 Hiçbir şey gömülü değil: şeması `version`'a çözülen her Jira alanı, board ona ne ad verirse versin okunuyor; release dalı konvansiyonu da tablodan değil, var olan ref'lerden çıkarılıyor - aynı koddan bir repoda `<prefix>/develop_<version>`, başkasında `release-<version>` çıkıyor. Dalı henüz açılmamış bir sürüm not olarak bildiriliyor, checkout edemeyeceğin bir seçenek olarak sunulmuyor.
 
-Başarısız bir `git fetch` sessizce değil, yüksek sesle bozuluyor: liste lokal ref'lere düşüyor, soru bunu söylüyor, bir yeniden dene satırı kazanıyor, ve bozuk bir koşu listesini uzaktakinin cevabı diye kaydederse exit gate Faz 0'ı kapatmıyor. Tamamını kapatmak için `prefs.global.baseBranchEvidence.enabled: false` - Adım 3 eskisi gibi soruyor.
+Başarısız bir `git fetch` sessizce değil, yüksek sesle bozuluyor: liste lokal ref'lere düşüyor, soru bunu söylüyor, bir yeniden dene satırı kazanıyor, ve bozuk bir koşu listesini uzaktakinin cevabı diye kaydederse exit gate Faz 0'ı kapatmıyor. Tamamını kapatmak için `prefs.global.baseBranchEvidence.enabled: false` - Adım 3 düz branch listesiyle sorar.
 
 ### Çalışma alanı: worktree mi lokal mi
 
@@ -155,7 +157,7 @@ Koşunun kendisinde ayarlanabilen tek şey autopilot; geri kalan her şey kendi
 
 ## Komutlar
 
-`/multi-agent` ve 58 alt komut. `/multi-agent:help` aynı katalogu terminalde, `outputLanguage` ayarına göre gösterir.
+`/multi-agent` ve 61 alt komut. `/multi-agent:help` aynı katalogu terminalde, `outputLanguage` ayarına göre gösterir.
 
 ### Pipeline girişleri
 
@@ -192,6 +194,7 @@ Koşunun kendisinde ayarlanabilen tek şey autopilot; geri kalan her şey kendi
 | `/multi-agent:scan`                | Yerel skill dizinlerini kademeli desen kataloğuna göre güvenlik taraması                         |
 | `/multi-agent:prune-prompts`       | Sürekli yüklü talimat yükünün sıfır-tabanlı incelemesi; kural başına tut / dene / sil            |
 | `/multi-agent:ios-coding-standard` | Bir iOS modülünü 99 kurallık registry'ye göre denetler, düzeltme planı çıkarır                   |
+| `/multi-agent:security-review`    | Diff, branch ya da repo üzerinde bağımsız statik güvenlik incelemesi: tehdit modeli, CVSS puanlı OWASP + CWE bulguları, çevrimdışı bağımlılık envanteri |
 
 ### Analiz
 
@@ -199,6 +202,9 @@ Koşunun kendisinde ayarlanabilen tek şey autopilot; geri kalan her şey kendi
 | --------------------------------- | ---------------------------------------------------------------------------------------------- |
 | `/multi-agent:analysis`           | Bağımsız özellik spesifikasyonu: global (23 bölümlük doküman) veya kurumsal (IG/UC/FG) profili |
 | `/multi-agent:analysis-resolve`   | Analiz dokümanının Bölüm 20 açık sorularını satır satır cevaplar                               |
+| `/multi-agent:analysis-jira`      | Son hâlindeki analiz dokümanını Jira story ağacına çevirir: kural kimliklerinden story, iki yönlü kapsam, tam önizleme, yalnız eksik olanı açar |
+| `/multi-agent:graph`              | Repo'nun kod grafiğini kurar ve sorgular: semboller, import'lar, referanslar; deterministik, API maliyeti yok |
+| `/multi-agent:research <id>`      | Maddenin boşluklarını kimseye sormadan tracker, bağlı doküman ve repodan cevaplar               |
 | `/multi-agent:complaint-analysis` | Graylog kanıtıyla şikayet triyajı: client / bff kök neden ya da core'a yönlendirme             |
 
 ### Cihaz üstü test
@@ -245,15 +251,18 @@ Koşunun kendisinde ayarlanabilen tek şey autopilot; geri kalan her şey kendi
 | -------------------------------- | ---------------------------------------------------------------------------------- |
 | `/multi-agent:setup`             | İlk kurulum sihirbazı: keychain token keşfi, git identity, pipeline hazırlığı      |
 | `/multi-agent:stack [id]`        | Bu repo için marketplace plugin'lerini etkinleştirir. Çoklu seçim                  |
+| `/multi-agent:scaffold <stack> <ad>` | Toolkit'in scaffold skill'i ile yeni proje iskeleti; ilk commit'ten önce yeşil |
 | `/multi-agent:language [en\|tr]` | `outputLanguage`'i gösterir veya değiştirir; `promptLanguage` İngilizce kalır      |
 | `/multi-agent:sync`              | Tek atımlık senkron: Claude Code, Copilot CLI, pipeline repo, website, toolkit MCP |
 | `/multi-agent:update`            | npm'deki son yayına günceller ve migration'ları koşar                              |
+| `/multi-agent:doctor`            | Kurulumun sağlık kontrolü: yerleşim, tercihler, kimlik bilgileri, hook'lar, host yetenekleri; çıkış kodu verdiktin kendisi |
 | `/multi-agent:uninstall`         | Pipeline'ı her CLI'dan kaldırır. Keychain token'larına hiç dokunmaz                |
+| `/multi-agent:serve`             | İstemci için yerel sözleşme sunucusu: yalnızca 127.0.0.1, token, boşta durur       |
 | `/multi-agent:help`              | Bu katalog, terminalde, `outputLanguage`'ine göre                                  |
 
 ### Alt agent'lar
 
-Komutlarla birlikte sekiz agent kurulur ve fazlar bunları çağırır: `explorer` ve `task-clarifier` (Faz 0-1), `ios-architect` / `android-architect` / `backend-architect` (Faz 2), `dev-critic` (Faz 3), `code-reviewer` ve `security-auditor` (Faz 4).
+Komutlarla birlikte on agent kurulur: `explorer` ve `task-clarifier` (Faz 0-1), `ios-architect` / `android-architect` / `backend-architect` ve `plan-critic` (Faz 1, critic yalnız kalite kapıları açıkken), `dev-critic` (Faz 2'nin sonu), `code-reviewer` ve `security-auditor` (Faz 3), ve tam dosya okuması engellendiğinde `bulk-read.sh`'ın tek bir büyük dosyayı özetlemek için çağırdığı `bulk-reader`.
 
 ### Komut olmayan skill'ler
 
@@ -267,35 +276,30 @@ 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-on`     | Bu makinenin izleyeceği repoları seçersin. Etiketli GitHub issue'ları ve sana atanmış + etiketli Jira maddeleri worktree'de koşar, taslak (draft) 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                                                                                                                                    |
+| `/multi-agent:autopilot-off`    | Zamanlamayı kaldırır. Koşan iş biter; repo seçimi saklanır. `--now` o an koşan maddeyi de durdurur, önce adını söyleyip sorar                                                                  |
 
-## Hangi model cevaplıyor
+### Autopilot (gözetimsiz)
 
-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.
+Koşucu bir launchd tick'idir. Her tick kuyruğun başındaki maddeyi alır, tüm
+pipeline'ı bir worktree'de `MULTI_AGENT_UNATTENDED=1` ile koşturur ve bir
+**taslak** pull request'te biter. PR'ı bir insan inceler ve merge eder;
+pipeline'daki hiçbir şey merge etmez.
 
-| 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                                                                          |
+- **Sormadan önce araştırır.** Maturity blocker'ında ya da açık bir analiz sorusunda park eden koşu, bir insana bırakılmadan önce bir araştırma turundan geçer. `/multi-agent:research <id> --autonomous` tracker thread'ini, bağlı maddeleri ve dokümanları, benzer kapanmış maddeleri ve repoyu okur; `research-gate.mjs` yalnızca alıntılanmış bir kaynağın ya da çözümlenen bir `file:line`'ın desteklediği boşluğu kapatır, maturity kontrolü ya da açık-sorular kapısı sonuç üzerinde yeniden koşup karar verir. Hâlâ açık kalan varsa koşu, bulunan adaylarla birlikte park eder. [Research](./pipeline/multi-agent-refs/features/research.md)
+- **Dışarıya tek yazan.** Oturum asla push etmez. Faz 4 bir PR isteği yazar; koşucu da oturumun dışında stack'in build ve testlerini kendisi yeniden koşturur, gate ledger'ı, commit aralığı üzerindeki sır taramasını ve outbound kapısını yeniden kontrol eder, koşunun kaydettiği branch'i temiz bir staging reposundan push eder ve PR'ı `gh pr create --draft` ile açar. Başarısız bir kontrol maddeyi, kararı diskte olmak üzere `verification-failed` bırakır. Bitbucket'ta taslak PR olmadığı için branch push edilir ve bir özet yazılır. [Gözetimsiz güvenlik](./pipeline/multi-agent-refs/features/unattended-security.md)
+- **Koşunun etrafındaki operasyonlar.** Mod açıkken ikinci bir launchd ajanı Mac'i uyanık tutar (`caffeinate -s -i`; `autopilot-on`'daki ekran sorusuna evet dersen `-d` de eklenir), her koşu da tick'i bitene kadar bir uyku kilidi tutar. Yapılandırılmış bir reponun ihtiyaç duyduğu her credential zamanlama önerilmeden önce ve her tick'te yeniden yoklanır; kilitlenmiş bir keychain, anahtarın adı ve çözümüyle reddedilir. Üst üste hiçbir şey üretmeyen denemelerden sonra bir devre kesici yeni başlatmayı durdurur, `costCeilingUsd` harcamayı 24 saatlik yuvarlanan pencerede sınırlar, `maxParallelAgents` aynı anda çalışan oturum sayısını sınırlar, koşucu günde bir kez bir temizlik raporu ve açıksa bir özet (digest) yazar. [Autopilot operasyonları](./pipeline/multi-agent-refs/features/autopilot-operations.md)
+- **Kapalı başarısız olan (fail-closed) bir guard.** Değişken açıkken Bash guard bir komutu yalnızca `;`, `&&`, `||` ve düz pipe'larla birleşen basit komutlara indirgeyebildiğinde değerlendirir, gerisini ayrıştırmadan reddeder. Ayrıştırabildiklerinde: push, PR, issue ya da tracker yazımı yok, Keychain okuması yok, ağ izin listesi dışına istek yok, paket kurulumu ya da manifest düzenlemesi yok, korunan bir yola yazma yok. Ticket, sayfa ve PR metni modele güvenilmeyen-veri sınırlayıcıları içinde ulaşır. İzin profili (`install --unattended`) ikinci hattır; sınırın kendisi ayrı, admin olmayan bir macOS kullanıcısı ve varsayılan ile release branch'lerindeki GitHub ruleset'leridir, bunları operatör uygular. [Gözetimsiz güvenlik](./pipeline/multi-agent-refs/features/unattended-security.md)
+- **İddialar güvenilmez, kontrol edilir.** Kalite kapıları açıkken koşunun repo hakkındaki iddiaları commit'ten önce kontrol edilir: değişikliğin referans verdiği lokalizasyon anahtarı ya da endpoint gerçekten var, açık analiz soruları cevaplanmış ya da koşuyu park ediyor, bir triyaj alıntısı andığı satırı birebir alıntılıyor, "önceden vardı" denen bulgu diff'in dokunmadığı bir satırı gösteriyor, planın adımları karşılanmış, ve bir test başarısı stack'in kendi işaretleriyle okunan pozitif bir çalıştırılmış test sayısı gösteriyor (8 stack: `ios`, `android`, `web`, `backend-node`, `python`, `go`, `rust`, `jvm`), yanında da değişiklik olmadan kırmızıya dönen yeni bir test. Her karar bir gate ledger'a yazılır ve commit hook'u, zorunlu kapıları HEAD için geçmemiş bir commit'i reddeder. [Gözetimsiz kapılar](./pipeline/multi-agent-refs/features/unattended-gates.md), [stack adaptörleri](./pipeline/multi-agent-refs/features/stack-adapters.md)
+- **Spec, plan ve review disiplini.** `/multi-agent:analysis` bir proje anayasası yazar (güvenlik, erişilebilirlik, mimari ve lisans kuralları, her biri bir kaynağa bağlı); spec-consistency kapısı id üzerinden her gereksinimin bir görevi ve bir testi olduğunu, hiçbir şeyin bağlayıcı bir kuralı askıya almadığını kontrol eder. Faz 1 dört mercekle (kapsam, uygulanabilirlik, güvenlik, daha ucuz bir alternatif) tek bir plan-critic turuyla biter; itirazlar bir kez cevaplanır ve bir script karar verir. Review'da `blocking` bir bulgu koşuyu ancak iki bağımsız reviewer aynı bulguyu taşıdığında ya da başarısız bir test onu gösterdiğinde durdurur; aksi halde `important`'a düşürülür, asla silinmez. [Anayasa](./pipeline/multi-agent-refs/features/constitution.md), [plan critic](./pipeline/multi-agent-refs/features/plan-critic.md), [review kararı](./pipeline/multi-agent-refs/features/review-decision.md)
+- **Bir istemci sözleşmesi.** Komutlar ve koşu soruları veri olarak beyan edilir. `/multi-agent:serve`, CLI'ın bastığı aynı JSON üzerinde localhost'ta bir HTTP sunucusu başlatır; `pipeline/contract/` bir istemcinin üzerine kurulacağı manifest'i, TypeScript tiplerini ve fixture'ları taşır. Dört telefon route'u redakte edilmiş koşuları okur, park etmiş bir soruyu sunulan seçeneklerden biriyle cevaplar ve yalnızca açıldığında bir başlatmayı kuyruğa alır; her istek kayıtlı bir cihazın Ed25519 imzasını taşır. Telefon uygulaması ayrı bir proje. [İstemci kiti](./pipeline/contract/README.md), [telefon API'si](./pipeline/multi-agent-refs/features/phone-api.md)
 
-**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.
+**Elle kullanım değişmedi.** Yukarıdaki her davranış `MULTI_AGENT_UNATTENDED=1`
+değişkenine ya da autopilot moduna bağlı. İkisi de yoksa hiçbir kapı ledger'a
+yazmaz ya da koşuyu park etmez, guard da önceden verdiği cevabı verir; her iki
+yönü bir smoke suite tutar. Giriş noktası giriş noktası tam sözleşme:
+[unattended-contract.md](./pipeline/multi-agent-refs/unattended-contract.md).
 
 **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
@@ -307,18 +311,21 @@ En büyük kazanç paralellik değil. Ölçüm: medyan koşu 44 dakika, ama 14:0
 biten bir madde sen masaya oturana kadar bekler; gece boyunca bu 40 dakikaya
 karşı **16 saat**. Sürekli mod işi değil, beklemeyi kaldırıyor.
 
-**Yapmayacakları.** Merge etmez - koşucu açık PR'da durur, karar sende kalır.
+**Yapmayacakları.** Merge etmez - koşucu taslak PR'da durur, karar sende kalır.
 Senin elle koşturduğun bir işe dokunmaz: repo başına eşzamanlılık her zaman 1,
 yani kuyruk senin çalıştığın repoyu `.git/index.lock` için yarışmak yerine atlar.
-PR sayısına tavan yok; sınırlar 24 saatlik yuvarlanan `costCeilingUsd` ve
-makinenin kapasitesi.
+PR sayısına tavan yok; sınırlar 24 saatlik yuvarlanan `costCeilingUsd`,
+ayarladıysan `maxParallelAgents` 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, 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
-imzalanması gerekecek bir ikili olarak değil, yerinde kaynaktan derleniyor.
+değiştiremez ve andığı tek komutu senin CLI'ının yazdığı gibi yazar. Göstergenin
+etiketleri, terminalin okuduğu aynı tablodan, `prefs.global.outputLanguage`
+diline göre çizilir.
+ActivityKit macOS'ta yok, o yüzden bu bir `NSStatusItem` ve imzalanması
+gerekecek bir ikili olarak değil, yerinde kaynaktan derleniyor.
 
 **Yeniden başlatmadan sonra çalıştırman gereken komut yok.** launchd işi
 **girişte** yükler, boot'ta değil - ve bu bir eksiklik değil doğrusu: token'ları
@@ -327,9 +334,11 @@ Jira'ya ne GitHub'a bağlanabilirdi. `autopilot-resume` diye bir komut yok -
 hatırlanması gereken komut, unutulduğunda sessizce duran kuyruk demektir.
 Bunun yerine `doctor` gerçek arızayı söyler: kurulu, ama launchd'de iş yok.
 
-Uyku **yalnızca prizdeyken** engellenir. Prizde olmayan bir laptop'u boşaltan
-kuyruk hatadır; bataryada assertion bırakılır ve prize takınca kaldığı yerden
-devam eder.
+**Uyku.** launchd'nin aralığı uyuyan bir Mac'i uyandırmaz; bu yüzden mod açıkken
+uyanık tutma ajanı prizdeyken sistem uykusunu, bataryada da boşta uykuyu
+engeller. Mod açıkken prizden çekilmiş bir laptop, prize takılana ya da mod
+kapatılana kadar uyanık kalır; `awake.enabled: false` ajanı kaldırır ve yalnızca
+koşu başına kilidi bırakır, macOS o kilidi yalnızca prizdeyken uygular.
 
 **Üç komut da üç CLI'a birden kurulur ve hepsinde aynı şekilde çalışır**, çünkü
 kontrol ettikleri şey bir CLI özelliği değil: tick'i `claude --bg` çocuğu doğuran
@@ -338,6 +347,38 @@ Dolayısıyla sürekli mod her hostta `claude` binary'sinin `PATH`'te olmasını
 istiyor. Kuyruk ve repo seçimi her hostta `~/.claude/autopilot/` altında durur;
 bu bilinçli - bir makinedeki iki CLI tek kuyruk okumalı, iki değil.
 
+## 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.
+
+**Üst basamak bir anahtar.** `/multi-agent:model` `fable`'ı açar ya da kapatır
+(`prefs.global.modelFallback.fableEnabled`, kapalı gelir). Review komutları,
+triyaj ve plan critic kendi yuvalarını bu anahtar üzerinden çözer: Claude
+Code'da `/multi-agent:review` anahtar açıkken Fable + Opus + Sonnet, kapalıyken
+Opus + Sonnet çalıştırır.
+
 ## Stack'ler
 
 Stack skill'leri [`mmerterden/multi-agent-plugins`](https://github.com/mmerterden/multi-agent-plugins) marketplace'inde versiyonlu plugin'ler olarak gönderilir. Repo başına bir stack seç:
@@ -350,17 +391,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ı 58 komutu alır.
+Pipeline **Claude Code**, **Copilot CLI** ve **Codex CLI** üzerinde native çalışır - üçü de aynı `pipeline/` kaynağından kurulur ve aynı 61 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 + 58 alt-komut skill'i + script'ler                                                                   |
-| Codex CLI   | `--codex`               | bir router skill + ref olarak 58 spec + 9 agent TOML + `AGENTS.md` bloğu + `codex mcp add`                       |
+| Copilot CLI | `--copilot`             | talimatlar + 61 alt-komut skill'i + script'ler                                                                   |
+| Codex CLI   | `--codex`               | bir router skill + ref olarak 61 spec + 10 agent TOML + `AGENTS.md` bloğu + `codex mcp add`                       |
 
 Skill'leri stack'e göre filtrele: `--platform=ios\|android\|all`.
 
-**Codex neden 58 değil de tek bir skill alıyor.** Codex, keşfettiği her skill'in adını
+**Codex neden 61 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
@@ -369,7 +410,7 @@ hiçbir maliyeti olmayan referans dosyaları olarak tutar - aynı komutlar, ayn
 host'un gerçekten tutabildiği bir düzen.
 
 Reviewer setleri farklı çünkü mevcut modeller farklı: Claude Code 3 reviewer çalıştırır
-(Fable + Opus + Sonnet), Copilot CLI 3 (Opus + GPT-5.4 + Sonnet), Codex CLI 3 (xhigh'da
+(Fable + Opus + Sonnet; fable basamağı kapalıyken 2), Copilot CLI 3 (Opus + GPT-5.4 + Sonnet), Codex CLI 3 (xhigh'da
 gpt-5.6, gpt-5.4, medium'da gpt-5.6). Codex tek-vendor olduğu için üçü arasındaki
 konsensüs, iki-vendor'lu bir host'taki aynı konsensüsten daha zayıf bir kanıttır ve
 triage notu bunu belirtir.
@@ -380,12 +421,12 @@ triage notu bunu belirtir.
 
 | Token                 | Ne için kullanılır                                                 | Faz                     |
 | --------------------- | ------------------------------------------------------------------ | ----------------------- |
-| `jira`                | issue'yu çek · rapor yorumunu gönder                               | 0, 7                    |
-| `github`              | issue'lar · PR'lar · `gh` auth                                     | 0, 6                    |
-| `bitbucket`           | PR create/update (reviewer koruyarak) · diff                       | 6                       |
-| `confluence`          | analiz / wiki sayfaları yayınla                                    | 7                       |
+| `jira`                | issue'yu çek · rapor yorumunu gönder                               | 0, 5                    |
+| `github`              | issue'lar · PR'lar · `gh` auth                                     | 0, 4                    |
+| `bitbucket`           | PR create/update (reviewer koruyarak) · diff                       | 4                       |
+| `confluence`          | analiz / wiki sayfaları yayınla                                    | 5                       |
 | `figma` + `figma_mcp` | design context çek                                                 | yalnızca analiz         |
-| `fortify`             | security-scan bulgu kapısı                                         | 4                       |
+| `fortify`             | security-scan bulgu kapısı                                         | 2                       |
 | `firebase`            | Firebase projeleri için servis hesabı JSON'ı                       | gerektiğinde            |
 | `jenkins`             | CI tetikleme / durum                                               | build / deploy          |
 | `npm`                 | paket publish (çoğunlukla CI)                                      | release                 |

package/docs/FIGMA_PIPELINE.md

@@ -2,45 +2,45 @@
 
 End-to-end guide for generating production-ready UI components from Figma designs through the multi-agent pipeline. Covers iOS (SwiftUI) and Android (Jetpack Compose) with the same workflow shape.
 
-> Note: Component and Figma-to-code skills are no longer bundled in this repo. Phase 3 dispatches component work to the per-stack marketplace plugins (`ai-ios-toolkit` / `ai-android-toolkit` in the `multi-agent-plugins` marketplace) via the Skill tool. The workflow, subphases, and skill names described below are what those plugin skills run internally, not pipeline-bundled code. The 3-tier Figma design-access fallback still governs the analysis phase in this repo.
+> Note: Component and Figma-to-code skills are no longer bundled in this repo. Phase 2 dispatches component work to the per-stack marketplace plugins (`ai-ios-toolkit` / `ai-android-toolkit` in the `multi-agent-plugins` marketplace) via the Skill tool. The workflow, subphases, and skill names described below are what those plugin skills run internally, not pipeline-bundled code. The 3-tier Figma design-access fallback still governs the analysis phase in this repo.
 
 ## What you get
 
 - **One command** - `/multi-agent <figma-url-or-issue>` - produces a complete component: Configuration + View + Modifiers + Preview + README + three layers of tests + Code Connect + wiki doc.
 - **Platform-agnostic orchestration** - classification happens once in Phase 0; the orchestrator picks the right code generator for iOS or Android based on `figmaConfig.project.platform`.
 - **Multi-repo aware** - components span multiple repos (tokens in `common`, view in `components`, docs in `wiki`). The orchestrator sequences writes correctly.
-- **Non-blocking side effects** - wiki generation + Jira sync run as augmentations; failures log and Phase 7 continues.
-- **Cross-cutting integration skills** - Phase 3D detects content patterns (`figma-form-integration`, `figma-price-integration`, `figma-ui-patterns`) and interaction patterns (`figma-navigation`, `figma-overlays`, `figma-bottom-sheets`) and dispatches the matching skill. All are **native-SwiftUI-first**; a project's own navigation/overlay/sheet system is used only when `figmaConfig.ui.{navigationSystem,overlaySystem,sheetSystem}` declares one (absent → stock SwiftUI: `NavigationStack`, `.alert`/`.sheet(item:)`, `.presentationDetents`). Generic across SwiftUI codebases.
+- **Non-blocking side effects** - wiki generation + Jira sync run as augmentations; failures log and Phase 5 continues.
+- **Cross-cutting integration skills** - Phase 2 detects content patterns (`figma-form-integration`, `figma-price-integration`, `figma-ui-patterns`) and interaction patterns (`figma-navigation`, `figma-overlays`, `figma-bottom-sheets`) and dispatches the matching skill. All are **native-SwiftUI-first**; a project's own navigation/overlay/sheet system is used only when `figmaConfig.ui.{navigationSystem,overlaySystem,sheetSystem}` declares one (absent → stock SwiftUI: `NavigationStack`, `.alert`/`.sheet(item:)`, `.presentationDetents`). Generic across SwiftUI codebases.
 - **Evolve an existing component** - `figma-evolve-component` reconciles a shipped component against current Figma (drift-heal) and additively extends it for a new need, behind a mandatory human gate - distinct from a fresh build, `figma-mend` (rebuild), and `figma-fix` (review bug).
 
 ## How it runs
 
-When multi-agent Phase 0 classifies a task as `component` (Figma URL in description, or figma-driven instruction path), Phase 3 delegates the entire phase to the enabled `ai-<platform>-toolkit` marketplace plugin's component skill (`create-component`, fallback `create-ui-component`) via the Skill tool. Component skills live in the plugin marketplace, not the pipeline. The dispatch layer records a coarse component-build row in `state.phases["3"].subphases[]` - multi-agent's phase-tracker reads that array with no special case. The subphase list below describes the flow the plugin skill runs internally.
+When multi-agent Phase 0 classifies a task as `component` (Figma URL in description, or figma-driven instruction path), Phase 2 delegates the entire phase to the enabled `ai-<platform>-toolkit` marketplace plugin's component skill (`create-component`, fallback `create-ui-component`) via the Skill tool. Component skills live in the plugin marketplace, not the pipeline. The dispatch layer records a coarse component-build row in `state.phases["3"].subphases[]` - multi-agent's phase-tracker reads that array with no special case. The subphase list below describes the flow the plugin skill runs internally.
 
 ### Internal phase order
 
 ```
-3.0  init               - node-id parse, registry lookup, worktree confirm
-3.1  gather             - Figma API / MCP fetch, variant properties, token extraction
-3.2a testing identifiers - semantic tags (platform-agnostic)
-3.2b localisation        - string keys → common repo
-3.2c accessibility       - a11y metadata; platform-aware output
-3.2d analytics           - event keys
-3.3  token mapping       - Figma values → design token symbols
-3.4a Configuration       - pure value type (SwiftUI struct / Compose @Immutable data class)
-3.4b View                - SwiftUI body / @Composable fun
-3.4c Docs                - FIGMA.md (iOS) / README.md (Android)
-3.4d Preview             - variant grid
-3.4e Modifiers           - fluent API
-3.5a structural tests    - ViewInspector / Compose Testing
-3.5b snapshot tests      - SnapshotTesting / Paparazzi
-3.5c unit tests          - configuration semantics + behavioural
-3.6  Code Connect        - .figma.swift / .figma.kt registration
-3.7  wiki                - 4-adapter dispatch (submodule / in-repo / github-wiki / separate-repo)
-3.8  cleanup             - artifact pruning, state finalize
+2.0  init               - node-id parse, registry lookup, worktree confirm
+2.1  gather             - Figma API / MCP fetch, variant properties, token extraction
+2.2a testing identifiers - semantic tags (platform-agnostic)
+2.2b localisation        - string keys → common repo
+2.2c accessibility       - a11y metadata; platform-aware output
+2.2d analytics           - event keys
+2.3  token mapping       - Figma values → design token symbols
+2.4a Configuration       - pure value type (SwiftUI struct / Compose @Immutable data class)
+2.4b View                - SwiftUI body / @Composable fun
+2.4c Docs                - FIGMA.md (iOS) / README.md (Android)
+2.4d Preview             - variant grid
+2.4e Modifiers           - fluent API
+2.5a structural tests    - ViewInspector / Compose Testing
+2.5b snapshot tests      - SnapshotTesting / Paparazzi
+2.5c unit tests          - configuration semantics + behavioural
+2.6  Code Connect        - .figma.swift / .figma.kt registration
+2.7  wiki                - 4-adapter dispatch (submodule / in-repo / github-wiki / separate-repo)
+2.8  cleanup             - artifact pruning, state finalize
 ```
 
-Each subphase emits a `→ <verb> <object>` progress line per `refs/progress-contract.md`; multi-agent's phase-tracker renders them inline under the Phase 3 row.
+Each subphase emits a `→ <verb> <object>` progress line per `refs/progress-contract.md`; multi-agent's phase-tracker renders them inline under the Phase 2 row.
 
 ## Configuration
 
@@ -71,7 +71,7 @@ Minimum viable config:
 
 Android projects swap the `build` section to `{ "gradleModule": ":components:button", "variant": "debug" }` and set `project.platform` to `"android"`.
 
-**Optional `ui` block - UI interaction systems.** Consumed by the enabled stack plugin's `navigation` / `overlays` / `bottom-sheets` skills (`ai-ios-toolkit:*` / `ai-android-toolkit:*`) and Phase 4 review. Omit it (or set `mode: "native"`) and the pipeline generates stock SwiftUI (`NavigationStack`, `.alert`/`.sheet(item:)`, `.sheet`+`presentationDetents`). Set `mode: "custom"` to route to a project-supplied system by type name:
+**Optional `ui` block - UI interaction systems.** Consumed by the enabled stack plugin's `navigation` / `overlays` / `bottom-sheets` skills (`ai-ios-toolkit:*` / `ai-android-toolkit:*`) and Phase 3 review. Omit it (or set `mode: "native"`) and the pipeline generates stock SwiftUI (`NavigationStack`, `.alert`/`.sheet(item:)`, `.sheet`+`presentationDetents`). Set `mode: "custom"` to route to a project-supplied system by type name:
 
 ```json
 "ui": {
@@ -87,8 +87,8 @@ When a GitHub issue triggers the pipeline and has no Jira link:
 
 1. Phase 0 Step 1 applies the `autoJiraFromGithubIssue` policy (`ask` | `always` | `never`, default `ask`). Autopilot forces `ask` to `always`.
 2. If create path: Jira ticket inherits title/body/labels; GitHub issue body gets a `Jira: [KEY](url)` link patch.
-3. Phase 7 Step 3.5 runs component wiki capture.
-4. Phase 7 posts a humanizer'd wiki summary back to the linked Jira (`wikiToJiraComment`, default `true`).
+3. Phase 5 runs component wiki capture (`multi-agent-refs/wiki-capture.md`).
+4. Phase 5 posts a humanizer'd wiki summary back to the linked Jira (`wikiToJiraComment`, default `true`).
 
 Full contract: [`pipeline/multi-agent-refs/issue-jira-triad.md`](../pipeline/multi-agent-refs/issue-jira-triad.md).
 
@@ -97,7 +97,7 @@ Full contract: [`pipeline/multi-agent-refs/issue-jira-triad.md`](../pipeline/mul
 | Mode | Path layout | Push semantics |
 |---|---|---|
 | `submodule` | `{repos.wiki.path}/FigmaComponents/{Category}/{Name}/{Name}.md` | Commit into submodule's branch, push, update parent repo's pointer |
-| `in-repo` | `{repos.components.path}/.wiki/components/{Category}/{Name}.md` | No push - ships with the component commit in Phase 6 |
+| `in-repo` | `{repos.components.path}/.wiki/components/{Category}/{Name}.md` | No push - ships with the component commit in Phase 4 |
 | `github-wiki` | `{owner}/{repo}.wiki.git/{Category}/{Name}.md` | Clone the `.wiki.git`, commit, push |
 | `separate-repo` | Remote repo's configured branch | Clone to cache, commit, push |
 
@@ -109,29 +109,29 @@ Global settings that affect the figma pipeline:
 
 | key | type | default | controls |
 |---|---|---|---|
-| `promptLanguage` | `en` / `tr` | `en` | Interactive prompt language (pickers, Phase 5/6 confirmations) |
+| `promptLanguage` | `en` / `tr` | `en` | Interactive prompt language (pickers, Phase 3/4 confirmations) |
 | `outputLanguage` | `en` / `tr` | `en` | Assistant's explanations / status / reports (independent of `promptLanguage`; external payloads stay English) |
 | `progressVerbosity` | `quiet` / `normal` / `verbose` | `normal` | Progress-line emission level |
-| `wikiDefault` | bool | `true` | Phase 7 wiki auto-yes under autopilot |
+| `wikiDefault` | bool | `true` | Phase 5 wiki auto-yes under autopilot |
 | `autoJiraFromGithubIssue` | `ask` / `always` / `never` | `ask` | Phase 0 Jira auto-create policy |
 | `wikiToJiraComment` | bool | `true` | Post wiki summary to linked Jira issue |
-| `confluenceDefault` | bool | `false` | Phase 7 Confluence auto-yes |
-| `jiraCommentDefault` | bool | `true` | Phase 7 test-scenarios Jira comment auto-yes |
+| `confluenceDefault` | bool | `false` | Phase 5 Confluence auto-yes |
+| `jiraCommentDefault` | bool | `true` | Phase 5 test-scenarios Jira comment auto-yes |
 
 ## Troubleshooting
 
 | Symptom | Likely cause | Fix |
 |---|---|---|
-| Phase 3 halts with "plugin not enabled" | The `ai-<platform>-toolkit` plugin is not enabled in this repo | Enable it in the repo's `.claude/settings.local.json` (`"ai-ios-toolkit@<marketplace>": true`) and reload the session |
+| Phase 2 halts with "plugin not enabled" | The `ai-<platform>-toolkit` plugin is not enabled in this repo | Enable it in the repo's `.claude/settings.local.json` (`"ai-ios-toolkit@<marketplace>": true`) and reload the session |
 | `multi-agent:create-component` not found | Marketplace not installed / plugin disabled | Install the marketplace and enable the platform toolkit; dispatch tries `create-component` then `create-ui-component` |
-| Wiki adapter failure | Remote unreachable (separate-repo mode) | Adapter caches pending output; next run retries. Non-blocking - Phase 7 continues. |
+| Wiki adapter failure | Remote unreachable (separate-repo mode) | Adapter caches pending output; next run retries. Non-blocking - Phase 5 continues. |
 | Jira auto-create hits 5xx | Transient Jira outage | Non-blocking - pipeline continues without link. User can run `/multi-agent:channels` post-hoc to add it. |
 | Android gradle unresolved | `figmaConfig.build.gradleModule` not set | Populate the config; halt is intentional (no guessing) |
 
 ## Further reading
 
-- [`pipeline/multi-agent-refs/component-dispatch.md`](../pipeline/multi-agent-refs/component-dispatch.md) - Phase 3 delegation contract.
-- [`pipeline/multi-agent-refs/wiki-capture.md`](../pipeline/multi-agent-refs/wiki-capture.md) - Phase 7 wiki contract.
+- [`pipeline/multi-agent-refs/component-dispatch.md`](../pipeline/multi-agent-refs/component-dispatch.md) - Phase 2 delegation contract.
+- [`pipeline/multi-agent-refs/wiki-capture.md`](../pipeline/multi-agent-refs/wiki-capture.md) - Phase 5 wiki contract.
 - [`pipeline/multi-agent-refs/issue-jira-triad.md`](../pipeline/multi-agent-refs/issue-jira-triad.md) - issue → jira → wiki triad contract.
 - [`pipeline/multi-agent-refs/progress-contract.md`](../pipeline/multi-agent-refs/progress-contract.md) - live progress-line emission contract.
 - [`pipeline/multi-agent-refs/cross-cli-contract.md`](../pipeline/multi-agent-refs/cross-cli-contract.md) - Claude ↔ Copilot CLI parity.

package/docs/adr/0006-skills-core-external-split.md

@@ -9,7 +9,7 @@ ADR-0003 (v3.5.0) collapsed the split `skills/claude/` + `skills/copilot/` into
 By v5.3.x the maintenance burden of the flat tree became visible in everyday work:
 
 - **Source navigation.** Browsing `pipeline/skills/shared/` on GitHub shows 148 sibling directories with no hint which ones are load-bearing for the pipeline vs. which ones are third-party imports.
-- **Code review cost.** Changes under `shared/` have very different risk profiles depending on which kind of skill changed. `multi-agent-sync/SKILL.md` is pipeline-critical - any drift breaks cross-CLI parity. `ios-developer/SKILL.md` is a reference guide imported from upstream - edits almost never affect pipeline behavior.
+- **Code review cost.** Changes under `shared/` have very different risk profiles depending on which kind of skill changed. `multi-agent-sync/SKILL.md` is pipeline-critical - any drift breaks cross-CLI parity. `swiftui-pro/SKILL.md` is a reference guide imported from upstream - edits almost never affect pipeline behavior.
 - **Grep noise.** `grep -r skills/shared/` produces 148× the noise it should when searching for pipeline code.
 - **Audit findings.** The v5.3.0 audit flagged this as technical debt worth addressing once the pipeline stabilized.
 

package/docs/adr/0007-multi-tool-adapter-framework.md

@@ -2,6 +2,12 @@
 
 **Status:** Superseded · 2026-07-02 (v10.7.0 removed all non-native adapters - the pipeline targets Claude Code + Copilot CLI only; Codex CLI was later added as a third NATIVE target in v13.0.0, not through this adapter framework). Original acceptance: 2026-04-27 (v7.7.0 / v7.9.0). Kept as the historical record of why the adapter framework existed; install flags documented below no longer exist.
 
+> **Amendment, 2026-09-13 ([ADR-0012](./0012-macos-only.md), macOS only).** Linux
+> and Windows support was removed. `package.json` declares `os: ["darwin"]` and
+> `lib/credential-store.sh` keeps only the macOS Keychain backend, so where the
+> body below names Windows Credential Manager or Linux libsecret, read it as
+> the record of what was decided then, not as a supported path.
+
 ## Context
 
 Through v7.6, the pipeline shipped to two CLIs only: Claude Code and Copilot CLI. Both expose **subagent dispatch** - the ability for the orchestrator to fan out work to parallel sub-agents with their own model, prompt, and context. This is a hard prerequisite for the 8-phase pipeline (Phase 1 parallel exploration, Phase 4 multi-reviewer review, Phase 7 multi-channel reporting).

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

@@ -6,6 +6,13 @@
 
 > **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.
 
+> **Amendment, 2026-09-13 ([ADR-0012](./0012-macos-only.md), macOS only).** Linux
+> and Windows support was removed. `package.json` declares `os: ["darwin"]`,
+> every workflow runs on a macOS runner, and `test.yml`'s matrix is macOS ×
+> Node 20/22 with no Ubuntu leg and no Windows job. Where the body below
+> describes an Ubuntu/macOS/Windows matrix or an Ubuntu `act` lane, read it as
+> the record of what was decided then.
+
 ## Context
 
 Two pressures collided during the v7.x line: