🎯 UniAgents

Claude Code'a rol-bazlı bir yazılım ekibi kur. /uni ile doğal dilde yaz; Tech Lead işi parçalar, doğru rollere dağıtır, doğrulamadan geçirir, sana tek konsolide rapor verir.

› /uni "stok raporuna tarih aralığı filtresi ekle"

🎯 [TECH LEAD]  Plan: 3 adım · 2 rol. Hafıza yüklendi, başlıyoruz.
📚 [HAFIZA]     uniagents vault · 9 dosya · 24 KB — ilgili karar + son run'lar.
🔎 [ANALYST] →  Filtre kuralı StokRaporController.cs:142'de; tarih DTO mevcut.
⚡ [BACKEND] →  Endpoint'e tarih parametresi eklendi. Build temiz, 0 warning.
🎨 [FRONTEND] → Date-range picker + locale. Layout ve a11y kontrol edildi.
🔍 [QA] →       4 edge case kapsandı. Regression yeşil.
🎯 [TECH LEAD]  ✅ Merge'e hazır · run-log .uniagents/runs/'a yazıldı.

Kurulum

npx uniagents init

/uni slash komutunu ve 10 global crew rolünü ~/.claude'a kurar. Sonra Claude Code'u yeniden başlat (subagent'lar oturum başında yüklenir).

uniagents status     # neyin kurulu olduğunu göster
uniagents remove     # kurulanları geri al

| Bayrak | Ne yapar | |---|---| | --project [dir] | global ~/.claude yerine projeye kur (<dir>/.claude) | | --all-roles | project-specific rolleri de kur (ör. Finance Auditor) | | --link | kopya yerine symlink (yerel geliştirme) | | --dry-run | hiçbir şey yazmadan ne yapacağını göster |

Gereksinim: Claude Code + Node.js ≥ 18.

İlk kullanım

Bağlı bir projede:

/uni "<doğal dilde isteğin>"

Tech Lead hafızayı yükler, planı kurar, işi doğru rollere dağıtır, doğrulama zincirinden geçirir ve tek rapor verir. Çıktı rol-etiketli blok formatındadır (🎯 [TECH LEAD] …).

Ekip

| | Rol | Sorumluluk | Slug | |---|---|---|---| | 🎯 | Tech Lead | Orkestrasyon — parçalama, dağıtma, raporlama | tech-lead | | 🧭 | Product Strategist | Açık-uçlu istekte yaklaşım/değer (ideation lideri) | product-strategist | | ⚡ | Senior Backend | API, service, DI, async | backend-engineer | | 🎨 | Senior Frontend | UI, view, animasyon, locale, a11y | frontend-engineer | | 💾 | Database Engineer | SQL, query opt, migration, cache | database-engineer | | 🚢 | DevOps Engineer | Build, deploy, CI, env, secret, rollback | devops-engineer | | 🔍 | QA Engineer | Test, regresyon, edge case; judge/critic | qa-engineer | | 🔎 | Research Analyst | Kod/dosya keşfi, iş kuralı haritası | research-analyst | | 🛡️ | Security Engineer | OWASP white-box; IDOR, injection, secret | security-engineer | | 🧹 | Code Auditor | Clean-code & mimari skor, sert veto | code-auditor | | 📊 | Finance Auditor | Finansal denetim (proje-opt-in) | finance-auditor |

Her rolün CV'si crew/<slug>.md dosyasında. Tech Lead isteğin anahtar kelimelerine göre doğru rolü subagent olarak çağırır.

Nasıl çalışır

/uni "<istek>" → Tech Lead sırayla: hafıza yükle (.uniagents/ vault) → manifest oku → state aç → plan → crew'a dağıt → doğrulama zinciri (build · lint · test · /review · /security-review) → konsolide rapor + run-log.

Tam çerçeve (dashboard + manifest + merkezi yönetişim)

npx uniagents init ekibi Claude Code'a kurar. Canlı dashboard, proje manifest'leri ve merkezi yönetişim için çerçeveyi klonla:

git clone https://github.com/Cloud1907/agent-ofis.git ~/uniagents
cd ~/uniagents
./bin/uniagents-kurulum          # symlink (~/.claude) + Python venv
export UNIAGENTS_HOME="$HOME/uniagents"
export PATH="$UNIAGENTS_HOME/bin:$PATH"

uniagents-dashboard              # http://localhost:7777
uniagents-baglat /path/to/proje  # yeni proje bağla (manifest + .uniagents vault)

• Manifest (projects/<isim>.yml) her projenin tek kanonik kuralı: crew, routing, forbidden, validation, conventions, enforcement. Şablon: projects/_SCHEMA.yml.
• Yönetişim (ADR-0007): gate kararı yalnız manifest + tool çıktısından türer. Risk-tier (auth/env/migration/deps → otomatik risky), modlar (gradual/enforced/full), Definition of Done (CI yeşil + gate approved olmadan completed yok).
• Hafıza: her bağlı projede .uniagents/ vault — decisions/ (ADR), runs/, sprints/, MEMORY.md (topic → pointer indeksi). Obsidian uyumlu.
• Detay: docs/CENTRAL-SETUP.md.

Dokümantasyon

Dokümantasyon sitesi site/ altında (Astro):

npm run site:dev      # localhost:4321
npm run site:build    # site/dist → statik yayın

İçerik: Hızlı başlangıç · Kullanım · Ekip & roller · Mimari & yönetişim.

Sorun giderme

| Sorun | Çözüm | |---|---| | /uni görünmüyor | Claude Code'u yeniden başlat · ls ~/.claude/commands/uni.md | | Roller subagent listesinde yok | Yeniden başlat · ls ~/.claude/agents/ · gerekiyorsa uniagents init | | bin/ script "operation not permitted" | macOS quarantine (zip/WhatsApp ile geldiyse): xattr -dr com.apple.quarantine . | | Dashboard 7777'de açılmıyor | lsof -ti:7777 \| xargs kill sonra tekrar başlat |

Lisans

MIT.