v3.49.1 Claude Code için başlangıç kiti · MIT

Kodu AI yazar.
Dümen sende.

TillerHand, Claude Code ile bir ürünü fikirden canlıya ve bakıma kadar götürür. Her önemli kararda AI sana seçenekleri, önerisini ve her seçeneğin bedelini sunar. Bir uzman kurulu işi denetler, korumalar hatayı daha olmadan durdurur.

npx tillerhand init

Nerede:

Proje klasöründe çalıştır. Sonra aynı klasörde yeni oturum aç ve /start fikrin yaz.

Tek komut yeter; plugin ve git yolları Kurulum'da · Codex ve Antigravity'de de çalışır · Kod bilmen gerekmez

Claude Code · /start

› /start Serbest çalışanlar için fatura takibi

Adım 4/9 · Teknoloji · Bu karar tüm veri katmanını belirler; sonradan değiştirmek pahalı.

Veritabanı ve kimlik doğrulama hangisi olsun?

Supabase (Önerilen)Postgres, kimlik ve dosya depolama tek yerde. Satır bazlı güvenlik hazır; ücretsiz katman MVP için yeterli.

Neon + Better AuthDaha fazla kontrol, sağlayıcıya bağımlılık az. Kimlik kodu sende kalır.

FirebaseGerçek zamanlı ve mobil ile ortak backend. NoSQL; ilişkisel sorgu zayıf.

Kurul görüşü: Mimar ✓Güvenlik ✓Maliyet: izle

Neden

AI ile kod yazmak hızlı. Ürün çıkarmak başka iş.

"Vibe coding" ile bir demo bir öğleden sonra çıkar. Gerçek kullanıcıya açılan bir ürün ise sessizce verilen kararları, testsiz kodu, sızan anahtarları ve dağılan klasörleri kaldırmaz. TillerHand hızı korur, bu dört açığı kapatır.

GeneldeAI veritabanını, kütüphaneyi, veri modelini kendi seçer. Neden öyle olduğunu kimse bilmez.

TillerHand'deHer karar 2-4 seçenekle sana gelir: önerilen ilk sırada, her birinin ne zaman daha iyi olduğu ve bedeli yanında. Cevabın günlüğe yazılır, bir daha sorulmaz.

Genelde"Çalışıyor" denir, test yoktur. Bir sonraki değişiklik eskisini bozar.

TillerHand'deKabul testleri koddan önce yazılır ve önce kırmızı olur. "Bitti" demeden kanıt gösterilir: test çıktısı, ekran görüntüsü.

GeneldeAPI anahtarı koda girer, prod veritabanı yanlışlıkla silinir, test geçsin diye test zayıflatılır.

TillerHand'deHook'lar bunları daha olmadan durdurur. AI bu korumaları atlatamaz; prod'a giden her adım senin onayını ister.

GeneldeÜç ay sonra kimse dosyaların nerede olduğunu bilmez; final-v2-old.tsx çoğalır.

TillerHand'deÖzellik bazlı bir klasör haritası yazım anında, CI'da ve kurulda korunur. Dağınıklık dosyaları engellenir.

Nasıl çalışır

Her görevde aynı döngü. Ortasında sen varsın.

TillerHand bir komut listesi değil, bir çalışma düzeni. Fikrini yazarsın, gerisini AI ile birlikte adım adım yürütürsün. Önemli hiçbir şey senin haberin olmadan olmaz.

1
AI planlar
Görevi okur, karar noktalarını bulur, seçenekleri hazırlar.
2
Sen karar verirsin
Önerilen ilk sırada; ne zaman hangisi daha iyi, bedeli ne.
3
Önce test, sonra kod
Testleri ayrı bir ajan yazar, kırmızı başlar; kod onları yeşile çevirir.
4
Kurul denetler
İlgili uzmanlar inceler; kritik bulguda iş bitmez.
5
Kanıtla kaydedilir
Kapı yeşilse commit, pano güncellenir, sıradaki görev.

↺ Her görevde tekrar · faz sonunda bulgu raporları ve kurul toplantısı

Kararı sen verirsin

Ürün, teknik, tasarım, veri, güvenlik ve maliyet kararları gerekçeli seçeneklerle sorulur. Tasarım soruları gerçek içerikli görsel önizlemeyle gelir.

Uzman kurulu denetler

Ürün, Mimar, Güvenlik, UX, KVKK ve QA gibi üyeler planı, görevi, commit'i ve fazı inceler. Önemli kararlarda farklı modellerden bir konsey toplanır.

Korumalar durdurur

Sır engeli, yıkıcı komut kalkanı, paket kapısı, test koruması, commit kapısı. Kurallar yazılı, kontroller otomatik; AI atlatamaz.

Her an neredesin, bilirsin

Her cevabın sonunda durum bloğu, alt çubukta görev ve limit, tarayıcıda canlı bir kontrol paneli.

Bir uzman gözüyle tarar

Teknik, iş, güvenlik, UX, performans ve hukuk için en önemli 20 bulgu; kanıtlı, puanlı ve düzeltme yöntemiyle.

Canlıya ve ötesine

Hosting, alan adı ve yedek kurulumu adım adım; onaylı prod deploy; canlı izleme ve düzenli bakım.

Çalışırken

TillerHand ile bir gün böyle görünür.

Aşağıdakiler gerçek çıktıların sadeleştirilmiş halleri. Hepsi Claude Code oturumunda, sohbetin içinde olur.

Kurul · görev sonu toplantısı

MEMBER: Güvenlik · VERDICT: REJECT
FINDINGS:
[CRITICAL] app/api/invoice/[id]/route.ts:14
  Fatura sahibi kontrol edilmiyor; başka
  kullanıcının id'siyle fatura okunur.
  → Sorguya user_id koşulu ekle.
MEMBER: QA · VERDICT: APPROVE
ASK THE USER: yok

Kurul bir açığı yakalar

Kritik bulgu (REJECT) varsa görev bitmiş sayılmaz. Sana üç yol sunulur: düzelt, riski gerekçesiyle kabul et ya da görevi geri al.

Koruma · AI bir dosyaya yazmaya çalışıyor

Write lib/stripe.ts
ENGELLENDİ: lib/stripe.ts dosyasına sır
yazılıyor (Stripe gizli anahtarı).
Sırrı koda yazma; ortam değişkeninden oku
ve adını .env.example'a boş değerle ekle.

Bash vercel deploy --prod
ONAY GEREKİYOR: Prod ortamına deploy.

Korumalar hatayı daha olmadan durdurur

Engel sohbetin içinde açıklamasıyla gelir. Prod'a, veriye ve paraya dokunan her adım senin onayını bekler.

Her cevabın sonunda

── Durum ─────────────────────────────
Aşama: Faz 1 · Görev: G-012 (7/23)
Soru modu: açık · Limit: 5s %34 hf %5
Yapıldı: kayıt formu + doğrulama, test yeşil
Kurul: APPROVE (ux, qa)
Sıradaki: G-013 şifre sıfırlama
Bekleyen karar: e-posta servisi

Nerede olduğunu her an bilirsin

Aşama, görev, limit, kurulun kararı ve sıradaki adım her cevabın sonunda. Bırakıp döndüğünde kaldığın yer hazır.

dashboard.html

Şimdi · Faz 1 · G-012 kayıt formu

Yol haritası

7/23

Güvenlik

Dikkat: 1 kritik bulgualan adı 21 gün2 karar bekliyor

Proje tek sayfada

Kararlar, kurul, bulgular, kalite, operasyon ve limit; her Claude cevabından sonra kendiliğinden güncellenir.

Ölçüm

Fark, hataları yakalayan testlerde.

Aynı görevler TillerHand ile ve onsuz claude -p ile koşuldu ve gizli testlerle puanlandı. Sonra koda bilerek hatalar eklendi: Ajanın yazdığı testler bu hataları yakalıyor mu?

Bilerek eklenen hataları yakalayan testler

TillerHand

%63

Kitsiz

%31

Fark en çok örtük gereksinim ve Türkçe sıralama tuzağı olan görevlerde çıktı.

24/24

TillerHand her koşuda testi koddan önce yazdı. Kitsiz koşu hiçbirinde yazmadı.

81/81

İki koşul da gizli testlerin hepsini geçti; bu boyuttaki görevleri model kitsiz de çözüyor.

Koşu: hata düzeltme, yeni özellik, yetki güvenliği, sayfalama, Türkçe sıralama ve çöp kutusu olmak üzere 6 farklı görev; her koşul 24 kez.

Sürüm 3.18.2 · Sonnet · 6 görev · koşul başına 24 koşu. Düzenek ve sonuçlar depoda: kit/eval/.

Rehber

Ayrıntılı rehber

Kurulumdan bakıma kadar her şey: komutlar, kurul, korumalar, araçlar ve kurallar.

Başlamadan

Kurulum

Önce yolunu seç: boş bir klasörde yeni bir fikirle mi başlıyorsun, yoksa kodun zaten var mı? Kurulum ikisinde de aynı; değişen, kurulumdan sonra yazacağın komut.

Yeni fikrim var

Boş klasör, kod yok

Klasörde npx tillerhand init
Aynı klasörde yeni oturum, /start fikrin: dokuz adımda plan
Faz 0: CI ve ilk deploy
Her gün /build: sıradaki görev

/start sihirbazı →

Kodum zaten var

İlerlemiş, beğenmediğin ya da düzene sokmak istediğin proje

Projenin kökünde npx tillerhand init; dosyaların ezilmez
Yeni oturum, /adopt: kod taranır, belgeler koddan çıkar
Kritik akışlara önce testler
Uyum görevleri /build ile, özellik özellik

/adopt nasıl çalışır →

Gereksinimler: Claude Code, Git, Node.js 18+.

Kurulum için tek bir yol seç; üçü de projeye aynı dosyaları kopyalar (.claude/, CLAUDE.md, AGENTS.md, docs/) ve git deposu yoksa açar. Emin değilsen npm. Proje tipi kurulumda değil, /start sırasında sorulur.

Yol	Ne zaman
1. npm (önerilen)	En kısa yol. Terminalde ya da Claude'a "bu klasörde `npx tillerhand init` çalıştır" diyerek
2. Claude Code plugin	Bilgisayara bir kez kurulur, sonra her yeni projede `/tillerhand:init`. Plugin yalnız kurulumu yapar ve her seferinde son sürümü çeker
3. git	Kitin kaynağını görmek, değiştirmek ya da katkı vermek için. Kit proje içinde `vibe-kit/` klasöründe durur, `.gitignore`'a girer

# 1. npm: proje klasöründe
npx tillerhand init
# 2. plugin: bir kez (masaüstünde /plugin açılmazsa terminalde: claude plugin marketplace add … ve claude plugin install …)
/plugin marketplace add burakdogrul/TillerHand
/plugin install tillerhand@tillerhand
#    sonra her yeni projede:
/tillerhand:init
# 3. git: proje klasöründe
git clone https://github.com/burakdogrul/TillerHand.git vibe-kit
node vibe-kit/kit/kit.mjs init

Kurulumdan sonra aynı klasörde yeni bir Claude Code oturumu aç; kitin komutları ve korumaları yeni oturumda yüklenir. Sonra yeni projede /start fikrin, var olan projede /adopt.

Hangi araç: init, Claude Code, Codex ve Antigravity'den hangisiyle (birden fazlası olabilir) çalışacağını sorar. Doğrudan da verebilirsin: init --tool codex. Kit başka bir klasördeyse: node <kit>/kit/kit.mjs init --project <proje>. Türkiye eki için --addons tr.

Eklentiler: Proje ilk açıldığında Claude Code, .claude/settings.json'da tanımlı skill eklentilerini kurmayı önerir: Caveman, Impeccable, Taste Skill, UI UX Pro Max, Humanizer, Ponytail ve Matt Pocock. /start onayınla eksikleri proje kapsamında kurar (plugins-sync.mjs --install). Tasarım, güvenlik, yayın ve video paketleri kurulur ama kapalı kalır; ilgili komut gerektiğinde açmayı sorar.

Önerilen: kod haritası. codebase-memory-mcp bağlıysa AI kodu dosya dosya okumak yerine sorgular; proje büyüdükçe ciddi token tasarrufu sağlar. /start kurmak isteyip istemediğini sorar; kurulumu kendi terminalinde yaparsın.

Kod bilmeden

Hiç bilmiyorsan: adım adım

Kod yazmayı bilmen gerekmez. Git, terminal ve kurulum işlerini Claude yapar ve önemli her adımda sana sorar. Sen ne istediğini anlatır ve seçim yaparsın.

Hesaplar (bir kez): GitHub hesabı (ücretsiz) ve Claude Pro veya Max aboneliği.
Programlar (bir kez): Claude masaüstü uygulaması, Node.js (LTS sürümü), Git. İstersen GitHub Desktop da kurabilirsin.
Proje: Projen için bir klasör aç ve Claude masaüstü uygulamasında Code sekmesinde seç. Claude'a "bu klasörde npx tillerhand init komutunu çalıştır" yaz. TillerHand plugin'ini bir kez kurduysan bunun yerine /tillerhand:init da olur.
Aç: Aynı klasörde yeni oturum aç; kitin komutları ve korumaları yeni oturumda yüklenir. Eklentileri kurmayı önerirse kabul et.
Başlat: /start fikrin yaz (kodun zaten varsa /adopt). Her sorunun ilk seçeneği önerilendir; emin değilsen onu seç. Pro'daysan ilk sorular için öneri: profil Hafif, planlama derinliği Hızlı (5 saatlik limitin ~%25-35'i), pano Evet, anlatıcı mod Evet.

Bilmen gerekenler. Pro'da 5 saatlik ve haftalık kullanım limiti var; Claude %90, %95 ve %99'da uyarır ama işi durdurmaz. Limit dolup iş kesilirse yenilenince /build ile kaldığın yerden devam edersin. Veritabanı, tasarım ve maliyet gibi kararlar sorulmadan verilmez; ödeme, veri silme ve canlıya alma gibi geri dönüşü zor işler her zaman onay ister. Projeyi başkasına bırakacaksan /handoff; devralan /handoff take ile aynı yerden devam eder.

Kodun zaten varsa

/adopt: var olan projeyi kite al

/start'ın var olan kod için karşılığı. Fikirden değil koddan başlar ama kararları yine sen verirsin. Bu oturumda uygulama koduna dokunulmaz ve dosya taşınmaz; taşıma ve düzeltmeler sonradan /build görevleriyle yapılır.

# projenin kökünde
npx tillerhand init
# aynı klasörde yeni oturum
/adopt

Salt okunur

Tarar

Stack, klasör yapısı, özellikler, testlerin durumu ve son 30 commit çıkarılır. Hızlı tarama 5 saatlik limitin yaklaşık %10-20'si; derin taramada seçtiğin bulgu raporları da çalışır.

Senin cevaplarınla

Belgeleri koddan çıkarır

PRD, stack ve mimari koddan taslak olarak yazılır, anlaşılmayan yer sorulur: neyi beğenmiyorsun, neyi iyileştirmek istiyorsun? Eski CLAUDE.md'deki kurallar tek tek sorulup AGENTS.md'ye taşınır. Kitin dosyası projeninkiyle çakışırsa .kit-new olarak yanına konur, birleştirme sorulur.

Taşımadan önce

Kritik akışlara test

Giriş, ödeme, veri kaydı gibi 3-7 akış seçilir ve her birinin doğru davranışı sana sorulur. Test kodun bugünkü haline göre değil, senin cevabına göre yazılır; ikisi çelişirse bulgu olur.

Yol haritası

Uyum görevleri

Faz 0 güvenli zeminFaz 1 yapıyı taşıFaz 2 bulgularFaz 3 yeni özellikler

Yapı ayrı bir dalda, özellik özellik taşınır. Her görevden sonra testler ve uygulama çalışıyor olmalı; bozulursa /rollback. Sonra her gün olduğu gibi /build.

Rutin

Her gün

Ne zaman	Ne yazarsın
Çalışmaya başlarken	`/build`: görev kodu yazmana gerek yok; sıradaki görevi kendisi alır, test eder
Durumu merak edersen	`ne durumdayız?` veya `/dashboard`
Bir şey bozulursa	`/rollback`: son çalışan hale güvenle döner
Hata görürsen	`/fix-bug belirti`: kök nedeni bulur, önce kırmızı test yazar, sonra düzeltir
Bırakırken	`/wrap-up` (her şeyi kaydeder), sonra `/clear`. Temiz ekranda sıradaki komut yazar

docs/workflow/decision-protocol.md

Kararı sen verirsin

Ürün, teknik, tasarım, içerik, veri, güvenlik ve maliyetle ilgili her seçim bir karar noktasıdır. AI seçenekleri hazırlar, önerisini ilk sıraya koyar, her seçeneğin ne zaman daha iyi olduğunu ve bedelini yazar. Cevabın docs/decisions/log.md'ye kaydedilir, sonra uygulanır ve bir daha sorulmaz.

Örnek soru

Aşama: Başlangıç 4/9 · Teknoloji. Bu karar tüm backend kodunu belirler; sonradan değiştirmek pahalı.

Backend'i hangi dil ve framework ile yazalım?

Python + FastAPI (Önerilen)Fikrinde belge okuma ve AI özetleme var; Python bu işlerde en güçlü ekosistem.

Node.js + HonoFrontend de TypeScript olacaksa tek dil ve tip paylaşımı sağlar.

GoÇok yüksek trafik ve düşük sunucu maliyeti gerekiyorsa; geliştirme daha yavaş.

Sen ne dersin	Ne olur
"tasarımda sorma"	Sadece `design` konusu kapanır. AI önerilen seçeneği seçer, kararı "automatic" diye kaydeder ve durum bloğunda bildirir. Önizlemeler yine üretilir.
"hiç sorma"	Tüm konular kapanır.
"tekrar sor"	Konu(lar) yeniden açılır.
`/ask-mode`	Mevcut modu ve otomatik verilen kararları gösterir; `on` / `off <konu>` ile değiştirir.

Konu	Örnek kararlar
product	MVP kapsamı, öncelik, kullanıcı akışı, fiyat
tech	Dil, framework, veritabanı, auth, hosting, kütüphane ekleme, API stili
design	Stil yönü, renk, yazı tipi, düzen, bileşen stili, animasyon, koyu tema
content	Metinler, ses tonu, sen/siz, başlık ve CTA alternatifleri
data	Veri modeli, silme davranışı, saklama süresi
security	Roller, oturum süresi, hız sınırları, kişisel veri
cost	Ücretli servis, plan seviyesi, AI modeli, harcama limiti

Geri dönüşü zor kararlarda (veritabanı, auth, ödeme, veri modeli; "tek yönlü kapı") önce kurulun ve gerekirse konseyin görüşü alınır. Soru modundan bağımsız olarak her zaman onay istenir: veri silme, prod'a deploy, para harcatan işlem, geri dönülemez komutlar. Dosya ve değişken adı gibi uygulama ayrıntıları sorulmaz, raporlanır.

.claude/commands/start.md

/start: dokuz adımlı sihirbaz

Uygulama kodu yazmadan projenin tüm temel kararlarını alır. Kararlar verildiği anda günlüğe yazılır ve panoda görünür. Yarıda kalırsa kaldığı adımdan devam eder.

Adım	Ne olur	Örnek soru	Skill
0 Hazırlık	Profil (Hafif / Standart / Tam), planlama derinliği (maliyetiyle), araç, pano, node, git, skill, limit ve kod haritası kontrolü	"Planlama derinliği: Hızlı (~%25-35) / Standart (~%50-70) / Ayrıntılı (~%80-100)?"	caveman
1 Fikir	Fikir turlar halinde sorgulanır, PRD yazılır	"İlk sürümde hangi özellikler olsun?" (çoklu seçim; seçilmeyenler kapsam dışı)	grilling
2 Tip	Web/SaaS, mobil veya backend; AI özelliği var mı	"Kullanıcın masa başında çalışıyor; web öneriyorum. Uygun mu?"	-
3 Kurulum	`node kit/kit.mjs install` tipi ve klasör haritasını yerleştirir	-	-
4 Teknoloji	Tipin karar kataloğundaki 10-12 karar tek tek	"Veritabanı ve kimlik: Supabase / Neon + Better Auth / Firebase?"	research
5 Mimari	Veri modeli, giriş yöntemleri, roller, servisler ve maliyet, sözlük, birim ekonomisi	"Silinen fatura çöp kutusuna mı gitsin, kalıcı mı silinsin?"	domain-modeling, codebase-design
6 Kurul	Tipe göre önerilen uzman kurulu; üyeler inceleme rolünün modeliyle çalışır, ajanlar projede üretilir. Pahalı adım: önce maliyet, sonra "Yap / Hafif yap / Sonraya bırak"	"Kurulda kimler olsun?" (çoklu seçim)	-
7 Tasarım	`/design general`: görsel önizlemelerle stil, renk, yazı tipi, detaylar. Pahalı adım: önce maliyet sorulur	"Bu üç açılış sayfasından hangisi?"	taste, impeccable, ui-ux-pro-max
8 Yol haritası	Kabul testi önce gelen görevler, ilk özellik, lansman hedefi	"Faz 1'de önce hangi özellikle başlayalım?"	-
9 Kapanış	Özet, sonraya bırakılan adımlar, ilk görev	-	-

Stack seçilince projenin README'sindeki Gereksinimler/Kurulum bölümü ve sürüm dosyası (.nvmrc / .python-version) doldurulur; proje başka bilgisayarda aynı şekilde kurulabilir. /release ve aylık /maintain bunu temiz bir klasörde kurarak sınar.

/design · görsel önizleme

Tasarımı görerek seçersin

Her tasarım kararında seçenek başına gerçek içerikle bir örnek üretilir (.previews/), tarayıcıda açılır, ekran görüntüsü gösterilir; sonra sorulur. Her stil yönü kendi skill'iyle çizilir, böylece seçenekler arasındaki fark gerçek olur.

Stil yönü · 3 örnek Renk · 3 palet Yazı tipi · 3 çift Detaylar DESIGN.md Sayfa yapısı Metin + humanizer Uygula critique · audit · polish

Premium / Apple tarzı

taste-skill:high-end-visual-design

Bol boşluk, büyük ve ince tipografi, yumuşak geçişler
Tüketici ürünü, marka algısı, yüksek fiyat

Minimal editoryal

taste-skill:minimalist-ui

Sıcak monokrom, tipografi odaklı, düz yüzeyler
İçerik, portfolyo, sakin SaaS

Cesur ve hareketli

taste-skill:gpt-taste

Dev tipografi, kaydırmaya bağlı animasyon, bento
Lansman sayfası, genç kitle

Endüstriyel / brutalist

taste-skill:industrial-brutalist-ui

Ham ızgara, terminal estetiği
Geliştirici aracı, veri yoğun pano

İşlevsel ürün arayüzü

impeccable + ui-ux-pro-max:ui-styling

Sade, yoğun bilgi, hızlı kullanım
Panel, admin, B2B araç

Her yönde ortak

impeccable · ui-ux-pro-max · humanizer

PRODUCT.md ve DESIGN.md Impeccable'da
Palet ve yazı adayları UI UX Pro Max'ten
Metinler Humanizer'dan geçer

İlham markası (isteğe bağlı): Beğendiğin bir ürünün DESIGN.md'si (awesome-design-md) indirilir ve Impeccable ile ilkeleri damıtılır. Logo, ad ve birebir palet alınmaz; marka taklidi yoktur.

/start sonrası

Dört aşama

Her aşamanın bir çıkış kapısı var: kapıdaki maddeler tamamlanmadan bir sonrakine geçilmez.

İlk gün · Faz 0

Kurulum ve ilk deploy

/build G-001… G-007CI yeşilprod URLSentrybelirteçler kodda

Çıkış kapısı

dev, test, lint, build komutları çalışıyor
Sır içeren deneme commit'i reddediliyor, GitHub'da CI yeşil
"Merhaba dünya" prod URL'de açılıyor, hata takibi çalışıyor

Her görev · Faz 1–2

Geliştirme döngüsü

/plan-task · karar noktaları sorulur /build · testleri test-writer yazar kanıt /review-changes kapı + kurul → commit /wrap-up

"Bitti" tanımı

Görevde çıkan tüm kararlar soruldu ve kaydedildi
Testler yeşil, çalıştığına dair kanıt gösterildi
Arayüz varsa DESIGN.md'ye uygun, Impeccable critique yapıldı, metinler Humanizer'dan geçti
Görev sonu kurul toplantısında REJECT yok

Lansman · ve her sürüm

Canlıya alma

/release first/releasesecurity-auditorsecurity-reviewponytail-auditimpeccable audit

/release first ilk lansmanda hosting, ortam değişkenleri, alan adı ve DNS, yedek ve zamana geri dönüş (PITR) ile geri alma provasını sağlayıcıya göre adım adım kurdurur (Vercel, Supabase, Railway, EAS). Adımlar resmî dokümandan, kaynak ve tarihle; sırrı sen panelde girersin.

Çıkış kapısı

Tüm ❌ maddeleri kapandı; senin kontrol etmen gerekenler soruldu
Yedekten geri yükleme denendi, geri alma yolu yazılı
KVKK metinleri yayında, harcama limitleri ayarlı, canlı izleme açık

Canlıdayken · düzenli

Bakım

/maintain weeklymonthly · ponytail-debtquarterly · ponytail-audit/user-feedback/retro

Canlı izleme 3 saatte bir kritik akışı ve yanıt süresini dener; bozulunca GitHub issue açılır, panoda uyarı çıkar ve /fix-bug önerilir.

Olay anında sırayla

Durdur, Kaydet, Düzelt, Bildir (kişisel veri ihlalinde Kurul'a 72 saat içinde), Öğren

.claude/agents/board-* · docs/workflow/board.md

Uzman kurulu

Seçilen ürün tipine göre uzman ajanlar senin projende oluşturulur ve stack'e göre özelleştirilir. İşleri sürekli denetler, karar önerir ve seni bilgilendirir. Danışmandırlar; sadece kritik bulguda işi durdururlar. Karar her zaman sende.

Web / SaaS

ürün · mimar · güvenlik · ux · performans · kvkk · qa

+ devops, + ai (AI eki varsa)

Mobil

ürün · mimar · güvenlik · ux · mobil · kvkk · qa

+ devops, + ai

Backend

ürün · mimar · güvenlik · api · devops · qa

+ kvkk (kişisel veri varsa), + ai

Toplantı	Ne zaman	Kim	Model
Plan · konsey	/plan-task sonunda, onaydan önce	Ürün + Mimar + ilgili üyeler (en fazla 4) + başkan	inceleme rolü · başkan opus
Görev sonu	/build sonunda	İlgili üyeler (en fazla 3)	inceleme rolü
Commit (hafif)	Her commit öncesi; hook zorunlu kılar. Görev sonu toplantısı aynı değişiklikleri onayladıysa yapılmaz	İlgili en fazla 2 üye, yalnız son onaydan sonra değişen dosyalar	haiku
Faz sonu · canlıya alma	/board convene, /release first	Tüm kurul + başkan	inceleme rolü · başkan opus
Karar konseyi	Tek yönlü kapı kararı, /board council	3 danışman aynı soruyu cevaplar + başkan	haiku · sonnet · opus · başkan opus

Konsey: üç aşama

Karpathy'nin llm-council yapısı kurula uyarlandı. Ağır toplantılar ve geri dönüşü pahalı kararlar üç aşamadan geçer:

1 · İlk görüşler

Üyeler (veya farklı modellerdeki danışmanlar) birbirinden habersiz, paralel çalışır. Görüşler A, B, C diye etiketlenir; bulgular A1, A2…

2 · Anonim çapraz oy

Her üye diğerlerinin görüşünü kimin yazdığını bilmeden okur, her bulguya AGREE · OVERSTATED · DISAGREE (doğru · abartılı · yanlış) oyu verir, eksik olanı yazar ve görüşleri sıralar.

Sayım (kod)

council.mjs ortalama sırayı, bulgu oylarını ve uzlaşma yüzdesini kodla hesaplar; model sayıyı değiştiremez.

3 · Başkan

board-chair (opus) tutanağı okur, kararı yazar, çürütülen bulguları gerekçesiyle eler, azınlık görüşünü korur. Tartışmalı kritik bulguyu eleyemez; sana sorar.

Profil konseyin ne zaman toplanacağını belirler (bir konsey Pro'da 5 saatlik limitin yaklaşık %12'si):

	Hafif (Pro için önerilen)	Standart	Tam
Eklentiler	Çekirdek 6 + tipin LSP ve stack skill'leri	Çekirdek 8 + stack; paketler gerekince	Çekirdek 8 + stack; paketler gerekince
Commit denetimi	Kapalı	Açık	Açık
Komut listesi	10 çekirdek komut açıklamalı, gerisi sadece adıyla (~1.100 token az)	Hafif gibi	Hepsi açıklamalı
Toplantı konseyi	Yok	Faz sonu, canlıya alma	Plan, faz sonu, canlıya alma, REJECT
Karar konseyi	Veritabanı, auth	Veritabanı, auth	Tüm tek yönlü kararlar

Karar konseyinde sana sorulan sorunun "(Önerilen)" seçeneği konseyden gelir; her seçeneğin altında konseyin oyu ve azınlık görüşü yazar. Tutanaklar docs/workflow/council/'da, özeti panonun Kurul sekmesinde.

REJECT geldiğinde görev bitmiş sayılmaz. Sana üç seçenek sunulur: düzelt (önerilen), riski kabul et ve gerekçeyi kaydet, ya da görevi geri al. Üyeler arasında görüş ayrılığı varsa iki görüş yan yana konur ve karar sana sorulur.

Kurallar yazılı, kontroller otomatik

Koruma katmanları

Kararlar Claude Code'un izin katmanında verilir (izin ver · sor · engelle); AI bunları atlatamaz. Codex ve Antigravity'de aynı betikler o aracın hook'larıyla çalışır.

Her dosya yazımında ve komutta

AI yazar / çalıştırır
Sır engeli
Yıkıcı komut kalkanı
Paket kapısı
Yapı ve kapsam
Test ayrımı: durdu

Her commit'te

Deterministik kapı
Test kaynağı
Kurul
Commit

Örnek: kod ajanı bir test dosyasını değiştirmek istedi, test ayrımı durdurdu. Her katman ayrı bir betik; biri durdurursa işlem olmaz, "sor" kararında onay sana gelir.

Katman	Ne yapar
Sır engeli	Koda veya dokümana yazılan API anahtarını (Anthropic, OpenAI, Stripe, AWS, GitHub, Supabase…) engeller; commit öncesi de tarar
Yıkıcı komut kalkanı	`DROP`, `TRUNCATE`, koşulsuz `DELETE`, `db reset` ve prod ortam değişkenlerini makineye çekmek engellenir; prod deploy, geri alma, mağazaya gönderim ve migration sorulur
Paket kapısı	Kurulan ya da `npx`, `uvx` ile indirilip çalıştırılan paket kayıt defterinden doğrulanır: yoksa engellenir; çok yeni, az indirilmiş veya popüler bir pakete benziyorsa sorulur
Yapı koruyucu	Harita dışı yeni dosya sorulur; `.bak`, `-old.*`, kopya ve `temp/` gibi dağınıklıklar engellenir
Yapılandırma onayı	`CLAUDE.md`, `AGENTS.md`, `.claude/`, `.codex/`, `.mcp.json` ve iş akışı dosyaları onayın olmadan değişmez
Test ayrımı	Testleri kodu yazan değil, ayrı bir ajan (`test-writer`, farklı model önerilir) koddan önce yazar. Test dosyasına bu ajan dışında kimse yazamaz: ana oturum ve kod ajanı denerse engellenir. Patch veya betikle dolaylı değişen test dosyası da commit kapısında durur. Böylece kodu yazan testi kendi koduna göre şekillendiremez
Test koruması	Beklenti silmek veya yoruma almak, `.skip`/`.only`, gevşek beklenti, test dosyasını silmek veya taşımak ve test ayarında kapsamı daraltmak sorulur; kabukla test dosyasına yazmak da
Deterministik kapı	`gate.mjs --run`: lint, tip kontrolü, test ve Semgrep çalışır; çıktı kurula girdi olur, kırmızı kontrol REJECT sayılır. Spec'teki "değişmemesi gereken" davranışların testi yoksa veya kırmızıysa kapı kırmızıdır. Eklenen bir satırda bu makineye özel bir yol (proje klasörünün ya da ev klasörünün tam yolu) varsa da kırmızıdır. Yeni veya değişen komut önce sana gösterilip onaylatılır
Commit kapısı	Kurul denetimi ve aynı değişiklikler için yeşil kapı olmadan commit atılmaz; görev sonu onayı commit için de geçerli, aynı değişiklik iki kez denetlenmez; denetimi atlamak (`--skip`) her seferinde sorulur
Düzenleme kilidi	`/freeze <klasör>` açıkken AI sadece o klasöre yazar; kabukla dışarı yazmak sorulur, sembolik bağdan kaçılamaz
Kapsam kalkanı	`/plan-task` onayından sonra planın dosya listesi kaydedilir; listede olmayan mevcut dosyaya yazım sorulur. Kalkanı açmak ve kapatmak da sorulur
Düzenleme turu sayacı	Aynı kod dosyası bir oturumda 5., 10. kez düzenlenince Semgrep ve güvenlik incelemesi hatırlatılır
Dev/prod ayrımı	Yerel ortam ve AI (salt-okunur MCP dahil) sadece dev projesine bağlanır; prod sırları barındırma panelinde kalır
Güvenlik incelemesi	`security-guidance`: yazarken riskli kalıp uyarısı (istemcide service_role, kişisel veri logu, innerHTML), commit'te ayrı modelle inceleme

Ne zaman	Nerede	Ne yakalar
Push ve PR	GitHub Actions	Lint, tip, test, build, Semgrep, kopya kod, klasör yapısı, bağımlılık açıkları, tüm geçmişte sır taraması; değişen dosyalarda karmaşıklık bütçesi (fonksiyon 15 karmaşıklık / 80 satır, dosya 400 satır); Supabase varsa yerel Supabase'e karşı RLS saldırgan testi
Canlıda	Canlı izleme · bulut ajanları (isteğe bağlı)	3 saatte bir kritik akış ve yanıt süresi testi, bozulunca issue ve panoda uyarı; kırmızı CI'a düzeltme önerisi; haftalık bakım raporu
Her hafta	Dependabot	Eskiyen bağımlılıklar; majörler planlı

/findings-* · docs/findings/

Bulgu raporları

Projeyi bir uzman gözüyle tarar; en önemli en fazla 20 bulguyu kanıtla, 0-100 önem puanıyla ve teknik düzeltme yöntemiyle sıralar. Her rapor alan için bir sağlık puanı verir ve bir öncekiyle karşılaştırılır (yeni / devam / kötüleşti / çözüldü).

Komut	Bakış açısı	Örnek bulgu
/findings-tech	Kıdemli mimar	Aynı yetki kontrolü 4 yerde tekrar yazılmış; kullanılmayan export; N+1 sorgu
/findings-business	Sektörün kıdemli uzmanı (bankacılıkta bankacı); web araştırmalı	Mutabakat akışı yok; iade kuralı tanımsız; rakiplerin standart özelliği eksik
/findings-security	Saldırgan	Başkasının faturası okunabiliyor (IDOR); webhook imzası doğrulanmıyor
/findings-ux	Kullanıcı ve UX araştırmacısı	Boş liste ekranı yönlendirmiyor; kontrast 3.1:1
/findings-perf	Performans ve FinOps	Panel sayfası 480 KB istemci JS; AI çağrısında max_tokens yok
/findings-legal	Uyum uzmanı (hukuki görüş değildir)	Vergi numarası veri envanterinde yok; çerez bandı onaydan önce analitik yüklüyor
/findings-all	Seçilenlerin hepsi, paralel	Birleşik özet ve ortak düzeltme planı

Önem puanı = etki (40) + olasılık (25) + yayılım (20) + aciliyet (15). Seviyeler: Kritik ≥80 · Yüksek 60-79 · Orta 40-59 · Düşük <40. Sağlık = 100 − ceza (kritik 15 · yüksek 8 · orta 4 · düşük 1). Raporun sonunda düzeltme planı, ilgili kurul üyesinin görüşü ve hangi bulguların yol haritasına gireceği sorusu var.

.claude/structure.json · docs/architecture/structure.md

Proje yapısı korunur

Kod özellik bazlıdır: bir özelliğe ait her şey features/<özellik>/ altında. Yeni bir dosya yapı haritası dışına yazılmak istenirse sana sorulur; dağınıklık dosyaları engellenir. Deneme işleri sandbox/, eski dokümanlar docs/archive/ altına gider.

.claude/         # komutlar, ajanlar, hook'lar, kurul, bulgular, structure.json
.github/         # CI, Dependabot, canlı izleme, bulut ajanları
docs/
  product/       prd · roadmap · glossary · launch · feedback · unit-economics · specs/
  architecture/  overview · stack · structure
  design/        design-guide
  decisions/     log.md + adr-NNNN-*.md
  quality/       test-plan · metrics · retros · qa/
  security/      checklist
  legal/         privacy-kvkk
  operations/    release-checklist · deploy-setup · maintenance · accounts · feature-flags · spend-alarms
  workflow/      progress · decision-protocol · skills · board · usage-limits · cost-log
  findings/      /findings-* raporları
  archive/
src/features/<özellik>/{components,hooks,server,__tests__}   # web
tests/
sandbox/         # git'e girmez
AGENTS.md · CLAUDE.md · README.md · CHANGELOG.md

AGENTS.md ortak kuralları tutar (Claude Code, Codex, Antigravity okur); CLAUDE.md onu içe alır ve Claude Code'a özel ekleri taşır. Yapı dört yerde korunur: yazım anında hook, her PR'da CI, kurul Mimarı ve /findings-tech. Haritayı değiştirmek teknik bir karardır; sana sorulur ve ADR olarak kaydedilir.

Her an neredeyiz

Raporlama ve pano

Her cevabın sonunda: durum bloğu

── Durum ─────────────────────────────
Aşama: Faz 1 · Görev: G-012 (7/23) · Soru modu: açık · Limit: 5s %34 hf %5
Yapıldı: kayıt formu + doğrulama, test yeşil · Kurul: APPROVE (ux, qa)
Otomatik kararlar: yok
Sıradaki: G-013 şifre sıfırlama · bekleyen karar: e-posta servisi

Her zaman: alt durum çubuğu

▶ Faz 1 · G-012 · görev 7/23 · soru: açık · 5s %34 · hf %5 · bağlam %42

dashboard.html

Üstte: Şimdi (aşama, görev, sıradaki adım), Dikkat gerektirenler (önem sırasıyla), sağlık rozeti ve özet kutucuklar
10 sekme: Genel · Yol haritası · Kararlar · Kurul · Bulgular · Kalite · Aktivite · Ürün ve teknik · Operasyon · Limit ve maliyet
Ürün ve teknik: PRD, MVP ve kabul testleri, birim ekonomisi, geri bildirim, stack, tasarım, marka paketi, tanıtım videoları, araştırma notları
Limit ve maliyet: 5 saatlik ve haftalık limit, bağlam, son 30 günün token ve API karşılığı maliyeti (ccusage), görev başı limit maliyeti
Sıradaki adımın ve uyarılardaki komutların yanında Kopyala düğmesi: komutu Claude sohbetine yapıştırırsın
Her Claude cevabından sonra güncellenir, açıkken 30 saniyede bir yenilenir; ek token harcamaz

Masaüstü bildirimi

Claude soru sorduğunda veya onay beklediğinde
90 saniyeden uzun bir iş bittiğinde · kapatmak için KIT_NOTIFY=off

docs/workflow/usage-limits.md

Limit farkındalığı

İş başlamadan 5 saatlik ve haftalık limit okunur: masaüstünde get_usage aracıyla, terminal ve IDE'de Claude Code'un durum çubuğuna gönderdiği bilgiyle. Limit sadece uyarı sebebidir: iş durmaz, sen "dur" demedikçe devam eder.

Çalışırken	Ne olur
%90	Tek satır hatırlatma ve sıfırlanma saati; iş devam eder
%95	"Limit çok azaldı" uyarısı; kaldığı yer sessizce kaydedilir
%99	"İş yarım kalabilir" uyarısı; adımlar küçük tutulur, WIP commit önerilir
"dur" dersen	Güvenli durur: adımı tamamlar, testleri çalıştırır, kaldığı yeri yazar

Seviye	5 saatlik	Haftalık	Davranış
yeşil	< %60	< %70	Normal çalışır
sarı	%60–84	%70–89	Tahmini maliyeti söyler, kurul yarıya iner
kırmızı	≥ %85	≥ %90	Maliyeti ve kalan payı tek satırla söyler

Görev maliyetleri docs/workflow/cost-log.md'ye yazılır; tahminler zamanla gerçek verilere oturur. Oturum açılışında sadece özet kurallar ve docs/workflow/progress.md yüklenir (yaklaşık 1.700 token). Kod haritası bağlıysa kod, dosyalar okunmadan sorgulanır. Ana oturumun bağlamı da küçük tutulur: bağımsız sorular tek turda sorulur, kapı ve alt ajan raporları kısa gelir, görev bitip commit atılınca /clear önerilir.

.claude/skills · MCP

Yetenek paketleri

Çekirdek işler dışarıdan kurulan araçlara değil, kitin kendi skill'lerine dayanır; dış araçlar sadece fark yarattığı yerde ve proje tipine göre açılır.

Doğru kaynak

source-research · Context7 · Firecrawl (isteğe bağlı)

Önce resmî doküman, mevzuat, standart
Her iddiaya kaynak, tarih, güven seviyesi (A-D)
Kütüphane dokümanı Context7'den güncel
Firecrawl API anahtarı senin ortam değişkeninde kalır

Dağıtım kurulumu

/release first · deploy-setup.md

Hosting, ortam değişkenleri, alan adı ve DNS, yedek, geri alma provası
Vercel, Supabase, Railway, EAS; adımlar kaynaklı ve tarihli
Sırrı sen panelde girersin; sohbete ve dosyaya yazılmaz

Öğrenen kurallar

/fix-bug · /retro · hookify · AGENTS.md

Aynı hata sınıfı ikinci kez gelince /fix-bug kural önerir; panoda da uyarı çıkar
Mekanik kural hookify'a, gerisi AGENTS.md'ye; sen onaylamadan yazılmaz
Her kuralda kaynak ve tarih; /maintain 90 günden eskileri sorar
Auto memory /start'ta sorulur, önerilen kapalı

Kişisel tercihler

~/.vibe-kit/preferences.md · prefs.mjs

Bir davranışı düzelttiğinde ya da nasıl çalışmak istediğini söylediğinde AI not alır
Görev ve oturum sonunda "tercih olarak kaydedeyim mi?" diye sorar; onaylamadığın yazılmaz
Tercihler tüm projelerinde geçerli, her oturumda yüklenir; git'e girmez
Listele: node .claude/hooks/prefs.mjs --list, sil: --remove <no>

Rol bazlı model

docs/workflow/models.md · models.mjs

Beş rol: planlama, kod yazma, test yazma, inceleme, doküman ve araştırma
Her görevin başında rol başına tek soru (model ve effort birlikte), iki ekranda
Önerilen: plan Opus, kod Sonnet, test Opus, inceleme Sonnet, doküman Haiku; hepsi yüksek effort. Test, koddan farklı model: aynı kör noktayı paylaşmaz
Test, inceleme ve doküman işleri seçilen modelle alt ajanda; plan ana oturumda
Roadmap işareti, maliyet satırı ve progress etiketleri progress.mjs ile yazılır; model çağrısı harcanmaz, biçim bozulmaz
Alt ajan yalnız karlıysa: flow.mjs görev büyüklüğüne, bağlama ve limite bakar; küçük görev ana oturumda kalır, kurul üyeleri değişen yollardan seçilir, sayısı limite göre azalır; üye en fazla 5 bulgu yazar

Türkiye eki

--addons tr · docs/legal/turkiye.md

KVKK yurt dışı aktarım: standart sözleşme, 5 iş günü bildirim
e-Fatura ve e-Arşiv eşikleri (GİB)
iyzico ve PayTR bildirim imzası kodu ve saldırgan testi
İ/ı ve Türkçe sıralama testleri; hukuki görüş değildir

Tarayıcıda QA ve önizleme

/qa · preview.mjs · Playwright CLI

Arayüz kriterleri gerçek tarayıcıda test olarak koşar
Rapor test sonucundan yazılır, panoda kart
/build arayüz görevinde masaüstü ve mobil ekran görüntüsü

Spec ve sapma kontrolü

docs/product/specs/ · gate.mjs

Mevcut, beklenen ve değişmemesi gereken davranış
"Değişmemesi gereken" satırların testi kapıda denetlenir
3+ dosyalık işte /plan-task, her hatada /fix-bug yazar

Logo

logo-design · SVG

Marka soruları, 4-6 konsept görsel önizlemeyle
16 px okunurluk, tek renk hal, koyu zemin
Favicon, uygulama ikonları, PNG boyutları

Tanıtım videosu

motion-video · renderAt(t) · Playwright · ffmpeg

Tek kesintisiz dönüşüm, gerçek imleç, 120 BPM
Kapalı formlu yaylar (testle doğrulandı)
Önce vuruş haritası ve 4 kare onayı, sonra MP4

Arayüz hareketi ve 3D

ui-motion · Motion · Reanimated · GSAP · three.js

Süre belirteçleri, yaylar, sadece transform/opacity
Hareket azaltma tercihi zorunlu
3D: tembel yükleme, statik yedek, mobil GPU

İnceleme ve keşif

rea · Understand-Anything · awesome-design-md

Rakip özelliği nasıl çalışıyor: sadece yetkili olduğun yazılımda, önce onay
İnsan için kod haritası: /adopt, /handoff, /release first önerir

Güvenlik

security-guidance · claude-security · Trail of Bits

Yazarken: riskli kalıp uyarısı
Commit'te: ayrı modelle inceleme
/findings-security: çok ajanlı, doğrulanmış tarama

Kod zekâsı ve stack kuralları

typescript-lsp · pyright-lsp · Vercel · Expo · Supabase

Her düzenlemeden sonra tip hatası; uydurma API derlemeden yakalanır
React, React Native, Postgres, Core Web Vitals kuralları tipe göre açılır

Mobil test ve servisler

Maestro · Expo MCP · servis kataloğu

Kabul testleri cihazda veya simülatörde
EAS build, TestFlight çökme kayıtları
GitHub, Stripe, PostHog, Figma: servis seçilince

Ölçüm ve maliyet

Playwright CLI · Chrome DevTools MCP · ccusage

Konsol, ağ, ekran görüntüsü CLI ile; performans izi MCP ile
Proje başına token ve maliyet panoda

Geri alma

/rollback · checkpoint.mjs

Testler yeşilken çalışan nokta kaydedilir
Geri dönüş yeni bir commit'tir, geçmiş silinmez
Yarım iş saklanır, .env'e dokunulmaz

Senin dilinde

.kit.json → lang

/start ve /adopt ilk iş dili sorar: Turkish / English / Other
Sorular, cevaplar, belgeler, pano ve durum çubuğu o dilde; /language ile değişir
Other: AI hook metinlerini bir kez çevirir; çeviriyi kaydetmek senin onayını ister
Proje dosyalarındaki etiket ve anahtarlar (**Active phase:**, APPROVE) İngilizce kalır: araçlar onları okur

Anlatıcı mod

output style: narrator

Her adımdan sonra: ne yaptım, neden, nasıl görürsün
Görev sonunda en fazla 2 anlama sorusu; cevaplar panoda

Harcama alarmı

spend-alarms.md · pano

Sağlayıcı tavanı ve %50/%80 uyarısı
Kodda kullanıcı kotası, günlük bütçe, otomatik kapatma
/release ve /maintain kontrol eder

docs/workflow/skills.md

Hangi işte hangi skill

İş	Skill
Her kod değişikliği	ponytail:ponytail
Kritik akış (auth, ödeme, veri)	mattpocock-skills:tdd
Hata ayıklama	mattpocock-skills:diagnosing-bugs · /freeze <klasör>
Fikri ve büyük planları sorgulamak	mattpocock-skills:grilling
Sözlük, karar kaydı, veri modeli	mattpocock-skills:domain-modeling
Modül sınırları, mimari	mattpocock-skills:codebase-design
Elle yapılacak kurulum (DNS, panel, mağaza)	mattpocock-skills:wizard
Değişebilen bilgi: sürüm, fiyat, mevzuat, rakip	source-research · Context7
Stil yönüne göre arayüz	taste-skill:*
Ürün bağlamı, tasarım sistemi, critique/audit/polish	impeccable:impeccable
Palet, yazı tipi, belirteçler	ui-ux-pro-max:*
Kullanıcıya görünen her metin	humanizer:humanizer
Logo, ikon, marka paketi	logo-design
Uygulama içi hareket	ui-motion
Kaydırma animasyonu (cesur yön)	gsap-skills
3D sahne (seçilirse)	threejs-fundamentals · threejs-performance · threejs-react-three-fiber
Tanıtım videosu	motion-video
Durum blokları, ilerleme notları	caveman:caveman
React/Next performansı · React Native	react-best-practices · composition-patterns · react-native-guidelines
Veritabanı şeması, sorgu, indeks	postgres-best-practices · supabase
Expo build, yükseltme, mağaza	expo
Core Web Vitals, erişilebilirlik, SEO	web-quality-skills
CLAUDE.md denetimi · oturum dersleri	claude-md-improver · /revise-claude-md
"Bunu bir daha yapma" → kalıcı kural	/hookify
İnceleme · denetim · borç listesi	ponytail-review · ponytail-audit · ponytail-debt
Derin güvenlik taraması	/claude-security · Trail of Bits

Bağlam paketleri: Skill listesi bağlamın %1'iyle sınırlı; taşınca skill'ler kaçırılır. Çekirdek eklentiler hep açık; tasarım, güvenlik, yayın ve video paketleri kapalı gelir ve ilgili komut gerektiğinde açmayı sorar (/tools). Yeni eklenti eklemek teknik bir karardır; üçüncü taraf skill'ler kurulmadan önce okunur.

Bilerek eklenmeyenler: superpowers, gstack, spec-kit, BMAD, GSD, OpenSpec kitin soru, plan ve kurul akışının yerine geçer; iyi fikirleri kitin kendi kurallarına işlendi. claude-mem ve Serena, kitin ilerleme dosyası ve kod haritasıyla aynı işi yapar.

Başka araçla

Codex ve Antigravity

TillerHand Claude Code için yazıldı. Kurallar, komutlar ve korumalar OpenAI Codex ve Google Antigravity'de de çalışır. Kurul tek modelle yürür; soru arayüzü, durum çubuğu ve commit kapısı bu araçlarda yok.

npx tillerhand init --tool codex          # ya da antigravity, ya da claude,codex
# var olan projeye araç eklemek
/kit-update --tool claude,codex

Parça	Claude Code	Codex	Antigravity
Kurallar	CLAUDE.md (AGENTS.md'yi içe alır)	AGENTS.md	AGENTS.md
Komutlar	/start, /build…	Skill: `$start` ya da `/skills`	Skill: `/start`
Korumalar	.claude/settings.json	.codex/hooks.json	.agents/hooks.json
"Sor" kararı	Onay penceresi	Engellenir; AI sana sorar, onaylarsan işlemi sen yaparsın	Onay penceresi
Seçenekli sorular	AskUserQuestion	Numaralı düz metin	ask_question
Kurul ve konsey	Ayrı ajanlar ve modeller	Tek model rolleri sırayla üstlenir	Tek model
Test ayrımı	Hook zorlar: test dosyasına yalnız test-writer yazar	Kural metinde (ajan kimliği yok)	Kural metinde (ajan kimliği yok)
Durum çubuğu, limit, pano yenileme, commit kapısı	Var	Yok	Yok

Komutların kaynağı tektir (.claude/commands/); .agents/skills/ altındaki kopyaları init, install ve update üretir. Codex proje hook'larını sadece klasöre güvendiğinde ve /hooks ile onayladığında çalıştırır; bunu ilk oturumda yap. İlk kullanımda bir sır yazma denemesiyle korumaların çalıştığını gör.

.claude/commands

Komutlar

Komut	Ne yapar
/start [fikir]	Dokuz adımlı sihirbaz: fikir, tip, kurulum, teknoloji, mimari, kurul, tasarım, yol haritası
/adopt	Var olan projeyi kite alır: tarar, belgeleri koddan çıkarır, AGENTS.md ve CLAUDE.md'yi yeniden yazar, kritik akış testleri ve özellik özellik taşıma ile uyum yol haritası
/plan-task [görev]	Karar noktalarını sorar, kurul görüşüyle plan çıkarır, onay alır; 3+ dosyalık işte spec yazar
/build [görev]	Önce kabul ve saldırgan testlerini ayrı bir ajan (`test-writer`) yazar, sonra kod; yeni karar çıkarsa durur; kanıt (arayüzde masaüstü ve mobil ekran görüntüsü) ve kurul denetimi
/design [kapsam]	Görsel önizlemeli tasarım kararları ve uygulama
/review-changes [aralık]	code-reviewer + security-auditor + ponytail-review; düzeltilecekleri çoklu seçimle sorar
/fix-bug [belirti]	Yeniden üret, kanıtla, hata spec'i; kırmızı testi `test-writer` yazar, sonra düzelt, kapı; aynı hata sınıfı tekrar ederse kural önerir
/qa [kriterler]	Arayüz kriterlerini tarayıcıda Playwright testi olarak koşar; rapor test sonucundan, panoda kart
/freeze <klasör> \| off	Düzenlemeyi tek klasöre kilitler; iş başka dosyalara yayılmaz
/rollback [nokta]	Son çalışan hale güvenle döner: yarım iş saklanır, geçmiş silinmez
/findings-<tür>	tech · business · security · ux · perf · legal · all: puanlı bulgu raporu
/board [setup\|convene\|council]	Uzman kurulunu kurar, toplar; `council <soru>` karar konseyi
/ask-mode [on\|off] [konu]	Soru modunu yönetir
/dashboard	Ayrıntılı rapor ve kontrol paneli
/wrap-up	İlerleme, kararlar, CHANGELOG ve pano; oturumu kapatır
/release [first]	Canlıya alma kontrolleri; `first` hosting, alan adı, yedek ve geri almayı sağlayıcıya göre adım adım kurdurur
/maintain [weekly\|monthly\|quarterly]	Düzenli bakım
/user-feedback	Kullanıcı geri bildirimini temalara ayırır, yol haritasına aldırır
/retro	Dersleri projeye yazar; kite önerileri TillerHand reposunda bir dala
/research [konu]	Makaleler, GitHub'daki benzer projeler ve rakip ürünler; fark tablosu; seçilen özellikler PRD'ye
/handoff [take]	Projeyi başka kişiye veya hesaba devreder ya da devralır; aynı yerden devam
/tools [on\|off\|measure\|commands]	Bağlam paketlerini gösterir, açar veya kapatır; skill yükünü ölçer; komut listesini hafif veya tam yapar
/kit-update	Projeyi TillerHand'in son sürümüne çeker; çakışmaları sorar; `--tool` ile araç, `--addons` ile ek ekler
/language [dil]	Konuşma dilini değiştirir (Türkçe, İngilizce ya da başka bir dil); hook metinlerinin çevirisini ve panoyu yeniler

TillerHand de bir proje

Güncelleme ve bakım

Projelerde öğrenilen dersler kite geri döner; kitin yeni sürümleri projelere güvenle gelir.

/retro TillerHand reposunda dal onayla push / PR VERSION + CHANGELOG + tag /kit-update

Dosya türü	Güncellemede ne olur
Kitin dosyaları: komutlar, ajanlar, hook'lar, decision-protocol, skills, güvenlik kontrol listesi, release-checklist, deploy-setup, maintenance, privacy-kvkk	Sen değiştirmediysen yenisiyle değişir. Değiştirdiysen seninki kalır, yeni hali `.kit-new` olarak gelir ve nasıl birleştirileceği sorulur.
Projenin dosyaları: AGENTS.md, CLAUDE.md, PRD, stack, tasarım, settings.json…	Dokunulmaz. CHANGELOG'daki "elle uyarla" maddeleri tek tek sorulur.
Codex ve Antigravity skill kopyaları (`.agents/skills/`)	Her güncellemede komutlardan yeniden üretilir.
Kitte yeni eklenmiş dosya	Projede yoksa eklenir. Daha önce bilerek sildiysen geri getirilmez.

Değerlendirme: node kit/eval/run.mjs aynı görevi kitli ve kitsiz çalıştırır, gizli kabul ve saldırgan testleriyle puanlar. Son ölçüm yukarıda, Ölçüm bölümünde.

Her projede

Altın kurallar

Kararı sen verirsin.AI önerir ve gerekçelendirir; seçim senin. "Sorma" demediğin konuda kendi başına seçmez.
Tasarımı görerek seç.Yazıyla tarif edilen stil değil, önizlemedeki ekran seçilir.
Önce yaz, sonra kodlat.PRD ve kapsam dışı listesi olmadan kod yok.
Tek görev, tek oturum.Büyük görevi böl.
Her çalışan adım bir commit.AI yolunu kaybederse oraya dönersin.
İlk gün canlıya al.Deploy hattı ve CI baştan çalışsın.
Bağlam dosyada yaşar./wrap-up ve /clear alışkanlık olsun.
"Çalışıyor" değil, kanıt.Ekran görüntüsü, istek/yanıt, test çıktısı.
İki deneme kuralı.Aynı hata iki kez çözülmediyse dur, geri al, yeniden planla.
Sır istemciye gitmez.Tarayıcıya ve mobil pakete giden her şey herkese açıktır.
Denenmemiş yedek, yedek değildir.Geri yüklemeyi lansmandan önce dene.
Tekrarlayan hatayı kurala çevir./retro ile kite yaz; mümkünse hook veya CI adımına dönüştür.

Kodu AI yazar.Dümen sende.

AI ile kod yazmak hızlı. Ürün çıkarmak başka iş.

Her görevde aynı döngü. Ortasında sen varsın.

AI planlar

Sen karar verirsin

Önce test, sonra kod

Kurul denetler

Kanıtla kaydedilir

Kararı sen verirsin

Uzman kurulu denetler

Korumalar durdurur

Her an neredesin, bilirsin

Bir uzman gözüyle tarar

Canlıya ve ötesine

TillerHand ile bir gün böyle görünür.

Kurul bir açığı yakalar

Korumalar hatayı daha olmadan durdurur

Nerede olduğunu her an bilirsin

Proje tek sayfada

Fark, hataları yakalayan testlerde.

Bilerek eklenen hataları yakalayan testler

Ayrıntılı rehber

Kurulum

Yeni fikrim var

Kodum zaten var

Hiç bilmiyorsan: adım adım

/adopt: var olan projeyi kite al

Tarar

Belgeleri koddan çıkarır

Kritik akışlara test

Uyum görevleri

Her gün

Kararı sen verirsin

/start: dokuz adımlı sihirbaz

Tasarımı görerek seçersin

Premium / Apple tarzı

Minimal editoryal

Cesur ve hareketli

Endüstriyel / brutalist

İşlevsel ürün arayüzü

Her yönde ortak

Dört aşama

Kurulum ve ilk deploy

Geliştirme döngüsü

Canlıya alma

Bakım

Uzman kurulu

Web / SaaS

Mobil

Backend

Konsey: üç aşama

1 · İlk görüşler

2 · Anonim çapraz oy

Sayım (kod)

3 · Başkan

Koruma katmanları

Bulgu raporları

Proje yapısı korunur

Raporlama ve pano

Her cevabın sonunda: durum bloğu

Her zaman: alt durum çubuğu

dashboard.html

Masaüstü bildirimi

Limit farkındalığı

Yetenek paketleri

Doğru kaynak

Dağıtım kurulumu

Öğrenen kurallar

Kişisel tercihler

Rol bazlı model

Türkiye eki

Tarayıcıda QA ve önizleme

Spec ve sapma kontrolü

Logo

Tanıtım videosu

Arayüz hareketi ve 3D

İnceleme ve keşif

Güvenlik

Kod zekâsı ve stack kuralları

Mobil test ve servisler

Kodu AI yazar.
Dümen sende.