AI Protocol

Claude Code, Cursor gibi kodlama ajanları için onay-öncelikli çalışma protokolü. Projene bir kez kurarsın; ajan her oturumda aynı çalışma anlaşmasına uyar.

Ne yapar?

  • Oturumu ucuza başlatır. Tüm geçmişi yeniden okumak yerine kısa bir bağlam kartını ve ilgili modülün takip dosyasını yükler.
  • Kod yazmadan önce sorar. Tek tur soru, kısa plan özeti, sonra açık onayını bekler.
  • Cerrahi düzenler. Küçük düzenlemeler serbest, orta olanlar tek cümlelik özet, büyük yeniden yazımlar onay ve önceden yedek commit ister.
  • İşi dürüstçe izler. Her değişiklik kodlandı, testini bekliyor ya da onaylandı olarak kaydedilir; gerçekten denenmeyen şey "test edildi" diye yazılmaz.
  • Tek komutla bitirir. finalize takip dosyalarını günceller ve yerel yedek commit atar. Push, zorla işlem ve dal silme her zaman onayını ister.

Kimler için?

Yapay zekâ editörüyle yeni projeye başlayıp kuralları ilk günden koymak isteyenler; ajanı büyük dosyaları baştan yazan, onayı atlayan ya da neyin test edildiğini kaybeden kişiler; büyüyen sohbet bağlamı yerine token tasarruflu bir iş akışı isteyenler.

Neler içerir?

  • Claude Code ve Cursor için talimat dosyaları (CLAUDE.md, AGENTS.md, .cursorrules, .cursor/rules/)
  • Takip dosyaları: yapılacaklar, yapılanlar, bilinen hatalar, bekleyen testler, modül notları
  • baslangic, finalize, arsiv ve tam komutlarına sahip bir oturum betiği
  • İsteğe bağlı yığın modülleri: Flutter, Unity, Godot, Web, Python
  • Proje adı, yığın ve dil soran, yer tutucuları dolduran kurulum betiği

Dil

Şablonlar, dosya adları ve betik çıktıları Türkçe. Kurulumda dilini seçersin; ajan talimat dosyalarını senin diline çevirir ve sana o dilde yanıt verir. Bir doğrulama betiği çevrilmemiş ya da bozulmuş dosyayı reddeder. Dosya adları ve betik çıktısı Türkçe kalır.

Gereksinimler ve dürüst notlar

  • Python 3 ve git gerekir.
  • Kurulum betiği Windows'ta çalıştırılarak doğrulandı. Linux ve macOS komutları pakette var ama yazar tarafından henüz çalıştırılmadı.
  • Hatasız ajan davranışını garanti etmez; disiplinle hataları azaltır. Kurallar bilerek katıdır (kod öncesi onay); projedeki CLAUDE.md'den gevşetebilirsin.
  • finalize tüm değişiklikleri commit'ler; sırları ilk finalize'dan önce .gitignore'a ekle.

Kurulumdan görüntüler

Görüntüler satışa çıkan paketten gerçekten çalıştırılan komutların çıktısıdır (Windows, Python projesi, dil: İngilizce). Pencere çerçevesi yalnızca görsel olarak çizilmiştir.

Etkileşimli kurulum: dil seçimi / interactive setup: choosing the language
1. Etkileşimli kurulumda proje adı, yığın ve dil sorulur; burada dil olarak Almanca (de) seçildi.
Kurulum betiği çıktısı / setup script output
2. Kurulum betiği proje adını, yığını ve dili alır; çevrilecek dosyaları listeler.
Kurulumdan sonra oluşan dosyalar / files created after setup
3. Kurulumdan sonra projede oluşan talimat ve takip dosyaları.
Çeviri görevi dosyası / translation task file
4. Dil Türkçe değilse kurulum, ajan için bir çeviri görevi dosyası üretir.
Oturum başı komutu / session start command
5. Oturum başı komutu: çeviri bekliyorsa uyarır ve bağlam dosyalarını hazırlar.

Edinme

AI Protocol, Agensi.io üzerinde skill olarak satılır.