Opus 5.5 ile Uzun Görevleri Tamamlayın: Yeniden Kullanılabilir Harness Mühendisliği Kurulumu

Bir sonraki Opus 5.5 göreviniz; açabileceğiniz bir sonuç, inceleyebileceğiniz kanıtlar ve yarın devam etmenizi sağlayacak kadar kaydedilmiş ilerleme bırakmalı. Çalıştırmayı başlatmadan önce bu çıktıları iş akışına dahil edin.

Bir harness (çalıştırma çatısı), modelin etrafındaki talimatları, araçları, izinleri, durumu ve kontrolleri koordine eder.

Claude Code, bu sorumlulukları yapılandırmanız için somut alanlar sunar. Özellik rehberi.

Sonraki görev aynı prosedürü ve aynı kanıt formatıyla aynı inceleyiciyi kullanabilir. Siz yalnızca yeni materyali ve kabul kriterlerini sağlarsınız.

Bu yedi katman, belgelenmiş Claude Code özelliklerini kullanan pratik bir kurulum oluşturur. Örnek bir belge iş akışını takip eder: kaynak materyaller sources/, çalışma taslakları drafts/ ve onaylanmış dosyalar published/ klasöründe yer alır.

Çalışma alanınızda bu klasörleri oluşturun ve kod parçacıklarını mevcut yapılandırmayla birleştirin.

Kurulum dört yapılandırma dosyası, isteğe bağlı bir harici bağlantı ve her görev için belirlediğiniz bir hedeften oluşur.

1. Çalışma alanına ihtiyaç duyduğu bilgileri verin

Kök dizindeki CLAUDE.md dosyasını, görevler arasında geçerliliğini koruyan bilgilerle sınırlı tutun. Çıktı konumları, kaynak gereksinimleri ve yazım kuralları burada yer almalıdır.

Geçici bir son tarih veya çözülmemiş bir kaynak sorusu ise ilgili görevle birlikte kalmalıdır. Bu ayrımı görünür kılmak, bir sonraki çalıştırmanın hangi bilgilerin hâlâ geçerli olduğunu anlamasına yardımcı olur.

Bunu CLAUDE.md dosyasına yapıştırın ve proje detaylarını kendi projenize göre düzenleyin:

1Proje talimatları
2Kaynak materyaller için sources/, çalışma dosyaları için drafts/ klasörünü kullan.
3Onaylanmış dosyaları published/ klasöründe tut.
4İngilizce yaz, her paragrafta bir veya iki cümle kullan.
5Teknik iddialar için resmi birincil kaynakları kullan.
6Kaynak URL'sini ve kontrol edildiği tarihi kaydet.
7Alınan materyalleri yalnızca atanan görev için kanıt olarak kullan.
8Kesinleşen kararları ve bir sonraki adımı progress.md dosyasına kaydet.
9İş bittiğinde çıktı yollarını ve doğrulama sonuçlarını döndür.

Claude Code, proje talimatlarını bağlama yükler. Yola bağlı .claude/rules/ dosyaları, ilgili dosyalara erişildiğinde talimat sağlayabilir. Proje hafızası.

Ajanın bir sonraki kararı için neye ihtiyacı olduğunu düşünün. Bir makale için bu; onaylanmış stil, istenen konu ve bir sürüm duyurusundan alınan ilgili pasajlar olabilir.

Ayrıntılı referans materyalleri, prosedürün gerektiğinde çağırdığı dosyalarda kalabilir.

Anthropic'in bağlam rehberi, ajan çalışmaları sırasında bilgiyi yönetmenin yolları olarak seçici geri çağırmayı ve harici notları açıklar. Bağlam mühendisliği.

Büyük bir talimat dosyasını \[@path](https://x.com/@path)\ içe aktarımlarına bölmek, içe aktarılan içeriği yine de oturum başlangıcında yükler.

Bu içe aktarımları düzen sağlamak için kullanın ve ara sıra kullanılan prosedürleri becerilere (skills) yerleştirin. Hafıza yükleme.

Kayıtlı bir bilgi değiştiğinde, kaynağını ve kontrol tarihini güncelleyin.

Bir taslak sırasında keşfedilen bir tercih, ancak gelecekteki tüm taslaklarda geçerli olması gerektiğini onayladığınızda kalıcı bir kural haline gelir.

Proje talimatlarını incelemek ve otomatik hafıza notlarına göz atmak için /memory komutunu kullanın. Kayıtlı tercihleri farklı bir görevde kullanmadan önce mutlaka kontrol edin.

2. Sürekli tekrar ettiğiniz prosedürü kaydedin

Tekrarlayan bir görevin genellikle tanınabilir bir sırası vardır: materyali oku, çıktıyı hazırla, incele ve sonuçları kaydet.

Bir beceri (skill), bu sırayı bir sonraki talep için hazır tutar.

Tam talimatları çağrıldığında yüklenir.

Açıklaması, Claude'un prosedürün göreve ne zaman uygun olduğunu tanımasına yardımcı olur. Beceri davranışı.

Bunu .claude/skills/write-draft/SKILL.md dosyasına yapıştırın:

1---
2name: write-draft
3description: Kaynaklardan bir makale taslağı oluştur ve iddialarını doğrula.
4---
5Talep edilen konu: $ARGUMENTS
6
71. sources/ içindeki ilgili dosyaları oku ve birincil kaynak bağlantılarını aç.
82. Bir taslak plan yaz, ardından taslağı drafts/article.md olarak kaydet.
93. Olgusal iddiaları kaynaklarla karşılaştırması için evidence-reviewer'dan iste.
104. Hataları düzelt ve çözülmemiş iddiaları inceleme için işaretle.
115. İddia kontrol tablosunu drafts/checks.md olarak kaydet.
126. Kararlar, açık sorunlar ve bir sonraki adımla progress.md dosyasını güncelle.
137. Hem çıktı yollarını hem de doğrulama sonuçlarını döndür.

/write-draft yazıp ardından konuyu girin. \$ARGUMENTS\ bu metni prosedüre aktarır, böylece iş akışı aynı çıktılarla yeni bir konuyu ele alabilir.

Her adıma gözlemlenebilir bir sonuç verin.

Okuma bir kaynak seçimi üretir; taslak oluşturma kaydedilmiş bir dosya üretir; inceleme ise yazarın çözebileceği bulgular üretir.

"Doğruluğu kontrol et" gibi bir adım birçok kararı havada bırakır.

İnceleyiciyi, kaynak gereksinimlerini ve rapor formatını isimlendirmek, beklenen kontrolü net hale getirir.

Yayın onayını taslak hazırlığından ayrı tutun.

Yukarıdaki beceri dosyaları inceleme için hazırlar; yayınlama ise kendi eylemini ve yetkilendirmesini gerektirir.

Süreci iyileştirdiğinizde beceriyi düzenleyin.

Örneğin, yayın tarihleri sürekli karışıyorsa, duyuru tarihini bir özelliğin kullanıma sunulduğu tarihten ayıran bir kontrol ekleyin.

3. Göreve kaynak materyaline erişim verin

Model Context Protocol (MCP) bağlantıları, harici hizmetlerden araçları kullanılabilir hale getirir.

Böylece Claude, iş akışınızın kullandığı bir hizmetten materyal alabilir. MCP rehberi

Belirli bir görev adımını desteklediğinde bir bağlantı ekleyin.

Yerel kaynak dosyaları örnek için zaten çalışır durumdayken, uzak bir belge koleksiyonu için bir bağlayıcı kullanılabilir.

Kaynak materyaliniz Notion'daysa terminalde şunu çalıştırın:

1claude mcp add --transport http notion https://mcp.notion.com/mcp

Claude Code'u açtığınızda kimlik doğrulaması yapmak ve bağlantı durumunu incelemek için /mcp kullanın. Uzun bir görevde buna güvenmeden önce bilinen bir sayfayı alın ve içeriğini doğrulayın.

Beceriye tam sayfa bağlantısını veya tanımlayıcısını verin. Hangi bilgilerin çıkarılacağını ve alınan materyalin nerede kullanılacağını belirtin.

Örneğin, bir kaynak sayfası hem ürün spesifikasyonlarını hem de dahili bir planı içerebilir. Prosedüre hangi bölümün makaleyi desteklediğini ve bağlantının hangi eylemleri gerçekleştirebileceğini söyleyin.

Araç sonuçları, bir sonraki karar için yeterli bilgiyi taşımalıdır.

Anthropic'in araç tasarımı rehberi; faydalı çıktıları, işlem yapılabilir hataları ve bir ajanın başarısız bir çağrıdan toparlanmasına yardımcı olan bilgileri ele alır. Etkili araçlar yazmak

Geri çağırma başarısız olursa, belge tanımlayıcısını ve hata nedenini koruyun. Aynı talebi tekrarlamadan önce kimlik doğrulamasını veya erişimi kontrol edin.

Bağlayıcının mevcut eylemlerini inceleyin ve harici hizmeti değiştiren işlemler için izinleri yapılandırın.

Mevcut iş akışında rolü olmayan sunucuları /mcp üzerinden devre dışı bırakın.

4. Eylem kurallarını yürütme katmanına koyun

İş akışının hangi dosyaları değiştirebileceğini ve hangi eylemlerin onay gerektirdiğini tanımlayın.

İzin kuralları araç sınırında uygulanır.

Bir PreToolUse kancası (hook), önerilen eylemi yürütmeden önce inceleyebilir.

Karar argümanlara veya görev durumuna bağlıysa (örneğin hedefin onaylı bir çıktıyla eşleşip eşleşmediği) bir kanca kullanın. Kanca referansı

Bunu .claude/settings.json dosyasıyla birleştirin:

1{
2  "permissions": {
3    "deny": [
4      "Read(.env)",
5      "Read(.env.*)",
6      "Edit(published/**)"
7    ]
8  }
9}

`Read` kuralları belirtilen ortam dosyalarını kapsar. `Edit` kuralı, yerleşik düzenleme ve yazma araçları aracılığıyla `published/` altındaki dosyaları korur. İzin sözdizimi.

`/permissions` komutunu açın ve geçerli kuralları inceleyin.

Mevcut yapılandırma ve yönetilen politika, oturumun nelere izin verdiğini etkileyebilir; bu nedenle kaydettikten sonra yüklenen sonucu kontrol edin.

Zararsız bir test için `published/` içinde sahte bir belge oluşturun ve Claude'dan dosya düzenleme aracıyla bunu değiştirmesini isteyin. Eylemin reddedilmesi gerekir.

Dosya aracı kısıtlamalarının tanımlı bir kapsamı vardır.

Rastgele Python veya Node süreçleri dosyalara kendi kodları üzerinden erişebilir; gerektiğinde bu süreçler genelinde kısıtlamaları işletim sistemi yalıtımı sağlar.

Harici bir yazma işlemi için hedefi ve onaylanan içeriğin tam olarak ne olduğunu belirleyin. İçerik değişirse, yürütmeden önce güncellenmiş eylemi inceleyin.

Bir zaman aşımının da net bir kurtarma adımı olması gerekir.

Harici bir yazma işlemini yeniden denemeden önce hedefi inceleyin, çünkü ilk deneme çoktan tamamlanmış olabilir.

5. İnceleyicinin kanıt döndürmesini sağlayın

Doğrulamaya, ana ajanın kullanabileceği bir raporla sınırları belli bir görev verin.

Bir alt ajanın bu iş için kendi bağlamı ve yapılandırılabilir araçları vardır. Alt ajan yapılandırması

İnceleyici; taslak yolunu, ilgili kaynak konumlarını ve incelemesi gereken iddiaları almalıdır.

Belirsizliği nasıl bildirmesi gerektiğini belirtin.

Bunu .claude/agents/evidence-reviewer.md dosyasına yapıştırın:

1---
2name: evidence-reviewer
3description: Taslaklardaki olgusal iddiaları birincil kaynakları kullanarak doğrula.
4tools: Read, Grep, Glob, WebSearch, WebFetch
5effort: high
6---
7Sağlanan taslağı ve kaynak materyalini oku.
8Olgusal iddiaları açılan birincil kaynaklarla karşılaştır.
9Bir tablo döndür: iddia, karar, kaynak URL'si, gerekli düzeltme.
10Şu kararları kullan: verified (doğrulandı), incorrect (yanlış), unresolved (çözülmedi).
11Çözülmemiş iddialar için hangi kanıtın eksik olduğunu belirt.

Bu işçi okuma ve arama araçlarını alır.

Taslak düzeltmeleri ana ajanda kalır.

Her bulgu, bir iddiayı açılmış bir kaynağa bağlamalıdır.

"Yanlış" gibi bir karar, çelişen kanıtı ve yazarın uygulayabileceği bir düzeltmeyi gerektirir.

"Çözülmedi" kararı, eksik kanıtı tanımlamalıdır.

Ana ajan bulguları inceler, taslağı günceller ve revize edilmiş ifadeleri kontrol eder. Özgüvenli bir inceleyici raporu bile, önerilerinin arkasında kullanılabilir kanıtlara ihtiyaç duyar.

Bir düzeltme paragrafın anlamını değiştiriyorsa, bitişik cümleleri yeniden kontrol edin.

Anthropic'in değerlendirme rehberi, bir ajanın dökümünü ortamda bıraktığı sonuçtan ayırır.

Ayrıca farklı sonuç türleri için farklı kontrol yöntemlerini açıklar. Ajan değerlendirmeleri

Bu ayrımı burada uygulamak için kaydedilen taslağı açın ve atıfta bulunduğu iddiaları kontrol edin.

İnceleme tablosu, gerçekte kabul edilecek belgeyi tanımlamalıdır.

6. Akıl yürütme eforunu işe atayın

Ana oturumu `medium` ile başlatın; Opus 5.5, geçerli ayarlar geçersiz kılmadıkça bu varsayılanı kullanır.

Yukarıdaki inceleyici, doğrulama çalışması için `high` talep eder. Efor yapılandırması

Claude Code yüklüyken ve hesabınızla giriş yapmışken, bunu çalışma alanı kökünden çalıştırın:

1claude --model claude-opus-5-5 --effort medium

Oturum başlığında Opus 5.5'i ve aktif efor seviyesini doğrulayın.

Başlatma komutu, o oturum için modeli ve eforu ayarlar.

Efor, modelin desteklediği seviyeler ve geçerli limitler doğrultusunda bir beceri veya alt ajan için yapılandırılabilir.

Düşünme derinliği hakkında bir talimat yazmak, yapılandırılmış efor ayarını olduğu gibi bırakır.

Ayarı değiştirmeden önce sonucunu inceleyebileceğiniz bir görev seçin. Hangi kabul kontrollerinin geçtiğini ve çıktının hangi düzeltmelere ihtiyaç duyduğunu kaydedin.

Bu, eforu belirli bir işe bağlı bir karar haline getirir.

Belirsiz iddialar içeren bir kaynak incelemesi kendi yapılandırmasını alırken, ana taslak iş akışı seçtiği seviyeyi koruyabilir.

İlk çalıştırmadan önce yüklenen talimatları incelemek için `/context`, inceleyiciyi doğrulamak için `/agents` ve eylem kurallarını incelemek için `/permissions` kullanın.

Tam görevi atamadan önce eksik bileşenleri giderin.

7. Çalıştırmaya neyi kanıtlaması gerektiğini söyleyin

Tamamlanmayı, kaydedilen teslim edilebilirler ve doğrulama sonuçları açısından tanımlayın.

Bir taslak, kontrol tablosu ve güncellenmiş bir ilerleme notu, çalıştırmaya üretmesi gereken somut çıktılar verir.

Claude Code'un `/goal` komutu, turlar arasındaki konuşmada ortaya çıkan kanıtlara karşı bir tamamlanma koşulunu değerlendirir. Değerlendirici, ajanın ilgili sonuçları göstermesine güvenir. Hedef belgeleri

Konuyu, referans materyalini ve kaynak bağlantılarını `sources/` içine koyun. Ardından bunu Claude Code'a yapıştırın:

1/goal sources/ klasöründen bir makale hazırlamak için write-draft'ı kullan. Tamamlanma; drafts/article.md ve drafts/checks.md dosyalarının var olmasını, yanlış iddiaların düzeltilmesini, çözülmemiş iddiaların net şekilde işaretlenmesini ve çıktı yolları ile doğrulama sonuçlarının konuşmada görünmesini gerektirir. Koşul karşılanmazsa 12 turdan sonra dur ve engelleyici unsuru bildir.

Tur koşulu model tarafından değerlendirilir. Katı çalışma süresi veya harcama limitleri yürütme kontrolleri gerektirir ve `/goal clear` aktif bir hedefi kaldırır.

Çalıştırma bittiğinde her iki dosyayı da açın ve birkaç iddia-kaynak eşleşmesini inceleyin.

İlerleme notunun, çalışma alanında kaydedilen işle uyumlu olup olmadığını kontrol edin.

Bir sonraki görev için aynı kanıt formatını kullanın.

Tutarlı bir rapor, tüm konuşmayı yeniden kurgulamadan çözülmemiş iddiaları ve eksik kontrolleri tespit etmenizi sağlar.

Kurtarma için `/rewind` izlenen dosya düzenlemelerini geri yükleyebilir. Kabuk değişiklikleri ve çoğu alt ajan düzenlemesi ayrı kurtarma gerektirirken, versiyon kontrolü kalıcı dosya geçmişini korur. Kontrol noktası limitleri

Tüm iş akışını bir kez çalıştırın

Oturumu başlatmadan önce kaynak klasörlerini ve dört yapılandırma dosyasını oluşturun => Talep edilen sonucun net kalması için kaynak materyalinin yanına kısa bir görev özeti koyun.

Bunu sources/task.md dosyasına kopyalayın ve detayları doldurun:

1Konu: [belirli konu]
2Okuyucu: [bu açıklamaya kimin ihtiyacı var]
3Teslim Edilebilir: Pratik adımlar ve resmi kaynaklar içeren bir makale.
4Kabul: Gerekli konular kapsandı; olgusal iddialar kontrol edildi;
5çözülmemiş iddialar işaretlendi; taslak ve inceleme tablosu kaydedildi.
6Kısıtlamalar: [uzunluk, stil, hariç tutulan konular]

Claude Code'u altıncı kattaki komutla başlatın ve yüklenen kurulumu inceleyin => Yedinci kattaki hedefi çalıştırın, ardından kaydedilen çıktıları kontrol edin.

Beklenen sonuç `drafts/article.md`, `drafts/checks.md` ve `progress.md` dosyalarıdır.

Kontrol tablosu, neyin doğrulandığını ve neyin hâlâ dikkatinizi gerektirdiğini belirtmelidir.

Beceri eksikse, yolunu ve frontmatter kısmını inceleyin.

İnceleyici eksikse, `name` ve `description` alanlarını kontrol edin, ardından `/agents` üzerinden kullanılabilirliğini doğrulayın.

Çözülmemiş iddialar için sağlanan kaynağı ve inceleyicinin talep ettiği kanıtı inceleyin.

Taslağı kabul etmeden önce boşluğu giderin veya görünür şekilde işaretli bırakın.

Sonraki oturumun neleri kurtarabileceğini kontrol edin

Anlamlı bir aşamadan sonra `progress.md` dosyasını güncelleyin.

Mevcut dosyaları, tamamlanan kontrolleri, açık soruları ve bir sonraki adımı kaydedin.

Kök dizindeki CLAUDE.md, sıkıştırma (compaction) sonrasında yeniden okunur.

Kapsamlı talimatlar, ilgili dosyalara erişildiğinde yeniden yüklenir. Sıkıştırma ve hafıza

İlerleme notu için bu kompakt yapıyı kullanın:

1Görev: [mevcut konu]
2Çıktılar: [taslak ve inceleme yolları]
3Tamamlanan: [biten aşamalar ve kontroller]
4Kararlar: [onaylanan seçimler ve kaynakları]
5Açık sorunlar: [eksik kanıtlar veya engelleyiciler]
6Sonraki adım: [tek bir somut devam adımı]

Aynı çalışma alanında yeni bir oturum başlatın ve şunu yapıştırın:

1progress.md dosyasını oku ve atıfta bulunulan taslağı ile kontrolleri incele.
2Kaydedilen sonraki adımdan devam et ve ilerleme notunu güncelle.

Oturum kaydedilen işi tanımalı ve devir noktasından devam etmelidir. Baştan başlarsa notu inceleyin ve eksik kararı veya dosya yolunu ekleyin.

Anthropic'in uzun süre çalışan ajan rehberi, oturumlar arası çalışmayı desteklemek için kalıcı ilerleme kayıtlarını kullanır.

Görev değiştikçe bu kayıtları güncel tutun ki devam eden bir çalıştırma güncel bilgilere sahip olsun. Uzun süreli harness'lar

Kurulumu kabul edilen iş üzerinde ölçün

Bildirilen kullanımı incelemek için `/usage`, çalışma bağlamını neyin meşgul ettiğini görmek için `/context` kullanın. Devredilen incelemeleri ve yeniden denemeleri görevin toplamına dahil edin. Kullanım rehberi

İnceleme sürenizi ve sonucun gerektirdiği düzeltmeleri kaydedin.

Önemli bir onarım gerektiren bir çıktı, tüm çalıştırmanın değerini değiştirir.

Bir yapılandırma değişikliğini test ederken görevi ve kabul kriterlerini tutarlı tutun.

Tek bir bileşeni ayarlayın, görevi tekrarlayın ve hem kaydedilen sonucu hem de kanıtlarını inceleyin.

Anthropic'in erken test kullanıcıları raporunda ima edilen %60 token azalması, o model deneyine özgüdür.

Kendi harness'ınızdan elde ettiğiniz tasarrufu, tamamlanan görevlerin ölçümleriyle belirleyin. Opus 5.5 duyurusu

İlk kabul edilen çalıştırmadan sonra, beceriyi yeni bir konu ve kaynak setiyle yeniden kullanın. İnceleyiciyi, çıktı yollarını ve tamamlanma formatını tutarlı tutun; ardından tekrarlayan bir düzeltme eksik bir adımı ortaya çıkardığında prosedürü güncelleyin.

Kaybetmemek için bunu kaydedin

Daha fazla alpha için @beamnxw'yi takip edin :)

=> substack hesabım

=> telegram kanalım