tillerhand 3.43.0 → 3.47.0

package/.github/workflows/npm-publish.yml

@@ -1,7 +1,7 @@
-# Kitin npm paketini (tillerhand) yayınlar: v* tag'i push edilince. Projelere kopyalanmaz (kit/kit.mjs → KIT_ONLY).
-# Token yok: npm Trusted Publishing (OIDC). npmjs.com → tillerhand → Settings → Trusted Publisher: GitHub Actions,
-# burakdogrul / TillerHand / npm-publish.yml / environment: npm. Kaynak: docs.npmjs.com/trusted-publishers (2026-10-06).
-# Action'lar commit SHA'sına sabit (checkout v7.0.1, setup-node v7.1.0); yeni sürüme geçerken SHA'yı github.com/actions/<ad>/releases'tan al.
+# Publishes the kit's npm package (tillerhand) when a v* tag is pushed. Not copied into projects (kit/kit.mjs → KIT_ONLY).
+# No token: npm Trusted Publishing (OIDC). npmjs.com → tillerhand → Settings → Trusted Publisher: GitHub Actions,
+# burakdogrul / TillerHand / npm-publish.yml / environment: npm. Source: docs.npmjs.com/trusted-publishers (2026-10-06).
+# Actions are pinned to a commit SHA (checkout v7.0.1, setup-node v7.1.0); when moving to a new version, take the SHA from github.com/actions/<name>/releases.
 name: npm-publish
 
 on:
@@ -12,7 +12,7 @@ permissions:
   contents: read
 
 jobs:
-  # Repo kodu (testler) yayın yetkisi olmadan koşar
+  # Repo code (tests) runs without publish permission
   test:
     runs-on: ubuntu-latest
     steps:
@@ -23,18 +23,18 @@ jobs:
         with:
           node-version: 24
           package-manager-cache: false # no cache in a release workflow (cache poisoning)
-      - name: Tag main'deki bir commit'i mi gösteriyor
-        run: git merge-base --is-ancestor "$GITHUB_SHA" origin/main || { echo "Tag main dalında değil, yayın durdu."; exit 1; }
-      - name: Sürümler aynı mı (tag, package.json, kit/VERSION)
+      - name: Does the tag point to a commit on main
+        run: git merge-base --is-ancestor "$GITHUB_SHA" origin/main || { echo "The tag is not on main, publish stopped."; exit 1; }
+      - name: Are the versions the same (tag, package.json, kit/VERSION)
         run: |
           tag="${GITHUB_REF_NAME#v}"
           pkg=$(node -p "require('./package.json').version")
           kit=$(cat kit/VERSION)
           echo "tag=$tag package.json=$pkg kit/VERSION=$kit"
-          [ "$tag" = "$pkg" ] && [ "$tag" = "$kit" ] || { echo "Sürümler farklı, yayın durdu."; exit 1; }
+          [ "$tag" = "$pkg" ] && [ "$tag" = "$kit" ] || { echo "The versions differ, publish stopped."; exit 1; }
       - run: node --test "kit/tests/*.test.mjs"
 
-  # Sadece yayın: repo kodu çalıştırmaz, OIDC yetkisi yalnız burada
+  # Publish only: runs no repo code, the OIDC permission exists only here
   publish:
     needs: test
     runs-on: ubuntu-latest
@@ -49,19 +49,19 @@ jobs:
           node-version: 24
           package-manager-cache: false # no cache in a release workflow (cache poisoning)
           registry-url: https://registry.npmjs.org
-      - name: npm sürümü (Trusted Publishing 11.5.1+ ister)
+      - name: npm version (Trusted Publishing needs 11.5.1+)
         run: node -e "const [a,b,c]=process.argv[1].split('.').map(Number); process.exit(a>11||(a===11&&(b>5||(b===5&&c>=1)))?0:1)" "$(npm --version)"
-      # İlk yayını hesap sahibi elle yapar (2FA ile); bu sürüm zaten yayındaysa (elle yayınlandıysa) tekrar denenmez.
-      # Sadece 404 "yok" sayılır; ağ veya sunucu hatası koşuyu durdurur.
-      - name: Yayınlanacak mı
+      # The account owner does the first publish by hand (with 2FA); if this version is already published (by hand), it is not tried again.
+      # Only a 404 counts as "does not exist"; a network or server error stops the run.
+      - name: Should it be published
         id: check
         run: |
           v=$(node -p "require('./package.json').version")
           if out=$(npm view "tillerhand@$v" version 2>&1); then
-            echo "::notice::tillerhand@$v zaten yayında; atlandı."
+            echo "::notice::tillerhand@$v is already published; skipped."
           elif echo "$out" | grep -q E404; then
             if npm view tillerhand name >/dev/null 2>&1; then echo "go=1" >> "$GITHUB_OUTPUT"
-            else echo "::warning::tillerhand npm'de yok; ilk yayın elle yapılır, bu koşu atlandı."; fi
+            else echo "::warning::tillerhand does not exist on npm; the first publish is done by hand, this run was skipped."; fi
           else
             echo "$out"; exit 1
           fi

package/AGENTS.md

@@ -1,67 +1,67 @@
 # [PROJE ADI]
 
-> [Tek cümle: Bu proje kimin için, hangi problemi çözüyor?]
+> [One sentence: who is this project for, and what problem does it solve?]
 
-Bu dosya projenin ortak kurallarıdır; Claude Code, Codex ve Antigravity okur. Claude Code'a özel ekler `CLAUDE.md`'de.
+This file holds the shared rules of the project. Claude Code, Codex and Antigravity read it. Claude Code-only additions are in `CLAUDE.md`.
 
-**Kurulum durumu:** Kökte `kit/` klasörü varsa ve `.kit.json` yoksa, ya da `.kit.json` → `type` boşsa (`null`) proje henüz kurulmamıştır. Kullanıcıya yeni projede `/start [fikir]`, klasörde var olan kod varsa `/adopt` öner; kurulum bitmeden kod yazma.
+**Setup status:** The project is not set up yet if a `kit/` folder exists in the root and `.kit.json` does not, or if `.kit.json` → `type` is empty (`null`). Suggest `/start [idea]` to the user for a new project, and `/adopt` if the folder already has code. Do not write code before setup is done.
 
-**Oturum başı:** `docs/workflow/progress.md`'yi oku (güncel durum, sıradaki adım). Claude Code bunu kendisi yükler.
+**Session start:** Read `docs/workflow/progress.md` (current state, next step). Claude Code loads it by itself.
 
-## Temel kurallar (her zaman geçerli)
+## Core rules (always apply)
 
-1. **Kararı kullanıcı verir.** Ürün, teknik, tasarım, içerik, veri, güvenlik ve maliyet kararlarında AskUserQuestion ile sor. 2-4 seçenek sun; önerin ilk sırada ve "(Önerilen)" etiketli olsun. Her seçenekte ne zaman daha iyi olduğunu ve bedelini yaz. Tasarım kararları görsel önizlemeyle sorulur. Soru modunda kapalı konularda önerileni seç ve "otomatik" diye kaydet. **İlk karar sorusundan önce `docs/workflow/decision-protocol.md`'yi oku.** Daha önce verilmiş kararlar `docs/decisions/log.md`'de; onları tekrar sorma. Her kararı tek yönlü / çift yönlü kapı olarak sınıfla; tek yönlülerde (veritabanı, auth, ödeme, veri modeli) önce kurul görüşü al.
-2. **Uzman kurulu denetler** (`docs/workflow/board.md`, kurallar `.claude/board/rules.md`). Plan onayından önce, görev bitince, her commit'te (hafif) ve faz sonunda ilgili üyeler toplanır. Kurul danışmandır; RET (kritik bulgu) varsa iş bitmez, kullanıcıya sorulur.
-3. **Doğru kaynak.** Sürüm, fiyat, kota, mevzuat, API gibi değişebilen bilgiyi hafızadan kullanma: `source-research` skill'i (önce birincil kaynak, her iddiaya kaynak ve tarih). Kütüphane kullanırken önce **Context7** MCP ile güncel dokümanı getir.
-4. **Az token harca.** Kod haritası (codebase-memory-mcp) bağlıysa kodu keşfederken önce onu sorgula (`get_architecture`, `search_graph`, `trace_path`, `get_code_snippet`). Dosyaları toptan okuma. Dokümanları sadece gerektiğinde oku (tablo aşağıda).
-5. **Yapıya uy (zorunlu).** Yeni dosyayı `.claude/structure.json` haritasındaki yerine yaz (özellik bazlı: `features/<özellik>/`); açıklaması `docs/architecture/structure.md`. Harita dışı yazım sorulur, dağınıklık dosyaları (`*.bak`, `*-old.*`, kopya) engellenir. Geçici ve deneme işleri `sandbox/`, artık geçerli olmayan dokümanlar `docs/archive/`. Haritayı değiştirmek teknik bir karardır.
-6. **Önce plan, sonra kod.** 2'den fazla dosyaya dokunan iş `/plan-task`'dan geçer. Tek seferde tek görev. Kapsamı genişletme. Dört ilke: (1) varsayımını söyle, belirsizse sor; (2) en sade çözüm, istenmeyen esneklik yok; (3) sadece görevin gerektirdiği satırlara dokun; (4) işe başlarken doğrulanabilir başarı ölçütünü yaz.
-7. **Kök neden, kanıt, test.** Kabul testleri (kriter kimliği test adında, `Ö-01.1`) ve saldırgan testleri koddan önce yazılır ve önce kırmızı olur. Testi kodu yazan değil, ayrı bir ajan (`test-writer`, test rolünün modeliyle) yazar; kodu yazan test dosyasına dokunmaz (test koruması engeller). Riskli özellik bayrak arkasında yayınlanır (`docs/operations/feature-flags.md`). Hata düzeltirken önce yeniden üret. "Bitti" demeden çalıştığını göster. Aynı hatada 2 denemede çözemezsen dur ve yön iste.
-8. **Her cevabın sonunda durum bloğu** (kısa). Biçim:
+1. **The user decides.** Ask with AskUserQuestion for product, technical, design, content, data, security and cost decisions. Offer 2-4 options; put your recommendation first and label it "(Recommended)". For each option, state when it is better and what it costs. Ask design decisions with a visual preview. In question mode, pick the recommended option on closed topics and record it as `otomatik` in the decision log ("Auto decisions" in the status block). **Read `docs/workflow/decision-protocol.md` before the first decision question.** Earlier decisions are in `docs/decisions/log.md`; do not ask them again. Classify every decision as a one-way or two-way door; for one-way doors (database, auth, payment, data model), get the board's opinion first.
+2. **The expert board reviews** (`docs/workflow/board.md`, rules in `.claude/board/rules.md`). The relevant members meet before plan approval, when a task ends, at every commit (light) and at the end of a phase. The board only advises; if there is a RET (critical finding), the work is not done and the user is asked.
+3. **Right source.** Do not use information that can change from memory: versions, prices, quotas, regulation, APIs. Use the `source-research` skill (primary source first, every claim with source and date). When using a library, first fetch the current docs with the **Context7** MCP.
+4. **Spend few tokens.** If the code map (codebase-memory-mcp) is connected, query it first when exploring code (`get_architecture`, `search_graph`, `trace_path`, `get_code_snippet`). Do not read files in bulk. Read docs only when needed (table below).
+5. **Follow the structure (mandatory).** Write each new file to its place in the `.claude/structure.json` map (by feature: `features/<feature>/`); it is explained in `docs/architecture/structure.md`. Writing outside the map is asked about; clutter files (`*.bak`, `*-old.*`, copies) are blocked. Temporary and trial work goes to `sandbox/`, outdated docs to `docs/archive/`. Changing the map is a technical decision.
+6. **Plan first, then code.** Work that touches more than 2 files goes through `/plan-task`. One task at a time. Do not widen the scope. Four principles: (1) state your assumption, ask if unsure; (2) simplest solution, no flexibility nobody asked for; (3) touch only the lines the task needs; (4) write a verifiable success criterion when you start.
+7. **Root cause, evidence, tests.** Acceptance tests (criterion id in the test name, `Ö-01.1`) and adversarial tests are written before the code and are red first. A separate agent (`test-writer`, with the test role's model) writes the tests, not the one who writes the code; the code writer does not touch test files (test protection blocks it). Risky features ship behind a feature flag (`docs/operations/feature-flags.md`). When fixing a bug, reproduce it first. Show that it works before saying "done". If you cannot fix the same error in 2 attempts, stop and ask for direction.
+8. **A status block at the end of every answer** (short). Format:
 
 ```
-── Durum ──────────────────────
-Aşama: … · Görev: … (x/y) · Soru modu: … · Limit: 5s %… hf %…
-Yapıldı: … · Kurul: … · Otomatik kararlar: …
-Sıradaki: … · bekleyen karar: …
+── Status ──────────────────────
+Phase: … · Task: … (x/y) · Question mode: … · Limit: 5h %… weekly %…
+Done: … · Board: … · Auto decisions: …
+Next: … · pending decision: …
 ```
 
-9. **Kullanıcıyı tanı.** Oturum başında gelen "Kişisel tercihler"e uy (proje kuralı önce gelir). Kullanıcı bir davranışını düzeltirse ya da nasıl çalışmak istediğini söylerse (konuşma, soru sıklığı, rapor biçimi, kod tarzı, kaçınılacaklar) kısaca not al; akışı bölme. Görev sonunda (`/build`) ve oturum sonunda (`/wrap-up`) notları AskUserQuestion ile çoklu seçim olarak sor ("Tercih olarak kaydedeyim mi?"). Seçilenleri `node .claude/hooks/prefs.mjs --add <konusma|sorular|raporlar|kod|kacin> "<tercih>"` ile yaz. Onaysız yazma. Sır, kişisel veri ya da proje adı yazma. Projeye özgü kural bu dosyaya değil "Öğrenilen kurallar"a gider.
+9. **Know the user.** Follow the "Personal preferences" that arrive at session start (project rules come first). If the user corrects a behavior or says how they want to work (conversation, question frequency, report format, code style, things to avoid), note it briefly; do not break the flow. At the end of a task (`/build`) and at the end of a session (`/wrap-up`), ask about the notes with AskUserQuestion as a multi-select ("Save as a preference?"). Write the selected ones with `node .claude/hooks/prefs.mjs --add <konusma|sorular|raporlar|kod|kacin> "<preference>"`. Do not write without approval. Do not write secrets, personal data or the project name. A project-specific rule goes to "Öğrenilen kurallar" (learned rules), not to this file.
 
 <!-- kit:other-tools -->
-## Codex ve Antigravity'de
+## In Codex and Antigravity
 
-Kit Claude Code için yazıldı; bu iki araçta şu karşılıklar geçerli:
+The kit was written for Claude Code; these equivalents apply in these two tools:
 
-- **Komutlar** (`/start`, `/build`…) `.agents/skills/` altında skill olarak durur: Codex'te `$start` ya da `/skills`, Antigravity'de `/start`. Kaynakları `.claude/commands/`; skill kopyaları kit güncellemesinde yeniden üretilir, düzenleme kaynakta yapılır.
-- **AskUserQuestion** geçen her yerde: Antigravity'de `ask_question` aracı. Seçenekli soru aracı yoksa (Codex) seçenekleri numaralı liste olarak yaz, önerileni ilk sıraya koy ve "(Önerilen)" diye işaretle, cevabı bekle. Karar yine kullanıcınındır.
-- **Alt ajanlar** (kurul üyeleri, konsey, inceleme ajanları `.claude/agents/`): Çalıştıramıyorsan ilgili tanımı oku, o rolle kendin değerlendir ve raporda "tek model" diye belirt. Test ayrımı (kural 7) burada hook ile zorlanamaz: testleri `test-writer` tanımıyla, kodu düşünmeden önce yaz ve kırmızıyı göster; kodu yazarken test dosyasını değiştirme.
-- **Model ve effort** (`docs/workflow/models.md`): Alt ajanı rolün karşılığıyla başlat (Codex: istemde model ve reasoning effort; Antigravity: `inherit`, `flash` ya da `pro`). Yapamıyorsan rolü kendin yürüt, modeli metinle öner.
-- **Korumalar** (sır engeli, yıkıcı komut kalkanı, yapı koruyucu, düzenleme kilidi, test koruması, düzenleme turu sayacı, paket kapısı ve Claude Code izin listesinin karşılığı) hook olarak çalışır: Codex `.codex/hooks.json`, Antigravity `.agents/hooks.json`. Kural ve koruma dosyalarına (`AGENTS.md`, `.claude/`, `.codex/`, `.agents/hooks.json`) yazma onaya bağlıdır. Engellenen işlemi başka yoldan (örneğin kabuk komutuyla) yapmaya çalışma; nedenini kullanıcıya söyle.
-- Claude Code eklentilerine ait skill'ler (adı `eklenti:skill` biçiminde) bu araçlarda yok: o adımı atla. Limit okuma ve durum çubuğu da yok: durum bloğunda limit "-" kalır.
+- **Commands** (`/start`, `/build`…) live under `.agents/skills/` as skills: in Codex `$start` or `/skills`, in Antigravity `/start`. Their sources are in `.claude/commands/`; skill copies are regenerated on kit update, so edit the source.
+- **Wherever AskUserQuestion appears:** in Antigravity, the `ask_question` tool. If there is no question tool with options (Codex), write the options as a numbered list, put the recommended one first and mark it "(Recommended)", then wait for the answer. The decision is still the user's.
+- **Subagents** (board members, council, review agents in `.claude/agents/`): If you cannot run them, read the matching definition, assess as that role yourself and state "single model" in the report. The test separation (rule 7) cannot be enforced here by a hook: write the tests with the `test-writer` definition, before you think about the code, and show the red run; do not change the test file while writing the code.
+- **Model and effort** (`docs/workflow/models.md`): Start the subagent with the role's equivalent (Codex: model and reasoning effort in the prompt; Antigravity: `inherit`, `flash` or `pro`). If you cannot, run the role yourself and suggest the model in text.
+- **Protections** (secret block, destructive command shield, structure guard, edit lock, test protection, edit round counter, package gate and the equivalent of the Claude Code permission list) run as hooks: Codex `.codex/hooks.json`, Antigravity `.agents/hooks.json`. Writing to rule and protection files (`AGENTS.md`, `.claude/`, `.codex/`, `.agents/hooks.json`) needs approval. Do not try another route (for example a shell command) around a blocked action; tell the user why.
+- Skills that belong to Claude Code plugins (named `plugin:skill`) do not exist in these tools: skip that step. There is also no limit reading and no status line: the limit stays "-" in the status block.
 <!-- /kit:other-tools -->
 
-## Gerektiğinde oku
+## Read when needed
 
-| Dosya | Ne zaman |
+| File | When |
 |---|---|
-| `docs/architecture/stack.md` | Kod yazarken: komutlar, kurallar, doğrulama yöntemi |
-| `docs/product/prd.md` | Kapsam veya kabul kriteri belirsizse |
-| `docs/architecture/overview.md`, `docs/product/glossary.md` | Yeni dosya/tablo/servis/kavram eklerken |
-| `docs/product/roadmap.md` | Görev seçerken ve işaretlerken |
-| `docs/design/design-guide.md`, `DESIGN.md`, `PRODUCT.md` | Arayüz işinde |
-| `docs/quality/test-plan.md`, `docs/security/checklist.md` | Kritik akış, auth, veri, ödeme koduna dokunurken |
-| `docs/workflow/models.md` | Alt ajan çağırırken (rolün modeli ve effort'u) |
-| `docs/ai/guide.md` (varsa) | Prompt veya model çağrısı işinde |
-| `docs/operations/accounts.md`, `docs/product/unit-economics.md` | Yeni dış servis, fiyat veya maliyet kararı |
-| `docs/operations/feature-flags.md` | Ödeme, AI, toplu bildirim, veri silen veya büyük arayüz değişikliği |
-| `docs/product/feedback.md`, `docs/quality/metrics.md` | Kullanıcı geri bildirimi, retro, bakım |
-| `docs/findings/<tür>/latest.md` | İlgili alanda iş yaparken: bilinen bulgular (`/findings-<tür>` raporları) |
+| `docs/architecture/stack.md` | When writing code: commands, rules, verification method |
+| `docs/product/prd.md` | When scope or an acceptance criterion is unclear |
+| `docs/architecture/overview.md`, `docs/product/glossary.md` | When adding a new file/table/service/concept |
+| `docs/product/roadmap.md` | When picking and marking tasks |
+| `docs/design/design-guide.md`, `DESIGN.md`, `PRODUCT.md` | On interface work |
+| `docs/quality/test-plan.md`, `docs/security/checklist.md` | When touching critical flow, auth, data or payment code |
+| `docs/workflow/models.md` | When calling a subagent (the role's model and effort) |
+| `docs/ai/guide.md` (if present) | On prompt or model-call work |
+| `docs/operations/accounts.md`, `docs/product/unit-economics.md` | New external service, price or cost decision |
+| `docs/operations/feature-flags.md` | Payment, AI, bulk notification, data-deleting or large interface change |
+| `docs/product/feedback.md`, `docs/quality/metrics.md` | User feedback, retro, maintenance |
+| `docs/findings/<type>/latest.md` | When working in the relevant area: known findings (`/findings-<type>` reports) |
 
 ## Komutlar
 
 ```bash
-# /start seçilen stack'e göre doldurur
+# /start fills these in for the chosen stack
 geliştirme:  [ ]
 önizleme:    [ ]
 test:        [ ]
@@ -70,27 +70,27 @@ tip kontrol: [ ]
 build:       [ ]
 ```
 
-## "Bitti" tanımı
+## Definition of "done"
 
-- [ ] Kabul kriterleri karşılandı; görevde çıkan kararlar soruldu ve kaydedildi
-- [ ] Lint, tip, testler temiz; kritik akışa dokunulduysa test eklendi
-- [ ] Hata, boş ve yükleniyor durumları ele alındı; çalıştığına dair kanıt gösterildi (doğrulama komutu bu turda çalıştırıldı ve çıktısı gösterildi; "çalışmalı" kanıt değildir)
-- [ ] Arayüz varsa: `DESIGN.md`'ye uygun, Impeccable critique yapıldı, metinler humanizer'dan geçti
-- [ ] Görev sonu kurul toplantısında RET yok
-- [ ] Kodda sır yok; yeni ortam değişkeni `.env.example`'da; `docs/product/roadmap.md` işaretli
+- [ ] Acceptance criteria are met; decisions that came up in the task were asked and recorded
+- [ ] Lint, types and tests are clean; a test was added if critical flow was touched
+- [ ] Error, empty and loading states are handled; evidence that it works was shown (the verification command ran in this turn and its output was shown; "it should work" is not evidence)
+- [ ] If there is an interface: matches `DESIGN.md`, Impeccable critique done, texts passed through humanizer
+- [ ] No RET in the end-of-task board meeting
+- [ ] No secrets in code; any new environment variable is in `.env.example`; `docs/product/roadmap.md` is marked
 
-## Asla
+## Never
 
-- `.env` dosyalarını okuma, yazma, içeriğini ekrana basma. Sırrı koda, loga veya istemci tarafına koyma.
-- Onay almadan (soru modundan bağımsız): veri silme/sıfırlama, `git push --force`, `git reset --hard`, toplu dosya silme, prod deploy, para harcatan işlem.
-- Testi geçirmek için testi silme veya zayıflatma (test koruması hook'u sorar). Var olmayan API veya paket uydurma.
-- Hook'ları (sır engeli, commit kapısı) atlatmaya çalışma. Kullanıcı adına karar verip sonradan bildirme.
-- Koda, teste veya belgeye bu makineye özel mutlak yol yazma (`C:\Users\<ad>\…`, `/home/<ad>/…`, proje klasörünün tam yolu). Yolu proje kökünden, betiğin konumundan veya geçici klasörden türet; kapı yakalar. Bilinçli bir örnekse satıra `kit:yol-izinli` yaz.
+- Do not read, write or print `.env` files. Do not put a secret in code, logs or client-side code.
+- Do not do these without approval (regardless of question mode): data deletion/reset, `git push --force`, `git reset --hard`, bulk file deletion, prod deploy, any action that spends money.
+- Do not delete or weaken a test to make it pass (the test protection hook asks). Do not invent APIs or packages that do not exist.
+- Do not try to bypass hooks (secret block, commit gate). Do not decide for the user and report afterwards.
+- Do not write a machine-specific absolute path into code, tests or docs (`C:\Users\<name>\…`, `/home/<name>/…`, the full project folder path). Derive the path from the project root, the script location or a temp folder; the gate catches it. For a deliberate example, write `kit:yol-izinli` on the line.
 
 ## Git
 
-Küçük ve sık commit. Mesaj biçimi: `tür: açıklama` (`feat`, `fix`, `refactor`, `docs`, `test`, `chore`, `wip`). `main` her zaman çalışır olmalı.
+Small, frequent commits. Message format: `type: description` (`feat`, `fix`, `refactor`, `docs`, `test`, `chore`, `wip`). `main` must always work.
 
 ## Öğrenilen kurallar
 
-> `/fix-bug` aynı hata sınıfı tekrarlayınca, `/retro` dönem sonunda önerir; sen onaylarsan eklenir. Biçim: `- Kural. (kaynak: … · YYYY-AA-GG)`; tarih eklenme veya son gözden geçirme. En fazla ~10 satır. `/maintain monthly` 90 günden eskileri gözden geçirir.
+> `/fix-bug` suggests when the same error class repeats, `/retro` suggests at the end of a period; added if you approve. Format: `- Rule. (kaynak: … · YYYY-AA-GG)`; the date is when it was added or last reviewed. At most ~10 lines. `/maintain monthly` reviews those older than 90 days.

package/CHANGELOG.md

@@ -1,19 +1,19 @@
-# Değişiklik Günlüğü
+# Changelog
 
-Biçim: [Keep a Changelog](https://keepachangelog.com/tr-TR/1.1.0/). Sürümleme: `MAJOR.MINOR.PATCH`.
+Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Versioning: `MAJOR.MINOR.PATCH`.
 
 ## [Yayınlanmamış]
 
-### Eklendi
+### Added
 - 
 
-### Değişti
+### Changed
 - 
 
-### Düzeltildi
+### Fixed
 - 
 
 ## [0.1.0] - YYYY-AA-GG
 
-### Eklendi
-- Proje iskeleti
+### Added
+- Project skeleton

package/CLAUDE.md

@@ -2,10 +2,10 @@
 
 @docs/workflow/progress.md
 
-## Claude Code'a özel kurallar
+## Claude Code-specific rules
 
-Ortak kurallar `AGENTS.md`'de (yukarıda içe alındı). Bunlar onlara ektir:
+The shared rules are in `AGENTS.md` (imported above). These are additions to them:
 
-- **Doğru skill'i kullan.** Kod: `ponytail:ponytail`. Kritik akış: `mattpocock-skills:tdd`. Arayüz: seçilen stil skill'i + `impeccable:impeccable`; hareket: `ui-motion`. Logo: `logo-design`. Tanıtım videosu: `motion-video`. Metin: `humanizer:humanizer`. Rapor dili: `caveman:caveman`. Tam tablo (ilk ihtiyaçta oku): `docs/workflow/skills.md`. Çekirdek dışı eklentiler paket olarak kapalı gelir; komut gerektirince açmayı sorar (`/tools`).
-- **Limiti ve bağlamı gözet** (`docs/workflow/usage-limits.md`). İş başlamadan limiti oku: masaüstünde `get_usage` aracı, terminalde `node .claude/hooks/usage.mjs`. Sarı/kırmızı seviyede tahmini maliyeti tek satırla söyle. Limit sadece uyarı sebebidir, işi durdurma: %90 hatırlat, %95 uyar ve "Kaldığı yer"i güncelle, %99 "yarım kalabilir" de; kullanıcı "dur" demedikçe devam et. Bağlam %50'yi geçince uygun noktada `/wrap-up` + `/clear` öner.
-- **Durum bloğu** caveman dilinde yazılır.
+- **Use the right skill.** Code: `ponytail:ponytail`. Critical flow: `mattpocock-skills:tdd`. Interface: the chosen style skill + `impeccable:impeccable`; motion: `ui-motion`. Logo: `logo-design`. Promo video: `motion-video`. Text: `humanizer:humanizer`. Report language: `caveman:caveman`. Full table (read on first need): `docs/workflow/skills.md`. Non-core plugins come switched off as packages; when a command needs one, ask to switch it on (`/tools`).
+- **Watch the limit and the context** (`docs/workflow/usage-limits.md`). Read the limit before starting work: the `get_usage` tool on desktop, `node .claude/hooks/usage.mjs` in the terminal. At yellow/red level, state the estimated cost in one line. The limit is only a reason to warn, not to stop work: remind at 90%, warn at 95% and update "Kaldığı yer" (where we left off), say "may be left unfinished" at 99%; keep going unless the user says "stop". When the context passes 50%, suggest `/wrap-up` + `/clear` at a suitable point.
+- **The status block** is written in caveman style.