Salı öğleden sonra, ekibiniz AI ile üretilmiş profil sayfasında bir güvenlik sorunu buluyor. Bir müşteri, ID'yi değiştirerek başka bir müşterinin kayıtlı adresini okuyabiliyor. Düzeltiyorsunuz. Merge ediyorsunuz. Devam ediyorsunuz. Cuma sabahı, yeni bir özellik yayınlanıyor: kayıtlı adresleri dışa aktarma. Cumartesiye kadar, Salı'daki hatayı bildiren aynı müşteri yine yazıyor: yeni dışa aktarma uç noktasında aynı sorun var. AI aracı kuralı bilmiyordu. Ona kimse Salı'nın dersini söylemedi. AI destekli geliştirmede en pahalı hata bu, ve en önlenebilir olanı. Aynı zamanda aşağıdaki çerçeveyi inşa etme nedenimiz.
Gerçek bir ekipte nasıl görünür
Salı-sonra-Cuma deseni, AI destekli işin tek en büyük regresyon kaynağı. Ajanın, ekibinizin geçen hafta neye karar verdiğine dair belleği yok. Her oturum sıfırdan başlıyor. Aynı yanlış desen, kimse ajanın talimatlarını güncellemediği için commit'ten commit'e tekrarlıyor. Bunu çerçeveyi kurmadan önce kendi müşteri çalışmamızda ölçtük: her ikinci pull request'te aynı altı sorunu tekrar tekrar düzeltiyorduk. Çerçeve bu israfı tamamen ortadan kaldırdı.
Aynı AI hataları neden tekrar tekrar oluyor
Bir çerçeve olmadan AI araçların, ekibinizin geçen hafta üzerinde anlaştığı şeyleri hatırlama yolu yok. Her konuşma sıfırdan başlıyor. Aynı yanlış desen, commit'ten commit'e tekrar ediyor çünkü kimse AI'ya bunu bir daha yapma demedi. Maliyet gerçek: çerçeveyi kurmadan önce kendi müşteri çalışmalarımızda ölçtük. Her ikinci pull request'te aynı altı sorunu tekrar tekrar düzeltiyorduk. Çerçeve bu israfı tamamen ortadan kaldırıyor.
Döngü, dört parçada
AI kodlama oturumunu bir konuşma değil, bir sistem olarak ele alıyoruz. Dört parça çalışmasını sağlıyor: bellek, beceriler, hooks ve inceleme. Her parçanın tek bir işi var.
Bellek: ekibin öğrendikleri
Ajanın her oturumun başında yüklediği, proje başına kapsamlanmış kalıcı notlar. Kararlar, kurallar, bunu yapmayın talimatları. Yeni bir ders ortaya çıktığında otomatik olarak güncellenir.
Beceriler: doğru iş için doğru araçlar
Ajanın talep üzerine yüklediği tekrar kullanılabilir slash komutları ve beceriler: kod incelemesi, göçler, şema tasarımı, API üretimi. Her biri denenmiş bir tarif, doğaçlama bir deneme değil.
Hooks: otomatik ekip kontrolleri
Commit öncesi, commit sonrası ve push öncesi hookları; linting, tip kontrolleri, güvenlik taramaları ve kendi iç kurallarımızı çalıştırır. Ajan, ekibin alacağı aynı geri bildirimi alıyor.
İnceleme: her PR ajana öğretir
Bir pull request birleştikten sonra dersler belleğe geri gider. Bir sonraki oturum hatayı tekrarlamaz. Aynı sorunu iki kez düzeltmenin maliyeti sıfıra iner.
Kendi kendini düzelten ajanlar pratikte
Sıradan bir iş gününde kendi kendini düzeltme şöyle görünüyor. Ajan derlemeyi çalıştırır, bir tip hatası görür, düzeltir, yeniden çalıştırır, bir sonrakini düzeltir. Ekip gürültüyü görmez. Ajan bir özelliği bitirdiğinde, commit sonrası hookları otomatik testleri ve güvenlik taramasını çalıştırır. Bir şey başarısız olursa, ajan başarısızlığı okur ve yeniden dener; sonsuz bir döngüde değil, geri çekilmeli üç denemede. Üç başarısızlıktan sonra durur ve bildirir. Ekip yalnızca ajanın çalıştıramadığı durumları görür ve bunlar gerçekten bir insanın gerekli olduğu durumlardır.
Tüm ekip otomasyonu, tüm ekip değişimi değil
Çerçeve insanları kaldırmıyor. İnsanların yapmaması gereken tekrarlı işi kaldırıyor. Bir insanın kod incelemesi kalıyor. Bir insanın tasarım kararları kalıyor. Giden şey: aynı kuralı dördüncü kez yeniden açıklamak, boilerplate kopyalamak, testleri manuel çalıştırmak, sürüm notlarını manuel yazmak, bir API değiştiğinde dokümantasyonu manuel güncellemek. Ekibin zamanı, önemli olan işe gidiyor.
- Kurallar bellekte bir kere yazılır, her yerde otomatik uygulanır
- Boilerplate üretilir, asla kopyalanmaz
- Testler her commit'te çalışır; bozuk commit'ler incelemeye ulaşmaz
- API'ler değiştiğinde dokümantasyon yeniden üretilir
- Sürüm notları commit log'undan gelir, birinin boş akşamından değil
Kanıt: bu website bu şekilde yapıldı
ibgroup.dev'de gördüğünüz her şey (yeniden tasarım, yeni hizmetler, açık kaynak sayfası, ürünler sayfası, okuduğunuz bu blog) bu çerçeve kullanılarak yapıldı. Her değişiklik döngüden geçti. Dahili projelerimizde iyileşmeyi ölçtük: aynı tür sorun, pull request incelemesinde değil commit'te yakalanıyor, aynı kuralın yeniden açıklanmasına gerek kalmıyor ve bir projeye yeni katkıda bulunan kişiyi alıştırmak iki haftadan iki güne indi. Strapi tarafından resmi olarak öne çıkarılan açık kaynak araç setimiz @ibrahim-bayer/strapi-http-toolkit de aynı şekilde sürdürülüyor (https://strapi.io/integrations/strapi-http-toolkit).
Ekibiniz için çerçeveyi nasıl kuruyoruz
Bunu Vibe Code Rescue ve Kurucu Koçluğu hizmetimizin bir parçası olarak veya kodunuz zaten iyi durumdaysa ayrı bir taahhüt olarak yapıyoruz. Kurulum yaklaşık bir hafta odaklı çalışma alıyor. Ekip koçluğu yarı zamanlı seanslarla iki hafta daha alıyor. Üç hafta sonra çerçeve bizden bağımsız çalışıyor ve öğrendikleriniz sizde kalıyor.
- Projeniz için bellek, beceriler ve hooks kurulumu (1 hafta)
- Çerçeveyi kullanan komutlar üzerine ekibinizi koçluk (2 hafta, yarı zamanlı)
- Ekibinizin sahip olduğu yazılı bir oyun kitabıyla devir teslim
- Upwork üzerinden sadece %10 ön ödemeyle güvenli ödeme
Bir sonraki iterasyonunuzu öncekinden daha iyi yapın
Ekibiniz AI kodlama araçlarını bellek, beceriler, hooks ve bir inceleme döngüsü olmadan kullanıyorsa, en büyük kazançları masada bırakıyorsunuz. Aynı hata tekrar tekrar oluyor çünkü ajanın onu öğrenme yolu yok. Üç haftalık çalışma ve ekibinizin hızı şekil değiştiriyor: daha fazla çıktı, daha az regresyon ve her ay daha iyi olan bir çerçeve.
Ekibiniz için Claude Code çerçevesini kurmayı görüşmek üzere bir görüşme ayarlayın. Upwork üzerinden güvenli ödeme.