tillerhand 3.32.1 → 3.34.0

package/.claude/agents/code-reviewer.md

@@ -28,7 +28,7 @@ Emin olmadığın bir şeyi bulgu olarak yazma; şüpheliyse "DOĞRULANMADI" eti
 
 ## Çıktı
 
-Övgü ve özet yok. Sadece bulgular, en ciddiden başlayarak:
+Övgü ve özet yok. Sadece bulgular, en ciddiden başlayarak; toplam en fazla ~15 satır, bulgu başına tek satır:
 
 ```
 [KRİTİK|ÖNEMLİ|KÜÇÜK] dosya:satır — Sorun. Somut senaryo (hangi girdiyle ne olur). Öneri.

package/.claude/agents/security-auditor.md

@@ -30,6 +30,8 @@ Sen bir uygulama güvenliği denetçisisin. Varsayılan tutumun şüphecilik: Bi
 
 ## Çıktı
 
+En ciddiden başlayarak; toplam en fazla ~15 satır, bulgu başına tek satır:
+
 ```
 [KRİTİK|YÜKSEK|ORTA|DÜŞÜK] dosya:satır — Açık. Sömürü senaryosu (saldırgan ne yapar, ne elde eder). Düzeltme.
 ```

package/.claude/board/rules.md

@@ -43,10 +43,10 @@ Kurulda olmayan bir üyeyi çağırma; ilgili alan kurulda yoksa durum bloğunda
 
 ## 4. Toplantı nasıl yapılır
 
-1. **Limit kontrolü** (`docs/workflow/usage-limits.md`): Seviye sarıysa üye sayısını yarıya indir; kırmızıysa kullanıcıya sor (kurulu hafiflet seçeneği dahil).
+1. **Limit kontrolü** (`docs/workflow/usage-limits.md`): Seviye sarıysa üye sayısını yarıya indir; kırmızıysa kullanıcıya sor (kurulu hafiflet seçeneği dahil). Görev sonu toplantısında üye sayısını ve paralel mi sırayla mı çalışılacağını `node .claude/hooks/flow.mjs` söyler (değişiklik büyüklüğü + limit; `code-reviewer` ve hassas yolda `security-auditor` her zaman katılır).
 1b. **Deterministik kapı** (commit, görev sonu, faz sonu; plan toplantısında yok): `node .claude/hooks/gate.mjs --run`. AGENTS.md → Komutlar'daki lint, tip kontrolü ve test ile Semgrep çalışır; sonuç değişiklik imzasıyla saklanır. Kırmızıysa veya boşsa (hiçbir kontrol çalışmadı) commit kapısı açılmaz: önce düzelt ya da Komutlar'ı doldur. Kullanıcı ara commit için açıkça isterse `node .claude/hooks/commit-gate.mjs --skip "kullanıcı isteği"` (her zaman onaya sorulur). Kapı "komut onayı gerekli" derse komutları kullanıcıya göster; onaylarsa `node .claude/hooks/gate.mjs --approve` (yeni veya değişen komut onaysız çalışmaz).
 1c. **Commit toplantısında önce** `node .claude/hooks/commit-gate.mjs --status`: "Onay geçerli" ise toplantı yok (görev sonu toplantısı aynı değişiklikleri denetledi). "Son onaydan sonra değişen: …" ise üyelere yalnız o dosyaların farkını ver.
-2. **Üyeleri paralel çalıştır** (Agent aracı, her üye ayrı alt ajan). Her üyeye şunları ver: toplantı türü, kapsam (plan metni / diff aralığı / faz), görev kodu, kabul kriterleri ve kapı çıktısı (varsa). Çağrıda inceleme rolünün `model` ve `effort`'unu ver (`node .claude/hooks/models.mjs --show`); commit toplantısında `model: "haiku"`, `effort: "low"` ver.
+2. **Üyeleri paralel çalıştır** (Agent aracı, her üye ayrı alt ajan). Her üyeye şunları ver: toplantı türü, kapsam (plan metni / diff aralığı / faz), görev kodu, kabul kriterleri ve kapı çıktısı (varsa). Çağrıda inceleme rolünün `model` ve `effort`'unu ver (`node .claude/hooks/models.mjs --show`); commit toplantısında `model: "haiku"`, `effort: "low"` ver. Rapor sözleşmesini istemde yaz: en fazla ~15 satır, bulgu başına tek satır, önem sırasıyla; övgü ve özet yok (raporlar ana oturumun bağlamına girer).
 2b. **Konsey toplantısıysa** (§2) `.claude/board/council.md` aşama 1-4'ü uygula. Sentezi başkanın kararından kur; görüş ayrılığı satırına azınlık görüşünü yaz.
 3. **Sentezle** (ana ajan; konseyde başkanın kararına göre):
 

package/.claude/commands/build.md

@@ -10,13 +10,14 @@ Boşsa `docs/workflow/progress.md` → "Sıradaki adım" veya `docs/product/road
 0b. **Model ve effort** (`docs/workflow/models.md`): Son seçimi `node .claude/hooks/models.mjs --show` ile oku. İki AskUserQuestion çağrısı yap: önce dört soru, her rolün modeli (Opus / Sonnet / Haiku); sonra dört soru, her rolün effort'u (düşük / orta / yüksek / ekstra yüksek). Her soruda models.md'deki önerilen seçenek ilk sırada ve "(Önerilen)" etiketli; son seçim farklıysa o seçeneğin açıklamasına "son seçim" yaz. Cevabı `node .claude/hooks/models.mjs --set plan=<model>:<effort> code=… review=… docs=…` ile kaydet. Ana oturumun modeli veya effort'u plan rolünden farklıysa tek satırla `/model <ad>` ve `/effort <düzey>` öner. Soru modunda `maliyet` konusu kapalıysa sorma ve `--set` çalıştırma: son seçim geçerli kalır, durum bloğunda "otomatik" yaz.
 1. Görevi ve kabul kriterlerini bana tek cümleyle tekrar et. `docs/workflow/progress.md` → aktif görevi güncelle.
 2. Bu görev için onaylanmış bir plan yoksa ve 2'den fazla dosyaya dokunacaksa önce `/plan-task` adımlarını uygula (karar noktaları dahil), onay bekle.
-2b. **Kod rolüne devret (2b ve 3):** Agent aracıyla alt ajan çalıştır, çağrıda kod rolünün `model` ve `effort`'unu ver. İstemde: görev ve kabul kriterleri, onaylı plan, dokunulacak dosyalar, adım 3'teki kurallar, önce kırmızı testler. Alt ajan kullanıcıya soru soramaz: karar noktasında durup soruyu ve seçenekleri raporlamasını iste; soruyu sen sor, kararı günlüğe yaz, alt ajanı cevapla devam ettir. Alt ajan bitince diff'i ve test çıktısını kendin oku; adım 4'ten sonrası ana oturumda. Kullanıcıya görünen metni (humanizer) son haline sen getir.
+2a. **Akış:** `node .claude/hooks/flow.mjs --files <plandaki dosya sayısı>` (masaüstünde durum çubuğu yok: `--context` ve `--limit`'i `get_usage`'dan ver). Çıktı kodun ve doküman işinin nerede yapılacağını (ana oturum / alt ajan), görev sonu kurulunun kaç üyeyle ve paralel mi sırayla mı toplanacağını söyler; 2b, 6b ve 8 buna uyar. "Önce /clear öner" derse tek satırla öner.
+2b. **Kod rolüne devret (2b ve 3):** Akış "Kod: ana oturum" diyorsa (küçük görev: alt ajanın soğuk başlangıcı kazandırdığından pahalı) kodu adım 3'e göre kendin yaz. Yoksa Agent aracıyla alt ajan çalıştır, çağrıda kod rolünün `model` ve `effort`'unu ver. İstemde: görev ve kabul kriterleri, onaylı plan, dokunulacak dosyalar, adım 3'teki kurallar, önce kırmızı testler. Alt ajan kullanıcıya soru soramaz: karar noktasında durup soruyu ve seçenekleri raporlamasını iste; soruyu sen sor, kararı günlüğe yaz, alt ajanı cevapla devam ettir. Raporu kısa iste (en fazla ~15 satır: değişen dosyalar, test sonucu sayıyla, açık sorular; kod ve tam çıktı yok). Alt ajan bitince diff'i ve test çıktısını kendin oku; adım 4'ten sonrası ana oturumda. Kullanıcıya görünen metni (humanizer) son haline sen getir.
    **Önce kabul testleri:** Görevin kabul kriterleri için testleri (kimlik test adında: `Ö-01.1`) ve gerekiyorsa saldırgan testlerini yaz, çalıştır ve **kırmızı** olduklarını göster (alt ajanın kırmızı çıktısını bana göster). Sonra uygula.
 3. Uygula. Kurallar:
    - **Uygularken yeni bir karar noktası çıkarsa dur ve sor** (`docs/workflow/decision-protocol.md`). Tahmin edip devam etme.
    - Skill'ler (`docs/workflow/skills.md`): Kod için `ponytail:ponytail`, kritik akış için `mattpocock-skills:tdd`. Arayüz için seçilen yön skill'i + `impeccable:impeccable` (`DESIGN.md`'ye bağlı kal; yeni tasarım kararı gerekirse `/design`). Kullanıcıya görünen metin için `humanizer:humanizer`.
    - Sadece bu görevin kapsamı. Görev dışı sorunları düzeltme, `docs/workflow/progress.md` → "Açık sorunlar"a yaz.
-   - Kod haritası bağlıysa keşfi onunla yap; dosyaları toptan okuma.
+   - Kod haritası bağlıysa keşfi onunla yap; dosyaları toptan okuma. Büyük dosyada önce ara (grep), sonra yalnız gereken satır aralığını oku.
    - Paket kurarken paket kapısı uyarırsa (uydurma / çok yeni / az kullanılan) kullanıcıya bildir; zorlamaya çalışma.
    - Plan bayrak gerektiriyorsa özelliği bayrak arkasına koy ve `docs/operations/feature-flags.md`'ye ekle.
    - Çalışırken limit %90 / %95 / %99'a gelirse `docs/workflow/usage-limits.md` §4'teki uyarıları ver; işi durdurma.
@@ -31,9 +32,9 @@ Boşsa `docs/workflow/progress.md` → "Sıradaki adım" veya `docs/product/road
    - API/iş mantığı → gerçek istek at veya testi çalıştır; isteği ve yanıtı göster.
    - Kanıt üretemiyorsan (cihaz, panel, ödeme gibi) bunu açıkça söyle ve benim yapmam gereken adımları yaz.
 6. Arayüz değiştiyse `impeccable:impeccable` → `critique` çalıştır; önemli bulguları düzeltip düzeltmeyeceğimi sor.
-6b. **Görev sonu kurul toplantısı** (`.claude/board/rules.md`; kurul kurulduysa). Bu, değişikliğin tek tam denetimidir: değişikliğe ilgili en fazla 3 üye + `code-reviewer` (değişiklik auth, ödeme, kişisel veri gibi hassas bir yola dokunuyorsa `security-auditor` da), inceleme rolünün `model` ve `effort`'uyla. RET varsa görev bitmez; bulguyu ve seçenekleri sor. ONAY veya KOŞULLU ONAY ise ve kapı (adım 4) yeşilse `node .claude/hooks/commit-gate.mjs --approve "görev sonu: <katılanlar>"`: commit aynı değişiklikler için kurulu yeniden toplamaz, sonradan değişen dosyalar varsa yalnız onlar incelenir. Toplantıyı `docs/workflow/board.md` günlüğüne yaz. Kurul kurulmadıysa adım 9'da `/review-changes` öner.
+6b. **Görev sonu kurul toplantısı** (`.claude/board/rules.md`; kurul kurulduysa). Bu, değişikliğin tek tam denetimidir: değişikliğe ilgili, akışın (2a) söylediği sayıda üye (en fazla 3) + `code-reviewer` (değişiklik auth, ödeme, kişisel veri gibi hassas bir yola dokunuyorsa `security-auditor` da), inceleme rolünün `model` ve `effort`'uyla. RET varsa görev bitmez; bulguyu ve seçenekleri sor. ONAY veya KOŞULLU ONAY ise ve kapı (adım 4) yeşilse `node .claude/hooks/commit-gate.mjs --approve "görev sonu: <katılanlar>"`: commit aynı değişiklikler için kurulu yeniden toplamaz, sonradan değişen dosyalar varsa yalnız onlar incelenir. Toplantıyı `docs/workflow/board.md` günlüğüne yaz. Kurul kurulmadıysa adım 9'da `/review-changes` öner.
 7. `AGENTS.md` → "Bitti tanımı" listesini tek tek kontrol et.
-8. Kapsam kalkanını kapat (komut kullanıcıya sorulur): `node .claude/hooks/freeze-guard.mjs --plan-end`. `docs/product/roadmap.md`'de görevi işaretle; PRD'de sadece testi yeşil olan kriterleri işaretle. Testleri JUnit raporuyla çalıştır (`docs/architecture/stack.md` → Kabul testleri) ki pano güncellensin. Limiti tekrar oku ve `docs/workflow/cost-log.md`'ye satır ekle (başlangıç/bitiş 5 saatlik %, süre dk). Roadmap, cost-log ve progress yazımını tek alt ajan çağrısıyla doküman rolüne ver (`model`, `effort`); sonucu kontrol et (progress.md'nin kalın etiketli satırları durum çubuğu ve pano için aynı biçimde kalmalı).
+8. Kapsam kalkanını kapat (komut kullanıcıya sorulur): `node .claude/hooks/freeze-guard.mjs --plan-end`. `docs/product/roadmap.md`'de görevi işaretle; PRD'de sadece testi yeşil olan kriterleri işaretle. Testleri JUnit raporuyla çalıştır (`docs/architecture/stack.md` → Kabul testleri) ki pano güncellensin. Limiti tekrar oku ve `docs/workflow/cost-log.md`'ye satır ekle (başlangıç/bitiş 5 saatlik %, süre dk). Roadmap, cost-log ve progress yazımını akış "Doküman: alt ajan" diyorsa tek alt ajan çağrısıyla doküman rolüne ver (`model`, `effort`), "ana oturum" diyorsa kendin yaz; sonucu kontrol et (progress.md'nin kalın etiketli satırları durum çubuğu ve pano için aynı biçimde kalmalı).
 9. Rapor ver:
    - Ne yapıldı (2-3 satır)
    - Bu görevde alınan kararlar (kullanıcı / otomatik)
@@ -43,4 +44,5 @@ Boşsa `docs/workflow/progress.md` → "Sıradaki adım" veya `docs/product/road
    - Kontrol edemediğin veya şüpheli olduğun yerler
    - Görevde bir davranışını düzelttiysem ya da tercih söylediysem: aynı AskUserQuestion çağrısında ayrı bir çoklu seçim sorusu olarak "Tercih olarak kaydedeyim mi?" (AGENTS.md → kural 9, varsa; seçilenler `prefs.mjs --add`). Not yoksa sorma.
    - Sonra ne yapalım? AskUserQuestion ile sor: commit (Önerilen; görev sonu denetimi geçerli, kurul kurulmadıysa önce `/review-changes`) / sıradaki göreve geç / bu görevde değişiklik iste. Commit'te hafif kurul denetimi otomatik istenir (commit kapısı hook'u). Commit atıldıktan ve testler yeşilken çalışan nokta kaydet: `node .claude/hooks/checkpoint.mjs --save "<görev kodu> bitti, testler yeşil"` (`/rollback` buraya döner).
+   - Commit atıldıysa: `docs/workflow/progress.md` → "Sıradaki adım" güncel mi bak, sonra tek satırla `/clear` öner (görev = oturum, `docs/workflow/usage-limits.md` §3; bağlam yüzdesinden bağımsız). Yeni oturum progress.md'den devam eder.
    - Durum bloğu

package/.claude/hooks/flow.mjs

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+// Work plan for a task from its size, the context and the limit (0 tokens): a subagent only where it pays.
+// A subagent starts cold (it reads its prompt and the files again); for a small task that costs more than it saves.
+//   node .claude/hooks/flow.mjs [--files N] [--context N] [--limit N] [--json]
+// Without arguments: files = changed files in git, context = status line (.claude/state/context.json),
+// limit = usage.mjs. On the desktop app there is no status line: give --context and --limit from get_usage.
+import fs from 'node:fs';
+import path from 'node:path';
+import { findRoot, isMain } from './shared.mjs';
+import { changes } from './commit-gate.mjs';
+import { readLimits, level, LEVEL_LABEL } from './usage.mjs';
+
+// Same bands as the cost table in docs/workflow/usage-limits.md §3 (1-2, 3-6, more files)
+export function flow({ files, context, level: lvl }) {
+  const size = files <= 2 ? 'küçük' : files <= 6 ? 'orta' : 'büyük';
+  const clear = context != null && context >= 50;
+  // A full main context is paid again on every turn: the code goes out of it
+  const code = size === 'küçük' && !clear ? 'ana' : 'alt ajan';
+  const base = { küçük: 1, orta: 2, büyük: 3 }[size];
+  // Yellow halves the members (rules.md §4); red runs one, so a RET stops before the rest is paid for
+  const members = lvl === 'red' ? 1 : lvl === 'yellow' ? Math.ceil(base / 2) : base;
+  return { files, context, level: lvl, size, clear, code, docs: code, members, reviewer: true, parallel: lvl !== 'red' };
+}
+
+export function flowText(f) {
+  const where = (w) => (w === 'ana' ? 'ana oturum' : 'alt ajan');
+  return [
+    `Akış: ${f.files} dosya · ${f.size} · bağlam ${f.context == null ? 'bilinmiyor' : `%${f.context}`} · limit ${LEVEL_LABEL[f.level]}`,
+    `Kod: ${where(f.code)}${f.code === 'ana' ? '' : ' (kod rolü)'}`,
+    `Doküman (roadmap, progress, cost-log): ${where(f.docs)}${f.docs === 'ana' ? '' : ' (doküman rolü)'}`,
+    `Kurul: ${f.members} üye + code-reviewer, ${f.parallel ? 'paralel' : 'sırayla'} (hassas yolda + security-auditor)`,
+    ...(f.clear ? [`Önce /clear öner: bağlam %${f.context}, her tur bunu yeniden okur.`] : []),
+  ].join('\n');
+}
+
+const readContext = (root) => {
+  try { const c = JSON.parse(fs.readFileSync(path.join(root, '.claude', 'state', 'context.json'), 'utf8')); return typeof c.percent === 'number' ? c.percent : null; } catch { return null; }
+};
+
+if (isMain(import.meta.url)) {
+  const root = findRoot();
+  const arg = (name) => {
+    const i = process.argv.indexOf(name);
+    if (i < 0) return undefined;
+    const n = Number(process.argv[i + 1]);
+    if (!Number.isFinite(n) || n < 0) { console.error('Kullanım: node .claude/hooks/flow.mjs [--files N] [--context N] [--limit N] [--json]'); process.exit(1); }
+    return n;
+  };
+  const files = arg('--files') ?? (() => { try { return changes().files.length; } catch { return 0; } })();
+  const limit = arg('--limit');
+  const f = flow({ files, context: arg('--context') ?? readContext(root), level: level(limit != null ? { five_hour: { percent: limit } } : readLimits(root)) });
+  console.log(process.argv.includes('--json') ? JSON.stringify(f) : flowText(f));
+}

package/.claude/hooks/gate.mjs

@@ -26,7 +26,16 @@ const CHECKS = ['lint', 'tip kontrol', 'test'];
 const APPROVED = [...CHECKS, 'geliştirme', 'önizleme'];
 const TIMEOUT = 10 * 60 * 1000;
 const BUFFER = 64 * 1024 * 1024;
-const tail = (s) => s.trimEnd().split(/\r?\n/).slice(-30).join('\n');
+// A red check shows its last 30 lines; a longer output is kept whole in a file, read only when the tail is not enough
+function failed(root, name, r) {
+  const all = `${r.error ? `${r.error.message}\n` : ''}${r.stdout ?? ''}${r.stderr ?? ''}`.trimEnd();
+  const lines = all.split(/\r?\n/);
+  if (lines.length <= 30) return { output: all };
+  const rel = `.claude/state/gate-log/${name.toLowerCase().replace(/\s+/g, '-')}.log`;
+  fs.mkdirSync(path.join(root, path.dirname(rel)), { recursive: true });
+  fs.writeFileSync(path.join(root, rel), all);
+  return { output: lines.slice(-30).join('\n'), note: `son 30 satır; tamamı ${rel}` };
+}
 
 // Only the "## Komutlar" section is read: a "test:" line elsewhere must not count as a command
 export function readCommands(md, names = CHECKS) {
@@ -70,7 +79,7 @@ function check(root, { name, command }) {
   const r = spawnSync(command, { cwd: root, shell: true, encoding: 'utf8', timeout: TIMEOUT, maxBuffer: BUFFER });
   const sec = Math.round((Date.now() - start) / 1000);
   if (r.status === 0) return { name, command, status: 'passed', sec };
-  return { name, command, status: 'failed', sec, output: tail(`${r.error ? `${r.error.message}\n` : ''}${r.stdout ?? ''}${r.stderr ?? ''}`) };
+  return { name, command, status: 'failed', sec, ...failed(root, name, r) };
 }
 
 function semgrep(root, files) {
@@ -93,7 +102,7 @@ function semgrep(root, files) {
   }
   const sec = Math.round((Date.now() - start) / 1000);
   if (r.status === 0) return { name, status: 'passed', sec };
-  return { name, status: 'failed', sec, output: tail(`${r.error ? `${r.error.message}\n` : ''}${r.stdout ?? ''}${r.stderr ?? ''}`) };
+  return { name, status: 'failed', sec, ...failed(root, name, r) };
 }
 
 // A path that only exists on this machine in a changed line breaks the code, tests and docs on every other machine.

package/.claude/settings.json

@@ -26,7 +26,8 @@
       "Bash(node .claude/hooks/prefs.mjs --list)",
       "Bash(node .claude/hooks/models.mjs --show)",
       "Bash(node .claude/hooks/models.mjs --set:*)",
-      "Bash(node .claude/hooks/commit-gate.mjs --status)"
+      "Bash(node .claude/hooks/commit-gate.mjs --status)",
+      "Bash(node .claude/hooks/flow.mjs:*)"
     ],
     "ask": [
       "Bash(git push:*)",

package/README.en.md

@@ -6,7 +6,7 @@
 </p>
 
 <p align="center">
-  <a href="kit/CHANGELOG.md"><img alt="Version" src="https://img.shields.io/badge/version-3.32.1-2a78d6?style=flat-square"></a>
+  <a href="kit/CHANGELOG.md"><img alt="Version" src="https://img.shields.io/badge/version-3.34.0-2a78d6?style=flat-square"></a>
   <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-2a78d6?style=flat-square"></a>
   <img alt="Claude Code" src="https://img.shields.io/badge/Claude%20Code-ready-d97757?style=flat-square">
   <img alt="Also Codex and Antigravity" src="https://img.shields.io/badge/also-Codex%20%C2%B7%20Antigravity-5b6577?style=flat-square">

package/README.md

@@ -6,7 +6,7 @@
 </p>
 
 <p align="center">
-  <a href="kit/CHANGELOG.md"><img alt="Sürüm" src="https://img.shields.io/badge/s%C3%BCr%C3%BCm-3.32.1-2a78d6?style=flat-square"></a>
+  <a href="kit/CHANGELOG.md"><img alt="Sürüm" src="https://img.shields.io/badge/s%C3%BCr%C3%BCm-3.34.0-2a78d6?style=flat-square"></a>
   <a href="LICENSE"><img alt="Lisans: MIT" src="https://img.shields.io/badge/lisans-MIT-2a78d6?style=flat-square"></a>
   <img alt="Claude Code" src="https://img.shields.io/badge/Claude%20Code-haz%C4%B1r-d97757?style=flat-square">
   <img alt="Codex ve Antigravity" src="https://img.shields.io/badge/ayr%C4%B1ca-Codex%20%C2%B7%20Antigravity-5b6577?style=flat-square">

package/docs/workflow/decision-protocol.md

@@ -28,7 +28,7 @@ Emin değilsen karar noktasıdır, sor.
 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.** Birbirine bağlı kararları sırayla sor (önce framework, sonra ona bağlı kütüphane).
+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.

package/docs/workflow/usage-limits.md

@@ -54,6 +54,7 @@ Max planda yüzdeler daha düşüktür. Günlük doldukça tahmin kendini düzel
    - **Kurulu hafiflet:** Plan ve görev sonu toplantılarına sadece `security-auditor` + `board-architect` katılır. Commit denetimini sadece kod dosyalarında yap, tek üyeyle.
 3. **Haftalık limit sarı veya kırmızıysa** ayrıca tek satırla uyar: Haftalık limit geç yenilenir.
 4. Kullanıcı bir seçenek seçtiyse kararı `docs/decisions/log.md` günlüğüne `maliyet` konusu olarak yaz.
+5. **Görev = oturum.** Her tur, oturumdaki bütün bağlamı yeniden okur; önceki görevin dosyaları ve çıktıları sonraki görevde boşuna para tutar. Görev bitip commit atılınca `/clear` öner (bağlam yüzdesinden bağımsız). Yeni oturum `docs/workflow/progress.md`'den devam eder.
 
 ## 4. Çalışırken limit uyarıları
 

package/kit/CHANGELOG.md

@@ -3,6 +3,25 @@
 Kit sürümü `kit/VERSION` dosyasında. Bir projeyi güncellemek: projede `/kit-update`.
 "Elle uyarla" notu olan maddeler projeye ait dosyalardadır; güncelleme bunlara dokunmaz.
 
+## [3.34.0] - 2026-10-26
+
+### Eklenen
+- **Alt ajan yalnız karlıysa.** Alt ajan soğuk başlar: istemini ve dosyaları yeniden okur. Küçük bir görevde bu, kazandırdığından pahalıdır. Yeni `node .claude/hooks/flow.mjs` görev büyüklüğüne (dosya sayısı), bağlama ve limite bakıp akışı söyler, token harcamaz:
+  - 1-2 dosya: kod ve doküman işi ana oturumda. 3 ve üstü ya da bağlam %50'nin üstündeyse kod rolü alt ajanda.
+  - Görev sonu kurulu 1, 2 ya da 3 üye + `code-reviewer` (hassas yolda `security-auditor` da). Limit sarıda üye sayısı yarıya iner, kırmızıda tek üye sırayla çalışır.
+  - Bağlam %50'nin üstündeyse önce `/clear` önerilir.
+  - `/build` (adım 2a) ve kurul kuralları bunu kullanır. Masaüstü uygulamasında durum çubuğu olmadığı için bağlam ve limit `--context`, `--limit` ile verilir.
+  - İzin satırı `/kit-update` ile eklenir.
+
+## [3.33.0] - 2026-10-26
+
+### Değişen
+- **Ana oturumun bağlamı küçük kalıyor.** Her tur oturumdaki bütün bağlamı yeniden okur; bağlama giren her satır sonraki turlarda yeniden ödenir.
+  - Aynı adımın birbirinden bağımsız soruları tek soru turunda sorulur (en fazla 4).
+  - Kapı kırmızıda son 30 satırı gösterir; daha uzun çıktının tamamı `.claude/state/gate-log/<kontrol>.log` dosyasına yazılır ve yalnız gerekirse okunur.
+  - Kurul üyeleri, `code-reviewer`, `security-auditor` ve kod alt ajanı en fazla ~15 satırlık rapor verir, bulgu başına tek satır.
+  - `/build` görev bitip commit atılınca `/clear` önerir (görev = oturum); yeni oturum `progress.md`'den devam eder. Büyük dosyada önce arama, sonra yalnız gereken satırlar okunur.
+
 ## [3.32.1] - 2026-10-26
 
 ### Düzeltilen

package/kit/VERSION

@@ -1 +1 @@
-3.32.1
+3.34.0

package/kit/guide.html

@@ -287,7 +287,7 @@ footer .container { display: flex; flex-wrap: wrap; gap: 16px; justify-content:
 <section class="hero">
   <div class="container">
     <div>
-      <span class="pill"><b>v3.32.1</b> Claude Code için başlangıç kiti · MIT</span>
+      <span class="pill"><b>v3.34.0</b> Claude Code için başlangıç kiti · MIT</span>
       <h1>Kodu AI yazar.<br><em>Dümen sende.</em></h1>
       <p class="sub">TillerHand, Claude Code ile bir ürünü fikirden canlıya ve bakıma kadar götürür. Her önemli kararda AI sana seçenekleri, önerisini ve her seçeneğin bedelini sunar. Bir uzman kurulu işi denetler, korumalar hatayı daha olmadan durdurur.</p>
       <div class="install"><span id="cmd">npx tillerhand init</span><button class="copy" type="button" data-copy="cmd">Kopyala</button></div>
@@ -882,7 +882,7 @@ Sıradaki: G-013 şifre sıfırlama · bekleyen karar: e-posta servisi</pre>
       </tbody>
     </table></div>
   </div>
-  <div class="note">Görev maliyetleri <code>docs/workflow/cost-log.md</code>'ye yazılır; tahminler zamanla gerçek verilere oturur. Oturum açılışında sadece özet kurallar ve <code>docs/workflow/progress.md</code> yüklenir (yaklaşık 1.700 token). Kod haritası bağlıysa kod, dosyalar okunmadan sorgulanır.</div>
+  <div class="note">Görev maliyetleri <code>docs/workflow/cost-log.md</code>'ye yazılır; tahminler zamanla gerçek verilere oturur. Oturum açılışında sadece özet kurallar ve <code>docs/workflow/progress.md</code> yüklenir (yaklaşık 1.700 token). Kod haritası bağlıysa kod, dosyalar okunmadan sorgulanır. Ana oturumun bağlamı da küçük tutulur: bağımsız sorular tek turda sorulur, kapı ve alt ajan raporları kısa gelir, görev bitip commit atılınca <code>/clear</code> önerilir.</div>
 </section>
 
 <section id="yetenekler">
@@ -894,7 +894,7 @@ Sıradaki: G-013 şifre sıfırlama · bekleyen karar: e-posta servisi</pre>
     <article class="tile"><h3>Dağıtım kurulumu</h3><p class="stack">/release first · deploy-setup.md</p><ul><li>Hosting, ortam değişkenleri, alan adı ve DNS, yedek, geri alma provası</li><li>Vercel, Supabase, Railway, EAS; adımlar kaynaklı ve tarihli</li><li>Sırrı sen panelde girersin; sohbete ve dosyaya yazılmaz</li></ul></article>
     <article class="tile"><h3>Öğrenen kurallar</h3><p class="stack">/fix-bug · /retro · hookify · AGENTS.md</p><ul><li>Aynı hata sınıfı ikinci kez gelince /fix-bug kural önerir; panoda da uyarı çıkar</li><li>Mekanik kural hookify'a, gerisi AGENTS.md'ye; sen onaylamadan yazılmaz</li><li>Her kuralda kaynak ve tarih; /maintain 90 günden eskileri sorar</li><li>Auto memory /start'ta sorulur, önerilen kapalı</li></ul></article>
     <article class="tile"><h3>Kişisel tercihler</h3><p class="stack">~/.vibe-kit/tercihler.md · prefs.mjs</p><ul><li>Bir davranışı düzelttiğinde ya da nasıl çalışmak istediğini söylediğinde AI not alır</li><li>Görev ve oturum sonunda "tercih olarak kaydedeyim mi?" diye sorar; onaylamadığın yazılmaz</li><li>Tercihler tüm projelerinde geçerli, her oturumda yüklenir; git'e girmez</li><li>Listele: <code>node .claude/hooks/prefs.mjs --list</code>, sil: <code>--remove &lt;no&gt;</code></li></ul></article>
-    <article class="tile"><h3>Rol bazlı model</h3><p class="stack">docs/workflow/models.md · models.mjs</p><ul><li>Dört rol: planlama, kod yazma, inceleme, doküman ve araştırma</li><li>Her görevin başında iki ekran: önce rollerin modeli, sonra effort'u</li><li>Önerilen: Opus yüksek, Sonnet yüksek, Sonnet yüksek, Haiku yüksek</li><li>Kod, inceleme ve doküman işleri seçilen modelle alt ajanda; plan ana oturumda</li></ul></article>
+    <article class="tile"><h3>Rol bazlı model</h3><p class="stack">docs/workflow/models.md · models.mjs</p><ul><li>Dört rol: planlama, kod yazma, inceleme, doküman ve araştırma</li><li>Her görevin başında iki ekran: önce rollerin modeli, sonra effort'u</li><li>Önerilen: Opus yüksek, Sonnet yüksek, Sonnet yüksek, Haiku yüksek</li><li>Kod, inceleme ve doküman işleri seçilen modelle alt ajanda; plan ana oturumda</li><li>Alt ajan yalnız karlıysa: <code>flow.mjs</code> görev büyüklüğüne, bağlama ve limite bakar; küçük görev ana oturumda kalır, kurul üye sayısı limite göre azalır</li></ul></article>
     <article class="tile"><h3>Türkiye eki</h3><p class="stack">--addons tr · docs/legal/turkiye.md</p><ul><li>KVKK yurt dışı aktarım: standart sözleşme, 5 iş günü bildirim</li><li>e-Fatura ve e-Arşiv eşikleri (GİB)</li><li>iyzico ve PayTR bildirim imzası kodu ve saldırgan testi</li><li>İ/ı ve Türkçe sıralama testleri; hukuki görüş değildir</li></ul></article>
     <article class="tile"><h3>Tarayıcıda QA ve önizleme</h3><p class="stack">/qa · preview.mjs · Playwright CLI</p><ul><li>Arayüz kriterleri gerçek tarayıcıda test olarak koşar</li><li>Rapor test sonucundan yazılır, panoda kart</li><li>/build arayüz görevinde masaüstü ve mobil ekran görüntüsü</li></ul></article>
     <article class="tile"><h3>Spec ve sapma kontrolü</h3><p class="stack">docs/product/specs/ · gate.mjs</p><ul><li>Mevcut, beklenen ve değişmemesi gereken davranış</li><li>"Değişmemesi gereken" satırların testi kapıda denetlenir</li><li>3+ dosyalık işte /plan-task, her hatada /fix-bug yazar</li></ul></article>
@@ -1055,7 +1055,7 @@ Sıradaki: G-013 şifre sıfırlama · bekleyen karar: e-posta servisi</pre>
 <footer>
   <div class="container">
     <a class="brand" href="#top" style="font-size:16px"><svg class="mark" style="width:22px;height:22px"><use href="#mark"/></svg>TillerHand</a>
-    <span>Sürüm 3.32.1 · <a href="https://github.com/burakdogrul/TillerHand">GitHub</a> · <a href="https://github.com/burakdogrul/TillerHand/blob/main/LICENSE">MIT lisansı</a> · KVKK bölümü kontrol listesidir, hukuki görüş değildir.</span>
+    <span>Sürüm 3.34.0 · <a href="https://github.com/burakdogrul/TillerHand">GitHub</a> · <a href="https://github.com/burakdogrul/TillerHand/blob/main/LICENSE">MIT lisansı</a> · KVKK bölümü kontrol listesidir, hukuki görüş değildir.</span>
   </div>
 </footer>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tillerhand",
-  "version": "3.32.1",
+  "version": "3.34.0",
   "description": "Claude Code, Codex ve Antigravity için Türkçe vibe coding kiti: kurallar, komutlar, korumalar ve proje şablonları.",
   "license": "MIT",
   "type": "module",