tillerhand 3.43.0 → 3.47.1

package/docs/operations/release-checklist.md

@@ -1,75 +1,75 @@
-# Canlıya Alma Kontrol Listesi
+# Go-Live Checklist
 
-> İlk lansmandan önce **tamamı**, sonraki her sürümde **"Her sürüm"** bölümü.
-> `/release` komutu otomatik kontrol edilebilenleri çalıştırır, gerisini sana sorar.
-> Tipe özel ek maddeler: `docs/architecture/stack.md` → "Canlıya alma".
-> İşaretler: ✅ tamam · ❌ eksik · ➖ bu projede geçerli değil
+> Before the first launch, **all of it**; for every later release, the **"Every release"** section.
+> The `/release` command runs the items that can be checked automatically and asks you about the rest.
+> Project-type-specific extra items: `docs/architecture/stack.md` → "Go live (extra)".
+> Marks: ✅ done · ❌ missing · ➖ not applicable to this project
 
-## A. Her sürüm (her deploy öncesi)
+## A. Every release (before each deploy)
 
-- [ ] CI `main` dalında yeşil (testler, lint, tip kontrolü, build, sır taraması)
-- [ ] `docs/quality/test-plan.md` → manuel kontrol listesi yapıldı
-- [ ] Yeni ortam değişkenleri prod ortamına eklendi
-- [ ] DB migration varsa: **önce yedek**, sonra migration; migration geri alınabilir mi kontrol edildi
-- [ ] `CHANGELOG.md` güncellendi, sürüm numarası verildi
-- [ ] Geri alma (rollback) yolu biliniyor: [Örn: Vercel'de önceki deploy'a "Promote", `git revert`]
-- [ ] Deploy sonrası duman testi: ana sayfa, giriş, ana akış, hata takibinde yeni hata yok
+- [ ] CI is green on the `main` branch (tests, lint, type check, build, secret scan)
+- [ ] The manual checklist in `docs/quality/test-plan.md` was done
+- [ ] New environment variables were added to the prod environment
+- [ ] If there is a DB migration: **backup first**, then the migration; checked that the migration can be rolled back
+- [ ] `CHANGELOG.md` updated, version number given
+- [ ] The rollback path is known: [e.g. "Promote" the previous deploy in Vercel, `git revert`]
+- [ ] Smoke test after deploy: home page, login, main flow, no new error in error tracking
 
-## B. İlk lansman (bir kez, sonra yılda bir gözden geçir)
+## B. First launch (once, then review yearly)
 
-### Kod ve kalite
-- [ ] `docs/product/roadmap.md` Faz 1-2 tamam
-- [ ] Kritik akış testleri (`docs/quality/test-plan.md` K1-K5) yeşil
-- [ ] Debug kodu, `console.log`, test verisi, sahte kullanıcılar temizlendi
-- [ ] 404, 500 ve bakım sayfaları/ekranları var
+### Code and quality
+- [ ] `docs/product/roadmap.md` Phase 1-2 done
+- [ ] Critical flow tests (`docs/quality/test-plan.md` K1-K5) are green
+- [ ] Debug code, `console.log`, test data, fake users cleaned up
+- [ ] 404, 500 and maintenance pages/screens exist
 
-### Güvenlik
-- [ ] `docs/security/checklist.md` tüm maddeler tamam; `security-auditor` ajanı engelleyici bulgu vermedi
-- [ ] Prod anahtarları lokal/test anahtarlarından ayrı
-- [ ] GitHub: `main` dalı korumalı (CI zorunlu), Dependabot güvenlik güncellemeleri açık, gizli tarama (secret scanning) açık
-- [ ] AI özelliği varsa: `docs/ai/guide.md` → "Canlıya alma" tamam
-- [ ] Admin hesapları güçlü şifre + 2FA (hosting, DB, domain, e-posta, ödeme, kod deposu)
+### Security
+- [ ] All items in `docs/security/checklist.md` are done; the `security-auditor` agent gave no blocking finding
+- [ ] Prod keys are separate from local/test keys
+- [ ] GitHub: `main` branch is protected (CI required), Dependabot security updates on, secret scanning on
+- [ ] If there is an AI feature: `docs/ai/guide.md` → "Go live (add-on)" is done
+- [ ] Admin accounts have a strong password + 2FA (hosting, DB, domain, email, payment, code repository)
 
-### Yasal
-- [ ] `docs/legal/privacy-kvkk.md` metinleri yayında ve linkli
-- [ ] Çerez bandı çalışıyor, onay öncesi analitik yüklenmiyor
+### Legal
+- [ ] The texts in `docs/legal/privacy-kvkk.md` are published and linked
+- [ ] The cookie banner works, analytics does not load before consent
 
-### Hesaplar, bayraklar, izleme
-- [ ] `docs/operations/accounts.md` eksiksiz: her servis, hesap sahibi, 2FA, bitiş tarihleri
-- [ ] Riskli özellikler bayrak arkasında; acil kapatma en az bir kez denendi (`docs/operations/feature-flags.md`)
-- [ ] Canlıda sentetik izleme açık (`.github/workflows/live-monitoring.yml`, `LIVE_URL` değişkeni tanımlı, 3 saatte bir), panoda "Canlı izleme · başarılı" görünüyor ve bir hata denemesiyle uyarı geldiği görüldü
-- [ ] `docs/product/unit-economics.md`: katkı payı pozitif, başa baş noktası biliniyor
-- [ ] Harcama alarmları: Ücretli her servisin tavanı veya uyarısı kurulu ve bir kez denendi (`docs/operations/spend-alarms.md`); AI/ücretli API çağrısında kullanıcı başı kota ve genel günlük bütçe var
-- [ ] Kabul testlerinin tamamı yeşil (MVP kriterleri)
-- [ ] Son `/qa` raporunda (`docs/quality/qa/`) "kaldı" yok; web projesinde arayüz kriterleri tarayıcıda koşuldu
+### Accounts, flags, monitoring
+- [ ] `docs/operations/accounts.md` is complete: every service, account owner, 2FA, expiry dates
+- [ ] Risky features are behind flags; the kill switch was tried at least once (`docs/operations/feature-flags.md`)
+- [ ] Synthetic monitoring is on in production (`.github/workflows/live-monitoring.yml`, `LIVE_URL` variable defined, every 3 hours), the dashboard shows "Live monitoring · succeeded", and an alert was seen to arrive after a test failure
+- [ ] `docs/product/unit-economics.md`: contribution margin is positive, break-even point is known
+- [ ] Spend alarms: every paid service has a cap or alert set up and tried once (`docs/operations/spend-alarms.md`); an AI/paid API call has a per-user quota and a global daily budget
+- [ ] All acceptance tests are green (MVP criteria)
+- [ ] The last `/qa` report (`docs/quality/qa/`) has no "kaldı" (remaining) item; in a web project the interface criteria were run in the browser
 
-### Altyapı
-> Adımlar sağlayıcıya göre `docs/operations/deploy-setup.md`'de (`/release first` → Dağıtım kurulumu).
-- [ ] Alan adı, SSL, `www` yönlendirmesi
-- [ ] Prod veritabanı ayrı proje/örnek; otomatik yedekleme açık
-- [ ] **Yedekten geri yükleme bir kez denendi** (denenmemiş yedek, yedek değildir)
-- [ ] E-posta gönderimi: alan adı doğrulandı (SPF, DKIM, DMARC), spam'e düşmüyor
-- [ ] Hata takibi (Sentry vb.) prod'da aktif, alarm e-postası/bildirim geliyor
-- [ ] Uptime izleme (UptimeRobot, Better Stack vb.) kuruldu
-- [ ] Log saklama süresi belirlendi
+### Infrastructure
+> Steps by provider are in `docs/operations/deploy-setup.md` (`/release first` → Deploy setup).
+- [ ] Domain, SSL, `www` redirect
+- [ ] Prod database is a separate project/instance; automatic backup is on
+- [ ] **Restore from backup was tried once** (an untried backup is not a backup)
+- [ ] Email sending: domain verified (SPF, DKIM, DMARC), does not land in spam
+- [ ] Error tracking (Sentry etc.) is active in prod, the alarm email/notification arrives
+- [ ] Uptime monitoring (UptimeRobot, Better Stack etc.) is set up
+- [ ] Log retention period is defined
 
-### Maliyet
-- [ ] Tüm ücretli servislerde (hosting, DB, AI API, e-posta) harcama limiti/alarmı ayarlı
-- [ ] Ücretsiz katman limitleri biliniyor; aşınca ne olacağı (durma mı, faturalama mı?) biliniyor
-- [ ] Aylık tahmini maliyet `docs/architecture/overview.md` → dış servisler tablosunda
+### Cost
+- [ ] A spend limit/alarm is set on all paid services (hosting, DB, AI API, email)
+- [ ] Free tier limits are known; what happens when they are exceeded (stop or billing?) is known
+- [ ] The estimated monthly cost is in `docs/architecture/overview.md` → the "External services" section
 
-### Performans ve görünürlük
-- [ ] Tipe özel performans hedefleri (`docs/architecture/stack.md`) karşılandı
-- [ ] Analitik (gizlilik dostu) kuruldu, temel olaylar (kayıt, ana eylem) izleniyor
+### Performance and visibility
+- [ ] Project-type-specific performance targets (`docs/architecture/stack.md`) are met
+- [ ] Analytics (privacy-friendly) is set up, basic events (sign-up, main action) are tracked
 
-### Hazırlık
-- [ ] `docs/product/launch.md` → "Lansman öncesi" tamam
-- [ ] Destek kanalı (e-posta/form) var ve biri bakıyor
-- [ ] `README.md`: kurulum, ortam değişkenleri, deploy adımları güncel
-- [ ] Tipe özel maddeler (`docs/architecture/stack.md` → "Canlıya alma") tamam
+### Preparation
+- [ ] `docs/product/launch.md` → "Before launch" is done
+- [ ] A support channel (email/form) exists and someone watches it
+- [ ] `README.md`: setup, environment variables, deploy steps are current
+- [ ] Project-type-specific items (`docs/architecture/stack.md` → "Go live (extra)") are done
 
-## C. Lansman sonrası ilk 72 saat
+## C. First 72 hours after launch
 
-- [ ] Hata takibi günde 2 kez kontrol
-- [ ] Maliyet paneli günde 1 kez kontrol
-- [ ] İlk kullanıcı geri bildirimleri `docs/product/roadmap.md` → Faz 4'e eklendi
+- [ ] Check error tracking twice a day
+- [ ] Check the cost panel once a day
+- [ ] First user feedback was added to `docs/product/roadmap.md` → "Faz 4" (Phase 4)

package/docs/operations/spend-alarms.md

@@ -1,45 +1,45 @@
-# Harcama Alarmları
+# Spend Alarms
 
-> Canlıdaki ürünün faturası sessizce büyüyebilir. AI çağrısı yapan bir döngü, bot trafiği veya sızan bir API anahtarı bir gecede aylık bütçeyi bitirebilir. Bu dosya ücretli her servis için **tavanı** (aşılınca durur) ve **uyarıyı** (eşikte haber verir) kayıt altına alır.
-> Bu, Claude Code limitinden ayrı bir şey: Burada konu senin ürününün kendi faturası.
-> `/dashboard` panosu (Operasyon sekmesi) aşağıdaki tabloyu okur. Limiti boş olan ücretli satırı "ayarlanmadı" diye işaretler.
+> The bill of a live product can grow silently. A loop that calls an AI, bot traffic or a leaked API key can use up the monthly budget overnight. For every paid service, this file records the **cap** (stops when exceeded) and the **alert** (warns at a threshold).
+> This is separate from the Claude Code limit: here the subject is your own product's bill.
+> The `/dashboard` dashboard (Operations tab) reads the table below. It marks a paid row with an empty limit as "not set".
 
 ## Alarmlar
 
-Her ücretli servis için bir satır. **Tür:** `tavan` (servis durur veya istek reddedilir) ya da `uyarı` (sadece haber verir). **Tutar:** aylık, para birimiyle (örn. `50 USD`). **Son kontrol:** `YYYY-AA-GG`.
+One row per paid service. **Type:** `cap` (cap: the service stops or requests are rejected) or `alert` (alert: only warns). **Amount:** monthly, with currency (e.g. `50 USD`). **Last check:** `YYYY-AA-GG`.
 
-| Servis | Tür | Tutar | Uyarı eşikleri | Nereden ayarlandı | Son kontrol |
+| Service | Type | Amount | Alert thresholds | Set up at | Last check |
 |---|---|---|---|---|---|
 
-## Sağlayıcıların sunduğu ayarlar
+## Settings the providers offer
 
-Doğrulama tarihi: 2026-10-12. Panel yerleri ve özellikler değişebilir. Kurmadan önce `source-research` ile güncel dokümana bak.
+Verified: 2026-10-12. Panel locations and features can change. Before setting up, check the current docs with `source-research`.
 
-| Servis | Ne var | Durdurur mu? |
+| Service | What exists | Does it stop? |
 |---|---|---|
-| Anthropic (Claude API) | Console'da organizasyon ve workspace bazında aylık harcama limiti | Evet. Limit dolunca istekler hata döner. Her ürün için ayrı bir workspace aç. |
-| OpenAI | Proje bazında bütçe uyarıları; yeni hesaplarda sert limit de olabilir | Uyarılar durdurmaz. Sert limit varsa limit dolunca istek 429 döner. Panelden kontrol et. |
-| Vercel | Spend Management (Pro): %50, %75 ve %100'de bildirim, webhook | Varsayılan olarak durdurmaz. "Projeleri duraklat" seçeneği ayrıca açılmalı. |
-| Supabase | Pro planda harcama tavanı (spend cap) varsayılan açık | Evet, tavan açıksa kota aşımı faturalanmaz. Kapatırsan durdurmaz. |
-| Google Cloud / Firebase | Bütçe ve uyarı (Budgets & alerts) | Hayır, sadece haber verir. Durdurmak için ek otomasyon gerekir. |
+| Anthropic (Claude API) | Monthly spend limit per organization and workspace in the Console | Yes. When the limit is reached, requests return an error. Open a separate workspace for each product. |
+| OpenAI | Budget alerts per project; new accounts may also have a hard limit | Alerts do not stop. If a hard limit exists, requests return 429 when it is reached. Check in the panel. |
+| Vercel | Spend Management (Pro): notifications and a webhook at 50%, 75% and 100% | Does not stop by default. The "pause projects" option must be turned on separately. |
+| Supabase | On the Pro plan the spend cap is on by default | Yes, while the cap is on, quota overage is not billed. If you turn it off, it does not stop. |
+| Google Cloud / Firebase | Budgets & alerts | No, it only warns. Stopping needs extra automation. |
 
-Kural: Durdurmayan servislerde uyarıyı en az iki eşikte kur (%50 ve %80). Uyarıların gideceği e-posta adresi gerçekten okunan bir adres olmalı.
+Rule: For services that do not stop, set the alert at two thresholds at least (50% and 80%). The email address the alerts go to must be one that is actually read.
 
-## Uygulama içi koruma (kodda)
+## In-app protection (in code)
 
-Sağlayıcı limiti son savunmadır. Ondan önce ürünün kendisi harcamayı sınırlar. AI veya ücretli API çağrısı yapan her özellikte:
+The provider limit is the last defense. Before it, the product itself limits spending. For every feature that calls an AI or a paid API:
 
-1. **Kullanıcı başı kota:** Günlük veya aylık istek ya da token sınırı olur. Aşılınca anlaşılır bir mesaj gösterilir ("Bugünkü hakkın doldu, yarın yenilenir"). Kota sunucuda tutulur, istemciye güvenilmez.
-2. **Genel günlük bütçe:** Tüm kullanıcıların o günkü tahmini harcaması toplanır.
-   - Bütçenin %80'inde: Uyarı gönderilir (e-posta ve hata takibi).
-   - Bütçenin %100'ünde: Özellik bayrağı (`docs/operations/feature-flags.md`) otomatik kapanır. Kullanıcıya "geçici olarak kullanılamıyor" mesajı gösterilir.
-3. **Her çağrı loglanır:** özellik, model, girdi ve çıktı token sayısı, tahmini maliyet, kullanıcı id. İçerik loglanmaz (KVKK).
-4. **Kötüye kullanım:** Kayıt olmadan AI çağrısı yapılamaz. İstek hızı sınırı (rate limit) ve bot koruması vardır.
+1. **Per-user quota:** There is a daily or monthly limit on requests or tokens. When it is exceeded, a clear message is shown ("You have used today's allowance, it renews tomorrow"). The quota is kept on the server; do not trust the client.
+2. **Global daily budget:** The estimated spend of all users for that day is summed.
+   - At 80% of the budget: send an alert (email and error tracking).
+   - At 100% of the budget: the feature flag (`docs/operations/feature-flags.md`) turns off automatically. The user sees a "temporarily unavailable" message.
+3. **Log every call:** feature, model, input and output token counts, estimated cost, user id. Do not log the content (KVKK).
+4. **Abuse:** No AI call without signing up. There is a rate limit and bot protection.
 
-Bu kuralların uygulanma yöntemi `docs/architecture/stack.md`'ye, AI ekinde `docs/ai/guide.md` → "Maliyet kontrolü"ne yazılır.
+How these rules are implemented is written in `docs/architecture/stack.md` and, in the AI add-on, in `docs/ai/guide.md` → "Cost control".
 
-## Ne zaman kontrol edilir
+## When it is checked
 
-- **`/start` Adım 5 (dış servisler):** Ücretli seçilen her servis için tabloya bir satır eklenir.
-- **`/release`:** Ücretli her servisin tavanı veya uyarısı kurulmuş ve bir kez test edilmiş olmalıdır. Test: düşük bir eşikle uyarının geldiği görülür.
-- **`/maintain` haftalık:** Alarm tetiklendi mi? Gerçek harcama, `docs/product/unit-economics.md`'deki tahminle uyumlu mu?
+- **`/start` Step 5 (external services):** A row is added to the table for every paid service chosen.
+- **`/release`:** The cap or alert of every paid service must be set up and tested once. Test: with a low threshold, see the alert arrive.
+- **`/maintain` weekly:** Did an alarm fire? Does the real spend match the estimate in `docs/product/unit-economics.md`?

package/docs/product/feedback.md

@@ -1,19 +1,20 @@
-# Kullanıcı Geri Bildirimi
+# User Feedback
 
-> Kullanıcıların sesi. `/user-feedback` komutu yeni geri bildirimleri buraya işler, Ürün kurul üyesiyle önceliklendirir,
-> hangilerinin yol haritasına gireceğini sana sorar. `/dashboard` panosu açık geri bildirimleri ve öne çıkan temaları gösterir.
-> Kişisel veri yazma: kullanıcıyı anonim etiketle (K-001) belirt.
+> The voice of the users. The `/user-feedback` command puts new feedback here, prioritizes it with the Product board member,
+> and asks you which items go into the roadmap. `/dashboard` shows open feedback and the leading themes.
+> The headings "Gelen kutusu" (inbox) and "Temalar" (themes) stay Turkish: the dashboard reads them.
+> Do not write personal data: label the user anonymously (K-001).
 
 ## Gelen kutusu
 
-Tür: `hata` / `istek` / `şikayet` / `övgü` / `soru`. Durum: `yeni` / `planlandı` / `yapıldı` / `reddedildi` / `birleşti`.
+Types: `hata` / `istek` / `şikayet` / `övgü` / `soru`. Statuses: `yeni` / `planlandı` / `yapıldı` / `reddedildi` / `birleşti`.
 
-| # | Tarih | Kaynak | Kullanıcı | Özet | Tür | Tema | Öncelik | Durum | Görev |
+| # | Date | Source | User | Summary | Type | Theme | Priority | Status | Task |
 |---|---|---|---|---|---|---|---|---|---|
 
 ## Temalar
 
-Benzer geri bildirimler bir temada toplanır. Aynı temada 3+ geri bildirim varsa güçlü sinyaldir.
+Similar feedback is collected under one theme. 3+ feedback items in the same theme is a strong signal.
 
-| Tema | Geri bildirim sayısı | Etkilenen özellik | Karar |
+| Theme | Feedback count | Affected feature | Decision |
 |---|---|---|---|

package/docs/product/glossary.md

@@ -1,27 +1,27 @@
-# Sözlük
+# Glossary
 
-> Projedeki her kavramın **tek** adı. AI aynı şeye bir yerde `customer`, bir yerde `client`, ekranda "Üye" derse
-> kod ve arayüz dağılır. Yeni bir kavram çıktığında önce buraya eklenir, sonra kodda kullanılır.
-> `/start` PRD'den ilk terimleri çıkarır.
+> **One** name for every concept in the project. If the AI says `customer` in one place, `client` in another and "Member" on screen,
+> the code and the interface fall apart. When a new concept appears, add it here first, then use it in code.
+> `/start` pulls the first terms from the PRD.
 
-| Terim (arayüzde) | Kodda | Tanım | Bunlarla karıştırma / kullanma |
+| Term (in the UI) | In code | Definition | Do not confuse with / do not use |
 |---|---|---|---|
-| [Müşteri] | `customer` | [Fatura kesilen kişi veya şirket] | `client` (HTTP istemcisiyle karışır), "Üye" |
-| [Fatura] | `invoice` | [...] | `bill` |
-| [Kullanıcı] | `user` | Uygulamaya giriş yapan hesap | Müşteri ile aynı şey değil |
+| [Customer] | `customer` | [The person or company that is invoiced] | `client` (clashes with the HTTP client), "Member" |
+| [Invoice] | `invoice` | [...] | `bill` |
+| [User] | `user` | The account that signs in to the app | Not the same thing as Customer |
 
-## Durumlar (status alanları)
+## States (status fields)
 
-Bir kaydın alabileceği durumlar ve geçişler. AI'nın yeni durum uydurmasını engeller.
+The states a record can have and the transitions between them. This stops the AI from inventing a new state.
 
 ```
-[invoice.status]: taslak (draft) → gönderildi (sent) → ödendi (paid)
-                                  ↘ gecikti (overdue) → ödendi (paid)
+[invoice.status]: draft → sent → paid
+                                  ↘ overdue → paid
                   taslak → iptal (cancelled)
 ```
 
-## Yazım kuralları
+## Writing rules
 
-- Kod: İngilizce (`camelCase` değişken, `PascalCase` bileşen/tip, `snake_case` DB alanı).
-- Arayüz metni: Türkçe; "siz" mi "sen" mi? → [seç: sen]
-- Tarih: `GG.AA.YYYY`, para: `1.234,56 ₺` (`Intl` ile `tr-TR`).
+- Code: English (`camelCase` variable, `PascalCase` component/type, `snake_case` DB field).
+- UI text: Turkish; formal or informal "you" ("siz" or "sen")? → [pick: sen]
+- Date: `GG.AA.YYYY`, money: `1.234,56 ₺` (`tr-TR` with `Intl`).

package/docs/product/launch.md

@@ -1,43 +1,43 @@
-# Lansman
+# Launch
 
-> Teknik canlıya alma `docs/operations/release-checklist.md`'de. Bu dosya ürünün **kullanıcıya ulaşması** için.
-> Kişisel bir araç veya iç proje ise bu dosyayı sil.
+> Technical go-live is in `docs/operations/release-checklist.md`. This file is for the product **reaching users**.
+> If this is a personal tool or an internal project, delete this file.
 
-## 1. Lansman öncesi
+## 1. Before launch
 
-- [ ] **Tek cümlelik değer önerisi** (`docs/product/prd.md` §3) açılış sayfasının başlığında.
-- [ ] Açılış sayfası: ne yapar, kimin için, nasıl görünür (ekran görüntüsü/video), tek bir çağrı (kayıt / bekleme listesi).
-- [ ] Bekleme listesi veya erken erişim formu (lansmandan haftalar önce açılırsa ilk kullanıcılar hazır olur).
-- [ ] Analitik olayları tanımlandı ve çalışıyor:
+- [ ] **One-sentence value proposition** (`docs/product/prd.md` §3) in the landing page headline.
+- [ ] Landing page: what it does, who it is for, how it looks (screenshot/video), a single call to action (sign up / waitlist).
+- [ ] Waitlist or early-access form (if it opens weeks before launch, the first users are ready).
+- [ ] Analytics events defined and working:
 
-| Olay | Ne zaman tetiklenir | Neden önemli |
+| Event | When it fires | Why it matters |
 |---|---|---|
-| `signup` | Kayıt tamamlandı | Edinim |
-| `activated` | [İlk değer anı: örn. ilk faturayı gönderdi] | Aktivasyon |
-| `[ana_eylem]` | [Ürünün ana eylemi] | Kullanım |
-| `upgrade` | Ücretli plana geçti | Gelir |
+| `signup` | Signup completed | Acquisition |
+| `activated` | [First moment of value: e.g. sent their first invoice] | Activation |
+| `[ana_eylem]` | [The product's main action] | Usage |
+| `upgrade` | Moved to a paid plan | Revenue |
 
-- [ ] Geri bildirim kanalı: uygulama içi form veya e-posta, kolay görünür yerde.
-- [ ] Sosyal paylaşım görselleri (Open Graph), favicon, uygulama ikonu.
+- [ ] Feedback channel: an in-app form or email, in an easy-to-see place.
+- [ ] Social sharing images (Open Graph), favicon, app icon.
 
-## 2. Kanallar
+## 2. Channels
 
-| Kanal | Hedef kitle uyuyor mu? | Hazırlık | Tarih |
+| Channel | Does it fit the target audience? | Preparation | Date |
 |---|---|---|---|
-| [Kişisel ağ / LinkedIn / X] | | Kısa demo videosu | |
-| [Hedef kitlenin olduğu topluluklar, forumlar, gruplar] | | Topluluk kurallarını oku, spam yapma | |
-| [Product Hunt vb.] | | | |
-| [İçerik / SEO] | | Problemi anlatan 1-2 yazı | |
+| [Personal network / LinkedIn / X] | | Short demo video | |
+| [Communities, forums, groups where the target audience is] | | Read the community rules, do not spam | |
+| [Product Hunt etc.] | | | |
+| [Content / SEO] | | 1-2 posts that explain the problem | |
 
-## 3. İlk 30 gün
+## 3. First 30 days
 
-- [ ] İlk 10 kullanıcıyla birebir konuş: Neden kaydoldu, nerede takıldı, neyi bekliyordu?
-- [ ] Haftalık metrik bakışı (aşağıdaki tablo).
-- [ ] Geri bildirimleri `docs/product/roadmap.md` → Faz 4'e görev olarak ekle; en çok tekrar edenden başla.
-- [ ] `docs/product/prd.md` §4 başarı kriterleriyle karşılaştır: Hedefe yakın mı, yön değiştirmek gerekiyor mu?
+- [ ] Talk one-on-one with the first 10 users: Why did they sign up, where did they get stuck, what did they expect?
+- [ ] Weekly metrics review (table below).
+- [ ] Add the feedback as tasks to `docs/product/roadmap.md` → Faz 4; start with the most repeated one.
+- [ ] Compare with the `docs/product/prd.md` §4 success criteria: Is it close to the target, or is a change of direction needed?
 
-## 4. Metrik takibi
+## 4. Metrics tracking
 
-| Hafta | Yeni kayıt | Aktivasyon oranı | Haftalık aktif | 1. hafta tutunma | Gelir | Not |
+| Week | New signups | Activation rate | Weekly active | Week 1 retention | Revenue | Note |
 |---|---|---|---|---|---|---|
 | | | | | | | |

package/docs/product/prd.md

@@ -1,76 +1,77 @@
-# Ürün Gereksinimleri (PRD)
+# Product Requirements (PRD)
 
-> Aşama: **0 - Fikir**. Kod yazmadan önce doldurulur. `/start` komutu bu dosyayı seninle birlikte doldurur.
-> Son güncelleme: [YYYY-AA-GG]
+> Stage: **0 - Idea**. Fill it in before writing code. The `/start` command fills this file in together with you.
+> Last updated: [YYYY-AA-GG]
 
 ## 1. Problem
 
-[Kim, hangi durumda, neyi yapamıyor veya neyi zor yapıyor? 2-3 cümle.]
+[Who cannot do what, or finds what hard to do, and in which situation? 2-3 sentences.]
 
-## 2. Hedef kullanıcı
+## 2. Target user
 
-| Persona | Kim? | En büyük derdi | Şu an ne kullanıyor? |
+| Persona | Who? | Biggest pain | What do they use now? |
 |---|---|---|---|
-| [Birincil] | | | |
-| [İkincil] | | | |
+| [Primary] | | | |
+| [Secondary] | | | |
 
-## 3. Değer önerisi
+## 3. Değer önerisi (value proposition)
 
-[Tek cümle: "[Kullanıcı], [ürün] sayesinde [sonuç] elde eder, çünkü [fark]."]
+[One sentence: "With [product], [user] gets [result], because [difference]."]
 
-## 4. Başarı kriterleri (ölçülebilir)
+## 4. Success criteria (measurable)
 
-- [ ] [Örn: İlk 30 günde 50 kayıtlı kullanıcı]
-- [ ] [Örn: Kayıttan ilk değere ulaşma süresi < 3 dakika]
-- [ ] [Örn: Aylık altyapı maliyeti < X TL]
+- [ ] [E.g. 50 registered users in the first 30 days]
+- [ ] [E.g. time from signup to first value < 3 minutes]
+- [ ] [E.g. monthly infrastructure cost < X TL]
 
-## 5. MVP kapsamı
+## 5. MVP scope
 
-Her özellik bir kullanıcı hikayesi + kabul kriterleri. Kabul kriteri yoksa özellik hazır değildir.
-Her kriterin bir kimliği var (`Ö-01.1`). Kabul testleri bu kimliği test adında taşır; `/dashboard` panosu MVP ilerlemesini kutucuklardan değil **test sonuçlarından** okur (`docs/quality/test-plan.md` §1a).
+Each feature is a user story + acceptance criteria. A feature without acceptance criteria is not ready.
+Each criterion has an id (`Ö-01.1`). Acceptance tests carry this id in the test name; the `/dashboard` reads MVP progress from **test results**, not from checkboxes (`docs/quality/test-plan.md` §1a).
+The label "Öncelik" (priority) stays Turkish: the dashboard reads it.
 
-### Ö-01: [Özellik adı]
-**Hikaye:** [Kullanıcı] olarak [eylem] yapmak istiyorum, böylece [fayda].
-**Kabul kriterleri:**
-- [ ] Ö-01.1: [Gözlemlenebilir davranış: "Geçersiz e-posta girilince form gönderilmez ve hata mesajı gösterilir"]
+### Ö-01: [Feature name]
+**Story:** As a [user], I want to [action], so that [benefit].
+**Acceptance criteria:**
+- [ ] Ö-01.1: [Observable behavior: "When an invalid email is entered, the form is not sent and an error message is shown"]
 - [ ] Ö-01.2: [...]
-**Öncelik:** Olmazsa olmaz / Olsa iyi olur
+**Öncelik:** Must have / Nice to have
 
-### Ö-02: [Özellik adı]
+### Ö-02: [Feature name]
 ...
 
-## 6. Kapsam dışı (bu sürümde YAPILMAYACAK)
+## 6. Kapsam dışı (out of scope: NOT built in this release)
 
-Bu liste AI'nın kapsamı genişletmesini engeller. Aklına gelen her "sonra" fikrini buraya yaz.
+This list stops the AI from widening the scope. Write every "later" idea that comes to mind here.
 
-- [Örn: Çoklu dil desteği]
-- [Örn: Takım/organizasyon hesapları]
-- [Örn: Mobil uygulama]
+- [E.g. Multi-language support]
+- [E.g. Team/organization accounts]
+- [E.g. Mobile app]
 
-## 7. Ana kullanıcı akışları
+## 7. Main user flows
 
 ```
-[Akış 1: Kayıt]  Açılış → Kayıt ol → E-posta doğrula → Onboarding → Panel
-[Akış 2: ...]
+[Flow 1: Sign-up]  Landing → Sign up → Verify email → Onboarding → Dashboard
+[Flow 2: ...]
 ```
 
-## 8. Ekranlar / uç noktalar listesi
+## 8. List of screens / endpoints
 
-| Ad | Tür (sayfa/ekran/endpoint) | Kimler erişir | İlgili özellik |
+| Name | Type (page/screen/endpoint) | Who can access | Related feature |
 |---|---|---|---|
 | | | | |
 
-## 9. Kısıtlar
+## 9. Constraints
 
-- **Bütçe:** [aylık altyapı + AI API üst limiti]
-- **Süre:** [MVP hedef tarihi]
-- **Yasal:** [Kişisel veri işleniyor mu? Ödeme alınıyor mu? → `docs/legal/privacy-kvkk.md`]
-- **Teknik:** [Zorunlu platform, entegrasyon vb.]
+- **Budget:** [monthly cap for infrastructure + AI API]
+- **Time:** [MVP target date]
+- **Legal:** [Is personal data processed? Is payment taken? → `docs/legal/privacy-kvkk.md`]
+- **Technical:** [Required platform, integrations, etc.]
 
-## 10. Gelir modeli (varsa)
+## 10. Revenue model (if any)
 
-[Ücretsiz / abonelik / tek seferlik / reklam. Fiyat. Ödeme sağlayıcısı.]
+[Free / subscription / one-time / ads. Price. Payment provider.]
 
-## 11. Açık sorular
+## 11. Open questions
 
-- [ ] [Henüz cevabı olmayan, kararı etkileyen sorular]
+- [ ] [Questions without an answer yet that affect a decision]