beast-agent 1.7.0 → 1.9.0

package/src/agent/searxng.js

@@ -0,0 +1,325 @@
+'use strict';
+
+/* SearXNG — yerel metasearch entegrasyonu (github.com/searxng/searxng)
+   SearXNG resmi olarak Linux/Docker hedefler; Windows'ta `import pwd`
+   yüzünden patlar. Bu modül Beast'ın GÖMÜLÜ Python'ına gerçek searxng'yi
+   (GitHub master) kurar + pwd shim'i yazar + 127.0.0.1:8888'de arka planda
+   çalıştırır. Arama zinciri 'searxng' motorunu yalnız AYAKTAYSA kullanır.
+
+   CLI:  beast searxng          → gerekirse kur + başlat
+         beast searxng status   → durum
+         beast searxng stop     → kulla */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { spawn, execFile, execSync } = require('child_process');
+
+const REQS_URL = 'https://raw.githubusercontent.com/searxng/searxng/master/requirements.txt';
+const PKG_URL = 'https://github.com/searxng/searxng/archive/refs/heads/master.zip';
+const GETPIP_URL = 'https://bootstrap.pypa.io/get-pip.py';
+const DEFAULT_URL = 'http://127.0.0.1:8888';
+
+/* ---------- yollar ---------- */
+
+function beastAppDir() {
+  if (process.env.BEAST_DATA) return process.env.BEAST_DATA;
+  return process.env.APPDATA
+    ? path.join(process.env.APPDATA, 'beast')
+    : path.join(os.homedir(), 'AppData', 'Roaming', 'beast');
+}
+
+function dir() {
+  const d = path.join(beastAppDir(), 'searxng');
+  try { fs.mkdirSync(d, { recursive: true }); } catch {}
+  return d;
+}
+
+function settingsPath() { return path.join(dir(), 'settings.yml'); }
+function runPyPath() { return path.join(dir(), 'run.py'); }
+function pidPath() { return path.join(dir(), 'server.pid'); }
+function pyExe() { return path.join(beastAppDir(), 'py', 'python.exe'); }
+
+/* ---------- durum yoklama (cache'li) ---------- */
+
+let _probe = { at: 0, up: false, url: '' };
+const PROBE_UP_TTL = 5 * 60 * 1000;
+const PROBE_DOWN_TTL = 2 * 60 * 1000;
+
+function resetProbeCache() { _probe = { at: 0, up: false, url: '' }; }
+
+async function isUp(baseUrl = DEFAULT_URL, { force = false } = {}) {
+  const base = String(baseUrl || DEFAULT_URL).replace(/\/+$/, '');
+  const ttl = _probe.up ? PROBE_UP_TTL : PROBE_DOWN_TTL;
+  if (!force && _probe.url === base && Date.now() - _probe.at < ttl) return _probe.up;
+  let up = false;
+  try {
+    const r = await fetch(`${base}/search?q=beast&format=json`, { signal: AbortSignal.timeout(1800) });
+    if (r.ok) {
+      const j = await r.json();
+      up = j && Array.isArray(j.results);
+    }
+  } catch {}
+  _probe = { at: Date.now(), up, url: base };
+  return up;
+}
+
+/* ---------- arama (zincir motoru) ---------- */
+
+async function search(query, { maxResults = 8, signal, baseUrl } = {}) {
+  const base = String(baseUrl || process.env.BEAST_SEARXNG_URL || DEFAULT_URL).replace(/\/+$/, '');
+  if (!(await isUp(base))) return null; // ayakta değil → zincir sıradaki motora geçer
+  try {
+    const sig =
+      signal && typeof AbortSignal !== 'undefined' && AbortSignal.any
+        ? AbortSignal.any([signal, AbortSignal.timeout(15000)])
+        : AbortSignal.timeout(15000);
+    const r = await fetch(
+      `${base}/search?q=${encodeURIComponent(String(query || ''))}&format=json&safesearch=0`,
+      { signal: sig }
+    );
+    if (!r.ok) return null;
+    const j = await r.json();
+    const results = (j.results || [])
+      .map((x) => ({
+        title: String(x.title || ''),
+        url: String(x.url || ''),
+        snippet: String(x.content || '').replace(/\s+/g, ' ').slice(0, 400),
+        engine: 'searxng',
+      }))
+      .filter((x) => x.url && x.title);
+    if (!results.length) return null;
+    return {
+      ok: true,
+      engine: 'searxng',
+      query,
+      results: results.slice(0, Math.max(1, Math.min(12, Number(maxResults) || 8))),
+    };
+  } catch {
+    return null;
+  }
+}
+
+/* ---------- kurulum ---------- */
+
+function sh(exe, args, timeoutMs = 600000) {
+  return new Promise((resolve, reject) => {
+    execFile(exe, args, { timeout: timeoutMs, windowsHide: true, maxBuffer: 8 * 1024 * 1024 }, (err, stdout, stderr) => {
+      if (err) {
+        const tail = String((stderr || stdout || err.message) || '').slice(-400);
+        return reject(new Error(tail || String(err)));
+      }
+      resolve(String(stdout || ''));
+    });
+  });
+}
+
+async function downloadTo(url, dest) {
+  const r = await fetch(url, { signal: AbortSignal.timeout(120000) });
+  if (!r.ok) throw new Error(`indirme başarısız: HTTP ${r.status}`);
+  fs.writeFileSync(dest, Buffer.from(await r.arrayBuffer()));
+}
+
+function sitePackagesDir(py) {
+  return sh(py, ['-c', 'import sysconfig;print(sysconfig.get_paths()["purelib"])']).then((s) => s.trim());
+}
+
+/* gömülü python'un ._pth dosyasında `import site` açık değilse pip/paketler görünmez */
+function fixEmbeddedPth(py) {
+  try {
+    const dirPy = path.dirname(py);
+    for (const f of fs.readdirSync(dirPy)) {
+      if (/^python\d+\._pth$/.test(f)) {
+        const p = path.join(dirPy, f);
+        const cur = fs.readFileSync(p, 'utf8');
+        if (!/^import site$/m.test(cur)) {
+          fs.writeFileSync(p, cur.replace(/^#\s*import site/m, 'import site'), 'utf8');
+        }
+      }
+    }
+  } catch {}
+}
+
+async function ensurePip(py, onLog) {
+  try {
+    await sh(py, ['-m', 'pip', '--version'], 60000);
+    return;
+  } catch {}
+  onLog('pip kuruluyor…');
+  const gp = path.join(os.tmpdir(), 'beast-get-pip.py');
+  await downloadTo(GETPIP_URL, gp);
+  await sh(py, [gp, '--no-warn-script-location'], 300000);
+  fixEmbeddedPth(py);
+}
+
+/** Tam kurulum — `beast searxng` komutunun yaptığı iş. */
+async function install({ onLog } = {}) {
+  const log = (m) => { try { (onLog || ((s) => console.log('  • ' + s)))(m); } catch {} };
+  const tools = require('./tools');
+  const probe = await tools.ensurePython();
+  const py = probe.exe;
+  log('python: ' + py);
+
+  await ensurePip(py, log);
+  log('setuptools/wheel/tzdata kuruluyor…');
+  await sh(py, ['-m', 'pip', 'install', '--no-warn-script-location', 'setuptools', 'wheel', 'tzdata'], 600000);
+
+  log('searxng bağımlılıkları indiriliyor (~40 MB)…');
+  const reqs = path.join(os.tmpdir(), 'beast-searxng-requirements.txt');
+  await downloadTo(REQS_URL, reqs);
+  await sh(py, ['-m', 'pip', 'install', '--no-warn-script-location', '-r', reqs], 900000);
+
+  log('searxng motoru kuruluyor…');
+  await sh(py, ['-m', 'pip', 'install', '--no-warn-script-location', '--no-build-isolation', PKG_URL], 900000);
+
+  /* pwd shim — searxng/valkeydb.py unix socket sahipliği için pwd import eder */
+  const sp = (await sitePackagesDir(py)) || path.join(path.dirname(py), 'Lib', 'site-packages');
+  const shim = [
+    '"""Windows shim: SearXNG valkeydb.py yalnizca unix-socket sahipligi icin pwd',
+    'kullanir; Windows\'ta valkey devre disi oldugundan donuk yanit yeterlidir."""',
+    'import os',
+    '',
+    'class _Pw:',
+    '    pw_name = "beast"',
+    '    pw_uid = 0',
+    '    pw_gid = 0',
+    '    pw_dir = os.path.expanduser("~")',
+    '    pw_shell = ""',
+    '',
+    'def getpwuid(uid):',
+    '    return _Pw()',
+    '',
+    'def getpwnam(name):',
+    '    return _Pw()',
+    '',
+    'def getgrgid(gid):',
+    '    class _Gr:',
+    '        gr_name = "beast"',
+    '        gr_gid = 0',
+    '    return _Gr()',
+    '',
+    'def getgrnam(name):',
+    '    return getgrgid(0)',
+  ].join('\n');
+  fs.writeFileSync(path.join(sp, 'pwd.py'), shim, 'utf8');
+
+  /* ayarlar + çalıştırıcı */
+  const secret = 'beast-' + Math.random().toString(36).slice(2, 14);
+  fs.writeFileSync(
+    settingsPath(),
+    [
+      'use_default_settings: true',
+      'server:',
+      `  secret_key: "${secret}"`,
+      '  port: 8888',
+      '  bind_address: "127.0.0.1"',
+      '  limiter: false',
+      '  image_proxy: false',
+      'search:',
+      '  formats:',
+      '    - html',
+      '    - json',
+      '',
+    ].join('\n'),
+    'utf8'
+  );
+  fs.writeFileSync(runPyPath(), 'from searx.webapp import run; run()', 'utf8');
+  resetProbeCache();
+  log('kurulum tamam');
+  return { ok: true };
+}
+
+/* ---------- başlat / durdur / durum ---------- */
+
+function readPid() {
+  try {
+    const s = fs.readFileSync(pidPath(), 'utf8').trim();
+    return /^\d+$/.test(s) ? Number(s) : null;
+  } catch {
+    return null;
+  }
+}
+
+async function start({ installIfMissing = true, onLog } = {}) {
+  if (await isUp(DEFAULT_URL, { force: true })) return { ok: true, already: true, url: DEFAULT_URL };
+  if (!fs.existsSync(settingsPath()) || !fs.existsSync(runPyPath())) {
+    if (!installIfMissing) return { ok: false, error: 'kurulu değil — önce: beast searxng' };
+    await install({ onLog });
+  }
+  const tools = require('./tools');
+  const probe = await tools.ensurePython();
+  const child = spawn(probe.exe, [runPyPath()], {
+    detached: true,
+    stdio: 'ignore',
+    windowsHide: true,
+    env: { ...process.env, SEARXNG_SETTINGS_PATH: settingsPath(), PYTHONIOENCODING: 'utf-8' },
+  });
+  try { fs.writeFileSync(pidPath(), String(child.pid)); } catch {}
+  child.unref();
+  /* ayağa kalkmasını bekle (ilk açılış motor listesini derler — birkaç sn) */
+  for (let i = 0; i < 20; i++) {
+    await new Promise((r) => setTimeout(r, 1000));
+    if (await isUp(DEFAULT_URL, { force: true })) return { ok: true, url: DEFAULT_URL, pid: child.pid };
+  }
+  return { ok: false, error: 'searxng başlatılamadı (20 sn içinde yanıt yok)' };
+}
+
+function stop() {
+  const pid = readPid();
+  if (!pid) return { ok: true, note: 'çalışmıyor' };
+  try {
+    execSync(`taskkill /PID ${pid} /T /F`, { stdio: 'ignore' });
+  } catch {}
+  try { fs.unlinkSync(pidPath()); } catch {}
+  resetProbeCache();
+  return { ok: true, stopped: pid };
+}
+
+async function status() {
+  return {
+    up: await isUp(DEFAULT_URL, { force: true }),
+    url: DEFAULT_URL,
+    pid: readPid(),
+    installed: fs.existsSync(settingsPath()) && fs.existsSync(runPyPath()),
+  };
+}
+
+/* ---------- CLI (bin/beast-agent.js → beast searxng) ---------- */
+
+async function cli(argv) {
+  const sub = String(argv[0] || 'start').toLowerCase();
+  console.log('\u27F3 SearXNG (yerel arama motoru)');
+  if (sub === 'stop') {
+    const r = stop();
+    console.log(r.ok ? '\u2713 durduruldu' : '\u2717 durdurulamadı');
+    process.exit(r.ok ? 0 : 1);
+  }
+  if (sub === 'status') {
+    const s = await status();
+    console.log(`  kurulu : ${s.installed ? 'evet' : 'hayır'}`);
+    console.log(`  çalışıyor: ${s.up ? 'evet (' + s.url + ')' : 'hayır'}`);
+    process.exit(0);
+  }
+  /* start */
+  const r = await start({ installIfMissing: true, onLog: (m) => console.log('  \u2022 ' + m) });
+  if (r.ok) {
+    console.log(r.already ? '\u2713 SearXNG zaten çalışıyor — ' + r.url : '\u2713 SearXNG başlatıldı — ' + r.url);
+    console.log('\u2139 arama zincirinde kullanılmaya hazır (Ayarlar → Web Arama sırası)');
+    process.exit(0);
+  }
+  console.error('\u2717 ' + (r.error || 'başlatılamadı'));
+  process.exit(1);
+}
+
+module.exports = {
+  search,
+  isUp,
+  resetProbeCache,
+  install,
+  start,
+  stop,
+  status,
+  cli,
+  settingsPath,
+  DEFAULT_URL,
+};

package/src/agent/seeds/brainstorming/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: brainstorming
+description: Yaratıcı işe KOD YAZMADAN ÖNCE kullan — yeni özellik, yeni proje, bileşen, davranış değişikliği istendiğinde; niyeti, gereksinimleri ve tasarımı kullanıcıyla netleştirmeden implementasyona geçmek yasaktır.
+---
+
+# Brainstorming: Fikirden Tasarıma
+
+Fikirleri doğal diyalogla tam oluşmuş tasarımlara dönüştür.
+
+Akış: bağlamı anla → fikri netleştir → tasarımı sun → kullanıcı onayı.
+
+<ZOR KAPI>
+Kullanıcıya ne yapacağını söyleyip onayı almadan HİÇBİR implementasyon
+eylemi yok: kod yazma, proje scaffold'ı, dosya üretme. Bu kapı HER görev
+için geçerlidir; törenin boyutu göreve göre ölçeklenir ama ONAY KAPISI
+ölçeklenmez.
+</ZOR KAPI>
+
+## Üç Yol
+
+İlk sorudan önce isteği SINIFLANDIR ve sınıfı sesli söyle — "bu sınırlı
+kapsamlı görünüyor, spec dosyası yazmak yerine kısa tasarımı burada sunacağım"
+— kullanıcı override edebilsin:
+
+- **Spike** — fizibilite sorusu ("yapılabilir mi", "hızlı-çirkin olsun").
+  Çıktısı tuttuğun kod değil, bir CEVAPTIR. Soru ve deneme planını 2-3
+  cümleyle sun, onay al, en ucuz yolla araştır. Tasarım dosyası yok.
+  Bulgu → öneri olarak raporla; bir şey inşa ettiysen "atılabilir" etiketiyle.
+- **Sınırlı (Bounded)** — mevcut koda iyi tanımlı değişiklik: yeni flag,
+  küçük endpoint, tek dosyalık fix. "Sınırlı" için DEĞİŞTİRECEĞİN AKIŞIN
+  Bu projede zaten var olması şart. Önemli netleştirme sorularını sor,
+  KISA tasarımı SOHBETTE sun (birkaç cümle - paragraf) ve DUR. Kullanıcı
+  "evet" demeden implementasyon yok. Spec dosyası yok, plan dosyası yok.
+- **Mimari** — yeni projeler, yeni alt sistemler, bileşen ilişkilerini
+  değiştiren işler. Tam süreç: sorular → 2-3 yaklaşım → bölümlü tasarım →
+  yazılı spec → writing-plans skill'i.
+
+İki yol arasında tereddüt varsa AĞIRINI seç. Ortasında gizli karmaşıklık
+çıkarsa yol YÜKSELTİLİR (dur, söyle, büyüt); asla aşağı inmez.
+
+## Anti-Desen: "Onaya Gerek Yok Kadar Basit"
+
+Her yol onayla biter. Todo listesi, tek fonksiyon, config değişikliği —
+tasarım sohbette iki cümle olabilir ama SUN ve ONAY AL. "Basit" işler,
+incelenmemiş varsayımların en çok iş boşa çıkardığı yerdir. Basitlikle
+ölçeklenen şey artefaktır; onay asla değil.
+
+## Kırmızı Bayraklar
+
+| Düşünce | Gerçek |
+|---|---|
+| "Bu, tasarım gerektirmeyecek kadar basit" | Basitlik kısa tasarım demektir, tasarım yok demek değil. |
+| "Sınırlı der spec'i atlarım" | Etiket arayışı şüphenin ta kendisi — ağır yolu seç. |
+| "Tasarım bariz, onu okurken başlarım" | Kapı onaydır, tasarımın uzunluğu değil. Sun ve evet bekle. |
+| "Bu tür app'leri biliyorum, sınırlıdır" | Sınırlı olma projeyi ölçer, bilgini değil. Akış yoksa mimaridir. |
+| "Spike çalıştı, kodu tutayım" | Spike'ın çıktısı cevaptır. Kodu tutmak YENİ istektir — sınıflandır. |
+| "Büyüdü ama az kaldı, yeniden sınıflandırmaya gerek yok" | Gizli karmaşıklık yolu ortada yükseltir. Dur ve söyle. |
+
+## Kontrol Listesi
+
+**Spike:** bağlamı gör → soru+plan sun (2-3 cümle) → onay → en ucuz yolla araştır → öneri raporla.
+
+**Sınırlı:** bağlamı gör (dosyalar, dokümanlar, son commit'ler) → netleştirme
+soruları TEK TEK → kısa tasarımı sohbette sun (yaklaşım, dokunulan dosyalar,
+test stratejisi) → açık "evet" bekle (sunup hemen başlamak = kapıyı atlamak) →
+normal iş akışıyla uygula (TDD geçerli).
+
+**Mimari:**
+1. Bağlamı gör: mevcut yapıyı list_dir/grep/read_file ile incele, deseni takip et
+2. Netleştirme soruları — TEK SORU PER MESAJ; amaç/kısıt/başarı kriterini anla;
+   çoklu seçmeli soru tercih et
+3. Kapsam çok buysa parçala: bağımsız alt-projelere böl, sırayı belirle,
+   ilk alt-projeyle normal akışa gir
+4. 2-3 yaklaşım öner — artı/eksileriyle; önerini BAŞA koy ve nedenini söyle;
+   her yaklaşımda YAGNI: gereksiz özelliği çıkar
+5. Tasarımı bölümler halinde sun — mimari, bileşenler, veri akışı, hata
+   yönetimi, test stratejisi; her bölümün ardından "şimdiye kadar doğru mu?" de
+6. Onaylı tasarımı yaz: `<workspace>/docs/plans/specs/YYYY-MM-DD-<konu>-design.md`
+7. Spec öz-denetim: "TBD/TODO" var mı, iç tutarlılık, kapsam tek plana sığıyor mu,
+   iki şekilde yorumlanabilir gereksinim var mı → düzelt
+8. Kullanıcıya spec dosyasını göster, incelemesini iste
+9. Onay gelince writing-plans skill'iyle implementasyon planına geç — başka hiçbir
+   implementasyon adımı bu kapıdan önce gelmez
+
+## Mevcut Kodda Çalışırken
+
+- Değişiklik önermeden önce mevcut yapıyı incele; var olan deseni takip et
+- İşini etkileyen sorunlu noktalar varsa (şişmiş dosya, bulanık sınır) hedefli
+  iyileştirmeyi tasarıma dahil et
+- Alakasız refactoring önerme — mevcut hedefe hizmet eden kal

package/src/agent/seeds/dispatching-parallel-agents/SKILL.md

@@ -0,0 +1,120 @@
+---
+name: dispatching-parallel-agents
+description: Birbirinden bağımsız 2+ iş aynı anda yapılabilecekken kullan — farklı alt sistemlerdeki hatalar, farklı araştırmalar, farklı dosyalar; işler sıra gerektirmeden ve ortak durum paylaşmadan yürüyebiliyorsa.
+---
+
+# Paralel Ajan Devri
+
+## Genel Bakış
+
+İşleri, bağlamı İZOLE alt-ajanlara devredersin. Talimatlarını ve
+bağlamını hassas kurarak odaklarını ve başarısını garanti edersin. Onlar
+senin oturum bağlamını asla görmez — ihtiyaç duydukları her şeyi SEN
+inşa edersin. Bu, kendi bağlamını koordinasyon işine saklar.
+
+**Çekirdek ilke:** Bağımsız her problem alanı için bir ajan. Paralel koştur.
+
+## Ne Zaman
+
+**Kullan:**
+- Farklı kök nedenli 3+ test hatası
+- Birbirinden bağımsız kırılmış alt sistemler
+- Her sorun diğerinin bağlamı olmadan anlaşılabilir
+- Araştırmalar arasında ortak durum yok
+
+**Kullanma:**
+- Hatalar ilişkiliyse (biri düzelince diğerleri de düzelebilir) — birlikte incele
+- Tam sistem durumunu görmek gerekiyorsa
+- Ajanlar birbirine karışacaksa (aynı dosyaları düzenliyorlarsa)
+
+## Desen
+
+### 1. Bağımsız Alanları Belirle
+
+Sorunları neyin kırıldığına göre grupla:
+- test-a.test.js: onay akışı
+- test-b.test.js: batch tamamlama
+- test-c.test.js: iptal davranışı
+
+Her alan bağımsız — onay fix'i iptal testlerini etkilemez.
+
+### 2. Odaklı Ajan Görevleri Yaz
+
+Her ajana:
+- **Spesifik kapsam:** tek dosya/alt sistem
+- **Net hedef:** bu testler geçsin
+- **Kısıt:** başka koda dokunma
+- **Beklenen çıktı:** ne buldun + ne düzelttin özeti
+
+### 3. Paralel Devret
+
+Tüm devirleri AYNI cevapta ver — paralel koşarlar:
+
+```
+run_background: "tests/a.test.js'deki 3 hatayı düzelt ..."
+run_background: "tests/b.test.js'deki 2 hatayı düzelt ..."
+run_background: "tests/c.test.js hatasını düzelt ..."
+```
+
+Birden çok çağrı aynı turda = paralel. Tur başına bir çağrı = sıralı.
+Bağımsız adımlar için `run_background_many` TEK ÇAĞRIDA fan-out yapar ve
+bitince TEK birleşik rapor düşürür.
+
+### 4. İncele ve Entegre Et
+
+Ajanlar dönünce:
+- Her özeti oku
+- Fix'ler çakışıyor mu kontrol et (aynı kod düzenlenmiş mi?)
+- Tam test suite'ini çalıştır — hepsi birlikte çalışıyor mu doğrula
+- Ara sıra elle kontrol — ajanlar sistematik hata yapabilir
+
+## Ajan Görev Metni Yapısı
+
+İyi görev metinleri:
+1. **Odaklı** — tek net problem alanı
+2. **Kendine yeterli** — problemi anlamak için gereken TÜM bağlam
+   (dosya yolları, hata mesajları, test isimleri — ajan senin sohbetini göremez)
+3. **Çıktıya spesifik** — ajan ne döndürmeli?
+
+```markdown
+src/agents/abort.test.js'deki 3 hatayı düzelt:
+
+1. "partial output ile abort" — 'interrupted at' bekleniyor
+2. "mixed completed/aborted" — hızlı araç abort edilmedi
+3. "pendingToolCount" — 3 beklenirken 0
+
+Bunlar zamanlama/race sorunları. Görevin:
+1. Test dosyasını oku, her testin ne doğruladığını anla
+2. Kök nedeni bul — zamanlama mı, gerçek bug mı?
+3. Düzelt:
+   - Keyfi timeout'ları event-beklemeliyle değiştir
+   - Bulunan gerçek bug'ları düzelt
+   - Davranış değiştiyse test beklentisini güncelle
+
+SADECE timeout artırma — gerçek sorunu bul.
+
+Dönüş: ne bulduğun ve ne düzelttiğin özeti.
+```
+
+## Yaygın Hatalar
+
+**❌ Çok geniş:** "tüm testleri düzelt" — ajan kaybolur
+**✅ Spesifik:** "abort.test.js'yi düzelt" — odaklı kapsam
+
+**❌ Bağlamsız:** "race condition'ı düzelt" — ajan nerede bilmiyor
+**✅ Bağlamlı:** hata mesajlarını ve test isimlerini yapıştır
+
+**❌ Kısıtsız:** ajan her şeyi refactor edebilir
+**✅ Kısıtlı:** "sadece testleri düzelt, production koduna dokunma"
+
+**❌ Belirsiz çıktı:** "düzelt" — ne değiştiğini bilemezsin
+**✅ Spesifik:** "kök neden ve değişiklik özeti dön"
+
+## Doğrulama
+
+Ajanlar döndükten sonra:
+1. **Her özeti incele** — ne değiştiğini anla
+2. **Çakışma kontrolü** — ajanlar aynı kodu düzenledi mi?
+3. **Tam suite çalıştır** — tüm fix'ler birlikte çalışıyor mu
+4. **Rastgele kontrol** — ajan raporları iddiadır, kanıt değil
+   (verification-before-completion)

package/src/agent/seeds/executing-plans/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: executing-plans
+description: Yazılı bir implementasyon planı bu oturumda uygulanacakken kullan — paralel ajan devri yapılmadan, plan adımları elle yürütülecekse.
+---
+
+# Plan Yürütme
+
+## Genel Bakış
+
+Planı yükle, eleştirel incele, tüm görevleri uygula, bitince raporla.
+
+**Not:** CEO modu / paralel ajan mümkünse subagent-driven-development daha
+iyi sonuç verir — bu skill ajan devrinin olmadığı düz yürütme içindir.
+
+## Süreç
+
+### Adım 1: Planı Yükle ve İncele
+1. Plan dosyasını oku (ve varsa gösterdiği spec dosyasını)
+2. Eleştirel incele — plan hakkında soru/tereddüt var mı?
+3. Tereddüt varsa: BAŞLAMADAN kullanıcıya bildir
+4. Yoksa: todo_write ile plan görevlerini aç ve başla
+
+### Adım 2: Görevleri Uygula
+
+Her görev için:
+1. todo_write'ta in_progress yap
+2. Her adımı plan yazdığı gibi uygula (plan ısırık adımlar taşır — atlamak yok)
+3. Belirtilen doğrulamaları çalıştır (run_command — komut çıktısıyla)
+4. done yap, sıradakine geç
+
+### Adım 3: Bitiş
+
+Tüm görevler tamam ve doğrulandığında:
+- 1-3 satırlık özet rapor: ne yapıldı + doğrulama kanıtları (ör. "npm test ✓ 154/154")
+- verification-before-completion: "bitti" demeden önce taze kanıt şart
+
+## Ne Zaman Durup Sorulur
+
+Hemen dur:
+- Engel ile karşılaşırsan (eksik bağımlılık, test fail, belirsiz talimat)
+- Plan başlamayı engelleyen kritik boşluk içeriyorsa
+- Bir talimatı anlamıyorsan
+- Doğrulama tekrar tekrar fail ediyorsa
+
+**Tahmin etmek yerine sor.**
+
+## Ne Zaman Önceki Adıma Dönülür
+
+- Kullanıcı planı güncellerse → Adım 1'e dön
+- Temel yaklaşımın yeniden düşünülmesi gerekiyorsa → Adım 1'e dön
+
+Engellere zorla geçme — dur, sor.
+
+## Hatırla
+
+- Planı önce eleştirel incele
+- Plan adımlarını birebir takip et
+- Doğrulamaları atlama
+- Kendi başına plan değiştirme — plan hatalıysa kullanıcıya bildirip karar al
+- Hiçbir doğrulama "elle yaptım" ile geçmez