Claude Code'da bir özellik geliştirmeye başlıyorsunuz. İş, çetrefilli bir tip hatasında tıkanıyor; siz de aynı repoyu bu tür uğraşlarda daha iyi olan Codex'e veriyorsunuz. Codex hatayı düzeltiyor ama artık özelliğin ne için olduğunu, hangi dosyalara dokunmamaya karar verdiğinizi ya da burada "bitti"nin ne anlama geldiğini bilmiyor. Her şeyi baştan, aklınızdan anlatıyorsunuz. On dakika sonra geri dönüyorsunuz ve Claude Code da unutmuş. Kod ilerledi. Bağlam ilerlemedi.
Bu, birden fazla kodlama ajanı çalıştırmanın vergisidir. Her araç kendi hafızasını kendi formatında ve kendi oturumunda tutar; dolayısıyla iş bir ajandan diğerine geçtiği anda diff dışındaki her şey yere düşer. Kodlama ajanları arasında geçiş yaparken bağlamı korumak, o bağlamı tek bir ajanın dışında, bir sonrakinin sizin anlatmanıza gerek kalmadan okuyabileceği bir biçimde yaşatmak anlamına gelir.
Bu makale, bunu nasıl yapacağınızı Sharkly'yi iş akışı olarak kullanarak anlatıyor: kodlama ajanlarınızın üzerinde duran ve bağlamı, ilerlemeyi, engelleri, sonuçları ve insan incelemesini talepten sürüme kadar görünür tutan katman. Kodlama ajanlarınız zaten var. Buradaki sorun aralarındaki dikiş yeri ve her eklediğiniz ajanla birlikte genişliyor.
Bağlam ajanlar arasında neden taşınmaz
Bir kodlama görevinin bağlamı üç yerde yaşar ve bunlardan yalnızca biri taşınabilir.
Birincisi talimat dosyası: CLAUDE.md, AGENTS.md, GEMINI.md. Sürekli kurallar, gelenekler, testleri çalıştırma komutları. İkincisi oturum durumu: sizinle ajanın az önce konuştuklarının geçmişi, neyi denediği, neyi elediği. Üçüncüsü işin kendisi: diskteki diff ya da branch.
Yalnızca üçüncüsü bedavaya taşınır. Farklı bir ajan kodu okuyabilir ama parçası olmadığı bir sohbeti okuyamaz ve başka bir araca hitaben yazılmış bir talimat dosyasını okumaz. Şunu açıkça söylemek gerek: ajan değiştirmek kodu korur, gerekçeyi düşürür. Commit ayakta kalır. "Neden" ise bir ajanın gördüğü ve bir sonrakinin asla göremeyeceği bir kaydırma arabelleğindeydi.
Yani bir geçiş sırasında bağlamı korumak aslında iki iştir: sürekli kuralları her ajanın okuyabileceği hale getirmek ve canlı görev durumunu tek bir aracın hafızasından başka bir şey olarak var etmek. Sonraki bölümler bunları sırayla ele alıyor. (Sorununuz aynı ajanın çalıştırmaları arasında bağlam kaybetmekse, o ilgili ama ayrı bir sorun; AI oturumları arasında bağlamı koruma yazısında ele alınıyor.)
Sürekli kuralları her ajanın okuduğu tek dosya haline getirin
Ucuz kazançla başlayın. Claude Code CLAUDE.md, Codex AGENTS.md, Gemini CLI GEMINI.md okur. Aynı iş, üç farklı dosya adı. Bunları ayrı ayrı yönetirseniz birbirlerinden saparlar ve geçiş yaptığınız ajan, siz aksini varsayarken artık eski kurallara uyuyor olur.
Kuralları bir kez yazın ve diğer dosya adlarını ona yönlendirin. macOS veya Linux'ta:
# AGENTS.md is the source of truth; the others are aliases
ln -s AGENTS.md CLAUDE.md
ln -s AGENTS.md GEMINI.md
git add AGENTS.md CLAUDE.md GEMINI.md
Artık repoyu açan her ajan aynı gelenekleri okur ve değiştiklerinde güncellenecek tek bir dosya olur. Kısa ve olgusal tutun: test komutu, yasak dizinler, inceleme kuralı, commit'lerin nasıl görünmesi gerektiği. Bu, hangi ajana geçmiş olursanız olun, her ajanın başlar başlamaz devraldığı ortak sözleşmedir.
Dikkat edilmesi gereken başarısızlık modu: bu dosyalara göreve özgü ayrıntı koymak. Talimat dosyası, repodaki her görevde geçerli olan kurallar içindir. "Jest değil Vitest kullanıyoruz" buraya aittir. "Ödeme yeniden deneme mantığını bitir ve auth middleware'e dokunma" ait değildir; bu, bu hafta tek bir görev için doğru, sonraki için yanlıştır. İkisini karıştırmak, her ajanın zaten yayınlanmış bir iş için yazılmış talimatları okuması demektir.
Yalnızca kuralları değil, çalışma bağlamını da taşıyın
Kurallar dosyası yeni ajanı başlangıç çizgisine getirir. Devam eden görev hakkında hiçbir şey söylemez: neyin kararlaştırıldığını, neyin yarım kaldığını, neyin hâlâ belirsiz olduğunu. Geçiş yaptığınızda tam da bu bilgi buharlaşır, çünkü yalnızca önceki ajanın oturumunda yaşamıştır.
Manuel çözüm bir devir teslim notudur. Ajan değiştirmeden önce, mevcut ajana bulunduğu yeri yazdırın: hedef, değiştirdiği dosyalar, doğruladıkları ve emin olmadığı tek şey. Bunu bir sonraki ajana ilk mesaj olarak yapıştırın. İşe yarar ve tek bir geçiş için yeterlidir. Bu kalıbı kendi başına özümsemeye değer; iyi bir devir teslim notunun şekli ajan devir teslim şablonları yazısında ele alınıyor.
Başarısızlık modu, notun kalıcı bir yerde yaşamamasıdır. Kapatacağınız bir terminaldeki bir paragraf ya da her seferinde yeniden yazdığınız bir mesajdır. İki kez ileri geri geçiş yapın, devir teslim notunu üç araç arasında elle, kafanızda tutuyor olursunuz. Bağlam var ama onu saklayan veritabanı siz olmuşsunuzdur. Bu tek bir görev için geçerli. Birkaç görev çalıştırdığınızda geçerli değil; kendin yap yaklaşımının tükendiği nokta da burasıdır.
Kendin yap kurulumunun ölçeklenmeyi bıraktığı yer
Sembolik bağlantılı kurallar artı yapıştırılan bir devir teslim notu, tek repo ve iki ajanla sizi çok ileri taşır. Bir üçüncü ajan, ikinci bir repo ya da bir günü aşan bir görev ekleyin, hesap aleyhinize döner. Her geçiş elle bir dışa aktarma ve yeniden içe aktarmadır. Her görevin kendi "ne bitti" akışı vardır ve bu yalnızca son ajanın bıraktığı yerde yaşar. Hiçbir şey size arka uç Ajan'ın, ön uç Ajan'ın beklediği endpoint'i bitirdiğini söylemez; çünkü "söylemek" kimsenin izlemediği bir terminaldeki mesajdı.
O noktada çözüm daha iyi bir not değildir. Çalışma bağlamını ajanlardan tamamen alıp her ajanın ve kişinin okuyup yazdığı ortak bir Görev'e taşımaktır. Sharkly'de bir Görev; hedefi, kabul kriterlerini, diff'i, engelleri ve tartışmayı tek bir kayıtta tutar. Yürütme, engeller, sonuçlar ve takip işleri o Görev zaman çizelgesine döner; böylece ajan değiştirmek artık bir dışa aktarma olmaktan çıkar. Görevi yeniden atarsınız; bir sonraki ajan, son ajanın yazdığı aynı kaydı okur.
İnsan-ajan ayrımının netleştiği yer de burasıdır. Ajanlar araştırır, yürütür, test eder ve Görev'e rapor verir. İnsanlar yön belirler, yetki verir ve sonucu kabul eder. Otomasyon, ekip muhakemesi gereken yerde durur ve bir sonraki çalışanın okuduğu kayıt, bir inceleyicinin okuduğu kaydın aynısıdır. Bu ancak bağlam artık bir oturumda hapsolmadığı için işler.
İşte dürüst karar ikilisi. Tek bir terminalde, tek bir repoda tek bir ajan çalıştırıyorsanız bunların hiçbirine ihtiyacınız yok; bağlam zaten hiç ayrılmaz, dolayısıyla korunacak bir şey de yoktur. Bağlamın bir geçişten sağ çıkması gerektiği anda ortak bir Görev'e yönelin; bu geçiş ajanlar arası, ajan-insan arası ya da yalnızca yarın sabahki siz olsun. Tek bir ekosisteme bağlanmak yerine birkaç kodlama ajanı kullanmaya devam etmek istiyorsanız, asıl mesele bu taşınabilirliktir: bağlam hiçbirinin içinde saklanmadığı için iş akışınız bir sonraki seçtiğiniz ajanla birlikte ayakta kalır. Bu aynı zamanda, Claude Code ve Codex'i tek bir kod tabanında birlikte çalıştırmanıza olanak tanıyan kurulumdur; devir teslimde ikisi de kör kalmaz ve worktree'lerle, görev başına bir checkout ile doğal olarak eşleşir, böylece paralel ajanlar çakışmaz.
Bugün uygulayabileceğiniz kontrol listesi
Bunu sırayla tamamlayın. İlk üçü hiçbir maliyet getirmez; dördüncüsü, ilk üçü ayak uyduramaz hale geldiğinde geçeceğiniz aşamadır.
- Kurallar dosyasını birleştirin.
CLAUDE.md,AGENTS.mdveGEMINI.mddosyalarını tek bir kaynağa sembolik bağlayın. Yalnızca repo geneli geleneklerle sınırlı tutun, görev ayrıntısı olmasın. - Her geçişten önce bir devir teslim notu yazın. Hedef, değişen dosyalar, doğrulananlar, açık soru. Mevcut ajan taslağı hazırlayabilir; siz bir sonrakine yapıştırırsınız.
- Geçişe alışkanlığa göre değil, göreve göre karar verin. Ajanı önünüzdeki işe göre eşleştirin; açık olan terminale varsayılan olarak dönmek yerine bir yönlendirme rehberi kullanın.
- Notlar ölçeklenmeyi bırakınca bağlamı ajanlardan taşıyın. Bir iki ajan ya da repodan fazlasıyla uğraşmaya başladığınızda hedefi, durumu ve incelemeyi ortak bir Görev'e koyun; böylece geçiş, yeniden anlatmak değil yeniden atama olur.
Hâlihazırda birkaç ajan çalıştırıyor ve her geçişte aynı bağlamı yeniden anlatıyorsanız, Sharkly tam da bu sorun etrafında kuruldu: her ajanın görevlerinin, ilerlemesinin ve sonuçlarının görünür kaldığı tek bir yer, böylece bağlam geçişten daha uzun yaşar.
