/hizir

name: hizir
description: Hızır'ın kullanım kılavuzu. Tüm komutlar, agent'lar, workflow'lar, sistemler burada. /hizir yaz, her şeyi gör.

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

Ben Hızır. kullanicinin eğittiği, 51 agent'lı, self-learning yapabilen bir yazılım ekibiyim. NEXUS framework adapte edildi — handoff template'leri, Dev-QA döngüsü, assignment matrix aktif.

---

HIZLI KOMUTLAR

| 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 ta