tillerhand 3.43.0 → 3.47.1

package/docs/workflow/cost-log.md

@@ -1,7 +1,7 @@
-# Maliyet Günlüğü
+# Cost Log
 
-> İşlerin 5 saatlik limitten ne kadar harcadığı. `docs/workflow/usage-limits.md` §3'teki tahminler,
-> burada en az 3 kayıt olunca bu ortalamalarla değiştirilir. Boyut: K (küçük) / O (orta) / B (büyük) / BOARD / DESIGN / FINDINGS.
+> How much of the 5-hour limit each job used. The estimates in `docs/workflow/usage-limits.md` §3
+> are replaced with these averages once there are at least 3 rows. Size: K (small) / O (medium) / B (large) / BOARD / DESIGN / FINDINGS.
 
-| Tarih | İş | Boyut | Başlangıç 5s % | Bitiş 5s % | Fark | Süre (dk) | Not |
+| Date | Job | Size | Start 5h % | End 5h % | Diff | Time (min) | Note |
 |---|---|---|---|---|---|---|---|

package/docs/workflow/decision-protocol.md

@@ -1,101 +1,101 @@
-# Karar Protokolü
+# Decision Protocol
 
-> Bu proje **soru odaklı** yürür. Kararları kullanıcı verir, AI seçenekleri hazırlar, önerir, uygular ve raporlar.
-> Kullanıcı bir konuda "sorma" diyene kadar o konuda tek bir karar bile kendiliğinden verilmez.
+> This project is **question-driven**. The user makes the decisions; the AI prepares the options, recommends, implements and reports.
+> Until the user says "don't ask" about a topic, not a single decision on that topic is made on its own.
 
-## 1. Karar noktası nedir?
+## 1. What is a decision point?
 
-Aşağıdakilerden birini etkileyen her seçim bir **karar noktasıdır** ve sorulur:
+Every choice that affects one of the following is a **decision point** and is asked:
 
-| Konu (kod) | Örnekler |
+| Topic (code) | Examples |
 |---|---|
-| `urun` | Özellik kapsamı, öncelik, MVP sınırı, kullanıcı akışı, fiyat, hedef kitle |
-| `teknik` | Dil, framework, veritabanı, auth yöntemi, hosting, kütüphane ekleme, API stili, mimari yapı, klasör yapısı |
-| `tasarim` | Stil yönü, renk, yazı tipi, sayfa/ekran düzeni, bileşen stili, animasyon miktarı, ikon seti, koyu tema |
-| `icerik` | Arayüz metinleri, ses tonu, hitap, açılış sayfası metni, e-posta metinleri |
-| `veri` | Veri modeli, alanlar, ilişkiler, saklama süresi, silme davranışı, migration |
-| `guvenlik` | Yetki modeli, roller, oturum süresi, hız sınırları, kişisel veri işleme |
-| `maliyet` | Ücretli servis seçimi, plan seviyesi, AI model seçimi, harcama limitleri |
+| `urun` | Feature scope, priority, MVP boundary, user flow, price, target audience |
+| `teknik` | Language, framework, database, auth method, hosting, adding a library, API style, architecture, folder structure |
+| `tasarim` | Style direction, color, typeface, page/screen layout, component style, amount of animation, icon set, dark theme |
+| `icerik` | Interface texts, tone of voice, form of address, landing page copy, email texts |
+| `veri` | Data model, fields, relations, retention period, deletion behavior, migration |
+| `guvenlik` | Authorization model, roles, session length, rate limits, personal data handling |
+| `maliyet` | Choice of paid service, plan tier, AI model choice, spending limits |
 
-**Karar noktası değildir** (sorulmaz, uygulanır ve durum bloğunda kısaca raporlanır): dosya/değişken/fonksiyon adı (`docs/product/glossary.md`'ye uygun), kodun iç düzeni, biçimlendirme, projede zaten kararı verilmiş bir kalıbın tekrar uygulanması.
+**Not a decision point** (not asked; apply it and report it briefly in the status block): file/variable/function names (follow `docs/product/glossary.md`), the internal layout of code, formatting, repeating a pattern the project has already decided.
 
-Emin değilsen karar noktasıdır, sor.
+If unsure, it is a decision point. Ask.
 
-## 2. Nasıl sorulur?
+## 2. How to ask
 
-1. **AskUserQuestion aracını kullan.** Araç yoksa aynı yapıyı numaralı liste olarak yaz ve cevap bekle.
-2. **Önce bağlam (1-3 cümle, soru metninin içinde veya hemen öncesinde):** Hangi aşamadayız, bu karar neyi etkiler, geri dönmesi kolay mı zor mu?
-3. **2-4 seçenek.** En uygun gördüğün **ilk sırada** ve etiketinin sonunda **"(Önerilen)"**.
-4. **Her seçeneğin açıklamasında:** Ne olduğu, hangi durumda daha iyi olduğu ve bedeli. Örnek: "Next.js — SEO ve sunucu tarafı gereken ürünlerde en iyisi, AI bu ekosistemi en iyi bilir; öğrenme eğrisi ve barındırma maliyeti Vite SPA'dan yüksek."
-5. **Önerinin gerekçesi bu projeye özel olsun:** PRD'deki kullanıcıya, bütçeye, ölçeğe ve kullanıcının daha önceki kararlarına dayan. Genel geçer "en popüler" gerekçe yetmez.
-6. **Tur başına en fazla 4 soru.** Aynı adımın birbirinden bağımsız sorularını tek AskUserQuestion çağrısında topla: her ayrı çağrı bir tur daha demek ve her tur bütün bağlamı yeniden okur. Birbirine bağlı kararları sırayla sor (önce framework, sonra ona bağlı kütüphane).
-7. Kullanıcı "Other" ile serbest cevap verirse onu da değerlendir. Riskli bulursan bir kez nedenini söyle, ısrar ederse uygula ve kayda geç.
-8. **Güncellik:** Sürüm, fiyat, kullanımdan kaldırma gibi değişebilen bilgiye dayanan seçeneklerde hafızana güvenme. Gerekirse önce araştır (`docs/workflow/skills.md` → araştırma).
-9. **Tasarım kararlarında görsel önizleme zorunlu.** Bkz. bölüm 5.
+1. **Use the AskUserQuestion tool.** If the tool is missing, write the same structure as a numbered list and wait for the answer.
+2. **Context first (1-3 sentences, inside the question text or right before it):** Which stage are we in, what does this decision affect, is it easy or hard to reverse?
+3. **2-4 options.** Put the one you find best **first**, with **"(Recommended)"** at the end of its label.
+4. **In each option's description:** What it is, when it is better, and what it costs. Example: "Next.js: best for products that need SEO and server-side work, the AI knows this ecosystem best; steeper learning curve and higher hosting cost than a Vite SPA."
+5. **Make the reason for the recommendation specific to this project:** Base it on the user in the PRD, the budget, the scale and the user's earlier decisions. A generic "most popular" reason is not enough.
+6. **At most 4 questions per round.** Group independent questions of the same step into one AskUserQuestion call: every separate call is one more round, and every round re-reads the whole context. Ask dependent decisions in order (framework first, then the library that depends on it).
+7. If the user gives a free answer with "Other", evaluate it too. If you find it risky, say why once; if the user insists, apply it and record it.
+8. **Freshness:** For options that depend on information that can change (version, price, deprecation), do not trust your memory. Research first if needed (`docs/workflow/skills.md` → research).
+9. **Visual preview is mandatory for design decisions.** See section 5.
 
-## 2a. Geri dönüş maliyeti: tek yönlü / çift yönlü kapı
+## 2a. Cost of reversal: one-way / two-way door
 
-Her kararı sormadan önce sınıfla ve soru metninde belirt:
+Classify every decision before asking and state it in the question text:
 
-- **Çift yönlü kapı:** Sonradan kolay ve ucuz değiştirilir (buton metni, renk, bir kütüphanenin iç kullanımı). Normal sorulur.
-- **Tek yönlü kapı:** Geri dönüşü pahalı veya imkânsız (veritabanı, auth sağlayıcısı, veri modeli, ödeme sağlayıcısı, alan adı, kişisel veri işleme, mağaza paket adı, herkese açık API sözleşmesi). Ek kurallar:
-  1. Soru metninde "Tek yönlü karar: sonradan değiştirmek [şu kadar] maliyetli" yazılır.
-  2. **Veritabanı ve auth kararlarında** (Tam profilde tüm tek yönlü kararlarda) sormadan önce **karar konseyi** toplanır (`.claude/board/council.md`); diğer tek yönlü kararlarda `board-architect` (ilgiliyse `security-auditor`) görüşü alınır. Konsey: 3 danışman aynı soruyu farklı modellerle cevaplar, birbirini anonim sıralar, `board-chair` önerir. Önerilen seçenek konseyin önerisidir; her seçeneğin açıklamasına konsey oyu ve azınlık görüşü eklenir. Limit kırmızıysa konsey yerine `board-architect` (ve ilgiliyse `security-auditor`) görüşü alınır.
-  3. Cevaptan sonra ADR zorunludur: `docs/decisions/adr-NNNN-*.md` (şablon: `adr-template.md`).
-  4. Kullanıcı acele etmiyorsa, büyük tek yönlü kararlar için "bir gün düşünüp sonra karar vermek" seçeneği de sunulur.
+- **Two-way door:** Easy and cheap to change later (button text, color, internal use of a library). Asked normally.
+- **One-way door:** Expensive or impossible to reverse (database, auth provider, data model, payment provider, domain name, personal data handling, store package name, public API contract). Extra rules:
+  1. The question text says "One-way decision: changing it later costs [this much]".
+  2. **For database and auth decisions** (in the Full profile, all one-way decisions), the **decision council** (`.claude/board/council.md`) meets before you ask; for other one-way decisions, get the opinion of `board-architect` (and `security-auditor` if relevant). Council: 3 advisors answer the same question with different models, rank each other anonymously, and `board-chair` recommends. The recommended option is the council's recommendation; add the council vote and the minority opinion to each option's description. If the limit is red, get the opinion of `board-architect` (and `security-auditor` if relevant) instead of the council.
+  3. After the answer an ADR is mandatory: `docs/decisions/adr-NNNN-*.md` (template: `adr-template.md`).
+  4. If the user is not in a hurry, for big one-way decisions also offer the option "think about it for a day, then decide".
 
-## 3. Cevap gelince
+## 3. When the answer arrives
 
-1. Kararı `docs/decisions/log.md` → **Karar günlüğü** tablosuna ekle (tarih, aşama, konu, soru, seçilen, kapı: `tek`/`çift`, karar veren: `kullanıcı`).
-2. Mimariyi veya uzun vadeyi etkileyen kararlarda ADR yaz (`docs/decisions/adr-NNNN-*.md`) ve `log.md` → ADR listesine ekle.
-3. Kararın etkilediği dokümanı güncelle (stack, mimari, tasarım rehberi, PRD, sözlük…).
-4. Sonra uygula.
+1. Add the decision to the **"Karar günlüğü"** (decision log) table in `docs/decisions/log.md` (date, stage, topic, question, chosen, door: `tek`/`çift`, decided by: `kullanıcı`).
+2. For decisions that affect the architecture or the long term, write an ADR (`docs/decisions/adr-NNNN-*.md`) and add it to the ADR list in `log.md`.
+3. Update the document the decision affects (stack, architecture, design guide, PRD, glossary…).
+4. Then implement.
 
-## 4. Soru modu
+## 4. Question mode
 
-Durum `docs/workflow/progress.md` → `**Soru modu:**` satırında tutulur. Varsayılan: `açık · kapalı konular: yok`.
+The state is kept in the `**Soru modu:**` line of `docs/workflow/progress.md`. Default: `açık · kapalı konular: yok`.
 
-| Kullanıcı ne der | Ne yaparsın |
+| What the user says | What you do |
 |---|---|
-| "sorma", "hiç sorma", `/ask-mode kapat hepsi` | Tüm konular kapalı |
-| "tasarımda sorma", "renkleri sen seç", `/ask-mode kapat tasarim` | Sadece o konu kapalı (konu kodlarıyla eşleştir; emin değilsen hangi konuyu kastettiğini sor) |
-| "tekrar sor", "sormaya devam et", `/ask-mode ac [konu\|hepsi]` | Konu(lar) tekrar açık |
+| "don't ask", "never ask", `/ask-mode off hepsi` | All topics closed |
+| "don't ask about design", "you pick the colors", `/ask-mode off tasarim` | Only that topic closed (match it to the topic codes; if unsure, ask which topic is meant) |
+| "ask again", "keep asking", `/ask-mode on [konu\|hepsi]` | Topic(s) open again |
 
-**Kapalı konuda:** "(Önerilen)" seçeneği seç, uygula. Günlüğe `karar veren: otomatik` yaz. Durum bloğunda "Otomatik kararlar" satırında listele. Tasarım konusu kapalı olsa bile önizlemeleri `.previews/` altına üret ki kullanıcı sonradan bakabilsin.
+**On a closed topic:** Pick the "(Recommended)" option and apply it. Write `karar veren: otomatik` in the log. List it in the "Auto decisions" line of the status block. Even when the design topic is closed, produce the previews under `.previews/` so the user can look later.
 
-**Soru modundan bağımsız, her zaman onay iste:** veri silme, prod'a deploy, ödeme veya para harcatan işlem, geri dönülemez her komut, `AGENTS.md` → "Asla" listesi.
+**Regardless of question mode, always ask for approval:** data deletion, prod deploy, an action that spends money, any command that cannot be undone, the "Never" list in `AGENTS.md`.
 
-## 5. Tasarım kararlarında görsel önizleme
+## 5. Visual preview for design decisions
 
-Her `tasarim` kararı görselle sorulur. Kullanıcı yazıyı değil, görüntüyü seçer.
+Every `tasarim` decision is asked with visuals. The user chooses an image, not text.
 
-1. Seçenek başına bir örnek üret: `.previews/NN-konu/a.html`, `b.html`, `c.html` (NN sıra no). Ayrıca hepsini yan yana veya alt alta gösteren `index.html`.
-2. Örnekler **gerçek içerikle** yapılır (PRD'deki ürün adı, gerçek başlık ve metinler); lorem ipsum yok.
-3. Her örnek, `docs/workflow/skills.md`'de o seçeneğe eşlenen skill ile üretilir. Örneğin "Premium" seçeneği premium tasarım skill'iyle, "Minimal" seçeneği minimal skill'le. Böylece seçenekler arasındaki fark gerçek olur.
-4. Büyük kararlarda (stil yönü, sayfa düzeni, ana ekran) her seçenek ayrı tam bölümdür. Küçük kararlarda (renk paleti, yazı tipi çifti, köşe/gölge, buton stili) tek bir karşılaştırma sayfasında yan yana örnekler yeterlidir.
-5. Önizlemeyi aç: Tarayıcı aracı varsa `index.html`'i aç, masaüstü ve mobil genişlikte ekran görüntüsü al ve göster. Yoksa dosya yolunu ver.
-6. Sonra AskUserQuestion ile sor: seçenekler A/B/C, açıklamalarında her birinin farkı ve hangi durumda daha iyi olduğu. Kullanıcı karma isteyebilir ("A'nın düzeni, B'nin renkleri"); bunu yeni bir önizlemeyle doğrula.
-7. Seçim `docs/design/design-guide.md` → karar günlüğüne ve `docs/decisions/log.md`'ye yazılır. `.previews/` git'e girmez.
+1. Produce one sample per option: `.previews/NN-konu/a.html`, `b.html`, `c.html` (NN is the sequence number). Also an `index.html` that shows them all side by side or one below the other.
+2. Build the samples with **real content** (the product name, real titles and texts from the PRD); no lorem ipsum.
+3. Produce each sample with the skill that `docs/workflow/skills.md` maps to that option. For example, the "Premium" option with the premium design skill, the "Minimal" option with the minimal skill. This makes the difference between options real.
+4. For big decisions (style direction, page layout, home screen), each option is a separate full section. For small decisions (color palette, typeface pair, corner/shadow, button style), side-by-side samples on one comparison page are enough.
+5. Open the preview: If a browser tool exists, open `index.html`, take screenshots at desktop and mobile width and show them. If not, give the file path.
+6. Then ask with AskUserQuestion: options A/B/C, with the difference of each and when it is better in the descriptions. The user may want a mix ("A's layout, B's colors"); verify that with a new preview.
+7. The choice is written to the decision log in `docs/design/design-guide.md` and to `docs/decisions/log.md`. `.previews/` stays out of git.
 
-## 6. Durum bloğu (her cevabın sonunda)
+## 6. Status block (at the end of every answer)
 
-Kısa ve sıkıştırılmış dille (caveman), en fazla 4 satır:
+In short, compressed language (caveman), at most 4 lines:
 
 ```
-── 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: ONAY (ux, qa)
-Otomatik kararlar: yok
-Sıradaki: G-013 şifre sıfırlama · bekleyen karar: e-posta servisi
+── Status ─────────────────────────────
+Phase: Phase 1 · Task: G-012 (7/23) · Question mode: open · Limit: 5h %34 weekly %5
+Done: signup form + validation, tests green · Board: ONAY (ux, qa)
+Auto decisions: none
+Next: G-013 password reset · pending decision: email service
 ```
 
-- Aşama ve görev `docs/workflow/progress.md`'den; görev sayısı `docs/product/roadmap.md`'deki işaretli/toplam.
-- Limit: masaüstünde `get_usage`, terminalde `node .claude/hooks/usage.mjs` (okunamıyorsa "bilinmiyor").
-- Kurul: bu turda toplantı yapıldıysa sonucu ve katılanlar.
-- "Sıradaki" her zaman somut olsun; bir karar bekleniyorsa onu söyle.
-- Sadece soru sorduğun turda (cevap beklerken) durum bloğunu soru öncesine tek satır olarak koy.
+- Phase and task come from `docs/workflow/progress.md`; the task count is checked/total in `docs/product/roadmap.md`.
+- Limit: `get_usage` on desktop, `node .claude/hooks/usage.mjs` in the terminal (if it cannot be read, "unknown").
+- Board: if a meeting happened this turn, its result and attendees.
+- "Next" must always be concrete; if a decision is awaited, say so.
+- In a turn where you only ask a question (waiting for the answer), put the status block as a single line before the question.
 
-## 7. Dil
+## 7. Language
 
-- **Sorular, seçenek açıklamaları, dokümanlar ve kullanıcıya görünen metinler:** Tam cümlelerle, düzgün Türkçe.
-- **Durum bloğu, ilerleme notları, kod açıklamaları:** Kısa ve sıkıştırılmış (caveman).
+- **Questions, option descriptions, documents and texts the user sees:** Complete sentences, proper prose in the conversation language.
+- **Status block, progress notes, code explanations:** Short and compressed (caveman).

package/docs/workflow/learning.md

@@ -1,9 +1,9 @@
-# Öğrenme kaydı
+# Learning Log
 
-> Anlatıcı mod açıkken görev sonunda sorulan anlama sorularının cevapları. AI her cevaptan sonra bir satır ekler; cevaplanmayan soru yazılmaz.
-> Pano "Ürün ve teknik" sekmesinde doğru/yanlış sayısını ve sık yanılan kavramları gösterir. Not değildir, kimseyle paylaşılmaz.
+> Answers to the comprehension questions asked at the end of a task while narrator mode is on. The AI adds one row after each answer; an unanswered question is not written.
+> The dashboard shows the number of correct (doğru) and wrong (yanlış) answers and the concepts often missed on the "Product and tech" tab. It is not a grade and is shared with no one.
 
 ## Kayıtlar
 
-| Tarih | Görev | Kavram | Sonuç |
+| Date | Task | Concept | Result |
 |---|---|---|---|

package/docs/workflow/mcp-catalog.md

@@ -1,42 +1,42 @@
-# MCP ve eklenti kataloğu
+# MCP and plugin catalog
 
-> Şablonda hazır gelmeyen, projede o servis seçilirse açılan bağlantılar. `/start` Adım 5'te (dış servisler) bu tabloya bakar ve eşleşen servis için kurulumu önerir.
-> Hepsi resmi, satıcının kendi sunucusudur (doğrulama: 2026-10-12). Kimlik doğrulama tarayıcıda (OAuth) veya senin ortam değişkeninle yapılır; anahtar sohbete veya dosyaya yazılmaz.
+> Connections that do not come ready in the template and are opened if the project picks that service. `/start` Step 5 (external services) checks this table and suggests the setup for a matching service.
+> All are the vendor's own official servers (verified: 2026-10-12). Authentication happens in the browser (OAuth) or with your own environment variable; a key is never written to the chat or to a file.
 
-## Projede hazır gelenler
+## Ready in the project
 
-| Ne | Tip | Not |
+| What | Type | Note |
 |---|---|---|
-| Context7 | hepsi | Güncel kütüphane dokümanı |
-| Supabase (salt okunur), Sentry | web, mobil · backend'de Sentry | `DEV_REF` /start'ta doldurulur: **geliştirme** projesi, sadece okur. Prod ref'i AI ortamına (.mcp.json, .env.local) yazılmaz; prod'a bakmak gerekirse kullanıcı paneli açar |
-| Maestro | mobil | Mobil E2E (`.maestro/*.yaml`). Maestro CLI kurulu olmalı: `curl -fsSL "https://get.maestro.mobile.dev" \| bash` (Windows: WSL veya docs.maestro.dev) |
-| Expo | mobil | `expo@expo-plugins` eklentisiyle gelir: EAS build, iş akışları, TestFlight çökme kayıtları. Bağlanmak için `/mcp` → Expo hesabıyla giriş. Simülatör ve ekran görüntüsü için SDK 54+ ve `npx expo install expo-mcp --dev` |
+| Context7 | all | Current library docs |
+| Supabase (read-only), Sentry | web, mobile · Sentry for backend | `DEV_REF` is filled in at /start: the **development** project, read-only. The prod ref is not written to the AI environment (.mcp.json, .env.local); if prod needs a look, the user opens the dashboard |
+| Maestro | mobile | Mobile E2E (`.maestro/*.yaml`). The Maestro CLI must be installed: `curl -fsSL "https://get.maestro.mobile.dev" \| bash` (Windows: WSL or docs.maestro.dev) |
+| Expo | mobile | Comes with the `expo@expo-plugins` plugin: EAS build, workflows, TestFlight crash logs. To connect: `/mcp` → sign in with the Expo account. For simulator and screenshots: SDK 54+ and `npx expo install expo-mcp --dev` |
 
-## Gerektiğinde eklenenler (varsayılan kapalı)
+## Added when needed (off by default)
 
-Bu sunucular `.mcp.json`'da gelmez; gereken komut kullanıcıya sorup bu makineye ekler (`--scope local`, git'e girmez). İş bitince `/mcp` ile kapatılabilir. Windows'ta `npx` yerine `cmd /c npx` yaz.
+These servers do not come in `.mcp.json`; the command that needs one asks the user and adds it to this machine (`--scope local`, does not enter git). It can be turned off with `/mcp` when the work is done. On Windows write `cmd /c npx` instead of `npx`.
 
-| Ne | Kim ister | Kurulum (doğrulama: 2026-10-23) | Not |
+| What | Who asks for it | Setup (verified: 2026-10-23) | Note |
 |---|---|---|---|
-| Playwright MCP | Keşif amaçlı tarayıcı testi, uzun etkileşimli akış | `claude mcp add --scope local playwright -- npx -y @playwright/mcp@0.0.83` | Ekran görüntüsü için `node .claude/hooks/preview.mjs`. Etkileşimli deneme için önce Playwright CLI (her komut sorulur; proje klasöründe depodaki ayar dosyasını okur): `npx -y @playwright/cli@0.1.22 open <url>`, `snapshot`, `console`, `requests`, `screenshot`. CLI sayfa verisini bağlama zorlamaz, daha az token harcar |
-| Chrome DevTools MCP | `/findings-perf`, `/findings-ux` | `claude mcp add --scope local chrome-devtools -- npx -y chrome-devtools-mcp@1.10.1` | Performans izi (LCP, CLS, INP), ağ şelalesi, konsol |
-| Figma | `/design` (tasarım Figma'daysa) | `claude mcp add --scope local --transport http figma-remote-mcp https://mcp.figma.com/mcp` | OAuth (`/mcp`). Figma'nın resmi plugin'i (~17 skill) bağlam bütçesi yüzünden kullanılmaz |
-| rea (CLI, MCP değil) | `/research` (rakip özelliği nasıl çalışıyor), `/adopt` (kaynağı olmayan parça) | Kurulum yok: `npx -y rea-agents@6.2.0 <alt komut>`; alt komutlar `npx -y rea-agents@6.2.0 --help`. Node `^22.19` veya `>=24.11` ister | Sadece kullanıcının sahip olduğu veya incelemeye yetkili olduğu yazılım. Lisans sözleşmesi (EULA) tersine mühendisliği yasaklayabilir; ticari araçlar (IDA, Hopper, JEB) kendi lisansıyla. `setup` çalıştırılmaz (ajan ayarlarını değiştirir). Analiz yereldir; site incelemesi o siteye gerçek istek atar |
-| Supabase dev (yazma) | `/build` (dev'de deneme) | `claude mcp add --scope local --transport http supabase-dev "https://mcp.supabase.com/mcp?project_ref=DEV_REF&features=database,docs"` | Sadece **geliştirme** projesi veya branch'i (`DEV_REF`). Prod ref'i asla bu tanıma yazılmaz. Şema değişikliği yine migration dosyasıyla yapılır |
+| Playwright MCP | Exploratory browser testing, long interactive flow | `claude mcp add --scope local playwright -- npx -y @playwright/mcp@0.0.83` | For screenshots, `node .claude/hooks/preview.mjs`. For interactive trials, use the Playwright CLI first (every command is asked; in the project folder it reads the config file in the repo): `npx -y @playwright/cli@0.1.22 open <url>`, `snapshot`, `console`, `requests`, `screenshot`. The CLI does not force page data into the context, so it spends fewer tokens |
+| Chrome DevTools MCP | `/findings-perf`, `/findings-ux` | `claude mcp add --scope local chrome-devtools -- npx -y chrome-devtools-mcp@1.10.1` | Performance trace (LCP, CLS, INP), network waterfall, console |
+| Figma | `/design` (if the design is in Figma) | `claude mcp add --scope local --transport http figma-remote-mcp https://mcp.figma.com/mcp` | OAuth (`/mcp`). Figma's official plugin (~17 skills) is not used because of the context budget |
+| rea (CLI, not MCP) | `/research` (how a competitor feature works), `/adopt` (a part with no source) | No setup: `npx -y rea-agents@6.2.0 <alt komut>`; subcommands: `npx -y rea-agents@6.2.0 --help`. Needs Node `^22.19` or `>=24.11` | Only software the user owns or is authorized to inspect. The license agreement (EULA) may forbid reverse engineering; commercial tools (IDA, Hopper, JEB) follow their own license. `setup` is not run (it changes agent settings). The analysis is local; inspecting a site sends real requests to that site |
+| Supabase dev (write) | `/build` (trying things in dev) | `claude mcp add --scope local --transport http supabase-dev "https://mcp.supabase.com/mcp?project_ref=DEV_REF&features=database,docs"` | Only the **development** project or branch (`DEV_REF`). The prod ref is never written to this definition. Schema changes are still made with a migration file |
 
-## Servis seçilince açılanlar
+## Opened when a service is chosen
 
-| Servis | Kurulum | Kimlik | Dikkat |
+| Service | Setup | Credentials | Caution |
 |---|---|---|---|
-| GitHub | `/plugin install github@claude-plugins-official` | `GITHUB_PERSONAL_ACCESS_TOKEN` ortam değişkeni (ince ayarlı, sadece bu repo) | Geniş yetkili token verme |
-| Stripe | `claude mcp add --transport http stripe https://mcp.stripe.com --scope project` | OAuth (`/mcp`) | Önce test modu hesabıyla bağlan |
-| Vercel | CLI: `npx -y vercel@63.1.1` (`/release` kullanır). Log ve build durumu için isteğe bağlı MCP: `claude mcp add --transport http vercel https://mcp.vercel.com --scope project` | `vercel login` / OAuth (`/mcp`) | Deploy ve satın alma yapabilir; `--prod`, `promote`, `rollback` her zaman sorulur (kalkan). Resmi plugin (30+ skill) bağlam bütçesi yüzünden kullanılmaz |
-| PostHog | `claude mcp add --transport http posthog https://mcp.posthog.com/mcp --scope project` | OAuth (`/mcp`), bölge otomatik | Ürün analitiği ve özellik bayrakları (`docs/operations/feature-flags.md`) |
-| Firebase | `/plugin install firebase@claude-plugins-official` | Firebase CLI girişi | Supabase yerine Firebase seçildiyse |
-| Linear | `/plugin install linear@claude-plugins-official` | OAuth | Yol haritası Linear'da tutulacaksa |
-
-## Kural
-
-- Her MCP aracının yaptığı işlem senin hesabının yetkisiyle yapılır. Yazma yetkisi olanlarda (Stripe, Vercel, GitHub) kalıcı veya para harcatan işlem kullanıcı onayı olmadan yapılmaz.
-- Yeni bir MCP eklemek `teknik` karardır; listede olmayan bir sunucu önerilirse önce `source-research` ile kaynağını ve bakım durumunu doğrula, `.mcp.json`'a sürüm sabitleyerek ekle.
-- Kullanılmayan MCP'yi kapat: her araç tanımı her oturumda bağlama yük ekler.
+| GitHub | `/plugin install github@claude-plugins-official` | `GITHUB_PERSONAL_ACCESS_TOKEN` environment variable (fine-grained, only this repo) | Do not give a broad-scope token |
+| Stripe | `claude mcp add --transport http stripe https://mcp.stripe.com --scope project` | OAuth (`/mcp`) | Connect with a test-mode account first |
+| Vercel | CLI: `npx -y vercel@63.1.1` (`/release` uses it). Optional MCP for logs and build status: `claude mcp add --transport http vercel https://mcp.vercel.com --scope project` | `vercel login` / OAuth (`/mcp`) | It can deploy and purchase; `--prod`, `promote`, `rollback` are always asked (shield). The official plugin (30+ skills) is not used because of the context budget |
+| PostHog | `claude mcp add --transport http posthog https://mcp.posthog.com/mcp --scope project` | OAuth (`/mcp`), region automatic | Product analytics and feature flags (`docs/operations/feature-flags.md`) |
+| Firebase | `/plugin install firebase@claude-plugins-official` | Firebase CLI login | If Firebase was chosen instead of Supabase |
+| Linear | `/plugin install linear@claude-plugins-official` | OAuth | If the roadmap will be kept in Linear |
+
+## Rule
+
+- Every action an MCP tool takes runs with your account's permissions. For tools with write access (Stripe, Vercel, GitHub), no permanent or money-spending action is taken without user approval.
+- Adding a new MCP is a `teknik` decision; if a server not on the list is suggested, first verify its source and maintenance status with `source-research`, and add it to `.mcp.json` with a pinned version.
+- Turn off an MCP you do not use: every tool definition adds load to the context in every session.

package/docs/workflow/models.md

@@ -1,54 +1,54 @@
-# Model ve effort (rol bazında)
+# Model and Effort (per role)
 
-> Kit işi beş role ayırır. Her rolün modelini ve effort'unu (ne kadar düşüneceğini) sen seçersin.
-> `/build` her görevin başında, `/start`, `/adopt` ve `/release` başlarken rol başına tek soru sorar (model ve effort birlikte), iki ekranda: önce plan, kod, test; sonra inceleme, doküman.
-> Seçim `node .claude/hooks/models.mjs --set …` ile `.claude/state/models.json`'a yazılır (git'e girmez). Güncel seçimi `node .claude/hooks/models.mjs --show` gösterir.
+> The kit splits the work into five roles. You choose each role's model and effort (how much it thinks).
+> `/build` asks one question per role (model and effort together) at the start of every task; `/start`, `/adopt` and `/release` ask when they begin. Two screens: first plan, code, test; then review, docs.
+> The choice is written with `node .claude/hooks/models.mjs --set …` to `.claude/state/models.json` (not in git). `node .claude/hooks/models.mjs --show` shows the current choice.
 
-## Roller
+## Roles
 
-| Rol | Anahtar | Kapsadığı işler | Önerilen |
+| Role | Key | Work it covers | Recommended |
 |---|---|---|---|
-| Planlama ve mimari | `plan` | Plan, mimari ve veri modeli kararları; PRD, README ve kullanıcıya görünen metin. Ana oturumda yürür. | Opus · yüksek |
-| Kod yazma | `code` | Uygulama kodu. Test dosyalarına yazamaz. Küçük görevde ana oturumda, yoksa alt ajanda. | Sonnet · yüksek |
-| Test yazma | `test` | Kabul ve saldırgan testleri, koddan önce; `test-writer` ajanı. Kodu yazandan ayrı ajan, önerilen model de farklı: aynı model aynı kör noktayı paylaşır. | Opus · yüksek |
-| İnceleme ve denetim | `review` | Kurul üyeleri, `code-reviewer`, `security-auditor`, bulgu raporları (`/findings-all`). | Sonnet · yüksek |
-| Doküman ve araştırma | `docs` | CHANGELOG, rapor özeti; kod tarama, web araştırması (`/research` derin). Karar günlüğü karar anında ana oturumda yazılır. | Haiku · yüksek |
+| Planning and architecture | `plan` | Plan, architecture and data model decisions; PRD, README and user-visible text. Runs in the main session. | Opus · high |
+| Code writing | `code` | Application code. Cannot write to test files. In the main session for a small task, otherwise in a subagent. | Sonnet · high |
+| Test writing | `test` | Acceptance and adversarial tests, before the code; the `test-writer` agent. A separate agent from the one writing the code, and the recommended model is different too: the same model shares the same blind spot. | Opus · high |
+| Review and audit | `review` | Board members, `code-reviewer`, `security-auditor`, findings reports (`/findings-all`). | Sonnet · high |
+| Docs and research | `docs` | CHANGELOG, report summary; code scanning, web research (`/research` deep). The decision log is written in the main session at decision time. | Haiku · high |
 
-Her sorudaki seçenekler (ilki önerilen; başka bir kombinasyon "Diğer" ile yazılır):
+Options in each question (the first is recommended; another combination can be written with "Other"):
 
-| Rol | Seçenekler |
+| Role | Options |
 |---|---|
-| `plan` | Opus · yüksek / Opus · ekstra yüksek / Sonnet · yüksek / Sonnet · orta |
-| `code` | Sonnet · yüksek / Opus · yüksek / Sonnet · orta / Haiku · yüksek |
-| `test` | Kod rolünün son seçiminden farklı model ilk sırada: kod Sonnet ise Opus · yüksek, kod Opus ise Sonnet · yüksek, kod Haiku ise Sonnet · yüksek. Sonra öteki iki model ve aynı modelin orta effort'u |
-| `review` | Sonnet · yüksek / Opus · yüksek / Sonnet · orta / Haiku · yüksek |
-| `docs` | Haiku · yüksek / Haiku · orta / Sonnet · yüksek / Sonnet · orta |
+| `plan` | Opus · high / Opus · extra high / Sonnet · high / Sonnet · medium |
+| `code` | Sonnet · high / Opus · high / Sonnet · medium / Haiku · high |
+| `test` | The model different from the code role's last choice goes first: Opus · high if code is Sonnet, Sonnet · high if code is Opus, Sonnet · high if code is Haiku. Then the other two models and the medium effort of the same model |
+| `review` | Sonnet · high / Opus · high / Sonnet · medium / Haiku · high |
+| `docs` | Haiku · high / Haiku · medium / Sonnet · high / Sonnet · medium |
 
-Kod ve test aynı modele alınırsa `models.mjs` uyarır ama engellemez (limit darken ikisi de ucuz modele alınabilir).
+If code and test are set to the same model, `models.mjs` warns but does not block (when the limit is tight, both can be moved to the cheap model).
 
-Effort ölçeği: düşük = `low`, orta = `medium`, yüksek = `high`, ekstra yüksek = `xhigh`. Effort arttıkça cevap yavaşlar ve limitten daha çok yer.
+Effort scale: low = `low`, medium = `medium`, high = `high`, extra high = `xhigh`. The higher the effort, the slower the answer and the more it takes from the limit.
 
-Opus en pahalı, Haiku en ucuz modeldir. Limit sarı veya kırmızıya döndüğünde en büyük tasarruf kod rolünü bir alt modele almaktır (`docs/workflow/usage-limits.md` §3). Güvenlik, veri modeli ve mimari kararlar planlama rolünde kalır.
+Opus is the most expensive model and Haiku the cheapest. When the limit turns yellow or red, the biggest saving is to move the code role to a lower model (`docs/workflow/usage-limits.md` §3). Security, data model and architecture decisions stay in the planning role.
 
-## Claude Code'da nasıl uygulanır
+## How it applies in Claude Code
 
-- **Ana oturum** planlama rolünü yürütür. Kit ana oturumun modelini değiştiremez: seçilen plan modeli veya effort'u oturumunkinden farklıysa AI tek satırla `/model <ad>` ve `/effort <düzey>` önerir.
-- **Alt ajanlar:** Kod yazma, inceleme ve doküman işleri Agent aracıyla alt ajana gider. Çağrıda rolün `model` ve `effort` değeri verilir; çağrıdaki değer ajan dosyasındaki `model:` satırını ezer.
-- **Takma adlar:** `opus`, `sonnet`, `haiku` (ayrıca `fable`) her zaman o ailenin en yeni modeline gider. Belirli bir sürüme sabitlemek için tam model kimliği ya da `ANTHROPIC_DEFAULT_OPUS_MODEL` (SONNET, HAIKU) ortam değişkeni.
-- **Effort:** Alt ajan çağrısında effort Claude Code v2.1.292 ve sonrasında verilebilir. `CLAUDE_CODE_EFFORT_LEVEL` ortam değişkeni tanımlıysa bütün effort seçimlerini ezer. Bir model her düzeyi desteklemeyebilir.
-- **Soru modu:** `maliyet` konusu kapalıysa soru gelmez, son seçim geçerli kalır.
-- **İstisnalar:** Commit (hafif) kurul denetimi her commit'te çalıştığı için `haiku` ve `low` kalır (`.claude/board/rules.md`). Karar konseyi (`.claude/board/council.md`) bilerek farklı modelleri karşılaştırır; rol seçimi ona uygulanmaz.
+- **The main session** runs the planning role. The kit cannot change the main session's model: if the chosen plan model or effort differs from the session's, the AI suggests `/model <name>` and `/effort <level>` in one line.
+- **Subagents:** Code writing, review and docs work goes to a subagent with the Agent tool. The call passes the role's `model` and `effort` value; the value in the call overrides the `model:` line in the agent file.
+- **Aliases:** `opus`, `sonnet`, `haiku` (also `fable`) always go to the newest model of that family. To pin to a specific version, use the full model ID or the `ANTHROPIC_DEFAULT_OPUS_MODEL` (SONNET, HAIKU) environment variable.
+- **Effort:** In a subagent call, effort can be passed in Claude Code v2.1.292 and later. If the `CLAUDE_CODE_EFFORT_LEVEL` environment variable is set, it overrides all effort choices. A model may not support every level.
+- **Question mode:** If the `maliyet` topic is closed, no question is asked and the last choice stays valid.
+- **Exceptions:** The commit (light) board review runs on every commit, so it stays at `haiku` and `low` (`.claude/board/rules.md`). The decision council (`.claude/board/council.md`) deliberately compares different models; the role choice does not apply to it.
 
-Kaynak: code.claude.com/docs/en/sub-agents, code.claude.com/docs/en/model-config (2026-10-26).
+Source: code.claude.com/docs/en/sub-agents, code.claude.com/docs/en/model-config (2026-10-26).
 
-## Codex ve Antigravity
+## Codex and Antigravity
 
 | | Codex | Antigravity |
 |---|---|---|
-| Ana oturum | Model seçici ve reasoning effort | Model seçici ve düşünme düzeyi (Low / Medium / High) |
-| Alt ajan | `.codex/agents/<ad>.toml` → `model`, `model_reasoning_effort`. Başlatırken istemle de verilebilir; verilmezse ana oturumunkini alır. | `.agents/agents/<ad>.md` → `model: inherit`, `flash` ya da `pro`. Alt ajanda düşünme düzeyi yok. |
-| Rol karşılığı | Opus ve Sonnet → güçlü model, Haiku → hızlı model (2026-10-26'da dokümanın önerisi: `gpt-6.1-sol` ve `gpt-6-luna`). Effort adları aynı: `low` … `xhigh`. | Opus ve Sonnet → `pro`, Haiku → `flash`. |
+| Main session | Model picker and reasoning effort | Model picker and thinking level (Low / Medium / High) |
+| Subagent | `.codex/agents/<ad>.toml` → `model`, `model_reasoning_effort`. Can also be given in the prompt at launch; if not given, it takes the main session's. | `.agents/agents/<ad>.md` → `model: inherit`, `flash` or `pro`. A subagent has no thinking level. |
+| Role equivalent | Opus and Sonnet → strong model, Haiku → fast model (the docs' recommendation on 2026-10-26: `gpt-6.1-sol` and `gpt-6-luna`). Effort names are the same: `low` … `xhigh`. | Opus and Sonnet → `pro`, Haiku → `flash`. |
 
-Seçenekli soru aracı yoksa (Codex) iki ekran numaralı liste olarak sorulur. Alt ajan çalıştıramıyorsan rolü kendin yürüt ve modeli metinle öner.
+If there is no question tool with options (Codex), ask the two screens as a numbered list. If you cannot run a subagent, run the role yourself and suggest the model in text.
 
-Kaynak: developers.openai.com/codex/subagents, antigravity.google/docs/subagents, antigravity.google/docs/models (2026-10-26).
+Source: developers.openai.com/codex/subagents, antigravity.google/docs/subagents, antigravity.google/docs/models (2026-10-26).

package/docs/workflow/progress.md

@@ -1,8 +1,8 @@
-# İlerleme
+# Progress
 
-> Bu dosya her oturumda AI'ya otomatik yüklenir. **40 satırı geçmesin.**
-> Sadece güncel durumu tutar; geçmiş `CHANGELOG.md`, `docs/decisions/log.md` ve git'te yaşar.
-> Alt durum çubuğu ve `/dashboard` panosu aşağıdaki **kalın etiketli** satırları okur; biçimlerini bozma.
+> This file is loaded into the AI automatically in every session. **Do not exceed 40 lines.**
+> It holds only the current state; history lives in `CHANGELOG.md`, `docs/decisions/log.md` and git.
+> The status line and the `/dashboard` read the **bold-labeled** lines below; do not break their format.
 
 **Son güncelleme:** -
 **Aktif faz:** Başlangıç
@@ -13,7 +13,7 @@
 
 ## Şu anki durum
 
-Proje henüz başlamadı. `/start [fikir]` ile başla.
+The project has not started yet. Start with `/start [fikir]`.
 
 ## Son oturumda yapılanlar
 
@@ -27,7 +27,7 @@ Proje henüz başlamadı. `/start [fikir]` ile başla.
 
 - 
 
-## Kaldığı yer (limit veya yarıda kalma nedeniyle durulduysa)
+## Kaldığı yer (if stopped because of a limit or midway)
 
 - 
 
@@ -35,6 +35,6 @@ Proje henüz başlamadı. `/start [fikir]` ile başla.
 
 - 
 
-## Dikkat (AI için notlar)
+## Watch out (notes for the AI)
 
 -