boilerplate-fe/prompt.md

🤖 AI Assistant Context - Next.js Frontend

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, teknoloji stack'i ve kurulum adımlarını içerir.

📝 AI Documentation (MDS Standard)

IMPORTANT: Every AI session, chat, or major change MUST be documented in the mds/ folder.

1. Create/Update Log: Create a markdown file (e.g., mds/YYYY-MM-DD-topic.md) or append to an existing daily log.
2. Content: Briefly summarize the user request, the changes made, and the rationale.
3. Persistence: This ensures a history of AI interactions and decisions is preserved within the repo.

---

📚 Projeyi Anlamak İçin Önce Oku

🎯 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 QA	.claude/skills/senior-qa/	Test yazarken, coverage analizi yaparken
Senior Frontend	.claude/skills/senior-frontend/	Component geliştirirken, UI best practices
Frontend Design	.claude/skills/frontend-design/	Tasarım kararları alırken

Agents (Roller)

Agent	Konum	Açıklama
Frontend Developer	.claude/agents/frontend-developer.md	Genel frontend geliştirme
Next.js Architecture Expert	.claude/agents/nextjs-architecture-expert.md	Mimari kararlar

Commands (Komutlar)

Komut	Konum	Açıklama
Component Generator	.claude/commands/nextjs-component-generator.md	Yeni component oluşturma
API Tester	.claude/commands/nextjs-api-tester.md	API endpoint test etme

---

🔧 Teknoloji Stack'i (Özet)

• Framework: Next.js 16 (App Router)
• UI Library: Chakra UI v3
• State Management: React Query (TanStack)
• Auth: NextAuth.js
• i18n: next-intl
• Language: TypeScript (Strict Mode)

---

🏗️ Proje Yapısı Özeti

src/
├── app/[locale]/     # Locale-based routing
├── components/       # UI components
├── lib/api/          # API clients
├── i18n/             # Internationalization
└── theme/            # Chakra UI theme

---

✅ Görev Bazlı Referans Kullanımı

Test yazarken:

.claude/skills/senior-qa/references/testing_strategies.md
.claude/skills/senior-qa/references/test_automation_patterns.md

Component geliştirirken:

.claude/skills/senior-frontend/SKILL.md
.claude/skills/frontend-design/SKILL.md

Mimari kararlar alırken:

.claude/agents/nextjs-architecture-expert.md
README.md (ADR bölümü)

---

💡 Örnek Prompt'lar

Yeni Component Oluşturma

".claude/skills/senior-frontend/ referanslarını kullanarak, reusable bir DataTable component'i oluştur."

Test Yazma

".claude/skills/senior-qa/references/testing_strategies.md pattern'lerini kullanarak LoginForm için unit test yaz."

Code Review

".claude/skills/senior-frontend/ best practice'lerine göre src/components/auth/ klasörünü review et."

---

Backend Projesi: ../typescript-boilerplate-be/prompt.md