cc-viewer 1.6.182 → 1.6.183

package/concepts/tr/Tool-TeamCreate.md

@@ -1,38 +1,53 @@
 # TeamCreate
 
-## Tanım
+Paylaşılan görev listesi ve ajanlar arası mesajlaşma kanalı ile yeni bir iş birliği ekibi kurar. Bir ekip, çoklu-ajan çalışması için koordinasyon temel öğesidir — ana oturum lider olarak hareket eder ve `Agent` aracı aracılığıyla isimlendirilmiş ekip arkadaşları oluşturur.
 
-Bir proje üzerinde çalışan birden fazla agent'ı koordine etmek için yeni bir takım oluşturur. Takımlar, paylaşılan bir görev listesi ve agent'lar arası mesajlaşma aracılığıyla paralel görev yürütmeyi mümkün kılar.
+## Ne Zaman Kullanılır
+
+- Kullanıcı açıkça bir ekip, sürü, tayfa veya çoklu-ajan iş birliği ister.
+- Bir projenin, özelleşmiş uzmanlardan (örneğin frontend, backend, testler, dokümanlar) yararlanan birkaç açıkça bağımsız iş akışı vardır.
+- İlerleme kaydettikçe birden fazla ajanın güncellediği kalıcı bir paylaşılan görev listesine ihtiyacınız var.
+- Tek seferlik alt ajan çağrıları yerine `SendMessage` aracılığıyla mesaj alışverişinde bulunabilen isimlendirilmiş, adreslenebilir ekip arkadaşları istersiniz.
+
+Tek bir devredilmiş arama veya tek seferlik paralel fan-out için KULLANMAYIN — düz `Agent` çağrıları daha hafif ve yeterlidir.
 
 ## Parametreler
 
-| Parametre | Tür | Zorunlu | Açıklama |
-|-----------|-----|---------|----------|
-| `team_name` | string | Evet | Yeni takımın adı |
-| `description` | string | Hayır | Takım açıklaması / amacı |
-| `agent_type` | string | Hayır | Takım liderinin türü / rolü |
+- `team_name` (string, zorunlu): Ekip için benzersiz tanımlayıcı. `~/.claude/teams/` altındaki dizin adı olarak ve ekip arkadaşlarını oluştururken `team_name` argümanı olarak kullanılır.
+- `description` (string, zorunlu): Ekibin hedefinin kısa ifadesi. Her ekip arkadaşına oluşturulurken gösterilir ve ekip yapılandırmasına yazılır.
+- `agent_type` (string, opsiyonel): Onu geçersiz kılmayan ekip arkadaşlarına uygulanan varsayılan alt ajan persona'sı. Tipik değerler `general-purpose`, `Explore` veya `Plan`'dır.
+
+## Örnekler
+
+### Örnek 1: Bir refactoring ekibi oluşturun
 
-## Oluşturulanlar
+```
+TeamCreate(
+  team_name="refactor-crew",
+  description="Refactor the data access layer from raw SQL to Prisma, including migrations and tests.",
+  agent_type="general-purpose"
+)
+```
 
-- **Takım yapılandırma dosyası**: `~/.claude/teams/{team-name}/config.json` — üye listesini ve meta verileri saklar
-- **Görev listesi dizini**: `~/.claude/tasks/{team-name}/` — tüm takım üyeleri için paylaşılan görev listesi
+Oluşturmadan sonra, `team_name: "refactor-crew"` ve `db-lead`, `migrations` ve `tests` gibi farklı `name` değerleri kullanarak `Agent` ile ekip arkadaşları oluşturun.
 
-Takımlar ile görev listeleri arasında 1:1 ilişki vardır.
+### Örnek 2: Bir inceleme ekibi oluşturun
 
-## Takım İş Akışı
+```
+TeamCreate(
+  team_name="perf-investigation",
+  description="Identify and rank the top three performance regressions introduced in the last release.",
+  agent_type="Explore"
+)
+```
 
-1. **TeamCreate** — takımı ve görev listesini oluştur
-2. **TaskCreate** — takım için görevleri tanımla
-3. **Agent** (`team_name` + `name` ile) — takıma katılan takım üyelerini başlat
-4. **TaskUpdate** — `owner` aracılığıyla görevleri takım üyelerine ata
-5. Takım üyeleri görevler üzerinde çalışır ve **SendMessage** ile iletişim kurar
-6. İşlem bitince takım üyelerini kapat, ardından **TeamDelete** ile temizlik yap
+Oluşturulan her ekip arkadaşı, işin yalnızca-okuma inceleme doğasıyla eşleşen varsayılan persona olarak `Explore`'u miras alır.
 
-## İlgili Araçlar
+## Notlar
 
-| Araç | Amaç |
-|------|------|
-| `TeamDelete` | Takımı ve görev dizinlerini kaldır |
-| `SendMessage` | Takım içi agent'lar arası iletişim |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Paylaşılan görev listesini yönet |
-| `Agent` | Takıma katılan takım üyelerini başlat |
+- Belirli bir oturumdan aynı anda yalnızca bir ekibe liderlik edilebilir. Başka bir tane oluşturmadan önce mevcut ekibi bitirin veya silin.
+- Bir ekip paylaşılan bir görev listesiyle 1:1'dir. Lider, görev oluşturma, atama ve kapatmaya sahiptir; ekip arkadaşları üzerinde çalıştıkları görevlerin durumunu günceller.
+- Ekip yapılandırması `~/.claude/teams/{team_name}/config.json`'da saklanır ve görev dizini de yanında bulunur. Bu dosyalar, `TeamDelete` ile açıkça kaldırılana kadar oturumlar boyunca hayatta kalır.
+- Ekip arkadaşları, eşleşen `team_name` artı farklı bir `name` ile `Agent` aracı kullanılarak oluşturulur. `name`, `SendMessage` tarafından kullanılan adres olur.
+- Dosya sistemi güvenli (harfler, rakamlar, tireler, alt çizgiler) bir `team_name` seçin. Boşluklardan veya slash'lardan kaçının.
+- `description`'ı, yeni bir ekip arkadaşının onu soğuk okuduğunda daha fazla bağlam olmadan ekibin hedefini anlayacağı şekilde yazın. Her ekip arkadaşının başlangıç promptunun parçası olur.

package/concepts/tr/Tool-TeamDelete.md

@@ -1,30 +1,44 @@
 # TeamDelete
 
-## Tanım
+Mevcut aktif ekibi yıkar, yapılandırma dizinini ve paylaşılan görev dizinini kaldırır. Bu, `TeamCreate`'in temizlik karşılığıdır ve genellikle ekibin hedefi ulaşıldıktan ve tüm ekip arkadaşları kapatıldıktan sonra çağrılır.
 
-Çok agent'lı işbirliği çalışması tamamlandığında bir takımı ve ilişkili görev dizinlerini kaldırır. Bu, TeamCreate'in temizlik karşılığıdır.
+## Ne Zaman Kullanılır
 
-## Davranış
+- Ekip işini tamamladı ve nihai rapor kullanıcıya teslim edildi.
+- Ekip hatayla oluşturuldu veya kapsamı o kadar büyük ölçüde değişti ki, devam etmek yerine sıfırdan başlamak daha temiz.
+- Yeni bir ekip oluşturmanız gerekiyor ancak zaten bir tane aktif — eskisini önce silin, çünkü aynı anda yalnızca bir ekibe liderlik edilebilir.
+- Bir ekip oturumlar arasında eski hale geldi ve `~/.claude/teams/` altındaki kalıcı durumu artık gerekli değil.
 
-- Takım dizinini kaldırır: `~/.claude/teams/{team-name}/`
-- Görev dizinini kaldırır: `~/.claude/tasks/{team-name}/`
-- Mevcut oturumdan takım bağlamını temizler
+Ekip arkadaşları hala çalışırken ÇAĞIRMAYIN — önce `SendMessage` ile bir `shutdown_request` ile onları kapatın, her `shutdown_response`'u bekleyin, sonra silin.
 
-**Önemli**: Takımın hâlâ aktif üyeleri varsa TeamDelete başarısız olur. Takım üyeleri önce SendMessage kapatma istekleri aracılığıyla düzgün şekilde kapatılmalıdır.
+## Parametreler
 
-## Tipik Kullanım
+`TeamDelete` tipik çağrısında parametre almaz. Çağıran oturuma ait mevcut aktif ekip üzerinde çalışır.
 
-TeamDelete, bir takım iş akışının sonunda çağrılır:
+## Örnekler
 
-1. Tüm görevler tamamlanır
-2. Takım üyeleri `shutdown_request` ile `SendMessage` aracılığıyla kapatılır
-3. **TeamDelete** takım ve görev dizinlerini kaldırır
+### Örnek 1: Başarı sonrası rutin kapanış
 
-## İlgili Araçlar
+1. Ekibe bir kapatma isteği yayınlayın:
+   ```
+   SendMessage(to="*", message={ "type": "shutdown_request" })
+   ```
+2. Her ekip arkadaşının bir `shutdown_response` ile yanıt vermesini bekleyin.
+3. Ekip dizinini ve görev dizinini kaldırmak için `TeamDelete()` çağırın.
 
-| Araç | Amaç |
-|------|------|
-| `TeamCreate` | Yeni bir takım ve görev listesi oluştur |
-| `SendMessage` | Takım üyeleriyle iletişim kur / kapatma istekleri gönder |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Paylaşılan görev listesini yönet |
-| `Agent` | Takıma katılan takım üyelerini başlat |
+### Örnek 2: Yanlış yapılandırılmış bir ekibi değiştirme
+
+`TeamCreate` yanlış `agent_type` veya `description` ile çağrıldıysa, önce hiç ekip arkadaşı oluşturulmadığından emin olun (veya onları kapatın), sonra:
+
+```
+TeamDelete()
+TeamCreate(team_name="...", description="...", agent_type="...")
+```
+
+## Notlar
+
+- `TeamDelete` herhangi bir ekip arkadaşı hala aktifse başarısız olur. Hata yanıtı canlı ekip arkadaşlarını listeler — her birine `SendMessage` aracılığıyla bir `shutdown_request` gönderin, `shutdown_response`'larını bekleyin ve tekrar deneyin.
+- Silme, aracın bakış açısından geri döndürülemez. Ekibin `~/.claude/teams/{team_name}/config.json`'daki yapılandırması ve görev dizini diskten kaldırılır. Görev listesinin korunmasına ihtiyacınız varsa, silmeden önce dizini dışa aktarın veya kopyalayın.
+- Yalnızca ekibi oluşturan lider oturum onu silebilir. Oluşturulan bir ekip arkadaşı kendi ekibinde `TeamDelete` çağıramaz.
+- Ekibi silmek, ekip arkadaşlarının depoda yaptığı dosya sistemi değişikliklerini geri almaz. Bunlar sıradan git-izlemeli düzenlemelerdir ve istenmiyorsa ayrıca geri alınmaları gerekir.
+- `TeamDelete` başarıyla döndükten sonra, oturum yeni bir ekip için yeniden `TeamCreate` çağırmakta özgürdür.

package/concepts/tr/Tool-WebFetch.md

@@ -1,55 +1,50 @@
 # WebFetch
 
-## Tanım
+Genel bir web sayfasının içeriklerini alır, HTML'i Markdown'a dönüştürür ve ihtiyacınız olan bilgiyi çıkarmak için sonuç üzerinde doğal dil promptuyla küçük bir yardımcı modeli çalıştırır.
 
-Belirtilen URL'nin web sayfası içeriğini çeker, HTML'yi markdown'a dönüştürür ve prompt'a göre AI modeli ile içeriği işler.
+## Ne Zaman Kullanılır
+
+- Konuşmada bahsedilen genel bir dokümantasyon sayfası, blog yazısı veya RFC'yi okumak.
+- Tam sayfayı bağlama yüklemeden bilinen bir URL'den belirli bir gerçek, kod parçacığı veya tablo çıkarmak.
+- Açık bir web kaynağından yayın notlarını veya changelog'ları özetlemek.
+- Kaynak yerel depoda olmadığında bir kitaplığın genel API referansını kontrol etmek.
+- Takip sorusunu yanıtlamak için kullanıcının sohbete yapıştırdığı bir bağlantıyı takip etmek.
 
 ## Parametreler
 
-| Parametre | Tür | Zorunlu | Açıklama |
-|-----------|-----|---------|----------|
-| `url` | string (URI) | Evet | Çekilecek tam URL |
-| `prompt` | string | Evet | Sayfadan hangi bilginin çıkarılacağını açıklar |
-
-## Kullanım Senaryoları
-
-**Kullanıma uygun:**
-- Herkese açık web sayfalarının içeriğini alma
-- Çevrimiçi belgelere başvurma
-- Web sayfasından belirli bilgileri çıkarma
-
-**Kullanıma uygun değil:**
-- Kimlik doğrulama gerektiren URL'ler (Google Docs, Confluence, Jira, GitHub vb.) — önce özel MCP aracı aranmalıdır
-- GitHub URL'leri — öncelikle `gh` CLI kullanılmalıdır
-
-## Dikkat Edilecekler
-
-- URL tam ve geçerli bir URL olmalıdır
-- HTTP otomatik olarak HTTPS'ye yükseltilir
-- İçerik çok büyükse sonuçlar özetlenebilir
-- 15 dakikalık otomatik temizlenen önbellek içerir
-- URL farklı bir ana bilgisayara yönlendirildiğinde, araç yönlendirme URL'sini döndürür ve yeni URL ile tekrar istek yapılması gerekir
-- MCP tarafından sağlanan web fetch aracı mevcutsa, onu tercih edin
-
-## Orijinal Metin
-
-<textarea readonly>IMPORTANT: WebFetch WILL FAIL for authenticated or private URLs. Before using this tool, check if the URL points to an authenticated service (e.g. Google Docs, Confluence, Jira, GitHub). If so, you MUST use ToolSearch first to find a specialized tool that provides authenticated access.
-
-- Fetches content from a specified URL and processes it using an AI model
-- Takes a URL and a prompt as input
-- Fetches the URL content, converts HTML to markdown
-- Processes the content with the prompt using a small, fast model
-- Returns the model's response about the content
-- Use this tool when you need to retrieve and analyze web content
-
-Usage notes:
-  - IMPORTANT: If an MCP-provided web fetch tool is available, prefer using that tool instead of this one, as it may have fewer restrictions.
-  - The URL must be a fully-formed valid URL
-  - HTTP URLs will be automatically upgraded to HTTPS
-  - The prompt should describe what information you want to extract from the page
-  - This tool is read-only and does not modify any files
-  - Results may be summarized if the content is very large
-  - Includes a self-cleaning 15-minute cache for faster responses when repeatedly accessing the same URL
-  - When a URL redirects to a different host, the tool will inform you and provide the redirect URL in a special format. You should then make a new WebFetch request with the redirect URL to fetch the content.
-  - For GitHub URLs, prefer using the gh CLI via Bash instead (e.g., gh pr view, gh issue view, gh api).
-</textarea>
+- `url` (string, zorunlu): Tam biçimli mutlak URL. Düz `http://` otomatik olarak `https://`'e yükseltilir.
+- `prompt` (string, zorunlu): Küçük çıkarma modeline geçirilen talimat. Sayfadan tam olarak neyi çıkaracağınızı açıklayın, örneğin "tüm dışa aktarılan fonksiyonları listele" veya "desteklenen minimum Node sürümünü döndür".
+
+## Örnekler
+
+### Örnek 1: Bir yapılandırma varsayılanını çıkarmak
+
+```
+WebFetch(
+  url="https://vitejs.dev/config/server-options.html",
+  prompt="What is the default value of server.port and can it be a string?"
+)
+```
+
+Araç Vite dokümantasyon sayfasını alır, Markdown'a dönüştürür ve "Varsayılan `5173`'tür; yalnızca bir sayı kabul eder." gibi kısa bir yanıt döndürür.
+
+### Örnek 2: Bir changelog bölümünü özetlemek
+
+```
+WebFetch(
+  url="https://nodejs.org/en/blog/release/v20.11.0",
+  prompt="List the security fixes included in this release as bullet points."
+)
+```
+
+Kullanıcı "Node 20.11'de neler değişti" diye sorduğunda ve yayın sayfası uzun olduğunda kullanışlıdır.
+
+## Notlar
+
+- `WebFetch`, kimlik doğrulama, çerezler veya VPN gerektiren herhangi bir URL'de başarısız olur. Google Docs, Confluence, Jira, özel GitHub kaynakları veya dahili wikiler için, bunun yerine kimlik doğrulamalı erişim sağlayan özel bir MCP sunucusu kullanın.
+- GitHub'da barındırılan herhangi bir şey için (PR'lar, konular, dosya blob'ları, API yanıtları), web arayüzünü kazımak yerine `Bash` aracılığıyla `gh` CLI'yi tercih edin. `gh pr view`, `gh issue view` ve `gh api` yapılandırılmış veri döndürür ve özel depolarda çalışır.
+- Alınan sayfa çok büyük olduğunda sonuçlar özetlenebilir. Tam metne ihtiyacınız varsa, literal bir alıntı istemek için `prompt`'u daraltın.
+- URL başına kendi kendini temizleyen 15 dakikalık bir önbellek uygulanır. Bir oturum sırasında aynı sayfaya tekrarlanan çağrılar neredeyse anlıktır ancak biraz eski içerik döndürebilir. Tazelik önemliyse, promptta bahsedin veya önbelleği bekleyin.
+- Hedef ana bilgisayar bir çapraz-ana bilgisayar yönlendirmesi verirse, araç özel bir yanıt bloğunda yeni URL'yi döndürür ve otomatik olarak takip etmez. Hala içeriği istiyorsanız yönlendirme hedefiyle `WebFetch`'i yeniden çağırın.
+- Prompt, ana asistandan daha küçük, daha hızlı bir model tarafından yürütülür. Dar ve somut tutun; karmaşık çok adımlı akıl yürütme, alındıktan sonra ham Markdown'u kendiniz okuyarak daha iyi ele alınır.
+- URL'e gömülü sırları, tokenları veya oturum tanımlayıcılarını asla geçirmeyin — sayfa içerikleri ve çıktıda yansıyan sorgu stringleri yukarı akış hizmetleri tarafından günlüğe kaydedilebilir.

package/concepts/tr/Tool-WebSearch.md

@@ -1,58 +1,51 @@
 # WebSearch
 
-## Tanım
+Canlı bir web araması gerçekleştirir ve asistanın modelin eğitim kesiminin ötesindeki mevcut bilgilerde yanıtını temellendirmek için kullandığı sıralanmış sonuçlar döndürür.
 
-Arama motoru sorgusu çalıştırır ve güncel bilgi almak için arama sonuçlarını döndürür.
+## Ne Zaman Kullanılır
 
-## Parametreler
-
-| Parametre | Tür | Zorunlu | Açıklama |
-|-----------|-----|---------|----------|
-| `query` | string | Evet | Arama sorgusu (en az 2 karakter) |
-| `allowed_domains` | string[] | Hayır | Yalnızca bu alan adlarından sonuçları dahil et |
-| `blocked_domains` | string[] | Hayır | Bu alan adlarından sonuçları hariç tut |
+- Güncel olaylar, son yayınlar veya son dakika haberleri hakkındaki soruları yanıtlamak.
+- Bir kitaplık, çerçeve veya CLI aracının en son sürümünü aramak.
+- Tam URL bilinmediğinde dokümantasyon veya blog yazıları bulmak.
+- Model eğitildiğinden beri değişmiş olabilecek bir gerçeği doğrulamak.
+- `WebFetch` ile herhangi bir sayfayı almadan önce bir konudaki birden fazla bakış açısını keşfetmek.
 
-## Kullanım Senaryoları
+## Parametreler
 
-**Kullanıma uygun:**
-- Modelin bilgi kesme tarihini aşan güncel bilgileri alma
-- Güncel olayları ve en son verileri bulma
-- En güncel teknik belgeleri arama
+- `query` (string, zorunlu): Arama sorgusu. Minimum uzunluk 2 karakter. Sonuçların taze olması için "en son" veya "yakın zamandaki" bilgiler hakkında sorarken mevcut yılı dahil edin.
+- `allowed_domains` (string dizisi, opsiyonel): Sonuçları yalnızca bu alan adlarıyla sınırlar, örneğin `["nodejs.org", "developer.mozilla.org"]`. Belirli bir kaynağa güvendiğinizde kullanışlıdır.
+- `blocked_domains` (string dizisi, opsiyonel): Bu alan adlarından gelen sonuçları hariç tutar. Aynı alan adını `allowed_domains` ve `blocked_domains`'e geçirmeyin.
 
-## Dikkat Edilecekler
+## Örnekler
 
-- Arama sonuçları markdown köprü formatında döndürülür
-- Kullanımdan sonra yanıtın sonuna "Sources:" bölümü eklenmeli ve ilgili URL'ler listelenmelidir
-- Alan adı filtrelemeyi destekler (dahil etme/hariç tutma)
-- Arama sorgusunda güncel yıl kullanılmalıdır
-- Yalnızca ABD'de kullanılabilir
+### Örnek 1: Mevcut yıl ile sürüm araması
 
-## Orijinal Metin
+```
+WebSearch(
+  query="React 19 stable release date 2026",
+  allowed_domains=["react.dev", "github.com"]
+)
+```
 
-<textarea readonly>
-- Allows Claude to search the web and use the results to inform responses
-- Provides up-to-date information for current events and recent data
-- Returns search result information formatted as search result blocks, including links as markdown hyperlinks
-- Use this tool for accessing information beyond Claude's knowledge cutoff
-- Searches are performed automatically within a single API call
+Resmi duyuruları döndürür ve düşük kaliteli toplayıcı sitelerden kaçınır.
 
-CRITICAL REQUIREMENT - You MUST follow this:
-  - After answering the user's question, you MUST include a "Sources:" section at the end of your response
-  - In the Sources section, list all relevant URLs from the search results as markdown hyperlinks: [Title](URL)
-  - This is MANDATORY - never skip including sources in your response
-  - Example format:
+### Örnek 2: Gürültülü kaynakları hariç tutmak
 
-    [Your answer here]
+```
+WebSearch(
+  query="kubernetes ingress-nginx CVE April 2026",
+  blocked_domains=["pinterest.com", "medium.com"]
+)
+```
 
-    Sources:
-    - [Source Title 1](https://example.com/1)
-    - [Source Title 2](https://example.com/2)
+Sonuçları satıcı uyarıları ve güvenlik izleyicilerine odaklı tutar.
 
-Usage notes:
-  - Domain filtering is supported to include or block specific websites
-  - Web search is only available in the US
+## Notlar
 
-IMPORTANT - Use the correct year in search queries:
-  - The current month is March 2026. You MUST use this year when searching for recent information, documentation, or current events.
-  - Example: If the user asks for "latest React docs", search for "React documentation" with the current year, NOT last year
-</textarea>
+- Bir yanıtta `WebSearch` kullandığınızda, yanıtınızın sonuna her alıntılanan sonucu `[Title](URL)` biçiminde bir Markdown köprüsü olarak listeleyen bir `Sources:` bölümü eklemeniz gerekir. Bu isteğe bağlı değil, zorunlu bir gerekliliktir.
+- `WebSearch` yalnızca Amerika Birleşik Devletleri'ndeki kullanıcılara sunulmaktadır. Araç bölgenizde kullanılamıyorsa, bilinen bir URL'ye karşı `WebFetch`'e geri dönün veya kullanıcıdan ilgili içeriği yapıştırmasını isteyin.
+- Her çağrı tek bir gidiş-dönüşte aramayı gerçekleştirir — akış yapamaz veya sayfalara ayıramazsınız. İlk sonuç kümesi hedef dışıysa sorguyu iyileştirin.
+- Araç parçacıklar ve meta veri döndürür, tam sayfa içerikleri değil. Belirli bir sonucu derinlemesine okumak için, döndürülen URL ile `WebFetch` ile takip edin.
+- CVE'ler veya uyumluluk gibi güvenliğe duyarlı sorular için yetkili kaynak temini uygulamak için `allowed_domains`'i ve dokümantasyonu yansıtan SEO çiftliklerini kesmek için `blocked_domains`'i kullanın.
+- Sorguları kısa ve anahtar kelime odaklı tutun. Doğal dil soruları işe yarar ancak birincil kaynaklardan ziyade konuşma yanıtları döndürme eğilimindedir.
+- Arama sezgisine dayalı olarak URL'ler uydurmayın — her zaman aramayı çalıştırın ve aracın gerçekten döndürdüğünü alıntılayın.

package/concepts/tr/Tool-Write.md

@@ -1,39 +1,35 @@
 # Write
 
-## Tanım
+Yerel dosya sisteminde yeni bir dosya oluşturur veya var olan bir dosyanın içeriklerini tamamen değiştirir. Hedef yoldaki her şeyi değiştirdiğinden, gerçek oluşturma veya kasıtlı tam yeniden yazma için saklanmalıdır.
 
-İçeriği yerel dosya sistemine yazar. Dosya zaten mevcutsa üzerine yazar.
+## Ne Zaman Kullanılır
 
-## Parametreler
-
-| Parametre | Tür | Zorunlu | Açıklama |
-|-----------|-----|---------|----------|
-| `file_path` | string | Evet | Dosyanın mutlak yolu (mutlak yol olmalıdır) |
-| `content` | string | Evet | Yazılacak içerik |
+- Henüz var olmayan yepyeni bir kaynak dosyası, test veya yapılandırma oluşturmak
+- Sıfırdan yeni bir fikstür, anlık görüntü veya veri dosyası üretmek
+- Artımlı bir `Edit`'in yeniden başlamaktan daha karmaşık olacağı tam bir yeniden yazma gerçekleştirmek
+- Kullanıcının açıkça üretmenizi istediği bir şema, geçiş veya derleme betiği gibi istenen bir eser yayınlamak
 
-## Kullanım Senaryoları
+## Parametreler
 
-**Kullanıma uygun:**
-- Yeni dosya oluşturma
-- Dosya içeriğinin tamamen yeniden yazılması gerektiğinde
+- `file_path` (string, zorunlu): Yazılacak dosyanın mutlak yolu. Herhangi bir üst dizin zaten var olmalıdır.
+- `content` (string, zorunlu): Dosyaya yazılacak tam metin. Bu, tüm dosya gövdesi olur.
 
-**Kullanıma uygun değil:**
-- Dosyadaki kısmi içeriği değiştirme — Edit kullanılmalıdır
-- Kullanıcı açıkça istemediği sürece proaktif olarak belge dosyaları (*.md) veya README oluşturulmamalıdır
+## Örnekler
 
-## Dikkat Edilecekler
+### Örnek 1: Yeni bir yardımcı modül oluşturun
+`file_path: "/Users/me/app/src/utils/slugify.ts"` ile `Write` çağırın ve uygulamayı `content` olarak sağlayın. Bunu yalnızca dosyanın zaten var olmadığını doğruladıktan sonra kullanın.
 
-- Hedef dosya zaten mevcutsa, önce Read ile okunmuş olmalıdır, aksi takdirde başarısız olur
-- Mevcut dosyanın tüm içeriğini üzerine yazar
-- Mevcut dosyaları düzenlemek için Edit'i tercih edin; Write yalnızca yeni dosya oluşturma veya tamamen yeniden yazma için kullanılır
+### Örnek 2: Türetilmiş bir eseri yeniden oluşturun
+Şema kaynağı değiştikten sonra, `/Users/me/app/generated/schema.json`'u taze üretilen JSON'u `content` olarak kullanarak tek bir `Write` çağrısında yeniden yazın.
 
-## Orijinal Metin
+### Örnek 3: Küçük bir fikstür dosyasını değiştirin
+Her satırın değiştiği tek kullanımlık bir test fikstürü için, `Write` bir `Edit` çağrıları dizisinden daha net olabilir. Dosyayı önce okuyun, kapsamı onaylayın, sonra üzerine yazın.
 
-<textarea readonly>Writes a file to the local filesystem.
+## Notlar
 
-Usage:
-- This tool will overwrite the existing file if there is one at the provided path.
-- If this is an existing file, you MUST use the Read tool first to read the file's contents. This tool will fail if you did not read the file first.
-- Prefer the Edit tool for modifying existing files — it only sends the diff. Only use this tool to create new files or for complete rewrites.
-- NEVER create documentation files (*.md) or README files unless explicitly requested by the User.
-- Only use emojis if the user explicitly requests it. Avoid writing emojis to files unless asked.</textarea>
+- Var olan bir dosyanın üzerine yazmadan önce, mevcut oturumda üzerinde `Read` çağırmalısınız. `Write` görülmemiş içeriği bozmayı reddeder.
+- Dosyanın yalnızca bir kısmına dokunan herhangi bir değişiklik için `Edit`'i tercih edin. `Edit` yalnızca diff'i gönderir, bu da daha hızlı, daha güvenli ve gözden geçirmesi daha kolaydır.
+- Kullanıcı açıkça istemedikçe proaktif olarak Markdown dokümantasyonu, `README.md` veya changelog dosyaları oluşturmayın.
+- Kullanıcı bu stili talep etmedikçe emoji, pazarlama yazısı veya dekoratif bannerlar eklemeyin.
+- Önce `Bash` `ls` çağrısı ile üst dizinin var olduğunu doğrulayın; `Write` ara klasörler oluşturmaz.
+- İçeriği tam olarak kalıcılaştırmak istediğiniz gibi sağlayın; şablonlama veya son işleme yoktur.

package/concepts/tr/Tool-executeCode.md

@@ -1,41 +1,47 @@
-# executeCode (mcp__ide__executeCode)
+# executeCode
 
-## Tanım
+Bir IDE entegrasyonu tarafından sağlanan canlı bir kernel veya sandbox içinde bir kod parçacığını yürütür (örneğin mevcut açık notebook'a bağlı Jupyter kerneli). Araç yalnızca Claude Code, Jupyter kerneli seçili VS Code uzantısı gibi uyumlu bir IDE köprüsüyle birlikte çalışırken mevcuttur.
 
-Mevcut notebook dosyasının Jupyter kernel'ında Python kodu çalıştırır.
+## Ne Zaman Kullanılır
+
+- Aktif bir Jupyter kernelinde zaten yüklü duruma karşı hızlı bir hesaplama, veri incelemesi veya çizim çalıştırmak.
+- Bir kod parçacığını bir notebook hücresine yapıştırmadan önce doğrulamak.
+- Kernelde var olan ancak diske serileştirilmemiş bir bellek içi dataframe, değişken veya modeli keşfetmek.
+- Kullanıcının IDE'de satır içi işlenmesini istediği bir grafik veya sayısal sonuç üretmek.
+
+`Bash` ile `python script.py` çalıştırmanın daha iyi hizmet edeceği bağımsız betikler veya taze bir kernel arasında kalıcı olması gereken kod için KULLANMAYIN.
 
 ## Parametreler
 
-| Parametre | Tür | Zorunlu | Açıklama |
-|-----------|-----|---------|----------|
-| `code` | string | Evet | Çalıştırılacak Python kodu |
+- `code` (string, zorunlu): Mevcut kernelde yürütülecek kod. Notebook hücresine yapıştırılmış gibi çalışır — tanımlanan değişkenler yeniden başlatılana kadar kernelde kalır.
+- `language` (string, opsiyonel): IDE köprüsü birden fazla kerneli desteklediğinde parçacığın dili. En yaygın olarak atlanır; varsayılan olarak aktif kernelin dilini kullanır (genellikle Python).
+
+## Örnekler
+
+### Örnek 1: Bir bellek içi dataframe'i incelemek
 
-## Kullanım Senaryoları
+```
+executeCode(
+  code="df.head()\nprint(df.shape)\nprint(df.dtypes)"
+)
+```
 
-**Kullanıma uygun:**
-- Jupyter notebook ortamında kod çalıştırma
-- Kod parçacıklarını test etme
-- Veri analizi ve hesaplama
+Kernelde zaten yüklü bir dataframe'in ilk satırlarını, şeklini ve sütun dtypes'ını döndürür.
 
-**Kullanıma uygun değil:**
-- Jupyter dışı ortamda kod çalıştırma — Bash kullanılmalıdır
-- Dosya değiştirme — Edit veya Write kullanılmalıdır
+### Örnek 2: Hızlı sayısal kontrol
 
-## Dikkat Edilecekler
+```
+executeCode(
+  code="import numpy as np\nnp.mean([1, 2, 3, 4, 5])"
+)
+```
 
-- Bu bir MCP (Model Context Protocol) aracıdır ve IDE entegrasyonu tarafından sağlanır
-- Kod mevcut Jupyter kernel'ında çalıştırılır, durum çağrılar arasında kalıcıdır
-- Kullanıcı açıkça istemediği sürece değişken tanımlamaktan veya kernel durumunu değiştirmekten kaçınılmalıdır
-- Kernel yeniden başlatıldığında durum kaybolur
+Notebook hücresi oluşturmadan tek seferlik bir hesaplama çalıştırır.
 
-## Orijinal Metin
+## Notlar
 
-<textarea readonly>Execute python code in the Jupyter kernel for the current notebook file.
-    
-    All code will be executed in the current Jupyter kernel.
-    
-    Avoid declaring variables or modifying the state of the kernel unless the user
-    explicitly asks for it.
-    
-    Any code executed will persist across calls to this tool, unless the kernel
-    has been restarted.</textarea>
+- `executeCode` bir IDE-köprüsü aracıdır. Claude Code'un düz terminal oturumlarında mevcut değildir; yalnızca oturum bir kernel sunan bir IDE'ye bağlı olduğunda (örneğin VS Code Jupyter uzantısı) görünür.
+- Durum kernelde kalıcıdır. Bir `executeCode` çağrısı tarafından tanımlanan değişkenler sonraki çağrılara, notebook hücrelerine ve kullanıcıya görünür kalır — yan etkilere dikkat edin.
+- Uzun süren veya bloklayıcı kod kerneli bloklar. Parçacıkları kısa tutun; dakikalarca süren iş için gerçek bir betik yazın ve `Bash` aracılığıyla çalıştırın.
+- Çıktı (stdout, dönüş değerleri, görüntüler) oturuma döndürülür. Çok büyük çıktılar IDE köprüsü tarafından kesilebilir.
+- Dosya düzenlemeleri için `Edit`, `Write` veya `NotebookEdit`'i tercih edin — `executeCode` kaynak dosyaları yazmak için bir ikame değildir.

package/concepts/tr/Tool-getDiagnostics.md

@@ -1,32 +1,44 @@
-# getDiagnostics (mcp__ide__getDiagnostics)
+# getDiagnostics
 
-## Tanım
+Bağlı IDE'den belirli bir dosya veya IDE'nin şu anda açık olan her dosyası için dil-sunucu tanılamalarını (hatalar, uyarılar, ipuçları) alır. Bir görevin yapıldığını ilan etmeden önce kod değişikliklerinin temiz derlendiğini doğrulamak için kullanılır.
 
-VS Code'dan sözdizimi hataları, tür hataları, lint uyarıları gibi dil tanılama bilgilerini alır.
+## Ne Zaman Kullanılır
+
+- Bir `Edit` veya `Write`'tan sonra değişikliğin bir tür hatası, sözdizimi hatası veya lint uyarısı getirmediğini onaylamak.
+- Çözülmemiş sorunlar için açık her dosyayı taramak için bir görevi sonlandırmadan önce.
+- Kullanıcının bildirdiği bir hatayı teşhis ederken — IDE'den tam derleyici veya tür-denetleyici mesajını çekmek tahmin etmekten kaçınır.
+- Yalnızca statik doğruluğu kontrol etmeniz gerektiğinde tam bir derleme veya test komutu çalıştırmaya hafif bir alternatif olarak.
+
+`getDiagnostics`'e test paketi yerine güvenmeyin. Dil sunucusunun gördüğünü bildirir, test veya üretim zamanında çalışanı değil.
 
 ## Parametreler
 
-| Parametre | Tür | Zorunlu | Açıklama |
-|-----------|-----|---------|----------|
-| `uri` | string | Hayır | Dosya URI'si. Belirtilmezse tüm dosyaların tanılama bilgilerini alır |
+- `uri` (string, opsiyonel): Tanılamaları almak için dosya URI'si (tipik olarak `file:///absolute/path`). Atlandığında, araç IDE'nin şu anda açık olan her dosya için tanılamaları döndürür.
+
+## Örnekler
+
+### Örnek 1: Düzenlemeden sonra tek bir dosyayı kontrol edin
 
-## Kullanım Senaryoları
+```
+getDiagnostics(
+  uri="file:///Users/sky/project/src/auth.ts"
+)
+```
 
-**Kullanıma uygun:**
-- Kodun sözdizimi, tür, lint gibi anlamsal sorunlarını kontrol etme
-- Kod düzenledikten sonra yeni hata oluşup oluşmadığını doğrulama
-- Kod kalitesini kontrol etmek için Bash komutlarının yerine kullanma
+`src/auth.ts` için herhangi bir TypeScript hatası, ESLint uyarısı veya diğer dil-sunucu mesajlarını döndürür.
 
-**Kullanıma uygun değil:**
-- Test çalıştırma — Bash kullanılmalıdır
-- Çalışma zamanı hatalarını kontrol etme — kodu çalıştırmak için Bash kullanılmalıdır
+### Örnek 2: Tüm açık dosyaları tarayın
 
-## Dikkat Edilecekler
+```
+getDiagnostics()
+```
 
-- Bu bir MCP (Model Context Protocol) aracıdır ve IDE entegrasyonu tarafından sağlanır
-- Yalnızca VS Code / IDE ortamında kullanılabilir
-- Kod sorunlarını kontrol etmek için Bash komutları yerine bu aracı tercih edin
+Şu anda açık olan her editördeki tanılamaları döndürür. Başka yerlerde hiçbir şeyin gerilemediğinden emin olmak için çok dosyalı bir refactoring'in sonunda kullanışlıdır.
 
-## Orijinal Metin
+## Notlar
 
-<textarea readonly>Get language diagnostics from VS Code</textarea>
+- `getDiagnostics` bir IDE-köprüsü aracıdır. Yalnızca Claude Code destekleyici bir IDE entegrasyonuna (örneğin VS Code uzantısı) bağlı olduğunda mevcuttur. Düz terminal oturumunda araç görünmez.
+- Sonuçlar, IDE'nin yüklediği dil sunucularını yansıtır — TypeScript, Pyright, ESLint, rust-analyzer vb. Kalite ve kapsam, Claude Code'a değil, kullanıcının IDE kurulumuna bağlıdır.
+- Tanılamalar canlıdır. Bir düzenlemeden sonra, boş bir sonucu başarı olarak yorumlamadan önce dil sunucusuna yeniden analiz etmek için bir süre tanıyın — dosya az önce kaydedildiyse yeniden çalıştırın.
+- Önem düzeyleri tipik olarak `error`, `warning`, `information` ve `hint`'i içerir. Önce `error`'a odaklanın; uyarılar kasıtlı proje stili olabilir.
+- Şu anda IDE'de açık olmayan dosyalar için, dosya gerçek sorunlar içerse bile dil sunucusunun bildirecek hiçbir tanılaması olmayabilir. Yetkili kapsam için dosyayı açın veya derlemeyi çalıştırın.

package/concepts/tr/Tools.md

@@ -8,7 +8,7 @@ Aşağıda tüm araçların kategorize edilmiş dizini bulunmaktadır.
 
 | Araç | Kullanım Amacı |
 |------|----------------|
-| [Task](Tool-Task.md) | Karmaşık çok adımlı görevleri işlemek için alt agent (SubAgent) başlatma |
+| [Agent](Tool-Agent.md) | Karmaşık çok adımlı görevleri işlemek için alt agent (SubAgent) başlatma |
 | [TaskOutput](Tool-TaskOutput.md) | Arka plan görevinin çıktısını alma |
 | [TaskStop](Tool-TaskStop.md) | Çalışan arka plan görevini durdurma |
 | [TaskCreate](Tool-TaskCreate.md) | Yapılandırılmış görev listesi girdisi oluşturma |