@mmerterden/multi-agent-pipeline

🇬🇧 English: README.md

Claude Code, Copilot CLI ve Codex CLI için 6 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. Yalnızca macOS. Sıfır runtime dependency.

📐 Mimari diyagramları - 6 faz akışı, çalışma modları, review/triage, Figma subphase'leri, component yapısı. Ekosistem diyagramı - bu repo, multi-agent-plugins marketplace'i ve multi-agent-toolkit-mcp'nin nasıl bir araya geldiği.

Önkoşullar

• Node.js >= 20.11 - zorunlu; pipeline'ın kendi araçları bunun üzerinde koşuyor.
• 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ıç

# public registry'den (auth gerekmez) - sadece kullandığın CLI'ları seç
npx @mmerterden/multi-agent-pipeline install --claude    # sadece Claude Code (varsayılan)
npx @mmerterden/multi-agent-pipeline install --copilot   # sadece Copilot CLI
npx @mmerterden/multi-agent-pipeline install --codex     # sadece Codex CLI
npx @mmerterden/multi-agent-pipeline install --all       # üçü birden

# sonra, bir kere:
/multi-agent:setup          # keychain token taraması + git kimliği + varsayılan stack

O makinede npx yoksa

npx npm ile, npm de Node ile gelir - yani "npx: command not found" neredeyse her zaman o kabukta Node olmadığı anlamına gelir, pakette bir sorun olduğu değil. Önce bak, sonra sana uyan satırı uygula:

node -v; npm -v; command -v node npm npx

| Gördüğün | Yapılacak | | --------------------------------------------- | ----------------------------------------------------------------------------------------- | | hiçbiri yok | Node >= 20.11 kur: brew install node ya da nodejs.org'dan LTS installer | | node çalışıyor, npx çalışmıyor | npm i -g @mmerterden/multi-agent-pipeline sonra multi-agent-pipeline install --claude | | nvm kurulu ama kabuk görmüyor | source ~/.nvm/nvm.sh && nvm use --lts, ya da yeni bir terminal aç | | npm çok eski (< 5.2, npx'ten önceki sürümler) | npm i -g npm@latest, ya da üstteki global kurulum satırı |

Ne npx ne de global kurulum isteyen yol - klonla ve installer'ı doğrudan çalıştır:

git clone https://github.com/mmerterden/multi-agent-pipeline.git
cd multi-agent-pipeline
node index.js install --claude        # önce --dry-run ile ne yazacağını görebilirsin

npm exec @mmerterden/multi-agent-pipeline install --claude de, PATH'te npx olmayan her npm 7+ üzerinde çalışır.

npx sorunu olmayan bir hata. Bu paket os: ["darwin"] beyan eder; npm başka hiçbir yerde kurmaz ve npm ERR! notsup Unsupported platform der. Bu kasıtlıdır (ADR-0012), eksik bir araç değil: her credential okuması security, her iOS build'i xcodebuild, her görsel kanıt simctl çağırıyor.

Tool flag'leri birleştirilebilir (--claude --codex). Hiç tool flag'i verilmezse installer sadece Claude Code'u hedefler. Diğer flag'ler: --dry-run (ne yazılacağını gösterir, hiçbir şey yazmaz), --platform=ios|android|all (ihtiyacın olmayan stack skill'lerini atlar), --link (kopyalamak yerine symlink, lokal geliştirme için).

Bir görev çalıştır - girdi tipi otomatik algılanır:

/multi-agent "PROJ-1234"                              # Jira id → çek, planla, geliştir
/multi-agent "https://github.com/org/repo/issues/42"  # GitHub issue URL'i
/multi-agent "my-app#42"                              # repo + issue numarası
/multi-agent "fix dark-mode contrast on LoginView"    # serbest-metin bug/özellik
/multi-agent:jira                                     # açık Jira issue'larını gez → seç
/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.

Onayları atlamak için autopilot ekle (örn. /multi-agent:autopilot "PROJ-1234"). Çalışma alanı bayrak değil: koşunun kendi şekli hakkında sorduğu tek soru, Faz 0'da nerede koşacağı - worktree mi, mevcut checkout'un mu. autopilot bu soruyu sormadan worktree'ye karar verir.

Sonra /multi-agent:update ile güncelle. Kaldırmak için (tokenlar korunur) npx @mmerterden/multi-agent-pipeline uninstall.

Stack skill'leri marketplace plugin'leridir. Claude Code'da ai-<stack>-toolkit plugin'leri (multi-agent-plugins marketplace) tek stack-skill kaynağıdır - ~/.claude/skills altına kopya konmaz. Repo başına aktif stack'leri /multi-agent:stack ile seç (çoklu seçim: ios backend, ya da argümansız native picker); her plugin ai-<stack>-toolkit:help ile dilinde katalog sunar. Copilot CLI ve Codex CLI'da plugin loader olmadığından onlara aynı enabled stack'lere filtreli lokal kopya iner.

Nasıl çalışır

Tek komut 6 fazı çalıştırır, riskli olanlar arasında bir kapı ile. Her koşu tüm kümeyi taşır; Faz 0'ın şekil hakkında sorduğu tek soru branch'in nerede yaşayacağı: worktree mi, mevcut checkout'un mu.

• 0 · Init - girdiyi ayrıştır (Jira id / GitHub URL / serbest metin), hesap + repo(lar) seç, issue'yu çek, maturity kontrolü yap.
• 1 · Plan - stack'i tespit et, codebase'i tara ve analiz dokümanını yaz; sonra onu dosya seviyesinde hedefleri olan görevlere böl ve koda dokunmadan önce onayın için dur. Analiz ve planlama tek bir karar, bu yüzden tek faz (ADR-0014). 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.

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.

/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. 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

Pipeline'ın varsaymak yerine baktığı üç yer:

• 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 bir sonucu var

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 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.

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

Faz 0 Adım 3 sormadan önce adayları her birinin arkasındaki kanıtla topluyor. Hedef sürüm alanı taşıyan ya da release'i temsil eden ayrı bir maddeye bağlı bir issue, release dallarını sürümle adlandıran bir repoda branch'i zaten söylüyor - bu, nedenini açıklayan sıralı bir satır oluyor; yanında "reponun varsayılan dalı" ya da "geçen sefer bunu kullandın" diyen satırlar duruyor. Seçim yine senin; kanıt yalnızca sıralamayı değiştiriyor.

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 düz branch listesiyle sorar.

Çalışma alanı: worktree mi lokal mi

Faz 0 Adım 5b branch'in nerede yaşayacağını sorar. Worktree (.worktrees/{id}/) mevcut checkout'una dokunmaz; Lokal proje kökünde yeni bir branch'te çalışır ve proje kökünün temiz olmasını ister. Bu bir soru, bayrak değil: :local komutu da --local anahtarı da yok, yani cevap koşunun nasıl yazıldığına gömülmek yerine koşunun içinde görünür. autopilot sormadan worktree'ye karar verir: gözetimsiz bir koşu nerede duruyorsa oradan commit'leyip push eder, ve bunu senin kendi checkout'unda yapmak tam olarak worktree'nin engellemek için var olduğu şeydir. Review'ın sonundaki manuel test önerisi de aynı cevabı izler: worktree koşusuna branch'i checkout edip test etmek isteyip istemediği sorulur, lokal koşu zaten o checkout'un içindedir, yani önerilecek bir şey yoktur.

Perde arkasında: her görev kendi git worktree'sinde çalışır (ya da lokal seçtiğinde mevcut branch'te), commit'ler repo'nun origin URL'inden yönlendirilen git kimliğini kullanır, ve çoklu-repo görevleri repo başına worktree artı bir integration build alır. Tokenlar OS keychain'de kalır; hiçbir şey commit edilmez ya da loglanmaz. /multi-agent:review mevcut bir GitHub/Bitbucket PR'ını da review edebilir - file:line'a bağlı bulgu-başına inline yorumlar + açık bir Approve / Needs-Work durumu.

Bunun arkasındaki disiplin - sınırlı loop'lar, kanıt kapıları, token-bütçeli faz dokümanları, değişmez testler, taze-context handoff'lar - docs/engineering.md'de kataloglanmıştır. Tam özellik listesi docs/features.md'te. Bu repo, multi-agent-plugins marketplace'i ve multi-agent-toolkit-mcp sunucusunun install zamanında ve run zamanında nasıl bir araya geldiği docs/ecosystem.md'de diyagramlanmıştır.

Modlar

| Mod | Komut | Akış | | --------- | ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Full | /multi-agent "task" | Tüm 6 faz, interaktif | | Autopilot | /multi-agent:autopilot "task" | Aynı 6 faz, onaysız; çalışma alanı worktree'ye çözülür ve Review içindeki kullanıcı-test kapısı atlanır | | Audit | /multi-agent:design-check | Mock-mode vs Figma uygunluğu, yalnızca lokal | | Audit | /multi-agent:testflight-validation | TestFlight build için pre-submission kapıları: statik archive denetimi → Apple'ın altool --validate-app'i → Review-Guidelines kontrolü. Yalnızca doğrular, asla yüklemez |

Koşunun kendisinde ayarlanabilen tek şey autopilot; geri kalan her şey kendi komutu. Tam katalog aşağıda.

Komutlar

/multi-agent ve 61 alt komut. /multi-agent:help aynı katalogu terminalde, outputLanguage ayarına göre gösterir.

Pipeline girişleri

| Komut | Ne yapar | | ------------------------------------- | ----------------------------------------------------------------------------------------------- | | /multi-agent "task" | Pipeline; branch'in nerede yaşayacağını Faz 0 sorar | | /multi-agent:autopilot "task" | Aynı pipeline, gözetimsiz: worktree'ye çözülür, onay sorulmaz | | /multi-agent:resume | Yarım kalan iş, iki kaynaktan da: duran koşu kaldığı yerden devam eder, arkasında koşu olmayan branch kuyruğu alır (Review → Build+Test → Commit/PR → Report) |

Görev kontrolü

| 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; arkasında koşu olmayan branch için kuyruğu çalıştırır | | /multi-agent:kill [#N] | Görevi durdurur, worktree'sini ve branch'ini siler | | /multi-agent:steer #N "<talimat>" | Koşan bir görevi durdurmadan düzeltir; talimat bir sonraki faz sınırında uygulanır | | /multi-agent:search | Tüm görev loglarında sıralamalı arama; --semantic triyaj corpus'unu sorgular | | /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 | | /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

| 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: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

| 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 |

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 | | /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 |

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 |

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: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 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

İ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, 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. --now o an koşan maddeyi de durdurur, önce adını söyleyip sorar |

Autopilot (gözetimsiz)

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.

• 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
• 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
• 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ı
• 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
• İ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, stack adaptörleri
• 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, plan critic, review kararı
• 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, telefon API'si

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.

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 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, 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 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ı 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. 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 bir launchd kullanıcı ajanı, ve komutu hangi CLI'da yazdığın bunu değiştirmiyor. 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 marketplace'inde versiyonlu plugin'ler olarak gönderilir. Repo başına bir stack seç:

/multi-agent:stack ios        # veya android / frontend / backend / mobile / all

Bu, ilgili plugin'i (+ ortak ai-common plugin'ini) repo'nun .claude/settings.json'unda etkinleştirir. Phase 1, routing için stack'i otomatik tespit eder. Yeni repo'lar varsayılan olarak iOS'tur.

Araç desteği

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 + 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 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 pipeline tek bir multi-agent router gönderir ve alt-komut spec'lerini, okunana kadar hiçbir maliyeti olmayan referans dosyaları olarak tutar - aynı komutlar, aynı davranış, 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; 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.

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 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, 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ı | 2 | | 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.

Pipeline koşusu dışında

Pipeline'ı kurmak yalnız onu çalıştırdığında işe yaramıyor. Sıradan bir oturum açtığında aynı üç şey elinin altında; her sohbette yüklenen rules/outside-the-pipeline.md bunları duyuruyor:

• Zaten onboard ettiğin servisler. setup'ın eşlediği token okunabilir durumda - mantıksal adı credential-store.sh ile çöz, issue'yu, sayfayı, logu getir. Okuma sıradan iş, yazma değil. Jira yorumu, issue düzenleme ve PR açma pipeline komutlarından geçer, çünkü onları güvenli kılan kurallar (issue asla otomatik kapanmaz, Closes: değil Ref:, dışa dönük metinde humanizer) orada yaşıyor.
• /multi-agent:stack'in bu repo için açtığı stack skilleri. Yönlendirmeyi her toolkit'in kendi index skill'i yapar; pipeline o tablonun kopyasını tutmaz.
• multi-agent-toolkit MCP. Çalışan uygulama için 80+ araç - ekran durumu, crash logu, tasarım karşılaştırma, store ön-kontrolü.

Uninstall bu katmanı korur: token'lar, onları açan okuyucu, adlarını tutan eşleme ve MCP kaydı. Pipeline'ı kaldırmak, onun üzerinden onboard ettiğin credential'ları kaybetmek anlamına gelmemeli.

Platform desteği

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.

Yan repolar

| Repo | Ne olduğu | | --------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 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 | 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 olarak yayınlanır; installer her CLI'a onu senin için register eder, böylece npx ekstra konfigürasyon olmadan onu çözer. |

Lisans

MIT - bkz. LICENSE. Güvenlik sorunları: bkz. SECURITY.md (zafiyetler için public issue açma).