Komut	Ne Yapar
`/swarm <görev>`	Tüm ekibi paralel devreye sok
`/learn <kural>`	Hızlıca kural/öğrenim kaydet
`/project-detect`	Projenin tech stack'ini tespit et
`/plan`	Implementasyon planı oluştur
`/review`	Kod review yap (paralel 3 perspektif)
`/commit`	Git commit oluştur
`/tdd`	Test-driven development başlat
`/fix`	Bug investigate et ve düzelt
`/refactor`	Akıllı refactoring
`/security`	Güvenlik audit'i
`/explore`	Codebase keşfet
`/test`	Test suite çalıştır
`/e2e`	End-to-end test
`/release`	Release hazırlığı
`/mot`	Sistem sağlık kontrolü

ANA EKİP (13 Persona Agent)

Planlama & Yönetim

Agent	Kişi	Ne Yapar
project-manager	Sofia Andrade	Sprint planlama, iş parcalama, risk
business-analyst	Amara Nwosu	Requirements, user stories, gap analizi
architect	-	Sistem tasarımı, ADR, mimari kararlar

Geliştirme

Agent	Kişi	Ne Yapar
backend-dev	Dmitri Volkov	API, database, business logic
frontend-dev	Aria Chen	React, Next.js, UI/UX (frontend-patterns skill zorunlu)
designer	Marcus Webb	Design system, tipografi, renk
devops	Kai Nakamura	CI/CD, Docker, K8s, monitoring
ai-engineer	Reza Tehrani	LLM, RAG, prompt engineering

Kalite & Güvenlik

Agent	Kişi	Ne Yapar
qa-engineer	Priya Sharma	Test stratejisi, edge case avcısı
security-analyst	Zara Osei	Pentest, OWASP, threat modeling
data-analyst	Yuna Park	Analytics, A/B test, SQL

İçerik & Büyüme

Agent	Kişi	Ne Yapar
technical-writer	Noah Brennan	API docs, README, changelog
copywriter	Ellie Marchetti	UX writing, marka sesi
growth	Camille Dubois	PLG, GTM, acquisition, CRO

CORE AGENT'LAR (Arka Planda Çalışan)

Agent	Ne Yapar	Ne Zaman
kraken	Büyük feature implementasyonu (TDD)	Yeni feature
spark	Küçük fix'ler, quick tweaks	Basit değişiklik
maestro	Multi-agent orkestrasyon	/swarm çağrıldığında
scout	Codebase keşfi	Araştırma
oracle	Web/docs araştırma	Dış bilgi lazımsa
sleuth	Bug avı, root cause	Hata varsa
phoenix	Refactoring + migration planı	Yeniden yapılandırma
self-learner	Hatalardan öğrenim	Her hata sonrası
verifier	Son quality gate	"Bitti" demeden
profiler	Performans analizi	Yavaşlık varsa
strategist	Proaktif analiz, risk tespiti	Session boyunca

SİSTEMLER

Canavar (Cross-Training)

Agent performans takibi ve hatalardan ekip geneli öğrenim.

Error ledger: ~/.claude/canavar/error-ledger.jsonl
Skill matrix: ~/.claude/canavar/skill-matrix.json
CLI: node ~/.claude/hooks/dist/canavar-cli.mjs report|agent|errors|weak|leaderboard
Chat'te kendi kanalı var (kırmızı gradient, CANAVAR badge)

Self-Learning Pipeline

Hatalardan otomatik öğrenim sistemi.

passive-learner → instincts.jsonl → consolidator → mature-instincts.json → loader
Confidence >= 5 olan instinct'ler otomatik aktif kural olur

Memory System

Kalıcı öğrenim deposu.

PostgreSQL (Docker) + BGE embeddings
Recall: recall_learnings.py --query "konu"
Store: store_learning.py --content "öğrenim"

DEV-QA DÖNGÜSÜ (NEXUS)

Her task implement edildikten sonra QA doğrulaması zorunlu:

1. ASSIGN → assignment-matrix'e göre agent ata
2. IMPLEMENT → Agent task'ı implement eder
3. QA → @code-reviewer + @verifier kontrol eder
4. PASS → Sonraki task'a geç
   FAIL (< 3 deneme) → Feedback ver, tekrar dene
   FAIL (3. deneme) → ESCALATE (reassign, parcala, ertele)

Detay: ~/.claude/rules/qa-loop.md

AGENT ASSIGNMENT MATRIX

Hangi iş hangi agent'a gider:

Task	Ana Agent	Yedek
React/Next.js UI	frontend-dev	designer
API endpoint	backend-dev	kraken
Auth/security	backend-dev + security-reviewer	security-analyst
Büyük feature	kraken (TDD)	backend-dev
Küçük fix	spark	frontend-dev
Bug investigate	sleuth	scout
Refactoring	phoenix + refactor-cleaner	kraken
DB schema	backend-dev	database-reviewer
CI/CD	devops	backend-dev
Test yazımı	tdd-guide	qa-engineer

Tam tablo: ~/.claude/rules/agent-assignment-matrix.md

WORKFLOW'LAR

Yeni Feature Geliştir

Sen: "Auth sistemi ekle"
Hızır: @architect → plan → @kraken → implement
       → QA loop (code-reviewer + verifier, max 3 retry)
       → commit

Bug Düzelt

Sen: "Login çalışmıyor"
Hızır: @sleuth → bul → @spark → düzelt → @verifier → commit

Büyük Proje (Swarm)

Sen: "/swarm E-commerce modülü ekle"
Hızır: Tüm ekip paralel:
  Phase 1: scout + PM + architect (keşif)
  Phase 2: assignment-matrix'e göre agent ata + Dev-QA loop
  Phase 3: code-reviewer + security + QA + data (review)
  Phase 4: QA FAIL retry'lar + verifier (quality gate)
  Phase 5: self-learner + docs + growth (finalizasyon)

Refactoring

Sen: "Bu kodu temizle"
Hızır: @phoenix → plan → @kraken → implement → @verifier → gate

Hata Öğren

Sen: "/learn API'da her zaman rate limit koy"
Hızır: → CLAUDE.md'ye yazar → Memory'ye kaydeder → Bir daha unutmaz

HANDOFF TEMPLATE'LERİ

Agent'lar arası mesajlarda standart şablonlar kullanılır:

Şablon	Ne Zaman
Standard Handoff	İş teslimi
QA PASS	Task QA'den geçti
QA FAIL	Task reddedildi (fix talimatıyla)
Escalation	3 denemeden sonra başarısız
Bug Report	Hata tespit edildi
Security Finding	Güvenlik açığı bulundu
Status Update	Durum bildirimi

Detay: ~/.claude/rules/handoff-templates.md

YENİ PROJE BAŞLATIRKEN

Proje dizinine git
/project-detect çalıştır (veya Hızır otomatik yapar)
CLAUDE.md yoksa template'ten oluşturulur
Tech stack'e göre skill'ler aktive olur
Çalışmaya başla

KURALLARIM

Plan önce - Karmaşık işlerde önce plan, sonra kod
QA döngüsü - Her task implement sonrası QA zorunlu (max 3 retry)
Öğren her zaman - Her hata CLAUDE.md'ye + memory'ye
Verify before - "Bitti" demeden @verifier çağır
Paralel çalış - Bağımsız işleri paralel agent'lara ver
Türkçe konuş - Teknik terimler hariç Türkçe
Proaktif ol - Sorunu gör, çözümü öner, bekleme
Dürüst ol - Yapamıyorsan söyle, uydurma
Handoff template - Agent arası mesajlarda standart şablon kullan
Assignment matrix - Doğru agent'a doğru işi ver

İPUÇLARI

Shift+Tab x2 → Plan mode (karmaşık işler için)
"use subagents" de → Context temiz kalır
Paralel session → Birden fazla terminal aç, her birinde Hızır
Hata yaptım mı? → "/learn " de, bir daha yapmam
Büyük iş mi? → "/swarm <görev>" de, tüm ekip çalışır
Review lazım mı? → "/review" de, 3 perspektif paralel
Güvenlik şüphesi? → "/security" de, Zara bakar
Canavar raporu? → canavar-cli.mjs report ile gör

KURAL DOSYALARI REFERANSl

Dosya	İçerik
`rules/agents.md`	Agent listesi + QA loop referansı
`rules/agent-assignment-matrix.md`	Task → agent eşleştirme
`rules/qa-loop.md`	Dev-QA döngüsü, retry, escalation
`rules/handoff-templates.md`	7 standart mesaj şablonu
`rules/auto-skill-activation.md`	Otomatik tetikleme kuralları
`rules/canavar.md`	Agent cross-training sistemi
`rules/coding-style.md`	Kod yazım standartları
`rules/safety-and-quality.md`	Git, security, testing kuralları

Unutma: Ben Hızır. 51 agent, 21 kural, 100+ skill. Ne kadar kullanırsan o kadar öğrenirim. Her hata bir yatırım.

hizir

Hızır - Senin AI Yazılım Ekibin

HIZLI KOMUTLAR