Kodlama ajanıyla SaaS inşa etmek: pratik bir iş akışı

Gözlemlenebilir bir sonuçla başlayın

Bir kodlama ajanı, ekranın ne yapması gerektiğine karar vermeden önce ikna edici bir ekran üretebilir. Küçük bir kullanıcı sonucuyla başlayın: giriş yapmış bir kullanıcı profilini düzenler, kaydeder ve yeniden yükleme sonrası kaydedilen adı görür. Bu, hem uygulamaya hem de incelemeye somut bir hedef verir.

Brifinge mevcut davranışı, istenen davranışı ve önemli hata durumlarını dahil edin. İşi sahiplenen mevcut modülü adlandırın. Profil düzenleme ekleme isteği, ajanın ikinci bir kullanıcı deposu icat etmesine bırakmak yerine kimlik doğrulama katmanına işaret etmelidir. Kimlik bilgilerini komutlardan ve ekran görüntülerinden uzak tutun — yapıştırılmış bir apps/web/.env.local ya da oturum çerezi konuşma kaydının parçası olur.

İşleyen bir brifing şöyle okunur: “Hesap ekranında, giriş yapmış bir kullanıcının görünen adını düzenlemesine ve yeniden yükleme sonrası görmesine izin verin. Kullanıcı kaydını auth modülü sahiplenir; tablo eklemeyin. Boş bir ad ya da başka bir kullanıcının kaydını hedefleyen istek reddedilmelidir. pnpm test ve dar genişlikte tek bir elle kaydetmeyle kanıtlayın.” Beş cümle ve tahminin çoğu ortadan kalkar.

• Kullanıcıya görünen sonuç; çalışan uygulamada kontrol edebileceğiniz şekilde ifade edilmiş.
• Davranışı bugün sahiplenen dosya ya da modül — ve dokunulmadan kalması gereken alanlar.
• En az bir hata durumu: kimliği doğrulanmamış bir deneme, geçersiz girdi ya da tekrarlanan bir istek.
• Onu kanıtlayan kontrol — bir test komutu, bir fikstür ya da açık bir elle yürüyüş.

Depoyu kendini anlatır hale getirin

Uygulamanın nasıl çalıştırıldığını, hangi kontrollerin deterministik olduğunu ve sahipliğin nerede uygulandığını belgeleyin. supastack'te AGENTS.md çalışma alanı sınırını, .ai/ ise dosya düzeyinde kararları kaydeder. Bu notlar, bir sonraki katılımcıya — insan ya da ajan — yalnızca hangi dosyaların değiştiğini değil, uygulamanın neden var olduğunu söylediğinde en faydalıdır. Ajan kurulum kılavuzu kitin bu malzemeyi nasıl sunduğunu gösterir; yerel kurulum kılavuzu ajanın gerçekten izleyeceği yürüyüştür.

Ajandan düzenlemeden önce ilgili kodu okumasını isteyin. Dar bir değişiklik genellikle arayüzü, sunucu sınırını ve o sınırın etrafındaki testleri gerektirir. Tüm depoyu yüklemek, yeni davranışın doğru olup olmadığına karar veren birkaç yeri anlamaktan daha az faydalıdır: sahiplik kontrolü, şema, yetkilendirme.

Bir özellik yapılandırmaya dokunduğunda, dosyayı kopyalamak yerine adını verin — “anahtarı apps/web/.env.local dosyasına ekleyin” sırları diskte tutar. Aynı disiplin sağlayıcı panoları için de geçerlidir: hedefi tarif edin, kimlik bilgisini yapıştırmayın.

Küçük, incelenebilir değişikliklerle çalışın

Ajanlar, bir değişikliğin tek bir sahibi ve tek bir kontrol edilebilir sonucu olduğunda en güvenilirdir. “Profil düzenleme ekle” incelenebilir; “hesap alanını iyileştir” kimsenin istemediği yeniden düzenlemelere davetiye çıkarır. Bir özellik şema değişikliğine, sunucu sınırına ve ekrana ayrışıyorsa, bunları her biri derlemeyi yeşil bırakan ayrı brifingler olarak çalıştırın.

Her ajan çalıştırmasından önce commit ya da kontrol noktası alın. Temiz bir taban, kötü bir çıktıyı arkeoloji çalışması yerine silinen bir farka dönüştürür ve incelemenize karşılaştırılacak sabit bir önce-sonra verir.

Her seferinde tek bir tam değişikliği inceleyin

Davranışı değiştirmeden önce bir kabul kontrolü yazın. Profil düzenleme için geçerli bir güncellemeyi ve yetkisiz bir denemeyi kapsayın. Bu durumları karşılayan en küçük uygulamayı yapın, ardından gerçek etkileşimi gerçekçi metin ve dar bir görünüm alanıyla inceleyin.

Sonucun yanında farkı da inceleyin. Çoğaltılmış iş mantığına, geniş istisna yönetimine ve mevcut yığının zaten çözdüğü bir sorunu çözen yeni bağımlılıklara bakın. Projenin kontrollerini çalıştırın ve neyi kanıtladıklarını kaydedin. Bir tarayıcı fikstürü form etkileşimini doğrulayabilir; üretim veritabanının ya da harici bir sağlayıcının doğru yapılandırıldığını kanıtlayamaz.

Her komut farklı bir soruyu yanıtlar. pnpm test davranışı deterministik sahte ve yerel bağdaştırıcılara karşı çalıştırır, pnpm check lint, tip kontrolü ve biçimlendirmeyi kapsar, pnpm build ise yalnızca paketleme aşamasında görünen entegrasyon hatalarını ortaya çıkarır. Birlikte inceleme için bir taban oluştururlar — gerçek ortamda hâlâ kanıtlanması gerekenleri lansman kontrol listesi kapsar.

pnpm test
pnpm check
pnpm build

Ajan yanıldığında

Sonuç yanlış olduğunda, kötü bir farkın üzerine takip komutları yığmaktan kaçının. Kontrol noktasına dönün, brifingi yanlış anlaşılan şeyin etrafında sıkılaştırın — genellikle söylenmemiş bir kısıt ya da eksik bir sahip — ve yeniden çalıştırın. Her deneme yalnızca yeni bir aciliyet değil, yeni bilgi taşımalıdır.

Israrlı başarısızlık genellikle brifingin depoda bulunmayan bir bağlamı varsaydığı anlamına gelir. Ajan kullanıcıları saklamak için sürekli ikinci bir yer icat ediyorsa, çözüm daha sert bir ton değil, kimliğin nerede yaşadığına dair AGENTS.md içine bir cümledir. Belgeyi güncelleyin, ardından görevi yeniden deneyin — kitin bu iş akışını tuttuğu yer ajanlar kılavuzu.

Ajan iş akışları hakkında sık sorulan sorular

Bir kurucu gerçek ürün işini bir kodlama ajanına emanet etmeye başladığında birkaç soru hep gündeme gelir.

• Bir kodlama ajanı tek başına tüm bir SaaS inşa edebilir mi? — Görünen parçaları hızla birleştirebilir ama kalıcı parçalar — yetkilendirme, faturalama yaşam döngüsü, veri yalıtımı — hâlâ bir brifing, bir kontrol ve bir inceleme ister. Bu döngü olmadan hız, yeniden işe dönüşür.
• Bir kodlama ajanına verilen görev ne kadar büyük olmalı? — Sonucu çalışan uygulamada dakikalar içinde doğrulayabileceğiniz kadar küçük: kullanıcıya görünür tek bir sonuç, tek bir sahip modül, tek bir kabul kontrolü.
• Bir komuta asla ne girmemeli? — Sağlayıcı sırları, oturum çerezleri, .env.local içeriği ve müşteri verisi. Dosyaları adlandırın ve aracın onları yerelde okumasını sağlayın; değerleri bir sohbet kaydına kopyalamayın.
• Ajan yazımı kod inceleme şeklimi değiştirir mi? — İnceleme yazmaktan okumaya kayar: farkı çoğaltılmış mantık, geniş istisna yönetimi ve yığının zaten çözdüğü bir sorunu yeniden çözen bağımlılıklar için inceleyin.
• Ajan çıktısı için en önemli testler hangileri? — Sahiplik ve hata davranışını sabitleyenler: yetkisiz istekler, geçersiz girdi ve tekrarlanan gönderimler; yalnızca demonun gösterdiği mutlu yol değil.