🚀 KodAkış-AIOS

KodAkış-AIOS, çoklu ajan sisteminizi yerel bir şablondan çıkarıp, herhangi bir projeye ve editöre (Cursor, Windsurf, Roo Code, Antigravity vb.) tek tıkla entegre olabilen küresel ve akıllı bir Yapay Zeka Ajan Yönetim ve Kolektif Hafıza Sistemi'dir.

🌐 English README (İngilizce Versiyon)

🔒 Güvenlik, Gizlilik ve Açık Rıza Politikası

KodAkış-AIOS, "Sıfır Bilgi Güvenliği" (Zero-Knowledge Privacy) ilkesi ile çalışarak kod güvenliğinizi en üst düzeyde korur.

• %100 Yerel Semantik Dizin: Kod parçacıkları ve semantik indeksler kesinlikle yerel makinenizde saklanır ve işlenir. Kodunuz asla hiçbir sunucuya sızdırılmaz.
• Şeffaf ve İzinli Telemetri (Opt-In Only): Kurulum esnasında size açıkça sorulur. Tercihinizi belirtmeden hiçbir ham veri toplanmaz.
• Kolektif Hafıza Akışı: aios sync komutu çalıştırıldığında merkeze veri akmaz; tam aksine, merkezdeki küresel hata çözüm kuralları yerel makinenize indirilerek yerel indeksinizi akıllı hale getirir.

[!NOTE] Detaylı güvenlik, gizlilik ve rıza şartlarımız için lütfen Güvenlik ve Gizlilik Politikası (SECURITY.md) dosyamızı inceleyin.

🛠️ Kurulum ve Kullanım

Sistemi projenizde hızlıca çalıştırmak için terminalinizde aşağıdaki komutu çalıştırmanız yeterlidir:

⚡ Tek Tıkla Kurulum (Initialization)

Herhangi bir projenizin kök dizinine giderek şu komutu çalıştırın:

npx aios init

Bu komut projenizi otomatik olarak tarar, teknoloji yığınını tespit eder, gerekli tüm çoklu ajan dosyalarını (Agents/), yetenek şablonlarını (skills/) ve editör adaptörlerini (.cursorrules, .windsurfrules, .claudeprompt) kurarak entegrasyonu tamamlar.

🔄 Küresel Hafıza Senkronizasyonu (Synchronization)

Küresel hata çözümleri ve mimari desenleri yerel kurallarınızla güncellemek için:

npx aios sync

Sistem senkronizasyon tamamlandığında, taranan dosya ve indekslenen parça (chunk) istatistiklerini raporlar. Eğer OpenAI veya Ollama gibi bir AI sağlayıcı aktifse, proje mimarisi değişikliklerine göre architecture.md mimari kılavuzunu da otomatik günceller.

🔄 Dinamik Güncelleme Kontrolü (Update)

Sistemi ve şablonları en son kararlı sürüme hızlıca güncellemek için:

npx aios update

Bu komut en son güncelleme notlarını görüntüler ve onayınızla sistem bileşenlerini otomatik olarak yükseltir.

📊 Güvenli Telemetri Yönetimi (Telemetry)

Açık rızaya dayalı ve Sıfır Bilgi Güvenliği prensibine uyumlu telemetri paylaşım durumunu yönetmek için:

npx aios telemetry [seçenek]

• --status : Telemetri paylaşım durumunu ve kuyruk log sayısını sorgular.
• --enable : Paylaşımı aktif hale getirir (Opt-In).
• --disable : Paylaşımı tamamen kapatır ve yerel kuyruğu siler.
• --send : Kuyrukta biriken maskelenmiş hata loglarını hemen gönderir.

🤖 Yapay Zeka Komut Seti (AI CLI Commands)

Kod tabanınızda otonom AI asistan operasyonlarını tetiklemek için:

• npx aios commit : Değişikliklerden otomatik semantik commit mesajı üretir.
• npx aios audit : Kod tabanını güvenlik açıkları ve kalite açısından denetler (audit_report.md).
• npx aios fix "hata" : Derleme veya çalışma zamanı hatalarını otonom olarak bulup düzeltir.
• npx aios report : Ajan çalışma performansını ve rework istatistiklerini analiz eder.

⚙️ İleri Seviye Yapılandırma

🚫 Özel Dizinleri Hariç Tutma (ignoredDirs)

Lokal semantik arama indeksleyicisinin taramasını istemediğiniz (örneğin büyük medya klasörleri, yedekler veya test mock verileri gibi) özel klasörleri .kodakis-aios/config.json içerisindeki ignoredDirs dizisine ekleyebilirsiniz:

{
  "ignoredDirs": [
    "public/uploads",
    "legacy-code",
    "tests/mocks"
  ]
}

Varsayılan olarak node_modules, .next, dist, .git vb. kritik klasörler sistem tarafından otomatik yoksayılır.

🤖 Sessiz Modda Otomatik AI Algılama

npx aios init --yes (veya -y) ile sessiz kurulum yaptığınızda, sistem ortamdaki OPENAI_API_KEY ortam değişkenini veya yerel Ollama bağlantısını otomatik olarak tarar ve en uygun AI sağlayıcı yapılandırmasını kurar.

🔌 Editör Destekleri ve Ajan Mimarisi

KodAkış-AIOS, tüm popüler yapay zeka destekli kod editörleriyle ve akıllı geliştirici asistanlarıyla uyumludur. Sistemdeki tüm koordinasyon ve iş akışı tek bir akıl tarafından yönetilir: Orchestrator.

• VS Code + Roo Code: Sohbet panelindeki Artı (custom agent) ikonundan orchestrator ajanını seçerek başlatın.
• Cursor: Doğrudan Chat veya Composer panelini açtığınızda .cursorrules sayesinde sistem otomatik olarak Orchestrator kimliğiyle devreye girer.
• Windsurf: Cascade sohbetini başlattığınızda .windsurfrules üzerinden otomatik olarak kararlı adımlarla ilerler.
• Antigravity (Google DeepMind): Pair programming sürecinde copilot-instructions.md ve .claudeprompt talimatlarını otomatik olarak okur. Kendisini projenin Orchestrator anayasasına göre konumlandırıp, yol haritasına sadık kalarak sıfır hata ile güvenle çalışır.

[!IMPORTANT] Projenin mimari bütünlüğü ve kod doğruluğu için tüm işleri sadece Orchestrator ajanının yönetmesi gerekir. Doğrudan Planner veya Coder ajanlarını çağırmayınız.

Detaylı editör çalıştırma kılavuzu ve görsel açıklamaları için Editör Destek Kılavuzu (editor_support.md) dosyasını inceleyebilirsiniz.

🔄 Canlı Kod Tabanı Haritalandırma ve Sürdürülebilirlik

KodAkış-AIOS, projeler büyüdükçe veya yeni projelere başlandığında dokümantasyonun güncelliğini yitirmesini engellemek için 3 Kademeli Canlı Senkronizasyon Kalkanı kullanır:

1. Ajan Tabanlı Güncelleme (Otonom): Coder ve Orchestrator ajanları yeni bir dosya eklediğinde, sildiğinde veya değiştirdiğinde, işi bitirmeden önce harita dokümanlarını (.apps.md, .components.md vb.) otonom olarak kendileri günceller.
2. CLI ile Anlık Senkronizasyon (npx aios sync): Geliştirici veya ajan istediği an bu komutla tüm kod tabanını 1 saniyede yeniden tarayarak haritaları tazeleyebilir.
3. Otomasyon (Git Hooks & Watcher): Arka plan izleyiciler değişiklikleri otomatik olarak haritalara işler.

[!TIP] Yeni projelerde çalışma akışları, eski projelerin analiz yöntemleri ve yerel semantik indeksin sürekli nasıl güncel kalabildiği gibi derin mimari detaylar için Mimari Sürdürülebilirlik Kılavuzu'nu (architecture.md) okuyun.

🏛️ Çalışma Mimarisi

sequenceDiagram
    autonumber
    actor Developer as Geliştirici
    participant IDE as Editör (Cursor/Roo Code)
    participant LocalIndex as Yerel Semantik Dizin
    participant Agent as Ajan Sistemi

    Developer->>IDE: npx aios init
    IDE->>LocalIndex: Kodları Yerel AST ile Parçala (100% Yerel)
    Note over LocalIndex: Kodlar makinenizden asla çıkmaz.

    Developer->>Agent: Görev Talebi Gönderir
    Agent->>LocalIndex: Akıllı Semantik Arama Yap
    LocalIndex-->>Agent: İlgili Dosya ve Satır Aralığını Döner

📂 Klasör ve Dosya Yapısı

Kurulum sonrasında projenizde şu klasör ve dosya yapısı yapılandırılacaktır:

• ai-office/docs/core/: Ajanların uyması gereken Türkçe çekirdek kurallar, git kuralları ve UI/UX anayasaları.
• ai-office/docs/memory/: Bilinen hatalar, regresyon alanları ve tercih edilen mimari yapılar deposu.
• ai-office/docs/project/: Otomatik üretilen kod tabanı haritaları (sayfalar, bileşenler, kütüphaneler vb.).
• Agents/: 11 adet farklı ajan profilinin (Planner, Coder, Designer, Verifier vb.) çalışma kuralları.
• skills/: 22 adet pratik yetenek şablonu.
• .cursorrules, .windsurfrules, .claudeprompt: Editörlerin sistemi otomatik tanıması için adaptörler.

🤝 Katkıda Bulunma ve İletişim

Topluluğumuzun bir parçası olmak, projeye katkı sağlamak veya bizimle iletişime geçmek için aşağıdaki kılavuzları inceleyebilirsiniz:

• Katkıda Bulunma Rehberi: Projeye nasıl katkı sunabileceğinizi öğrenmek için Katkı Sağlama Rehberi (CONTRIBUTING.md) dosyasını okuyun.
• Davranış Kuralları: Topluluk huzurunu ve saygıyı koruma kurallarımız için Davranış Kuralları (CODE_OF_CONDUCT.md) dosyasını inceleyin.

📄 Lisans

Bu proje MIT lisansı ile korunmaktadır.