Claude Code, kod tabanınızı okuyan, dosyaları düzenleyen, komutlar çalıştıran ve doğrudan git ile çalışan ajan tabanlı bir kodlama aracıdır. Tek bir terminaldeki tek bir geliştirici için hiçbir yönetim gerektirmez: işi tarif edersiniz, yapılırken izlersiniz ve farkı (diff) incelersiniz. Bu döngü hızlıdır ve bu rehberdeki hiçbir şey ondan vazgeçmenizi istemez.
Boşluk, bir ekip ona bağımlı hale geldiğinde ortaya çıkar. Claude Code oturumları yürüten beş geliştirici gerçek çıktı üretir, ancak iş özel terminallerde yaşar. Bir ekibin üzerine kurulu olduğu soruların hiçbirine kimse cevap veremez: bu değişikliği kim istedi, şu anda kim yürütüyor, çalışma gerçekte ne yaptı ve birleşmeden önce sonucu kim onayladı. Yürütme mükemmeldir; işin kaydı yoktur.
Claude Code proje yönetimi, bu işi takip edilen ve incelenebilen proje işi olarak yürütme pratiğidir: bir issue, kapsamı belirlenmiş bir Task'a dönüşür; Task, Claude Code üzerinden yürüten bir Agent'a atanır; çalışma, kontrol ettiğiniz bir makinede izole bir worktree içinde gerçekleşir ve sonuç incelenmek üzere bir insana geri döner. Bu rehber, bu yayı Sharkly ile anlatır; Sharkly, Claude Code'un yerini almaz. Ekibinizin zaten kullandığı aracın etrafına paylaşılan görev, bağlam, kontrol ve inceleme katmanını ekler.
Kısaca
Claude Code işini proje işi gibi yönetmek için issue'yu hedefi, sınırları ve kabul kriterleri olan kapsamlı bir Task olarak yazın; Runtime'ı Claude Code olan bir Agent'a atayın; çalışmanın bağlı bir Computer üzerinde izole bir git worktree içinde yürümesine izin verin ve ilerleme akış halinde geri gelsin; ardından Task üzerindeki kanıtları inceleyip kabul edin, değişiklik isteyin ya da yeniden atayın. Yürütmeyi Claude Code yapar. Sharkly ise atamayı, bağlamı, ilerlemeyi, engelleri, sonuçları ve insan incelemesini onun etrafında yönetir; böylece paralel çalışmalar özel terminallerde kaybolmak yerine tüm ekip tarafından görülebilir kalır. Tek başına terminal oturumları hızlı, yerel ve düşük riskli işler için doğru araç olmaya devam eder.
Yönetilen bir Task, ham bir Claude Code oturumuna ne katar
Ham bir oturum ile yönetilen bir Task, altta aynı Claude Code'u çalıştırır. Fark, çalışmanın etrafındaki her şeydir ve bu fark, bir terminalin sunamayacağı dört yeteneğe ayrılır.
Paylaşılan görünürlük. Bir Task; gereksinimleri, görev durumunu, tartışmayı, yürütme kayıtlarını ve incelemeyi özel prompt'lara ve oturumlara bölmek yerine tek bir yerde tutar. Bir ekip arkadaşınız SH-214'ü açıp ne istendiğini, neyin çalıştığını ve neyin geri döndüğünü görebilir.
Sahiplik. Bir Task, insan sorumluluğunu Agent yürütmesinden ayırır. Sonuçtan bir kişi sorumludur; yürütmeyi üstlenen ise bir Agent veya Crew'dür. İkisi de kaydedilir, böylece “bunun sahibi kim” sorusunun her zaman bir cevabı vardır.
İnceleme kanıtı. Her çalışma bir yürütme izi üretir: ne zaman başladığı, hangi araçları çağırdığı, neden kuyruğa alındığı ve nasıl sonuçlandığı. Agent'ın raporu, bu ize bağlı bir yorum olarak saklanır. İnceleme artık “terminali izleyen kimse ona güvenilsin” olmaktan çıkıp “kaydı oku” haline gelir.
Çakışmasız paralel çalışmalar. Her Task izole bir dizin alır ve depo (repository) tabanlı işler her çalışma için ayrı bir git worktree kullanabilir; böylece birkaç Task aynı kod tabanını aynı anda değiştirebilir. Paralel çalışma mekaniğinin kendi rehberi var: birden fazla Claude Code agent'ı nasıl paralel çalıştırılır.
Adım adım anlatıma geçmeden önce dürüst bir sınır çizelim. Her Claude Code oturumu buna ihtiyaç duymaz. Bir soruyu araştırmak, bir plan şekillendirmek veya hızlı bir yerel değişiklik yapmak için bağımsız bir Agent Chat ya da sade bir terminal oturumu kullanın. İş sahiplik, durum, yürütme geçmişi veya inceleme gerektirdiğinde ise bir Task kullanın.
1. Adım: Issue'yu bir Agent'ın yürütebileceği bir Task'a dönüştürün
Bu yay, herhangi bir agent çalışmadan önce başlar. Claude Code yaklaşımını sizin verdiklerinizden planlar; bu yüzden belirsiz bir Task, yanlış yönde kendinden emin bir çalışma üretir.
İşe yarar bir Task başlığı, konuyu değil sonucu adlandırır. Açıklama ise yeni bir kişinin ya da bir Agent'ın ilerlemek için ihtiyaç duyacağı her şeyi taşımalıdır: iş neden önemli; neler kapsam içinde, neler dışında; ilgili dosyalar, bağlantılar veya gözlemlenen davranış; kısıtlar ve alınmış kararlar; ve tamamlanmanın nasıl inceleneceği.
İşte tek kişilik akışların atladığı madde bu sonuncusudur. Açıklamaya “bitti demek, yeniden deneme mantığının eski davranışta başarısız olan bir testi olması demektir” yazmak, inceleyiciye bir kontrol listesi, Agent'a ise bir hedef verir. Kalıcı hedefi, kapsamı ve kabul kriterlerini açıklamada tutun; tartışma için yorumları kullanın.
Durum kategorisi burada da önemlidir: Backlog'daki bir Task beklemededir ve ona bir Agent atamak yürütmeyi başlatmaz. Bu bir özelliktir. Bir grup Task'ı şekillendirip hepsini atayabilir ve hazır olduklarında Backlog'dan çıkararak her birini kasten serbest bırakabilirsiniz.
Issue'larınız zaten başka bir yerde duruyorsa sürecinizi baştan kurmak zorunda değilsiniz. Sharkly'nin entegrasyonları arasında Jira, Slack ve GitHub bulunur; böylece mevcut takip sistemleri yerinde kalırken yürütme atanabilir ve izlenebilir hale gelir. Agent'ların yürütebileceği işler yazma disiplini, agentic coding nedir yazımızda ele aldığımız daha geniş bir dönüşümün parçasıdır.
2. Adım: Onu Runtime'ı Claude Code olan bir Agent'a atayın
Sharkly'de işi doğrudan Claude Code'a atamazsınız. İşi bir Agent'a atarsınız ve o Agent'ın Runtime'ı Claude Code'dur. Bu ayrım boşuna yapılmış değildir.
Bir Agent, tek seferlik bir prompt değil, kaydedilmiş bir çalışma yapılandırmasıdır: talimatları, Runtime'ı, Skills'leri, depoları, ortam değişkenleri ve çalışma ayarları işi nasıl ele aldığını şekillendirir. Bir kişi bir “Backend Fixer” Agent'ını bir kez yapılandırır, Space'e paylaşır ve her geliştiricinin doğaçlama prompt'lar yazması yerine tüm ekip aynı test edilmiş yapılandırmaya iş atar. Bu kavramı Sharkly'deki Agent'lar, açıklandı yazımızda tüm ayrıntılarıyla ele alıyoruz.
Runtime, bir Computer'da kullanılabilir olan somut agent aracıdır. Bir makine bağladığınızda küçük bir yerel servis, orada kurulu olan desteklenen agent araçlarını algılar ve her birini bir Runtime olarak bildirir; bir Claude Code kurulumu, servis onu gördüğü anda kullanılabilir bir Runtime olarak görünür.
Bu düzenlemeyle ilgili üç gerçek, beklentileri doğru tutar:
- Agent, Runtime'ın varsayılan modelini izler. Sharkly bir model adı göstermez veya vaat etmez; Agent üzerinde model seçici ya da düşünme derinliği kontrolü yoktur. Modeli değiştirmek için Claude Code'un kendi içindeki yapılandırmayı değiştirin.
- Model kullanımı size aittir (bring-your-own). Çalışmalar, o Computer'da Claude Code içinde zaten yapılandırılmış Claude aboneliğini veya API anahtarını kullanır. Model kotası, ekibinizin bağladığı yapay zeka kodlama araçlarına, planlara ve API hesaplarına bağlıdır.
- Atama açıktır. Task'ın Assignee kontrolünü açıp Agent'ı seçersiniz, tıpkı bir ticket'ı bir iş arkadaşınıza atadığınız gibi. Sorumlu kişi ayrıca kaydedilmeye devam eder.
Küçük ve iyi tanımlanmış işler için Task'ı doğrudan tek bir Agent'a atayın. Bir Crew'ü, yani tek bir lider Agent tarafından koordine edilen yeniden kullanılabilir bir People ve Agent grubunu, yalnızca liderin hedefi gerçekten yorumlaması ve diğer üyelerin sonuçlarını tek bir Task'a geri getirmesi gerektiğinde kullanın. İlk atamanın adım adım anlatımı ilk görevinizi bir yapay zeka agent'ına nasıl atarsınız yazımızda.
3. Adım: Bir Computer üzerinde, izole bir worktree içinde yürütme
Task Backlog'dan çıktığında ve Agent hazır olduğunda Sharkly çalışmayı kuyruğa alır ve seçilen Computer'a gönderir: dizüstü bilgisayarınız, uzak bir sunucu veya bir konteyner. O makinedeki yerel servis çalışmayı alır, görev dizinini hazırlar, Claude Code'u başlatır ve ilerlemeyi akış halinde geri gönderir. Kodunuz, kimlik bilgileriniz ve Claude Code kurulumunuz kontrol ettiğiniz donanımdan asla ayrılmaz.
Sorumlulukların ayrımını açıkça belirtmekte fayda var: Agent, işin nasıl ele alınacağını tanımlar; Computer, ana makineyi ve yerel kaynakları sağlar; Runtime, gerçek agent oturumunu yürütür; Task ise paylaşılan kayıt olarak kalır.
Depo işleri için önerilen çalışma dizini modu Temporary'dir: her Task izole bir dizin alır ve yerel servis, önbelleğe alınmış depo verilerinden her çalışma için yeni bir git worktree hazırlayabilir. Aynı depoya dokunan iki Task, diskte iki farklı dizine yazar; paralel çalışmaların birbirini ezmemesinin nedeni budur. Bu yapı taşı yapay zeka kodlama agent'larıyla git worktree'ler nasıl kullanılır yazımızda ele alınıyor. Specified modu, yani çalışmaların yeniden kullandığı tek bir yapılandırılmış yerel dizin, dürüst istisnalar için vardır: çok büyük bir depo, pahalı yerel önbellekler veya tek bir yola bağlı araçlar.
Claude Code çalışırken, çalışma görünür durumlardan geçer: kuyruğa alındı, gönderildi, çalışıyor, ardından tamamlandı, başarısız oldu veya iptal edildi. Çalışma durumu, Task durumundan ayrıdır ve bu ayrım işe yarar: bir Task; Agent'ı çalışırken, bir insan yanıtı beklerken veya bir hata bildirirken In Progress olarak kalabilir ve kimsenin hangisi olduğunu anlamak için terminali yoklaması gerekmez.
4. Adım: İlerleme ve engeller Task'a geri döner
Ekibin görmesi gereken her şey tek bir yere geri döner. Agent'ın raporu, yürütme izine bağlı bir yorum olarak saklanır. Activity, yorumları ve görev değişikliklerini tek bir zaman çizelgesinde gösterir. Executions ise çalışma geçmişini tutar: tetikleyici kaynağı, başlangıç ve bitiş zamanları, araç çağrıları ve hata ayrıntıları.
Engeller sessizce tıkanmak yerine yüzeye çıkar. Bir Agent, bir Task'ı insan yanıtı veya incelemesi bekler halde bırakabilir ve engellenen işler Inbox'ı besler; Inbox, dikkatinizi gerektiren Task'ları daha düşük öncelikli güncellemelerden ayıran kişisel kuyruktur. Fark yapısaldır: tıkanmış bir oturum, siz sekmeyi kontrol edene kadar bekler; engellenmiş bir Task ise sorumlu kişiye engellendiğini söyler.
İşi sürdürmek yeni bir oturum değil, bir yorumdur. Hâlâ Agent'a atanmış bir Task'a yapılan uygun bir yorum, Task'ın birikmiş bağlamıyla bir takip çalışması başlatır ve hızlı art arda gelen yorumlar birleştirilir; böylece yinelenen bekleyen çalışmalar oluşturmazsınız.
5. Adım: İnsan incelemesi ve kabul
Bu yay, olması gereken yerde sona erer: bir insanda. Agent'lar araştırır, yürütür, test eder ve raporlar. İnsanlar yön belirler, yetki verir ve sonucu kabul eder.
Yönetilen bir Task'ta inceleme, bir oturumu yeniden izlemek değil kanıt okumaktır. İnceleyici, Agent'ın raporunu 1. Adım'da yazılan kabul kriterlerine göre kontrol eder: kapsam içinde kaldı mı, ilgili kontrolleri çalıştırdı mı, sonuçları için kanıt sundu mu, tahmin etmek yerine belirsizliği kaydetti mi. Özet yeterli olmadığında yürütme izi oradadır.
Ardından kabul, üç dürüst yoldan birini izler. İşi kabul edip Task'ı tamamlanmış bir duruma taşırsınız. Odaklı bir yorumla değişiklik istersiniz; bu, tüm bağlamı taşıyan bir takip çalışması başlatır. Ya da çalışmanın yanlış gittiğine karar verirsiniz: iptal edin, yürütme günlüğünü okuyun ve yeniden deneyin veya işi başka bir Agent'a atayın.
Bunların hiçbiri git incelemenizin yerini almaz. Claude Code, normal git barındırma hizmetiniz üzerinden dal oluşturur, commit yazar ve pull request açar; birleştirme incelemeniz de olduğu yerde kalır. Task ise PR sayfasının göremediklerini ekler: ilk talep, yürütme kanıtı ve kaydedilmiş kabul.
Tek başına oturum ile yönetilen Task karşılaştırması
| Soru | Tek başına Claude Code oturumu | Yönetilen Sharkly Task'ı |
|---|---|---|
| Bunu kim istedi? | Sizin hafızanız | Kapsamı ve kabul kriterleriyle birlikte Task açıklaması |
| Bunun üzerinde kim çalışıyor? | Terminalin sahibi kimse o | Sorumlu kişi artı yürütmeyi üstlenen bir Agent |
| Şu anda ne oluyor? | Terminali izleyin | Task, board'lar ve Inbox üzerindeki çalışma durumu |
| Çalışma ne yaptı? | Sekme kapanana kadar geri kaydırma geçmişi | Yürütme izi ve kalıcı yorumlar |
| İki çalışma aynı depoyu paylaşabilir mi? | Yalnızca worktree'leri elle kurarsanız | Varsayılan olarak her Task için izole worktree |
| Sonucu kim onayladı? | Kimse kaydetmez | Task üzerinde inceleme ve kabul |
| Ekip kurulumu yeniden kullanabilir mi? | Prompt'lar tek bir kişide kalır | Space'te paylaşılan Agent'lar ve Skills'ler |
Sol sütun yanlış sütun değildir. Keşif ve hızlı düzeltmeler için doğru araçtır. Sağ sütun ise işin görünür, incelenebilir ve paralel olması gerektiğinde kendini kanıtlar.
Tek bir Task'tan yönetilen bir projeye
Yukarıdaki her şey, şekil değiştirmeden tek bir Task'tan bir plana ölçeklenir. Birkaç Task tek bir sonuca hizmet ettiğinde Projects halinde, soru bu zaman aralığında ne yayınlanacağı olduğunda ise Sprints halinde gruplanır. Views, ekibin tekrar tekrar sorduğu soruları kaydeder; örneğin inceleme bekleyen Task'lar gibi.
Bu iş akışının tüm tezi budur. Ekibin kaldıraç gücü daha fazla yapay zeka sohbeti açmaktan değil; rolleri, kuralları, bağlamı ve iş akışlarını paylaşmaktan gelir. Bu disiplinin genel tabloda nerede durduğu ise ana rehberimizin konusu: yapay zeka agent proje yönetimi nedir.
Gerekli göründüğünden daha küçük başlayın. Bir Computer bağlayın, Claude Code'un kullanılabilir bir Runtime olarak göründüğünü doğrulayın, dar bir role sahip bir Agent oluşturun ve ona gerçek kabul kriterleri olan düşük riskli bir Task atayın. Sonucu, yeni bir ekip arkadaşınızın ilk pull request'ini incelediğiniz gibi inceleyin. Sharkly dokümantasyonu her kavramı daha ayrıntılı ele alır.
SSS
Sharkly, Claude Code'un yerini alır mı?
Hayır. Sharkly; Claude Code, Codex veya diğer yürütme araçlarının yerini almaz. Yürütmeyi Claude Code yapar: kod tabanını okur, dosyaları düzenler, komutlar çalıştırır ve git ile çalışır. Sharkly ise onun etrafına ekip düzeyinde bir katman ekler; atamayı, görev bağlamını, ilerlemeyi, engelleri, sonuçları ve insan incelemesini yönetir.
Claude Code'u Sharkly üzerinden çalıştırmak için ayrı bir model aboneliğine ihtiyacım var mı?
Hayır. Model kullanımı, bağlı Computer'larınızda Claude Code içinde zaten yapılandırılmış abonelikler veya API anahtarları üzerinden devam eder. Model kotası, ekibinizin bağladığı yapay zeka kodlama araçlarına, planlara ve API hesaplarına bağlıdır.
Claude Code'u hâlâ doğrudan terminalde kullanabilir miyim?
Evet, kullanmalısınız da. Bir soruyu araştırmak, bir plan şekillendirmek veya hızlı bir yerel değişiklik yapmak için doğrudan bir oturum ya da bağımsız bir Agent Chat doğru araçtır. İş sahiplik, durum, yürütme geçmişi veya inceleme gerektirdiğinde bir Task'a geçin.
Bir çalışma başarısız olduğunda ne olur?
Çalışma, Task üzerinde başarısız olarak işaretlenir ve yürütme günlüğü, başlığın yanı sıra model servisinden gelen orijinal teknik ayrıntıları kaydeder. Sharkly'nin sorun giderme rehberi; hız sınırları, tükenmiş kota ve kimlik doğrulama hataları gibi yaygın durumları sonraki adımlarla eşleştirir ve Claude Code'un kendi hata referansına bağlantı verir. Nedeni düzelttikten sonra yeniden deneyin veya Task'ı başka bir Agent'a atayın.
Aynı depoda aynı anda birkaç Claude Code Task'ı çalışabilir mi?
Evet. Temporary çalışma dizini modunda her Task kendi izole dizininde çalışır ve depo tabanlı çalışmaların her biri yeni bir git worktree alabilir; böylece eşzamanlı Task'lar paylaşılan bir checkout'a yazmaz. Agent ve Computer üzerindeki eşzamanlılık sınırları, aynı anda kaç tanesinin çalışacağını belirler.
