beast-agent 1.9.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +130 -130
  3. package/bin/beast-agent.js +137 -137
  4. package/package.json +1 -1
  5. package/scripts/fix-electron.js +138 -138
  6. package/scripts/release.js +137 -131
  7. package/scripts/swap-electron.js +40 -40
  8. package/src/agent/agentdefs.js +122 -122
  9. package/src/agent/bots.js +580 -580
  10. package/src/agent/bus.js +389 -389
  11. package/src/agent/computeruse.js +200 -200
  12. package/src/agent/config.js +284 -284
  13. package/src/agent/discord.js +332 -332
  14. package/src/agent/engine.js +75 -10
  15. package/src/agent/kb.js +123 -123
  16. package/src/agent/llm.js +430 -430
  17. package/src/agent/logger.js +90 -90
  18. package/src/agent/mcp.js +427 -427
  19. package/src/agent/mem0.js +605 -605
  20. package/src/agent/memory.js +427 -427
  21. package/src/agent/mqueue.js +124 -124
  22. package/src/agent/pdf.js +20 -20
  23. package/src/agent/research.js +133 -133
  24. package/src/agent/scripts/news.py +113 -113
  25. package/src/agent/scripts/stealthsearch.py +30 -30
  26. package/src/agent/scripts/websearch.py +225 -225
  27. package/src/agent/searxng.js +325 -325
  28. package/src/agent/seeds/brainstorming/SKILL.md +90 -90
  29. package/src/agent/seeds/dispatching-parallel-agents/SKILL.md +120 -120
  30. package/src/agent/seeds/executing-plans/SKILL.md +60 -60
  31. package/src/agent/seeds/subagent-driven-development/SKILL.md +167 -167
  32. package/src/agent/seeds/systematic-debugging/SKILL.md +131 -131
  33. package/src/agent/seeds/test-driven-development/SKILL.md +152 -152
  34. package/src/agent/seeds/verification-before-completion/SKILL.md +63 -63
  35. package/src/agent/seeds/writing-plans/SKILL.md +162 -162
  36. package/src/agent/seeds/writing-skills/SKILL.md +229 -229
  37. package/src/agent/skills.js +652 -652
  38. package/src/agent/store.js +378 -378
  39. package/src/agent/telegram.js +155 -155
  40. package/src/agent/tokens.js +39 -39
  41. package/src/agent/usage.js +125 -125
  42. package/src/agent/watchers.js +312 -312
  43. package/src/agent/watext.js +80 -80
  44. package/src/agent/whatsapp.js +555 -555
  45. package/src/cron.js +255 -255
  46. package/src/main.js +348 -6
  47. package/src/preload.js +9 -0
  48. package/src/renderer/browserPreload.js +73 -73
  49. package/src/renderer/i18n.js +4 -0
  50. package/src/renderer/index.html +448 -409
  51. package/src/renderer/renderer.js +824 -41
  52. package/src/renderer/style.css +264 -5
@@ -1,90 +1,90 @@
1
- ---
2
- name: brainstorming
3
- 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.
4
- ---
5
-
6
- # Brainstorming: Fikirden Tasarıma
7
-
8
- Fikirleri doğal diyalogla tam oluşmuş tasarımlara dönüştür.
9
-
10
- Akış: bağlamı anla → fikri netleştir → tasarımı sun → kullanıcı onayı.
11
-
12
- <ZOR KAPI>
13
- Kullanıcıya ne yapacağını söyleyip onayı almadan HİÇBİR implementasyon
14
- eylemi yok: kod yazma, proje scaffold'ı, dosya üretme. Bu kapı HER görev
15
- için geçerlidir; törenin boyutu göreve göre ölçeklenir ama ONAY KAPISI
16
- ölçeklenmez.
17
- </ZOR KAPI>
18
-
19
- ## Üç Yol
20
-
21
- İlk sorudan önce isteği SINIFLANDIR ve sınıfı sesli söyle — "bu sınırlı
22
- kapsamlı görünüyor, spec dosyası yazmak yerine kısa tasarımı burada sunacağım"
23
- — kullanıcı override edebilsin:
24
-
25
- - **Spike** — fizibilite sorusu ("yapılabilir mi", "hızlı-çirkin olsun").
26
- Çıktısı tuttuğun kod değil, bir CEVAPTIR. Soru ve deneme planını 2-3
27
- cümleyle sun, onay al, en ucuz yolla araştır. Tasarım dosyası yok.
28
- Bulgu → öneri olarak raporla; bir şey inşa ettiysen "atılabilir" etiketiyle.
29
- - **Sınırlı (Bounded)** — mevcut koda iyi tanımlı değişiklik: yeni flag,
30
- küçük endpoint, tek dosyalık fix. "Sınırlı" için DEĞİŞTİRECEĞİN AKIŞIN
31
- Bu projede zaten var olması şart. Önemli netleştirme sorularını sor,
32
- KISA tasarımı SOHBETTE sun (birkaç cümle - paragraf) ve DUR. Kullanıcı
33
- "evet" demeden implementasyon yok. Spec dosyası yok, plan dosyası yok.
34
- - **Mimari** — yeni projeler, yeni alt sistemler, bileşen ilişkilerini
35
- değiştiren işler. Tam süreç: sorular → 2-3 yaklaşım → bölümlü tasarım →
36
- yazılı spec → writing-plans skill'i.
37
-
38
- İki yol arasında tereddüt varsa AĞIRINI seç. Ortasında gizli karmaşıklık
39
- çıkarsa yol YÜKSELTİLİR (dur, söyle, büyüt); asla aşağı inmez.
40
-
41
- ## Anti-Desen: "Onaya Gerek Yok Kadar Basit"
42
-
43
- Her yol onayla biter. Todo listesi, tek fonksiyon, config değişikliği —
44
- tasarım sohbette iki cümle olabilir ama SUN ve ONAY AL. "Basit" işler,
45
- incelenmemiş varsayımların en çok iş boşa çıkardığı yerdir. Basitlikle
46
- ölçeklenen şey artefaktır; onay asla değil.
47
-
48
- ## Kırmızı Bayraklar
49
-
50
- | Düşünce | Gerçek |
51
- |---|---|
52
- | "Bu, tasarım gerektirmeyecek kadar basit" | Basitlik kısa tasarım demektir, tasarım yok demek değil. |
53
- | "Sınırlı der spec'i atlarım" | Etiket arayışı şüphenin ta kendisi — ağır yolu seç. |
54
- | "Tasarım bariz, onu okurken başlarım" | Kapı onaydır, tasarımın uzunluğu değil. Sun ve evet bekle. |
55
- | "Bu tür app'leri biliyorum, sınırlıdır" | Sınırlı olma projeyi ölçer, bilgini değil. Akış yoksa mimaridir. |
56
- | "Spike çalıştı, kodu tutayım" | Spike'ın çıktısı cevaptır. Kodu tutmak YENİ istektir — sınıflandır. |
57
- | "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. |
58
-
59
- ## Kontrol Listesi
60
-
61
- **Spike:** bağlamı gör → soru+plan sun (2-3 cümle) → onay → en ucuz yolla araştır → öneri raporla.
62
-
63
- **Sınırlı:** bağlamı gör (dosyalar, dokümanlar, son commit'ler) → netleştirme
64
- soruları TEK TEK → kısa tasarımı sohbette sun (yaklaşım, dokunulan dosyalar,
65
- test stratejisi) → açık "evet" bekle (sunup hemen başlamak = kapıyı atlamak) →
66
- normal iş akışıyla uygula (TDD geçerli).
67
-
68
- **Mimari:**
69
- 1. Bağlamı gör: mevcut yapıyı list_dir/grep/read_file ile incele, deseni takip et
70
- 2. Netleştirme soruları — TEK SORU PER MESAJ; amaç/kısıt/başarı kriterini anla;
71
- çoklu seçmeli soru tercih et
72
- 3. Kapsam çok buysa parçala: bağımsız alt-projelere böl, sırayı belirle,
73
- ilk alt-projeyle normal akışa gir
74
- 4. 2-3 yaklaşım öner — artı/eksileriyle; önerini BAŞA koy ve nedenini söyle;
75
- her yaklaşımda YAGNI: gereksiz özelliği çıkar
76
- 5. Tasarımı bölümler halinde sun — mimari, bileşenler, veri akışı, hata
77
- yönetimi, test stratejisi; her bölümün ardından "şimdiye kadar doğru mu?" de
78
- 6. Onaylı tasarımı yaz: `<workspace>/docs/plans/specs/YYYY-MM-DD-<konu>-design.md`
79
- 7. Spec öz-denetim: "TBD/TODO" var mı, iç tutarlılık, kapsam tek plana sığıyor mu,
80
- iki şekilde yorumlanabilir gereksinim var mı → düzelt
81
- 8. Kullanıcıya spec dosyasını göster, incelemesini iste
82
- 9. Onay gelince writing-plans skill'iyle implementasyon planına geç — başka hiçbir
83
- implementasyon adımı bu kapıdan önce gelmez
84
-
85
- ## Mevcut Kodda Çalışırken
86
-
87
- - Değişiklik önermeden önce mevcut yapıyı incele; var olan deseni takip et
88
- - İşini etkileyen sorunlu noktalar varsa (şişmiş dosya, bulanık sınır) hedefli
89
- iyileştirmeyi tasarıma dahil et
90
- - Alakasız refactoring önerme — mevcut hedefe hizmet eden kal
1
+ ---
2
+ name: brainstorming
3
+ 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.
4
+ ---
5
+
6
+ # Brainstorming: Fikirden Tasarıma
7
+
8
+ Fikirleri doğal diyalogla tam oluşmuş tasarımlara dönüştür.
9
+
10
+ Akış: bağlamı anla → fikri netleştir → tasarımı sun → kullanıcı onayı.
11
+
12
+ <ZOR KAPI>
13
+ Kullanıcıya ne yapacağını söyleyip onayı almadan HİÇBİR implementasyon
14
+ eylemi yok: kod yazma, proje scaffold'ı, dosya üretme. Bu kapı HER görev
15
+ için geçerlidir; törenin boyutu göreve göre ölçeklenir ama ONAY KAPISI
16
+ ölçeklenmez.
17
+ </ZOR KAPI>
18
+
19
+ ## Üç Yol
20
+
21
+ İlk sorudan önce isteği SINIFLANDIR ve sınıfı sesli söyle — "bu sınırlı
22
+ kapsamlı görünüyor, spec dosyası yazmak yerine kısa tasarımı burada sunacağım"
23
+ — kullanıcı override edebilsin:
24
+
25
+ - **Spike** — fizibilite sorusu ("yapılabilir mi", "hızlı-çirkin olsun").
26
+ Çıktısı tuttuğun kod değil, bir CEVAPTIR. Soru ve deneme planını 2-3
27
+ cümleyle sun, onay al, en ucuz yolla araştır. Tasarım dosyası yok.
28
+ Bulgu → öneri olarak raporla; bir şey inşa ettiysen "atılabilir" etiketiyle.
29
+ - **Sınırlı (Bounded)** — mevcut koda iyi tanımlı değişiklik: yeni flag,
30
+ küçük endpoint, tek dosyalık fix. "Sınırlı" için DEĞİŞTİRECEĞİN AKIŞIN
31
+ Bu projede zaten var olması şart. Önemli netleştirme sorularını sor,
32
+ KISA tasarımı SOHBETTE sun (birkaç cümle - paragraf) ve DUR. Kullanıcı
33
+ "evet" demeden implementasyon yok. Spec dosyası yok, plan dosyası yok.
34
+ - **Mimari** — yeni projeler, yeni alt sistemler, bileşen ilişkilerini
35
+ değiştiren işler. Tam süreç: sorular → 2-3 yaklaşım → bölümlü tasarım →
36
+ yazılı spec → writing-plans skill'i.
37
+
38
+ İki yol arasında tereddüt varsa AĞIRINI seç. Ortasında gizli karmaşıklık
39
+ çıkarsa yol YÜKSELTİLİR (dur, söyle, büyüt); asla aşağı inmez.
40
+
41
+ ## Anti-Desen: "Onaya Gerek Yok Kadar Basit"
42
+
43
+ Her yol onayla biter. Todo listesi, tek fonksiyon, config değişikliği —
44
+ tasarım sohbette iki cümle olabilir ama SUN ve ONAY AL. "Basit" işler,
45
+ incelenmemiş varsayımların en çok iş boşa çıkardığı yerdir. Basitlikle
46
+ ölçeklenen şey artefaktır; onay asla değil.
47
+
48
+ ## Kırmızı Bayraklar
49
+
50
+ | Düşünce | Gerçek |
51
+ |---|---|
52
+ | "Bu, tasarım gerektirmeyecek kadar basit" | Basitlik kısa tasarım demektir, tasarım yok demek değil. |
53
+ | "Sınırlı der spec'i atlarım" | Etiket arayışı şüphenin ta kendisi — ağır yolu seç. |
54
+ | "Tasarım bariz, onu okurken başlarım" | Kapı onaydır, tasarımın uzunluğu değil. Sun ve evet bekle. |
55
+ | "Bu tür app'leri biliyorum, sınırlıdır" | Sınırlı olma projeyi ölçer, bilgini değil. Akış yoksa mimaridir. |
56
+ | "Spike çalıştı, kodu tutayım" | Spike'ın çıktısı cevaptır. Kodu tutmak YENİ istektir — sınıflandır. |
57
+ | "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. |
58
+
59
+ ## Kontrol Listesi
60
+
61
+ **Spike:** bağlamı gör → soru+plan sun (2-3 cümle) → onay → en ucuz yolla araştır → öneri raporla.
62
+
63
+ **Sınırlı:** bağlamı gör (dosyalar, dokümanlar, son commit'ler) → netleştirme
64
+ soruları TEK TEK → kısa tasarımı sohbette sun (yaklaşım, dokunulan dosyalar,
65
+ test stratejisi) → açık "evet" bekle (sunup hemen başlamak = kapıyı atlamak) →
66
+ normal iş akışıyla uygula (TDD geçerli).
67
+
68
+ **Mimari:**
69
+ 1. Bağlamı gör: mevcut yapıyı list_dir/grep/read_file ile incele, deseni takip et
70
+ 2. Netleştirme soruları — TEK SORU PER MESAJ; amaç/kısıt/başarı kriterini anla;
71
+ çoklu seçmeli soru tercih et
72
+ 3. Kapsam çok buysa parçala: bağımsız alt-projelere böl, sırayı belirle,
73
+ ilk alt-projeyle normal akışa gir
74
+ 4. 2-3 yaklaşım öner — artı/eksileriyle; önerini BAŞA koy ve nedenini söyle;
75
+ her yaklaşımda YAGNI: gereksiz özelliği çıkar
76
+ 5. Tasarımı bölümler halinde sun — mimari, bileşenler, veri akışı, hata
77
+ yönetimi, test stratejisi; her bölümün ardından "şimdiye kadar doğru mu?" de
78
+ 6. Onaylı tasarımı yaz: `<workspace>/docs/plans/specs/YYYY-MM-DD-<konu>-design.md`
79
+ 7. Spec öz-denetim: "TBD/TODO" var mı, iç tutarlılık, kapsam tek plana sığıyor mu,
80
+ iki şekilde yorumlanabilir gereksinim var mı → düzelt
81
+ 8. Kullanıcıya spec dosyasını göster, incelemesini iste
82
+ 9. Onay gelince writing-plans skill'iyle implementasyon planına geç — başka hiçbir
83
+ implementasyon adımı bu kapıdan önce gelmez
84
+
85
+ ## Mevcut Kodda Çalışırken
86
+
87
+ - Değişiklik önermeden önce mevcut yapıyı incele; var olan deseni takip et
88
+ - İşini etkileyen sorunlu noktalar varsa (şişmiş dosya, bulanık sınır) hedefli
89
+ iyileştirmeyi tasarıma dahil et
90
+ - Alakasız refactoring önerme — mevcut hedefe hizmet eden kal
@@ -1,120 +1,120 @@
1
- ---
2
- name: dispatching-parallel-agents
3
- 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.
4
- ---
5
-
6
- # Paralel Ajan Devri
7
-
8
- ## Genel Bakış
9
-
10
- İşleri, bağlamı İZOLE alt-ajanlara devredersin. Talimatlarını ve
11
- bağlamını hassas kurarak odaklarını ve başarısını garanti edersin. Onlar
12
- senin oturum bağlamını asla görmez — ihtiyaç duydukları her şeyi SEN
13
- inşa edersin. Bu, kendi bağlamını koordinasyon işine saklar.
14
-
15
- **Çekirdek ilke:** Bağımsız her problem alanı için bir ajan. Paralel koştur.
16
-
17
- ## Ne Zaman
18
-
19
- **Kullan:**
20
- - Farklı kök nedenli 3+ test hatası
21
- - Birbirinden bağımsız kırılmış alt sistemler
22
- - Her sorun diğerinin bağlamı olmadan anlaşılabilir
23
- - Araştırmalar arasında ortak durum yok
24
-
25
- **Kullanma:**
26
- - Hatalar ilişkiliyse (biri düzelince diğerleri de düzelebilir) — birlikte incele
27
- - Tam sistem durumunu görmek gerekiyorsa
28
- - Ajanlar birbirine karışacaksa (aynı dosyaları düzenliyorlarsa)
29
-
30
- ## Desen
31
-
32
- ### 1. Bağımsız Alanları Belirle
33
-
34
- Sorunları neyin kırıldığına göre grupla:
35
- - test-a.test.js: onay akışı
36
- - test-b.test.js: batch tamamlama
37
- - test-c.test.js: iptal davranışı
38
-
39
- Her alan bağımsız — onay fix'i iptal testlerini etkilemez.
40
-
41
- ### 2. Odaklı Ajan Görevleri Yaz
42
-
43
- Her ajana:
44
- - **Spesifik kapsam:** tek dosya/alt sistem
45
- - **Net hedef:** bu testler geçsin
46
- - **Kısıt:** başka koda dokunma
47
- - **Beklenen çıktı:** ne buldun + ne düzelttin özeti
48
-
49
- ### 3. Paralel Devret
50
-
51
- Tüm devirleri AYNI cevapta ver — paralel koşarlar:
52
-
53
- ```
54
- run_background: "tests/a.test.js'deki 3 hatayı düzelt ..."
55
- run_background: "tests/b.test.js'deki 2 hatayı düzelt ..."
56
- run_background: "tests/c.test.js hatasını düzelt ..."
57
- ```
58
-
59
- Birden çok çağrı aynı turda = paralel. Tur başına bir çağrı = sıralı.
60
- Bağımsız adımlar için `run_background_many` TEK ÇAĞRIDA fan-out yapar ve
61
- bitince TEK birleşik rapor düşürür.
62
-
63
- ### 4. İncele ve Entegre Et
64
-
65
- Ajanlar dönünce:
66
- - Her özeti oku
67
- - Fix'ler çakışıyor mu kontrol et (aynı kod düzenlenmiş mi?)
68
- - Tam test suite'ini çalıştır — hepsi birlikte çalışıyor mu doğrula
69
- - Ara sıra elle kontrol — ajanlar sistematik hata yapabilir
70
-
71
- ## Ajan Görev Metni Yapısı
72
-
73
- İyi görev metinleri:
74
- 1. **Odaklı** — tek net problem alanı
75
- 2. **Kendine yeterli** — problemi anlamak için gereken TÜM bağlam
76
- (dosya yolları, hata mesajları, test isimleri — ajan senin sohbetini göremez)
77
- 3. **Çıktıya spesifik** — ajan ne döndürmeli?
78
-
79
- ```markdown
80
- src/agents/abort.test.js'deki 3 hatayı düzelt:
81
-
82
- 1. "partial output ile abort" — 'interrupted at' bekleniyor
83
- 2. "mixed completed/aborted" — hızlı araç abort edilmedi
84
- 3. "pendingToolCount" — 3 beklenirken 0
85
-
86
- Bunlar zamanlama/race sorunları. Görevin:
87
- 1. Test dosyasını oku, her testin ne doğruladığını anla
88
- 2. Kök nedeni bul — zamanlama mı, gerçek bug mı?
89
- 3. Düzelt:
90
- - Keyfi timeout'ları event-beklemeliyle değiştir
91
- - Bulunan gerçek bug'ları düzelt
92
- - Davranış değiştiyse test beklentisini güncelle
93
-
94
- SADECE timeout artırma — gerçek sorunu bul.
95
-
96
- Dönüş: ne bulduğun ve ne düzelttiğin özeti.
97
- ```
98
-
99
- ## Yaygın Hatalar
100
-
101
- **❌ Çok geniş:** "tüm testleri düzelt" — ajan kaybolur
102
- **✅ Spesifik:** "abort.test.js'yi düzelt" — odaklı kapsam
103
-
104
- **❌ Bağlamsız:** "race condition'ı düzelt" — ajan nerede bilmiyor
105
- **✅ Bağlamlı:** hata mesajlarını ve test isimlerini yapıştır
106
-
107
- **❌ Kısıtsız:** ajan her şeyi refactor edebilir
108
- **✅ Kısıtlı:** "sadece testleri düzelt, production koduna dokunma"
109
-
110
- **❌ Belirsiz çıktı:** "düzelt" — ne değiştiğini bilemezsin
111
- **✅ Spesifik:** "kök neden ve değişiklik özeti dön"
112
-
113
- ## Doğrulama
114
-
115
- Ajanlar döndükten sonra:
116
- 1. **Her özeti incele** — ne değiştiğini anla
117
- 2. **Çakışma kontrolü** — ajanlar aynı kodu düzenledi mi?
118
- 3. **Tam suite çalıştır** — tüm fix'ler birlikte çalışıyor mu
119
- 4. **Rastgele kontrol** — ajan raporları iddiadır, kanıt değil
120
- (verification-before-completion)
1
+ ---
2
+ name: dispatching-parallel-agents
3
+ 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.
4
+ ---
5
+
6
+ # Paralel Ajan Devri
7
+
8
+ ## Genel Bakış
9
+
10
+ İşleri, bağlamı İZOLE alt-ajanlara devredersin. Talimatlarını ve
11
+ bağlamını hassas kurarak odaklarını ve başarısını garanti edersin. Onlar
12
+ senin oturum bağlamını asla görmez — ihtiyaç duydukları her şeyi SEN
13
+ inşa edersin. Bu, kendi bağlamını koordinasyon işine saklar.
14
+
15
+ **Çekirdek ilke:** Bağımsız her problem alanı için bir ajan. Paralel koştur.
16
+
17
+ ## Ne Zaman
18
+
19
+ **Kullan:**
20
+ - Farklı kök nedenli 3+ test hatası
21
+ - Birbirinden bağımsız kırılmış alt sistemler
22
+ - Her sorun diğerinin bağlamı olmadan anlaşılabilir
23
+ - Araştırmalar arasında ortak durum yok
24
+
25
+ **Kullanma:**
26
+ - Hatalar ilişkiliyse (biri düzelince diğerleri de düzelebilir) — birlikte incele
27
+ - Tam sistem durumunu görmek gerekiyorsa
28
+ - Ajanlar birbirine karışacaksa (aynı dosyaları düzenliyorlarsa)
29
+
30
+ ## Desen
31
+
32
+ ### 1. Bağımsız Alanları Belirle
33
+
34
+ Sorunları neyin kırıldığına göre grupla:
35
+ - test-a.test.js: onay akışı
36
+ - test-b.test.js: batch tamamlama
37
+ - test-c.test.js: iptal davranışı
38
+
39
+ Her alan bağımsız — onay fix'i iptal testlerini etkilemez.
40
+
41
+ ### 2. Odaklı Ajan Görevleri Yaz
42
+
43
+ Her ajana:
44
+ - **Spesifik kapsam:** tek dosya/alt sistem
45
+ - **Net hedef:** bu testler geçsin
46
+ - **Kısıt:** başka koda dokunma
47
+ - **Beklenen çıktı:** ne buldun + ne düzelttin özeti
48
+
49
+ ### 3. Paralel Devret
50
+
51
+ Tüm devirleri AYNI cevapta ver — paralel koşarlar:
52
+
53
+ ```
54
+ run_background: "tests/a.test.js'deki 3 hatayı düzelt ..."
55
+ run_background: "tests/b.test.js'deki 2 hatayı düzelt ..."
56
+ run_background: "tests/c.test.js hatasını düzelt ..."
57
+ ```
58
+
59
+ Birden çok çağrı aynı turda = paralel. Tur başına bir çağrı = sıralı.
60
+ Bağımsız adımlar için `run_background_many` TEK ÇAĞRIDA fan-out yapar ve
61
+ bitince TEK birleşik rapor düşürür.
62
+
63
+ ### 4. İncele ve Entegre Et
64
+
65
+ Ajanlar dönünce:
66
+ - Her özeti oku
67
+ - Fix'ler çakışıyor mu kontrol et (aynı kod düzenlenmiş mi?)
68
+ - Tam test suite'ini çalıştır — hepsi birlikte çalışıyor mu doğrula
69
+ - Ara sıra elle kontrol — ajanlar sistematik hata yapabilir
70
+
71
+ ## Ajan Görev Metni Yapısı
72
+
73
+ İyi görev metinleri:
74
+ 1. **Odaklı** — tek net problem alanı
75
+ 2. **Kendine yeterli** — problemi anlamak için gereken TÜM bağlam
76
+ (dosya yolları, hata mesajları, test isimleri — ajan senin sohbetini göremez)
77
+ 3. **Çıktıya spesifik** — ajan ne döndürmeli?
78
+
79
+ ```markdown
80
+ src/agents/abort.test.js'deki 3 hatayı düzelt:
81
+
82
+ 1. "partial output ile abort" — 'interrupted at' bekleniyor
83
+ 2. "mixed completed/aborted" — hızlı araç abort edilmedi
84
+ 3. "pendingToolCount" — 3 beklenirken 0
85
+
86
+ Bunlar zamanlama/race sorunları. Görevin:
87
+ 1. Test dosyasını oku, her testin ne doğruladığını anla
88
+ 2. Kök nedeni bul — zamanlama mı, gerçek bug mı?
89
+ 3. Düzelt:
90
+ - Keyfi timeout'ları event-beklemeliyle değiştir
91
+ - Bulunan gerçek bug'ları düzelt
92
+ - Davranış değiştiyse test beklentisini güncelle
93
+
94
+ SADECE timeout artırma — gerçek sorunu bul.
95
+
96
+ Dönüş: ne bulduğun ve ne düzelttiğin özeti.
97
+ ```
98
+
99
+ ## Yaygın Hatalar
100
+
101
+ **❌ Çok geniş:** "tüm testleri düzelt" — ajan kaybolur
102
+ **✅ Spesifik:** "abort.test.js'yi düzelt" — odaklı kapsam
103
+
104
+ **❌ Bağlamsız:** "race condition'ı düzelt" — ajan nerede bilmiyor
105
+ **✅ Bağlamlı:** hata mesajlarını ve test isimlerini yapıştır
106
+
107
+ **❌ Kısıtsız:** ajan her şeyi refactor edebilir
108
+ **✅ Kısıtlı:** "sadece testleri düzelt, production koduna dokunma"
109
+
110
+ **❌ Belirsiz çıktı:** "düzelt" — ne değiştiğini bilemezsin
111
+ **✅ Spesifik:** "kök neden ve değişiklik özeti dön"
112
+
113
+ ## Doğrulama
114
+
115
+ Ajanlar döndükten sonra:
116
+ 1. **Her özeti incele** — ne değiştiğini anla
117
+ 2. **Çakışma kontrolü** — ajanlar aynı kodu düzenledi mi?
118
+ 3. **Tam suite çalıştır** — tüm fix'ler birlikte çalışıyor mu
119
+ 4. **Rastgele kontrol** — ajan raporları iddiadır, kanıt değil
120
+ (verification-before-completion)
@@ -1,60 +1,60 @@
1
- ---
2
- name: executing-plans
3
- description: Yazılı bir implementasyon planı bu oturumda uygulanacakken kullan — paralel ajan devri yapılmadan, plan adımları elle yürütülecekse.
4
- ---
5
-
6
- # Plan Yürütme
7
-
8
- ## Genel Bakış
9
-
10
- Planı yükle, eleştirel incele, tüm görevleri uygula, bitince raporla.
11
-
12
- **Not:** CEO modu / paralel ajan mümkünse subagent-driven-development daha
13
- iyi sonuç verir — bu skill ajan devrinin olmadığı düz yürütme içindir.
14
-
15
- ## Süreç
16
-
17
- ### Adım 1: Planı Yükle ve İncele
18
- 1. Plan dosyasını oku (ve varsa gösterdiği spec dosyasını)
19
- 2. Eleştirel incele — plan hakkında soru/tereddüt var mı?
20
- 3. Tereddüt varsa: BAŞLAMADAN kullanıcıya bildir
21
- 4. Yoksa: todo_write ile plan görevlerini aç ve başla
22
-
23
- ### Adım 2: Görevleri Uygula
24
-
25
- Her görev için:
26
- 1. todo_write'ta in_progress yap
27
- 2. Her adımı plan yazdığı gibi uygula (plan ısırık adımlar taşır — atlamak yok)
28
- 3. Belirtilen doğrulamaları çalıştır (run_command — komut çıktısıyla)
29
- 4. done yap, sıradakine geç
30
-
31
- ### Adım 3: Bitiş
32
-
33
- Tüm görevler tamam ve doğrulandığında:
34
- - 1-3 satırlık özet rapor: ne yapıldı + doğrulama kanıtları (ör. "npm test ✓ 154/154")
35
- - verification-before-completion: "bitti" demeden önce taze kanıt şart
36
-
37
- ## Ne Zaman Durup Sorulur
38
-
39
- Hemen dur:
40
- - Engel ile karşılaşırsan (eksik bağımlılık, test fail, belirsiz talimat)
41
- - Plan başlamayı engelleyen kritik boşluk içeriyorsa
42
- - Bir talimatı anlamıyorsan
43
- - Doğrulama tekrar tekrar fail ediyorsa
44
-
45
- **Tahmin etmek yerine sor.**
46
-
47
- ## Ne Zaman Önceki Adıma Dönülür
48
-
49
- - Kullanıcı planı güncellerse → Adım 1'e dön
50
- - Temel yaklaşımın yeniden düşünülmesi gerekiyorsa → Adım 1'e dön
51
-
52
- Engellere zorla geçme — dur, sor.
53
-
54
- ## Hatırla
55
-
56
- - Planı önce eleştirel incele
57
- - Plan adımlarını birebir takip et
58
- - Doğrulamaları atlama
59
- - Kendi başına plan değiştirme — plan hatalıysa kullanıcıya bildirip karar al
60
- - Hiçbir doğrulama "elle yaptım" ile geçmez
1
+ ---
2
+ name: executing-plans
3
+ description: Yazılı bir implementasyon planı bu oturumda uygulanacakken kullan — paralel ajan devri yapılmadan, plan adımları elle yürütülecekse.
4
+ ---
5
+
6
+ # Plan Yürütme
7
+
8
+ ## Genel Bakış
9
+
10
+ Planı yükle, eleştirel incele, tüm görevleri uygula, bitince raporla.
11
+
12
+ **Not:** CEO modu / paralel ajan mümkünse subagent-driven-development daha
13
+ iyi sonuç verir — bu skill ajan devrinin olmadığı düz yürütme içindir.
14
+
15
+ ## Süreç
16
+
17
+ ### Adım 1: Planı Yükle ve İncele
18
+ 1. Plan dosyasını oku (ve varsa gösterdiği spec dosyasını)
19
+ 2. Eleştirel incele — plan hakkında soru/tereddüt var mı?
20
+ 3. Tereddüt varsa: BAŞLAMADAN kullanıcıya bildir
21
+ 4. Yoksa: todo_write ile plan görevlerini aç ve başla
22
+
23
+ ### Adım 2: Görevleri Uygula
24
+
25
+ Her görev için:
26
+ 1. todo_write'ta in_progress yap
27
+ 2. Her adımı plan yazdığı gibi uygula (plan ısırık adımlar taşır — atlamak yok)
28
+ 3. Belirtilen doğrulamaları çalıştır (run_command — komut çıktısıyla)
29
+ 4. done yap, sıradakine geç
30
+
31
+ ### Adım 3: Bitiş
32
+
33
+ Tüm görevler tamam ve doğrulandığında:
34
+ - 1-3 satırlık özet rapor: ne yapıldı + doğrulama kanıtları (ör. "npm test ✓ 154/154")
35
+ - verification-before-completion: "bitti" demeden önce taze kanıt şart
36
+
37
+ ## Ne Zaman Durup Sorulur
38
+
39
+ Hemen dur:
40
+ - Engel ile karşılaşırsan (eksik bağımlılık, test fail, belirsiz talimat)
41
+ - Plan başlamayı engelleyen kritik boşluk içeriyorsa
42
+ - Bir talimatı anlamıyorsan
43
+ - Doğrulama tekrar tekrar fail ediyorsa
44
+
45
+ **Tahmin etmek yerine sor.**
46
+
47
+ ## Ne Zaman Önceki Adıma Dönülür
48
+
49
+ - Kullanıcı planı güncellerse → Adım 1'e dön
50
+ - Temel yaklaşımın yeniden düşünülmesi gerekiyorsa → Adım 1'e dön
51
+
52
+ Engellere zorla geçme — dur, sor.
53
+
54
+ ## Hatırla
55
+
56
+ - Planı önce eleştirel incele
57
+ - Plan adımlarını birebir takip et
58
+ - Doğrulamaları atlama
59
+ - Kendi başına plan değiştirme — plan hatalıysa kullanıcıya bildirip karar al
60
+ - Hiçbir doğrulama "elle yaptım" ile geçmez