🤖 AI Assistant Context - NestJS Backend

Bu dosya, AI asistanların (Claude, GPT, Gemini vb.) projeyi hızlıca anlaması için hazırlanmış bir referans dökümanıdır.

📚 Projeyi Anlamak İçin Önce Oku

README.md dosyasını oku - Projenin mimarisi, ADR'ler, teknoloji stack'i ve kurulum adımlarını içerir.

README.md

🎯 Referans Klasörü

.claude/ klasörü best practice'ler, agent tanımları ve yardımcı scriptler içerir. Görev türüne göre ilgili referansları kullan:

Skills (Beceri Setleri)

Beceri	Konum	Ne Zaman Kullan
Senior Backend	`.claude/skills/senior-backend/`	API geliştirme, servis yazarken
Senior Fullstack	`.claude/skills/senior-fullstack/`	End-to-end feature geliştirme
Code Reviewer	`.claude/skills/code-reviewer/`	Code review yaparken
Receiving Code Review	`.claude/skills/receiving-code-review/`	Review feedback işlerken
Senior ML Engineer	`.claude/skills/senior-ml-engineer/`	ML/AI entegrasyonları
Senior Prompt Engineer	`.claude/skills/senior-prompt-engineer/`	LLM prompt optimizasyonu

Agents (Roller)

Agent	Konum	Açıklama
TypeScript Pro	`.claude/agents/typescript-pro.md`	TypeScript best practices
Code Reviewer	`.claude/agents/code-reviewer.md`	Kod review yapma
Debugger	`.claude/agents/debugger.md`	Hata ayıklama
Security Engineer	`.claude/agents/security-engineer.md`	Güvenlik analizi
Database Optimizer	`.claude/agents/database-optimizer.md`	DB performans optimizasyonu
API Documenter	`.claude/agents/api-documenter.md`	API dokümantasyonu
API Security Audit	`.claude/agents/api-security-audit.md`	API güvenlik denetimi
AI Engineer	`.claude/agents/ai-engineer.md`	AI/ML entegrasyonları
Data Scientist	`.claude/agents/data-scientist.md`	Veri analizi

🔧 Teknoloji Stack'i (Özet)

Framework: NestJS
ORM: Prisma
Database: PostgreSQL
Cache: Redis
Auth: JWT + RBAC
i18n: nestjs-i18n
Language: TypeScript (Strict Mode)

🏗️ Proje Yapısı Özeti

src/
├── common/           # Shared (BaseService, BaseController, Filters, Interceptors)
├── config/           # App configuration
├── database/         # Prisma service
├── i18n/             # Translation files
└── modules/          # Feature modules (auth, users, admin, health)

✅ Görev Bazlı Referans Kullanımı

API geliştirirken:

.claude/skills/senior-backend/SKILL.md
.claude/skills/senior-backend/references/

Code review yaparken:

.claude/skills/code-reviewer/SKILL.md
.claude/skills/code-reviewer/references/common_antipatterns.md

Güvenlik denetimi yaparken:

.claude/agents/security-engineer.md
.claude/agents/api-security-audit.md

Database optimizasyonu:

.claude/agents/database-optimizer.md

💡 Örnek Prompt'lar

Yeni Module Oluşturma

".claude/skills/senior-backend/ referanslarını kullanarak, notifications modülü oluştur. BaseService ve BaseController pattern'lerini kullan."

Code Review

".claude/skills/code-reviewer/references/common_antipatterns.md dosyasına göre src/modules/auth/ klasörünü review et."

Güvenlik Analizi

".claude/agents/api-security-audit.md rolünü al ve projenin güvenlik açıklarını analiz et."

Database Optimizasyonu

".claude/agents/database-optimizer.md rolünü al ve Prisma sorgularını optimize et."

Frontend Projesi: ../nextjs-boilerplate-full/prompt.md

4.2 KiB Raw Blame History Unescape Escape