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)
• Git (proje klonlamak icin)
• Claude Code CLI (kurulum - GitHub)

Secenek 1: npm'den Kurulum (Onerilen)

Paket npm'de yayinda: @fatihkan/badi

# Tek seferlik kullanim (en hizli)
npx @fatihkan/badi init

# veya global kurulum
npm install -g @fatihkan/badi
badi init

Secenek 2: GitHub'dan Dogrudan

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

# veya tek seferlik
npx github:fatihkan/badi init

Secenek 3: Gelistirme Icin Klonla (Katkida Bulunmak Icin)

Kodu degistirmek veya katkida bulunmak istersen:

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

# 2. Bagimliliklari yukle
npm install

# 3. Global komut olarak linkle
npm link
# Bu 'badi' komutunu global PATH'e ekler, kod degisikliklerin anlik yansir

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

# 5. Testleri calistir
npm test

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

Yeni Surum Yayinlama (Paket Sahibi Icin)

Badi'ye yeni ozellik ekleyip surum cikarmak istersen:

# 1. Testleri calistir
npm test

# 2. Versiyonu yukselt
npm version patch   # 1.0.0 -> 1.0.1 (bug fix)
npm version minor   # 1.0.0 -> 1.1.0 (yeni ozellik)
npm version major   # 1.0.0 -> 2.0.0 (kirilma degisikligi)

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

# 4. Yayinla (npm hesabi ve 2FA gerekli)
npm publish --access public

# 5. GitHub'a push et
git push origin main --tags

Kurulum Dogrulama

Kurulum basarili mi kontrol et:

# 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:

# 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:

# Hook'lara executable izni ver
chmod +x .claude/hooks/*.sh

jq bulunamadi hatasi:

# macOS
brew install jq

# Linux (Debian/Ubuntu)
sudo apt install jq

Hizli Baslangic

Yazilim Projesi

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

Icerik Uretimi

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

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

CLI Komutlari

Proje Yonetimi

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:

# 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:

# 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)

# 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)

# 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

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.