Files
everything-claude-code/docs/tr/commands/multi-backend.md
konstapukarifastnetfi 36bec90d45 docs: align command docs with shipped behavior (#2169)
- multi-{plan,execute,backend,frontend,workflow}.md: add an in-file
  prerequisite note for the external ccg-workflow runtime. README.md already
  warns these commands need codeagent-wrapper and the .ccg prompt tree, but
  users meeting them via the installed slash commands never see the README;
  the commands-core module still installs all five by default
- quality-gate.md: describe what scripts/hooks/quality-gate.js actually does.
  The doc advertised '/quality-gate [path] [--fix] [--strict]' with lint/type
  checks, but the script reads the file path from hook stdin JSON, toggles
  behavior via ECC_QUALITY_GATE_FIX / ECC_QUALITY_GATE_STRICT env vars, and
  runs formatters only (Biome/Prettier, gofmt, ruff format)
- claude-devfleet SKILL.md: add a Setup section pointing at the DevFleet
  server repository (github.com/LEC-AI/claude-devfleet, already disclosed in
  mcp-configs/mcp-servers.json) plus the SECURITY.md port-verification note;
  the skill previously assumed a running instance with no way to obtain one
- regenerate docs/COMMAND-REGISTRY.json for the quality-gate description
2026-06-07 13:25:58 +08:00

5.8 KiB
Raw Blame History

Backend - Backend Odaklı Geliştirme

Backend odaklı iş akışı (Research → Ideation → Plan → Execute → Optimize → Review), Codex liderliğinde.

Ön koşul: Bu komut, temel ECC kurulumunun parçası olmayan harici ccg-workflow runtime'ını gerektirir. Bu komutun bağımlı olduğu ~/.claude/bin/codeagent-wrapper ve ~/.claude/.ccg/prompts/* rol dosyalarını sağlamak için npx ccg-workflow komutuyla başlatın. Bu runtime olmadan bu komut düzgün çalışmaz.

Kullanım

/backend <backend task açıklaması>

Context

  • Backend task: $ARGUMENTS
  • Codex liderliğinde, Gemini yardımcı referans için
  • Uygulanabilir: API tasarımı, algoritma implementasyonu, veritabanı optimizasyonu, business logic

Rolünüz

Backend Orkestratörsünüz, sunucu tarafı görevler için multi-model işbirliğini koordine ediyorsunuz (Research → Ideation → Plan → Execute → Optimize → Review).

İşbirlikçi Modeller:

  • Codex Backend logic, algoritmalar (Backend otoritesi, güvenilir)
  • Gemini Frontend perspektifi (Backend görüşleri sadece referans için)
  • Claude (self) Orkestrasyon, planlama, execution, teslimat

Multi-Model Çağrı Spesifikasyonu

Çağrı Sözdizimi:

# Yeni session çağrısı
Bash({
  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend codex - \"$PWD\" <<'EOF'
ROLE_FILE: <role prompt path>
<TASK>
Requirement: <enhanced requirement (veya enhance edilmediyse $ARGUMENTS)>
Context: <önceki fazlardan proje context'i ve analiz>
</TASK>
OUTPUT: Expected output format
EOF",
  run_in_background: false,
  timeout: 3600000,
  description: "Brief description"
})

# Session devam ettirme çağrısı
Bash({
  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend codex resume <SESSION_ID> - \"$PWD\" <<'EOF'
ROLE_FILE: <role prompt path>
<TASK>
Requirement: <enhanced requirement (veya enhance edilmediyse $ARGUMENTS)>
Context: <önceki fazlardan proje context'i ve analiz>
</TASK>
OUTPUT: Expected output format
EOF",
  run_in_background: false,
  timeout: 3600000,
  description: "Brief description"
})

Role Prompts:

Phase Codex
Analysis ~/.claude/.ccg/prompts/codex/analyzer.md
Planning ~/.claude/.ccg/prompts/codex/architect.md
Review ~/.claude/.ccg/prompts/codex/reviewer.md

Session Reuse: Her çağrı SESSION_ID: xxx döndürür, sonraki fazlar için resume xxx kullan. Phase 2'de CODEX_SESSION kaydet, Phase 3 ve 5'te resume kullan.


İletişim Yönergeleri

  1. Yanıtlara mode etiketi [Mode: X] ile başla, ilk [Mode: Research]
  2. Katı sıra takip et: Research → Ideation → Plan → Execute → Optimize → Review
  3. Gerektiğinde kullanıcı etkileşimi için AskUserQuestion tool kullan (örn., onay/seçim/approval)

Ana İş Akışı

Phase 0: Prompt Enhancement (İsteğe Bağlı)

[Mode: Prepare] - ace-tool MCP mevcutsa, mcp__ace-tool__enhance_prompt çağır, orijinal $ARGUMENTS'ı sonraki Codex çağrıları için enhanced sonuçla değiştir. Mevcut değilse, $ARGUMENTS'ı olduğu gibi kullan.

Phase 1: Research

[Mode: Research] - Requirement'ları anla ve context topla

  1. Code Retrieval (ace-tool MCP mevcutsa): Mevcut API'leri, veri modellerini, servis mimarisini almak için mcp__ace-tool__search_context çağır. Mevcut değilse, built-in tool'ları kullan: dosya keşfi için Glob, sembol/API araması için Grep, context toplama için Read, daha derin keşif için Task (Explore agent).
  2. Requirement tamamlılık skoru (0-10): >=7 devam et, <7 dur ve tamamla

Phase 2: Ideation

[Mode: Ideation] - Codex liderliğinde analiz

Codex'i MUTLAKA çağır (yukarıdaki çağrı spesifikasyonunu takip et):

  • ROLE_FILE: ~/.claude/.ccg/prompts/codex/analyzer.md
  • Requirement: Enhanced requirement (veya enhance edilmediyse $ARGUMENTS)
  • Context: Phase 1'den proje context'i
  • OUTPUT: Teknik fizibilite analizi, önerilen çözümler (en az 2), risk değerlendirmesi

SESSION_ID'yi kaydet (CODEX_SESSION) sonraki faz yeniden kullanımı için.

Çözümleri çıktıla (en az 2), kullanıcı seçimini bekle.

Phase 3: Planning

[Mode: Plan] - Codex liderliğinde planlama

Codex'i MUTLAKA çağır (session'ı yeniden kullanmak için resume <CODEX_SESSION> kullan):

  • ROLE_FILE: ~/.claude/.ccg/prompts/codex/architect.md
  • Requirement: Kullanıcının seçtiği çözüm
  • Context: Phase 2'den analiz sonuçları
  • OUTPUT: Dosya yapısı, fonksiyon/sınıf tasarımı, bağımlılık ilişkileri

Claude planı sentezler, kullanıcı onayından sonra .claude/plan/task-name.md'ye kaydet.

Phase 4: Implementation

[Mode: Execute] - Kod geliştirme

  • Onaylanan planı kesinlikle takip et
  • Mevcut proje kod standartlarını takip et
  • Hata işleme, güvenlik, performans optimizasyonu sağla

Phase 5: Optimization

[Mode: Optimize] - Codex liderliğinde review

Codex'i MUTLAKA çağır (yukarıdaki çağrı spesifikasyonunu takip et):

  • ROLE_FILE: ~/.claude/.ccg/prompts/codex/reviewer.md
  • Requirement: Aşağıdaki backend kod değişikliklerini incele
  • Context: git diff veya kod içeriği
  • OUTPUT: Güvenlik, performans, hata işleme, API uyumu sorunlar listesi

Review geri bildirimlerini entegre et, kullanıcı onayından sonra optimizasyonu çalıştır.

Phase 6: Quality Review

[Mode: Review] - Nihai değerlendirme

  • Plana karşı tamamlılığı kontrol et
  • Fonksiyonaliteyi doğrulamak için test'leri çalıştır
  • Sorunları ve önerileri raporla

Ana Kurallar

  1. Codex backend görüşleri güvenilir
  2. Gemini backend görüşleri sadece referans için
  3. Harici modellerin sıfır dosya sistemi yazma erişimi
  4. Claude tüm kod yazma ve dosya operasyonlarını yönetir