tillerhand 3.42.1 → 3.47.0

package/.claude/commands/review-changes.md

@@ -1,25 +1,25 @@
 ---
-description: Değişiklikleri bağımsız inceleme ajanlarıyla inceler (gerekirse güvenlik denetimi dahil).
-argument-hint: [boş = commit edilmemiş değişiklikler | main..HEAD | commit hash]
+description: Reviews changes with independent review agents (including a security audit when needed).
+argument-hint: [empty = uncommitted changes | main..HEAD | commit hash]
 ---
 
-İncelenecek aralık: $ARGUMENTS (boşsa `git diff HEAD` ve takip edilmeyen yeni dosyalar).
+Range to review: $ARGUMENTS (if empty, `git diff HEAD` and untracked new files).
 
-Kendi yazdığın kodu kendin inceleme; bağımsız ajanlara ver.
+Do not review your own code yourself; hand it to independent agents.
 
-0. **Zaten denetlendi mi?** Aralık boşsa (commit edilmemiş değişiklikler) `node .claude/hooks/commit-gate.mjs --status` çalıştır. "Onay geçerli" diyorsa bu değişiklikler görev sonu toplantısında denetlendi: yeniden inceleme yapma, onayı ve kapı durumunu bildir; kullanıcı açıkça isterse yine incele. "Son onaydan sonra değişen: …" diyorsa aşağıdaki adımları yalnız o dosyalarla yap.
-1. `git diff --stat` ile değişen dosyaları gör.
-2. **`code-reviewer`** alt ajanını inceleme rolünün `model` ve `effort`'uyla çalıştır (`docs/workflow/models.md`; adım 3 de öyle). Ona aralığı ve (biliniyorsa) görev kodunu ver. Görevin `docs/product/specs/` altında spec'i varsa onu da ver: beklenen davranış karşılandı mı, değişmemesi gereken davranış bozuldu mu?
-3. Değişiklik şunlardan birine dokunuyorsa **`security-auditor`** alt ajanını da paralel çalıştır: auth, yetki, ödeme, webhook, dosya yükleme, kişisel veri, DB erişim kuralları, ortam değişkenleri, AI/LLM çağrıları.
-   Kurul kurulduysa değişikliğe ilgili kurul üyelerini de ekle (`.claude/board/rules.md` §3, en fazla 3; limit sarıysa 1).
-   Aynı anda `ponytail:ponytail-review` ile gereksiz kod, aşırı mühendislik ve yük altında kırılacak yerlere bak. Arayüz değiştiyse `impeccable:impeccable` → `audit` da çalışsın.
-4. Ajanların bulgularını birleştir, tekrarları çıkar, önem sırasına koy:
+0. **Already reviewed?** If the range is empty (uncommitted changes), run `node .claude/hooks/commit-gate.mjs --status`. If it says "Approval valid", these changes were reviewed in the end-of-task meeting: do not review again, report the approval and the gate status; review anyway if the user explicitly asks. If it says "Changed since the last approval: …", do the steps below only with those files.
+1. See the changed files with `git diff --stat`.
+2. Run the **`code-reviewer`** subagent with the review role's `model` and `effort` (`docs/workflow/models.md`; step 3 too). Give it the range and (if known) the task id. If the task has a spec under `docs/product/specs/`, give that too: was the expected behavior met, was the must-not-change behavior broken?
+3. If the change touches any of these, also run the **`security-auditor`** subagent in parallel: auth, authorization, payment, webhook, file upload, personal data, DB access rules, environment variables, AI/LLM calls.
+   If the board is set up, also add the board members relevant to the change (`.claude/board/rules.md` §3, at most 3; 1 if the limit is yellow).
+   At the same time, use `ponytail:ponytail-review` to look for unnecessary code, over-engineering and places that will break under load. If the UI changed, also run `impeccable:impeccable` → `audit`.
+4. Merge the agents' findings, remove duplicates, order by severity:
 
 ```
-[KRİTİK|ÖNEMLİ|KÜÇÜK] dosya:satır — sorun. Öneri.
+[KRİTİK|ÖNEMLİ|KÜÇÜK] file:line — problem. Suggestion.
 ```
 
-5. Bulgulara katılmıyorsan nedenini tek satırla yaz; sessizce eleme.
-6. Son satır: **Commit'e hazır** / **Önce düzelt: [maddeler]**.
+5. If you disagree with a finding, write the reason in one line; do not drop it silently.
+6. Last line: **Ready to commit** / **Fix first: [items]**.
 
-Bulguları düzeltme. Hangilerinin düzeltileceğini **çoklu seçimle** sor (KRİTİK olanlar önerilen olarak işaretli). Sonra durum bloğunu yaz.
+Do not fix the findings. Ask which ones to fix with a **multi-select** (KRİTİK ones marked as recommended). Then write the status block.

package/.claude/commands/rollback.md

@@ -1,31 +1,31 @@
 ---
-description: Projeyi son çalışan haline (veya seçilen bir noktaya) güvenle döndürür. Geçmiş silinmez, yarım iş saklanır, geri dönüş de geri alınabilir.
-argument-hint: [boş = seçenekleri göster | etiket veya commit]
+description: Safely returns the project to its last working state (or a chosen point). History is not deleted, unfinished work is saved, and the rollback can be undone too.
+argument-hint: [empty = show options | tag or commit]
 ---
 
-Hedef: $ARGUMENTS
+Target: $ARGUMENTS
 
-Kullanıcı git bilmiyor olabilir. Her şeyi sade Türkçe anlat; git terimini kullanırsan tek cümleyle ne demek olduğunu söyle.
+The user may not know git. Explain everything in plain language; if you use a git term, say what it means in one sentence.
 
-1. `node .claude/hooks/checkpoint.mjs --list` çalıştır.
-2. **Hedef verilmediyse sor** (AskUserQuestion), en fazla 4 seçenek:
-   - En yeni **çalışan nokta** (Önerilen). Etiketi `calisan/...` olanlar, testler yeşilken `/build` ve `/wrap-up` tarafından kaydedilir. Açıklamada notunu ve tarihini yaz.
-   - Bir önceki çalışan nokta.
-   - Son 1-2 commit; her birinin ne değiştirdiğini commit mesajından tek cümleyle anlat.
+1. Run `node .claude/hooks/checkpoint.mjs --list`.
+2. **If no target was given, ask** (AskUserQuestion), at most 4 options:
+   - The newest **working point** (Recommended). Those with a `calisan/...` tag are saved by `/build` and `/wrap-up` when tests are green. Write its note and date in the description.
+   - The previous working point.
+   - The last 1-2 commits; explain in one sentence what each one changed, from the commit message.
 
-   Çalışan nokta yoksa son commit'leri göster ve bunu söyle.
-3. **Ne olacağını önceden söyle:**
-   - Seçilen noktadan sonra yapılan değişiklikler dosyalardan kalkar, ama geçmişte durur.
-   - Kaydedilmemiş iş varsa önce saklanır (`git stash`); sonra geri getirilebilir.
-   - `.env` gibi git'e girmeyen dosyalara dokunulmaz.
-   - Bu geri dönüş de `/rollback` ile geri alınabilir.
-4. Kullanıcı açıkça onaylarsa `node .claude/hooks/checkpoint.mjs --restore <hedef> --yes` çalıştır.
-5. Projenin test komutunu çalıştır (`AGENTS.md` → Komutlar). Sonucu göster: Çalışan hale gerçekten dönüldü mü?
-6. `docs/workflow/progress.md` → "Son oturumda yapılanlar" ve "Dikkat" bölümlerine geri dönüşü yaz: hangi noktaya dönüldü, neden, saklanan iş.
-7. Bitince kısa rapor ver:
-   - hangi hale dönüldü,
-   - testlerin sonucu,
-   - saklanan iş varsa nasıl geri getirileceği (`git stash pop`),
-   - bunu geri almak için ne yapılacağı.
+   If there is no working point, show the last commits and say so.
+3. **Say beforehand what will happen:**
+   - Changes made after the chosen point disappear from the files, but stay in history.
+   - If there is unsaved work, it is stashed first (`git stash`); it can be brought back later.
+   - Files that do not go into git, such as `.env`, are not touched.
+   - This rollback can also be undone with `/rollback`.
+4. If the user explicitly approves, run `node .claude/hooks/checkpoint.mjs --restore <hedef> --yes`.
+5. Run the project's test command (`AGENTS.md` → Komutlar, commands). Show the result: did it really return to a working state?
+6. Write the rollback to `docs/workflow/progress.md` → "Son oturumda yapılanlar" (done last session) and "Watch out" sections: which point it returned to, why, the stashed work.
+7. When done, give a short report:
+   - which state it returned to,
+   - the test result,
+   - if there is stashed work, how to bring it back (`git stash pop`),
+   - what to do to undo this.
 
-Asla: `git reset --hard`, `git push --force`, stash'i silmek (`git stash drop/clear`). Uzak depoya (push) geri dönüşü göndermek ayrı bir onay ister.
+Never: `git reset --hard`, `git push --force`, deleting the stash (`git stash drop/clear`). Pushing the rollback to the remote repo (push) needs a separate approval.

package/.claude/commands/start.md

@@ -1,157 +1,160 @@
 ---
-description: Projeyi fikirden başlatır. Her adımda soru sorarak tip, stack, mimari, tasarım ve yol haritasını kullanıcıyla birlikte kararlaştırır.
-argument-hint: [proje fikri, 1-3 cümle]
+description: Starts the project from an idea. Asks at every step and decides project type, stack, architecture, design and roadmap together with the user.
+argument-hint: [project idea, 1-3 sentences]
 ---
 
-Fikir: $ARGUMENTS
+Idea: $ARGUMENTS
 
-Bu bir **9 adımlı sihirbaz** (0-9). Kullanıcı hiçbir şeyi bilmiyormuş gibi davran: Her kararı `docs/workflow/decision-protocol.md`'ye göre sor (AskUserQuestion, önerilen seçenek ilk sırada, her seçeneğin ne zaman daha iyi olduğu açıklamalı). Kendi kafana göre karar verme. Bu oturumda uygulama kodu yazma. Her kararı tek yönlü / çift yönlü kapı olarak sınıfla (`docs/workflow/decision-protocol.md` §2a); veritabanı, auth, ödeme ve veri modeli gibi tek yönlü kararlarda önce kurul görüşü al (veritabanı ve auth'ta karar konseyi; profil kuralı `.claude/board/council.md`).
+This is a **9-step wizard** (0-9). Act as if the user knows nothing. Ask every decision per `docs/workflow/decision-protocol.md` (AskUserQuestion, recommended option first, each option explains when it is better). Never decide on your own. Write no application code in this session. Classify every decision as a one-way / two-way door (`docs/workflow/decision-protocol.md` §2a). For one-way decisions such as database, auth, payment and data model, get the board's opinion first (decision council for database and auth; profile rule in `.claude/board/council.md`).
 
-**Devam etme:** `docs/workflow/progress.md` → `**Başlangıç adımı:**` 0'dan büyükse kaldığın adımdan devam et ve bunu kullanıcıya söyle. Her adım bitince bu satırı (`N/9`) ve `**Son güncelleme:**` satırını güncelle; sonra durum bloğunu yaz. Ağır adımlardan (1b araştırma, 4, 6, 7) sonra sıradaki adıma geçmeden tek satırla `/clear` öner: adımın sonucu dosyalarda, sonraki adım onları okur; her tur bütün bağlamı yeniden okuduğu için temiz oturum ucuzdur. `/start` yeniden çağrılınca kaldığı adımdan devam eder.
+**Resuming:** If `docs/workflow/progress.md` → `**Başlangıç adımı:**` is greater than 0, resume from that step and tell the user. When a step ends, update this line (`N/9`) and the `**Son güncelleme:**` line; then write the status block. After heavy steps (1b research, 4, 6, 7), suggest `/clear` in one line before the next step: the step's result is in files and the next step reads them; a clean session is cheap because every turn rereads the whole context. Calling `/start` again resumes from the saved step.
 
-**Kararlar anında kaydedilir:** Her kararı verildiği anda `docs/decisions/log.md` → Karar günlüğüne yaz (adım sonunu bekleme). Pano kararları ve adım ilerlemesini oradan canlı gösterir.
+**Decisions are logged immediately:** Write each decision to `docs/decisions/log.md` → decision log the moment it is made (do not wait for the step end). The dashboard shows decisions and step progress live from there.
 
-**Pahalı adımlar** (Adım 4'teki karar konseyi, Adım 6 kurul, Adım 7 tasarım): Başlamadan tahmini maliyeti (`docs/workflow/usage-limits.md` tablosu) ve kalan limiti tek satırla söyle. Adım kaldırılmaz; seçim kullanıcıdadır. Ayrıntılı derinlikte bildir ve yap. Hızlı ve Standart'ta sor: **Yap** / **Hafif yap** / **Sonraya bırak**. Önerilen: Hızlı'da "Sonraya bırak", Standart'ta "Hafif yap".
-- Hafif yap: Adım 4'te konsey yerine tek danışman görüşü; Adım 6'da önerilen 3 üye tek onayla; Adım 7'de tek önizleme turu (stil yönü), renk ve yazı tipi o yönün önerilen setinden.
-- Sonraya bırak: Adım 4'te tek yönlü kararı yine kullanıcı verir (önerilen + gerekçe ile). Adım 6 ve 7 için Faz 0'a görev eklenir (`/board setup`, `/design genel`).
+**Expensive steps** (decision council in Step 4, board in Step 6, design in Step 7): Before starting, state the estimated cost (table in `docs/workflow/usage-limits.md`) and the remaining limit in one line. The step is never removed; the user chooses. At Detailed depth, announce and do it. At Quick and Standard, ask: **Do it** / **Do it light** / **Leave for later**. Recommended: "Leave for later" at Quick, "Do it light" at Standard.
+- Do it light: In Step 4 one advisor opinion instead of the council; in Step 6 the 3 recommended members with one approval; in Step 7 a single preview round (style direction), color and font from that direction's recommended set.
+- Leave for later: In Step 4 the user still decides the one-way decision (recommended option + reasoning). For Steps 6 and 7, add tasks to Phase 0 (`/board setup`, `/design general`).
 
 ---
 
-## Adım 0: Hazırlık
-
-0. **Profil** (ilk soru): Hafif / Standart / Tam. Tabloyu `.claude/board/council.md` → "Ne zaman"den göster; Pro planda **Hafif** önerilen, Max planda Standart. Seçimi `docs/workflow/progress.md` → `**Profil:**` satırına yaz.
-   - **Hafif:** Şu eklentileri proje kapsamında kapat (her biri için `claude plugin disable <id> --scope project`): hookify@claude-plugins-official, claude-md-management@claude-plugins-official. (Paket eklentileri her profilde zaten kapalı gelir; komutlar gerektiğinde açmayı sorar.) `docs/workflow/board.md` → `**Commit denetimi:** kapalı`.
-   - **Standart / Tam:** Eklentiler ve commit denetimi açık kalır.
-   - **Komut listesi:** Hafif ve Standart'ta çekirdek dışı 19 komut skill listesinde sadece adıyla durur (`/` menüsünde var, adıyla çağrılır; kit varsayılanı). **Tam:** `node .claude/hooks/tools.mjs --commands full` (bütün açıklamalar listede; 200K bağlamda liste taşabilir).
-   - Profil sonradan değiştirilebilir; aynı adımları tersine uygula.
-0a. **Planlama derinliği** (ikinci soru, profilden ayrı: profil sürekli maliyeti, derinlik sadece bu sihirbazı belirler). Seçenekleri `docs/workflow/usage-limits.md` tablosundaki tahmini maliyetle göster. Fikir netse ve Pro plandaysa **Hızlı**, fikir belirsizse veya üründe ödeme/kişisel veri varsa **Standart** önerilen. Seçimi `**Profil:**` satırına ekle (örn. `Hafif · derinlik: Hızlı`).
-   - **Hızlı:** Adım 1 tek tur (problem, kitle, MVP çoklu seçim); kabul kriterleri taslak olarak tek onayla. Adım 4'te önerilen stack tek ekranda onaylanır. Adım 5 sadece veri modeli ve giriş yöntemi; dış servis ve birim ekonomisi ilgili göreve kalır.
-   - **Standart:** Bütün adımlar; pahalı adımlar başlamadan sorulur.
-   - **Ayrıntılı:** Bütün adımlar tam haliyle.
-0b. **Anlatıcı mod:** Sor: "Yazılımı yeni öğreniyorsan, Anlatıcı mod her değişikliği ve hatayı sade Türkçe anlatır. Cevaplar biraz uzar, bu da biraz daha fazla token demek. Açılsın mı?" Seçenekler: "Evet" ve "Hayır, kısa cevaplar". Kullanıcının bilgi seviyesi düşükse "Evet" önerilen olsun.
-    - Evet ise `.claude/settings.local.json` dosyasına `"outputStyle": "anlatici"` ekle (dosya varsa birleştir; bu dosya git'e girmez, kişisel ayardır).
-    - Mod bir sonraki mesajdan itibaren geçerli olur. Terminalde `/output-style anlatici` komutu da aynı işi yapar. Kapatmak için değeri sil.
-0c. **Araç:** Bu projede hangi yapay zekâ araçlarıyla çalışılacak? `.kit.json` → `tool` doluysa (`init` sırasında seçildi) tek satırla bildir, tekrar sorma. Yoksa **çoklu seçimle** sor:
-    - **Claude Code (Önerilen):** Kit bunun için yazıldı; bütün özellikler (kurul ajanları, soru arayüzü, durum çubuğu, limit).
-    - **Codex:** Kurallar `AGENTS.md`'den, komutlar skill olarak (`$start`), korumalar `.codex/hooks.json` ile. Kurul tek model, seçenekler düz metin, durum çubuğu yok.
-    - **Antigravity:** Kurallar `AGENTS.md`'den, komutlar skill olarak (`/start`), korumalar `.agents/hooks.json` ile. Kurul tek model, durum çubuğu yok.
-    Seçimi `**Profil:**` satırına ekle (örn. `araç: claude,codex`) ve Adım 3'teki kurulum komutuna `--tool <liste>` olarak ver. Claude Code dosyaları her durumda kurulur (hook betikleri ortaktır).
-0d. **Auto memory** (sadece Claude Code): Claude Code varsayılan olarak düzeltmelerinden kendine not tutar. Notlar bu makinede kalır, git'e girmez, ekip görmez ve kimse gözden geçirmez. Sor:
-    - **Kapalı (Önerilen):** Projenin hafızası `AGENTS.md`, `progress.md` ve karar günlüğünde; görünür ve git'te. Tekrarlayan hatalar `/fix-bug` ile "Öğrenilen kurallar"a önerilir. `.claude/settings.json`'a `"autoMemoryEnabled": false` ekle (dosyayı birleştir).
-    - **Açık:** Tercihlerin oturumlar arasında kendiliğinden hatırlanır; notlar `AGENTS.md` ile çelişebilir. Ayara dokunma.
-    Seçimi `**Profil:**` satırına ekle (örn. `hafıza: kapalı`). Kaynak: code.claude.com/docs/en/memory (2026-10-25).
-0e. **Model ve effort** (`docs/workflow/models.md`): `/build` adım 0b'deki iki ekranı sor ve kaydet. Planlama işleri ana oturumda, araştırma ve tarama doküman rolünde, kurul inceleme rolünde çalışır; Adım 6'da model ayrıca sorulmaz.
-1. Ortamı kontrol et ve tek satırla raporla: `node --version`, `git --version` ve kitin yeri. İki kurulum yolu var: kökte `kit/kit.mjs` (template yolu) ya da `.kit.json` → `kit` alanındaki klasör (`init` ile kurulmuş, `type` boş). `kit` alanı `npx:tillerhand@<sürüm>` ise kit npm paketinden kurulmuştur. `local` ise klasörün bu makinedeki yolu git dışı `.kit.local.json` → `kit`'tedir; o dosya yoksa kullanıcıya kit klasörünü sor ya da `npx -y tillerhand@<.kit.json → version>` kullan. Klasörde zaten uygulama kodu varsa (`package.json`, `pyproject.toml`, `src/` vb.) dur ve `/adopt` öner.
-2. `docs/workflow/skills.md`'deki plugin'lerin skill'leri senin skill listende var mı bak. LSP eklentisi dil sunucusu ister: web ve mobil için `npm i -g typescript-language-server typescript`, backend için `npm i -g pyright` (global kurulum; kullanıcı onayıyla). **Eklentiler:** Proje ayarı eklentileri açar ama indirmez; kurulmamış olanlar yükleme hatası verir ve skill'leri gelmez. Kullanıcıya listeyi göster ve sor: "Proje ayarındaki eklentiler kurulsun mu?" Önce `node .claude/hooks/plugins-sync.mjs` ile eksikleri listele; onay gelirse `node .claude/hooks/plugins-sync.mjs --install` çalıştır. Betik eksikleri proje kapsamında kurar, `false` olanları (paket eklentileri: tasarım, güvenlik, yayın, video) kurup kapatır. Kullanıcıya tek cümleyle söyle: "Paketler kapalı gelir, ilgili komut gerektiğinde açmayı sorar; durum için `/tools`." Sonra kullanıcıdan `/reload-plugins` çalıştırmasını iste. claude CLI yoksa eksik eklentilerin `/plugin install x@y` komutlarını ver ve "Kurup devam edelim mi, eksik skill olmadan mı?" diye sor.
-3. `caveman:caveman` skill'ini yükle (rapor dili).
-4. **Limit:** Limiti oku (`docs/workflow/usage-limits.md` §1) ve raporla. Seçilen derinliğin tahmini maliyetini kalan limitle karşılaştır; adımlar arasında durup sonra devam edilebileceğini söyle. Seviye sarı veya kırmızıysa bunu tek satırla söyle; durdurma.
-5. **Kod haritası:** Oturumda codebase-memory-mcp araçları (`index_repository`, `search_graph` vb.) var mı bak. Yoksa sor: "Kod haritası kurulsun mu? AI, kodu dosya dosya okumak yerine sorgular; proje büyüdükçe oturum başına ciddi token tasarrufu sağlar."
-   - **Kur (Önerilen):** Kurulumu kullanıcı kendi terminalinde yapar; uzaktan indirilen script'i sen çalıştırma. Resmi komutları ver:
+## Step 0: Preparation
+
+**Language (before anything else):** If `node .claude/hooks/lang.mjs --show` returns a code other than `none`, the language is already chosen; do not ask again. Otherwise ask with AskUserQuestion, **in English**: "Which language should I talk to you in?" Options: Turkish / English / Other. For Other, the user types the language name; convert it to a BCP-47 code (`de`, `pt-BR`) and confirm in one sentence if unsure. Run `node .claude/hooks/lang.mjs --set <code>`. If the code is not `tr` or `en`, translate the hook texts the user sees: translate the output of `node .claude/hooks/lang.mjs --export` into that language (placeholders in curly braces such as `{command}`, `{step}` stay unchanged), pass the JSON to `node .claude/hooks/lang.mjs --write` through stdin, then `--check` must say `ok`. From then on every question, option, answer, status block and document text you write is in this language; no rule relaxes this. Bold labels in documents (such as `**Aktif faz:**`) stay as they are; tools read them. Do not generate the dashboard before the language is chosen.
+
+0. **Profile** (first question after language): Light / Standard / Full. Show the table from `.claude/board/council.md` → "When"; **Light** is recommended on the Pro plan, Standard on the Max plan. Write the choice to `docs/workflow/progress.md` → `**Profil:**` line as `Hafif`, `Standart` or `Tam` (tools read these words; show the English names in the question).
+   - **Light:** Disable these plugins at project scope (for each: `claude plugin disable <id> --scope project`): hookify@claude-plugins-official, claude-md-management@claude-plugins-official. (Package plugins come disabled in every profile anyway; commands ask to enable them when needed.) `docs/workflow/board.md` → `**Commit denetimi:** kapalı`.
+   - **Standard / Full:** Plugins and commit review stay on.
+   - **Command list:** In Light and Standard, the 20 non-core commands appear in the skill list by name only (they exist in the `/` menu and are called by name; kit default). **Full:** `node .claude/hooks/tools.mjs --commands full` (all descriptions in the list; the list may overflow a 200K context).
+   - The profile can be changed later; apply the same steps in reverse.
+0a. **Planning depth** (second question, separate from profile: profile sets the ongoing cost, depth only shapes this wizard). Show the options with the estimated cost from the `docs/workflow/usage-limits.md` table. **Quick** is recommended if the idea is clear and the plan is Pro; **Standard** if the idea is vague or the product has payment or personal data. Append the choice to the `**Profil:**` line (e.g. `Hafif · depth: Hızlı`).
+   - **Quick:** Step 1 in one round (problem, audience, MVP multi-select); acceptance criteria as a draft with one approval. In Step 4 the recommended stack is approved on a single screen. Step 5 covers only the data model and sign-in method; external services and unit economics are left to the related task.
+   - **Standard:** All steps; expensive steps are asked before they start.
+   - **Detailed:** All steps in full.
+   In the `**Profil:**` line write the depth as `Hızlı`, `Standart` or `Ayrıntılı`.
+0b. **Narrator mode:** Ask: "If you are new to software, Narrator mode explains every change and error in plain language. Answers get a bit longer, which means a few more tokens. Turn it on?" Options: "Yes" and "No, short answers". If the user's knowledge level is low, "Yes" is the recommended option.
+    - If yes, add `"outputStyle": "anlatici"` to `.claude/settings.local.json` (merge if the file exists; this file stays out of git, it is a personal setting).
+    - The mode takes effect from the next message. In the terminal, `/output-style anlatici` does the same. To turn it off, delete the value.
+0c. **Tool:** Which AI tools will be used in this project? If `.kit.json` → `tool` is set (chosen during `init`), report it in one line and do not ask again. Otherwise ask with **multi-select**:
+    - **Claude Code (Recommended):** The kit is written for it; all features (board agents, question interface, status line, limit).
+    - **Codex:** Rules from `AGENTS.md`, commands as skills (`$start`), protections through `.codex/hooks.json`. Single-model board, options as plain text, no status line.
+    - **Antigravity:** Rules from `AGENTS.md`, commands as skills (`/start`), protections through `.agents/hooks.json`. Single-model board, no status line.
+    Append the choice to the `**Profil:**` line (e.g. `tools: claude,codex`) and pass it as `--tool <list>` to the install command in Step 3. Claude Code files are installed in every case (hook scripts are shared).
+0d. **Auto memory** (Claude Code only): By default Claude Code keeps notes to itself from your corrections. The notes stay on this machine, do not enter git, the team cannot see them and nobody reviews them. Ask:
+    - **Off (Recommended):** The project's memory lives in `AGENTS.md`, `progress.md` and the decision log; visible and in git. Repeated mistakes are proposed to "Öğrenilen kurallar" (learned rules) through `/fix-bug`. Add `"autoMemoryEnabled": false` to `.claude/settings.json` (merge the file).
+    - **On:** Your preferences are remembered across sessions on their own; notes may conflict with `AGENTS.md`. Leave the setting alone.
+    Append the choice to the `**Profil:**` line (e.g. `memory: off`). Source: code.claude.com/docs/en/memory (2026-10-25).
+0e. **Model and effort** (`docs/workflow/models.md`): Ask the two screens in `/build` step 0b and save them. Planning work runs in the main session, research and scanning in the document role, board review in the review role; the model is not asked separately in Step 6.
+1. Check the environment and report in one line: `node --version`, `git --version` and the kit's location. There are two install paths: `kit/kit.mjs` at the root (template path) or the folder in `.kit.json` → `kit` field (installed with `init`, `type` empty). If the `kit` field is `npx:tillerhand@<version>`, the kit was installed from the npm package. If it is `local`, the folder's path on this machine is in the git-ignored `.kit.local.json` → `kit`; if that file is missing, ask the user for the kit folder or use `npx -y tillerhand@<.kit.json → version>`. If the folder already has application code (`package.json`, `pyproject.toml`, `src/` etc.), stop and suggest `/adopt`.
+2. Check whether the skills of the plugins in `docs/workflow/skills.md` are in your skill list. The LSP plugin needs a language server: `npm i -g typescript-language-server typescript` for web and mobile, `npm i -g pyright` for backend (global install; with user approval). **Plugins:** The project settings enable plugins but do not download them; missing ones give a load error and their skills do not arrive. Show the user the list and ask: "Should the plugins in the project settings be installed?" First list the missing ones with `node .claude/hooks/plugins-sync.mjs`; if approved, run `node .claude/hooks/plugins-sync.mjs --install`. The script installs the missing ones at project scope and installs then disables those set to `false` (package plugins: design, security, release, video). Tell the user in one sentence: "Packages come disabled; the related command asks to enable them when needed; use `/tools` for status." Then ask the user to run `/reload-plugins`. If the claude CLI is missing, give the `/plugin install x@y` commands of the missing plugins and ask "Install and continue, or continue without the missing skills?".
+3. Load the `caveman:caveman` skill (report language).
+4. **Limit:** Read the limit (`docs/workflow/usage-limits.md` §1) and report it. Compare the estimated cost of the chosen depth with the remaining limit; say that you can stop between steps and continue later. If the level is yellow or red, say so in one line; do not stop.
+5. **Code map:** Check whether codebase-memory-mcp tools (`index_repository`, `search_graph` etc.) exist in the session. If not, ask: "Install the code map? The AI queries code instead of reading it file by file; as the project grows it saves a lot of tokens per session."
+   - **Install (Recommended):** The user installs it in their own terminal; do not run a remotely downloaded script yourself. Give the official commands:
      - Windows (PowerShell): `Invoke-WebRequest -Uri https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.ps1 -OutFile install.ps1; Unblock-File .\install.ps1; .\install.ps1`
      - macOS/Linux: `curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash`
-     - Installer Claude Code'a kendisini kullanıcı düzeyinde tanıtır (MCP, hook, skill). Sonra Claude Code yeniden başlatılır ve `/mcp` ile kontrol edilir. Otomatik indeks için: `codebase-memory-mcp config set auto_index true`. Kaynak: github.com/DeusData/codebase-memory-mcp
-   - **Şimdilik kurma:** Küçük proje için yeterli; sonra kurulabilir.
-6. **Bildirimler:** Claude soru sorduğunda veya uzun bir işi bitirdiğinde masaüstü bildirimi gelir (`.claude/hooks/notify.mjs`). Kapatmak için `KIT_NOTIFY=off`.
-6b. **Pano:** `node .claude/hooks/dashboard.mjs` çalıştır. Sor: "Pano kararları ve adım ilerlemesini canlı gösterir, her cevaptan sonra kendini yeniler. Tarayıcıda açayım mı?" Evet ise aç: Windows `start dashboard.html`, macOS `open dashboard.html`, Linux `xdg-open dashboard.html`.
-7. Fikir boşsa sor: "Ne yapmak istiyorsun? 1-3 cümleyle anlat."
+     - The installer registers itself with Claude Code at user level (MCP, hook, skill). Then restart Claude Code and check with `/mcp`. For automatic indexing: `codebase-memory-mcp config set auto_index true`. Source: github.com/DeusData/codebase-memory-mcp
+   - **Skip for now:** Enough for a small project; can be installed later.
+6. **Notifications:** A desktop notification arrives when Claude asks a question or finishes a long task (`.claude/hooks/notify.mjs`). To turn off, set `KIT_NOTIFY=off`.
+6b. **Dashboard:** Run `node .claude/hooks/dashboard.mjs`. Ask: "The dashboard shows decisions and step progress live and refreshes itself after every answer. Open it in the browser?" If yes, open it: Windows `start dashboard.html`, macOS `open dashboard.html`, Linux `xdg-open dashboard.html`.
+7. If the idea is empty, ask: "What do you want to build? Describe it in 1-3 sentences."
 
-## Adım 1: Fikri netleştir → `docs/product/prd.md`
+## Step 1: Clarify the idea → `docs/product/prd.md`
 
-`mattpocock-skills:grilling` yaklaşımıyla fikri sorgula. Soruları **AskUserQuestion ile, turlar halinde** sor (her tur en fazla 4 soru). Mümkün olan her soruya fikirden çıkardığın 2-4 somut seçenek ve önerini koy; açık uçlu soruyu sadece seçenek üretemiyorsan sor.
+Question the idea with the `mattpocock-skills:grilling` approach. Ask questions **with AskUserQuestion, in rounds** (at most 4 questions per round). For every question where possible, give 2-4 concrete options drawn from the idea, plus your recommendation; ask an open-ended question only if you cannot produce options.
 
-Sırayla netleştir:
-1. Problem ve hedef kullanıcı (kim, hangi durumda, şu an ne kullanıyor?)
-2. Değer önerisi ve rakiplerden farkı
-3. MVP özellikleri: Fikirden 5-8 aday özellik çıkar. "Hangileri ilk sürümde olmalı?" diye **çoklu seçim** ile sor. Seçilmeyenler "Kapsam dışı" olur.
-4. Her MVP özelliği için kabul kriteri taslağı yaz ve onaylat.
-5. Başarı kriterleri, gelir modeli (ücretsiz / abonelik / tek seferlik / reklam), bütçe (aylık altyapı + AI), süre.
-6. Kişisel veri, ödeme ve AI kullanımı var mı?
+Clarify in this order:
+1. Problem and target user (who, in which situation, what do they use now?)
+2. Value proposition and difference from competitors
+3. MVP features: Draw 5-8 candidate features from the idea. Ask "Which ones should be in the first release?" with **multi-select**. Unselected ones become "Kapsam dışı" (out of scope).
+4. Write a draft of acceptance criteria for each MVP feature and get it approved.
+5. Success criteria, revenue model (free / subscription / one-time / ads), budget (monthly infrastructure + AI), timeline.
+6. Will there be personal data, payment and AI usage?
 
-MVP büyük görünüyorsa küçültmeyi bir karar olarak sor. Fikirdeki riskleri açıkça söyle. `docs/product/prd.md`'yi yaz, özetini göster, onay al.
+If the MVP looks big, ask shrinking it as a decision. State the risks in the idea openly. Write `docs/product/prd.md`, show its summary, get approval.
 
-**1b. Araştırma (pahalı adım, isteğe bağlı):** Sor: "Fikirle ilgili makaleleri, GitHub'daki benzer projeleri ve rakip ürünleri araştırayım mı? Hızlı araştırma 5 saatlik limitin yaklaşık %10-15'i." Seçenekler: Yap / Sonraya bırak (Faz 0'a `/research` görevi eklenir). Önerilen: fikir alanı tanıdık değilse veya ticari üründe "Yap", aksi halde "Sonraya bırak". Yap ise `/research` akışını uygula; seçilen özellikler PRD'ye girer.
+**1b. Research (expensive step, optional):** Ask: "Should I research articles, similar projects on GitHub and competing products related to the idea? Quick research is about 10-15% of the 5-hour limit." Options: Do it / Leave for later (a `/research` task is added to Phase 0). Recommended: "Do it" if the idea area is unfamiliar or the product is commercial, otherwise "Leave for later". If Do it, run the `/research` flow; selected features go into the PRD.
 
-## Adım 2: Proje tipi
+## Step 2: Project type
 
-AskUserQuestion ile sor. Seçenekleri ve önerini PRD'ye göre gerekçelendir:
-- **Web uygulaması / SaaS:** Tarayıcıdan kullanılan ürün, açılış sayfası + panel. SEO, hızlı yayın, mağaza onayı yok.
-- **Mobil uygulama:** Cihaz özellikleri (kamera, bildirim, konum), günlük alışkanlık ürünü. Mağaza süreci ve iki platform var.
-- **Backend / API / otomasyon:** Arayüzü olmayan servis, bot, veri işleme, başka uygulamalara API.
+Ask with AskUserQuestion. Justify the options and your recommendation by the PRD:
+- **Web app / SaaS:** A product used from the browser, landing page + panel. SEO, fast release, no store approval.
+- **Mobile app:** Device features (camera, notifications, location), daily-habit product. Store process and two platforms.
+- **Backend / API / automation:** A service without a UI, bot, data processing, API for other apps.
 
-Kullanıcı birden fazlasını isterse (örn. web + mobil) önce hangisinin MVP olacağını sor; diğeri yol haritasına sonraki faz olarak girer.
+If the user wants more than one (e.g. web + mobile), first ask which one will be the MVP; the other enters the roadmap as a later phase.
 
-Ayrıca sor: **Projede yapay zeka (LLM) özelliği olacak mı?** Evet ise AI eki kurulur. **Türkiye'de satış yapacak veya Türk kullanıcısı olacak mı?** Evet ise Türkiye eki (`tr`) önerilir: KVKK yurt dışı aktarım, e-Fatura/e-Arşiv, iyzico/PayTR bildirim imzası (web-saas ve backend'de kodlu), İ/ı testleri. Birden fazla ek virgülle: `--addons ai,tr`.
+Also ask: **Will the project have an AI (LLM) feature?** If yes, the AI add-on is installed. **Will it sell in Turkey or have Turkish users?** If yes, the Turkey add-on (`tr`) is recommended: KVKK cross-border transfer, e-Fatura/e-Arşiv, iyzico/PayTR notification signature (coded in web-saas and backend), İ/ı tests. Several add-ons with a comma: `--addons ai,tr`.
 
-## Adım 3: Kurulum
+## Step 3: Installation
 
-Kullanıcıya ne yapılacağını tek cümleyle söyle, sonra çalıştır:
+Tell the user in one sentence what will be done, then run:
 
 ```bash
-# template yolu (kökte kit/ var): kit/ kurulumdan sonra silinir
+# template path (kit/ is in the root): kit/ is deleted after the install
 node kit/kit.mjs install --type <web-saas|mobile|backend> [--addons ai,tr] [--tool claude,codex,antigravity]
-# init yolu (.kit.json → kit; "local" ise .kit.local.json → kit, o dosya yoksa kullanıcıya sor): kit klasörüne dokunulmaz; araç init'te seçildiyse --tool gerekmez
+# init path (.kit.json → kit; if "local", .kit.local.json → kit, ask the user if that file is missing): the kit folder is not touched; --tool is not needed if the tool was chosen at init
 node <kit>/kit/kit.mjs install --type <web-saas|mobile|backend> [--addons ai,tr] --project .
-# npm yolu (.kit.json → kit = npx:tillerhand@<sürüm>): aynı sürümle. Sürüm tam olarak 1.2.3 biçiminde ve .kit.json → version ile aynı değilse dur, kullanıcıya sor
-npx -y tillerhand@<sürüm> install --type <web-saas|mobile|backend> [--addons ai,tr] --project .
+# npm path (.kit.json → kit = npx:tillerhand@<version>): with the same version. If the version is not exactly in the form 1.2.3 or differs from .kit.json → version, stop and ask the user
+npx -y tillerhand@<version> install --type <web-saas|mobile|backend> [--addons ai,tr] --project .
 ```
 
-Çıktıyı raporla. Artık `docs/architecture/stack.md` seçilen tipin dosyasıdır. Proje yapısını (`docs/architecture/structure.md`) kullanıcıya kısaca göster: kod özellik bazlı olacak, yapı haritası (`.claude/structure.json`) korunacak, deneme işleri `sandbox/` altına gidecek. Commit öner: `chore: kit kurulumu (<tip>)`.
+Report the output. From now on `docs/architecture/stack.md` is the chosen type's file. Show the user the project structure (`docs/architecture/structure.md`) briefly: code will be organized by feature, the structure map (`.claude/structure.json`) will be enforced, experiments go under `sandbox/`. Suggest a commit: `chore: kit kurulumu (<tip>)`.
 
-## Adım 4: Teknoloji kararları → `docs/architecture/stack.md`
+## Step 4: Technology decisions → `docs/architecture/stack.md`
 
-`docs/architecture/stack.md` → **"Karar noktaları"** bölümündeki her kararı sırayla sor (birbirine bağlı olanlar sırayla, bağımsızlar aynı turda, en fazla 4).
-- Katalogdaki seçeneklerden bu projeye en uygun 2-4 tanesini seç. Önerini PRD'ye dayandır (kitle, bütçe, ölçek, ekip bilgisi, SEO ihtiyacı vb.).
-- Sürüm, fiyat veya ücretsiz katman bilgisine dayanan seçeneklerde yalnız değişeni doğrula: katalogda `(kaynak: <adres>, YYYY-AA-GG)` notu 90 günden yeni olan iddiayı yeniden araştırma. Notsuz ya da eski iddiaları, kullanıcıya sunacağın seçeneklerle sınırlı olarak, adımın başında tek bir `source-research` turunda topla (karar başına ayrı araştırma yok). Doğruladığın iddianın yanına bu projenin `stack.md`'sinde kaynak ve tarih notunu yaz.
-- Kullanıcı "hangisi daha iyi, emin değilim" derse farkları somut bir örnekle anlat ve tekrar sor.
+Ask every decision in the **"Decision points"** section of `docs/architecture/stack.md` in order (dependent ones in sequence, independent ones in the same round, at most 4).
+- From the catalog options, pick the 2-4 best suited to this project. Base your recommendation on the PRD (audience, budget, scale, team knowledge, SEO need etc.).
+- For options that depend on version, price or free-tier information, verify only what changes: do not re-research a claim whose `(kaynak: <adres>, YYYY-AA-GG)` note in the catalog is newer than 90 days. Gather the claims without a note or with an old note, limited to the options you will present to the user, in a single `source-research` round at the start of the step (no separate research per decision). Next to a claim you verified, write the source and date note in this project's `stack.md`.
+- If the user says "which is better, I'm not sure", explain the differences with a concrete example and ask again.
 
-Bütün kararlar bitince:
-1. docs/architecture/stack.md → "Seçilen teknolojiler" tablosunu doldur.
-2. Seçim önerilenden farklıysa docs/architecture/stack.md'nin Komutlar, Klasör yapısı, Kodlama kuralları, AI hataları ve Doğrulama bölümlerini seçime göre yeniden yaz. Bunlara bağlı `.github/workflows/ci.yml`, `.claude/settings.json` izinleri, `.env.example`, pre-commit ayarları ve `.mcp.json` dosyalarını da uyarla. Farkları raporla.
-3. `AGENTS.md` → Komutlar bölümünü doldur. `önizleme:` satırına uygulamanın yerel adresini yaz (örn. `http://localhost:3000`); arayüzü olmayan projede boş kalır.
-3a. **Başka bilgisayarda kurulabilirlik:** Çalışma ortamı sürümünü sabitle: Node için `.nvmrc`, Python için `.python-version` (sürüm stack.md'deki). `README.md` → Gereksinimler (çalışma ortamı ve sürümü, sistem bağımlılıkları: veritabanı, ffmpeg vb., hesaplar) ve Kurulum bölümlerini doldur; komutlar `AGENTS.md` → Komutlar ile aynı olsun. Kilit dosyası (`package-lock.json`, `uv.lock` vb.) ilk paket kurulumunda oluşur ve commit'e girer.
-3b. **Stack skill'leri:** Web'de (React/Next) `npx -y skills@1.7.2 add vercel-labs/agent-skills --skill react-best-practices --skill composition-patterns -a claude-code -y --copy`, mobilde `--skill react-native-guidelines` ile çalıştır. Gelen SKILL.md dosyalarını kurmadan önce oku (üçüncü taraf içerik). Mobilde Maestro CLI kurulu değilse kurulumunu söyle (`docs/workflow/mcp-catalog.md`).
-3c. **3D (web, PRD'de 3D sahne, ürün görselleştirme veya WebGL efekti varsa):** three.js `teknik` karar olarak sorulur. Seçilirse `CloudAI-X/threejs-skills`'ten (MIT, topluluk) üç skill sabit commit'ten kopyalanır: `threejs-fundamentals`, `threejs-performance` ve React'te `threejs-react-three-fiber`. Her biri için `curl -fsSL https://raw.githubusercontent.com/CloudAI-X/threejs-skills/0e181866f095b5f06d005133876e926515390d95/skills/<ad>/SKILL.md -o .claude/skills/<ad>/SKILL.md` (klasörü önce oluştur). Dosyaları kurmadan önce oku (üçüncü taraf içerik). Diğer konular (shader, ışık, yükleyici) için skill eklenmez, Context7 kullanılır. 3D kuralları `ui-motion` → "3D".
-4. `docs/decisions/log.md`: Günlükte eksik karar kalmadığını kontrol et, teknoloji yığınını `docs/decisions/adr-0001-tech-stack.md` olarak kaydet (şablon: `adr-template.md`).
+When all decisions are done:
+1. Fill the "Seçilen teknolojiler" (chosen technologies) table in docs/architecture/stack.md.
+2. If the choice differs from the recommended one, rewrite the Folder structure, Coding rules, Common AI mistakes and Verification sections of docs/architecture/stack.md to match the choice. Also adapt the files that depend on them: `.github/workflows/ci.yml`, `.claude/settings.json` permissions, `.env.example`, pre-commit settings and `.mcp.json`. Report the differences.
+3. Fill the "Komutlar" (commands) section of `AGENTS.md`. Write the app's local address in the `önizleme:` line (e.g. `http://localhost:3000`); it stays empty in a project without a UI.
+3a. **Installable on another computer:** Pin the runtime version: `.nvmrc` for Node, `.python-version` for Python (the version in stack.md). Fill the "Requirements" section of `README.md` (runtime and its version, system dependencies: database, ffmpeg etc., accounts) and its "Installation" section; the commands must match `AGENTS.md` "Komutlar". The lock file (`package-lock.json`, `uv.lock` etc.) is created at the first package install and goes into the commit.
+3b. **Stack skills:** For web (React/Next) run `npx -y skills@1.7.2 add vercel-labs/agent-skills --skill react-best-practices --skill composition-patterns -a claude-code -y --copy`, for mobile with `--skill react-native-guidelines`. Read the incoming SKILL.md files before installing them (third-party content). For mobile, if the Maestro CLI is not installed, tell the user how to install it (`docs/workflow/mcp-catalog.md`).
+3c. **3D (web, if the PRD has a 3D scene, product visualization or a WebGL effect):** three.js is asked as a `teknik` decision. If chosen, three skills are copied from a pinned commit of `CloudAI-X/threejs-skills` (MIT, community): `threejs-fundamentals`, `threejs-performance` and, in React, `threejs-react-three-fiber`. For each: `curl -fsSL https://raw.githubusercontent.com/CloudAI-X/threejs-skills/0e181866f095b5f06d005133876e926515390d95/skills/<ad>/SKILL.md -o .claude/skills/<ad>/SKILL.md` (create the folder first). Read the files before installing them (third-party content). No skill is added for other topics (shader, light, loader); use Context7. 3D rules are in `ui-motion` → "3D".
+4. `docs/decisions/log.md`: Check that no decision is missing from the log, record the technology stack as `docs/decisions/adr-0001-tech-stack.md` (template: `adr-template.md`).
 
-## Adım 5: Mimari → `docs/architecture/overview.md`, `docs/product/glossary.md`
+## Step 5: Architecture → `docs/architecture/overview.md`, `docs/product/glossary.md`
 
-`mattpocock-skills:domain-modeling` ve `mattpocock-skills:codebase-design` ile:
-1. **Veri modeli:** Tablo/varlık taslağını göster. Belirsiz noktaları karar olarak sor: ilişki türü, silme davranışı (kalıcı / çöp kutusu), kişisel veri alanları, saklama süresi.
-2. **Kimlik ve yetki:** Giriş yöntemleri (e-posta + şifre, magic link, Google, Apple) ve roller. Çoklu seçimle sor.
-3. **Dış servisler:** Aylık maliyet tahminiyle tablo; ücretli olan her servis için onay al. Seçilen servisin `docs/workflow/mcp-catalog.md`'de bağlantısı varsa (GitHub, Stripe, Vercel, PostHog, Figma, Firebase, Linear) kurulmasını öner; kimliği kullanıcı kendisi bağlar (OAuth veya ortam değişkeni). Her servisi `docs/operations/accounts.md`'ye ekle (sahip, 2FA, bitiş tarihi; şifre yazma). Ücretli her servis için `docs/operations/spend-alarms.md` → Alarmlar tablosuna satır ekle ve tavan tutarını sor (önerilen: birim ekonomisindeki aylık tahminin 2 katı).
-3b. **Birim ekonomisi** (ücretli ürünse): `docs/product/unit-economics.md` girdilerini fiyat, komisyon, sabit ve kullanıcı başı maliyet tahminleriyle doldur. Katkı payı negatif veya değişken maliyet fiyatın %30'unu geçiyorsa bunu `maliyet` kararı olarak sor (fiyat / kullanım limiti / model seçimi).
-4. **Ortamlar:** Lokal / önizleme / prod ayrımı.
-5. `docs/product/glossary.md`: Ana kavramlar, arayüz adları ve durum geçişleri. Arayüzde "sen" mi "siz" mi kullanılacağını sor.
+With `mattpocock-skills:domain-modeling` and `mattpocock-skills:codebase-design`:
+1. **Data model:** Show the table/entity draft. Ask unclear points as decisions: relation type, delete behavior (permanent / trash), personal data fields, retention period.
+2. **Identity and authorization:** Sign-in methods (email + password, magic link, Google, Apple) and roles. Ask with multi-select.
+3. **External services:** A table with monthly cost estimates; get approval for every paid service. If the chosen service has a connection in `docs/workflow/mcp-catalog.md` (GitHub, Stripe, Vercel, PostHog, Figma, Firebase, Linear), suggest installing it; the user connects the identity themselves (OAuth or environment variable). Add every service to `docs/operations/accounts.md` (owner, 2FA, expiry date; do not write passwords). For every paid service add a row to the "Alarmlar" (alarms) table in `docs/operations/spend-alarms.md` and ask the cap amount (recommended: 2 times the monthly estimate in unit economics).
+3b. **Unit economics** (if it is a paid product): Fill the inputs of `docs/product/unit-economics.md` with estimates for price, commission, fixed and per-user cost. If the contribution margin is negative or the variable cost exceeds 30% of the price, ask it as a `maliyet` decision (price / usage limit / model choice).
+4. **Environments:** Local / preview / prod separation.
+5. `docs/product/glossary.md`: Main concepts, UI names and state transitions. Ask whether the UI will use the informal or formal "you" (Turkish "sen" or "siz").
 
-AI eki kurulduysa `docs/ai/guide.md` → model envanterini doldur: Hangi özellik hangi model? Bunu maliyet tahminiyle karar olarak sor.
+If the AI add-on is installed, fill the model inventory in `docs/ai/guide.md`: Which feature uses which model? Ask this as a decision with the cost estimate.
 
-## Adım 6: Uzman kurulu → `.claude/agents/`, `docs/workflow/board.md`
+## Step 6: Expert board → `.claude/agents/`, `docs/workflow/board.md`
 
-Pahalı adım: önce maliyeti söyle ve derinliğe göre sor (yukarıdaki "Pahalı adımlar").
+Expensive step: state the cost first and ask by depth (see "Expensive steps" above).
 
-`.claude/board/rules.md` §5'i uygula:
-1. Tipe, PRD'ye ve seçilen stack'e göre kurul öner. Kurulun ne olduğunu kısaca anlat: Uzman ajanlar planı, görevi, her commit'i ve fazı denetler. Danışmandır; kritik bulguda durdurur; karar her zaman kullanıcıda.
-2. Üyeleri **çoklu seçimle** onaylat; yeni uzman eklenebileceğini söyle.
-3. Üyeler inceleme rolünün modeli ve effort'uyla çalışır (Adım 0e, `docs/workflow/models.md`); ayrıca sorma. Pro planda tam kurul toplantısının tahmini maliyetini söyle (`docs/workflow/usage-limits.md`).
-4. Commit denetimi açık mı kalsın? Varsayılan açık ve hafif: en fazla 2 üye, `haiku`, sadece diff.
-5. Ajan dosyalarını üret ve "Bu proje" bölümlerini doldur. `docs/workflow/board.md`'yi doldur.
-6. Yeni ajanların bir sonraki oturumda yükleneceğini söyle.
+Apply `.claude/board/rules.md` §5:
+1. Propose a board based on the type, the PRD and the chosen stack. Explain briefly what the board is: Expert agents review the plan, the task, every commit and the phase. It is advisory; it stops on a critical finding; the decision is always the user's.
+2. Get the members approved with **multi-select**; say that a new expert can be added.
+3. Members work with the review role's model and effort (Step 0e, `docs/workflow/models.md`); do not ask separately. On the Pro plan, state the estimated cost of a full board meeting (`docs/workflow/usage-limits.md`).
+4. Keep commit review on? Default on and light: at most 2 members, `haiku`, diff only.
+5. Generate the agent files and fill their "This project" sections. Fill `docs/workflow/board.md`.
+6. Say that the new agents load in the next session.
 
-## Adım 7: Tasarım yönü (arayüz varsa)
+## Step 7: Design direction (if there is a UI)
 
-Pahalı adım: önce maliyeti söyle ve derinliğe göre sor (yukarıdaki "Pahalı adımlar"). `/design genel` akışını çalıştır. Görsel önizlemelerle stil yönü, renk, yazı tipi ve detay kararları alınır; sonunda `PRODUCT.md`, `DESIGN.md` ve `docs/design/design-guide.md` hazır olur. Backend tipinde bu adımı atla.
+Expensive step: state the cost first and ask by depth (see "Expensive steps" above). Run the `/design general` flow. Style direction, color, font and detail decisions are made with visual previews; at the end `PRODUCT.md`, `DESIGN.md` and `docs/design/design-guide.md` are ready. Skip this step for the backend type.
 
-## Adım 8: Yol haritası → `docs/product/roadmap.md`
+## Step 8: Roadmap → `docs/product/roadmap.md`
 
-1. MVP özelliklerini tek oturumluk görevlere böl; Faz 0'daki kurulum görevlerini koru. Her özelliğin ilk görevi "kabul testlerini yaz (kırmızı)" olsun (`docs/quality/test-plan.md` §1a). Ödeme, AI, toplu bildirim ve veri silen özellikler için bayrak görevi ekle (`docs/operations/feature-flags.md`). Faz 1'den itibaren her fazın son görevi "Refactor turu" olsun (karmaşıklık bütçesi tüm depoda temiz: `node .claude/hooks/budget.mjs --check`).
-2. Sor: "Faz 1'de önce hangi özellikle başlayalım?" (öneri: en riskli veya en değerli olan).
-3. Sor: "Lansman hedefi ne?" (tarih / özellik tamamlanınca / sadece kişisel kullanım). Kişisel kullanımsa `docs/product/launch.md`'yi silmeyi öner.
-4. Yol haritasını özetle ve onay al.
+1. Split the MVP features into single-session tasks; keep the setup tasks in Phase 0. Make the first task of each feature "write the acceptance tests (red)" (`docs/quality/test-plan.md` §1a). For payment, AI, bulk notification and data-deleting features, add a feature flag task (`docs/operations/feature-flags.md`). From Phase 1 on, make the last task of every phase a "Refactor round" (complexity budget clean across the whole repo: `node .claude/hooks/budget.mjs --check`).
+2. Ask: "Which feature should we start with in Phase 1?" (suggestion: the riskiest or most valuable one).
+3. Ask: "What is the launch target?" (date / when features are complete / personal use only). If personal use, suggest deleting `docs/product/launch.md`.
+4. Summarize the roadmap and get approval.
 
-## Adım 9: Kapanış
+## Step 9: Closing
 
-1. `docs/workflow/progress.md`: Aktif faz `Faz 0`, aktif görev `G-001`, başlangıç adımı `9/9`, sıradaki adım, bekleyen kararlar.
-2. `node .claude/hooks/dashboard.mjs` çalıştır.
-3. Kullanıcıya özet ver: alınan karar sayısı, seçilen stack, kurul üyeleri, tasarım yönü, MVP özellikleri, sonraya bırakılan adımlar, ilk görev, kalan limit.
-4. Commit öner: `docs: proje planı`.
-5. Son satır: "Devam: `/build G-001`".
+1. `docs/workflow/progress.md`: Active phase `Faz 0`, active task `G-001`, start step `9/9`, next step, pending decisions.
+2. Run `node .claude/hooks/dashboard.mjs`.
+3. Give the user a summary: number of decisions made, chosen stack, board members, design direction, MVP features, steps left for later, first task, remaining limit.
+4. Suggest a commit: `docs: project plan`.
+5. Last line: "Continue: `/build G-001`".

package/.claude/commands/tools.md

@@ -1,19 +1,19 @@
 ---
-description: Bağlam paketlerini yönetir: hangi eklentilerin açık olduğunu gösterir, paket açar/kapatır, skill ve ajan yükünü ölçer.
-argument-hint: [boş = durum | ac <paket> | kapat <paket> | olc | komutlar hafif|tam]
+description: Manages context packages: shows which plugins are on, turns packages on/off, measures skill and agent load.
+argument-hint: [empty = status | ac <paket> | kapat <paket> | olc | komutlar hafif|tam]
 ---
 
-İstek: $ARGUMENTS
+Request: $ARGUMENTS
 
-Neden var: Skill listesi bağlamın %1'iyle sınırlı. Taşınca az kullanılan skill'lerin açıklaması düşer ve Claude onları tanımaz. Bu yüzden çekirdek dışındaki eklentiler kapalı gelir ve paket olarak gerektiğinde açılır. Paketler ve içerikleri: `docs/workflow/skills.md` → "Bağlam paketleri".
+Why it exists: The skill list is limited to 1% of context. When it overflows, descriptions of rarely used skills drop and Claude does not know them. So plugins outside the core come off by default and are turned on as packages when needed. Packages and their contents: `docs/workflow/skills.md` → "Context packages".
 
-- **Boşsa:** `node .claude/hooks/tools.mjs` çalıştır, çıktıyı kısa bir tabloyla göster (paket, durum, yaklaşık token, hangi komut açar).
-- **`ac <paket>`:** Önce kullanıcıya paketin yaklaşık token maliyetini ve şu notu söyle: "Oturum ortasında açmak prompt önbelleğini bozar; en ucuzu faz sınırında `/clear` ile birlikte açmaktır." Onay gelirse `node .claude/hooks/tools.mjs --enable <paket>` çalıştır. Betik kurulu olmayan eklenti bildirirse kurulum için ayrıca sor (`node .claude/hooks/plugins-sync.mjs --install`). Sonra kullanıcıdan `/reload-plugins` çalıştırmasını iste.
-- **`kapat <paket>`:** `node .claude/hooks/tools.mjs --disable <paket>`, sonra `/reload-plugins`.
-- **`olc`:** `node .claude/hooks/tools.mjs --measure` çalıştır. En büyük 5 eklentiyi ve toplamı göster. Kesin değer için kullanıcıya `/context` (Skills satırı) ve `/doctor` öner; kullanılmayan skill'leri bulmak için `/skill-doctor`.
+- **Empty:** Run `node .claude/hooks/tools.mjs` and show the output as a short table (package, status, approximate tokens, which command turns it on).
+- **`ac <paket>`:** First tell the user the package's approximate token cost and this note: "Turning on mid-session breaks the prompt cache; the cheapest is at a phase boundary together with `/clear`." If approved, run `node .claude/hooks/tools.mjs --enable <paket>`. If the script reports a plugin that is not installed, ask separately about installing it (`node .claude/hooks/plugins-sync.mjs --install`). Then ask the user to run `/reload-plugins`.
+- **`kapat <paket>`:** `node .claude/hooks/tools.mjs --disable <paket>`, then `/reload-plugins`.
+- **`olc`:** Run `node .claude/hooks/tools.mjs --measure`. Show the 5 largest plugins and the total. For the exact value suggest `/context` (Skills row) and `/doctor` to the user; suggest `/skill-doctor` to find unused skills.
 
-- **`komutlar hafif` / `komutlar tam`:** `node .claude/hooks/tools.mjs --commands light` veya `--commands full`. Hafif: çekirdek dışı 19 komut listede sadece adıyla durur (~1.100 token/oturum az), `/` menüsünde kalır. Tam: bütün açıklamalar listede. Bu ayar `.claude/settings.json`'a yazılır, ekibin hepsini etkiler; profil değişikliğiyle birlikte yapılır (`docs/workflow/progress.md` → `**Profil:**`). Yeni oturumda geçerli olur.
+- **`komutlar hafif` / `komutlar tam`:** `node .claude/hooks/tools.mjs --commands light` or `--commands full`. Light: the 20 non-core commands stay in the list with only their name (~1,100 fewer tokens per session) and remain in the `/` menu. Full: all descriptions in the list. This setting is written to `.claude/settings.json` and affects the whole team; do it together with a profile change (`docs/workflow/progress.md` → `**Profil:**`). It takes effect in a new session.
 
-Açma ve kapama sadece bu makineyi etkiler (`.claude/settings.local.json`, git'e girmez). Herkes için varsayılanı değiştirmek `.claude/settings.json` → `enabledPlugins` düzenlemesidir ve `teknik` karardır.
+Turning on and off affects only this machine (`.claude/settings.local.json`, not in git). Changing the default for everyone means editing `.claude/settings.json` → `enabledPlugins` and is a `teknik` decision.
 
-Codex ve Antigravity'de eklenti paketi yoktur: bu komut orada sadece `docs/workflow/mcp-catalog.md`'deki isteğe bağlı araçları listeler.
+Codex and Antigravity have no plugin packages: there this command only lists the optional tools in `docs/workflow/mcp-catalog.md`.