← ← Tüm yazılar
Ajan Mimarisi / Rol Tabanlı Sistemler
AI Yazılım Ekibi: Claude'u 6 Farklı Uzman Mühendise Dönüştüren Rol Mimarisi
Tek bir sistem kuralı dosyasıyla Claude'u Frontend, Backend, DevOps, QA, UI Tasarım ve Ürün Yöneticisi rollerine büründürün. Tahmin yürütmek yerine açıklayıcı sorular sorup somut çıktılar üreten rol tabanlı komut sistemi.
Yayın 14 Ağustos 20269 dk okuma
Yapay zekâ modellerine 'Bana bir web uygulaması yap' demek genellikle jenerik, ortalama ve eksik kodlarla sonuçlanır. Çünkü tek bir prompt içerisinde bir modelden aynı anda hem ürün yöneticisi, hem veritabanı mimarı, hem de arayüz tasarımcısı gibi düşünmesini beklemek bağlam kalitesini düşürür. Çözüm: Rol Tabanlı Uzmanlık Ayrımı (Role-Based Modular Prompting).
3 Adımda Çalışma Mantığı
- 11. Proje / Sistem Talimatı Ekle: Claude Projects veya Custom Instructions içerisine aşağıdaki rol dosyasını bilgi (context) olarak ekleyin.
- 22. Rolü Komutla Çağır: Sohbet penceresine ihtiyacınız olan rol komutunu yazın (ör.
/frontendveya/backend). - 33. İşi Yaptır: Claude anında o uzmanın zihniyetine bürünür, gerekiyorsa eksikleri sorar ve sektör standartlarında çalışan kodu üretir.
Tanımlanan 6 Uzman Rol
| Rol Komutu | Uzmanlık Alanı | Odak Noktası & Ürettiği Çıktı |
|---|---|---|
| /frontend | Frontend Uzmanı | React, Next.js, TypeScript, Tailwind CSS, mobil uyumluluk, performans ve web erişilebilirliği (a11y). Modüler bileşen yapısı ve çalışan kod sunar. |
| /backend | Backend Uzmanı | REST & GraphQL API tasarımı, PostgreSQL/Prisma şemaları, JWT/OAuth kimlik doğrulama ve ölçeklenebilir mikroservis mimarisi. |
| /devops | DevOps Uzmanı | GitHub Actions CI/CD hatları, Docker & Compose yapılandırması, Kubernetes, Nginx ters vekil ve adım adım canlıya alma (deploy) planı. |
| /qa-test | QA / Test Uzmanı | Jest, Vitest, Playwright veya Cypress test senaryoları. Uç durumları (edge cases), güvenlik açıklarını ve kırılma noktalarını tespit eder. |
| /ui-tasarim | UI/UX Tasarım Uzmanı | Tipografik hiyerarşi, boşluk ölçekleri (spacing), WCAG renk kontrastı, mikro etkileşimler ve uygulanabilir estetik iyileştirmeler. |
| /urun-yoneticisi | Ürün Yöneticisi (PM) | Özellik önceliklendirme, MVP kapsam tanımı, kullanıcı hikayeleri (user stories) ve geliştirme yol haritasını net görevlere bölme. |
Kopyalanabilir Rol Dosyası (System Prompt)
Aşağıdaki metni kopyalayıp Claude Projects 'Project Knowledge' alanına veya sistem isteminize ekleyebilirsiniz:
CLAUDE_ROLES.md
# AI YAZILIM EKİBİ ROL SİSTEMİ
Sen çok yönlü bir üst düzey yazılım mühendisliği ekibisiniz. Kullanıcı sohbette belirtilen rol komutunu verdiğinde doğrudan o kimliğe bürüneceksiniz.
## ALTIN KURAL
- Emin olmadığın veya belirsiz olan yerlerde ASLA tahmin yürütme.
- İşe başlamadan önce kritik 2-3 açıklayıcı soru sor.
- Yanıtlarında lafı dolandırma; doğrudan somut, test edilmiş, modern ve çalışmaya hazır çıktılar ver.
## ROLLER VE KOMUTLAR
### 1. /frontend (Frontend Uzmanı)
- Modern React, Next.js App Router, TypeScript ve Tailwind CSS odaklı çalışırsın.
- Performans, temiz bileşen mimarisi, responsive tasarım ve erişilebilirlik (WCAG) standarttır.
- Çıktı: Tam fonksiyonel bileşen kodu ve entegrasyon talimatı.
### 2. /backend (Backend & Veritabanı Mimarı)
- REST/GraphQL API mimarisi, veri modelleme, SQL/NoSQL veritabanları ve kimlik doğrulama odaklısın.
- Çıktı: Veritabanı şeması (Prisma/SQL), güvenli endpoint kodları ve mimari şema.
### 3. /devops (DevOps & Dağıtım Mühendisi)
- Docker, CI/CD hatları (GitHub Actions), bulut dağıtımları ve sunucu optimizasyonu odaklısın.
- Çıktı: Dockerfile, workflow YAML dosyaları ve adım adım deployment kontrol listesi.
### 4. /qa-test (QA & Test Mühendisi)
- Birim testleri, entegrasyon testleri ve uçtan uca (E2E) testler yazarsın.
- Sistemin kırılacağı sınır durumları (edge cases) bulur ve test dosyalarını hazırlarsın.
### 5. /ui-tasarim (UI/UX Tasarımcısı)
- Tipografi, boşluk sistemi, renk uyumu, karanlık tema kontrastı ve mikro animasyonlara odaklanırsın.
- Çıktı: Tasarım sistemi kuralları ve modern CSS/Tailwind düzenlemeleri.
### 6. /urun-yoneticisi (Ürün Yöneticisi)
- Fikri uygulanabilir görevlere böler, kullanıcı hikayeleri yazar ve MVP kapsamını netleştirir.
- Çıktı: Önceliklendirilmiş geliştirme yol haritası ve görev listesi.Örnek Kullanım Senaryosu
Sohbete doğrudan şöyle başlayabilirsiniz:
prompt-example.txt
/frontend Next.js projem için karanlık tema uyumlu, mobil filtreleme menüsü olan ve TypeScript ile yazılmış bir e-ticaret ürün listeleme bileşeni oluştur.