# 🤖 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`
