Genel Bakış
day-zero-kit, bir Proje Kurulum Rehberi ve yapay zekâ kod ajanları için sekiz skill'den oluşur. Yeni bir ürünün kodunu yazmadan önce etrafını kurar: hesaplar, ortamlar, bütçe alarmları ve harcama sınırları, bot kapısı, uyarılar, yedek, mobil kit ve proje hafızası ilk günden hazır olur. Ekip yalnız ürün akışına bakar, altyapıyı ajan rehberle kurar. Rehber Neon Postgres, Cloud Run'da Go API, Next.js ve Expo yığını için yazıldı.
Problem
İçindeki kurallar, beş yıl boyunca ürün kurarken yediğim dayaklardan çıktı: uyumayan veritabanları, tavansız açılan ücretli API'ler, kataloğu kazıyan botlar, kimseye haber vermeden biten krediler, eski sürümde kalıp yeni akışı göremeyen kullanıcılar.
Çözüm
Bu tecrübeyi rakamlarıyla birlikte bir rehbere, sonra bir ajanın izleyebileceği skill'lere dönüştürdüm. Ajan kurulum kararlarını tek tek sorar ve docs/DECISIONS.md'ye yazar, proje hafızası dosyalarını açar, kurulum planını aşama aşama uygular. Yalnız insanın yapabileceği işlerde durup sorar: hesaplar, ödemeler, alan adları, mağaza gönderimleri, canlıya deploy ve herkese açık her şey.
Sonuçlar
Kendi canlı ürünlerimin Ağustos–Ekim 2026 faturalarından ve loglarından (rehberde Ürün A–D diye geçerler):
- Aylık bulut faturası Eylül'deki ~₺3.900–4.400'den ~₺1.300'e indi (8 Ekim tahmini).
- Veritabanı günde 6,5 CU-saatten ~2,1'e düştü: okumalar bellekten, veritabanı uyuyor.
- Ayda ~₺1.500 tutan harita API'si açık veri ve kendi tablomuzla sıfıra indi.
- Web isteklerinin %41'ini tek bir kazıyıcı alıyordu; bot kapısı ilk gününde 6.654 isteği reddetti.
- Biten bir API kredisi 30 gün fark edilmedi; uyarılar kurulduktan sonra hatadan alarma 4 dakika.
Skill'ler
project-setup: Kararları sorar, hafıza dosyalarını açar, altyapıyı gün 0'dan aşama aşama kurar ve doğrular.decision-support: Ücretli API, plan, analitik, gerçek zamanlı iletişim, OTA ve bölge kararlarında seçenekleri gerçek rakamlarla koyar.release-gate: Mağaza sürümünden ve canlıya deploy'dan önce yayın kapısını çalıştırır, kanıtla "çıkar / çıkmaz" önerir.cost-audit: Veritabanı uyanışı, instance tavanı, harcama freni, kota ve build dakikası için düzeltme listesi çıkarır.security-audit: Yetkiler, sırlar, bağımlılıklar, başkasının kaydını okuma, bot kapısı ve KVKK için bulgu listesi verir.project-memory: CHANGELOG, STATUS, TODO, DECISIONS ve devir notunu günceller.alert-audit: Her hata, kredi, kota ve süre dolumunun doğru kişiye, doğru kanaldan ulaştığını doğrular.seo-geo-routine: SEO ve GEO işlerini yürütür; önce botların veritabanını uyandırmadığını kontrol eder.
Teknik Öne Çıkanlar
- Türkçe ve İngilizce skill setleriyle (
day-zero-kit-tr,day-zero-kit-en) bir Claude Code eklenti pazaryeri; skill'ler Codex'te de kullanılabilir. - Her kural bir kanıt etiketi taşır: kanıtlı, ölçüldü ya da öneri.
- Her push'ta bir Python betiği manifestleri, skill'leri, başvuru dosyalarının rehberle birebir eşleşmesini ve bağlantıları denetler.
- Rehber metni CC BY 4.0, skill'ler ve betikler MIT lisanslı.
Neden Önemli
Pahalıya öğrenilmiş dersleri tekrarlanabilir bir gün 0 kurulumuna çevirir: veritabanını gereksiz uyandırmamak, her harcamaya tavan ve alarm, sessiz hata bırakmamak, en az yetkiyle çalışmak, kullanıcıyı kırmadan değiştirmek, kararları ve proje hafızasını yazmak.