61 lines
2.6 KiB
Markdown
61 lines
2.6 KiB
Markdown
# CLAUDE.md
|
||
|
||
Bu dosya, bu depodaki kodlarla çalışırken Claude Code'a (claude.ai/code) rehberlik sağlar.
|
||
|
||
## Projeye Genel Bakış
|
||
|
||
Bu bir **Claude Code plugin**'idir - üretime hazır agent'lar, skill'ler, hook'lar, komutlar, kurallar ve MCP konfigürasyonlarından oluşan bir koleksiyondur. Proje, Claude Code kullanarak yazılım geliştirme için test edilmiş iş akışları sağlar.
|
||
|
||
## Testleri Çalıştırma
|
||
|
||
```bash
|
||
# Tüm testleri çalıştır
|
||
node tests/run-all.js
|
||
|
||
# Tekil test dosyalarını çalıştır
|
||
node tests/lib/utils.test.js
|
||
node tests/lib/package-manager.test.js
|
||
node tests/hooks/hooks.test.js
|
||
```
|
||
|
||
## Mimari
|
||
|
||
Proje, birkaç temel bileşen halinde organize edilmiştir:
|
||
|
||
- **agents/** - Delegasyon için özelleşmiş alt agent'lar (planner, code-reviewer, tdd-guide, vb.)
|
||
- **skills/** - İş akışı tanımları ve alan bilgisi (coding standards, patterns, testing)
|
||
- **commands/** - Kullanıcılar tarafından çağrılan slash komutları (/tdd, /plan, /e2e, vb.)
|
||
- **hooks/** - Tetikleyici tabanlı otomasyonlar (session persistence, pre/post-tool hooks)
|
||
- **rules/** - Her zaman takip edilmesi gereken yönergeler (security, coding style, testing requirements)
|
||
- **mcp-configs/** - Harici entegrasyonlar için MCP server konfigürasyonları
|
||
- **scripts/** - Hook'lar ve kurulum için platformlar arası Node.js yardımcı araçları
|
||
- **tests/** - Script'ler ve yardımcı araçlar için test suite
|
||
|
||
## Temel Komutlar
|
||
|
||
- `/tdd` - Test-driven development iş akışı
|
||
- `/plan` - Uygulama planlaması
|
||
- `/e2e` - E2E testleri oluştur ve çalıştır
|
||
- `/code-review` - Kalite incelemesi
|
||
- `/build-fix` - Build hatalarını düzelt
|
||
- `/learn` - Oturumlardan kalıpları çıkar
|
||
- `/skill-create` - Git geçmişinden skill'ler oluştur
|
||
|
||
## Geliştirme Notları
|
||
|
||
- Package manager algılama: npm, pnpm, yarn, bun (`CLAUDE_PACKAGE_MANAGER` env var veya proje config ile yapılandırılabilir)
|
||
- Platformlar arası: Node.js script'leri aracılığıyla Windows, macOS, Linux desteği
|
||
- Agent formatı: YAML frontmatter ile Markdown (name, description, tools, model)
|
||
- Skill formatı: Ne zaman kullanılır, nasıl çalışır, örnekler için açık bölümler içeren Markdown
|
||
- Hook formatı: Matcher koşulları ve command/notification hook'ları ile JSON
|
||
|
||
## Katkıda Bulunma
|
||
|
||
CONTRIBUTING.md'deki formatları takip edin:
|
||
- Agents: Frontmatter ile Markdown (name, description, tools, model)
|
||
- Skills: Açık bölümler (When to Use, How It Works, Examples)
|
||
- Commands: Description frontmatter ile Markdown
|
||
- Hooks: Matcher ve hooks array ile JSON
|
||
|
||
Dosya isimlendirme: tire ile küçük harfler (örn., `python-reviewer.md`, `tdd-workflow.md`)
|