Skip to content
Back to search

vibe-coder-kit

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

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/omergocmen--vibe-coder-kit/badge.svg)](/listings/omergocmen--vibe-coder-kit)

HTML

<a href="/listings/omergocmen--vibe-coder-kit"><img src="/api/listings/omergocmen--vibe-coder-kit/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 349 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. # ⚡ Vibe Coder Kit
  3. **AI Destekli Profesyonel Yazılım Geliştirme Agent Framework'ü**
  4. *AI kod asistanını disiplinli, süreç odaklı bir geliştirme ekibine dönüştürün.*
  5. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
  6. [![OpenCode Compatible](https://img.shields.io/badge/OpenCode-Compatible-purple.svg)](https://opencode.ai)
  7. [![PRs Welcome](https://img.shields.io/badge/PRs-Welcome-brightgreen.svg)](#katkıda-bulunmak)
  8. </div>
  9. ---
  10. ## 🎯 Vibe Coder Kit Nedir?
  11. Vibe Coder Kit, AI kod asistanlarını (ör. [OpenCode](https://opencode.ai)) 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:
  12. - 🤖 **4 Uzman Agent Personalası** — Tasarımcı, Frontend Geliştirici, Backend Geliştirici, DevOps
  13. - 🛠️ **12 Kanıtlanmış Skill** — Fikir üretiminden kriz yönetimine yapılandırılmış iş akışları
  14. - 📏 **3 Kural Seti** — Kod hijyeni, kalite ve güvenlik standartları
  15. - 🧠 **Kalıcı Bilgi Tabanı** — Oturumlar arası bilgi paylaşımı, tekrarlanan hataları önler
  16. > **"Çalışıyor" ≠ "Bitti".** Testler geçiyor + temiz kod + dokümantasyon güncel = bitti.
  17. ---
  18. ## ✨ Öne Çıkan Özellikler
  19. ### 🎭 Agent Personalaları
  20. | Agent | İsim | Uzmanlık Alanı |
  21. |-------|------|---------------|
  22. | 🎨 **Tasarımcı** | Aria | UI/UX, motion design, tasarım sistemleri, erişilebilirlik |
  23. | 💻 **Frontend** | Felix | React/Vue, CSS mimarisi, performans, Core Web Vitals |
  24. | ⚙️ **Backend** | Bora | API tasarımı, veritabanları, auth, güvenlik, mikroservisler |
  25. | 🚀 **DevOps** | Deva | Docker, CI/CD, cloud altyapı, izleme, kriz yönetimi |
  26. <!-- Her agent, kendi alanında senior seviye uzman olarak tasarlanmıştır. Detaylı bilgi için .agent/agents/ dizinine bakabilirsiniz. -->
  27. ### 🛠️ Skill'ler (Yapılandırılmış İş Akışları)
  28. | Skill | Ne Zaman Kullanılır | Ne Yapar |
  29. |-------|---------------------|----------|
  30. | `project-context-primer` | Her oturum başında *(zorunlu)* | Proje bağlamını, kararları ve tuzakları yükler |
  31. | `prompt-enhancer` | Belirsiz veya eksik istekler | Kapsamı netleştirir, eksik boyutları tamamlar |
  32. | `brainstorming` | Yeni özellik veya proje fikirleri | Sokratik yöntemle rafine eder → scope dokümanı üretir |
  33. | `writing-plans` | Scope onayından sonra | Checkpoint'li implementasyon planı oluşturur |
  34. | `architecture-review` | Kod yazmaya başlamadan önce | Planı stres testine tabi tutar, riskleri işaretler |
  35. | `test-driven-execution` | Her özellik implementasyonunda | Test önce, kod sonra yaklaşımı uygular |
  36. | `code-review` | Her commit öncesinde | Pre-commit checklist + geri bildirim yanıtlama |
  37. | `github` | Tüm git işlemlerinde | Conventional commits, branch yönetimi, PR iş akışı |
  38. | `knowledge-base-update` | Önemli bir şey öğrenildiğinde | Oturumlar arası kalıcı bilgi depolama |
  39. | `documentation-sync` | Önemli kod değişikliklerinden sonra | Dokümantasyon ve kodun uyumunu sağlar |
  40. | `dependency-audit` | Release öncesi / aylık rutin | Güvenlik açıklarını ve eski paketleri tarama |
  41. | `incident-response` | Production sorunlarında | Triyaj → içerme → düzeltme → post-mortem |
  42. <!-- Skill'ler bağımsız olarak kullanılabilir, ancak tam verim için önerilen sırayla çalıştırılmalıdır. -->
  43. ### 📏 Kurallar (Zorunlu Standartlar)
  44. | Kural | Amacı |
  45. |-------|-------|
  46. | `code-hygiene` | Yorum stili, debug log temizliği, hassas veri yönetimi |
  47. | `code-quality` | Aşırı mühendislik yapmadan DRY, soyutlama eşiği |
  48. | `safety` | Yıkıcı komut onayı, rollback planları |
  49. <!-- Kurallar öneri değil, zorunluluktur. Agent bu kuralları her görevde uygular. -->
  50. ---
  51. ## 🚀 Kurulum ve Kullanım
  52. Vibe Coder Kit'i iki şekilde kullanabilirsiniz: **mevcut projenize entegre ederek** veya **yeni bir proje olarak başlatarak**.
  53. ### Yöntem 1: Mevcut Projenize Entegre Etme (Önerilen)
  54. Mevcut bir projeniz varsa, sadece agent yapılandırma dosyalarını projenize kopyalayın:
  55. ```bash
  56. # 1. Repoyu indirin (geçici bir klasöre)
  57. git clone https://github.com/omergocmen/vibe-coder-kit.git /tmp/vibe-coder-kit
  58. # 2. .agent dizinini projenize kopyalayın
  59. cp -r /tmp/vibe-coder-kit/.agent /projenizin/yolu/
  60. # 3. OpenCode yapılandırma dosyasını kopyalayın
  61. cp /tmp/vibe-coder-kit/opencode.json /projenizin/yolu/
  62. # 4. AGENTS.md dosyasını kopyalayın (OpenCode bunu otomatik okur)
  63. cp /tmp/vibe-coder-kit/AGENTS.md /projenizin/yolu/
  64. # 5. Geçici dosyaları temizleyin
  65. rm -rf /tmp/vibe-coder-kit
  66. # 6. Proje dizinine gidin
  67. cd /projenizin/yolu
  68. ```
  69. **Windows (PowerShell) kullanıcıları:**
  70. ```powershell
  71. # 1. Repoyu indirin
  72. git clone https://github.com/omergocmen/vibe-coder-kit.git "$env:TEMP\vibe-coder-kit"
  73. # 2. .agent dizinini projenize kopyalayın
  74. Copy-Item -Recurse "$env:TEMP\vibe-coder-kit\.agent" "C:\projenizin\yolu\.agent"
  75. # 3. Yapılandırma dosyalarını kopyalayın
  76. Copy-Item "$env:TEMP\vibe-coder-kit\opencode.json" "C:\projenizin\yolu\"
  77. Copy-Item "$env:TEMP\vibe-coder-kit\AGENTS.md" "C:\projenizin\yolu\"
  78. # 4. Geçici dosyaları temizleyin
  79. Remove-Item -Recurse "$env:TEMP\vibe-coder-kit"
  80. ```
  81. ### Yöntem 2: Yeni Proje Olarak Başlatma
  82. Sıfırdan yeni bir proje başlatıyorsanız, repoyu doğrudan klonlayıp üzerine inşa edin:
  83. ```bash
  84. # Repoyu klonlayın
  85. git clone https://github.com/omergocmen/vibe-coder-kit.git benim-projem
  86. cd benim-projem
  87. # Artık .agent/, opencode.json ve AGENTS.md hazır
  88. # Kendi kodunuzu bu dizin yapısının üzerine ekleyin
  89. ```
  90. ### İndirdikten Sonra Ne Yapmalısınız?
  91. 1. **[OpenCode](https://opencode.ai) kurun** — Henüz kurmadıysanız:
  92. ```bash
  93. # npm ile global kurulum
  94. npm install -g opencode
  95. # veya doğrudan çalıştırın
  96. npx opencode
  97. ```
  98. 2. **Proje dizininde OpenCode'u başlatın:**
  99. ```bash
  100. cd /projenizin/yolu
  101. opencode
  102. ```
  103. 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.
  104. 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.
  105. ### Yapıyı Özelleştirme
  106. Projenize özel özelleştirmeler yapabilirsiniz:
  107. - **Agent personalarını düzenleyin:** `.agent/agents/` dizinindeki dosyaları projenizin ihtiyacına göre değiştirin
  108. - **Yeni skill ekleyin:** `.agent/skills/yeni-skill/SKILL.md` oluşturun
  109. - **Kuralları sıkılaştırın:** `.agent/rules/` dizinindeki dosyaları düzenleyin
  110. - **Gereksiz agent'ları kaldırın:** Örneğin sadece backend geliştirme yapıyorsanız, `designer.md` ve `frontend-dev.md` dosyalarını silebilirsiniz
  111. <!-- Her projenin ihtiyacı farklıdır. Framework'ü projenize göre özelleştirmekten çekinmeyin. -->
  112. ---
  113. ## 📁 Proje Yapısı
  114. ```
  115. vibe-coder-kit/
  116. ├── AGENTS.md # Oturum başlatma talimatları (OpenCode tarafından otomatik okunur)
  117. ├── opencode.json # OpenCode yapılandırma dosyası
  118. ├── .agent/
  119. │ ├── agents/ # Uzman personaları
  120. │ │ ├── designer.md # Aria — UI/UX ve motion design
  121. │ │ ├── frontend-dev.md # Felix — Frontend mühendisliği
  122. │ │ ├── backend-dev.md # Bora — Backend ve sistemler
  123. │ │ └── devops.md # Deva — Altyapı ve operasyonlar
  124. │ ├── skills/ # Yapılandırılmış iş akışları
  125. │ │ ├── project-context-primer/ # Oturum başlatma (zorunlu)
  126. │ │ ├── prompt-enhancer/ # İstek netleştirme
  127. │ │ ├── brainstorming/ # Sokratik tasarım rafinasyonu
  128. │ │ ├── writing-plans/ # İmplementasyon planlama
  129. │ │ ├── architecture-review/ # Plan stres testi
  130. │ │ ├── test-driven-execution/ # TDD iş akışı
  131. │ │ ├── code-review/ # Commit öncesi inceleme
  132. │ │ ├── github/ # Git işlemleri ve commit'ler
  133. │ │ ├── knowledge-base-update/ # Kalıcı bellek
  134. │ │ ├── documentation-sync/ # Dokümantasyon senkronizasyonu
  135. │ │ ├── dependency-audit/ # Güvenlik taraması
  136. │ │ └── incident-response/ # Kriz yönetimi
  137. │ ├── rules/ # Zorunlu standartlar
  138. │ │ ├── code-hygiene.md # Temiz kod kuralları
  139. │ │ ├── code-quality.md # DRY ve soyutlama kuralları
  140. │ │ └── safety.md # Yıkıcı işlem güvenlikleri
  141. │ └── knowledge/ # Oturumlar arası bellek (otomatik doldurulur)
  142. ├── .kilo/ # Planlama çalışma alanı
  143. │ └── plans/
  144. ├── LICENSE
  145. └── README.md
  146. ```
  147. ---
  148. ## 🔄 Geliştirme İş Akışı
  149. ```
  150. 🆕 YENİ OTURUM
  151. └─ project-context-primer (zorunlu)
  152. 💡 FİKİR → brainstorming → SCOPE-<slug>.md
  153. 📋 PLAN → writing-plans → implementation_plan.md → architecture-review
  154. 🛠️ GELİŞTİR → test-driven-execution
  155. ✅ KOMİT → code-review → github skill (conventional commits)
  156. ```
  157. <!-- Bu iş akışı öneridir. Projenizin ihtiyacına göre adımları atlayabilir veya özelleştirebilirsiniz. -->
  158. ### Örnek Akış
  159. 1. **Oturum başlat** → `project-context-primer` bağlamı yükler
  160. 2. **Özelliği tanımla** → `brainstorming` bir scope dokümanı üretir
  161. 3. **İmplementasyonu planla** → `writing-plans` checkpoint'li plan oluşturur
  162. 4. **Mimariyi incele** → `architecture-review` planı stres testine tabi tutar
  163. 5. **Geliştir** → `test-driven-execution` ile implementasyon yapılır
  164. 6. **Kodu incele** → `code-review` pre-commit checklist çalıştırır
  165. 7. **Commit ve push** → `github` skill conventional commits ve PR'ları yönetir
  166. ---
  167. ## 🧠 Bilgi Kalıcılığı
  168. 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:
  169. | Tür | Ne Saklanır |
  170. |-----|-------------|
  171. | `decision` | Mimari seçimler, teknoloji tercihler ve gerekçeleri |
  172. | `convention` | İsimlendirme kuralları, kod pattern'leri, klasör yapıları |
  173. | `bug` | Belirsiz sorunların köken nedeni ve çözümü |
  174. | `gotcha` | 3. parti servis tuzakları, ortam sorunları, edge case'ler |
  175. | `research` | Önemli araştırma gerektiren soruların cevapları |
  176. <!-- Aynı sorunları her oturumda yeniden keşfetmek zorunda kalmazsınız. Bilgi birikir ve aktarılır. -->
  177. ---
  178. ## 🤝 Uyumluluk
  179. **[OpenCode](https://opencode.ai)** için geliştirilmiştir, ancak kavramlar taşınabilir:
  180. | Araç | Nasıl Kullanılır |
  181. |------|-----------------|
  182. | **OpenCode** | `opencode.json` + `AGENTS.md` ile doğal destek |
  183. | **Cursor** | Agent personalarını custom instructions olarak kullanın |
  184. | **Claude Code** | Skill dosyalarını `CLAUDE.md` içinde referans verin |
  185. | **GitHub Copilot** | Kuralları custom instructions'a uyarlayın |
  186. | **Windsurf** | Personaları agent yapılandırması olarak yükleyin |
  187. ---
  188. ## 📋 Conventional Commits
  189. Bu kit [Conventional Commits](https://www.conventionalcommits.org/) standardını uygular:
  190. ```
  191. feat(auth): add refresh token rotation
  192. fix(userService): handle null email in validation
  193. refactor(Button): extract loading state to hook
  194. docs(readme): update installation instructions
  195. chore(deps): upgrade react to 19.2.0
  196. ```
  197. <!-- Commit mesajları İngilizce yazılır, emir kipinde (imperative mood) olmalıdır. Detaylar için .agent/skills/github/SKILL.md dosyasına bakın. -->
  198. ---
  199. ## 🌐 Dil Tercihi
  200. 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.
  201. ---
  202. ## 🤝 Katkıda Bulunmak
  203. Katkılar memnuniyetle karşılanır! Mevcut yapıyı takip edin:
  204. 1. Repo'yu fork edin
  205. 2. Özellik branch'i oluşturun: `feat/yeni-ozellik`
  206. 3. Mevcut skill/agent/rule yapısına uygun değişiklik yapın
  207. 4. Pull request gönderin
  208. ### Yeni Skill Eklemek
  209. `.agent/skills/skill-adi/SKILL.md` dosyası oluşturun:
  210. ```markdown
  211. ---
  212. name: skill-adi
  213. description: >
  214. Bu skill ne zaman kullanılır ve ne üretir.
  215. ---
  216. # Skill Adı
  217. ## Ne Zaman Tetiklenir
  218. ## Adım Adım Süreç
  219. ## Kurallar
  220. ```
  221. ### Yeni Agent Personalası Eklemek
  222. `.agent/agents/agent-adi.md` dosyası oluşturun:
  223. ```markdown
  224. # Agent: Agent Adı
  225. ## Kimlik
  226. ## Uzmanlık Alanları
  227. ## Çalışma Metodolojisi
  228. ## Kod Standartları
  229. ## Asla Yapma
  230. ## Kullanılan Skill'ler
  231. ```
  232. ---
  233. ## 📄 Lisans
  234. Bu proje MIT Lisansı ile lisanslanmıştır. Detaylar için [LICENSE](LICENSE) dosyasına bakın.
  235. ---
  236. ## 🌟 Destek
  237. Bu kit geliştirme iş akışınızı iyileştirdiyse:
  238. - ⭐ Bu repo'yu star'layın
  239. - 🐛 Sorunları bildirin (Issues sekmesi)
  240. - 💡 Yeni skill veya agent personalası önerin
  241. - 🔀 Pull request gönderin
  242. ---
  243. <div align="center">
  244. **⚡ ile geliştirildi by [omer gocmen](https://github.com/omergocmen)**
  245. *Sadece çalışan değil — kalıcı yazılım geliştirin.*
  246. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.