Fahri Can Seçer
4b71e10d82
Some checks failed
UI Deploy (Next-Auth Support) 🎨 / build-and-deploy (push) Has been cancelled
117 lines
3.9 KiB
Markdown
117 lines
3.9 KiB
Markdown
# 🤖 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`
|