Pi kodlama ajanına yapılandırılmış bir geliştirme döngüsü dayatan workflow uzantısı

Son zamanlarda yapay zeka kodlama ajanı araçları art arda çıkıyor ve paralel ajanlarla aynı anda birden fazla dosyayı düzenleme yaklaşımı popüler hale geldi. Ancak bizzat kullanınca hemen fark edilen bir şey var — ortaya çıkan sonuçlar dağınık oluyor.
Ajan plan yapmadan kod döküyor, modüller arasındaki tutarlılık bozuluyor ve aynı hataları her oturumda tekrar ediyor. "Hızlıca çok şey üretmek" her zaman iyi bir şey değilmiş. Üretim hızı ne kadar yüksek olursa olsun, sonrasında insanın toparlamak için harcadığı süre daha uzunsa bunun pek anlamı kalmıyor.
Bu yüzden yaklaşımı değiştirdim. Ajanın hızını bilinçli olarak yavaşlatıp yapıyı zorunlu kılarsak, nihai kalite artmaz mı?
Pi kodlama ajanı (@mariozechner/pi-coding-agent) için bir workflow uzantısı yaptım; bunun özü de ajana 6 aşamalı bir geliştirme döngüsünü zorunlu kılmak:
📝 Plan → 🔍 Planı Doğrula → 🔨 Uygula → ✅ Uygulamayı Doğrula → 🧠 Derle → 🎉 Tamam

1. Aşama bazlı araç engelleme
   Implement aşaması dışında dosya düzenleme araçlarının kendisi engelleniyor. rm, mv, sed -i gibi bash komutları da salt okunur aşamalarda bloklanıyor. Yapay zekanın plan oluşturmadan önce koda dokunması baştan imkansız hale geliyor.
2. Paralel çok modelli karşıt doğrulama
   Planlar ve uygulama çıktıları birden fazla LLM tarafından aynı anda doğrulanıyor. Bu sıradan bir kod incelemesi değil; kodu bozacak somut senaryolar üretip saldıran bir yöntem. Ciddiyet düzeyi 🔴 CRITICAL / 🟡 WARNING / 🔵 INFO olarak sınıflandırılıyor ve tek bir CRITICAL bile varsa ilgili aşama geçilemiyor.
3. Compound öğrenme ve proje belleği
   Her döngü bittiğinde örüntüler, hatalar (gotchas) ve mimari kararlar otomatik olarak kaydediliyor. Bu bellek .pi/workflow-memory.json içinde tutuluyor ve oturum değişse bile korunuyor. Böylece "dün burada boşuna uğraştık, bugün aynısını tekrarlamayalım" demek mümkün oluyor.
4. Repo Map (AST + PageRank)
   web-tree-sitter ile proje genelindeki semboller (fonksiyonlar, sınıflar, arayüzler vb.) çıkarılıyor, import grafiği oluşturuluyor ve dosya bazında önem derecesi PageRank ile hesaplanıyor. Token bütçesi içinde (varsayılan 2048) proje yapısı kavranabildiği için ajan, "bu proje nasıl bir yapıya sahip" sorusunu anlamış halde çalışıyor. 18 dili destekliyor.
   Diğer özellikler

• TODO sistemi — büyük görevleri TODO birimlerine bölüyor ve her TODO için Implement → Verify → Compound döngüsünü bağımsız olarak yürütüyor
• Git otomasyonu — TODO sınırlarında otomatik commit/push, dirty tree varsa önce temizlenmesi zorunlu
• Özel kontroller — docs/checks/ içine Markdown dosyaları koyarak projeye özgü doğrulama ölçütleri eklenebiliyor
• Bağlam yönetimi — her zaman enjekte edilen minimum bağlam ile gerektiğinde getirilen on-demand bağlam ayrılıyor; böylece token israfı önleniyor
  Felsefe
  Paralel ajanların kötü olduğunu söylemiyorum. Ama yapısız paralel üretimin, teknik borcu da paralel üretmekle neredeyse aynı şey olduğunu düşünüyorum. Bu uzantı, "işi yapay zekaya verelim ama insanın çalıştığı düzene benzer bir disiplin uygulayalım" fikrinden çıktı.
  %100 TypeScript ile yazıldı ve npm install + tek bir symlink ile kuruluyor.
  GitHub: https://github.com/popododo0720/pi-stuff
  Geri bildirimlere açığım!