npm package: @fatihkan/badi
Description: Claude Code kullanicilari icin profesyonel is akisi yonetim sistemi
Author: Fatih Kan
Latest version: 1.0.0

# Badi

Claude Code kullanicilari icin profesyonel is akisi yonetim sistemi. Gunluk islerinizi yapilandirin, uretkenliginizi arttirin, icerik uretin, kaliteyi koruyun.

## Ozellikler

- **21 Uzman Ajan** — Guvenlik, performans, kod inceleme, refactoring, mimari, icerik uretimi, proje planlama
- **50 Is Akisi Komutu** — Oturum yonetimi, dagitim, kalite kontrol, strateji, yazilim muhendisligi, icerik uretimi, proje mimarisi
- **11 Guvenlik Hook'u** — Otomatik yedekleme, tehlikeli komut engelleme, dal korumasi
- **21 Beceri Kategorisi** — 1000+ yapilandirilmis operasyonel prosedur
- **6 Katmanli Bellek** — Oturumlar arasi baglam koruma
- **Plugin Sistemi** — Ucuncu parti skill/agent/komut destegi
- **Icerik Uretim Araclari** — Sosyal medya, gorsel brief, video senaryo, takvim
- **Dashboard** — Gunluk istatistik ve uretkenlik takibi

## Kurulum

### Gereksinimler

- **Node.js 18+** ([indir](https://nodejs.org))
- **Git** (proje klonlamak icin)
- **Claude Code** CLI ([kurulum](https://docs.claude.com/claude-code))

### Secenek 1: GitHub'dan Klonlayarak (Onerilen)

Paket henuz npm'de yayinda degil. Repoyu klonlayip global kullanabilirsin:

```bash
# 1. Repoyu klonla
git clone https://github.com/fatihkan/badi.git
cd badi

# 2. Bagimliliklari yukle
npm install

# 3. Global komut olarak kullanilabilir hale getir
npm link
# Bu 'badi' komutunu global PATH'e ekler

# 4. Test et
badi --version
badi --help

# 5. Yeni bir projede kullan
cd /path/to/senin-projen
badi init
```

**Link'i kaldirmak icin:** `npm unlink -g @fatihkan/badi`

### Secenek 2: GitHub'dan Dogrudan npm Install

```bash
# Global kurulum
npm install -g github:fatihkan/badi

# Sonra kullan
badi init
```

### Secenek 3: Tek Seferlik Kullanim (npx ile)

```bash
# Klonlama gerekmez, direkt calistir
npx github:fatihkan/badi init
```

### Secenek 4: Yerel Kurulum (npm link olmadan)

```bash
git clone https://github.com/fatihkan/badi.git
cd badi
npm install

# Dogrudan node ile calistir
node bin/badi.js init --target /path/to/projen
```

### npm'de Yayinlamak (Paket Sahibi Icin)

Badi'yi npm registry'sine yayinlamak istersen:

```bash
# 1. npm hesabi olustur (varsa atla)
# https://www.npmjs.com/signup

# 2. npm'e giris yap
npm login

# 3. @fatihkan scope'unu dogrula
npm whoami
# fatihkan cikmali

# 4. package.json'da versiyonu kontrol et
cat package.json | grep version

# 5. Testleri calistir
npm test

# 6. Paket icerigini onizle
npm pack --dry-run

# 7. Yayinla
npm publish --access public --provenance
```

Yayindan sonra kullanicilar `npx @fatihkan/badi init` diyebilir.

### Kurulum Dogrulama

Kurulum basarili mi kontrol et:

```bash
# CLI erisimi
badi --version
# Cikti: badi v1.0.0

# Yeni bir proje olustur
mkdir test-proje && cd test-proje
badi init

# Dogrulama
badi doctor
# Tum kontroller GECTI cikmali

# Bilesenleri listele
badi list
# 21 agent, 50 komut, 11 hook gorunmeli
```

### Sorun Giderme

**`badi: command not found` hatasi:**
```bash
# npm link yapildigindan emin ol
cd /path/to/badi
npm link

# veya npm bin dizinini PATH'e ekle
export PATH="$(npm bin -g):$PATH"
```

**Hook scriptleri calismiyor:**
```bash
# Hook'lara executable izni ver
chmod +x .claude/hooks/*.sh
```

**`jq` bulunamadi hatasi:**
```bash
# macOS
brew install jq

# Linux (Debian/Ubuntu)
sudo apt install jq
```

## Hizli Baslangic

### Yazilim Projesi
```bash
badi init              # Projeyi yapilandir
# Claude Code'da:
/start                 # Gunluk seansi basla
/audit                 # Kalite denetimi
/wrap-up               # Gun sonu ozet
```

### Icerik Uretimi
```bash
badi icerik marka                    # Ilk kurulum: marka sesi
badi icerik basla                    # Sabah: bugun ne var?
badi icerik post "yeni urun"         # Hizli sablon
badi icerik durum                    # Ilerleme kontrolu
badi icerik kapat                    # Aksam: ozet + yarin icin
```

### Proje Planlamasi
```bash
# Claude Code'da:
/architect             # Fikri 5 dokumana donustur
/scaffold              # Kod iskelesi olustur
/spec-check            # Kod-spec uyum kontrolu
```

## CLI Komutlari

### Proje Yonetimi

```bash
badi init [--target DIR] [--force] [--dry-run]    # Proje yapilandir
badi update [--target DIR]                         # Guncelle (ozellestirmeleri korur)
badi doctor [--target DIR]                         # Kurulum dogrula
badi list [--agents|--commands|--hooks|--skills]    # Bilesen listele
badi plugin [install|remove|list]                   # Plugin yonet
badi --version                                      # Surum bilgisi
badi --help                                         # Yardim
```

### Icerik Uretimi — Oturum Yonetimi

`/start` tarzi gunluk icerik uretim rituelu icin komutlar:

```bash
# SABAH — Seansi baslat
badi icerik basla
# Bugunun temasini gosterir, bekleyen taslaklari listeler, oncelikler verir

# URETIM
badi icerik fikir post           # Yapilandirilmis fikir listesi
badi icerik post "yeni urun"     # Hizli sablon

# GUN ICINDE — Durumu kontrol et
badi icerik durum
# Envanter, tamamlanmislik orani, uyarilar

# HAFTALIK PLAN
badi icerik plan
# Gelecek haftanin tema haritasi, platform dagilimi

# DOSYA ACMA
badi icerik ac               # En son dosyayi gosterir
badi icerik ac marka         # Filtreli arama

# AKSAM — Seansi kapat
badi icerik kapat
# Bugun uretilenleri listeler, yarin icin hazirlik
```

### Icerik Uretimi (Hizli Sablonlar)

Sosyal medya icin hazir sablonlar terminal'den tek komutla olusturulur. Her sablon `.claude/workspace/` altinda dogru dizine yazilir:

```bash
# Sosyal medya post sablonu (3 varyasyon, hashtag, zamanlama)
badi icerik post "yeni urun lansman"

# Karousel (coklu kare) sablonu (7 kare, tasarim notlari)
badi icerik karousel "5 uretkenlik ipucu"

# Video senaryo (hook, sahneler, post-produksiyon)
badi icerik video "30 saniye tutorial"

# Gorsel brief (AI prompt, renk paleti, tipografi)
badi icerik gorsel "sabah rutini post"

# Icerik takvimi (tema haritasi, 4 hafta)
badi icerik takvim "2026-04"

# Marka sesi rehberi (tum icerik komutlari okur)
badi icerik marka

# Uretilen tum icerikleri listele
badi icerik list
```

**Uretilen dosyalar:**
- Post/karousel → `.claude/workspace/icerikler/YYYY-MM-DD-konu.md`
- Video senaryo → `.claude/workspace/senaryolar/YYYY-MM-DD-konu.md`
- Gorsel brief → `.claude/workspace/gorseller/YYYY-MM-DD-konu-brief.md`
- Icerik takvimi → `.claude/workspace/takvim/YYYY-MM-DD-takvim-donem.md`
- Marka sesi → `.claude/workspace/marka-sesi.md`

### Claude Code Slash Komutlari

Terminal sablonlari hizli baslangic icin. Tam interaktif is akisi icin Claude Code icinde slash komutlar kullanin:

```
/start           # Oturum baslat
/sync            # Baglam yenile
/audit           # Kalite denetimi
/review          # Kod incelemesi
/wrap-up         # Gun sonu

/icerik-basla    # Gunluk icerik seansi baslatici (start gibi)
/icerik-plan     # Haftalik icerik planlamasi
/icerik-durum    # Uretim durum paneli
/icerik-kapat    # Gun sonu kapanis rituelu
/icerik-fikir    # Fikir brainstorm seansi
/icerik-uret     # Interaktif icerik uretme
/gorsel-brief    # Gorsel yonetmenlik
/video-senaryo   # Video senaryo
/icerik-takvimi  # Icerik planlama
/marka-sesi      # Marka sesi tanimlama
/karousel        # Karousel olusturma

/architect       # Proje planlama (5 dokuman)
/spec-check      # Spesifikasyon uyum kontrolu
/scaffold        # Kod iskele
/refactor        # Yeniden duzenleme plani
/adr             # Mimari karar kaydi

/dashboard       # Gunluk istatistik paneli
/health          # Sistem saglik kontrolu
/doctor          # Konfigurasyon dogrulamas
```

Tam komut listesi icin `.claude/command-index.md` dosyasina bakin.

## Dizin Yapisi

```
.claude/
  agents/       21 uzman ajan tanimi
  commands/     50 is akisi komutu
  references/    8 proje planlama rehberi (design patterns, tech stack, vb.)
  hooks/        11 guvenlik ve otomasyon hook'u
  skills/       21 kategori, 1000+ beceri
  workspace/    Gorev panosu, gunluk notlar, uretilen icerikler
    icerikler/   Post ve karousel sablonlari
    senaryolar/  Video senaryolari
    gorseller/   Gorsel briefler
    takvim/      Icerik takvimleri
    marka-sesi.md
  plugins/      Ucuncu parti eklentiler
  settings.json  Hook konfigurasyonu
  memory.md      Aktif oturum bellegi
  knowledge-base.md
  command-index.md
```

## Ajanlar

### Yazilim Muhendisligi
| Ajan | Rol |
|------|-----|
| auditor | Kalite guvence kapisi |
| security-scanner | Guvenlik acigi tespiti |
| performance-profiler | Performans analizi |
| test-strategist | Test strateji planlama |
| api-designer | API tasarim |
| migration-pilot | Goc planlama |
| archaeologist | Kod gecmisi arastirmasi |
| error-whisperer | Hata teshis |
| debt-collector | Teknik borc tarama |
| code-generator | Kod iskele ve sablon uretimi |
| refactoring-advisor | Refactoring danismanligi |
| architecture-advisor | Mimari tasarim ve ADR |
| project-architect | Proje planlama ve 5 dokuman uretimi |

### Icerik Uretimi
| Ajan | Rol |
|------|-----|
| content-creator | Sosyal medya icerik uretimi |
| visual-director | Gorsel brief ve AI prompt |

### Destek ve Kocluk
| Ajan | Rol |
|------|-----|
| coach | Veri odakli kocluk |
| onboarding-sherpa | Proje alistirma |
| pr-ghostwriter | PR dokumantasyonu |
| rubber-duck | Dusunce partneri |
| unsticker | Tikaniklik cozme |
| yak-shave-detector | Kapsam kaymasi tespiti |

## Icerik Uretim Is Akisi

### Ilk Kurulum (bir kere)
```bash
# 1. Marka sesini tanimla
badi icerik marka
# .claude/workspace/marka-sesi.md dosyasini doldur

# 2. Haftalik plan yap
badi icerik plan
# Tema haritasini gor, takvim olustur
badi icerik takvim "2026-04"
```

### Gunluk Ritel (CLI)
```bash
# Sabah
badi icerik basla       # Bugun ne yapacagim? (tema, oncelikler, bekleyenler)

# Uretim
badi icerik fikir post  # Fikir ara
badi icerik post "secilen fikir"
badi icerik karousel "5 urun ipucu"
badi icerik video "15 saniye hook"

# Kontrol
badi icerik durum       # Ne kadar ilerledim?

# Aksam
badi icerik kapat       # Bugun ne yaptim? Yarin icin ne kaldi?
```

### Detayli Uretim (Claude Code icinde)
Hizli CLI sablonlar baslangic icin. Tam interaktif akis icin Claude Code'da:
- `/icerik-basla` — Marka sesi okunarak kisisel seans
- `/icerik-plan` — Haftalik stratejik planlama
- `/icerik-durum` — Detayli istatistik raporu
- `/icerik-kapat` — Ogrenim ve bilgi adaylari
- `/icerik-fikir` — Marka odakli brainstorm
- `/icerik-uret` — Platform bazli varyasyonlar
- `/karousel` — Kare kare tasarim + AI prompt
- `/video-senaryo` — Sahne sahne senaryo
- `/gorsel-brief` — AI gorsel prompt'lari

## Gelistirme

```bash
npm install
npm test        # 48 test
npm run lint
npm run format
```

## Testler

- **48 test** — CLI, hooks, icerik uretimi (oturum + sablonlar), doctor, update, list, plugin
- Tum testler Node.js native test runner kullanir
- Hicbir dis test bagimliligi yok

## Surum

v1.0.0 — Ilk genel surum

## Lisans

MIT - Fatih Kan

## Katkida Bulunma

`CONTRIBUTING.md` dosyasina bakiniz.