architecture-review

⚡ Vibe Coder Kit

AI Destekli Profesyonel Yazılım Geliştirme Agent Framework'ü

AI kod asistanını disiplinli, süreç odaklı bir geliştirme ekibine dönüştürün.

---

🎯 Vibe Coder Kit Nedir?

Vibe Coder Kit, AI kod asistanlarını (ör. OpenCode) yapılandırılmış, süreç odaklı bir geliştirme ekibine dönüştüren yapılandırma odaklı bir agent framework'üdür. Anlık prompt yazmak yerine, şunlara sahip olursunuz:

• 🤖 4 Uzman Agent Personalası — Tasarımcı, Frontend Geliştirici, Backend Geliştirici, DevOps
• 🛠️ 12 Kanıtlanmış Skill — Fikir üretiminden kriz yönetimine yapılandırılmış iş akışları
• 📏 3 Kural Seti — Kod hijyeni, kalite ve güvenlik standartları
• 🧠 Kalıcı Bilgi Tabanı — Oturumlar arası bilgi paylaşımı, tekrarlanan hataları önler

"Çalışıyor" ≠ "Bitti". Testler geçiyor + temiz kod + dokümantasyon güncel = bitti.

---

✨ Öne Çıkan Özellikler

🎭 Agent Personalaları

🛠️ Skill'ler (Yapılandırılmış İş Akışları)

📏 Kurallar (Zorunlu Standartlar)

---

🚀 Kurulum ve Kullanım

Vibe Coder Kit'i iki şekilde kullanabilirsiniz: mevcut projenize entegre ederek veya yeni bir proje olarak başlatarak.

Yöntem 1: Mevcut Projenize Entegre Etme (Önerilen)

Mevcut bir projeniz varsa, sadece agent yapılandırma dosyalarını projenize kopyalayın:

# 1. Repoyu indirin (geçici bir klasöre)
git clone https://github.com/omergocmen/vibe-coder-kit.git /tmp/vibe-coder-kit

# 2. .agent dizinini projenize kopyalayın
cp -r /tmp/vibe-coder-kit/.agent /projenizin/yolu/

# 3. OpenCode yapılandırma dosyasını kopyalayın
cp /tmp/vibe-coder-kit/opencode.json /projenizin/yolu/

# 4. AGENTS.md dosyasını kopyalayın (OpenCode bunu otomatik okur)
cp /tmp/vibe-coder-kit/AGENTS.md /projenizin/yolu/

# 5. Geçici dosyaları temizleyin
rm -rf /tmp/vibe-coder-kit

# 6. Proje dizinine gidin
cd /projenizin/yolu

Windows (PowerShell) kullanıcıları:

# 1. Repoyu indirin
git clone https://github.com/omergocmen/vibe-coder-kit.git "$env:TEMP\vibe-coder-kit"

# 2. .agent dizinini projenize kopyalayın
Copy-Item -Recurse "$env:TEMP\vibe-coder-kit\.agent" "C:\projenizin\yolu\.agent"

# 3. Yapılandırma dosyalarını kopyalayın
Copy-Item "$env:TEMP\vibe-coder-kit\opencode.json" "C:\projenizin\yolu\"
Copy-Item "$env:TEMP\vibe-coder-kit\AGENTS.md" "C:\projenizin\yolu\"

# 4. Geçici dosyaları temizleyin
Remove-Item -Recurse "$env:TEMP\vibe-coder-kit"

Yöntem 2: Yeni Proje Olarak Başlatma

Sıfırdan yeni bir proje başlatıyorsanız, repoyu doğrudan klonlayıp üzerine inşa edin:

# Repoyu klonlayın
git clone https://github.com/omergocmen/vibe-coder-kit.git benim-projem
cd benim-projem

# Artık .agent/, opencode.json ve AGENTS.md hazır
# Kendi kodunuzu bu dizin yapısının üzerine ekleyin

İndirdikten Sonra Ne Yapmalısınız?

1. OpenCode kurun — Henüz kurmadıysanız:

   # npm ile global kurulum
   npm install -g opencode
   
   # veya doğrudan çalıştırın
   npx opencode
   

2. Proje dizininde OpenCode'u başlatın:

   cd /projenizin/yolu
   opencode
   

3. İlk oturumda OpenCode otomatik olarak AGENTS.md dosyasını okuyacak ve project-context-primer skill'ini çalıştıracaktır. Agent size proje hakkında sorular soracak ve bağlamı yükleyecektir.

4. Bilgi tabanını başlatın — İlk oturumda .agent/knowledge/INDEX.md dosyası oluşturulur. Bundan sonra tüm kararlar, kurallar ve tuzaklar otomatik olarak kaydedilir.

Yapıyı Özelleştirme

Projenize özel özelleştirmeler yapabilirsiniz:

• Agent personalarını düzenleyin: .agent/agents/ dizinindeki dosyaları projenizin ihtiyacına göre değiştirin
• Yeni skill ekleyin: .agent/skills/yeni-skill/SKILL.md oluşturun
• Kuralları sıkılaştırın: .agent/rules/ dizinindeki dosyaları düzenleyin
• Gereksiz agent'ları kaldırın: Örneğin sadece backend geliştirme yapıyorsanız, designer.md ve frontend-dev.md dosyalarını silebilirsiniz

---

📁 Proje Yapısı

vibe-coder-kit/
├── AGENTS.md                          # Oturum başlatma talimatları (OpenCode tarafından otomatik okunur)
├── opencode.json                      # OpenCode yapılandırma dosyası
├── .agent/
│   ├── agents/                        # Uzman personaları
│   │   ├── designer.md                # Aria — UI/UX ve motion design
│   │   ├── frontend-dev.md            # Felix — Frontend mühendisliği
│   │   ├── backend-dev.md             # Bora — Backend ve sistemler
│   │   └── devops.md                  # Deva — Altyapı ve operasyonlar
│   ├── skills/                        # Yapılandırılmış iş akışları
│   │   ├── project-context-primer/    # Oturum başlatma (zorunlu)
│   │   ├── prompt-enhancer/           # İstek netleştirme
│   │   ├── brainstorming/             # Sokratik tasarım rafinasyonu
│   │   ├── writing-plans/             # İmplementasyon planlama
│   │   ├── architecture-review/       # Plan stres testi
│   │   ├── test-driven-execution/     # TDD iş akışı
│   │   ├── code-review/               # Commit öncesi inceleme
│   │   ├── github/                    # Git işlemleri ve commit'ler
│   │   ├── knowledge-base-update/     # Kalıcı bellek
│   │   ├── documentation-sync/        # Dokümantasyon senkronizasyonu
│   │   ├── dependency-audit/          # Güvenlik taraması
│   │   └─