AI-native mühendis ne yapılacağını bir yapay zeka ajanına tarif eder ve ajanın yazdığı planı onaylar, kodu ajan yazar ama değişikliğin canlıya çıkıp çıkmayacağına mühendis karar verir. Ajan burada kodu okuyup değiştiren ve terminalde komut çalıştıran bir araç, Claude Code buna bir örnek. Fikri olan kod bilmeyen de, kod yazan da, ekip yöneten de aşağıda bir özelliğin baştan canlıya nasıl çıktığını görecek, sonda her biri için ayrı bir başlangıç yeri var.
Prototip neden yetmiyor
Bir ajana çalışan bir demo yaptırmak artık kod bilmeyen birinin de yapabildiği bir iş. Zorluk, o demo başkasının eline geçtiğinde başlar. İkinci özelliği eklerken ajan ilkini bozabilir ve sen bunu fark etmezsin, çünkü bozulan yer o an baktığın ekran değildir. Kendi denemen bozulursa ajana baştan yazdırırsın. Başkasının verisini tutan ve kimin neyi görebileceğine karar veren bir uygulamada o yol kapalı.
Bir özellik nasıl canlıya çıkar
Aşağıdaki sırayı ajana sen verirsin, ajanın her başlatıldığında okuduğu bir talimat dosyasıyla ve neyi sormadan yapabileceğini belirleyen izin ayarlarıyla.
İşe ne istediğini yazarak başla. Talimat dosyası ajana önce soru sormasını, sonra işin adımlarını ve kabul kriterlerini yazmasını söyler. Kabul kriteri, işin ne zaman bitmiş sayılacağı. Planı okumadan onaylama, çünkü yanlış anlaşılmış bir istek en kolay planda düzelir.
Onaydan sonra ajan önce testi yazar. Test, isteğinin karşılanıp karşılanmadığını otomatik kontrol eden küçük bir kod parçası. İlk koşuda başarısız olduğunu kendin gör, çünkü kod yokken geçen bir test yeni isteği kontrol etmiyordur.
Kodu da ajan yazıyor ve değişikliği o testi geçirecek kadarıyla sınırlı tutuyor, çünkü küçük kalan bir değişikliği gerçekten okuyabilirsin.
Değişiklik bitince ajan bir PR açmak için senden izin ister. PR, değişikliklerin ana koda girmeden önce tek sayfada toplanıp incelendiği GitHub sayfası. Kod okumuyorsan ajandan PR'ın kısa bir özetini iste.
Merge, değişikliği ana koda almak. Otomatik yayın kuruluysa değişiklik bununla canlıya çıkar. Bu yüzden merge'i ajana bırakma, izin ayarlarında merge komutuna izin verme. Şifrelerin ve gizli anahtarların durduğu dosyaları okumayı da aynı yerde kapat.
İş ne zaman bitmiş sayılır
Kodu da testini de ajan yazıyorsa testin geçmesi tek başına güvence sayılmaz. Ajan bir isteği yanlış anladıysa testini de aynı yanlış anlamayla yazar ve ikisi birbirini onaylar.
Bu yanlışı yakalamanın yolu değişikliği preview'da kendin denemek. Preview, uygulamanın o değişiklik için açılan geçici bir kopyası ve canlıdaki kullanıcılar onu görmüyor. Kod okumuyorsan elindeki en güçlü kontrol bu. Ekranda istediğin şeyi görmediysen iş bitmemiştir.
Preview'dan önce testin dışında kalan iki kontrol daha koşmalı. Typecheck kodun parçalarının birbirine uyup uymadığına bakar. Build uygulamanın yayına çıkacak halini üretiyor ve build'de kırılan bir değişiklik canlıya çıkamaz. İkisini de ajana koşturt, çıktısını görmeden işi bitmiş sayma.
PR'ı kim açarsa açsın, onu okuyan kişi senin denediğini varsayar. Denemediğin bir değişikliği bu yüzden merge etme, ekipteysen review'a da gönderme.
Ekipte nasıl görünür
Ekipte zorlaşan şey, bu sıranın herkeste aynı kalması. Birinin ajanı testi önce yazar, ötekininki hiç yazmaz ve PR'lar okuyanın o günkü dikkatine göre geçer.
AI-native bir ekipte ajanın talimat dosyası repo'da, yani kodun ve geçmişinin tutulduğu yerde durur ve herkesin ajanı aynı dosyayı okur. Claude Code'da bu dosyanın adı CLAUDE.md. Ekip PR'larda aynı yorumu tekrar yazıyorsa o yorum bu dosyaya girmeli, çünkü ajan yazılmamış bir kuralı bilemez. Dosya da kod gibi PR'la değişiyor.
Repo'daki izin ayarlarında ajanın production'a, yani canlı ortama dokunan komutları engellenir. Yine de en sağlam önlem, ajanın çalıştığı bilgisayarda production'a erişen bir anahtarın hiç bulunmaması.
Plan ve test sırası tek kişideki gibi. Review'da ise ajanın açtığı PR'ı ekipten biri okur ve neye bakacağı repo'da yazılıdır, böylece sonuç PR'ı kimin okuduğuna daha az bağlı kalır. Merge yetkili kişinin işi.
Birisi ajana bir işi doğru yaptırmanın yolunu bulduğunda AI-native ekipte bu yol skill olarak, ajana o işi adım adım tarif eden kısa bir talimat olarak repo'ya girer, böylece herkesin ajanında hazır.
Kaç kişinin ajanı her hafta kullandığını saymak kolay ama bu sayı yalnız ajanın açıldığını söyler. İşin nasıl yürüdüğünü bir işin PR'a dönme süresi ya da review'dan geri dönen PR sayısı gösteriyor, AI-native bir ekip bunlardan birini düzenli takip eder.
Nereden başlanır
Tek başına deneyeceksen ücretsiz 2 saatte canlı uygulama programıyla başla. Programda kendi fikrinden küçük bir web uygulamasını internete koyuyorsun. Kod yazıyorsan PR ve test sana tanıdık gelecek, yeni öğreneceğin şey aynı akışı ajana yaptırırken nerede araya gireceğin. Program, kopyalayıp üzerine kendi uygulamanı kuracağın hazır bir şablon repo'yla ilerliyor ve şablon GitHub'da açık.
Ekibin için bakıyorsan 8 soruluk ekip testi ekibinin bugün nerede durduğunu gösterir. Bu düzeni ekibinle kendi kodunuzda kurmak için Birlikte çalışalım sayfasına bak. İlk adım 2 saatlik canlı bir oturum ve sonunda ekibin kuralları repo'da yazılı oluyor.
Terimlerin uzun açıklamaları ve örnekleri sözlükte.
