open-multi-agent

open-multi-agent, terminal öncelikli, lead tabanlı geliştirme için tasarlanmış bir OpenCode pluginidir. Açık rol sınırları, komut orkestrasyonu, araç katalogları ve workspace destekli plan durumu ile küçükten büyüğe her ölçekte çalışmayı sürdürülebilir şekilde yürütür.

Ürün nedir

OpenCode plugin arayüzü üzerine inşa edilmiş çoklu-agent orkestrasyon sistemi. Her kullanıcı isteği üç katmanlı bir yönetici hiyerarşisinden geçer — cto (stratejik), lead (kullanıcıya dönük), sub-lead (operasyonlar) — ve açık bir katalogtaki gömülü uzmanlara (kodlayıcılar, araştırmacılar, reviewers, test uzmanları, güvenlik denetçileri ve daha fazlası) dağılır. Tüm plan durumu .agent/plans/ ve .agent/roadmap/ dizinlerinde saklanır; böylece workspace, oturumlar arasında kalıcı bir belleğe sahip olur.

• İngilizce README: README.md
• Plugin şeması: schemas/open-multi-agent.schema.json
• Yapılandırma şablonu: templates/open-multi-agent.jsonc

v2 genel komut yüzeyi

| Komut | Aracı | Açıklama | | ------------------- | ----- | ---------------------------------------------------------------------------------------------------- | | /plan | lead | Kapsamı, boşlukları ve kısıtları analiz eder; .agent/plans/active.md içinde kalıcı bir plan üretir | | /implement | lead | Aktif planı okur, hazırlığı doğrular, sub-lead ve kodlayıcı aracılara dağıtır | | /validate | lead | En küçük yeterli proje doğrulamasını çalıştırır (build, test, lint, typecheck, format) | | /roadmap | cto | Çok fazlı bir yol haritası, kilometre taşları ve bağımlılık eşlemi tanımlar | | /roadmap-status | cto | Mevcut yol haritası fazını, ilerlemeyi ve engelleri özetler | | /roadmap-continue | cto | Mevcut yol haritası fazındaki kalan maddeleri sıralı olarak yürütür |

Yeniden tasarlanacak komutlar

/review, /status, /analyze — bu komutlar hâlâ kullanılabilir durumda ancak gelecek bir sürümde yeniden sınıflandırılacak veya değiştirilecektir.

Yalnızca dahili komutlar

/audit, /quality-gate, /instinct-status, /projects, /git-clean — bunlar dahili uzmanlara yönlendirilir ve kararlı genel yüzeyin parçası değildir.

Yol haritası / plan / implement / validate akışı

/roadmap → cto
    ↓ fazları ve kilometre taşlarını tanımlar → .agent/roadmap/roadmap.md + roadmap.json

/plan → lead
    ↓ repo taraması → boşluk analizi → danışman → doğrulayıcı
    → .agent/plans/active.md (isimli planlar: .agent/plans/<isim>/active.md)

/implement → lead
    ↓ aktif planı okur → hazırığı doğrular
    → EXECUTE modu → sub-lead dağıtımı → kodlayıcı aracılar (sıralı veya sınırlı paralel)
    → update_plan_task → tamamlama / arşivleme

/validate → lead
    ↓ proje türünü algıla → en küçük yeterli doğrulama kapsamı
    → build / test / lint / typecheck / format-check
    → hata sınıflandırması → düzeltme

İsimli planlar, aktif planla aynı yaşam döngüsünü takip eder ancak .agent/plans/<plan-name>/ altında saklanır.

Üst düzey aktör topolojisi

cto (yönetici)
├── Yol haritası ölçeğinde koordinasyon
├── Yetki devri: sub-lead, internal-plan-advisor, internal-plan-validator,
│                internal-roadmap-writer, internal-docs, internal-gitmaster
└── Arka plan görevlerinin sahibi (lead ile birlikte)

lead (kullanıcıya dönük)
├── Tüm genel komutlar (/plan, /implement, /validate, /roadmap*)
├── Kalite kapıları ve normalizasyon
└── Arka plan görevlerinin sahibi (cto ile birlikte)

sub-lead (operasyonlar)
├── Sınırlı iş dağıtımı kodlayıcı aracılara
├── Yönlendirme: internal-coder-*, internal-reviewer, internal-tester,
│                internal-debugger, internal-build-resolver
└── Arka plan görevi sahibi değildir; bu talepleri lead veya cto üzerinden yürütür

Kodlayıcı ailesi

| Aracı | Kapsam | | --------------------------- | ------------------------------------- | | internal-coder-small | 2 dosya / 300 satır maks. | | internal-coder-medium | 6 dosya / 1 500 satır maks. | | internal-coder-strong | 15 dosya / 5 000 satır maks. | | internal-coder-ultrabrain | 30 dosya / 10 000 satır maks. | | internal-coder-ui-low | UI düzeltmeleri (2 dosya / 500 satır) | | internal-coder-ui-high | Karmaşık UI (8 dosya / 3 000 satır) |

İş akışı uzmanları

internal-plan-advisor · internal-plan-validator · internal-reviewer · internal-tester · internal-debugger · internal-build-resolver · internal-security-reviewer · internal-architect · internal-e2e-runner · internal-harness-optimizer · internal-gitmaster · internal-docs · internal-coder-helper

Keşifçiler

internal-explorer-low · internal-explorer-medium · internal-research (web araçları etkin)

Yapılandırma v2 referansı

Yapılandırma dosyası konumları (birini kullanın):

• ~/.config/opencode/open-multi-agent.jsonc
• .opencode/open-multi-agent.jsonc

Minimal v2 yapılandırması:

{
  "$schema": "https://opencode.ai/config.json",
  "version": 2,
  "plugin": ["open-multi-agent@latest"],
}

Temel v2 bölümleri:

{
  "version": 2,
  "agent": {
    "lead": { "promptExtension": { "prepend": "...", "append": "..." }, "disabledTools": ["..."] },
    "cto": { "model": "claude-sonnet" },
  },
  "workflow": {
    "hookProfile": "standard",
    "orchestration": {
      "maxParallelAgents": 3,
      "timeoutMs": 300000,
      "retryPolicy": "exponential",
    },
  },
  "memory": { "enabled": true, "directory": ".opencode/.memory" },
  "github": { "remote": "origin" },
  "mcp": { "context7": { "enabled": true } },
  "disabledTools": { "global": ["..."], "perAgent": { "internal-coder-small": ["..."] } },
  "commandSurface": {
    "allowDangerousCommands": false,
    "restrictedCommands": ["rm -rf"],
    "requireConfirmation": ["git push --force"],
  },
}

Tam şema için bkz. schemas/open-multi-agent.schema.json ve taşıma notları için docs/adr/ADR-008-config-schema-v2.md.

Hızlı başlangıç

1) Plugini kaydet

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["open-multi-agent@latest"]
}

Bu depoda yerel geliştirme yaparken .opencode/plugins/open-multi-agent.ts kullanılır:

export { plugin as OpenMultiAgentPlugin } from '../../src/index.ts';

2) Plugin yapılandırması ekle

~/.config/opencode/open-multi-agent.jsonc veya .opencode/open-multi-agent.jsonc oluşturup version: 2 belirtin. Şablon: templates/open-multi-agent.jsonc

3) Plugin yüklenmesini doğrula

opencode debug config

Çıktıda resolved plugin list içinde plugin girdisini arayın.

4) Yerel çalışma

bun install
mise run build

Doküman hub

• Kullanıma başlangıç
• Mimari
• Komutlar ve plan akışı
• Yapılandırma
• ADR: Aktör hiyerarşisi
• ADR: Yapılandırma şeması v2
• Katkı rehberi
• Sürüm notları

Geliştirme kontrolleri

mise run build
mise run test
mise run typecheck
mise run lint
mise run format

Doğrudan karşılıkları:

bun build ./src/index.ts --outdir dist --target bun
bun test
tsc --noEmit
eslint .
prettier --check .