development-team

Claude Code Yazılım Ekibi Template

Claude Code için hazır multi-agent yazılım geliştirme ekibi. Tek komutla indir, hemen başla.

Version: 7.0.1

---

🚀 Hızlı Başlangıç

Tek Komut

npx degit erhankaraarslan/agent_yazilim_ekibi my-project
cd my-project
claude

Bu kadar! Artık 12 agent, 20+ skill ve tüm hook'lar hazır.

Projeyi Başlat

Claude Code'da:

initializer agent'ı çağır: [PROJE AÇIKLAMASI]

Örnek:

initializer agent'ı çağır: E-ticaret API'si.
Tech: Node.js + Express + PostgreSQL.
Modüller: Auth, Products, Orders.

---

📦 Ne İçeriyor?

12 Uzman Agent

Agent	Model	Rol
initializer	opus	Proje başlatma, feature list
architect	opus	Mimari tasarım, ADR
code-reviewer	opus	Kod review (read-only)
security-engineer	opus	Güvenlik audit (read-only)
backend-developer	sonnet	API, business logic
frontend-developer	sonnet	UI, components
database-admin	sonnet	Schema, migration
qa-engineer	sonnet	Test stratejisi
devops-engineer	sonnet	CI/CD, deployment
product-manager	sonnet	User story, feature
tech-writer	sonnet	Dokümantasyon
progress-tracker	sonnet	İlerleme takibi

20+ Skill

• coding-standards - Kodlama kuralları
• api-design - RESTful API standartları
• testing-standards - Test yazım kuralları
• git-workflow - Git branch/commit
• session-handoff - Session geçişi
• feature-tracking - Feature list yönetimi
• incremental-coding - Tek feature odaklı çalışma
• smart-compaction - Context yönetimi
• error-recovery - Hata çözümleme
• ... ve daha fazlası

14 Hook Event

• SessionStart - Session başlangıç kontrolü
• PreToolUse - Tehlikeli komut engelleme
• PostToolUseFailure - Hata loglama
• PreCompact - Context kaydetme
• Stop - Clean state kontrolü
• ... ve daha fazlası

7 MCP Server (Opsiyonel)

• PostgreSQL, Redis, Filesystem, Memory, Slack, Sentry, Puppeteer

---

📁 Yapı

my-project/
├── .claude/
│   ├── agents/         # 12 agent tanımı
│   ├── skills/         # 20+ skill
│   ├── rules/          # Coding rules
│   └── settings.json   # Hooks & permissions
├── .mcp.json           # MCP server config
├── CLAUDE.md           # Proje hafızası (HER SESSION OKU!)
├── feature-list.json   # Feature tracking
└── docs/               # Dokümantasyon

---

🔄 Güncelleme

Template güncellemelerini almak için:

# Sadece .claude/ klasörünü güncelle
npx degit erhankaraarslan/agent_yazilim_ekibi/.claude .claude --force

Not: Bu komut .claude/ klasörünü en son versiyonla değiştirir. Kendi yaptığın özelleştirmeler varsa yedekle.

---

📖 Kullanım

Agent Çağırma

# Mimari karar
architect agent'ı çağır, database seçimi yapalım

# Kod review
code-reviewer agent'ı çağır, son değişiklikleri incele

# Güvenlik kontrolü
security-engineer agent'ı çağır, auth modülünü tara

# Test yazımı
qa-engineer agent'ı çağır, login için test yaz

Session Yönetimi

# Session sonunda
session-handoff skill'ini çalıştır

# Yeni session'da
CLAUDE.md'yi oku ve kaldığım yerden devam et

Feature Tracking

# Feature listesini gör
cat feature-list.json

# Tamamlanan feature'ı işaretle
feature-list.json'da F001'i passes: true yap

---

⚠️ Önemli Kurallar

1. Her session başında CLAUDE.md oku
2. Tek feature'a odaklan - Aynı anda birden fazla feature'a başlama
3. Test etmeden tamamlama - Feature'ı passes: true yapmadan önce test et
4. feature-list.json'ı koru - Sadece passes, status, notes değiştir

---

📚 Dokümantasyon

• Proje Başlatma Rehberi
• Enterprise Overview
• Mimari Detaylar

---

🏆 Anthropic Best Practices

Bu template, Anthropic'in yayınladığı makalelerdeki best practice'leri uygular:

• Effective Harnesses for Long-Running Agents
• Building Effective Agents
• Claude Code Best Practices

---

📄 Lisans

MIT - Serbestçe kullanılabilir ve değiştirilebilir.

---

Author: Erhan Karaarslan
Repository: https://github.com/erhankaraarslan/agent_yazilim_ekibi