logosFortuna-skill

LogosFortuna-Skill - UDIV Meta-Orkestrasyon Sistemi

Amac

LogosFortuna-Skill, her gorevi dort fazli bir donguyle cozer: Anla → Tasarla → Uygula → Dogrula (UDIV). Hicbir zaman anlamadan uygulamaya gecme. Her fazda kullanicidan onay al. Her oturumdan ogren.

Runtime Durumu

• Bu skill'in repodaki somut runtime karsiligi python -m logosfortuna udiv komutudur; faz plani, guardrail ve mevcut agent yuzeyi buradan okunabilir.
• commands/ ve agents/ altindaki markdown dosyalari host ortamin kesif/yonlendirme katmanidir; Python runtime model cagrilarini dogrudan yapmaz.
• Auto-rollback, Big-O profiler, chaos engineering ve MCP graph persistence gibi ileri ozellikler bu repoda kismi durumdadir. Uctan uca destek yoksa bunu acikca belirt.

Temel Kurallar

1. Asla anlamadan uygulama — Faz 1 tamamlanmadan kod yazma
2. Her fazda onay — Faz gecisleri kullanicinin acik onayiyla olur tier'a baglidir: L0'da her faz, L1'de 3-4, L2/L3'te sadece final. Detay: trust-tier-otonomi.md
3. Kucuk artimlar — Buyuk degisiklikler yerine kucuk, dogrulanabilir adimlar
4. Geri donus — Bir faz basarisiz olursa onceki faza don
5. Ogrenme — Her oturum sonunda ogrenimleri memory'ye kaydet
6. Constitution — Proje anayasasina (.specify/memory/constitution.md, v2.0.0) her zaman uy
7. Iddia uyumu — Repoda tam karsiligi olmayan ileri ozellikleri "kismi" veya "planlanan" olarak etiketle
8. Prompt Enrichment Pipeline — Her UDIV islemi Faz 1'de dort katmanli zenginlestirmeyle baslar: (0) MCP need-detection, (a) default suffix, (b) skill discovery, (c) web-search trust scoring
9. Onayli-Otomatik plugin/MCP kurulumu — Eksik tespit edildiginde AskUserQuestion ile sor, onaylanirsa Bash ile claude plugin install veya claude mcp add cagir. Asla sessizce kurma. (auto_install_policy default: approved-auto)
10. Telemetri — Her faz/agent calismasi .specify/telemetry/*.jsonl'a yazilir (telemetry_enabled = true ise). Veri lokal kalir, hicbir yere gonderilmez.
11. Trust-Tier otonomi (yeni v2.0.0) — Operator gorev basinda L0-L3 beyan eder; sistem risk artislarinda otomatik dusurur, asla yukseltmez. Detay: trust-tier-otonomi.md
12. Differential capability per agent (yeni v2.0.0) — Her agent en dar tool yuzeyiyle calisir; dogrulayan yazamaz, kiran degistiremez. Detay: differential-capability.md
13. Patching velocity > discovery rate (yeni v2.0.0) — Her bulgu remediation ile gelir; salt rapor kabul edilmez. Constitution Prensip 8.
14. Self-red-team mandatory for L2/L3 (yeni v2.0.0) — kirik-ajansi Faz 4'te 7 saldiri vektoru calistirir; critical bulguda L0'a iner. Constitution Quality Gate.

Prompt Enrichment Pipeline (Faz 1 Baslangicinda Otomatik)

Her UDIV islemi asagidaki dort katmanli zenginlestirmeyi otomatik calistirir:

Katman 0: MCP Need-Detection (yeni — 2026-05-12)

Faz 1'in en basinda, anahtar eylemler kullaniciyi prompt'undan ayiklanir ve gerekli MCP/plugin'ler tespit edilir:

• Eksik MCP varsa → auto-install-protokol ile AskUserQuestion yapilir
• Kullanici politikasina gore (approved-auto / autonomous / whitelist / suggest-only) aksiyon alinir
• Bash: claude plugin install <name>@claude-plugins-official veya claude mcp add <name> <cmd>

→ Detay: references/mcp-need-detector.md → Detay: references/auto-install-protokol.md

Katman 1: Default Meta-Prompt Suffix

Her islemede (agent system prompt, karmasik karar noktasi, Anlama Ozeti) asagidaki Ingilizce cumle eklenir:

Think step by step and challenge your own assumptions.

→ Detay: references/prompt-enrichment.md

Katman 2: Skill Discovery + Hybrid Otomasyon

Session'da yuklu skill'ler taranir, goreve uygun olan tespit edilir:

• BASIT skill (brand-guidelines, doc-coauthoring vb.) → otomatik dahil + bildir
• KARMASIK skill (frontend-design, ui-ux-pro-max vb.) → kullaniciya onay sor
• BILINMIYOR → skill-classifier-ajansi ile LLM-driven siniflandirma yapilir, sonuc Memory MCP'ye cache'lenir (ikinci karsilasmada cache hit)

→ Detay: references/skill-kesif-tablosu.md → Agent: ../../agents/skill-classifier-ajansi.agent.md

Katman 3: Web-Search-Based Enrichment + Trust Scoring

Her gorevde web search yapilir, sonuclar 0-100 guven skoruyla filtrelenir:

• >=90 (docs.anthropic.com, github.com/anthropics vb.) → otomatik dahil
• 70-89 → kullaniciya onay sor
• <70 → disla

→ Detay: references/kaynak-guven-skorlama.md

Onemli: Bu pipeline constitution Operational Defaults'u revize eder — web enrichment artik OTOMATIK ve HER GOREVDE, ancak trust scoring + fallback ile korunur.

Gorev Siniflandirma (UDIV Oncesi)

UDIV dongusune baslamadan once gorevin karmasikligini degerlendir:

Seviye	Kriter	UDIV Akisi
Basit	Tek dosya, acik istek, bilinen kalip	Anla (hafif) → Uygula → Dogrula
Orta	2-5 dosya, net kapsam, tek yaklasim yeterli	Anla → Tasarla (tek oneri) → Uygula → Dogrula
Karmasik	5+ dosya, belirsiz kapsam, mimari etki	Tam UDIV dongusu (2-3 yaklasim)

Context: Kullanici tek dosyada basit degisiklik istiyor user: "Bu fonksiyonun return type'ini degistir" assistant: Basit gorev → Anla (hafif) → Uygula → Dogrula akisi. Faz 2 (Tasarla) atlanir. Context: Kullanici yeni bir API endpoint eklemek istiyor user: "Kullanici profil API'si ekle" assistant: Orta gorev → Anla → Tasarla (tek oneri) → Uygula → Dogrula akisi. Context: Kullanici mimari degisiklik planliyor user: "Monolitten mikroservise gec" assistant: Karmasik gorev → Tam UDIV dongusu (2-3 yaklasim karsilastirmasi) baslatilir.

Dongu Koruma Limitleri

Kisir donguyu onlemek icin asagidaki limitler kesinlikle uygulanir:

Limit	Deger	Asim Durumunda
Faz geri donusu (ayni faz cifti)	Max 2	Kullaniciya eskale et
Artim deneme sayisi (ayni artim)	Max 3	DURDUR, kullaniciya raporla
Dogrulama-Uygulama turu	Max 2	Kalan sorunlari kullaniciya sun
Faz 1 kesfetme adimi	Max 7 arac cagrisi (enrichment pipeline dahil)	Mevcut bilgiyle ilerle
Toplam UDIV dongu tekrari	Max 1 tam tekrar	Tamamen dur

Sayac Takibi: Her faz basinda geri_donus_sayaci=0 olarak basla. Her geri donuste +1 artir. Limite ulasinca kullaniciya acikla ve karar iste.

UDIV Dongusu

Faz 1: ANLA

Kullanicinin gercekte ne istedigini ve mevcut sistemin nasil calistigini derinlemesine kavra. Maksimum 7 arac cagrisi (yeni enrichment pipeline dahil). "Yeterli Anlama Kriterleri"nin en az 4/5'i karsilaninca dur.

1. Default Suffix Aktivasyonu — "Think step by step and challenge your own assumptions." tum agent cagrilarinda otomatik eklenir
2. Skill Discovery — Session'daki yuklu skill listesi taranir, goreve uygun olan tespit edilir (hibrit kural)
3. Web Enrichment + Trust Scoring — Brave Search / WebSearch ile zenginlestirme, >=90 skor otomatik, 70-89 onay ister
4. Baglam Yukle — Memory graph, CLAUDE.md, constitution.md
5. Derin Kesfet — anlama-ajansi agent'ini calistir, kod yollarini iz, bagimliliklari haritalandir
6. Yapilandirilmis Dusunme — Karmasik isteklerde mcp__sequential-thinking__sequentialthinking kullan
7. Netlistirme — Belirsiz noktalarda kullaniciya soru sor
8. Anlama Ozeti Sun — Niyet, mevcut durum, etki alani, risk, on yaklasim, enrichment raporu
9. → KULLANICI ONAYI BEKLE

→ Detay: references/udiv-protokol.md

Faz 2: TASARLA

Birden fazla yaklasim uret (min 2, max 3), trade-off'lari degerlendir, en iyisini oner.

1. Yaklasim Uretimi — Her yaklasimdaki dosya degisikliklerini listele
2. Görsel Mimari Tasarımı — Seçilen veya önerilen yaklaşımın mimarisini Mermaid.js ile görselleştir
3. Degerlendirme — Constitution prensipleri, gecmis kararlar, trade-off analizi
4. Oneri — En iyi yaklasimi nedeniyle birlikte oner
5. → KULLANICI ONAYI BEKLE (yaklasim secimi)

→ Detay: references/udiv-protokol.md

Faz 3: UYGULA

Onaylanmis tasarimi kucuk, dogrulanmis artimlarla hayata gecir. Her artim max 3 deneme.

1. Self-Healing (Auto-Rollback) Hazırlığı — Kritik degisikliklerde rollback planini hazirla; repodaki otomatik git stash / temp branch akisi henuz kismi oldugu icin kullaniciya gorunur kal
2. Artim Planlama — En kucuk bagimsiz artimlara bol
3. Akıllı Bağlam Budama (Context Pruning) — Uzun dongulerde eski loglari ozetle, ancak repoda otomatik summarization yoksa bunu elle ve acikca yap
4. Artimsal Uygulama — uygulama-ajansi calistir, her artimdan sonra dogrula (syntax, test, lint)
5. Ilerleme Raporu — Tamamlanan/kalan artimlar, sorunlar ve cozumler
6. → KULLANICI ONAYI BEKLE

→ Detay: references/udiv-protokol.md

Faz 4: DOGRULA ve OGREN

Sonucu cok boyutlu dogrula ve ogrenimleri kaydet.

1. Kapsamli Dogrulama — dogrulama-ajansi ile 5 boyut: fonksiyonel, anayasal, niyetsel, yapisal, regresyon
2. Canlı Maliyet/Performans Profiler — Statik risk analizi ve mevcut kalite verileriyle performans risklerini raporla; tam Big-O profiler bu repoda kismi
3. Proaktif Tehdit Avcılığı (Chaos Engineering) — Hazir harness yoksa chaos/mutation basligini tamamlanmis gibi sunma; onerilen senaryolar olarak raporla
4. Guvenlik Tarama — guvenlik-ajansi ile OWASP Top 10 ve SANS Top 25 kontrolu
5. Kalite Analizi — kalite-ajansi ile kod kalitesi skoru (0-100) ve iyileştirme önerileri
6. Self-Red-Team (yeni v2.0.0) — kirik-ajansi ile 7 saldiri vektoru. L2/L3 icin zorunlu gate. Critical bulgu → otomatik L0'a iner. Detay: agents/kirik-ajansi.agent.md
7. Patching Velocity kontrolu (yeni v2.0.0) — Her bulgu remediation ile mi geliyor? Constitution Prensip 8 ihlali varsa Faz 3'e don.
8. Sorun Cozumu — Kritik → Faz 3'e don (max 2 tur), kucuk → yerinde duzelt
9. Ogrenme — ogrenme-ajansi ile tercihleri, kaliplari, basarili yaklasimlari kaydet; MCP yoksa fallback tablosunu uygula
10. Son Rapor — Ne yapildi, nasil dogrulandi, ne ogrendi + (L3 ise) feature branch'e otomatik commit/push

→ Detay: references/udiv-protokol.md

Arac Orkestrasyon

Detayli arac secim mantigi ve fallback tablosu: references/arac-orkestrasyon.md

Hizli Referans:

• Bilgi kaliciligi → mcp__memory__*
• Karmasik akil yurutme → mcp__sequential-thinking__sequentialthinking
• Kod kesfetme → Explore agent veya Glob/Grep
• Harici bilgi → mcp__brave-search__brave_web_search veya WebSearch
• GitHub islemleri → mcp__github__*
• Dosya islemleri → Read, Write, Edit

Arac Erisilebilirlik

MCP araclari her ortamda mevcut olmayabilir. Bir arac "tool not found" hatasi verirse:

1. Fallback tablosuna bak ve alternatife gec
2. Ayni araci tekrar deneme, fallback'te kal
3. Kullaniciya bildir: "X araci mevcut degil, Y ile devam ediyorum"

Faz Basarisizlik Protokolu

Faz 4 basarisiz → sayac[4→3] += 1 → sayac <= 2: Faz 3'e don | sayac > 2: DURDUR
Faz 3 basarisiz → sayac[3→2] += 1 → sayac <= 2: Faz 2'ye don | sayac > 2: DURDUR
Faz 2 basarisiz → sayac[2→1] += 1 → sayac <= 2: Faz 1'e don | sayac > 2: DURDUR
Faz 1 basarisiz → Kullaniciya daha fazla bilgi sor

Her geri donuste neden geri donuldugunu acikla ve onceki fazin ciktisini guncelle. 3. Geri donus sayacini raporla: "Bu faz ciftinde X/2 geri donus kullanildi"

Iptal Protokolu

Kullanici "iptal", "dur", "vazgec", "birak" gibi ifadeler kullandiginda:

1. Mevcut calismay hemen durdur — yarim kalmis islem varsa tamamla veya geri al
2. Durum raporu sun:

   ## Iptal Raporu
   - Tamamlanan fazlar: [liste]
   - Aktif faz: [faz adi] — [ilerleme %]
   - Yapilan degisiklikler: [dosya listesi]
   - Geri alinmasi gereken degisiklik: [varsa]
   

3. Secenekler sun:
   • "Yapilanlari koru, sadece dur"
   • "Tum degisiklikleri geri al (git checkout .)"
   • "Farkli bir noktadan devam et"
4. Kullanicinin secimini uygula

Çoklu Dil Desteği

LogosFortuna uluslararası kullanım için çoklu dil desteği sağlar. Desteklenen diller: Türkçe (ana dil), İngilizce, Almanca, Fransızca. Otomatik n-gram tabanlı dil algılama ve kültür-spesifik adaptasyon (naming conventions, tarih formatları, iletişim tarzı) sağlanır.

Entegrasyon ve Otomasyon

Detaylı entegrasyon yetenekleri için scriptlere bakın: scripts/entegrasyon-sistemi.py

Desteklenen Entegrasyonlar:

• GitHub: Config ve repo listesi yonetimi hazir; PR otomasyonu ve branch protection host/tool bagimli ve su an kismi
• Slack/Discord: Gerçek zamanlı bildirimler, batch gruplama, sessiz saatler
• CI/CD: Jenkins/GitLab CI config modeli mevcut; otomatik kalite gate ve rollback akislari kismi
• Webhook: Özel webhook desteği, retry mekanizması, event filtreleme

Güvenlik ve Kalite Kapıları

Detaylı doğrulama kriterleri: references/kalite-kapilari.md

Özet:

• Güvenlik: OWASP Top 10 + SANS Top 25 regex tabanlı tarama
• Kalite: Çok boyutlu skorlama (teknik %40, bakım %30, test %20, dokümantasyon %10)
• Kapılar: Minimum skor zorunlulukları, istisna yönetimi, sürekli izleme

Performans

• Caching: Analiz sonuçları 24h TTL ile cache'lenir, dosya değişikliklerinde invalidation
• Lazy Loading: Sadece aktif/modified dosyalar analiz edilir
• Paralel İşleme: Tasarim hedefi olarak tanimli; repodaki Python runtime bunu henuz uctan uca zorlamaz

Komut Referansi (Sprint 2 ile genisletildi)

Komut	Aciklama
/lf	Tam UDIV dongusu (Anla → Tasarla → Uygula → Dogrula)
/lf-anla	Sadece Faz 1: derin anlama ve baglam haritasi
/lf-dogrula	Sadece Faz 4: mevcut degisikleri 5 boyutlu dogrula
/lf-rapor [gun]	Telemetri ozeti (default son 7 gun) — faz sureleri, geri donus oranlari, install onerileri
/lf-update	GitHub'da yeni surum var mi kontrol et, onaylanirsa guncelle

Yeni Mimarı Bilesenler (2026-05-20) — Mythos-Inspired v2.0.0

Trust-Tier Otonomi + Self-Red-Teaming + Differential Capability

Tier seciminden Faz 4'e:
  ├── Operator beyani: L0 (default) / L1 / L2 / L3 + opt elevated-trust
  ├── Faz gecisleri tier'a gore (L0 her faz, L2/L3 kesintisiz)
  ├── Auto-downgrade tetikleyicileri sinyal-tabanli
  └── Faz 4'te:
      ├── dogrulama-ajansi (mevcut)
      ├── kirik-ajansi (YENI, L2/L3 mandatory gate)
      └── Patching Velocity check (Constitution Prensip 8)

Iliskili Yeni Dosyalar (v2.0.0)

• references/trust-tier-otonomi.md — L0-L3 otonomi tanimi, auto-downgrade tetikleyicileri, beyan sintaksi
• references/differential-capability.md — Agent rol-bazli tool allowlist matrisi, execute komut whitelist'i
• agents/kirik-ajansi.agent.md — Self-red-teamer, 7 saldiri vektoru kataloğu
• .specify/memory/constitution.md — v2.0.0: Prensip 8, 9, 10 eklendi; Quality Gate'lere "findings ship with remediations" ve "self-red-team pass" eklendi

Onceki Mimari Bilesenler (2026-05-12)

Auto-Install + Skill Discovery + Telemetri

Faz 1 ANLA basinda otomatik:
  ├── Katman 0: MCP Need-Detector → eksik MCP tespit → AskUserQuestion → claude mcp add
  ├── Katman 1: Default suffix injection (Think step by step + challenge assumptions)
  ├── Katman 2: Skill discovery + skill-classifier-ajansi (LLM siniflandirma)
  └── Katman 3: Web enrichment + trust scoring

Her faz tamamlandiginda:
  └── telemetry-writer.py → .specify/telemetry/udiv-runs-*.jsonl

Iliskili Yeni Dosyalar

• references/auto-install-protokol.md — Onayli-Otomatik kurulum karar agaci
• references/mcp-need-detector.md — eylem→MCP haritasi
• references/self-update.md — surum kontrol ve guncelleme
• agents/skill-classifier-ajansi.agent.md — LLM-driven skill siniflandirici
• scripts/telemetry-writer.py — JSONL telemetri writer + summarize CLI
• scripts/evals/golden-tests.jsonl — UDIV protokolu kendi kendini test eden golden set
• scripts/evals/runner.py — eval runner

Hata Yönetimi

• Sınıflandırma: Kritik, kurtarılabilir, uyarı, bilgilendirme seviyeleri
• Otomatik Kurtarma: Retry mekanizmasi ve fallback sistemleri mevcut; tam state recovery / rollback akisi kismi
• İzleme: Gerçek zamanlı monitoring, hata loglama, alert sistemi