Doküman Co-Authoring Workflow

Bu beceri, kullanıcıları işbirlikçi belge oluşturma konusunda rehberlik etmek için yapılandırılmış bir workflow sağlar. Aktif bir rehber olarak hareket ederek, kullanıcıları üç aşama boyunca yönlendirin: Context Gathering (Bağlam Toplama), Refinement & Structure (Değerlendirme ve Yapılandırma) ve Reader Testing (Okuyucu Testi).

Bu Workflow Ne Zaman Sunulacağı

Tetikleyici koşullar:

• Kullanıcı belge yazımından bahseder: "bir doc yaz", "draft bir proposal hazırla", "bir spec oluştur", "yazıp geç"
• Kullanıcı belirli belge türlerinden bahseder: "PRD", "design doc", "decision doc", "RFC"
• Kullanıcı önemli bir yazma görevine başlamakta gibi görünüyor

İlk teklif: Kullanıcıya belgeyi co-author yapmak için yapılandırılmış bir workflow sunun. Üç aşamayı açıklayın:

1. Context Gathering (Bağlam Toplama): Kullanıcı tüm ilgili bağlamı sağlar ve Claude açıklayıcı sorular sorar
2. Refinement & Structure (Değerlendirme ve Yapılandırma): Her bölümü beyin fırtınası ve düzenleme yoluyla yinelemeli olarak oluşturun
3. Reader Testing (Okuyucu Testi): Belgeyi yeni bir Claude örneğiyle test edin (bağlamı olmadan) diğerleri okumadan önce körlük noktalarını yakalaması için

Bu yaklaşımın, belgeyi diğerleri okuduğunda iyi çalışmasını sağlamaya yardımcı olduğunu açıklayın (Claude'a yapıştırdıklarında da dahil). Workflow'u denemek isteyip istemediğini yoksa freeform olarak çalışmayı tercih edip etmediğini sorun.

Kullanıcı reddederse, freeform olarak çalışın. Kullanıcı kabul ederse, Stage 1'e geçin.

Stage 1: Context Gathering (Bağlam Toplama)

Hedef: Kullanıcının bildiği ile Claude'un bildiği arasındaki boşluğu kapatarak, daha sonra akıllı rehberlik sağlamayı etkinleştirin.

İlk Sorular

Belge hakkında meta-context için kullanıcıdan sorular sorarak başlayın:

1. Bu belge ne türü? (örn. teknik spec, decision doc, proposal)
2. Birincil hedef kitle kimdir?
3. Biri bunu okuduğunda istenen etki nedir?
4. Takip edilecek bir template veya belirli bir format var mı?
5. Bilinmesi gereken başka kısıtlamalar veya bağlam var mı?

Onlara kısa cevaplar verebileceklerini veya bilgiyi uygun olan şekilde dumplayabileceklerini bildirin.

Kullanıcı bir template sağlarsa veya doc türünden bahsederse:

• Paylaşmak için bir template belgesi olup olmadığını sorun
• Paylaşılan belgede bir link sağlarlarsa, fetch etmek için uygun integration kullanın
• Dosya sağlarlarsa, okuyun

Kullanıcı mevcut paylaşılan belgeyi düzenlemekten bahsederse:

• Mevcut durumu okumak için uygun integration kullanın
• Alt-text olmayan görselleri kontrol edin
• Alt-text olmayan görseller varsa, diğerleri belgeyi anlamak için Claude'u kullandığında Claude'un onları göremeyeceğini açıklayın. Alt-text oluşturmasını isteyip istemediğini sorun. Evet ise, her görsel için açıklayıcı alt-text oluşturmak üzere sohbet içine yapıştırmasını isteyin.

Info Dumping

İlk sorular yanıtlandıktan sonra, kullanıcıyı tüm bağlamını dumplaması için teşvik edin. Aşağıdaki gibi bilgileri isteyin:

• Proje/sorun hakkında arka plan
• İlgili takım tartışmaları veya paylaşılan belgeler
• Alternatif çözümlerin neden kullanılmadığı
• Organizasyon bağlamı (takım dinamikleri, geçmiş olaylar, politika)
• Zaman baskısı veya kısıtlamalar
• Teknik mimarisi veya bağımlılıkları
• Paydaş endişeleri

Onlara organize etme konusunda endişelenmemeleri - sadece hepsini çıkarması gerektiğini tavsiye edin. Bağlam sağlamak için birden fazla yol sunun:

• Info dump stream-of-consciousness
• Takım kanallarına veya dizilere işaret edin
• Paylaşılan belgeler bağlantı

Integrations mevcut ise (örn. Slack, Teams, Google Drive, SharePoint veya diğer MCP servers), bunların bağlamı doğrudan çekmek için kullanılabileceğinden bahsedin.

Integration algılanmadı ve Claude.ai veya Claude app ise: Onlara Claude ayarlarında konektörleri etkinleştirerek mesajlaşma uygulamaları ve belge depolamadan doğrudan bağlam çekmelerine izin vereceğini tavsiye edin.

Açıklayıcı soruların ilk dump sonrası sorulacağını bildirin.

Bağlam toplama sırasında:

• Kullanıcı takım kanallarından veya paylaşılan belgelerden bahsederse:

  • Integration mevcut ise: İçeriğin şimdi okunacağını bildirin, ardından uygun integration kullanın
  • Integration yoksa: Erişim eksikliğini açıklayın. Claude ayarlarında konektörleri etkinleştirmelerini tavsiye edin veya ilgili içeriği doğrudan yapıştırmalarını isteyin.

• Kullanıcı bilinmeyen entities/projelerden bahsederse:

  • Bağlı araçların daha fazla öğrenmek için aranması gerekip gerekmediğini sorun
  • Aramadan önce kullanıcı onayını bekleyin

• Kullanıcı bağlam sağlarken, nelerin öğrenildiğini ve neyin hala belirsiz olduğunu takip edin

Açıklayıcı sorular sorma:

Kullanıcı ilk dump yaptığını işaret ettiğinde (veya önemli bağlam sağlandıktan sonra), anlayışı sağlamak için açıklayıcı sorular sorun:

Bağlamdaki boşluklara dayalı 5-10 numaralı soru oluşturun.

Onlara kısa cevaplar verebileceklerini (örn. "1: evet, 2: #channel'a bak, 3: geriye uyumluluk nedeniyle hayır"), daha fazla doc'a bağlantı, kanallara işaret veya sadece info-dumping devam edebileceklerini bildirin. Ne onlar için en verimli ise.

Çıkış koşulu: Sorular anlayışı gösterdiğinde yeterli bağlam toplanır - uç durumlar ve trade-off'lar temel kavramların açıklanmasına gerek kalmadan sorulabilir.

Geçiş: Bu aşamada sağlamak istedikleri daha fazla bağlam olup olmadığını veya belgeyi taslaklaştırmaya geçme zamanı gelip gelmediğini sorun.

Kullanıcı daha fazla eklemek isterse, izin verin. Hazır olunca, Stage 2'ye geçin.

Stage 2: Refinement & Structure (Değerlendirme ve Yapılandırma)

Hedef: Belgeyi beyin fırtınası, kurala uygun seçim ve yinelemeli iyileştirme yoluyla bölüm bölüm oluşturun.

Kullanıcıya talimatlar: Belgenin bölüm bölüm oluşturulacağını açıklayın. Her bölüm için:

1. Nelerin dahil edileceği hakkında açıklayıcı sorular sorulur
2. 5-20 seçenek beyin fırtınası yapılır
3. Kullanıcı neyi tutacağı/kaldıracağı/birleştireceğini gösterir
4. Bölüm taslaklanır
5. Cerrah gibi düzeltmeler yoluyla iyileştirilir

En fazla bilinmeyeni olan bölümle başlayın (genellikle çekirdek karar/proposal), ardından geriye kalanların içinde çalışın.

Bölüm sıralaması:

Belge yapısı açık ise: Hangi bölümle başlamak istediğini sorun.

En fazla bilinmeyeni olan bölümle başlamayı önerin. Decision doc'lar için, bu genellikle çekirdek proposal'dır. Spec'ler için, tipik olarak teknik yaklaşımdır. Özet bölümleri en son kalmak için iyidir.

Kullanıcı hangi bölümlere ihtiyacı olduğunu bilmiyorsa: Belge türü ve template'e dayanarak, doc türü için uygun 3-5 bölüm önerin.

Bu yapının işe yarıyıp yaramadığını veya ayarlamak isteyip istemediğini sorun.

Yapı anlaştıktan sonra:

Tüm bölümler için placeholder metin içeren ilk belge yapısı oluşturun.

Artifact'lara erişim varsa: Artifact oluşturmak için create_file kullanın. Bu hem Claude'a hem de kullanıcıya bir iskelet verir.

Tüm bölümler için placeholder metin içeren ilk yapının "[To be written]" veya "[Content here]" gibi oluşturulacağını bildirin.

Tüm bölüm başlıkları ve kısa placeholder metin ile artifact oluşturun.

İskelet bağlantısını sağlayın ve her bölümü doldurma zamanının geldiğini gösterin.

Artifact'lara erişim yoksa: Çalışma dizininde markdown dosyası oluşturun. Uygun olarak adlandırın (örn. decision-doc.md, technical-spec.md).

Tüm bölümler için placeholder metin içeren ilk yapının oluşturulacağını bildirin.

Tüm bölüm başlıkları ve placeholder metin ile dosya oluşturun.

Dosya adının oluşturulduğunu doğrulayın ve her bölümü doldurma zamanının geldiğini gösterin.

Her bölüm için:

Adım 1: Açıklayıcı Sorular

[BÖLÜM ADI] bölümünde çalışmaya başlanacağını ilan edin. Nelerin dahil edileceği hakkında 5-10 açıklayıcı soru sorun:

Bağlama ve bölüm amacına dayalı 5-10 spesifik soru oluşturun.

Kısa cevaplar verebileceklerini veya yalnızca neyin kapsanması gerektiğini gösterebileceklerini bildirin.

Adım 2: Beyin Fırtınası

[BÖLÜM ADI] bölümü için, bölümün karmaşıklığına bağlı olarak [5-20] şeyin dahil edilebileceğini beyin fırtınası yapın. Aşağıdakileri arayın:

• Unutulmuş olabilecek paylaşılan bağlam
• Henüz bahsedilmemiş açılar veya düşünceler

Bölüm karmaşıklığına dayalı 5-20 numaralı seçenek oluşturun. Sonunda, daha fazla seçenek isterlerse daha fazla beyin fırtınası yapmayı önerin.

Adım 3: Kurala Uygun Seçim

Hangi noktaların tutulması, kaldırılması veya birleştirilmesi gerektiğini sorun. Sonraki bölümler için öncelikleri öğrenmeye yardımcı olmak üzere kısa gerekçeler isteyin.

Örnekler sağlayın:

• "Keep 1,4,7,9"
• "Remove 3 (duplicates 1)"
• "Remove 6 (audience already knows this)"
• "Combine 11 and 12"

Kullanıcı serbest biçim geri bildirim verirse (örn. "looks good" veya "I like most of it but...") numaralı seçimler yerine, tercihlerini çıkarın ve devam edin. Neyi tutmak/kaldırmak/değiştirmek istediğini ayrıştırın ve uygulayın.

Adım 4: Boşluk Kontrolü

Seçtiklerine dayalı olarak, [BÖLÜM ADI] bölümü için eksik olan önemli bir şey olup olmadığını sorun.

Adım 5: Taslaklandırma

Bu bölüm için placeholder metni seçtikleri şeye dayalı taslaklanmış içerikle değiştirmek için str_replace kullanın.

[BÖLÜM ADI] bölümünün seçtikleri şeye dayalı taslaklanacağını ilan edin.

Artifact'ları kullanıyorsanız: Taslaklandıktan sonra artifact bağlantısını sağlayın.

Bunu okumalarını ve neyi değiştirmesi gerektiğini belirtmelerini isteyin. Spesifik olmak sonraki bölümler için öğrenmeye yardımcı olduğunu not edin.

Dosya kullanıyorsanız (artifact yok): Taslaklandıktan sonra tamamlamayı doğrulayın.

[BÖLÜM ADI] bölümünün [dosya adı] içinde taslaklandığını bildirin. Bunu okumalarını ve neyi değiştirmesi gerektiğini belirtmelerini isteyin. Spesifik olmak sonraki bölümler için öğrenmeye yardımcı olduğunu not edin.

İlk bölümü taslaklandırırken dahil edilecek kullanıcı talimatı: Not sağlayın: Belgeyi doğrudan düzenleme yerine, neyi değiştirmesi gerektiğini belirtmelerini isteyin. Bu gelecek bölümler için stillerinin öğrenilmesine yardımcı olur. Örneğin: "Remove the X bullet - already covered by Y" veya "Make the third paragraph more concise".

Adım 6: Yinelemeli İyileştirme

Kullanıcı geri bildirim sağlarken:

• Düzeltmeleri yapmak için str_replace kullanın (hiçbir zaman tüm belgeyi yeniden yazdırmayın)
• Artifact'ları kullanıyorsanız: Her düzeltmeden sonra artifact bağlantısı sağlayın
• Dosya kullanıyorsanız: Sadece düzeltmelerin tamamlandığını doğrulayın
• Kullanıcı belgeyi doğrudan düzenlerse ve okumasını isterse: Yaptıkları değişiklikleri zihinsel olarak not edin ve gelecek bölümler için başında bulundurun (bu tercihlerini gösterir)

Seçili bölüm tatmin edene kadar yineleyin.

Kalite Kontrolü

3 ardışık yinelemeden sonra önemli değişiklik yoksa, önemli bilgi kaybedilmeden neyin kaldırılabileceğini sorun.

Bölüm tamamlandığında, [BÖLÜM ADI]'nin tamamlandığını doğrulayın. Sonraki bölüme geçmeye hazır olup olmadığını sorun.

Tüm bölümler için tekrarlayın.

Tamamlanmaya Yakın

Tamamlanmaya yaklaşırken (%80+ bölüm yapıldığında), tüm belgeyi yeniden okuma ve şunları kontrol etme niyetini ilan edin:

• Bölümler arasında akış ve tutarlılık
• Fazlalık veya çelişkiler
• "Slop" veya genel doldurma gibi görünen her şey
• Her cümlenin ağırlık taşıyıp taşımadığı

Tüm belgeyi okuyun ve geri bildirim sağlayın.

Tüm bölümler taslaklanıp iyileştirildiğinde: Tüm bölümlerin taslaklandığını ilan edin. Tüm belgeyi bir kez daha inceleme niyetini belirtin.

Genel uyum, akış, tamlık açısından gözden geçirin.

Herhangi bir son tavsiye sağlayın.

Reader Testing'e geçmeye hazır olup olmadığını veya başka bir şeyi iyileştirmek isteyip istemediğini sorun.

Stage 3: Reader Testing (Okuyucu Testi)

Hedef: Belgeyi yeni bir Claude örneğiyle (bağlam olmadan) test ederek okuyucular için çalıştığını doğrulayın.

Kullanıcıya talimatlar: Testi açıklayın - bu belgenin okuyucular için gerçekten çalışıp çalışmadığını görmek için yapılır. Bu körlük noktalarını yakalar - yazarlara mantıklı gelen ama diğerlerini kafa karıştırabilen şeyler.

Test Yaklaşımı

Alt-agent'lara erişim varsa (örn. Claude Code'da):

Kullanıcı katılımı olmadan testi doğrudan gerçekleştirin.

Adım 1: Okuyucu Soruları Tahmin Edin

Okuyucuların bu belgeyi keşfetmeye çalışırken ne sorabileceğini tahmin etme niyetini ilan edin.

Okuyucuların gerçekçi olarak sorabileceği 5-10 soru oluşturun.

Adım 2: Alt-Agent ile Test Edin

Bu soruların yeni bir Claude örneğiyle test edileceğini ilan edin (bu konuşmadan bağlam olmadan).

Her soru için, sadece belge içeriği ve soruyla bir alt-agent çağırın.

Reader Claude'un her soru için doğru/yanlış yaptığını özetleyin.

Adım 3: Ek Kontroller Çalıştırın

Ek kontroller yapılacağını ilan edin.

Belirsizlik, yanlış varsayımlar, çelişkiler açısından kontrol etmek için alt-agent çağırın.

Bulunan herhangi bir sorunu özetleyin.

Adım 4: Rapor ve Düzelt

Sorun bulunursa: Reader Claude'un belirli sorunlarla mücadele ettiğini rapor edin.

Spesifik sorunları listeleyin.

Bu boşlukları düzeltme niyetini belirtin.

Sorunlu bölümler için iyileştirmeye geri döngüyü kapatın.

---

Alt-agent'lara erişim yoksa (örn. claude.ai web arayüzü):

Kullanıcı testi manuel olarak yapmalıdır.

Adım 1: Okuyucu Soruları Tahmin Edin

Bu belgeyi keşfetmeye çalışırken insanların ne sorabileceğini sorun. Claude.ai'ye ne yazarlar?

Okuyucuların gerçekçi olarak sorabileceği 5-10 soru oluşturun.

Adım 2: Test Kurulumu

Test talimatları sağlayın:

1. Yeni bir Claude konuşması açın: https://claude.ai
2. Belge içeriğini yapıştırın veya paylaşın (paylaşılan doc platformunda konektörleri etkinleştirilmiş ise, bağlantıyı sağlayın)
3. Reader Claude'a oluşturulan soruları sorun

Her soru için, Reader Claude'u şunları sağlamaya talimat edin:

• Cevap
• Bir şey belirsiz veya açık değil miydi
• Belgenin zaten bilinen ne bilgi/bağlam varsaydığı

Reader Claude'un doğru cevaplar verip vermediğini veya bir şeyi yanlış anlamlandırıp anlamlandırmadığını kontrol edin.

Adım 3: Ek Kontroller

Reader Claude'a ayrıca sorun:

• "What in this doc might be ambiguous or unclear to readers?"
• "What knowledge or context does this doc assume readers already have?"
• "Are there any internal contradictions or inconsistencies?"

Adım 4: Sonuçlara Dayalı Yinele

Reader Claude'un yanlış yaptığı veya mücadele ettiği şeyi sorun. Bu boşlukları düzeltme niyetini belirtin.

Sorunlu bölümler için iyileştirmeye geri döngüyü kapatın.

---

Çıkış Koşulu (Her İki Yaklaşım)

Reader Claude soruları tutarlı olarak doğru cevaplayıp yeni boşluk veya belirsizlik ortaya çıkarmadığında, belge hazırdır.

Son İnceleme

Reader Testing geçtiğinde: Belgenin Reader Claude testini geçtiğini ilan edin. Tamamlanmadan önce:

1. Kendi kendilerini son bir kez okumalarını tavsiye edin - bu belgeyi sahiplenir ve kalitesinden sorumludur
2. Herhangi bir gerçek, bağlantı veya teknik detayı iki kez kontrol etmelerini tavsiye edin
3. İstenen etkiyi başarıp başarmadığını doğrulamalarını isteyin

Bir kez daha inceleme isteyip istemediğini veya işin bittiğini sorun.

Kullanıcı son incelemesi isterse, bunu sağlayın. Aksi takdirde: Belge tamamlamayı ilan edin. Birkaç son tavsiye sağlayın:

• Bu konuşmayı bir ek olarak bağlamayı düşünün, böylece okuyucular belgenin nasıl geliştirildiğini görebilir
• Derinlik sağlamak için ek metin kullanın, ana belgeyi şişirmeden
• Gerçek okuyuculardan geri bildirim alındıkça belgeyi güncelleyin

Etkili Rehberlik İçin İpuçları

Ton:

• Doğrudan ve prosedürel olun
• Kullanıcı davranışını etkilediğinde gerekçeyi kısaca açıklayın
• Yaklaşımı "satmaya" çalışmayın - sadece çalıştırın

Sapmalarla İlgilenmek:

• Kullanıcı bir aşamayı atlamak isterse: Bunu atlamak ve freeform olarak yazmak isteyip istemediğini sorun
• Kullanıcı hayal kırıklığına uğramışsa görünüyorsa: Bunun bekleneninden daha uzun sürdüğünü bildirin. Daha hızlı hareket etme yollarını öneriniz
• Her zaman kullanıcıya süreci ayarlama yeteneği verin

Bağlam Yönetimi:

• Boyunca, bahsedilen bir şey hakkında bağlam eksikse, proaktif olarak sorun
• Boşlukları birikmeye izin vermeyin - bunları ortaya çıktıkça ele alın

Artifact Yönetimi:

• Tam bölümleri taslaklandırmak için create_file kullanın
• Tüm düzeltmeler için str_replace kullanın
• Her değişiklikten sonra artifact bağlantısı sağlayın
• Hiçbir zaman artifact'ları beyin fırtınası listeleri için kullanmayın - bu sadece konuşma

Hız Üzerinde Kalite:

• Aşamalar boyunca acele etmeyin
• Her yineleme anlamlı iyileştirmeler yapmalıdır
• Hedef, okuyucular için gerçekten çalışan bir belgedir