mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-04-08 10:23:30 +08:00
Add Turkish (tr) docs and update README (#744)
* Add Turkish (tr) docs and update README Add a full set of Turkish documentation under docs/tr (agents, changelog, CLAUDE guide, contributing, code of conduct, and many agents/commands/skills/rules files). Update README to include a link to the Turkish docs and increment the supported language count from 5 to 6. This commit adds localized guidance and references to help Turkish-speaking contributors and users. * Update docs/tr/TROUBLESHOOTING.md Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com> * Update docs/tr/README.md Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com> * docs(tr): fix license link and update readmes Update Turkish docs: change license badge link to point to repository root (../../LICENSE), increment displayed language count from 5 to 6, and remove two outdated related links from docs/tr/examples/README.md to keep references accurate. * Update docs/tr/commands/instinct-import.md Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com> * Update docs/tr/commands/checkpoint.md Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com> --------- Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>
This commit is contained in:
Berkcan Gümüşışık
committed by
GitHub
GitHub
parent
bb1efad7c7
commit
fd2a8edb53
268
docs/tr/commands/multi-plan.md
Normal file
268
docs/tr/commands/multi-plan.md
Normal file
@@ -0,0 +1,268 @@
|
||||
# Plan - Multi-Model İşbirlikçi Planlama
|
||||
|
||||
Multi-model işbirlikçi planlama - Context retrieval + Dual-model analiz → Adım adım implementation planı oluştur.
|
||||
|
||||
$ARGUMENTS
|
||||
|
||||
---
|
||||
|
||||
## Ana Protokoller
|
||||
|
||||
- **Dil Protokolü**: Tool/model'lerle etkileşimde **İngilizce** kullan, kullanıcıyla kendi dilinde iletişim kur
|
||||
- **Zorunlu Parallel**: Codex/Gemini çağrıları `run_in_background: true` kullanmalı (ana thread'i bloke etmemek için tek model çağrılarında bile)
|
||||
- **Kod Egemenliği**: Harici modellerin **sıfır dosya sistemi yazma erişimi**, tüm değişiklikler Claude tarafından
|
||||
- **Stop-Loss Mekanizması**: Mevcut faz çıktısı doğrulanana kadar bir sonraki faza geçme
|
||||
- **Sadece Planlama**: Bu komut context okumaya ve `.claude/plan/*` plan dosyalarına yazmaya izin verir, ancak **ASLA production kodu değiştirmez**
|
||||
|
||||
---
|
||||
|
||||
## Multi-Model Çağrı Spesifikasyonu
|
||||
|
||||
**Çağrı Sözdizimi** (parallel: `run_in_background: true` kullan):
|
||||
|
||||
```
|
||||
Bash({
|
||||
command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend <codex|gemini> {{GEMINI_MODEL_FLAG}}- \"$PWD\" <<'EOF'
|
||||
ROLE_FILE: <role prompt path>
|
||||
<TASK>
|
||||
Requirement: <enhanced requirement>
|
||||
Context: <retrieved project context>
|
||||
</TASK>
|
||||
OUTPUT: Step-by-step implementation plan with pseudo-code. DO NOT modify any files.
|
||||
EOF",
|
||||
run_in_background: true,
|
||||
timeout: 3600000,
|
||||
description: "Brief description"
|
||||
})
|
||||
```
|
||||
|
||||
**Model Parametre Notları**:
|
||||
- `{{GEMINI_MODEL_FLAG}}`: `--backend gemini` kullanırken, `--gemini-model gemini-3-pro-preview` ile değiştir (trailing space not edin); codex için boş string kullan
|
||||
|
||||
**Role Prompts**:
|
||||
|
||||
| Phase | Codex | Gemini |
|
||||
|-------|-------|--------|
|
||||
| Analysis | `~/.claude/.ccg/prompts/codex/analyzer.md` | `~/.claude/.ccg/prompts/gemini/analyzer.md` |
|
||||
| Planning | `~/.claude/.ccg/prompts/codex/architect.md` | `~/.claude/.ccg/prompts/gemini/architect.md` |
|
||||
|
||||
**Session Reuse**: Her çağrı `SESSION_ID: xxx` döndürür (genellikle wrapper tarafından çıktılanır), sonraki `/ccg:execute` kullanımı için **MUTLAKA kaydet**.
|
||||
|
||||
**Background Task'leri Bekle** (max timeout 600000ms = 10 dakika):
|
||||
|
||||
```
|
||||
TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
|
||||
```
|
||||
|
||||
**ÖNEMLİ**:
|
||||
- `timeout: 600000` belirtilmeli, aksi takdirde varsayılan 30 saniye erken timeout'a neden olur
|
||||
- 10 dakika sonra hala tamamlanmamışsa, `TaskOutput` ile polling'e devam et, **ASLA process'i öldürme**
|
||||
- Bekleme timeout nedeniyle atlanırsa, **MUTLAKA `AskUserQuestion` çağırarak kullanıcıya beklemeye devam etmek veya task'i öldürmek isteyip istemediğini sor**
|
||||
|
||||
---
|
||||
|
||||
## Execution Workflow
|
||||
|
||||
**Planlama Görevi**: $ARGUMENTS
|
||||
|
||||
### Phase 1: Tam Context Retrieval
|
||||
|
||||
`[Mode: Research]`
|
||||
|
||||
#### 1.1 Prompt Enhancement (İLK önce çalıştırılmalı)
|
||||
|
||||
**ace-tool MCP mevcutsa**, `mcp__ace-tool__enhance_prompt` tool'unu çağır:
|
||||
|
||||
```
|
||||
mcp__ace-tool__enhance_prompt({
|
||||
prompt: "$ARGUMENTS",
|
||||
conversation_history: "<son 5-10 konuşma turu>",
|
||||
project_root_path: "$PWD"
|
||||
})
|
||||
```
|
||||
|
||||
Enhanced prompt'u bekle, **orijinal $ARGUMENTS'ı tüm sonraki fazlar için enhanced sonuçla değiştir**.
|
||||
|
||||
**ace-tool MCP mevcut DEĞİLSE**: Bu adımı atla ve tüm sonraki fazlar için orijinal `$ARGUMENTS`'ı olduğu gibi kullan.
|
||||
|
||||
#### 1.2 Context Retrieval
|
||||
|
||||
**ace-tool MCP mevcutsa**, `mcp__ace-tool__search_context` tool'unu çağır:
|
||||
|
||||
```
|
||||
mcp__ace-tool__search_context({
|
||||
query: "<enhanced requirement'a dayalı semantik sorgu>",
|
||||
project_root_path: "$PWD"
|
||||
})
|
||||
```
|
||||
|
||||
- Doğal dil kullanarak semantik sorgu oluştur (Where/What/How)
|
||||
- **ASLA varsayımlara dayalı cevap verme**
|
||||
|
||||
**ace-tool MCP mevcut DEĞİLSE**, fallback olarak Claude Code built-in tool'ları kullan:
|
||||
1. **Glob**: Pattern'e göre ilgili dosyaları bul (örn., `Glob("**/*.ts")`, `Glob("src/**/*.py")`)
|
||||
2. **Grep**: Anahtar semboller, fonksiyon adları, sınıf tanımlarını ara (örn., `Grep("className|functionName")`)
|
||||
3. **Read**: Tam context toplamak için keşfedilen dosyaları oku
|
||||
4. **Task (Explore agent)**: Daha derin keşif için, codebase genelinde aramak üzere `Task`'ı `subagent_type: "Explore"` ile kullan
|
||||
|
||||
#### 1.3 Tamamlılık Kontrolü
|
||||
|
||||
- İlgili sınıflar, fonksiyonlar, değişkenler için **tam tanımlar ve imzalar** elde etmeli
|
||||
- Context yetersizse, **recursive retrieval** tetikle
|
||||
- Çıktıya öncelik ver: giriş dosyası + satır numarası + anahtar sembol adı; belirsizliği çözmek için gerekli olduğunda minimal kod snippet'leri ekle
|
||||
|
||||
#### 1.4 Requirement Alignment
|
||||
|
||||
- Requirement'larda hala belirsizlik varsa, kullanıcı için yönlendirici sorular **MUTLAKA** çıktıla
|
||||
- Requirement sınırları net olana kadar (eksiklik yok, fazlalık yok)
|
||||
|
||||
### Phase 2: Multi-Model İşbirlikçi Analiz
|
||||
|
||||
`[Mode: Analysis]`
|
||||
|
||||
#### 2.1 Input'ları Dağıt
|
||||
|
||||
**Parallel call** Codex ve Gemini (`run_in_background: true`):
|
||||
|
||||
**Orijinal requirement**'ı (önceden belirlenmiş görüşler olmadan) her iki modele dağıt:
|
||||
|
||||
1. **Codex Backend Analysis**:
|
||||
- ROLE_FILE: `~/.claude/.ccg/prompts/codex/analyzer.md`
|
||||
- Odak: Teknik fizibilite, mimari etki, performans değerlendirmeleri, potansiyel riskler
|
||||
- OUTPUT: Çok perspektifli çözümler + artı/eksi analizi
|
||||
|
||||
2. **Gemini Frontend Analysis**:
|
||||
- ROLE_FILE: `~/.claude/.ccg/prompts/gemini/analyzer.md`
|
||||
- Odak: UI/UX etkisi, kullanıcı deneyimi, görsel tasarım
|
||||
- OUTPUT: Çok perspektifli çözümler + artı/eksi analizi
|
||||
|
||||
`TaskOutput` ile her iki modelin tam sonuçlarını bekle. **SESSION_ID'yi kaydet** (`CODEX_SESSION` ve `GEMINI_SESSION`).
|
||||
|
||||
#### 2.2 Cross-Validation
|
||||
|
||||
Perspektifleri entegre et ve optimizasyon için iterate et:
|
||||
|
||||
1. **Consensus tanımla** (güçlü sinyal)
|
||||
2. **Divergence tanımla** (değerlendirme gerektirir)
|
||||
3. **Tamamlayıcı güçlü yönler**: Backend logic Codex'i takip eder, Frontend design Gemini'yi takip eder
|
||||
4. **Mantıksal akıl yürütme**: Çözümlerdeki mantıksal boşlukları elimine et
|
||||
|
||||
#### 2.3 (İsteğe Bağlı ama Önerilen) Dual-Model Plan Taslağı
|
||||
|
||||
Claude'un sentezlenmiş planındaki eksiklik riskini azaltmak için, her iki modelin de "plan taslakları" çıktılamasını parallel yaptır (yine **dosya değiştirmesine izin verilmez**):
|
||||
|
||||
1. **Codex Plan Draft** (Backend otoritesi):
|
||||
- ROLE_FILE: `~/.claude/.ccg/prompts/codex/architect.md`
|
||||
- OUTPUT: Adım adım plan + pseudo-code (odak: data flow/edge cases/error handling/test strategy)
|
||||
|
||||
2. **Gemini Plan Draft** (Frontend otoritesi):
|
||||
- ROLE_FILE: `~/.claude/.ccg/prompts/gemini/architect.md`
|
||||
- OUTPUT: Adım adım plan + pseudo-code (odak: information architecture/interaction/accessibility/visual consistency)
|
||||
|
||||
`TaskOutput` ile her iki modelin tam sonuçlarını bekle, önerilerindeki anahtar farkları kaydet.
|
||||
|
||||
#### 2.4 Implementation Planı Oluştur (Claude Final Version)
|
||||
|
||||
Her iki analizi sentezle, **Adım Adım Implementation Planı** oluştur:
|
||||
|
||||
```markdown
|
||||
## Implementation Plan: <Task Name>
|
||||
|
||||
### Task Type
|
||||
- [ ] Frontend (→ Gemini)
|
||||
- [ ] Backend (→ Codex)
|
||||
- [ ] Fullstack (→ Parallel)
|
||||
|
||||
### Technical Solution
|
||||
<Codex + Gemini analizinden sentezlenmiş optimal çözüm>
|
||||
|
||||
### Implementation Steps
|
||||
1. <Step 1> - Beklenen teslim edilen
|
||||
2. <Step 2> - Beklenen teslim edilen
|
||||
...
|
||||
|
||||
### Key Files
|
||||
| File | Operation | Description |
|
||||
|------|-----------|-------------|
|
||||
| path/to/file.ts:L10-L50 | Modify | Description |
|
||||
|
||||
### Risks and Mitigation
|
||||
| Risk | Mitigation |
|
||||
|------|------------|
|
||||
|
||||
### SESSION_ID (for /ccg:execute use)
|
||||
- CODEX_SESSION: <session_id>
|
||||
- GEMINI_SESSION: <session_id>
|
||||
```
|
||||
|
||||
### Phase 2 End: Plan Teslimi (Execution Değil)
|
||||
|
||||
**`/ccg:plan` sorumlulukları burada biter, MUTLAKA şu aksiyonları çalıştır**:
|
||||
|
||||
1. Tam implementation planını kullanıcıya sun (pseudo-code dahil)
|
||||
2. Planı `.claude/plan/<feature-name>.md`'ye kaydet (requirement'tan feature adını çıkar, örn., `user-auth`, `payment-module`)
|
||||
3. **Kalın metinle** prompt çıktıla (MUTLAKA gerçek kaydedilen dosya yolunu kullan):
|
||||
|
||||
---
|
||||
**Plan oluşturuldu ve `.claude/plan/actual-feature-name.md` dosyasına kaydedildi**
|
||||
|
||||
**Lütfen yukarıdaki planı inceleyin. Şunları yapabilirsiniz:**
|
||||
- **Planı değiştir**: Neyin ayarlanması gerektiğini söyleyin, planı güncelleyeceğim
|
||||
- **Planı çalıştır**: Aşağıdaki komutu yeni bir oturuma kopyalayın
|
||||
|
||||
```
|
||||
/ccg:execute .claude/plan/actual-feature-name.md
|
||||
```
|
||||
---
|
||||
|
||||
**NOT**: Yukarıdaki `actual-feature-name.md` gerçek kaydedilen dosya adıyla değiştirilmelidir!
|
||||
|
||||
4. **Mevcut yanıtı hemen sonlandır** (Burada dur. Daha fazla tool çağrısı yok.)
|
||||
|
||||
**KESINLIKLE YASAK**:
|
||||
- Kullanıcıya "Y/N" sor sonra otomatik çalıştır (execution `/ccg:execute`'un sorumluluğudur)
|
||||
- Production koduna herhangi bir yazma operasyonu
|
||||
- `/ccg:execute`'u veya herhangi bir implementation aksiyonunu otomatik çağır
|
||||
- Kullanıcı açıkça değişiklik talep etmediğinde model çağrılarını tetiklemeye devam et
|
||||
|
||||
---
|
||||
|
||||
## Plan Kaydetme
|
||||
|
||||
Planlama tamamlandıktan sonra, planı şuraya kaydet:
|
||||
|
||||
- **İlk planlama**: `.claude/plan/<feature-name>.md`
|
||||
- **İterasyon versiyonları**: `.claude/plan/<feature-name>-v2.md`, `.claude/plan/<feature-name>-v3.md`...
|
||||
|
||||
Plan dosyası yazma, planı kullanıcıya sunmadan önce tamamlanmalı.
|
||||
|
||||
---
|
||||
|
||||
## Plan Değişiklik Akışı
|
||||
|
||||
Kullanıcı plan değişikliği talep ederse:
|
||||
|
||||
1. Kullanıcı geri bildirimine göre plan içeriğini ayarla
|
||||
2. `.claude/plan/<feature-name>.md` dosyasını güncelle
|
||||
3. Değiştirilmiş planı yeniden sun
|
||||
4. Kullanıcıyı tekrar gözden geçirmeye veya çalıştırmaya davet et
|
||||
|
||||
---
|
||||
|
||||
## Sonraki Adımlar
|
||||
|
||||
Kullanıcı onayladıktan sonra, **manuel** olarak çalıştır:
|
||||
|
||||
```bash
|
||||
/ccg:execute .claude/plan/<feature-name>.md
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Ana Kurallar
|
||||
|
||||
1. **Sadece plan, implementation yok** – Bu komut hiçbir kod değişikliği çalıştırmaz
|
||||
2. **Y/N prompt'ları yok** – Sadece planı sun, kullanıcının sonraki adımlara karar vermesine izin ver
|
||||
3. **Güven Kuralları** – Backend Codex'i takip eder, Frontend Gemini'yi takip eder
|
||||
4. Harici modellerin **sıfır dosya sistemi yazma erişimi**
|
||||
5. **SESSION_ID Devri** – Plan sonunda `CODEX_SESSION` / `GEMINI_SESSION` içermeli (`/ccg:execute resume <SESSION_ID>` kullanımı için)
|
||||
Reference in New Issue
Block a user