skript-be/prompt.md

🤖 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

1. 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