opencode-multiagent 0.2.1 → 0.4.0

package/docs/configuration.tr.md

@@ -0,0 +1,244 @@
+> Dil: [English](configuration.md) | **Türkçe**
+>
+> Geri: [README](../README.tr.md)
+
+# Konfigürasyon Referansı
+
+Bu doküman, plugin'in konfigürasyon yüzeylerini, her ayarın ne yaptığını ve override sırasının
+nasıl çalıştığını açıklar.
+
+## Konfigürasyon Dosyaları
+
+Plugin üç farklı konfigürasyon katmanı kullanır:
+
+1. Paketle birlikte gelen varsayılanlar: `defaults/opencode-multiagent.json`
+2. Kullanıcı runtime override dosyası: `~/.config/opencode/plugins/opencode-multiagent.json`
+3. Host OpenCode konfigürasyonu: `opencode.json`
+
+## Merge ve Override Kuralları
+
+### Runtime ayarları
+
+Plugin başlarken önce paketlenmiş varsayılanları, sonra da
+`~/.config/opencode/plugins/opencode-multiagent.json` dosyasını okur.
+
+Kullanıcı ayar dosyası şu bölümleri destekler:
+
+- `flags`
+- `agentSettings`
+- `profiles`
+
+Efektif runtime flag'leri şu sırayla çözülür:
+
+1. dahili `defaultFlags`
+2. merge edilmiş profillerden seçilen profil
+3. kullanıcı `flags`
+
+Yani kullanıcı `flags` her zaman seçilen profilin üstüne yazar, seçilen profil de dahili temel
+ayarların üstüne yazar.
+
+### Agent ayarları
+
+`agentSettings`, agent compilation sırasında uygulanır ve sadece `model`, `temperature` ve
+`steps` alanlarını doldurur; ancak bu alanlar host config içinde zaten açıkça tanımlanmışsa
+dokunulmaz.
+
+Pratik kural:
+
+- paketlenmiş agent markdown dosyaları temel tanımı sağlar
+- `agentSettings` merkezi varsayılan override sağlar
+- açıkça tanımladığınız `opencode.json -> agent.<name>.*` değerleri her zaman kazanır
+
+### MCP varsayılanları
+
+Paketlenmiş `mcpDefaults` bölümü korumacı şekilde enjekte edilir. Plugin, aktif OpenCode
+konfigürasyonunda aynı isimde bir sunucu yoksa MCP sunucusunu ekler.
+
+Pratik kural:
+
+- paketlenmiş `mcpDefaults` boşlukları doldurur
+- açıkça tanımladığınız `opencode.json -> mcp.<name>` değerleri her zaman kazanır
+
+## `flags`
+
+Üst seviye runtime flag'leri:
+
+| Anahtar               | Varsayılan | Ne yapar                                                                               |
+| --------------------- | ---------- | -------------------------------------------------------------------------------------- |
+| `profile`             | `standard` | Kullanıcı flag override'ları uygulanmadan önce temel runtime profilini seçer.          |
+| `enforcement`         | `true`     | Hassas dosya yolları ve yıkıcı shell komutları için yerel güvenlik kontrollerini açar. |
+| `observation`         | `true`     | Event ve tool çalıştırmalarını JSONL olarak loglar.                                    |
+| `prompt_controls`     | `true`     | Prompt metadata header'larını ve riskli prompt/komut içerik loglamasını açar.          |
+| `agent_compilation`   | `true`     | Paketlenmiş, global ve proje bazlı agent markdown dosyalarını aktif config'e derler.   |
+| `command_compilation` | `true`     | Paketlenmiş, global ve proje bazlı command markdown dosyalarını aktif config'e derler. |
+| `mcp_compilation`     | `true`     | Eksikse plugin tarafından yönetilen MCP varsayılanlarını aktif config'e enjekte eder.  |
+| `telemetry`           | `true`     | Session, tool ve hata telemetry kayıtlarını plugin loguna yazar.                       |
+| `supervision`         | `true`     | Delegated child session'lar için parent-child supervision hatırlatmalarını açar.       |
+| `quality_gate`        | `true`     | Edit yapan session'ları izler ve idle kalınca quality reminder üretir.                 |
+| `skill_injection`     | `false`    | Ayrılmış. Skill registry'yi yükler ancak henüz içerik enjekte etmez.                  |
+
+### `skill_sources`
+
+Varsayılan değer:
+
+```json
+["${plugin_root}/skills", "${home}/.agents/skills", "${home}/skills"]
+```
+
+Bu dizi, `skill_injection` açıksa kullanılacak arama sırasını belirtir.
+
+- `${plugin_root}` kurulu paket kökünü gösterir
+- `${home}` aktif kullanıcının home dizinini gösterir
+
+### `compiler.permission_compilation`
+
+| Anahtar                           | Varsayılan | Ne yapar                                                                                                                                                 |
+| --------------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `compiler.permission_compilation` | `true`     | `bash`, `read`, `edit`, `glob`, `grep` ve `list` gibi temel araçlar için eksik top-level OpenCode permission varsayılanlarını temkinli biçimde doldurur. |
+
+### `experimental`
+
+Bu flag'ler opsiyonel prompt ve session transform davranışlarını açar:
+
+| Anahtar                                | Varsayılan | Ne yapar                                                   |
+| -------------------------------------- | ---------- | ---------------------------------------------------------- |
+| `experimental.chat_system_transform`   | `false`    | System prompt sonuna deneysel bir not ekler.               |
+| `experimental.chat_messages_transform` | `false`    | Dispatch öncesi son kullanıcı mesajına deneysel not ekler. |
+| `experimental.session_compacting`      | `false`    | Session compaction özetlerine deneysel context ekler.      |
+| `experimental.text_complete`           | `false`    | Tamamlanan LLM çıktılarının sonuna deneysel metin ekler.   |
+
+Bu alanlar varsayılan olarak sadece `strict` profilinde açıktır.
+
+### `supervision_config`
+
+| Anahtar                              | Varsayılan | Anlamı                                                                  |
+| ------------------------------------ | ---------- | ----------------------------------------------------------------------- |
+| `supervision_config.idle_timeout_ms` | `180000`   | Delegated child session'ın ne kadar süre boşta kalabileceğini belirler. |
+| `supervision_config.cooldown_ms`     | `300000`   | Supervision hatırlatmaları arasındaki bekleme süresi.                   |
+
+### `quality_config`
+
+| Anahtar                               | Varsayılan | Anlamı                                                                                       |
+| ------------------------------------- | ---------- | -------------------------------------------------------------------------------------------- |
+| `quality_config.reminder_idle_ms`     | `120000`   | Edit yapan bir session ne kadar süre boşta kalırsa quality reminder düşünüleceğini belirler. |
+| `quality_config.reminder_cooldown_ms` | `300000`   | Quality reminder'lar arasındaki bekleme süresi.                                              |
+
+## `agentSettings`
+
+Bu bölüm, agent bazında şu varsayılanları merkezi olarak yönetir:
+
+- `model`
+- `temperature`
+- `steps`
+
+Paketlenmiş tüm agent'lar şu anda varsayılan olarak `temperature: 0` kullanır.
+
+| Agent       | Kategori      | Varsayılan model              | Steps |
+| ----------- | ------------- | ----------------------------- | ----- |
+| `planner`   | Primary       | `anthropic/claude-opus-4-6`   | `200` |
+| `executor`  | Primary       | `anthropic/claude-sonnet-4-6` | `200` |
+| `coder`     | Coding        | `anthropic/claude-sonnet-4-6` | `40`  |
+| `ui-coder`  | Coding        | `anthropic/claude-sonnet-4-6` | `40`  |
+| `sec-coder` | Coding        | `anthropic/claude-opus-4-6`   | `60`  |
+| `reviewer`  | Quality       | `anthropic/claude-sonnet-4-6` | `30`  |
+| `auditor`   | Quality       | `anthropic/claude-opus-4-6`   | `40`  |
+| `scout`     | Research      | `anthropic/claude-sonnet-4-6` | `30`  |
+| `docmaster` | Documentation | `anthropic/claude-sonnet-4-6` | `30`  |
+
+## `mcpDefaults`
+
+Bunlar paketle birlikte gelen ve plugin tarafından yönetilen MCP sunucu tanımlarıdır.
+
+| Sunucu       | Tip      | Varsayılan enabled | Amaç                                                                      |
+| ------------ | -------- | ------------------ | ------------------------------------------------------------------------- |
+| `code_index` | `local`  | `true`             | İndeksli kod arama, dosya bulma, özet ve sembol sorguları.                |
+| `repo`       | `local`  | `true`             | Git status, diff, log, branch ve commit inceleme araçları.                |
+| `context7`   | `remote` | `false`            | Güncel kütüphane ve framework dokümantasyonu sorgulama.                   |
+| `exa`        | `remote` | `false`            | Web arama ve code context toplama.                                        |
+| `gh_grep`    | `remote` | `false`            | Public GitHub depolarında kod arama.                                      |
+| `github`     | `local`  | `false`            | GitHub repo, issue, PR ve dosya işlemleri. `GITHUB_PAT_TOKEN` gerektirir. |
+
+Notlar:
+
+- `code_index` ve `repo`, yerel geliştirme akışını doğrudan desteklediği için varsayılan olarak açıktır.
+- `github`, kimlik bilgisi gerektirdiği için varsayılan olarak kapalıdır.
+- `context7`, `exa` ve `gh_grep` opsiyonel uzak servislerdir; kapalı başlar.
+
+## `profiles`
+
+Plugin üç isimli profil ile gelir.
+
+| Profil     | En uygun senaryo           | Observation ve telemetry | Supervision ve quality | Experimental transform |
+| ---------- | -------------------------- | ------------------------ | ---------------------- | ---------------------- |
+| `minimal`  | En düşük runtime yükü      | Çoğu kapalı              | Çoğu kapalı            | Kapalı                 |
+| `standard` | Varsayılan günlük kullanım | Açık                     | Açık                   | Kapalı                 |
+| `strict`   | En yüksek koruma seviyesi  | Açık                     | Açık                   | Açık                   |
+
+Profil detayları:
+
+- `minimal`, enforcement'i açık bırakır ama log ve reminder davranışlarını azaltır.
+- `standard`, normal kullanım için varsayılan dengedir.
+- `strict`, standart korumaların üstüne tüm experimental transform'ları da açar.
+
+## Kullanıcı Override Örnekleri
+
+### Temel kullanıcı runtime dosyası
+
+Yol: `~/.config/opencode/plugins/opencode-multiagent.json`
+
+```json
+{
+  "flags": {
+    "profile": "strict"
+  },
+  "agentSettings": {
+    "planner": {
+      "steps": 300
+    }
+  }
+}
+```
+
+### Özel profil örneği
+
+```json
+{
+  "profiles": {
+    "sessiz": {
+      "observation": false,
+      "telemetry": false,
+      "supervision": false,
+      "quality_gate": false
+    }
+  },
+  "flags": {
+    "profile": "sessiz"
+  }
+}
+```
+
+### `opencode.json` içinde host taraflı MCP override
+
+Bir MCP sunucusunu açıkça etkinleştirmek veya değiştirmek istediğinizde host config kullanın:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-multiagent"],
+  "mcp": {
+    "github": {
+      "type": "local",
+      "command": ["npx", "-y", "@modelcontextprotocol/server-github"],
+      "environment": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "{env:GITHUB_PAT_TOKEN}"
+      },
+      "enabled": true
+    }
+  }
+}
+```
+
+## İlgili Dokümanlar
+
+- [Kullanım Kılavuzu](usage-guide.tr.md)
+- [Ajan Referansı](agents.tr.md)

package/docs/usage-guide.md

@@ -0,0 +1,224 @@
+> Language: **English** | [Turkish](usage-guide.tr.md)
+>
+> Back: [README](../README.md)
+
+# Usage Guide
+
+This guide covers the practical day-to-day use of `opencode-multiagent` as an OpenCode plugin.
+
+## 1. Install the Plugin
+
+Add the plugin to `opencode.json`:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-multiagent"]
+}
+```
+
+That is the smallest supported setup.
+
+Reference examples:
+
+- `examples/opencode.json`
+- `examples/opencode.with-overrides.json`
+
+## 2. What Happens When the Plugin Loads
+
+When OpenCode loads the package, the plugin:
+
+1. reads bundled defaults from `defaults/opencode-multiagent.json`
+2. reads user overrides from `~/.config/opencode/plugins/opencode-multiagent.json`
+3. builds the effective runtime flags and agent settings
+4. compiles bundled agent and command markdown into the active config
+5. injects plugin-owned MCP defaults only when the host config does not already define them
+6. prefers `planner` as the default top-level agent when available
+7. enables runtime hooks for telemetry, supervision, quality reminders, and the shared task board
+
+## 3. Normal User Flow
+
+In normal use, you do not need to pick worker agents manually. The system is designed so the
+top-level interaction goes through `planner`.
+
+Typical flow:
+
+```text
+user -> planner -> executor -> specialized subagents
+```
+
+### The main routing roles
+
+| Agent      | Role                                                                       |
+| ---------- | -------------------------------------------------------------------------- |
+| `planner`  | Owns triage, planning, challenge, inspection, and result integration.      |
+| `executor` | Runs the plan by dispatching bounded coding tasks and validating results.  |
+
+## 4. Triage Levels
+
+`planner` uses a tiered routing model.
+
+| Tier     | Meaning                                                  | Typical route                                |
+| -------- | -------------------------------------------------------- | -------------------------------------------- |
+| `Tier 0` | Trivial single-file work                                 | `planner -> executor -> coder`               |
+| `Tier 1` | Bounded work                                             | `planner -> executor -> coder/ui-coder/sec-coder` |
+| `Tier 2` | Complex multi-module work                                | `planner -> auditor -> executor -> coders`   |
+| `Tier 3` | Inspection                                               | `planner` (inspection mode)                  |
+
+As a user, the practical takeaway is simple: ask for the task naturally and let `planner` decide
+the route unless you have a strong reason to override the flow.
+
+## 5. Shared Task Board
+
+The plugin exposes three shared task tools:
+
+- `task_create`
+- `task_update`
+- `task_list`
+
+These are used internally by the agent system to track work, but they are also important to
+understand when reading logs or `.opencode` artifacts.
+
+### Task lifecycle
+
+Possible task states:
+
+- `pending`
+- `claimed`
+- `in_progress`
+- `completed`
+- `failed`
+- `blocked`
+
+### Persistence
+
+When a project root is available, the task board is persisted to:
+
+- `.opencode/tasks/taskboard.json`
+
+This makes multi-step execution easier to inspect after a session.
+
+## 6. Profiles
+
+The plugin ships three runtime profiles:
+
+| Profile    | When to use it                                                               |
+| ---------- | ---------------------------------------------------------------------------- |
+| `minimal`  | You want lower runtime overhead and fewer reminders/logs.                    |
+| `standard` | Normal default usage. Best starting point for most users.                    |
+| `strict`   | You want the strongest runtime controls and experimental transforms enabled. |
+
+Example user override file:
+
+```json
+{
+  "flags": {
+    "profile": "strict"
+  }
+}
+```
+
+## 7. Overriding Agent Defaults
+
+Use `~/.config/opencode/plugins/opencode-multiagent.json` for centralized plugin-level overrides.
+
+Example:
+
+```json
+{
+  "agentSettings": {
+    "planner": {
+      "steps": 300
+    },
+    "reviewer": {
+      "model": "anthropic/claude-opus-4-6"
+    }
+  }
+}
+```
+
+Use `opencode.json` when you want an explicit host-level override for a specific OpenCode field.
+
+Example:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-multiagent"],
+  "agent": {
+    "planner": {
+      "steps": 300
+    }
+  }
+}
+```
+
+## 8. MCP Servers
+
+Bundled MCP defaults:
+
+- `code_index`
+- `repo`
+- `context7`
+- `exa`
+- `gh_grep`
+- `github`
+
+Important behavior:
+
+- if the host config already defines one of these servers, the plugin does not overwrite it
+- `code_index` and `repo` are enabled by default
+- `context7`, `exa`, `gh_grep`, and `github` start disabled in bundled defaults
+
+### Enabling GitHub MCP
+
+Use `opencode.json` to explicitly enable it:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-multiagent"],
+  "mcp": {
+    "github": {
+      "type": "local",
+      "command": ["npx", "-y", "@modelcontextprotocol/server-github"],
+      "environment": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "{env:GITHUB_PAT_TOKEN}"
+      },
+      "enabled": true
+    }
+  }
+}
+```
+
+## 9. Logs and Generated Artifacts
+
+Common generated files and directories:
+
+| Path                                                  | Purpose                                              |
+| ----------------------------------------------------- | ---------------------------------------------------- |
+| `~/.config/opencode/logs/opencode-multiagent.jsonl`   | Observation and telemetry log                        |
+| `~/.config/opencode/plugins/opencode-multiagent.json` | User runtime overrides                               |
+| `.opencode/tasks/taskboard.json`                      | Shared task board persistence                        |
+| `.opencode/plans/`                                    | Durable plans created through planner and docmaster  |
+| `.opencode/exec/`                                     | Execution artifacts maintained during larger work    |
+
+## 10. Development Workflow
+
+If you are developing the plugin itself, the usual workflow is:
+
+```bash
+mise run setup
+mise run test
+mise run typecheck
+mise run validate-config
+mise run build
+```
+
+If `mise` is unavailable in your local shell, the equivalent direct commands are based on `bun`,
+`tsx`, and `tsc`.
+
+## Related Docs
+
+- [Configuration Reference](configuration.md)
+- [Agent Reference](agents.md)

package/docs/usage-guide.tr.md

@@ -0,0 +1,225 @@
+> Dil: [English](usage-guide.md) | **Türkçe**
+>
+> Geri: [README](../README.tr.md)
+
+# Kullanım Kılavuzu
+
+Bu kılavuz, `opencode-multiagent` eklentisinin günlük kullanımını pratik açıdan anlatır.
+
+## 1. Plugin Kurulumu
+
+`opencode.json` dosyasına plugin'i ekleyin:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-multiagent"]
+}
+```
+
+Bu, desteklenen en küçük kurulumdur.
+
+Referans örnekler:
+
+- `examples/opencode.json`
+- `examples/opencode.with-overrides.json`
+
+## 2. Plugin Yüklenince Ne Olur
+
+OpenCode paketi yüklediğinde plugin şu adımları uygular:
+
+1. `defaults/opencode-multiagent.json` içindeki varsayılanları okur
+2. `~/.config/opencode/plugins/opencode-multiagent.json` içindeki kullanıcı override'larını okur
+3. efektif runtime flag ve agent ayarlarını oluşturur
+4. paketlenmiş agent ve command markdown dosyalarını aktif config'e derler
+5. host config içinde yoksa plugin'e ait MCP varsayılanlarını ekler
+6. mümkünse `planner` ajanını varsayılan top-level ajan olarak tercih eder
+7. telemetry, supervision, quality reminder ve ortak task board hook'larını açar
+
+## 3. Normal Kullanım Akışı
+
+Normal kullanımda uzman ajanları elle seçmeniz gerekmez. Sistem, top-level etkileşimin `planner`
+üzerinden gitmesi için tasarlanmıştır.
+
+Tipik akış:
+
+```text
+kullanici -> planner -> executor -> uzman alt ajanlar
+```
+
+### Temel routing rolleri
+
+| Agent      | Rol                                                                                    |
+| ---------- | -------------------------------------------------------------------------------------- |
+| `planner`  | Talebi triage eder, route seçer, büyük işler için plan üretir, sonuçları inceler.     |
+| `executor` | Planı bounded uzman görevlerine bölerek uygular ve sonuçları doğrular.                |
+
+## 4. Triage Seviyeleri (Tier Modeli)
+
+`planner`, katmanlı bir routing modeli kullanır.
+
+| Tier     | Açıklama                                       | Rota                                          |
+| -------- | ---------------------------------------------- | --------------------------------------------- |
+| `Tier 0` | Küçük, açık işler                              | `planner -> executor -> coder`                |
+| `Tier 1` | Bounded işler                                  | `planner -> executor -> coder/ui-coder/sec-coder` |
+| `Tier 2` | Karmaşık çok modüllü işler                     | `planner -> auditor -> executor -> coders`    |
+| `Tier 3` | İnceleme                                       | `planner` (inspeksiyon modu)                  |
+
+Kullanıcı açısından pratik kural basittir: güçlü bir sebep yoksa görevi doğal şekilde tarif edin ve
+`planner` ajanının route seçmesine izin verin.
+
+## 5. Ortak Task Board
+
+Plugin üç ortak task aracı sunar:
+
+- `task_create`
+- `task_update`
+- `task_list`
+
+Bu araçlar ajan sistemi tarafından dahili olarak kullanılır; ancak log ve `.opencode` çıktılarının
+nasıl oluştuğunu anlamak için bilinmeleri faydalıdır.
+
+### Task yaşam döngüsü
+
+Olası task durumları:
+
+- `pending`
+- `claimed`
+- `in_progress`
+- `completed`
+- `failed`
+- `blocked`
+
+### Kalıcılık
+
+Bir proje kökü varsa task board şu dosyaya yazılır:
+
+- `.opencode/tasks/taskboard.json`
+
+Bu sayede çok adımlı yürütmeler oturum sonrasında da incelenebilir.
+
+## 6. Profiller
+
+Plugin üç runtime profili ile gelir:
+
+| Profil     | Ne zaman kullanılır                                                      |
+| ---------- | ------------------------------------------------------------------------ |
+| `minimal`  | Daha düşük runtime yükü ve daha az log/reminder istediğinizde            |
+| `standard` | Normal varsayılan kullanım; çoğu kullanıcı için en iyi başlangıç noktası |
+| `strict`   | En güçlü runtime kontrolleri ve experimental transform'lar gerektiğinde  |
+
+Örnek kullanıcı override dosyası:
+
+```json
+{
+  "flags": {
+    "profile": "strict"
+  }
+}
+```
+
+## 7. Agent Varsayılanlarını Override Etme
+
+Merkezi plugin düzeyi override için `~/.config/opencode/plugins/opencode-multiagent.json`
+kullanın.
+
+Örnek:
+
+```json
+{
+  "agentSettings": {
+    "planner": {
+      "steps": 300
+    },
+    "reviewer": {
+      "model": "anthropic/claude-opus-4-6"
+    }
+  }
+}
+```
+
+Belirli bir OpenCode alanını açıkça override etmek istediğinizde `opencode.json` kullanın.
+
+Örnek:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-multiagent"],
+  "agent": {
+    "planner": {
+      "steps": 300
+    }
+  }
+}
+```
+
+## 8. MCP Sunucuları
+
+Paketle gelen MCP varsayılanları:
+
+- `code_index`
+- `repo`
+- `context7`
+- `exa`
+- `gh_grep`
+- `github`
+
+Önemli davranışlar:
+
+- host config zaten aynı isimli sunucuyu tanımlıyorsa plugin onun üstüne yazmaz
+- `code_index` ve `repo` varsayılan olarak açıktır
+- `context7`, `exa`, `gh_grep` ve `github` paket varsayılanlarında kapalı başlar
+
+### GitHub MCP'yi etkinleştirme
+
+Bunu açıkça etkinleştirmek için `opencode.json` kullanın:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-multiagent"],
+  "mcp": {
+    "github": {
+      "type": "local",
+      "command": ["npx", "-y", "@modelcontextprotocol/server-github"],
+      "environment": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "{env:GITHUB_PAT_TOKEN}"
+      },
+      "enabled": true
+    }
+  }
+}
+```
+
+## 9. Loglar ve Üretilen Artifaktlar
+
+Sık görülen dosya ve dizinler:
+
+| Yol                                                   | Amaç                                                           |
+| ----------------------------------------------------- | -------------------------------------------------------------- |
+| `~/.config/opencode/logs/opencode-multiagent.jsonl`   | Observation ve telemetry logu                                  |
+| `~/.config/opencode/plugins/opencode-multiagent.json` | Kullanıcı runtime override dosyası                             |
+| `.opencode/tasks/taskboard.json`                      | Ortak task board verisi                                        |
+| `.opencode/plans/`                                    | `planner` ve `docmaster` tarafından yazılan kalıcı planlar     |
+| `.opencode/exec/`                                     | Büyük yürütmeler sırasında tutulan execution artifaktları      |
+
+## 10. Geliştirme Akışı
+
+Plugin'in kendisini geliştiriyorsanız tipik akış şöyledir:
+
+```bash
+mise run setup
+mise run test
+mise run typecheck
+mise run validate-config
+mise run build
+```
+
+Yerel shell ortamınızda `mise` yoksa aynı doğrulamalar `bun`, `tsx` ve `tsc` tabanlı komutlarla da
+çalıştırılabilir.
+
+## İlgili Dokümanlar
+
+- [Konfigürasyon Referansı](configuration.tr.md)
+- [Ajan Referansı](agents.tr.md)