opencode-multiagent 0.3.0-next.1 → 0.5.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 (96) hide show
  1. package/AGENTS.md +21 -0
  2. package/CHANGELOG.md +25 -0
  3. package/README.md +4 -4
  4. package/README.tr.md +4 -4
  5. package/agents/AGENTS.md +95 -0
  6. package/agents/auditor.md +59 -17
  7. package/agents/brainstormer.md +113 -0
  8. package/agents/{worker.md → coder.md} +12 -10
  9. package/agents/{scribe.md → docmaster.md} +16 -8
  10. package/agents/executor.md +45 -62
  11. package/agents/planner.md +59 -47
  12. package/agents/reviewer.md +22 -9
  13. package/agents/scout.md +16 -12
  14. package/agents/sec-coder.md +83 -0
  15. package/agents/ui-coder.md +77 -0
  16. package/commands/board.md +17 -0
  17. package/commands/brainstorm-conclude.md +14 -0
  18. package/commands/brainstorm.md +14 -0
  19. package/commands/execute.md +8 -7
  20. package/commands/init-deep.md +6 -6
  21. package/commands/init.md +4 -5
  22. package/commands/inspect.md +5 -5
  23. package/commands/plan.md +7 -6
  24. package/commands/quality.md +3 -3
  25. package/commands/review.md +4 -3
  26. package/commands/status.md +4 -3
  27. package/defaults/AGENTS.md +48 -0
  28. package/defaults/opencode-multiagent.json +16 -150
  29. package/defaults/opencode-multiagent.schema.json +16 -190
  30. package/dist/index.js +471 -218
  31. package/dist/opencode-multiagent/compiler.d.ts +8 -2
  32. package/dist/opencode-multiagent/compiler.d.ts.map +1 -1
  33. package/dist/opencode-multiagent/constants.d.ts +3 -57
  34. package/dist/opencode-multiagent/constants.d.ts.map +1 -1
  35. package/dist/opencode-multiagent/correlation.d.ts +21 -0
  36. package/dist/opencode-multiagent/correlation.d.ts.map +1 -0
  37. package/dist/opencode-multiagent/defaults.d.ts +0 -2
  38. package/dist/opencode-multiagent/defaults.d.ts.map +1 -1
  39. package/dist/opencode-multiagent/hooks.d.ts.map +1 -1
  40. package/dist/opencode-multiagent/log.d.ts.map +1 -1
  41. package/dist/opencode-multiagent/markdown.d.ts.map +1 -1
  42. package/dist/opencode-multiagent/quality.d.ts +4 -0
  43. package/dist/opencode-multiagent/quality.d.ts.map +1 -1
  44. package/dist/opencode-multiagent/runtime.d.ts.map +1 -1
  45. package/dist/opencode-multiagent/supervision.d.ts +14 -0
  46. package/dist/opencode-multiagent/supervision.d.ts.map +1 -1
  47. package/dist/opencode-multiagent/task-manager.d.ts +8 -2
  48. package/dist/opencode-multiagent/task-manager.d.ts.map +1 -1
  49. package/dist/opencode-multiagent/telemetry.d.ts +2 -0
  50. package/dist/opencode-multiagent/telemetry.d.ts.map +1 -1
  51. package/dist/opencode-multiagent/tools.d.ts +32 -1
  52. package/dist/opencode-multiagent/tools.d.ts.map +1 -1
  53. package/docs/agents.md +77 -175
  54. package/docs/agents.tr.md +78 -175
  55. package/docs/configuration.md +17 -27
  56. package/docs/configuration.tr.md +17 -27
  57. package/docs/usage-guide.md +35 -34
  58. package/docs/usage-guide.tr.md +36 -35
  59. package/examples/opencode.with-overrides.json +2 -2
  60. package/package.json +1 -1
  61. package/skills/AGENTS.md +51 -0
  62. package/skills/advanced-evaluation/manifest.json +1 -1
  63. package/skills/cek-context-engineering/manifest.json +1 -1
  64. package/skills/cek-prompt-engineering/manifest.json +1 -1
  65. package/skills/cek-test-prompt/manifest.json +1 -1
  66. package/skills/cek-thought-based-reasoning/manifest.json +1 -1
  67. package/skills/context-degradation/manifest.json +1 -1
  68. package/skills/debate/manifest.json +1 -1
  69. package/skills/design-first/manifest.json +1 -1
  70. package/skills/dispatching-parallel-agents/manifest.json +1 -1
  71. package/skills/drift-analysis/manifest.json +1 -1
  72. package/skills/evaluation/manifest.json +1 -1
  73. package/skills/parallel-investigation/manifest.json +1 -1
  74. package/skills/reflexion-critique/manifest.json +1 -1
  75. package/skills/reflexion-reflect/manifest.json +1 -1
  76. package/skills/root-cause-analysis/manifest.json +1 -1
  77. package/skills/sadd-judge-with-debate/manifest.json +1 -1
  78. package/skills/structured-code-review/manifest.json +1 -1
  79. package/skills/task-decomposition/manifest.json +1 -1
  80. package/skills/verification-before-completion/manifest.json +1 -1
  81. package/skills/verification-gates/manifest.json +1 -1
  82. package/agents/advisor.md +0 -60
  83. package/agents/critic.md +0 -136
  84. package/agents/deep-worker.md +0 -69
  85. package/agents/devil.md +0 -38
  86. package/agents/heavy-worker.md +0 -72
  87. package/agents/lead.md +0 -147
  88. package/agents/librarian.md +0 -66
  89. package/agents/qa.md +0 -53
  90. package/agents/quick.md +0 -70
  91. package/agents/strategist.md +0 -66
  92. package/agents/ui-heavy-worker.md +0 -66
  93. package/agents/ui-worker.md +0 -74
  94. package/agents/validator.md +0 -50
  95. package/dist/opencode-multiagent/file-lock.d.ts +0 -15
  96. package/dist/opencode-multiagent/file-lock.d.ts.map +0 -1
package/docs/agents.tr.md CHANGED
@@ -4,255 +4,158 @@
4
4
 
5
5
  # Ajan Referansı
6
6
 
7
- `opencode-multiagent`, 20 paketlenmiş ajan ile gelir:
7
+ `opencode-multiagent`, 10 paketlenmiş ajan ile gelir:
8
8
 
9
- - 4 ana ajan
10
- - 16 alt ajan
9
+ - 3 ana ajan
10
+ - 7 alt ajan
11
11
 
12
- Paketlenmiş tüm ajanlar şu anda varsayılan olarak `temperature: 0` kullanır.
12
+ Paketlenmiş ajanların çoğu varsayılan olarak `temperature: 0` kullanır. Tek istisna, daha yaratıcı keşif için `temperature: 0.3` kullanan `brainstormer` ajanıdır.
13
13
 
14
14
  ## Sistem Yapısı
15
15
 
16
16
  Sistem katmanlı olacak şekilde tasarlanmıştır:
17
17
 
18
- - `lead` kullanıcıya dönük routing'i yönetir
19
- - `critic` route'u sorgular veya repo durumunu inceler
20
- - `planner` büyük işler için kalıcı plan üretir
21
- - `executor` planı bounded worker yürütmesine dönüştürür
22
- - uzman alt ajanlar kodlama, review, arastirma ve dokumantasyon işlerini üstlenir
18
+ - `planner` kullanıcıya dönük triage, planlama, challenge ve inspeksiyon işlemlerini yönetir
19
+ - `executor` planı bounded uzman görevlerine dönüştürür ve yürütmeyi koordine eder
20
+ - uzman alt ajanlar kodlama, review, araştırma ve dokümantasyon işlerini üstlenir
23
21
 
24
22
  ## Yüksek Seviye Hiyerarşi
25
23
 
26
24
  ```text
27
25
  kullanici
28
- -> lead
29
- -> critic
30
- -> devil
31
- -> strategist
32
- -> planner
33
- -> strategist
34
- -> auditor
35
- -> devil
36
- -> scribe / librarian / reviewer / scout
37
- -> executor
38
- -> quick / worker / heavy-worker / deep-worker
39
- -> ui-worker / ui-heavy-worker
40
- -> reviewer
41
- -> validator
42
- -> qa
43
- -> advisor
44
- -> scout
45
- -> scribe
46
- -> planner (tekrarlanan QA başarısızlıklarında eskalasyon)
47
- -> librarian
48
- -> scout
49
- -> scribe
26
+ -> brainstormer (planlama öncesi keşif + fikir olgunlaştırma)
27
+ -> scout (araştırma)
28
+ -> auditor (fikirleri stres-test)
29
+
30
+ -> planner (triage + planlama + inspeksiyon)
31
+ -> executor (yürütme koordinasyonu)
32
+ -> coder (standart kodlama) -> reviewer, scout
33
+ -> ui-coder (UI/UX kodlama) -> reviewer, scout
34
+ -> sec-coder (güvenlik kodlama) -> reviewer, scout
35
+ -> reviewer (kalite kapısı)
36
+ -> scout (araştırma)
37
+ -> docmaster (.magent + doküman + GitHub)
38
+ -> auditor (plan açığı bulucu)
39
+ -> scout (araştırma)
40
+ -> reviewer (kanıt)
41
+ -> docmaster (plan kalıcılığı)
50
42
  ```
51
43
 
52
44
  ## Ana Ajanlar
53
45
 
54
- ### `lead`
46
+ ### `brainstormer`
55
47
 
56
48
  - Mod: `primary`
57
49
  - Varsayılan model: `anthropic/claude-opus-4-6`
58
- - Steps: `500`
59
- - Amaç: kullanıcıya dönük tek giriş noktası olarak talebin tüm yaşam döngüsünü sahiplenmek
60
- - En uygun kullanım: route seçimi, iş delegasyonu, sonuçların birleştirilmesi ve kullanıcıya dönüş
61
-
62
- ### `critic`
63
-
64
- - Mod: `primary`
65
- - Varsayılan model: `openai/gpt-5.4`
50
+ - Temperature: `0.3`
66
51
  - Steps: `200`
67
- - Amaç: challenge ve inspection ajanı olmak
68
- - En uygun kullanım: başlamadan önce route'u sorgulamak veya repo memory / plugin durumunu incelemek
52
+ - Amaç: planlama öncesi keşif ve fikir olgunlaştırma
53
+ - En uygun kullanım: planlama başlamadan önce kullanıcıyla birlikte fikirleri keşfetmek, boşlukları ve alternatifleri ortaya çıkarmak, varsayımları sorgulamak ve tartışma tamamlandığında planner'a hazır bir brief üretmek
69
54
 
70
55
  ### `planner`
71
56
 
72
57
  - Mod: `primary`
73
58
  - Varsayılan model: `anthropic/claude-opus-4-6`
74
- - Steps: `100`
75
- - Amaç: kod yazmadan kalıcı ve yürütmeye hazır plan üretmek
76
- - En uygun kullanım: büyük, cross-cutting, riskli veya çok aşamalı işler için `.magent/plans/` altında plan oluşturmak
59
+ - Steps: `200`
60
+ - Amaç: triage, planlama, challenge ve inspeksiyon
61
+ - En uygun kullanım: route seçimi, delegasyonu, büyük işlerde kalıcı ve yürütmeye hazır plan üretmek, repo durumunu incelemek
77
62
 
78
63
  ### `executor`
79
64
 
80
65
  - Mod: `primary`
81
66
  - Varsayılan model: `anthropic/claude-sonnet-4-6`
82
67
  - Steps: `200`
83
- - Amaç: onaylanmış planı bounded worker görevlerine bölüp doğrulama katmanları ile yürütmek
84
- - En uygun kullanım: implementasyon orkestrasyonu, task board güncellemeleri, reviewer, validator ve QA akışını yönetmek
85
-
86
- ## Kodlama Worker'ları
87
-
88
- ### `quick`
68
+ - Amaç: yürütme orkestrasyonu
69
+ - En uygun kullanım: onaylanmış planı bounded uzman görevlerine bölüp doğrulama katmanları ile yürütmek, task board güncellemeleri
89
70
 
90
- - Mod: `subagent`
91
- - Varsayılan model: `opencode-go/minimax-m2.5`
92
- - Steps: `16`
93
- - Amaç: çok küçük, açık ve düşük riskli düzenlemeler için hızlı worker
94
- - Ne zaman kullanılır: görev kelimesi kelimesine tanımlanmış, lokal ve net sınırları olan bir değişiklikse
71
+ ## Kodlama Ajanları
95
72
 
96
- ### `worker`
73
+ ### `coder`
97
74
 
98
75
  - Mod: `subagent`
99
- - Varsayılan model: `openai/gpt-5.3-codex`
100
- - Steps: `30`
101
- - Amaç: normal bounded implementasyon işleri için standart worker
102
- - Ne zaman kullanılır: UI dışı, orta zorlukta, varsayılan kodlama yolu gerektiğinde
76
+ - Varsayılan model: `anthropic/claude-sonnet-4-6`
77
+ - Steps: `40`
78
+ - Amaç: standart kodlama
79
+ - En uygun kullanım: UI dışı, orta zorlukta, varsayılan kodlama yolu gerektiğinde
103
80
 
104
- ### `heavy-worker`
81
+ ### `ui-coder`
105
82
 
106
83
  - Mod: `subagent`
107
- - Varsayılan model: `openai/gpt-5.4`
84
+ - Varsayılan model: `anthropic/claude-sonnet-4-6`
108
85
  - Steps: `40`
109
- - Amaç: riskli, cross-cutting veya güvenlik hassasiyeti olan implementasyon işleri
110
- - Ne zaman kullanılır: değişiklik birden fazla modülü, hassas runtime davranışını veya güvenlik mantığını etkiliyorsa
86
+ - Amaç: UI/UX
87
+ - En uygun kullanım: daha çok component, view-local state, layout, accessibility veya responsive davranış ile ilgiliyse
111
88
 
112
- ### `deep-worker`
89
+ ### `sec-coder`
113
90
 
114
91
  - Mod: `subagent`
115
92
  - Varsayılan model: `anthropic/claude-opus-4-6`
116
93
  - Steps: `60`
117
- - Amaç: belirsiz veya yoğun muhakeme gerektiren işler için uzun ufuklu tek sahipli worker
118
- - Ne zaman kullanılır: görev, daha fazla yerel analiz, akış takibi veya dikkatli çok adımlı bir uygulama gerektiriyorsa
119
-
120
- ### `ui-worker`
94
+ - Amaç: güvenlik hassas kodlama
95
+ - En uygun kullanım: değişiklik hassas runtime davranışını, kimlik doğrulama veya güvenlik mantığını etkiliyorsa
121
96
 
122
- - Mod: `subagent`
123
- - Varsayılan model: `anthropic/claude-opus-4-6`
124
- - Steps: `30`
125
- - Amaç: normal karmaşıklıktaki UI ve UX işleri
126
- - Ne zaman kullanılır: iş daha çok component, view-local state, layout, accessibility veya responsive davranış ile ilgiliyse
127
-
128
- ### `ui-heavy-worker`
129
-
130
- - Mod: `subagent`
131
- - Varsayılan model: `anthropic/claude-opus-4-6`
132
- - Steps: `40`
133
- - Amaç: geniş kapsamlı veya karmaşık durum yöneten UI ve UX işleri
134
- - Ne zaman kullanılır: iş birden fazla ekranı, karmaşık akışları veya koordineli etkileşim davranışlarını kapsıyorsa
135
-
136
- ## Kalite ve Review Ajanları
97
+ ## Kalite Ajanları
137
98
 
138
99
  ### `reviewer`
139
100
 
140
101
  - Mod: `subagent`
141
- - Varsayılan model: `github-copilot/grok-code-fast-1`
142
- - Steps: `24`
143
- - Amaç: küçük ve bounded değişiklikler için read-only kod incelemesi yapmak
144
- - En uygun kullanım: implementasyon tamamlandı denmeden önce 1-3 dosyalık dar bir değişiklik yüzeyini incelemek
145
-
146
- ### `validator`
147
-
148
- - Mod: `subagent`
149
- - Varsayılan model: `openai/gpt-5.3-codex`
150
- - Steps: `24`
151
- - Amaç: gerekli en küçük doğrulama komutlarını çalıştıran bounded doğrulama ajanı
152
- - En uygun kullanım: test, build, lint ve typecheck gibi komutlarla kanıt üretmek
153
-
154
- ### `qa`
155
-
156
- - Mod: `subagent`
157
- - Varsayılan model: `openai/gpt-5.4`
158
- - Steps: `24`
159
- - Amaç: son kabul kararını veren read-only kalite kapısı olmak
160
- - En uygun kullanım: daha yüksek riskli işlerde doğrulama sonrası net bir OKAY veya REJECT kararı gerektiğinde
102
+ - Varsayılan model: `anthropic/claude-sonnet-4-6`
103
+ - Steps: `30`
104
+ - Amaç: kod inceleme, QA, doğrulama
105
+ - En uygun kullanım: implementasyon tamamlandıktan sonra değişiklik yüzeyini incelemek, test/build/lint ile kanıt üretmek ve son kabul kararı vermek
161
106
 
162
107
  ### `auditor`
163
108
 
164
109
  - Mod: `subagent`
165
- - Varsayılan model: `openai/gpt-5.4`
166
- - Steps: `24`
167
- - Amaç: agresif read-only plan denetimi yapmak
110
+ - Varsayılan model: `anthropic/claude-opus-4-6`
111
+ - Steps: `40`
112
+ - Amaç: plan açığı bulucu
168
113
  - En uygun kullanım: iş yürütülmeden önce eksik adımları, zayıf kabul kriterlerini, sıralama sorunlarını ve verification boşluklarını yakalamak
169
114
 
170
- ### `devil`
171
-
172
- - Mod: `subagent`
173
- - Varsayılan model: `anthropic/claude-sonnet-4-6`
174
- - Steps: `8`
175
- - Amaç: araç kullanmadan saf devil's-advocate muhakemesi yürütmek
176
- - En uygun kullanım: varsayımları sorgulamak, kör noktaları göstermek ve hızlı karşı argüman üretmek
177
-
178
- ## Araştırma ve Danışmanlık Ajanları
115
+ ## Araştırma Ajanı
179
116
 
180
117
  ### `scout`
181
118
 
182
119
  - Mod: `subagent`
183
120
  - Varsayılan model: `anthropic/claude-sonnet-4-6`
184
- - Steps: `24`
185
- - Amaç: hızlı ve read-only repo haritalama yapmak
121
+ - Steps: `30`
122
+ - Amaç: dosya keşfi, araştırma
186
123
  - En uygun kullanım: dosya bulma, sembol takibi, kod tabanı yapısını anlama ve yerel keşif
187
124
 
188
- ### `librarian`
189
-
190
- - Mod: `subagent`
191
- - Varsayılan model: `anthropic/claude-sonnet-4-6`
192
- - Steps: `24`
193
- - Amaç: dış kaynak araştırması ve dokümantasyon toplamak
194
- - En uygun kullanım: güncel doküman sorgusu, dış karşılaştırmalar, API araştırması ve repo dışı kanıt toplama
195
-
196
- ### `advisor`
197
-
198
- - Mod: `subagent`
199
- - Varsayılan model: `openai/gpt-5.4`
200
- - Steps: `20`
201
- - Amaç: bloke olmuş veya düşük güvenli implementasyon işleri için read-only teknik danışmanlık vermek
202
- - En uygun kullanım: worker'ı unblock etmek, yerel implementasyon yolları arasında seçim yapmak veya riskli bir kararı netleştirmek
203
-
204
- ### `strategist`
205
-
206
- - Mod: `subagent`
207
- - Varsayılan model: `anthropic/claude-opus-4-6`
208
- - Steps: `20`
209
- - Amaç: yön ve mimari kararlarda yargı odaklı danışmanlık vermek
210
- - En uygun kullanım: yaklaşım doğrulamak, mimari riskleri görünür kılmak ve bir planın ilerlemesi gerekip gerekmediğine karar vermek
211
-
212
125
  ## Dokümantasyon Ajanı
213
126
 
214
- ### `scribe`
127
+ ### `docmaster`
215
128
 
216
129
  - Mod: `subagent`
217
130
  - Varsayılan model: `anthropic/claude-sonnet-4-6`
218
131
  - Steps: `30`
219
- - Amaç: dokümantasyon yazmak ve `.magent` artifaktlarını yönetmek
220
- - En uygun kullanım: `README.md`, `AGENTS.md`, `CHANGELOG.md`, `CONTRIBUTING.md`, `docs/**` ve `.magent/**` güncellemeleri
132
+ - Amaç: dokümantasyon, `.magent`, GitHub
133
+ - En uygun kullanım: `README.md`, `AGENTS.md`, `CHANGELOG.md`, `CONTRIBUTING.md`, `docs/**` ve `.magent/**` güncellemeleri, GitHub işlemleri
221
134
 
222
135
  ## Kategori Özeti
223
136
 
224
- | Kategori | Ajanlar |
225
- | ------------------------ | -------------------------------------------------------------------------------- |
226
- | Ana orkestrasyon | `lead`, `critic`, `planner`, `executor` |
227
- | Kodlama worker'ları | `quick`, `worker`, `heavy-worker`, `deep-worker`, `ui-worker`, `ui-heavy-worker` |
228
- | Kalite ve review | `reviewer`, `validator`, `qa`, `auditor`, `devil` |
229
- | Araştırma ve danışmanlık | `scout`, `librarian`, `advisor`, `strategist` |
230
- | Dokümantasyon | `scribe` |
137
+ | Kategori | Ajanlar |
138
+ | ------------------- | ---------------------------------------------- |
139
+ | Ana orkestrasyon | `brainstormer`, `planner`, `executor` |
140
+ | Kodlama ajanları | `coder`, `ui-coder`, `sec-coder` |
141
+ | Kalite | `reviewer`, `auditor` |
142
+ | Araştırma | `scout` |
143
+ | Dokümantasyon | `docmaster` |
231
144
 
232
145
  ## Özet Tablo
233
146
 
234
- | Agent | Kategori | Mod | Model | Steps | Ana kullanım |
235
- | ----------------- | ------------- | ---------- | --------------------------------- | ----- | ---------------------------------------------------- |
236
- | `lead` | Primary | `primary` | `anthropic/claude-opus-4-6` | `500` | Kullanıcıya dönük routing ve yaşam döngüsü sahipliği |
237
- | `critic` | Primary | `primary` | `openai/gpt-5.4` | `200` | Challenge ve inspection |
238
- | `planner` | Primary | `primary` | `anthropic/claude-opus-4-6` | `100` | Kalıcı plan yazımı |
239
- | `executor` | Primary | `primary` | `anthropic/claude-sonnet-4-6` | `200` | Yürütme orkestrasyonu ve doğrulama |
240
- | `quick` | Coding | `subagent` | `opencode-go/minimax-m2.5` | `16` | Çok küçük açık değişiklikler |
241
- | `worker` | Coding | `subagent` | `openai/gpt-5.3-codex` | `30` | Varsayılan bounded kodlama işi |
242
- | `heavy-worker` | Coding | `subagent` | `openai/gpt-5.4` | `40` | Riskli cross-cutting implementasyon |
243
- | `deep-worker` | Coding | `subagent` | `anthropic/claude-opus-4-6` | `60` | Yoğun muhakeme isteyen tek sahipli kodlama |
244
- | `ui-worker` | Coding | `subagent` | `anthropic/claude-opus-4-6` | `30` | Standart UI ve UX işi |
245
- | `ui-heavy-worker` | Coding | `subagent` | `anthropic/claude-opus-4-6` | `40` | Geniş UI akışları ve ileri seviye state |
246
- | `reviewer` | Quality | `subagent` | `github-copilot/grok-code-fast-1` | `24` | Read-only kod incelemesi |
247
- | `validator` | Quality | `subagent` | `openai/gpt-5.3-codex` | `24` | Doğrulama komutları çalıştırma |
248
- | `qa` | Quality | `subagent` | `openai/gpt-5.4` | `24` | Son kalite kapısı |
249
- | `auditor` | Quality | `subagent` | `openai/gpt-5.4` | `24` | Plan denetimi |
250
- | `devil` | Quality | `subagent` | `anthropic/claude-sonnet-4-6` | `8` | Karşı argüman ve kör nokta üretimi |
251
- | `scout` | Research | `subagent` | `anthropic/claude-sonnet-4-6` | `24` | Yerel repo keşfi |
252
- | `librarian` | Research | `subagent` | `anthropic/claude-sonnet-4-6` | `24` | Dış kaynak araştırması |
253
- | `advisor` | Advisory | `subagent` | `openai/gpt-5.4` | `20` | Yerel implementasyon danışmanlığı |
254
- | `strategist` | Advisory | `subagent` | `anthropic/claude-opus-4-6` | `20` | Mimari ve yön kararı danışmanlığı |
255
- | `scribe` | Documentation | `subagent` | `anthropic/claude-sonnet-4-6` | `30` | Doküman ve `.magent` yazımı |
147
+ | Agent | Kategori | Mod | Model | Steps | Ana kullanım |
148
+ | -------------- | ------------- | ---------- | ----------------------------- | ----- | ------------------------------------------------------- |
149
+ | `brainstormer` | Primary | `primary` | `anthropic/claude-opus-4-6` | `200` | Planlama öncesi keşif ve fikir olgunlaştırma |
150
+ | `planner` | Primary | `primary` | `anthropic/claude-opus-4-6` | `200` | Triage, planlama, challenge, inspeksiyon |
151
+ | `executor` | Primary | `primary` | `anthropic/claude-sonnet-4-6` | `200` | Yürütme orkestrasyonu |
152
+ | `coder` | Coding | `subagent` | `anthropic/claude-sonnet-4-6` | `40` | Standart kodlama |
153
+ | `ui-coder` | Coding | `subagent` | `anthropic/claude-sonnet-4-6` | `40` | UI/UX kodlama |
154
+ | `sec-coder` | Coding | `subagent` | `anthropic/claude-opus-4-6` | `60` | Güvenlik hassas kodlama |
155
+ | `reviewer` | Quality | `subagent` | `anthropic/claude-sonnet-4-6` | `30` | Kod inceleme, QA, doğrulama |
156
+ | `auditor` | Quality | `subagent` | `anthropic/claude-opus-4-6` | `40` | Plan açığı bulma ve denetim |
157
+ | `scout` | Research | `subagent` | `anthropic/claude-sonnet-4-6` | `30` | Dosya keşfi ve araştırma |
158
+ | `docmaster` | Documentation | `subagent` | `anthropic/claude-sonnet-4-6` | `30` | Doküman, `.magent` yazımı ve GitHub |
256
159
 
257
160
  ## İlgili Dokümanlar
258
161
 
@@ -74,7 +74,7 @@ Top-level runtime flags:
74
74
  | `telemetry` | `true` | Records session, tool, and error telemetry in the plugin log. |
75
75
  | `supervision` | `true` | Enables parent-child supervision reminders for idle delegated sessions. |
76
76
  | `quality_gate` | `true` | Tracks edit activity and emits quality reminders for sessions that go idle. |
77
- | `skill_injection` | `false` | Enables runtime skill registry lookup and skill availability injection. |
77
+ | `skill_injection` | `false` | Reserved. Loads the skill registry but does not inject content yet. |
78
78
 
79
79
  ### `skill_sources`
80
80
 
@@ -130,30 +130,20 @@ This section centralizes per-agent defaults for:
130
130
  - `temperature`
131
131
  - `steps`
132
132
 
133
- All bundled agents currently default to `temperature: 0`.
134
-
135
- | Agent | Category | Default model | Steps |
136
- | ----------------- | ------------- | --------------------------------- | ----- |
137
- | `lead` | Primary | `anthropic/claude-opus-4-6` | `500` |
138
- | `critic` | Primary | `openai/gpt-5.4` | `200` |
139
- | `planner` | Primary | `anthropic/claude-opus-4-6` | `100` |
140
- | `executor` | Primary | `anthropic/claude-sonnet-4-6` | `200` |
141
- | `scout` | Research | `anthropic/claude-sonnet-4-6` | `24` |
142
- | `worker` | Coding | `openai/gpt-5.3-codex` | `30` |
143
- | `heavy-worker` | Coding | `openai/gpt-5.4` | `40` |
144
- | `deep-worker` | Coding | `anthropic/claude-opus-4-6` | `60` |
145
- | `ui-worker` | Coding | `anthropic/claude-opus-4-6` | `30` |
146
- | `ui-heavy-worker` | Coding | `anthropic/claude-opus-4-6` | `40` |
147
- | `quick` | Coding | `opencode-go/minimax-m2.5` | `16` |
148
- | `reviewer` | Quality | `github-copilot/grok-code-fast-1` | `24` |
149
- | `validator` | Quality | `openai/gpt-5.3-codex` | `24` |
150
- | `qa` | Quality | `openai/gpt-5.4` | `24` |
151
- | `advisor` | Advisory | `openai/gpt-5.4` | `20` |
152
- | `auditor` | Quality | `openai/gpt-5.4` | `24` |
153
- | `strategist` | Advisory | `anthropic/claude-opus-4-6` | `20` |
154
- | `devil` | Quality | `anthropic/claude-sonnet-4-6` | `8` |
155
- | `scribe` | Documentation | `anthropic/claude-sonnet-4-6` | `30` |
156
- | `librarian` | Research | `anthropic/claude-sonnet-4-6` | `24` |
133
+ Most bundled agents default to `temperature: 0`. The exception is `brainstormer` which uses `temperature: 0.3` for more creative exploration.
134
+
135
+ | Agent | Category | Default model | Steps |
136
+ | -------------- | ------------- | ----------------------------- | ----- |
137
+ | `brainstormer` | Primary | `anthropic/claude-opus-4-6` | `200` |
138
+ | `planner` | Primary | `anthropic/claude-opus-4-6` | `200` |
139
+ | `executor` | Primary | `anthropic/claude-sonnet-4-6` | `200` |
140
+ | `coder` | Coding | `anthropic/claude-sonnet-4-6` | `40` |
141
+ | `ui-coder` | Coding | `anthropic/claude-sonnet-4-6` | `40` |
142
+ | `sec-coder` | Coding | `anthropic/claude-opus-4-6` | `60` |
143
+ | `reviewer` | Quality | `anthropic/claude-sonnet-4-6` | `30` |
144
+ | `auditor` | Quality | `anthropic/claude-opus-4-6` | `40` |
145
+ | `scout` | Research | `anthropic/claude-sonnet-4-6` | `30` |
146
+ | `docmaster` | Documentation | `anthropic/claude-sonnet-4-6` | `30` |
157
147
 
158
148
  ## `mcpDefaults`
159
149
 
@@ -203,8 +193,8 @@ Path: `~/.config/opencode/plugins/opencode-multiagent.json`
203
193
  "profile": "strict"
204
194
  },
205
195
  "agentSettings": {
206
- "lead": {
207
- "steps": 650
196
+ "planner": {
197
+ "steps": 300
208
198
  }
209
199
  }
210
200
  }
@@ -75,7 +75,7 @@ Pratik kural:
75
75
  | `telemetry` | `true` | Session, tool ve hata telemetry kayıtlarını plugin loguna yazar. |
76
76
  | `supervision` | `true` | Delegated child session'lar için parent-child supervision hatırlatmalarını açar. |
77
77
  | `quality_gate` | `true` | Edit yapan session'ları izler ve idle kalınca quality reminder üretir. |
78
- | `skill_injection` | `false` | Runtime skill registry taramasını ve skill availability injection'ını açar. |
78
+ | `skill_injection` | `false` | Ayrılmış. Skill registry'yi yükler ancak henüz içerik enjekte etmez. |
79
79
 
80
80
  ### `skill_sources`
81
81
 
@@ -131,30 +131,20 @@ Bu bölüm, agent bazında şu varsayılanları merkezi olarak yönetir:
131
131
  - `temperature`
132
132
  - `steps`
133
133
 
134
- Paketlenmiş tüm agent'lar şu anda varsayılan olarak `temperature: 0` kullanır.
135
-
136
- | Agent | Kategori | Varsayılan model | Steps |
137
- | ----------------- | ------------- | --------------------------------- | ----- |
138
- | `lead` | Primary | `anthropic/claude-opus-4-6` | `500` |
139
- | `critic` | Primary | `openai/gpt-5.4` | `200` |
140
- | `planner` | Primary | `anthropic/claude-opus-4-6` | `100` |
141
- | `executor` | Primary | `anthropic/claude-sonnet-4-6` | `200` |
142
- | `scout` | Research | `anthropic/claude-sonnet-4-6` | `24` |
143
- | `worker` | Coding | `openai/gpt-5.3-codex` | `30` |
144
- | `heavy-worker` | Coding | `openai/gpt-5.4` | `40` |
145
- | `deep-worker` | Coding | `anthropic/claude-opus-4-6` | `60` |
146
- | `ui-worker` | Coding | `anthropic/claude-opus-4-6` | `30` |
147
- | `ui-heavy-worker` | Coding | `anthropic/claude-opus-4-6` | `40` |
148
- | `quick` | Coding | `opencode-go/minimax-m2.5` | `16` |
149
- | `reviewer` | Quality | `github-copilot/grok-code-fast-1` | `24` |
150
- | `validator` | Quality | `openai/gpt-5.3-codex` | `24` |
151
- | `qa` | Quality | `openai/gpt-5.4` | `24` |
152
- | `advisor` | Advisory | `openai/gpt-5.4` | `20` |
153
- | `auditor` | Quality | `openai/gpt-5.4` | `24` |
154
- | `strategist` | Advisory | `anthropic/claude-opus-4-6` | `20` |
155
- | `devil` | Quality | `anthropic/claude-sonnet-4-6` | `8` |
156
- | `scribe` | Documentation | `anthropic/claude-sonnet-4-6` | `30` |
157
- | `librarian` | Research | `anthropic/claude-sonnet-4-6` | `24` |
134
+ Paketlenmiş ajanların çoğu varsayılan olarak `temperature: 0` kullanır. Tek istisna, daha yaratıcı keşif için `temperature: 0.3` kullanan `brainstormer` ajanıdır.
135
+
136
+ | Agent | Kategori | Varsayılan model | Steps |
137
+ | -------------- | ------------- | ----------------------------- | ----- |
138
+ | `brainstormer` | Primary | `anthropic/claude-opus-4-6` | `200` |
139
+ | `planner` | Primary | `anthropic/claude-opus-4-6` | `200` |
140
+ | `executor` | Primary | `anthropic/claude-sonnet-4-6` | `200` |
141
+ | `coder` | Coding | `anthropic/claude-sonnet-4-6` | `40` |
142
+ | `ui-coder` | Coding | `anthropic/claude-sonnet-4-6` | `40` |
143
+ | `sec-coder` | Coding | `anthropic/claude-opus-4-6` | `60` |
144
+ | `reviewer` | Quality | `anthropic/claude-sonnet-4-6` | `30` |
145
+ | `auditor` | Quality | `anthropic/claude-opus-4-6` | `40` |
146
+ | `scout` | Research | `anthropic/claude-sonnet-4-6` | `30` |
147
+ | `docmaster` | Documentation | `anthropic/claude-sonnet-4-6` | `30` |
158
148
 
159
149
  ## `mcpDefaults`
160
150
 
@@ -203,8 +193,8 @@ Yol: `~/.config/opencode/plugins/opencode-multiagent.json`
203
193
  "profile": "strict"
204
194
  },
205
195
  "agentSettings": {
206
- "lead": {
207
- "steps": 650
196
+ "planner": {
197
+ "steps": 300
208
198
  }
209
199
  }
210
200
  }
@@ -33,42 +33,43 @@ When OpenCode loads the package, the plugin:
33
33
  3. builds the effective runtime flags and agent settings
34
34
  4. compiles bundled agent and command markdown into the active config
35
35
  5. injects plugin-owned MCP defaults only when the host config does not already define them
36
- 6. prefers `lead` as the default top-level agent when available
37
- 7. enables runtime hooks for telemetry, file locks, supervision, quality reminders, and the shared task board
36
+ 6. prefers `planner` as the default top-level agent when available
37
+ 7. enables runtime hooks for telemetry, supervision, quality reminders, and the shared task board
38
38
 
39
39
  ## 3. Normal User Flow
40
40
 
41
41
  In normal use, you do not need to pick worker agents manually. The system is designed so the
42
- top-level interaction goes through `lead`.
42
+ top-level interaction goes through `planner` for most tasks. For exploratory work where the
43
+ direction is unclear, start with `brainstormer` first.
43
44
 
44
- Typical flow:
45
+ Typical flows:
45
46
 
46
47
  ```text
47
- user -> lead -> critic/planner/executor -> specialized subagents
48
+ user -> planner -> executor -> specialized subagents
49
+ user -> brainstormer -> (concludes with brief) -> planner -> executor -> ...
48
50
  ```
49
51
 
50
52
  ### The main routing roles
51
53
 
52
- | Agent | Role |
53
- | ---------- | ------------------------------------------------------------------------- |
54
- | `lead` | Owns the request lifecycle, chooses routing, and integrates results. |
55
- | `critic` | Challenges a route or inspects repository state before work proceeds. |
56
- | `planner` | Writes a durable execution plan for larger or riskier work. |
57
- | `executor` | Runs the plan by dispatching bounded worker tasks and validating results. |
54
+ | Agent | Role |
55
+ | -------------- | -------------------------------------------------------------------------- |
56
+ | `brainstormer` | Explores ideas with the user before planning. Produces a planner brief. |
57
+ | `planner` | Owns triage, planning, challenge, inspection, and result integration. |
58
+ | `executor` | Runs the plan by dispatching bounded coding tasks and validating results. |
58
59
 
59
60
  ## 4. Triage Levels
60
61
 
61
- `lead` uses a tiered routing model.
62
+ `planner` uses a tiered routing model.
62
63
 
63
- | Tier | Meaning | Typical route |
64
- | -------- | -------------------------------------------------------- | --------------------------------------- |
65
- | `Tier 0` | Tiny, explicit, low-risk work | `lead -> executor -> quick/worker` |
66
- | `Tier 1` | Bounded work that benefits from a challenge pass | `lead -> critic -> executor` |
67
- | `Tier 2` | Cross-cutting, risky, ambiguous, or migration-heavy work | `lead -> critic -> planner -> executor` |
68
- | `Tier 3` | Inspection and repo-memory work | `lead -> critic` |
64
+ | Tier | Meaning | Typical route |
65
+ | -------- | -------------------------------------------------------- | -------------------------------------------- |
66
+ | `Tier 0` | Trivial single-file work | `planner -> executor -> coder` |
67
+ | `Tier 1` | Bounded work | `planner -> executor -> coder/ui-coder/sec-coder` |
68
+ | `Tier 2` | Complex multi-module work | `planner -> auditor -> executor -> coders` |
69
+ | `Tier 3` | Inspection | `planner` (inspection mode) |
69
70
 
70
- As a user, the practical takeaway is simple: ask for the task naturally and let `lead` decide the
71
- route unless you have a strong reason to override the flow.
71
+ As a user, the practical takeaway is simple: ask for the task naturally and let `planner` decide
72
+ the route unless you have a strong reason to override the flow.
72
73
 
73
74
  ## 5. Shared Task Board
74
75
 
@@ -79,7 +80,7 @@ The plugin exposes three shared task tools:
79
80
  - `task_list`
80
81
 
81
82
  These are used internally by the agent system to track work, but they are also important to
82
- understand when reading logs or `.magent` artifacts.
83
+ understand when reading logs or `.opencode` artifacts.
83
84
 
84
85
  ### Task lifecycle
85
86
 
@@ -96,7 +97,7 @@ Possible task states:
96
97
 
97
98
  When a project root is available, the task board is persisted to:
98
99
 
99
- - `.magent/tasks/taskboard.json`
100
+ - `.opencode/tasks/taskboard.json`
100
101
 
101
102
  This makes multi-step execution easier to inspect after a session.
102
103
 
@@ -129,11 +130,11 @@ Example:
129
130
  ```json
130
131
  {
131
132
  "agentSettings": {
132
- "lead": {
133
- "steps": 650
133
+ "planner": {
134
+ "steps": 300
134
135
  },
135
136
  "reviewer": {
136
- "model": "openai/gpt-5.4"
137
+ "model": "anthropic/claude-opus-4-6"
137
138
  }
138
139
  }
139
140
  }
@@ -148,8 +149,8 @@ Example:
148
149
  "$schema": "https://opencode.ai/config.json",
149
150
  "plugin": ["opencode-multiagent"],
150
151
  "agent": {
151
- "lead": {
152
- "steps": 650
152
+ "planner": {
153
+ "steps": 300
153
154
  }
154
155
  }
155
156
  }
@@ -197,13 +198,13 @@ Use `opencode.json` to explicitly enable it:
197
198
 
198
199
  Common generated files and directories:
199
200
 
200
- | Path | Purpose |
201
- | ----------------------------------------------------- | ------------------------------------------------- |
202
- | `~/.config/opencode/logs/opencode-multiagent.jsonl` | Observation and telemetry log |
203
- | `~/.config/opencode/plugins/opencode-multiagent.json` | User runtime overrides |
204
- | `.magent/tasks/taskboard.json` | Shared task board persistence |
205
- | `.magent/plans/` | Durable plans created through planner and scribe |
206
- | `.magent/exec/` | Execution artifacts maintained during larger work |
201
+ | Path | Purpose |
202
+ | ----------------------------------------------------- | ---------------------------------------------------- |
203
+ | `~/.config/opencode/logs/opencode-multiagent.jsonl` | Observation and telemetry log |
204
+ | `~/.config/opencode/plugins/opencode-multiagent.json` | User runtime overrides |
205
+ | `.opencode/tasks/taskboard.json` | Shared task board persistence |
206
+ | `.opencode/plans/` | Durable plans created through planner and docmaster |
207
+ | `.opencode/exec/` | Execution artifacts maintained during larger work |
207
208
 
208
209
  ## 10. Development Workflow
209
210