Claude Code’un Çoklu Ajan Orkestrasyonu ve Laravel ile Bir Gece İçinde Bir Backend Yeniden İnşa Etme Yöntemim

Geçen akşam saat 20:50’de bir ürünün backend’ini sıfırdan yeniden inşa etmek için oturdum. 23:00’de, kimlik doğrulama, CRUD, gerçek zamanlı WebSockets ve sohbet ile tamamlanmış bir Laravel API’m vardı. 01:50’de mevcut React Native frontend’i yeni API ile çalışacak şekilde bağladım. Ertesi sabah buluta dağıtımını yaptım.

Tüm backend için yaklaşık iki saat sürdü. Frontend entegrasyonu ile birlikte toplam beş saat.

Birden fazla ajan orkestrasyonu, Laravel ve sağlam belgeler bunun mümkün olmasını sağladı.

Ne İnşa Ediyordum?

Ürün, gerçek zamanlı spor analiz platformuydu. Canlı anlık olay bilgisi, maç skorları, sohbet, koç panoları, oyuncu profilleri… Her şey. Orijinal ürün, monolitik bir Python betiği ile FastAPI backend’ine dayanıyordu. Çalışıyordu, fakat ölçeklenebilir olarak inşa edilmemişti.

Backend’i yıkarak Laravel üzerine yeniden inşa etmeye karar verdim. Mevcut React Native frontend sadece yeni API’ye bağlanmak zorundaydı. Ve bunu hızlı bir şekilde yapmak zorundaydım çünkü Ağustos’ta piyasaya sürmemiz gerekiyordu.

Üç Araçlı İş Akışı

İşlemin farklı bölümleri için farklı Claude araçları kullandım. Claude ile etkili bir şekilde çalışmak için önceden araştırma yapmıştım ve ortaya çıkan iş akışı yeterince etkiliydi ki bunu detaylandırmak istiyorum.

Üç araç kullandım:

Claude tarayıcıda stratejik planlama için. CEO’nun ürün belgelerini, mevcut kod tabanını ve teknik gereksinimlerimizi verdim. Altı aşamadan oluşan bir yapım planı üretti. Bu, belirsiz değildi; Claude Code için direkt olarak talimat olarak verebileceğim kadar spesifikti.

Claude Code için icra. Yapım planının her aşaması bir talimat haline geldi. Claude Code, phase by phase Laravel backend’ini oluşturdu: migrations, modeller, controllerlar, API kaynakları, etkinliklerin yayınlanması, küfür filtreleme ile sohbet, güvenlik sıkılaştırma. Altı aşama yaklaşık iki saatte tamamlandı.

Çoklu ajan orkestrasyonu için karmaşık orta kısım. Burada işler ilginçleşti.

18 Ajan Eşzamanlı Hataları Düzeltme

Backend tamamlandıktan ve frontend bağlandıktan sonra 33 dosyada 175 TypeScript hatası vardı. Eski Python API’si düz nesnelerle string ID’ler dönerken, yeni Laravel API’si iç içe kaynaklarla integer ID’ler döndürüyor. Oyun verisine, takım verisine veya oyuncu verisine dokunan her ekran bozuldu.

Onları bir dosyayı bir seferde düzeltmek yerine, birden fazla Claude Code ajanını paralel olarak başlattım. Bir noktada 18 ajan aynı anda çalışıyordu, her biri farklı bir hata grubuyla ilgileniyor. Bir ajan koç panosu ekranlarını yönetiyordu. Diğeri oyuncu istatistik alan adlarını düzeltiyordu. Başka bir ajan, skoru düz alanlardan iç içe takım nesnelerine yeniden bağlıyordu.

Hepsi aynı kod tabanı üzerinde çalışıyordu ve birbirine karışmadı; çünkü her ajanın kendi kapsamlı görevi vardı. Hatalar 175’ten 0’a sekiz grup halinde gitti.

Bu tür bir paralellik, tek iş parçacıklı bir iş akışında insan veya AI ile mümkün değil.

Neden Laravel Avantajım Oldu

Orijinal backend bir monolitik Python betiğiydi. Her şeyi yapan bir dosya. Bunu Laravel’e dönüştürmek neredeyse haksız şekilde kolaydı.

Laravel, kutudan çıktığı gibi birçok özellik sunuyor. API kimlik doğrulaması için Sanctum, ilişkilerle veritabanı modelleri için Eloquent. Tutarlı JSON yanıt şemaları için API Resources. WebSockets için Reverb ile yayın. Yerleşik oran sınırlama, doğrulama ve middleware. Hatta sohbet için küfür filtresi, Laravel’in pipeline düzeni ile oldukça basit.

Eski yığınla haftalar süren özel işlerin çoğu, php artisan make:model, ilişkileri tanımlama, bir kaynak sınıfı yazma ile tamamlandı. CRUD kalıpları neredeyse kendiliğinden yazıldı ve Claude Code, Laravel kodu üretmede çok etkiliydi çünkü çerçevenin kuralları çok iyi tanımlanmış.

Altı aşama. İki buçuk saat. Kimlik doğrulama, CRUD, oyun istatistikleri, anlık olay motoru, gerçek zamanlı yayın, sohbet ve dağıtım hazırlığı içeren tam bir API.

Belgeler AI’nın İşlemesini Sağladı

Claude’un yapım planı neden ilk seferde bu kadar doğruydu? Kurucunun dökümantasyonu ayrıntılıydı.

Kurucu, her özellik için detaylı spesifikasyonlar sunmuştu. Oyun verisi için alan tanımları. Kullanıcı rolü açıklamaları. Sohbet davranış kuralları. İstatistik kategorileri ve nasıl gruplandırılmaları gerektiği. Bunları Claude’a verdiğimde, AI’nın kullanabileceği yeterli bağlam oldu ve gerçeklere dayalı bir yapı planı üretti.

Geri dönüşüm, geri dönüşüm doğurur. Eğer ürün belgeleri belirsiz olsaydı, zamanımın yarısını gereksinimleri netleştirmekle geçirirdim.

Tam Zaman Çizelgesi

Gece nasıl geçtiğine dair bir bakış:

Her iki platformda da push-to-deploy ile. Ekip, kilise sona ermeden uygulamayı telefonlarında görebildi.

Diğer Geliştiricilere Ne Söylerdim

Her katmanda AI kullanın, ancak her katman için farklı AI kullanın. Tarayıcı tabanlı Claude, planlama ve strateji için harika. Claude Code, icra için mükemmel. Çoklu ajan orkestrasyonu, paralel problem çözme için idealdir. Her şeyi tek bir araçta yapmaya çalışmayın.

Güçlü kurallara sahip bir çerçeve seçin. Laravel’in belirgin yapısı, Claude Code’nin doğru, idiomatik kod üretmesini sıradan hale getirdi. Çerçeveniz ne kadar öngörülebilir olursa, AI destekli gelişim o kadar etkili olur.

Yapıma başlamadan önce belgelere yatırım yapın. Tek bir hızlandırıcı, AI değil, girdi kalitesiydi. Ayrıntılı ürün belgeleri, yapım planının ilk seferde doğru olmasını sağladı. Geri dönüş yok. “Aslında bunu kastettim” yok.

Ajanların kendilerini tarife dayalı olarak belirlemesine izin verin. 18 ajanı eşzamanlı olarak çalıştırdığımda, Claude Code işleri kendi başına parçalara ayırdı, her ajanın belirli dosyaları ve hata türlerini ele almasını sağladı. Üst üste binme olmadı. Ben manuel olarak çalışma atamak zorunda kalmadım, yalnızca sorunu işaret ettim ve düzeltmeyi paralelleştirdi.

Iddialı zaman çizelgelerinden korkmayın. Bir gecede tamamlanan bir backend yeniden inşası abartılı gibi görünüyor. Ancak doğru araçlarla, doğru çerçeve ile ve sağlam belgelerle, yalnızca iyi kapsamlı görevlerin paralel olarak yerine getirilmesi bir dizi. Bir geliştiricinin bir seansta neleri gönderebileceği konusundaki sınır, temelde değişti.

Tessa Kriesel, Built for Devs‘in CEO’su ve bir startup’ta yarı zamanlı CTO’su. Gündüzleri geliştirici araçlarının ürün benimsemesi ve pazar stratejisi ile ilgileniyorum. Akşamları ise, görünüşe göre, 18 AI ajanın aynı anda çalıştığı backend’leri yeniden inşa ediyorum. Geliştirici ürünleri veya çoklu ajan orkestrasyonu hakkında konuşmak isterseniz, çevrimiçi olarak beni bulabilirsiniz.