Cline ve Roo Code Açık Kaynak Kodlama Ajanları: Memory Bank Mimarisi, .roomodes Özel Modları ve En Popüler 10 Mühendislik Skill’i

Açık Kaynak Kodlama Ajanlarında Mimari Dönüşüm: Neden .clinerules, Memory Bank ve .roomodes Şart?

Visual Studio Code üzerinde çalışan açık kaynaklı otonom kodlama ajanları Cline ve Roo Code, geliştiricilere herhangi bir bulut veya yerel dil modelini (Anthropic Claude, OpenAI, Google Gemini, DeepSeek, Meta Muse Glimmer veya yerel Ollama/vLLM modelleri) doğrudan IDE araçlarıyla (dosya okuma/yazma, terminal yürütme, headless tarayıcı ve MCP sunucuları) birleştirme özgürlüğü sunmaktadır.

Ancak yüzlerce mikroservisten veya karmaşık katmanlardan oluşan kurumsal projelerde ajanları yapılandırmasız kullanmak üç temel mühendislik darboğazına neden olur:

1. Oturumlar Arası Hafıza Kaybı (Context Amnesia): Bir sohbet penceresi bağlam sınırına ulaşıp kapatıldığında, ajanın proje mimarisi ve devam eden işler hakkındaki tüm içgörüsü silinir.
2. Aşırı Yetkilendirme ve Kural İhlali: Tek bir genel modun hem mimari tasarım yapması hem de aynı anda üretim dosyalarını değiştirmesi, planlanmamış yan etkilere ve derleme kırılmalarına yol açar.
3. Doğrusal Token Maliyeti: Basit bir CSS düzeltmesi veya birim testi için bile en pahalı sınır modelin (frontier model) dev bir bağlam penceresiyle çağrılması mühendislik bütçesini hızla tüketir.

Bu kapsamlı rehberde; Cline Memory Bank mimarisi, Roo Code .roomodes (Özel Modlar & Boomerang Orkestrasyonu) yapısı ve üretim ortamında en çok kullanılan 10 otonom mühendislik skill’i kod şablonlarıyla incelenmektedir.

1. Skill #1: Sıfır Bağlam Kaybı Sağlayan Memory Bank Mimarisi (memory-bank/)

Cline ve Roo Code topluluğunun standartlaştırdığı Memory Bank deseni, ajanın geçici sohbet geçmişine güvenmek yerine proje kök dizinindeki memory-bank/ klasöründe tutulan 6 hiyerarşik Markdown dosyasını tek gerçeklik kaynağı (Single Source of Truth) olarak kullanmasını sağlar:

1. projectbrief.md (Temel Vizyon): Projenin kapsamını, iş hedeflerini ve değişmez çekirdek gereksinimlerini tanımlar.
2. productContext.md (Ürün Bağlamı): Sistemin hangi problemi çözdüğünü ve kullanıcı deneyimi akışlarını açıklar.
3. systemPatterns.md (Mimari Desenler): Katmanlı mimari kurallarını, servisler arası iletişim protokollerini, veritabanı şema ilkelerini ve tasarım desenlerini belgeler.
4. techContext.md (Teknoloji Yığını): Kullanılan dil sürümlerini, çerçeveleri, derleme komutlarını ve ortam kısıtlamalarını listeler.
5. activeContext.md (Canlı Odak): En sık değişen dosyadır; o an üzerinde çalışılan özelliği, son yapılan değişiklikleri ve bir sonraki somut adımı tutar.
6. progress.md (İlerleme Kaydı): Tamamlanan modülleri, kalan iş paketlerini ve bilinen teknik borçları izler.

Proje kök dizinine yerleştirilen .clinerules (veya .roo/rules/01-memory-bank.md) dosyası, ajanı her görev başında bu dosyaları okumaya ve görev sonunda güncellemeye zorlar:

# .clinerules — Otonom Memory Bank İşletim Protokolü

## 1. Zorunlu Başlangıç Okuması (Session Initialization)
Her yeni görev başladığında herhangi bir kod dosyasına dokunulmadan önce `memory-bank/` dizinindeki 6 çekirdek dosya (`projectbrief.md`, `productContext.md`, `systemPatterns.md`, `techContext.md`, `activeContext.md`, `progress.md`) eksiksiz okunur.

## 2. Mimari Tutarlılık
Üretilen tüm kodlar `systemPatterns.md` içindeki katman sınırlarına ve `techContext.md` içindeki kütüphane sürümlerine %100 uymak zorundadır.

## 3. Görev Sonu Senkronizasyonu (Context Flush)
Bir alt görev tamamlandığında veya bağlam penceresi %70 doluluğa ulaştığında:
- Son yapılan mimari değişiklikler ve sıradaki adım `memory-bank/activeContext.md` dosyasına işlenir.
- Tamamlanan kontrol listesi maddeleri `memory-bank/progress.md` içinde güncellenir.

2. Skill #2 & #3: .roomodes Özel Ajan Modları, Boomerang Orchestrator ve Hibrit Model Yönlendirme

Roo Code, .roomodes yapılandırma dosyası aracılığıyla her biri farklı araç izinlerine (groups: read, edit, browser, command, mcp) ve dosya düzenleme filtrelerine (fileRegex) sahip uzman ajan modları tanımlanmasına olanak tanır.

Bunun üzerine inşa edilen Boomerang Orchestrator (new_task) deseni ise tek bir devasa bağlam penceresi kullanmak yerine işi uzman alt modlara fırlatır (boomerang). Her alt görev kendi izole ve temiz bağlam penceresinde çalışır, işini bitirir ve yalnızca kısa sonuç raporunu üst orkestratöre geri döndürür.

Aşağıdaki üretim seviyesi .roomodes dosyası; Orchestrator, Architect, Code, Debug, Security ve Documentation modlarını en az ayrıcalık ilkesiyle (Principle of Least Privilege) yapılandırır:

{
  "customModes": [
    {
      "slug": "orchestrator",
      "name": "🎯 Boomerang Orchestrator",
      "roleDefinition": "Karmaşık yazılım hedeflerini analiz eden ve new_task aracıyla uzman alt modlara (architect, code, debug, security, docs) delege eden stratejik iş akışı yöneticisi.",
      "groups": [
        "read",
        [
          "edit",
          {
            "fileRegex": "^memory-bank/.*\\.md$",
            "description": "Yalnızca Memory Bank durum dosyalarını güncelleyebilir."
          }
        ]
      ],
      "customInstructions": "Doğrudan uygulama kodu yazılmaz. Görev mantıksal fazlara bölünür, uygun uzman moda new_task ile devredilir ve dönen özetler memory-bank/activeContext.md içine kaydedilir."
    },
    {
      "slug": "architect",
      "name": "🏛️ System Architect",
      "roleDefinition": "Sistem mimarisi, veri akışı, API sözleşmeleri ve refactor planlamasından sorumlu baş mimar modu.",
      "groups": [
        "read",
        "browser",
        "mcp",
        [
          "edit",
          {
            "fileRegex": "\\.(md|mmd|openapi\\.yaml|json)$",
            "description": "Yalnızca mimari dokümanları, Mermaid şemalarını ve OpenAPI sözleşmelerini düzenleyebilir."
          }
        ]
      ],
      "customInstructions": "Kaynak kod (.ts, .java, .py) dosyaları değiştirilmez. Önce mevcut bağımlılıklar incelenir ve memory-bank/systemPatterns.md ile uyumlu teknik uygulama planı üretilir."
    },
    {
      "slug": "security-auditor",
      "name": "🛡️ Security & CVE Auditor",
      "roleDefinition": "Bağımlılık zafiyetlerini (CVE), IDOR, SSRF, XSS ve gömülü sırları tarayan salt-okunur siber güvenlik denetçisi.",
      "groups": [
        "read",
        "command",
        "mcp"
      ],
      "customInstructions": "Hiçbir kaynak dosya doğrudan düzenlenmez (salt-okunur mod). Güvenlik tarama araçları çalıştırılır, zafiyetler kanıtlarıyla raporlanır ve düzeltme görevi Orchestrator üzerinden Code moduna iletilir."
    },
    {
      "slug": "docs-agent",
      "name": "📚 Autonomous Documentation Agent",
      "roleDefinition": "Kod tabanındaki değişiklikleri README, API referansı ve Memory Bank dosyalarıyla eşitleyen dokümantasyon uzmanı.",
      "groups": [
        "read",
        [
          "edit",
          {
            "fileRegex": "\\.(md|mdx)$",
            "description": "Yalnızca Markdown dokümantasyon dosyalarını düzenleyebilir."
          }
        ]
      ],
      "customInstructions": "Son commit ve kod değişiklikleri analiz edilerek mimari diyagramlar ve dokümanlar güncellenir."
    }
  ]
}

Görev Karmaşıklığına Göre Hibrit Model Yönlendirme (Maliyet Optimizasyonu)

Roo Code her özel mod için farklı bir API profili (Model Profile) atanmasını destekler. Bu sayede:

• Orchestrator & Architect Modları: Derin sistem tasarımı için yüksek akıl yürütme kapasiteli sınır modellere (Claude Opus / Sonnet, OpenAI o3/GPT-5 veya Gemini Pro) bağlanır.
• Code, Debug & Docs Modları: Sınırları zaten Architect tarafından çizilmiş alt görevleri yürüttüğü için yüksek hızlı ve düşük maliyetli modellere (DeepSeek V3/R1, Qwen 3.6 Coder veya yerel GPU’da çalışan Meta Muse Glimmer 30B) yönlendirilir. Bu hibrit mimari toplam token faturasını %60 ila %70 oranında düşürür.

3. Üretim Kalitesini Katlayan Diğer 7 Kritik Mühendislik Skill’i (Skill #4 – #10)

Skill #4: Tarayıcı Otomasyonu (Headless Browser) ile Görsel UI ve Konsol Testi

Cline ve Roo Code’un browser araç grubu, arka planda gerçek bir Chromium oturumu açarak geliştirilen arayüzü bizzat test eder. Bu skill etkinleştirildiğinde ajan; http://localhost:3000 adresine gider, butonlara tıklar, her adımda ekran görüntüsü (screenshot) alır ve tarayıcı konsolundaki (console.error) React/hidratasyon hatalarını veya CSS taşmalarını görsel olarak teşhis edip kaynak kodu kendi kendine onarır.

Skill #5: Özel MCP (Model Context Protocol) Araç Geliştirme Skill’i

Ajanın tekrarlayan bir kurumsal iş akışına (ör. şirket içi Jira/Linear biletlerini okuma, PostgreSQL şemasını sorgulama veya Sentry loglarını çekme) ihtiyacı olduğunda, MCP Geliştirme Skill’i devreye girer. Ajan, @modelcontextprotocol/sdk kullanarak yeni bir MCP sunucusu yazar, derler ve IDE’nin mcp_settings.json dosyasına kaydederek kendi yetenek setini otonom olarak genişletir.

Skill #6: Büyük Ölçekli Refactor Planlayıcı (Plan / Act & AST Analizi)

Cline’ın Plan / Act ayrımı ve Roo Code’un Architect -> Code geçişi üzerine kurulan bu skill, 50+ dosyayı etkileyen isimlendirme veya mimari katman dönüşümlerinde doğrudan dosya değiştirmeyi yasaklar. Önce tüm referans ağacı (search_files / list_code_definition_names) çıkarılır, etki matrisi oluşturulur ve her dosya grubu derleme doğrulamasıyla adım adım dönüştürülür.

Skill #7: Uçtan Uca API Entegrasyon ve Sözleşme (Contract) Doğrulayıcı

Backend mikroservislerindeki DTO/Entity tanımları ile Frontend/Mobil istemcilerdeki TypeScript arayüzleri arasındaki sözleşme kaymalarını (contract drift) yakalar. Backend’de bir alan adı veya enum değeri değiştiğinde tüm istemci tiplerini ve API çağrı noktalarını tarayarak çalışma zamanı beyaz ekran hatalarını önler.

Skill #8: Bağımlılık Güvenlik Denetçisi (CVE & Sır Tarama)

security-auditor modunda çalışan bu skill; npm audit, pip-audit, trivy veya osv-scanner komutlarını yürüterek package-lock.json, pom.xml ve requirements.txt içindeki kritik CVE açıklarını tespit eder. Ayrıca kaynak kodda unutulmuş API anahtarlarını ve yetkilendirme eksiklerini (IDOR) raporlar.

Skill #9: Çok Aşamalı Docker ve Kubernetes Manifest Üretici

Projenin çalışma zamanı gereksinimlerini (techContext.md) okuyarak; önbellek dostu çok aşamalı (multi-stage), non-root kullanıcıyla çalışan minimal Dockerfile, yerel geliştirme için docker-compose.yml ve üretim kümesi için Deployment, Service, Ingress ve HorizontalPodAutoscaler (HPA) Kubernetes manifestlerini sıfır sözdizimi hatasıyla üretir.

Skill #10: Otonom Dokümantasyon Ajanı (fileRegex: "\\.(md|mdx)$")

Yazma izni fileRegex ile yalnızca Markdown dosyalarına kilitlenmiş olan bu mod, her özellik geliştirme turunun sonunda Boomerang Orchestrator tarafından otomatik olarak çağrılır. Değişen API uç noktalarını README.md dosyasına işler, Mermaid mimari diyagramlarını günceller ve memory-bank/progress.md dosyasını senkronize eder.

4. Cline ve Roo Code — 10 Mühendislik Skill’i Karşılaştırma Matrisi

Mimari Değerlendirme

Cline ve Roo Code, açık kaynak dünyasında kodlama ajanlarının yalnızca "kod tamamlayıcı" olmaktan çıkıp kendi hafızasını yöneten (Memory Bank), kendi yetki sınırlarını koruyan (.roomodes & fileRegex) ve kendi alt ajanlarını orkestre eden (Boomerang Tasks) deterministik sistemlere dönüştüğünü kanıtlamaktadır. Yukarıdaki 10 mühendislik skill’ini proje dizinine entegre eden yazılım ekipleri, hem bulut/yerel model maliyetlerini optimize etmekte hem de kurumsal mimari standartlarını her satır kodda otomatik olarak güvence altına almaktadır.