@mmerterden/multi-agent-pipeline 16.31.1 → 17.1.0

package/README.tr.md

@@ -10,7 +10,7 @@
 
 **Claude Code**, **Copilot CLI** ve **Codex CLI** için 8 fazlı bir AI geliştirme pipeline'ı. Bir Jira issue'sunu veya GitHub URL'sini tek komutla merge edilmiş bir PR'a dönüştürür - analiz → plan → TDD → review → test → commit → PR - çoklu-repo orkestrasyonu, bir plan-onay kapısı, CLI-farkında paralel review ve store-uyumluluk kontrolleriyle birlikte. Component ve Figma-to-code işleri paket içine gömülmek yerine stack başına marketplace plugin'lerine (iOS/SwiftUI, Android/Compose) devredilir, böylece component skill'leri tek bir yerde yaşar.
 
-Claude Code, Copilot CLI ve Codex CLI üzerinde native çalışır. macOS / Linux / Windows. Sıfır runtime dependency.
+Claude Code, Copilot CLI ve Codex CLI üzerinde native çalışır. Yalnızca macOS. Sıfır runtime dependency.
 
 📐 **[Mimari diyagramları](./docs/architecture.md)** - 8 faz akışı, çalışma modları, review/triage, Figma subphase'leri, component yapısı. **[Ekosistem diyagramı](./docs/ecosystem.md)** - bu repo, `multi-agent-plugins` marketplace'i ve `multi-agent-toolkit-mcp`'nin nasıl bir araya geldiği.
 
@@ -46,7 +46,7 @@ Bir görev çalıştır - girdi tipi otomatik algılanır:
 /multi-agent:issue                                    # atanmamış GitHub issue'larını gez → seç
 ```
 
-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.
+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`, worktree olmadan mevcut branch'te çalışmak için `--local` ekle (örn. `/multi-agent:autopilot "PROJ-1234"`). Pipeline derinliği artık bayrak değil, koşunun sorduğu bir soru: `/multi-agent` ve `/multi-agent:local` Faz 0'da Tam mı Kısa mı diye sorar.
 
@@ -75,117 +75,117 @@ Bunun arkasındaki disiplin - sınırlı loop'lar, kanıt kapıları, token-büt
 
 ## Modlar
 
-| Mod | Komut | Akış |
-|---|---|---|
-| Full | `/multi-agent "task"` | Tüm 8 faz, interaktif |
-| Autopilot | `/multi-agent:autopilot "task"` | 7 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 |
-| 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 |
+| Mod       | Komut                                | Akış                                                                                                                                                                       |
+| --------- | ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Full      | `/multi-agent "task"`                | Tüm 8 faz, interaktif                                                                                                                                                      |
+| Autopilot | `/multi-agent:autopilot "task"`      | 7 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                                                                                                             |
+| 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.
 
 ## Komutlar
 
-`/multi-agent` ve 51 alt komut. `/multi-agent:help` aynı katalogu terminalde, `outputLanguage` ayarına göre gösterir.
+`/multi-agent` ve 56 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 |
+| 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 |
 
 ### Görev kontrolü
 
-| Komut | Ne yapar |
-|---|---|
-| `/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: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 |
-| `/multi-agent:garbage-collect` | Artık scratch, sahipsiz worktree ve offload edilmiş payload'ları süpürür. Önce dry-run |
-| `/multi-agent:prune-logs` | Görev loglarını yaş / proje / görev filtresiyle siler. Denetim izi ve metrikler kalır |
-| `/multi-agent:purge` | Tüm worktree, branch, log ve state dosyalarını siler. Çift onay |
+| Komut                               | Ne yapar                                                                                                                                               |
+| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `/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: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                                                                         |
+| `/multi-agent:garbage-collect`      | Artık scratch, sahipsiz worktree ve offload edilmiş payload'ları süpürür. `--abandoned` ile durup bir daha dönülmemiş koşuları da toplar. Önce dry-run |
+| `/multi-agent:prune-logs`           | Görev loglarını yaş / proje / görev filtresiyle siler. Denetim izi ve metrikler kalır                                                                  |
+| `/multi-agent:purge`                | Tüm worktree, branch, log ve state dosyalarını siler. Çift onay                                                                                        |
 
 ### Review
 
-| Komut | Ne yapar |
-|---|---|
-| `/multi-agent:review` | Branch diff'i veya PR üzerinde paralel review; PR girdisinde inline yorum + approve/needs-work |
-| `/multi-agent:review-jira` | Bir Jira issue'sunun geliştirmeye hazırlığını puanlar, eksikleri yorum olarak yazar |
-| `/multi-agent:review-issue` | Aynı puanlama, GitHub issue'su için |
-| `/multi-agent:review-analysis` | Yazılmış analiz dokümanını review eder; bulgular ihlal edilen Locked kuralını gösterir |
-| `/multi-agent:diff-explain` | Faz 4 triyaj bulgusunu onu doğuran diff satırlarına eşler |
-| `/multi-agent:refactor` | Best-practice çıkarımı + bug avı + türetilmiş skill drift'i + toolkit MCP araştırması → tek plan |
-| `/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 |
+| Komut                              | Ne yapar                                                                                         |
+| ---------------------------------- | ------------------------------------------------------------------------------------------------ |
+| `/multi-agent:review`              | Branch diff'i veya PR üzerinde paralel review; PR girdisinde inline yorum + approve/needs-work   |
+| `/multi-agent:review-jira`         | Bir Jira issue'sunun geliştirmeye hazırlığını puanlar, eksikleri yorum olarak yazar              |
+| `/multi-agent:review-issue`        | Aynı puanlama, GitHub issue'su için                                                              |
+| `/multi-agent:review-analysis`     | Yazılmış analiz dokümanını review eder; bulgular ihlal edilen Locked kuralını gösterir           |
+| `/multi-agent:diff-explain`        | Faz 4 triyaj bulgusunu onu doğuran diff satırlarına eşler                                        |
+| `/multi-agent:refactor`            | Best-practice çıkarımı + bug avı + türetilmiş skill drift'i + toolkit MCP araştırması → tek plan |
+| `/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                   |
 
 ### Analiz
 
-| Komut | Ne yapar |
-|---|---|
-| `/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:complaint-analysis` | Graylog kanıtıyla şikayet triyajı: client / bff kök neden ya da core'a yönlendirme |
+| Komut                             | Ne yapar                                                                                       |
+| --------------------------------- | ---------------------------------------------------------------------------------------------- |
+| `/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:complaint-analysis` | Graylog kanıtıyla şikayet triyajı: client / bff kök neden ya da core'a yönlendirme             |
 
 ### Cihaz üstü test
 
-| Komut | Ne yapar |
-|---|---|
-| `/multi-agent:test` | Açık simülatör veya emülatörde UI Bug Hunter: screenshot, tap, analiz |
-| `/multi-agent:test-dark-mode` | Her ekranı önce light sonra dark gezer, kontrast ve renk hatalarını raporlar |
-| `/multi-agent:test-accessibility` | VoiceOver etiketleri, 44pt altı dokunma alanları, kontrast, trait'ler |
-| `/multi-agent:test-dynamic-type` | Her ekranı XL'den accessibility-XL'e kadar yeniden gezer, kırpılmaları raporlar |
-| `/multi-agent:test-screenshots [dil]` | Bir dilde App Store screenshot seti (varsayılan `tr`) |
-| `/multi-agent:manual-test` | Faz 5'in bağımsız hali: görev branch'ine geçer, Xcode için hazırlar |
+| Komut                                 | Ne yapar                                                                        |
+| ------------------------------------- | ------------------------------------------------------------------------------- |
+| `/multi-agent:test`                   | Açık simülatör veya emülatörde UI Bug Hunter: screenshot, tap, analiz           |
+| `/multi-agent:test-dark-mode`         | Her ekranı önce light sonra dark gezer, kontrast ve renk hatalarını raporlar    |
+| `/multi-agent:test-accessibility`     | VoiceOver etiketleri, 44pt altı dokunma alanları, kontrast, trait'ler           |
+| `/multi-agent:test-dynamic-type`      | Her ekranı XL'den accessibility-XL'e kadar yeniden gezer, kırpılmaları raporlar |
+| `/multi-agent:test-screenshots [dil]` | Bir dilde App Store screenshot seti (varsayılan `tr`)                           |
+| `/multi-agent:manual-test`            | Faz 5'in bağımsız hali: görev branch'ine geçer, Xcode için hazırlar             |
 
 ### Tasarım, build ve store
 
-| Komut | Ne yapar |
-|---|---|
-| `/multi-agent:design-check` | Kapsam geçitli mock-mode vs Figma denetimi; annotasyonlu HTML + PDF rapor |
-| `/multi-agent:store-ready` | iOS ve Android için yayın öncesi kapılar: paket denetimi, store doğrulaması, politika incelemesi |
-| `/multi-agent:testflight-validation` | `store-ready`'nin iOS'a sabitlenmiş hali. Yalnızca doğrular, asla yüklemez |
-| `/multi-agent:build-optimize` | Xcode build'ini ölçer, analizörleri koşar, önce-öneri yaklaşımlı plan üretir |
+| Komut                                | Ne yapar                                                                                         |
+| ------------------------------------ | ------------------------------------------------------------------------------------------------ |
+| `/multi-agent:design-check`          | Kapsam geçitli mock-mode vs Figma denetimi; annotasyonlu HTML + PDF rapor                        |
+| `/multi-agent:store-ready`           | iOS ve Android için yayın öncesi kapılar: paket denetimi, store doğrulaması, politika incelemesi |
+| `/multi-agent:testflight-validation` | `store-ready`'nin iOS'a sabitlenmiş hali. Yalnızca doğrular, asla yüklemez                       |
+| `/multi-agent:build-optimize`        | Xcode build'ini ölçer, analizörleri koşar, önce-öneri yaklaşımlı plan üretir                     |
 
 ### Ticket ve raporlama
 
-| Komut | Ne yapar |
-|---|---|
-| `/multi-agent:jira` | Açık Jira issue'larını gez → seç → branch → mod → başlat |
-| `/multi-agent:issue` | Atanmamış GitHub issue'larını gez → seç → otomatik ata → başlat |
+| Komut                      | Ne yapar                                                                                      |
+| -------------------------- | --------------------------------------------------------------------------------------------- |
+| `/multi-agent:jira`        | Açık Jira issue'larını gez → seç → branch → mod → başlat                                      |
+| `/multi-agent:issue`       | Atanmamış GitHub issue'larını gez → seç → otomatik ata → başlat                               |
 | `/multi-agent:create-jira` | Projenin kendi konvansiyonlarına uygun Task / Bug / Story taslağı, oluşturmadan önce önizleme |
-| `/multi-agent:channels` | Çok kanallı raporu gönderir: Jira, Confluence, Wiki, PR açıklaması, board durumu |
-| `/multi-agent:feedback` | Bakımcıya tek mesaj. Yalnızca yazdığın metin gider, log ve yol gitmez |
+| `/multi-agent:channels`    | Çok kanallı raporu gönderir: Jira, Confluence, Wiki, PR açıklaması, board durumu              |
+| `/multi-agent:feedback`    | Bakımcıya tek mesaj. Yalnızca yazdığın metin gider, log ve yol gitmez                         |
 
 ### Kendi rutinlerin
 
-| Komut | Ne yapar |
-|---|---|
-| `/multi-agent:save [ad]` | Tekrar eden bir işi `/multi-agent:<ad>` olarak kaydeder. Local-only, asla sync edilmez |
-| `/multi-agent:routines` | Kaydettiğin rutinleri ve ne yaptıklarını listeler |
-| `/multi-agent:forget [ad]` | Kayıtlı bir rutini ve registry kaydını siler |
+| Komut                      | Ne yapar                                                                               |
+| -------------------------- | -------------------------------------------------------------------------------------- |
+| `/multi-agent:save [ad]`   | Tekrar eden bir işi `/multi-agent:<ad>` olarak kaydeder. Local-only, asla sync edilmez |
+| `/multi-agent:routines`    | Kaydettiğin rutinleri ve ne yaptıklarını listeler                                      |
+| `/multi-agent:forget [ad]` | Kayıtlı bir rutini ve registry kaydını siler                                           |
 
 ### Kurulum ve bakım
 
-| Komut | Ne yapar |
-|---|---|
-| `/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: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:uninstall` | Pipeline'ı her CLI'dan kaldırır. Keychain token'larına hiç dokunmaz |
-| `/multi-agent:help` | Bu katalog, terminalde, `outputLanguage`'ine göre |
+| Komut                            | Ne yapar                                                                           |
+| -------------------------------- | ---------------------------------------------------------------------------------- |
+| `/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: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:uninstall`         | Pipeline'ı her CLI'dan kaldırır. Keychain token'larına hiç dokunmaz                |
+| `/multi-agent:help`              | Bu katalog, terminalde, `outputLanguage`'ine göre                                  |
 
 ### Alt agent'lar
 
@@ -195,6 +195,52 @@ Komutlarla birlikte sekiz agent kurulur ve fazlar bunları çağırır: `explore
 
 İki uyumluluk skill'i her host'a kurulur ve store kapılarını besler: `apple-archive-compliance` (ITMS kod eşlemeli 18 kurallı Apple review taraması) ve `google-play-compliance` (Console hata kodlu 21 kurallı Play politika kataloğu). Stack'e bağlı geri kalan her şey - SwiftUI, Compose, backend, frontend - aşağıda anlatılan marketplace plugin'lerinden gelir.
 
+## Sürekli mod
+
+Yukarıdaki her şey sen başlattığında başlar. Sürekli mod, aynı pipeline'ın
+**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 |
+
+**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
+`smoke-autopilot-default-off.sh` derlemeyi düşürür. Etiket bir filtredir, kapı
+değil - push yetkin olan bir repoda issue açabilen herkes etiket ekleyebilir -
+o yüzden kapı picker'dır ve makine başınadır.
+
+En büyük kazanç paralellik değil. Ölçüm: medyan koşu 44 dakika, ama 14:00'te
+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.
+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.
+
+**`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
+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.
+
+**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ı
+açan şey login keychain'in açılması, giriş öncesi ateşlenen bir tick zaten ne
+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.
+
 ## 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ç:
@@ -207,13 +253,13 @@ 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ı 53 komutu alır.
+Pipeline **Claude Code**, **Copilot CLI** ve **Codex CLI** üzerinde native çalışır - üçü de aynı `pipeline/` kaynağından kurulur ve aynı 56 komutu alır.
 
-| Araç | Bayrak | Ne kurar |
-|---|---|---|
+| 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 + 53 alt-komut skill'i + script'ler |
-| Codex CLI | `--codex` | bir router skill + ref olarak 53 spec + 8 agent TOML + `AGENTS.md` bloğu + `codex mcp add` |
+| Copilot CLI | `--copilot`             | talimatlar + 56 alt-komut skill'i + script'ler                                                                   |
+| Codex CLI   | `--codex`               | bir router skill + ref olarak 56 spec + 8 agent TOML + `AGENTS.md` bloğu + `codex mcp add`                       |
 
 Skill'leri stack'e göre filtrele: `--platform=ios\|android\|all`.
 
@@ -233,20 +279,20 @@ triage notu bunu belirtir.
 
 ## Token'lar ve entegrasyonlar
 
-`setup` OS keychain'ini tarar ve her token'ı **mantıksal bir isimle** (örn. `jira`) gerçek keychain girdisine eşler - pipeline token'ları bu eşleme üzerinden çözer (`credential-store.sh`), böylece literal keychain isimleri hiçbir sync edilen dosyada görünmez. Token'lar keychain'de kalır (macOS Keychain / Windows Credential Manager / Linux libsecret), **asla commit edilmez ya da loglanmaz**, ve hepsi **opsiyoneldir** - pipeline Phase 0'da ihtiyaç duyduğu herhangi birini sorar.
-
-| 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 |
-| `figma` + `figma_mcp` | design context çek | yalnızca analiz |
-| `fortify` | security-scan bulgu kapısı | 4 |
-| `firebase` | Firebase projeleri için servis hesabı JSON'ı | gerektiğinde |
-| `jenkins` | CI tetikleme / durum | build / deploy |
-| `npm` | paket publish (çoğunlukla CI) | release |
-| `appstore_connect_*` | TestFlight / App Store pre-submission doğrulaması (opsiyonel, iOS) | `testflight-validation` |
+`setup` OS keychain'ini tarar ve her token'ı **mantıksal bir isimle** (örn. `jira`) gerçek keychain girdisine eşler - pipeline token'ları bu eşleme üzerinden çözer (`credential-store.sh`), böylece literal keychain isimleri hiçbir sync edilen dosyada görünmez. Token'lar macOS Keychain'de kalır, **asla commit edilmez ya da loglanmaz**, ve hepsi **opsiyoneldir** - pipeline Phase 0'da ihtiyaç duyduğu herhangi birini sorar.
+
+| 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                       |
+| `figma` + `figma_mcp` | design context çek                                                 | yalnızca analiz         |
+| `fortify`             | security-scan bulgu kapısı                                         | 4                       |
+| `firebase`            | Firebase projeleri için servis hesabı JSON'ı                       | gerektiğinde            |
+| `jenkins`             | CI tetikleme / durum                                               | build / deploy          |
+| `npm`                 | paket publish (çoğunlukla CI)                                      | release                 |
+| `appstore_connect_*`  | TestFlight / App Store pre-submission doğrulaması (opsiyonel, iOS) | `testflight-validation` |
 
 **Secret scan**, Claude Code'da bir `PreToolUse` hook'u olarak (bulgu halinde commit'i sert-engeller) ve diğer yerlerde bir pre-push kontrolü olarak çalışır.
 
@@ -262,13 +308,13 @@ Uninstall bu katmanı korur: token'lar, onları açan okuyucu, adlarını tutan
 
 ## Platform desteği
 
-**macOS**, **Linux** ve **Windows** (Git Bash / WSL) üzerinde çalışır. Shell ve credential erişimi platform-agnostik bir katmandan geçer - keychain otomatik olarak **macOS Keychain**, **Linux libsecret** (`secret-tool`) veya **Windows Credential Manager**'a çözülür, ve script'ler BSD ile GNU araç varyantları arasında fallback yapar. Node.js 20.11+ (20 ve 22'de test edildi).
+Yalnızca **macOS** üzerinde çalışır. Paket `os: ["darwin"]` beyan eder, yani `npm` başka bir platformda kurulumu reddeder - koşunun yarısında başarısız olmasındansa. Her credential okuması `security`, her iOS build'i `xcodebuild`, her ekran kaydı `simctl` çağırıyor. Node.js 20.11+ (20 ve 22'de test edildi). Gerekçe: [ADR-0012](docs/adr/0012-macos-only.md).
 
 ## Yan repolar
 
-| Repo | Ne olduğu |
-|---|---|
-| [`mmerterden/multi-agent-plugins`](https://github.com/mmerterden/multi-agent-plugins) | Stack-başına skill toolkit'lerinin marketplace'i (iOS / Android / Frontend / Backend + common). `/multi-agent:stack` ilgili plugin'i etkinleştirir. |
+| Repo                                                                                          | Ne olduğu                                                                                                                                                                                                                                                                                                                                                         |
+| --------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`mmerterden/multi-agent-plugins`](https://github.com/mmerterden/multi-agent-plugins)         | Stack-başına skill toolkit'lerinin marketplace'i (iOS / Android / Frontend / Backend + common). `/multi-agent:stack` ilgili plugin'i etkinleştirir.                                                                                                                                                                                                               |
 | [`mmerterden/multi-agent-toolkit-mcp`](https://github.com/mmerterden/multi-agent-toolkit-mcp) | UI testing / simulator capture / xcodebuild için MCP sunucusu - Phase 5 UI Bug Hunter'ı güçlendirir. Public npm registry'de [`@mmerterden/multi-agent-toolkit-mcp`](https://www.npmjs.com/package/@mmerterden/multi-agent-toolkit-mcp) olarak yayınlanır; installer her CLI'a onu senin için register eder, böylece `npx` ekstra konfigürasyon olmadan onu çözer. |
 
 ## Lisans

package/docs/adr/0011-dormant-ci.md

@@ -1,6 +1,15 @@
 # 11. CI stays in the repository but dormant; the pre-push gate is primary
 
-**Status:** Accepted · 2026-08-31
+**Status:** Accepted · 2026-08-31 · amended 2026-09-13
+
+> **Amendment, 2026-09-13 (ADR-0012, macOS only).** Linux and Windows support
+> was removed. `package.json` now declares `os: ["darwin"]`, which npm enforces
+> on the root package, so no non-macOS runner can `npm ci` this tree at all.
+> Every workflow moved to a macOS runner, `test.yml`'s matrix lost its Ubuntu
+> leg and its `windows-test` job, and `npm run gate:linux` and
+> `pipeline/scripts/gate-linux.sh` are gone. Where the body below says a leg is
+> reachable through `act` on Ubuntu, read it as history: the gap it describes no
+> longer exists because the platform no longer does.
 
 ## Context
 

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

@@ -0,0 +1,98 @@
+# 12. macOS only; Linux and Windows support is removed, not deprecated
+
+**Status:** Accepted · 2026-09-13
+
+## Context
+
+The package advertised three platforms. `README.md` said "macOS / Linux /
+Windows", `lib/credential-store.sh` carried a `secret-tool` backend for Linux
+and a PowerShell Credential Manager backend for Windows, and `test.yml` ran a
+matrix over Ubuntu and macOS plus a dedicated `windows-test` job.
+
+None of it was verified. ADR-0011 records that CI has not executed since
+2026-07-02, and its own honest-status block already said the Linux path was
+"coded, smoke-skipped (CI has no keyring agent)" and the Windows path "coded,
+unverified this release". `docs/engineering.md` claimed "the CI matrix runs
+macOS, Linux, and Windows", which stopped being true the day the runners went
+away.
+
+The rest of the pipeline never made the same promise. Every credential read
+shells `security`. Every iOS build shells `xcodebuild`. Every piece of visual
+evidence shells `simctl`. A run on another platform does not degrade into a
+smaller run; it fails partway through, having already created a worktree and a
+branch. Three advertised platforms, one that works.
+
+## Decision
+
+macOS is the only supported platform, and the package says so where a machine
+can act on it:
+
+- `package.json` declares `os: ["darwin"]`. npm enforces this on the root
+  package - a non-macOS `npm ci` ends in `EBADPLATFORM` before a single file is
+  written. This one field does more than deleting every branch would.
+- `index.js` and `install/index.mjs` refuse a non-darwin host with one line
+  naming the requirement. `uninstall`, `help` and `--version` are exempt:
+  somebody who installed before this gate must still be able to remove it, and
+  a person diagnosing a broken install needs the other two.
+  `MULTI_AGENT_ALLOW_NON_DARWIN=1` overrides, and says on stderr that nothing
+  on that path is tested.
+- `doctor` gains `host-platform`, which runs first and blocks. It runs first so
+  a non-macOS host gets one honest line instead of a cascade whose common cause
+  is never stated.
+- Every workflow runs on a macOS runner. `test.yml` loses its Ubuntu leg and
+  its `windows-test` job, `pipeline/scripts/gate-linux.sh` and the
+  `npm run gate:linux` script are deleted.
+
+**The dead Linux and Windows code is removed separately, or not at all.** It
+costs nothing at runtime - `detect_platform()` returns `macos` and the other
+arms never execute - and removing it is where the real risk lives. Seven
+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
+   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
+   that names either one alone, and macOS ships `shasum` while a mac with brew
+   coreutils has both. Net change: zero lines.
+3. `credential-store.sh`'s node reader for `keychainMapping`. Its comment
+   blames Windows; its condition is `command -v node`, so it fires on any host
+   without `python3`, macOS included.
+4. `delegate_to_python()` and `do_set`'s `[ "$PLATFORM" != "macos" ] &&` guard.
+   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
+   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.
+7. `credential-store-resolver.sh`, which has no OS content at all - it resolves
+   Claude / Copilot / Codex install trees.
+
+## Consequences
+
+- A Linux or Windows user cannot install. That is the point: the alternative
+  was letting them install and fail at Phase 3.
+- `rollup.byOs` in the usage panel keeps its key. A row with the field missing
+  should read as "unknown host", not as "macOS".
+- `test.yml` is still dormant per ADR-0011. What it would verify on waking is
+  now a clean macOS runner and a lockfile install, not a platform matrix.
+- The `os` field is a hard stop with no per-file discipline required, which is
+  why it is listed first. Deleting 126 lines of unreachable branches buys no
+  behaviour and risks the seven items above; it is optional cleanup, gated
+  behind a green `npm test` on both sides of each removal.
+
+## Alternatives
+
+**Deprecate rather than remove.** A deprecation window helps users who have a
+working install. Nobody has one: the paths were never verified and CI has not
+run since July.
+
+**Keep the code, drop only the claim.** Tempting, and it is what the optional
+part of this decision does. But leaving `secret-tool` in the tree with no
+promise attached means the next reader has to work out whether it is supported,
+which is the ambiguity the `os` field removes in one line.
+
+**Self-hosted macOS runner.** Considered and rejected in ADR-0011 for a public
+repository: a self-hosted runner executes code from any fork's pull request.

package/docs/adr/README.md

@@ -21,6 +21,7 @@ Format: lightly adapted from [Michael Nygard's ADR template](https://cognitect.c
 | [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 |
 
 ## Writing a New ADR
 

package/docs/architecture.md

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

package/docs/ecosystem.md

@@ -5,7 +5,7 @@ separately, wired together at install time and at run time:
 
 | Repo | What it owns | Ships as |
 |---|---|---|
-| **`multi-agent-pipeline`** (this repo) | Orchestration: the 8-phase flow, the 53 slash commands, quality gates, review/triage, cross-CLI parity | npm package (`@mmerterden/multi-agent-pipeline`), installs itself onto Claude Code / Copilot CLI / Codex CLI |
+| **`multi-agent-pipeline`** (this repo) | Orchestration: the 8-phase flow, the 56 slash commands, quality gates, review/triage, cross-CLI parity | npm package (`@mmerterden/multi-agent-pipeline`), installs itself onto Claude Code / Copilot CLI / Codex CLI |
 | **`multi-agent-plugins`** | Stack knowledge: per-platform component/lifecycle skills (iOS, Android, Frontend, Backend) + shared knowledge | Claude Code marketplace, 5 independently-versioned plugins |
 | **`multi-agent-toolkit-mcp`** | The pipeline's hands on devices and browsers: 80 MCP tools across 6 categories (simulator/emulator control, accessibility audit, store compliance, web automation, Figma-vs-mock design audit, an agent-DSL batch runner) | npm package, registered as a standard stdio MCP server on every host |
 
@@ -18,7 +18,7 @@ Either can be swapped or removed without touching the other two's source.
 graph LR
     subgraph PIPE ["multi-agent-pipeline (orchestrator)"]
         direction TB
-        PHASES["8 phases · 53 commands"]
+        PHASES["8 phases · 56 commands"]
         GATES["deterministic gates + review triage"]
     end
 
@@ -64,8 +64,8 @@ only those:
 graph TD
     CC["Claude Code<br/>~/.claude/commands/multi-agent/<br/>(source of truth)"]
 
-    CC -->|"Step 2: copy + reformat<br/>53 sub-command skills"| COP["Copilot CLI<br/>~/.copilot/skills/"]
-    CC -->|"Step 2b: transform<br/>(install.js --codex)"| COD["Codex CLI<br/>1 router skill + 53 refs<br/>+ 8 agent TOML"]
+    CC -->|"Step 2: copy + reformat<br/>56 sub-command skills"| COP["Copilot CLI<br/>~/.copilot/skills/"]
+    CC -->|"Step 2b: transform<br/>(install.js --codex)"| COD["Codex CLI<br/>1 router skill + 56 refs<br/>+ 8 agent TOML"]
     CC -->|"Step 3: genericize<br/>(strip personal data)"| REPO["multi-agent-pipeline repo<br/>pipeline/"]
     CC -->|"Step 4: version + feature sync"| WEB["Website<br/>projects.ts / i18n.tsx"]
 
@@ -153,7 +153,7 @@ measurements behind this table):
 
 | | Claude Code | Copilot CLI | Codex CLI |
 |---|---|---|---|
-| **Pipeline commands** | 53 slash-command skills, native | 53 skills, `multi-agent-{cmd}` naming, copied in | 1 router skill (`multi-agent`) + 53 command specs as reference files - Codex silently truncates its skills block past a few dozen entries, so sub-commands are not peer skills here |
+| **Pipeline commands** | 56 slash-command skills, native | 56 skills, `multi-agent-{cmd}` naming, copied in | 1 router skill (`multi-agent`) + 56 command specs as reference files - Codex silently truncates its skills block past a few dozen entries, so sub-commands are not peer skills here |
 | **Stack plugins** | Marketplace plugin, loaded natively, resolved by `.claude/settings.json` enabled-list | Enabled plugin's authored skills copied flat into `~/.copilot/skills/`; `knowledge/` **not** re-copied (already delivered via `shared/external`) | Copied as reference files under `~/.codex/multi-agent-refs/skills/`, plugin-prefixed on name clash (e.g. `architecture` → `ai-ios-toolkit-architecture`) |
 | **Component dispatch (Phase 3)** | Marketplace plugin's `create-component`/`create-screen` skill via the Skill tool | No plugin loader - the enabled stack plugin's authored skills (incl. `create-component`) are copied flat into `~/.copilot/skills/` at install time (the old frozen `figma-*` copies are pruned, they were never a fallback) | Not part of the enforced parity axis; classification + state-shape must match, skill *inventory* does not |
 | **multi-agent-toolkit-mcp** | `claude mcp add multi-agent-toolkit -- npx -y @mmerterden/multi-agent-toolkit-mcp` | `copilot mcp add multi-agent-toolkit -- npx -y @mmerterden/multi-agent-toolkit-mcp` | `codex mcp add multi-agent-toolkit -- npx -y @mmerterden/multi-agent-toolkit-mcp` (skipped with a warning if `codex` isn't on `PATH`) |

package/docs/engineering.md

@@ -73,4 +73,4 @@ Every loop in the pipeline has a deterministic exit condition and a hard iterati
 ## Cross-CLI parity
 
 - **One source of truth, two runtimes**: Claude Code and Copilot CLI command surfaces are byte-identical where shared; a parity smoke fails on drift.
-- **Portability gates**: every shell script passes `bash -n` and a GNU/BSD portability grep; the CI matrix runs macOS, Linux, and Windows.
+- **Portability gates**: every shell script passes `bash -n` and a BSD-userland portability grep. The target is macOS with bash 3.2, not a platform matrix - `grep -P` is banned because BSD grep lacks it and fails silently, and the `sha256sum || shasum` and `stat -c || stat -f` chains keep their ordering for the same reason.

package/index.js

@@ -30,6 +30,32 @@ if (noColor) {
   process.env.NO_COLOR = "1";
 }
 
+// macOS only, and the gate is here rather than in install.js so every entry
+// point sees the same answer. Three commands are deliberately exempt:
+// `uninstall` (someone who installed before this gate existed must still be
+// able to remove it), `--version` and `help` (a person diagnosing a broken
+// install needs both to work).
+//
+// The pipeline shells `security` for every credential, `xcodebuild` and
+// `simctl` for every iOS build and every piece of visual evidence. On another
+// platform a run does not degrade, it fails - so refusing here is the honest
+// answer rather than letting the user discover it at Phase 3.
+const PLATFORM_EXEMPT = new Set(["uninstall", "delete", "help", "--version", "-v", "version"]);
+if (process.platform !== "darwin" && !PLATFORM_EXEMPT.has(command ?? "")) {
+  if (process.env.MULTI_AGENT_ALLOW_NON_DARWIN !== "1") {
+    console.error(
+      `multi-agent-pipeline supports macOS only. This host reports "${process.platform}".`,
+    );
+    console.error(
+      "Set MULTI_AGENT_ALLOW_NON_DARWIN=1 to proceed anyway; nothing on that path is tested.",
+    );
+    process.exit(3);
+  }
+  console.error(
+    `warning: MULTI_AGENT_ALLOW_NON_DARWIN=1 on "${process.platform}" - untested, unsupported.`,
+  );
+}
+
 if (command === "--version" || command === "-v" || command === "version") {
   const pkg = JSON.parse(readFileSync(join(__dirname, "package.json"), "utf-8"));
   console.log(pkg.version);

package/install/_dev-only-files.mjs

@@ -65,7 +65,6 @@ const DEV_ONLY_TOOLING = Object.freeze([
   "validate-schemas.mjs", // validates the repo's own schema files, needs ajv
   "sync-parity-check.sh",
   "benchmark-phase-0.sh",
-  "gate-linux.sh", // drives .github/workflows/ci-lite.yml through act; no consumer has either
 ]);
 
 /** Eval harnesses (`eval-*.mjs`) read `pipeline/eval/**`, which never ships. */

package/install/index.mjs

@@ -33,6 +33,16 @@ const TOOL_FLAGS = ["--claude", "--copilot", "--codex"];
  * @param {string[]} argv
  */
 export async function runInstall(argv) {
+  // index.js gates the CLI path; this repeats the check for programmatic
+  // importers, since `./install` is its own exports entry and can be called
+  // without ever passing through index.js.
+  if (process.platform !== "darwin" && process.env.MULTI_AGENT_ALLOW_NON_DARWIN !== "1") {
+    console.error(
+      `multi-agent-pipeline supports macOS only. This host reports "${process.platform}".`,
+    );
+    process.exit(3);
+  }
+
   const HOME = process.env.HOME || process.env.USERPROFILE;
   if (!HOME) {
     console.error(