Vaka Analizi: Vibe Coding Prompt Template – Kendim İçin Yazdığım Bir Akışa 2.806 Yıldız

Deponun bugünkü durumu

İki katkıda bulunan, o anlık görüntüde sıfır açık konu, MIT lisansı. Skor tablosunun tamamı bu. İndirme sayım yok, depoyu kimin klonladığına dair analitiğim yok ve o 2.806 hesabın kaçının tek bir dosyayı bile açtığını bilmemin bir yolu yok. Tahmin yürütmektense bunu söylemeyi tercih ederim.

Şablonun içinde gerçekte ne var

Bu bir markdown deposu. Kurulacak bir paket yok; dosyalarınızın yerinde olup olmadığını kontrol eden tek bir Python betiği dışında çalıştırılacak bir şey de yok.

Çekirdeği, sırayla bir sohbet modeline yapıştırdığınız dört prompt:

• part1-deepresearch.md modelden fikri sınamasını ister: talep, rakipler, kapsamın gerçekçi olup olmadığı. Yirmi ila otuz dakika.
• part2-prd-mvp.md bunu bir MVP kapsamına indirgenmiş ürün gereksinim dokümanına çevirir.
• part3-tech-design-mvp.md bütçenize, takviminize ve karmaşıklık toleransınıza göre yığın seçeneklerini gezer.
• part4-notes-for-agent.md IDE ajanınıza verdiğiniz dosyadır. Ajana ilk üç çıktıyı okumasını ve şablonları doldurmasını söyler.

İlk üçü, henüz bir deponuz yokken ChatGPT, Claude.ai veya Gemini içinde çalışır. Yalnızca dördüncüsü bir IDE ister.

Bu çekirdeğin etrafında, sonradan istek üzerine eklediğim üç şey var:

Araç adaptörleri. templates/tool-adapters/ her araç için ince birer işaretçi dosya barındırıyor: Claude Code için CLAUDE.md, Cursor için .cursor/rules/vibe.mdc, Antigravity için .agent/rules/vibe.md. Codex AGENTS.md dosyasını doğrudan okuduğu için ek bir şey istemiyor. Her adaptör kopya değil işaretçi olduğundan talimatlar tek yerde duruyor. Aynı altı aşama için Cursor komutları, Antigravity iş akışları ve Codex promptları da geliyor.

Claude Code becerileri. .claude/skills/ altında altı tane var: /vibe-research, /vibe-prd, /vibe-techdesign, /vibe-agents, /vibe-build ve diğer beşini sırayla çalıştıran orkestratör /vibe-workflow. Tek tek npx skills add ile kuruluyorlar.

İşlenmiş bir örnek. examples/reddit-to-ai/ tam bir çıktı seti: araştırma dokümanı, PRD, teknik tasarım, AGENTS.md, MEMORY.md. İyi çıktının neye benzediğini tahmin etmek yerine görebiliyorsunuz.

Üç GitHub Actions iş akışı var ve bu ifadenin çağrıştırdığından daha küçükler: ilk kez katkı verenlere selam veren bir iş, PR boyutunu etiketleyen bir iş ve gerekli şablon dosyalarının hâlâ yerinde olduğunu, SECURITY.md içinde yer tutucu bir e-posta kalmadığını, adı değişmiş bir dosya veya beceriye atıf yapılmadığını kontrol eden bir lint işi. Bu bir derleme hattı değil, kendi bozuk bağlantılarıma karşı bir koruma.

Şablonun bir de web sitesi sürümü var; aynı aşamaları tarayıcıda yürütüyor. Bu vaka analizi deponun kendisiyle ilgili.

Yapı neden serbest promptlamayı yener

Çözmeye çalıştığım hata biçimi çok belirli. Bir özelliği kodlama ajanına sohbette anlatırsanız, ajan söylemediğiniz kısımları çıkarım yapmak zorunda kalır: klasör düzeni, adlandırma, neyin bitmiş sayıldığı, önceki kararlarınızdan hangilerinin hâlâ geçerli olduğu. Makul ama sık sık yanlış çıkarım yapar ve siz fark ettiğinizde yanlış varsayım çoktan on iki dosyaya girmiştir.

Kararları önce yazıya dökmek iki iş görür. Ajan tahmin etmek yerine bir dosya okur; siz de karara henüz hiç kod yokken, yani itiraz etmenin bedava olduğu anda itiraz edebilirsiniz. En çok kötü fikri PRD aşamasında öldürdüm, birkaçı kendi fikrimdi.

Diğer yarısı README'nin dayattığı döngü: planla, planı onaylat, tek bir özelliği uygula, doğrula, tekrarla. Bunda yeni hiçbir şey yok; junior bir geliştiriciyi nasıl brifinglerseniz öyle. Şablonun katkısı, o brifingi her seferinde elle yazmanız (ya da gerçekçi olalım, hiç yazmamanız) yerine yaklaşık bir saatte üretmesi.

Kendi işlerimde de kullanıyorum. README bu yolla yapılmış projeleri listeliyor; RealDex mobil uygulaması ve vibeworkflow.app'in kendisi dahil.

Altı sessiz ay, sonra kasım

Altı ay boyunca depo ayda 5 ile 24 arası yıldız aldı ve Ekim 2025'i toplam 77 yıldızla kapattı. Dürüst temel çizgi bu: birkaç kişinin bulduğu, herkese açık bir markdown klasörü.

Kasım 2025 tek başına 628 yıldız ekledi; o ana kadarki toplamın sekiz katından fazla. v1.0.0'ı 27 Kasım'da yayımladım, yani deponun bulunduğu ay ile sürüm numarası aldığı ay aynı. Hangisinin diğerine yol açtığını kanıtlayamam. Sürümler kendi başına 628 yıldız üretmez ve elimde yönlendiren kaynak verisi yok — GitHub, depo sahibine iki haftalık kayan pencerenin ötesinde trafik geçmişi vermiyor, ben de o sırada kaydetmedim. Söyleyebileceğim şu: sürüm, depoya bağlantı verilebilecek bir şey kazandırdı ve büyüme ani bir sıçrayıp sönme yerine sürdü. Aralık'ta 488, Ocak'ta 394, ardından yavaş bir düşüşle ayda kabaca 120-250 yıldızlık bir tabana oturdu ve o taban bugüne kadar kırılmadı.

Sıçramadan sonra ne çıktı

Asıl ders bu listenin biçiminde. Sürümlerin üçte ikisi kitle geldikten sonra çıktı. v1.0.0'a kadar olan her şey kendi problemimi çözmemdi; sonrasındaki her şey başkalarının araçları, başkalarının editörleri ve başkalarının soruları için yapılan bakım işiydi. v2.4.0 sertleştirme sürümü var, çünkü güvenlik politikasında [your-email] yer tutucusu duran herkese açık bir depo utanç vericidir; lint işi de var, çünkü aynı hatayı ikinci kez yapamayayım.

Böyle bir şeye başlayacak birine söyleyeceklerim

Erken yayımlamak bana hiçbir şeye mal olmadı ve altı ay boyunca hiçbir şey de öğretmedi. Sorun değil: depo o altı ay boyunca kimse yıldızlamasa da benim işime yarıyordu, zaten kasıma kadar hayatta kalmasının tek sebebi bu. Emeği haklı çıkarmak için bir kitleye ihtiyacı olsaydı temmuzda silerdim.

Sürüm numarası beklediğimden çok daha fazla iş gördü. İçeriği kökten değiştirdiği için değil, projeye insanların işaret edebileceği bir yüzey ve anılmaya değer bir an kazandırdığı için. Altı aylık sessiz commit'ler kimseye bağlantı verecek bir şey sunmuyordu.

Bakım yükü de gerçek. Yedi sürüm, bir yönetişim dosyası, konu şablonları, bir davranış kuralları metni ve bir lint iş akışı, dört promptu tekrar tekrar yazmaktan bıktığımda kurmaya niyetlendiğim şeyler değildi. Bir iş akışını herkese açarsanız ve tutarsa, ikinci bir proje devralmış olursunuz.