🎯 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ı
│   │   └── incident-response/         # Kriz yönetimi
│   ├── rules/                         # Zorunlu standartlar
│   │   ├── code-hygiene.md            # Temiz kod kuralları
│   │   ├── code-quality.md            # DRY ve soyutlama kuralları
│   │   └── safety.md                  # Yıkıcı işlem güvenlikleri
│   └── knowledge/                     # Oturumlar arası bellek (otomatik doldurulur)
├── .kilo/                             # Planlama çalışma alanı
│   └── plans/
├── LICENSE
└── README.md

🔄 Geliştirme İş Akışı

🆕 YENİ OTURUM
  └─ project-context-primer (zorunlu)

💡 FİKİR     → brainstorming → SCOPE-<slug>.md
📋 PLAN      → writing-plans → implementation_plan.md → architecture-review
🛠️ GELİŞTİR  → test-driven-execution
✅ KOMİT     → code-review → github skill (conventional commits)

Örnek Akış

1. Oturum başlat → project-context-primer bağlamı yükler
2. Özelliği tanımla → brainstorming bir scope dokümanı üretir
3. İmplementasyonu planla → writing-plans checkpoint'li plan oluşturur
4. Mimariyi incele → architecture-review planı stres testine tabi tutar
5. Geliştir → test-driven-execution ile implementasyon yapılır
6. Kodu incele → code-review pre-commit checklist çalıştırır
7. Commit ve push → github skill conventional commits ve PR'ları yönetir

🧠 Bilgi Kalıcılığı

En güçlü özelliklerden biri. Her önemli karar, tuzak, kural ve bug köken nedeni .agent/knowledge/ dizininde saklanır ve oturum başlangıcında otomatik yüklenir:

🤝 Uyumluluk

OpenCode için geliştirilmiştir, ancak kavramlar taşınabilir:

📋 Conventional Commits

Bu kit Conventional Commits standardını uygular:

feat(auth): add refresh token rotation
fix(userService): handle null email in validation
refactor(Button): extract loading state to hook
docs(readme): update installation instructions
chore(deps): upgrade react to 19.2.0

🌐 Dil Tercihi

Tüm agent talimatları, kurallar ve skill dokümantasyonu Türkçe yazılmıştır. İngilizce frontmatter ile birlikte sunulur. Bu Türkçe konuşan geliştirme ekipleri için bilinçli bir tercihtir. Çeviri katkılarına açığız.

🤝 Katkıda Bulunmak

Katkılar memnuniyetle karşılanır! Mevcut yapıyı takip edin:

1. Repo'yu fork edin
2. Özellik branch'i oluşturun: feat/yeni-ozellik
3. Mevcut skill/agent/rule yapısına uygun değişiklik yapın
4. Pull request gönderin

Yeni Skill Eklemek

.agent/skills/skill-adi/SKILL.md dosyası oluşturun:

---
name: skill-adi
description: >
  Bu skill ne zaman kullanılır ve ne üretir.
---

# Skill Adı

## Ne Zaman Tetiklenir
## Adım Adım Süreç
## Kurallar

Yeni Agent Personalası Eklemek

.agent/agents/agent-adi.md dosyası oluşturun:

# Agent: Agent Adı

## Kimlik
## Uzmanlık Alanları
## Çalışma Metodolojisi
## Kod Standartları
## Asla Yapma
## Kullanılan Skill'ler

📄 Lisans

Bu proje MIT Lisansı ile lisanslanmıştır. Detaylar için LICENSE dosyasına bakın.

🌟 Destek

Bu kit geliştirme iş akışınızı iyileştirdiyse:

• ⭐ Bu repo'yu star'layın
• 🐛 Sorunları bildirin (Issues sekmesi)
• 💡 Yeni skill veya agent personalası önerin
• 🔀 Pull request gönderin