Claude Code Dinamik İş Akışı: Kontrol Noktalarıyla Görevleri Yönetilebilir Adımlara Bölün

Karmaşık bir görev yalnızca “bu projeyi iyi hâle getir” şeklinde verilirse modelin tamamlanma ölçütünü anlaması ve değişikliklerin incelenmesi zorlaşır. Daha güvenli dinamik iş akışı, depodaki mevcut duruma göre sonraki adımı belirler: önce araştır, sonra çözüm öner, küçük bir bölümü uygula, sonucu kontrol et ve ardından devam et. Claude Code'un komutları ve ayarları değişebilir; bu yazı genel bir iş birliği düzenini ele alır. İzinler ve hook'lar için güncel resmî belgelere başvurun.

Önce görev sınırlarını belirleyin

Hedefi, değiştirilebilecek dizinleri, dokunulmaması gereken ayarları ve kabul koşullarını belirtin. Örneğin: “Giriş sayfasındaki dar ekran taşmasını düzelt; yalnızca UI dosyalarını değiştir. Bitince değişikliği ve doğrulama yöntemini açıkla.” Ajanın önce ilgili kodu okuyup varsayımlarını sıralamasını isteyin; silme, dağıtım veya veri geçişi iznini en baştan vermeyin. İnsan onayı gerektiren işlemleri açıkça belirtin.

Kontrol noktalarıyla ilerleyin

İlk aşamada yalnızca sayfayı ve sorunun yeniden üretildiği yolu bulmasını isteyin. İkinci aşamada en küçük düzeltme planını hazırlasın. Üçüncü aşamada sınırlı değişikliği uygulasın. Dördüncü aşamada diff'i incelesin, uygun yerel doğrulamayı çalıştırsın ve kapsanmayan noktaları bildirsin. Bir sonraki aşamaya geçmeden önce her seferinde gerçek sonucu değerlendirin. Araştırma kapsamın beklenenden büyük olduğunu gösterirse, ajanın tüm modülü fırsat bulmuşken yeniden düzenlemesine izin vermek yerine görev sınırlarını güncelleyin.

Bağlam devrini kayda geçirin

Uzun görevlerde hedefi, doğrulanmış olguları, çözülmemiş soruları ve önemli dosya yollarını saklayın. Yeni oturum ilgisiz belgeleri baştan okumak yerine bu kısa kayıttan devam edebilir. Geçici varsayımları olgu gibi yazmayın; “doğrulandı” ve “teyit bekliyor” diye işaretleyin. Birden çok alt görev varsa, paralel değişiklik çakışmalarını azaltmak için her birine ayrı tamamlanma ölçütü ve dosya sınırı verin.

İzinler, araçlar ve güvenlik

Araç izinleri ajanın neleri okuyup yazabileceğini belirler. Proje düzeyinde yapılandırmayı ve açık izin listelerini tercih edin; shell komutlarını, ağ isteklerini ve dosya yazımlarını inceleyin. API anahtarlarını istemlere veya commit kayıtlarına koymayın. Bildirim ya da otomatik tetikleme gerekiyorsa, mevcut Claude Code sürümünün ilgili hook olayını ve girdi biçimini desteklediğini önce doğrulayın; resmî örnekleri kullanıp geçici bir projede deneyin. Üretim verisini etkileyen işlemleri insan yürütmeli veya tek tek onaylamalıdır.

İş akışının etkisini nasıl anlarsınız?

Yalnızca üretim hızını değil, yeniden çalışma sayısını, kapsam dışı değişiklikleri ve inceleme süresini karşılaştırın. Ajan isteği sık sık yanlış anlıyorsa görev açıklamasını ve kabul ölçütlerini iyileştirin; sürekli durup soru soruyorsa izinlerin gereğinden dar olup olmadığını kontrol edin. Tek seferlik küçük bir değişiklik için doğrudan soru-cevap daha uygun olabilir. Dinamik iş akışının değeri, riskli ve çok dosyalı görevlerde açık duraklama noktaları sağlamasıdır.

Resmî belgeler

Claude Code'a genel bakış