Kod Fabrikası — Fábrica de Software com Claude
mustafacaglarkara/claude-skill-kod-fabrikasi
Desenvolvimento faseado com IA, documentação automática e sincronização Git
Ver no GitHubSkill que implementa um fluxo de desenvolvimento estruturado em fases, integrando NotebookLM para documentação automática, Graphify para mapeamento arquitetural e Git hooks para sincronização contínua. Orientado por configuração por projeto, mantém contexto limpo e reproduzível em qualquer repositório.
Instalação
npx convez-ai mustafacaglarkara/claude-skill-kod-fabrikasi1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Estruturar grandes projetos em fases com checkpoints de qualidade
- Manter documentação viva sincronizada automaticamente via NotebookLM
- Mapear arquitetura de sistemas com Graphify durante desenvolvimento
- Automatizar git hooks para garante disciplina em equipes
Veredito

Ferramenta robusta e opinada para times que buscam rigor estruturado em projetos Claude Code. Requer setup inicial cuidadoso (Python, NotebookLM, Graphify) mas entrega disciplina de fase-a-fase com documentação automática. Melhor para projetos médios-grandes onde rastreabilidade importa.
README
A tradução para o português deste README ainda está na fila.
Kod Fabrikası — Claude Code Skill (v2.0)
EN: AI-powered software factory for Claude Code. NotebookLM + Graphify + Git hooks + Phase-based Development workflow, all driven by a single per-project config. Portable across all your projects. Documentation and skill content are in Turkish.
v2.0: Project management
.mdfiles now live under.claude/{context,decisions,archives,references}/— root stays clean. See CHANGELOG.md for migration from v1.
TR: AI destekli yazılım fabrikası. NotebookLM + Graphify + Git hook'ları + Faz Bazlı Geliştirme iş akışını her projende aynı disiplinle yürütür. Tek bir .claude/kod-fabrikasi.config.json üzerinden tüm proje-spesifik değerleri tutar — bir kere kur, her yerde çalıştır.
v2.0 değişikliği: Proje yönetim .md dosyaları artık root'u kirletmiyor. ROADMAP/MEMORY/QA gibi dosyalar .claude/{context,decisions,archives,references}/ altında gruplanıyor. Faz raporları .claude/archives/PHASE_NN_<konu>.md formatında. v1 → v2 migration için bkz. CHANGELOG.md.
⚡ Hızlı Başlangıç (komutları unutsan da olur)
1. Skill'i bir kerelik kur
git clone https://github.com/mustafacaglarkara/claude-skill-kod-fabrikasi.git ~/.claude/skills/kod-fabrikasi
2. Yeni bir projeye girdiğinde
cd <yeni-proje>
bash ~/.claude/skills/kod-fabrikasi/scripts/init.sh # 4 soru sorar, her şeyi kurar
make setup-hooks # git hook'ları (pre-commit + post-commit)
make bundle # ilk Drive + NotebookLM eşitlemesi
3. Faz başlat (Claude'a tek satır)
"FAZ_PROMPT'u oku ve sıradaki fazı başlat."
Claude 6 adımlı disiplinle çalışır: bağlam topla → plan sun → onay bekle → uygula + test → faz raporu yaz (.claude/archives/PHASE_NN_*.md) → ROADMAP/MEMORY/QA güncelle → commit. Post-commit hook NotebookLM'i otomatik eşitler.
4. v1 projelerinden v2'ye geçiş
Eski projende ROADMAP.md, MEMORY.md vs. root'ta mı? CHANGELOG.md → "Migration Rehberi (v1 → v2)" bölümü tek tek komutları gösterir.
📦 Ön Gereksinimler
# Mimari haritalayıcı
python3 -m pip install graphifyy
# NotebookLM API + tarayıcı eklentisi
python3 -m pip install "notebooklm-py[browser]"
playwright install chromium
# Google hesabıyla NotebookLM'e giriş (bir kerelik)
notebooklm login
Doğrulama:
notebooklm list
graphify --version
⚠️
notebooklm-pyhangi Python'a kuruluysainit.sho Python'un tam yolunu sorar (PATH varsaymak hook'larda patlar — bkz. Tuzak #3).
🏗️ Skill Yapısı
~/.claude/skills/kod-fabrikasi/
├── SKILL.md # Frontmatter + 6 adımlık iş akışı özeti
├── references/ # Level-3: gerektiğinde yüklenir
│ ├── workflow.md # Faz akışı detayı
│ ├── kurulum-rehberi.md # Yeni proje kurulumu
│ ├── notebooklm-graphify.md # Etkili kullanım
│ ├── faz-raporu-sablonu.md # Rapor şablonu + örnek
│ └── tuzaklar.md # 10 kritik tuzak (geçmişten damıtılmış)
├── scripts/
│ ├── init.sh # İnteraktif kurulum (4 soru)
│ ├── bundle.py # Config-driven; Drive + NotebookLM ayna senkron
│ ├── Makefile # bundle / graphify-update / end-phase / setup-hooks
│ └── setup-hooks.sh # Framework-aware (flutter/go/php/python/node/none)
└── assets/
└── kod-fabrikasi.config.example.json
init.sh projeyi şu hale getirir:
<proje-root>/
├── .claude/kod-fabrikasi.config.json # tüm proje-spesifik değerler burada
├── bundle.py # config'ten okur
├── Makefile # config'ten okur
├── setup-hooks.sh # config'ten framework'ü okur, doğru hook'u üretir
├── reports/ # faz raporları buraya yazılır
├── ROADMAP.md / MEMORY.md / QA_REPORTS.md # senin tarafından oluşturulur
└── .gitignore (graphify-out/, __pycache__/, tum_kodlar.txt eklenir)
🧠 Sistem Nasıl Çalışır
Sen → kod yaz + ROADMAP/MEMORY/QA güncelle → git commit
│
pre-commit ─────┤
├─ testler (framework'e göre)
│
post-commit ────┤
├─ graphify update . (AST mimari harita)
└─ bundle.py
├─ kodu paketle → tum_kodlar.txt
├─ kritik dökümanlar → Drive
├─ reports/ + graphify-out/ → Drive ayna
└─ NotebookLM'i Drive ile birebir eşitle
│
NotebookLM web ─┘ ← "Yenile" butonu
| Parça | Ne yapar |
|---|---|
| Claude / Antigravity | Asıl işi yapar: kod yazar, faz raporu yazar, ROADMAP/MEMORY/QA günceller |
| NotebookLM | Projeyi okumuş danışman — soru sorarsın, cevap verir. Dosya yazmaz, faz yapmaz |
| Graphify | AST tabanlı mimari harita — refactor öncesi etki analizi |
| bundle.py | Drive ve NotebookLM'i kod + dökümanlarla birebir aynalar |
| Git hooks | Her commit'te otomatik tetikler |
⚙️ Config Şeması
.claude/kod-fabrikasi.config.json (init.sh tarafından üretilir):
{
"drive_folder_path": "/Users/.../Drive'ım/DEV_PROJELERI/<proje>",
"notebook_id": "uuid-from-notebooklm",
"python_bin": "/Library/Frameworks/Python.framework/Versions/3.13/bin/python3",
"graphify_bin": "/Library/Frameworks/Python.framework/Versions/3.13/bin/graphify",
"framework": "flutter",
"critical_docs": ["ROADMAP.md", "MEMORY.md", "QA_REPORTS.md", ...],
"sync_dirs": ["reports", "graphify-out"],
"phase_files": { "roadmap": "ROADMAP.md", ... }
}
Tam şablon: assets/kod-fabrikasi.config.example.json
Desteklenen framework'ler (pre-commit test komutu seçimi):
flutter→flutter analyze+flutter testgo→go test ./...php-laravel→php artisan testpython→pytestnode→npm testnone→ test komutu yok
🛠️ Günlük Komutlar
make bundle # Manuel: kod paketle + Drive + NotebookLM eşitle
make graphify-update # Manuel: mimari haritayı güncelle
make end-phase # Faz sonu: graphify + bundle birlikte
make setup-hooks # Hook'ları (yeniden) kur
make check-config # Config'i doğrula
Veya sadece git commit at — post-commit hook her şeyi otomatik yapar.
🚫 10 Kritik Tuzak (sistemi "iyileştireyim" derken düşme)
bundle.py ve setup-hooks.sh bu hatalardan geçerek olgunlaştı. Detay: references/tuzaklar.md
- NotebookLM kaynaklarını başlığa göre dict'leme (çiftler birikir)
- Alt klasör dosyalarında başlık çakışması (
a/rapor.md≠b/rapor.md→__ile düzleştir) python3PATH varsayma (hook'lar farklı PATH ile çalışır)- Boş klasörde NotebookLM'i temizleme (güvenlik freni şart)
__pycache__/commit etme- Büyük HTML/JSON yükleme (NotebookLM boğulur)
copytree(dirs_exist_ok=True)(eski dosyalar birikir →rmtree+copytree)reports/klasörünüsync_dirs'e koymama- Aynı içeriği hem
.mdhem.txtyazma (NotebookLM'de çift kaynak) - Runtime doğrulamayı atlayıp "yeşil" yazma
🆘 Sorun Giderme
| Sorun | Çözüm |
|---|---|
ModuleNotFoundError: notebooklm | python_bin PATH'teki python3'e işaret ediyor ama paket başka python'a kurulu. which python3 → config'i o yola sabitle. |
| NotebookLM'de çift kaynak | make bundle tekrar çalıştır — id bazında temizler. |
Drive klasöründe dosya yok uyarısı | Güvenlik freni devreye girdi (iyi haber). Drive yolu doğru mu? Drive masaüstü çalışıyor mu? |
| Hook çalışmıyor | make setup-hooks tekrar çalıştır. .git/hooks/post-commit var mı kontrol et. |
init.sh: command not found | Bash kullan: bash ~/.claude/skills/kod-fabrikasi/scripts/init.sh |
🔄 Güncelleme
cd ~/.claude/skills/kod-fabrikasi
git pull
Mevcut projelerin config'i değişmez; sadece skill içerikleri güncellenir.
📚 Kapsamlı Rehberler
SKILL.md— Claude'un okuduğu ana skill dosyasıreferences/workflow.md— 6 adımlı faz akışıreferences/kurulum-rehberi.md— yeni proje kurulumureferences/notebooklm-graphify.md— etkili kullanımreferences/faz-raporu-sablonu.md— rapor şablonureferences/tuzaklar.md— 10 kritik tuzak
📄 Lisans
MIT — bkz. LICENSE
🤝 Katkı
Bu skill kişisel iş akışımdan damıtıldı. Bug bildirimi / iyileştirme önerisi için Issue veya PR açabilirsiniz. Skill'i forklayıp kendi disiplininize uyarlayabilirsiniz.
Yapı: Anthropic Agent Skills spec'ine uygundur (frontmatter, progressive disclosure, references/scripts/assets klasörleri).