tartisma-ortami

🗣️ Tartışma Ortamı

Claude Code için çok modelli tartışma becerisi (skill)

Bir kararı tek modele sormak yerine farklı modellerden ajanları birbirine itiraz ettir, tartışmayı bir Markdown dosyasından canlı izle, sonunda uzlaşılan kararı ve açık kalan maddeleri al.

Ne işe yarar · Nasıl çalışır · Kurulum · Kullanım · Özelleştirme · Sorun giderme · English

---

💡 Ne işe yarar

Tek bir modele "sence hangisi?" diye sorduğunda genelde makul görünen ilk cevaba yaslanır ve kendi fikrine itiraz etmez. Tartışma Ortamı aynı soruyu farklı modellerden iki ajana (varsayılan: Claude Fable ve Claude Sonnet) verir. Ajanlar:

• birbirine doğrudan yazar (aracı yok, tur beklemek yok),
• her karar maddesinde UZLAŞIYORUM ya da UZLAŞMIYORUM: <neden> diye tutum alır,
• iddialarına kaynak gösterir, kaynaksız rakamı "tahmin" diye işaretler,
• mesaj sınırı dolunca ya da uzlaşınca SON POZİSYON bildirip durur.

Ana Claude oturumu (lider) tartışmayı kurar, kendisi de taraf olarak katılır ve sonunda bir ## Karar bölümü yazar. Sen de tartışmanın ortasında ortak dosyaya not düşerek araya girebilirsin.

İyi gittiği konular: ürün kararları, fiyatlandırma, mimari seçimler, araç/teknoloji karşılaştırmaları, bir planın zayıf noktalarını bulmak, "şu metin ikna edici mi?" gibi değerlendirmeler.

Gereksiz olduğu konular: tek doğru cevabı olan sorular, hızlı bilgi soruları, kod yazma işinin kendisi (bunun için tek oturum ya da alt ajanlar daha ucuz ve hızlı).

---

🔁 Nasıl çalışır

flowchart LR
    U([Sen]) -->|konu + karar maddeleri| L[Lider<br/>ana Claude oturumu]
    L -->|brief| F[tartisma_fable]
    L -->|brief| S[tartisma_sonnet]
    F <-->|SendMessage| S
    F <-->|SendMessage| L
    S <-->|SendMessage| L
    F -->|her mesaj| D[(tartismalar/…md)]
    S -->|her mesaj| D
    L -->|her mesaj| D
    U -.->|canlı izler, not yazar| D
    L -->|Karar + açık maddeler| U

1. Hazırlık: Lider konuyu 3-7 numaralı karar maddesine böler ve yalnız doğrulanmış gerçeklerden bir brief hazırlar. Ajanlar senin sohbet geçmişini görmez; bilmeleri gereken her şey brief'tedir.
2. Ortak dosya: tartismalar/<tarih-saat>-<konu>.md oluşturulur: karar maddeleri, brief ve boş bir "Yazışma" bölümü.
3. Ajanlar açılır: İki ajan paralel başlar. Lider de açılış pozisyonunu ikisine gönderir.
4. Tartışma: Ajanlar birbirinin argümanına doğrudan cevap verir; her mesaj aynı anda dosyanın sonuna eklenir.
5. Kapanış: Herkes uzlaşınca ya da mesaj sınırı dolunca lider ## Karar bölümünü yazar: uzlaşılanlar, açık kalanlar (iki tarafın gerekçesiyle) ve kaynaklar.
6. Sonuç: Sohbette kısa özet alırsın; açık maddelerde son söz senindir.

Örnek bir çıktı için: ornek/2026-10-12-2130-blog-platformu.md

---

📦 Kurulum

Gereksinimler

• Güncel bir Claude Code sürümü (terminal, VS Code ya da JetBrains eklentisi).
• Kullandığın modellere erişimi olan bir Claude hesabı ya da API anahtarı. Hesabında Fable yoksa başlatırken "Fable yerine Opus kullan" demen yeterli.
• Ajan takımları özelliğinin açık olması (aşağıda 2. adım). Bu özellik şu an deneysel.
• Etkileşimli oturum. claude -p (headless) modunda ajan takımı kurulmaz.

1. Beceriyi kopyala

git clone https://github.com/batoner/tartisma-ortami.git
New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude\skills" | Out-Null
Copy-Item -Recurse -Force .\tartisma-ortami\tartisma-ortami "$env:USERPROFILE\.claude\skills\"

git clone https://github.com/batoner/tartisma-ortami.git
mkdir -p ~/.claude/skills
cp -r tartisma-ortami/tartisma-ortami ~/.claude/skills/

Klasörü kullanıcı dizini yerine projenin içine koy: <proje>/.claude/skills/tartisma-ortami/SKILL.md. O zaman beceri yalnız o projede açılan oturumlarda görünür.

Sonuçta şu dosya bulunmalı:

~/.claude/skills/tartisma-ortami/SKILL.md

2. Ajan takımlarını aç

~/.claude/settings.json dosyasına (Windows'ta %USERPROFILE%\.claude\settings.json) şu env girdisini ekle. Dosyada başka ayarlar varsa yalnız env bloğunu birleştir:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

[!NOTE] Bu ayar açıkken Claude'un adını verdiği her alt ajan takım üyesi olarak başlar. Bu genelde sorun çıkarmaz; istemezsen tartışma bitince değeri "0" yapabilirsin. Ayrıntı: Claude Code belgeleri: Agent teams.

3. Dene

Yeni bir Claude Code oturumu aç ve /tartisma yazmaya başla. Otomatik tamamlamada /tartisma-ortami görünüyorsa kurulum tamamdır.

---

🚀 Kullanım

Başlatma

En kısa yol, komutu konuyla birlikte yazmak:

/tartisma-ortami Ekibimiz için CI: GitHub Actions mı, GitLab CI mı?

Doğal dil de olur. Beceri "tartıştır", "tartışma ortamı", "modeller tartışsın" gibi ifadelerle kendiliğinden devreye girer:

Yeni uygulamada abonelik mi tek seferlik ödeme mi, ajanlara tartıştır.
3 ajan olsun, biri şeytanın avukatı.

/tartisma-ortami Mobil uygulamanın ilk açılış ekranı: kaç soru soralım,
hangi cevap neyi değiştirsin? Kişi başı 4 mesaj, Fable yerine Opus kullan.

İyi bir başlangıç için

Yap	Kaçın
Konuyu karar maddelerine böl ya da lidere böldür ("3-5 maddeye ayır")	"Ne düşünüyorsunuz?" gibi ucu açık sorular
Elindeki gerçekleri ver: bütçe, kısıtlar, daha önce verdiğin kararlar, ilgili dosyaların yolu	Ajanların bilmediği bir bağlama güvenmek (sohbet geçmişini görmezler)
Önemliyse "rakamlara kaynak göstersinler" de	Sonucu baştan söyleyip onay beklemek

Canlı izleme

• Dosyadan: Lider dosyanın yolunu söyler. Dosyayı VS Code gibi değişince kendini yenileyen bir editörde aç ya da terminalde takip et:

  tail -f tartismalar/2026-10-12-2130-blog-platformu.md          # macOS / Linux
  

  Get-Content -Wait -Encoding utf8 .\tartismalar\2026-10-12-2130-blog-platformu.md   # Windows
  

• Ajan panelinden: Claude Code'da istem satırının altındaki panelde ↑/↓ ile bir ajan seç, Enter ile onun oturumunu gör ve ona doğrudan yaz. Seçili ajanı x ile durdurabilirsin.

Araya girme

Üç yolun var:

1. Dosyaya not yaz. Ortak dosyanın sonuna şöyle bir blok ekle; herkes her mesajdan önce dosyanın sonunu okur ve önce senin notuna cevap verir:

   ### Kullanıcı · 21:45
   Bütçe aylık 0 değil, 5 dolara kadar çıkabilir. 1. maddeyi buna göre yeniden değerlendirin.
   

2. Lidere sohbetten söyle. Lider yeni bilgiyi iki ajana birden iletir ve dosyaya yazar.
3. Tek bir ajana yaz. Ajan panelinden seçip doğrudan mesaj gönder.

Sonuç

Tartışma bitince dosyanın sonunda şöyle bir bölüm olur:

## Karar (12.10.2026 21:40, üç taraf uzlaştı; açık madde yok)
1. **Platform:** Astro + GitHub Pages, hazır tema; ...
2. ...
- Tahmin olanlar: ...

Uzlaşılamayan maddelerde iki tarafın gerekçesi yan yana yazılır; son kararı sen verirsin. Lider, kararın gerektirdiği dışa dönük işleri (yayın, mail, ödeme, hesap ayarı) senin açık onayın olmadan yapmaz.

---

⚙️ Özelleştirme

Hepsini başlatırken sohbette söylemen yeterli; dosyayı düzenlemen gerekmez.

Ne	Varsayılan	Nasıl değiştirilir
Katılımcılar	tartisma_fable (Fable) + tartisma_sonnet (Sonnet) + lider	"Opus ve Haiku tartışsın", "3 ajan olsun"
Roller	Herkes kendi görüşünü savunur	"Biri şeytanın avukatı, biri kullanıcı gözüyle baksın"
Mesaj sınırı	Ajan başına 6 mesaj, mesaj başına en fazla 200 kelime	"Kişi başı 3 mesaj", "kısa tutun, 100 kelime"
Dosya konumu	Çalışma dizininde tartismalar/	"Dosyayı ~/notlar/tartismalar/ altına koy" ya da CLAUDE.md'ye bir satır: Tartışma klasörü: ~/notlar/tartismalar
Web araştırması	Serbest, kaynak göstererek	"İnternete bakmasınlar, yalnız brief'le tartışsınlar"

Kalıcı bir değişiklik istersen ~/.claude/skills/tartisma-ortami/SKILL.md dosyasındaki varsayılanları düzenleyebilirsin.

---

💸 Maliyet

Her ajan ayrı bir Claude oturumudur ve kendi bağlamını taşır; bu yüzden bir tartışma, aynı soruyu tek oturuma sormaktan belirgin şekilde daha fazla token harcar. Fable ve Opus, Sonnet ve Haiku'dan pahalıdır. Lider başlamadan önce boyutu tek satırla söyler (kaç ajan, kişi başı kaç mesaj).

Ucuz tutmak için:

• mesaj sınırını düşür (3-4 mesaj çoğu konuya yeter),
• pahalı model yerine Sonnet + Haiku kullan,
• karar maddelerini az ve net tut.

---

🛠 Sorun giderme

Ajan takımları açık değildir. settings.json içinde CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS değerinin "1" olduğunu kontrol et ve yeni bir oturum aç. claude -p ile çalışıyorsan etkileşimli oturuma geç.

PowerShell'de çift tırnak içindeki ters tırnak (`) kaçış karakteri sayılır; Markdown'daki `kod` ifadeleri bozulur. Beceri bu yüzden ajanlara kaçış karakteri yorumlamayan yollar söyler (Bash'te tırnaklı <<'EOF', PowerShell'de tek tırnaklı @' … '@). Eski bir kopyayı kullanıyorsan güncelle.

Ajanların izin istekleri lider oturumunda görünür. En sık soru, ortak dosyaya ekleme yapan komut içindir. İstersen tartışma öncesinde bu komutlara izin ver ya da soruları tek tek onayla. Ajanları --dangerously-skip-permissions ile çalıştırma.

Hesabında Fable yoksa başlatırken "Fable yerine Opus kullan" diye belirt. Lider açılışta modele erişemezse bunu söyler ve başka bir modelle yeniden dener.

Ajan takımları şimdilik oturum devamında geri gelmiyor. Lidere "aynı dosyadan devam et, ajanları yeniden aç" demen yeterli; dosyada tüm yazışma duruyor.

Ajan panelinden seçip doğrudan yaz ("2. maddeye Sonnet'in son argümanıyla cevap ver") ya da lidere söyle. Lider, aynı argüman ikinci kez dönünce maddeyi "açık" diye kapatacak şekilde ayarlıdır.

---

🔒 Güvenlik notları

• Ajanlara yalnız okuma, düşünme ve web araması yapmaları söylenir. Dosya değiştirme (ortak dosyaya ekleme dışında), tarayıcı, hesap ve mail işi yapmazlar. Bu bir talimattır, teknik bir kısıt değildir. Asıl koruma Claude Code'un izin sistemidir: ajanlar liderin izin modunu devralır.
• Bir ajanın mesajı senin onayın sayılmaz. Claude Code ajan mesajlarını "başka bir Claude oturumundan" olarak işaretler; lider de beceri gereği bunlara dayanarak dışa dönük bir iş yapmaz.
• Brief'e koyduğun her şey ajanlara gider. Paylaşmak istemediğin kişisel ya da gizli bilgiyi brief'e koydurma.

---

📁 Dosya yapısı

tartisma-ortami/
├── README.md                      ← bu sayfa
├── LICENSE
├── tartisma-ortami/
│   └── SKILL.md                   ← becerinin kendisi (~/.claude/skills/ altına kopyalanır)
└── ornek/
    └── 2026-10-12-2130-blog-platformu.md   ← örnek bir tartışma çıktısı

Güncellemek için: repo klasöründe git pull, sonra 1. adımdaki kopyalama komutunu yeniden çalıştır.

---

🌍 English

Tartışma Ortamı ("debate room") is a Claude Code skill that runs a multi-model debate. It spawns two agents on different models (Fable and Sonnet by default) using Claude Code's experimental agent teams. The agents message each other directly, mark each decision item AGREE / DISAGREE: <reason>, cite sources, and append every message to a shared Markdown file you can watch live and write into. The lead session takes part as a third voice and closes with a ## Karar (decision) section listing agreed items and open items with both sides' reasoning.

Install: copy tartisma-ortami/ to ~/.claude/skills/, set "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" under env in ~/.claude/settings.json, then run /tartisma-ortami <topic>. The skill's instructions are in Turkish; it works for topics in any language.

---

MIT · Geri bildirim ve öneriler için bir issue açabilirsin.