**Focus modları** (isteğe bağlı, `-` ile): ``` /project-analysis # Tüm kategoriler (12 lead) /project-analysis -backend # API, DB, Arch, Security /project-analysis -frontend # UI/UX, Content, A11y /project-analysis -security # Sadece Security (SecLead/Opus) /project-analysis -optimize # Perf, Arch, Data /project-analysis -feature # Growth, Biz, Content /project-analysis -test # Tüm kategorilerde test boşlukları /project-a...
Scanned 5/27/2026
Install via CLI
Skills Directoryopenskills install SkyWalker2506/claude-config# /project-analysis [-focus]
**Focus modları** (isteğe bağlı, `-` ile):
```
/project-analysis # Tüm kategoriler (12 lead)
/project-analysis -backend # API, DB, Arch, Security
/project-analysis -frontend # UI/UX, Content, A11y
/project-analysis -security # Sadece Security (SecLead/Opus)
/project-analysis -optimize # Perf, Arch, Data
/project-analysis -feature # Growth, Biz, Content
/project-analysis -test # Tüm kategorilerde test boşlukları
/project-analysis -refactor # Arch, Perf — teknik borç
/project-analysis -backend -security # Kombinasyon
```
**Focus → Lead mapping:**
| Focus | Çalışan Lead'ler | Atlanan Lead'ler |
|-------|-----------------|-----------------|
| `-backend` | CodeLead, SecLead | ArtLead, GrowthLead, BizLead |
| `-frontend` | ArtLead | CodeLead, GrowthLead, BizLead, SecLead |
| `-security` | SecLead | ArtLead, CodeLead, GrowthLead, BizLead |
| `-optimize` | CodeLead (Perf+Arch+Data) | ArtLead, GrowthLead, BizLead, SecLead |
| `-feature` | GrowthLead, BizLead | ArtLead, CodeLead, SecLead |
| `-test` | Tüm Lead'ler (test gaps modu) | — |
| `-refactor` | CodeLead (Arch+Perf) | ArtLead, GrowthLead, BizLead, SecLead |
| `-docs` | ArtLead (Content) | CodeLead, GrowthLead, BizLead, SecLead |
Focus varsa dispatch tablosunda atlanan lead'ler `(atlandı)` olarak gösterilir.
Focus flag'leri forge'dan geçilebilir — forge Phase 1'de `/project-analysis -backend` gibi çağırır.
---
> **ÖNEMLİ — skill başlamadan önce:**
> Kullanıcıya şunu göster:
>
> ```
> Analiz başlamadan önce /compact önerilir (agent'lar çok token tüketir).
>
> 1) /compact çalıştır, sonra devam et
> 2) Geç ve devam et
> ```
>
> Kullanıcı "1" yazarsa → yanıt olarak **sadece şunu yaz, başka hiçbir şey ekleme:**
>
> /compact
> Kullanıcı "2" veya sadece Enter basarsa → direkt devam et.
## Başlamadan Önce ZORUNLU Oku
`PROJECT_ANALYSIS.md` dosyasını oku — özellikle şu bölümler:
- **§2** — Lead hiyerarşisi ve "dispatches" ne anlama geldiği (Lead ayrı process başlatmaz, bizzat analiz eder)
- **§4** — Agent registry ve model mapping tablosu (Claude Code Model kolonu dahil)
- **§5** — Lead prompt şablonu (birebir uygula, kendi yorumunu katma)
Bu okuma yapılmadan Lead prompt'ları yazılmaz.
---
Bu skill tetiklendiğinde aşağıdaki adımları izle:
## Referans
Tam protokol: `__PROJECTS_ROOT__/PROJECT_ANALYSIS.md`
O dosyayı oku ve içindeki talimatlara **harfiyen** uy.
---
## Adım -1 — Agent Erişilebilirlik Kontrolü (HER ZAMAN İLK ÇALIŞIR)
`scripts/check-agent-availability.sh` çalıştır (Bash tool ile).
Çıktıdaki her `UNAVAILABLE:` satırı için formatı parse et:
```
UNAVAILABLE: <model_tipi> | <neden> | <kurulum_talimatı> | <fallback>
```
Her ulaşılamayan agent için kullanıcıya sor:
```
⚠️ [MODEL_TIPI] ulaşılamıyor — [NEDEN]
Ne yapalım?
1) Kurulum yap — [KURULUM_TALİMATI]
2) Alternatif kullan — [FALLBACK] modeli ile devam et
3) Bu agent'ı atla
4) Tüm ulaşılamazlara alternatif uygula (bu oturum)
```
Tam protokol: `PROJECT_ANALYSIS.md §7`
Tüm seçimler alındıktan sonra → **Adım 0'a geç**
---
## Adım 0 — Proje Tespiti (YENİ — HER ZAMAN İLK ÇALIŞIR)
Mevcut proje dizinini tara:
```
Glob: **/* (max depth 2)
Kontrol et: kaynak kod var mı? (lib/, src/, app/, pubspec.yaml, package.json, vb.)
```
### Senaryo A — Boş / Yeni Proje (kod yok, sadece README veya hiçbir şey yok)
```
Bu proje henüz kurulmamış. Analiz yapabilmem için önce projeyi anlamam gerekiyor.
Sana birkaç soru soracağım — cevaplarından bir proje brief'i oluşturacağım.
Sonra istersen tech stack tavsiyesi de verebilirim.
Devam edelim mi? (enter = evet)
```
**A14 DiscoveryAgent** başlat — `PROJECT_ANALYSIS.md §0`'daki soruları kullanır.
Discovery tamamlanınca kullanıcıya sor:
```
Brief hazır. Şimdi ne yapalım?
1) Tech stack tavsiyesi al (A15 TechLead)
2) Direkt projeyi kur (kurulum adımlarına geç)
3) İkisi de — önce stack karar ver, sonra kur
```
### Senaryo B — Mevcut Proje (kod var)
`project-brief.md` var mı kontrol et:
- Varsa → brief'i oku, analiz moduna geç
- Yoksa → "Proje hakkında kısa bir brief oluşturalım mı? (Y/N)" sor
- Y → A14 çalıştır (hızlı mod, 3 soru), sonra analiz moduna geç
- N → direkt analiz moduna geç
---
### Paralel Research Phase (Phase 1'den önce)
Analysis başlamadan önce 4 paralel research agent çalıştırılır. Her biri farklı açıdan projeyi araştırır:
| Researcher | Odak | Çıktı |
|-----------|------|-------|
| **Stack Researcher** | Tech stack, versiyon, bağımlılıklar, uyumluluk | `analysis/research-stack.md` |
| **Feature Researcher** | Mevcut özellikler, eksikler, rakip karşılaştırma | `analysis/research-features.md` |
| **Architecture Researcher** | Kod yapısı, pattern'ler, coupling, complexity | `analysis/research-architecture.md` |
| **Risk Researcher** | Güvenlik açıkları, performans darboğazları, teknik borç | `analysis/research-risks.md` |
**Çalışma şekli:**
1. 4 agent paralel `run_in_background: true` ile başlatılır
2. Her agent kendi dosyasına yazar (max 3-5KB)
3. Tüm research tamamlanınca Lead'lere context olarak verilir
4. Lead'ler research çıktılarını okuyarak daha derin analiz yapar
**Focus modu etkisi:**
- `-backend`: Stack + Architecture + Risk researcher çalışır (Feature atlanır)
- `-frontend`: Stack + Feature researcher çalışır (Architecture + Risk atlanır)
- `-security`: Risk researcher tek başına, detaylı (Opus modeli ile)
- Diğer focus'lar: 4'ü de çalışır, sonuçlar focus'a göre filtrelenir
Research phase max 3 dakika sürer. Timeout olan researcher atlanır, lead'ler onsuz devam eder.
---
## Adım 1 — Agent atama modunu sor
```
Analiz için ajan atama modunu seç:
1) Lead Orchestrator — A1 projeyi inceler, her departman için Lead + ajan atar
2) Manuel — her kategori için ajan ve modeli kendim seçerim
3) Hızlı — tüm kategoriler Sonnet ile, standart agent'lar
Seçiminiz (1/2/3):
```
**1 seçilirse (Lead Orchestrator):**
- A1 (Lead Orchestrator) kısa bir proje taraması yapar
- Her Lead departmanı için: hangi kategoriler, hangi worker agent'lar, hangi modeller → bir atama haritası çıkarır
- Kullanıcıya haritayı göster, onay al
- Leads'leri paralel başlat (`run_in_background=true`)
**2 seçilirse (Manuel):**
- Her kategori için sırayla sor: `Evet / Hayır / Kısmen`
- Kabul edilen her kategori için: hangi agent ID? hangi model?
- `PROJECT_ANALYSIS.md` §3'teki kategori + agent eşleşme tablosuna bak, öner
**3 seçilirse (Hızlı):**
- Tüm 12 kategoriyi Sonnet modeli + varsayılan agent'larla başlat (kategori seçimi yok)
## Adım 2 — Lead'leri başlat (paralel, background)
Her Lead departmanı için bir Agent başlat (`run_in_background=true`).
Lead agent prompt şablonu (`PROJECT_ANALYSIS.md` §5'teki şablonu kullan):
- Lead rolü ve sorumlu kategoriler
- Her kategori için atanan worker agent ve model
- Proje kökü
- Çıktı: `[PROJE]/analysis/[NN_kategori].md`
Lead yapısı:
- **ArtLead** → UI/UX (#1), Content (#8), Accessibility (#11)
- **CodeLead** → Performance (#2), Data (#4), Architecture (#10)
- **GrowthLead** → SEO (#3), Growth (#6), Analytics (#9)
- **BizLead** → Monetization (#5), Competitive (#12)
- **SecLead** → Security (#7)
### Agent Dispatch Tablosu
Lead'ler başlatılmadan önce kullanıcıya dispatch tablosunu göster:
```
━━ Agent Dispatch ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Agent Model Kategoriler
───────── ─────────── ──────────────────────────
ArtLead Sonnet 4.6 UI/UX, Content, A11y
CodeLead Sonnet 4.6 Perf, Data, Arch
GrowthLead Sonnet 4.6 SEO, Growth, Analytics
BizLead Sonnet 4.6 Monetization, Competitive
SecLead Opus 4.6 Security
Master Opus 4.6 Final report (Phase 4)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```
Bu tablo her zaman gösterilir — kullanıcı hangi agent'ın hangi modelle çalıştığını bilmeli.
## Adım 3 — Watchdog
Her 3 dakikada bir durum göster (model bilgisi dahil):
```
Analiz durumu (X/Y tamamlandı):
✅ ArtLead [Sonnet 4.6] 3m 12s — UI/UX ✅, Content ✅, A11y ✅
✅ SecLead [Opus 4.6] 2m 30s — Security ✅
⏳ CodeLead [Sonnet 4.6] 4m 45s — Perf ✅, Data ✅, Arch ⏳
⏳ GrowthLead[Sonnet 4.6] 3m 50s — SEO ✅, Growth ⏳, Analytics ⏳
⏳ BizLead [Sonnet 4.6] 2m 10s — Monetization ⏳, Competitive ⏳
```
8 dakika geçen lead → kullanıcıya sor, onay gelirse yeniden başlat.
## Adım 4 — Master rapor
Tüm Lead'ler tamamlanınca bir **Opus agent** başlat:
- Tüm kategori raporlarını oku
- `[PROJE]/analysis/MASTER_ANALYSIS.md` oluştur
- `PROJECT_ANALYSIS.md` §6'daki master rapor yapısını kullan
- Cross-cutting insights + top 20 aksiyon listesi + maliyet tablosu
## Adım 5 — Kullanıcıya göster
1. Agent execution özeti (her agent: model, süre, çıktı sayısı)
2. Master rapor özeti
3. Dosya konumları
4. En kritik 5 aksiyon
```
━━ Execution Summary ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Agent Model Süre Çıktı
───────── ─────────── ────── ─────
ArtLead Sonnet 4.6 3m 12s 3 reports
CodeLead Sonnet 4.6 4m 45s 3 reports
GrowthLead Sonnet 4.6 3m 50s 3 reports
BizLead Sonnet 4.6 2m 10s 2 reports
SecLead Opus 4.6 2m 30s 1 report
Master Opus 4.6 1m 45s MASTER_ANALYSIS.md
───────── ─────────── ────── ─────
Total 6 agents 18m 12s 13 files
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```
## When NOT to Use
- Tek satirlik basit soru/cevap ise
- Skill'in scope'u disindaysa
- Riskli/destructive is ise (ayri onay gerekir)
## Red Flags
- Belirsiz hedef/kabul kriteri
- Gerekli dosya/izin/secret eksik
- Ayni adim 2+ kez tekrarlandi
## Error Handling
- Gerekli kaynak yoksa → dur, blocker'i raporla
- Komut/akıs hatasi → en yakin guvenli noktadan devam et
- 3 basarisiz deneme → daha uygun skill/agent'a yonlendir
## Verification
- [ ] Beklenen cikti uretildi
- [ ] Yan etki yok (dosya/ayar)
- [ ] Gerekli log/rapor paylasildi
No comments yet. Be the first to comment!
