product-frontend-clean-architecture-development
Use this skill as the master frontend architecture orchestrator to guide, design, and refactor React, React Native, and Expo applications according to Clean Architecture principles, Feature-Sliced Des
SKILL.mdskills/frontend-engineering/product-frontend-clean-architecture-development/SKILL.md
GitHubMaster Frontend Clean Architecture Orchestrator
Bu skill; modern web, mobil (React Native / Expo) ve çapraz platform frontend projelerinde Clean Architecture (Temiz Mimari) ve Feature-Sliced Design (FSD) standartlarını uçtan uca koordine eden ana orkestratördür.
Projeyi 3 temel mimari katmana ve 6 alt uzmanlık alanına bölerek monolitik bileşenleri engeller, iş mantığını saf tutar ve yüksek performanslı, test edilebilir sistemler inşa eder.
Master Araştırma Raporu: senior_frontend_architecture_and_competencies_master_report.md
🏛️ 1. Alt Uzmanlık Skilleri Dizini (Subskills Directory)
Geliştirilecek özelliğin veya refactoring ihtiyacının kapsamına göre aşağıdaki modüler alt uzmanlık skillerine delege edilir:
| Alt Uzmanlık Skilli | Kapsam ve Temel Sorumluluk | Göreli Bağlantı |
|---|---|---|
| 🖥️ Presentation Layer | Router ve Screen ayrımı, Pure UI (Dumb) bileşenler, 150 satır kuralı, Orchestrator deseni ve Headless UI. | frontend-layer-presentation |
| 🧠 Domain Layer | Saf TypeScript modelleri, Zod şemaları, framework-bağımsız use case fonksiyonları ve XState durum makineleri. | frontend-layer-domain |
| 🔌 Infrastructure Layer | API Repositories, DTO-to-Domain mappers, Supabase adaptörleri ve donanımsal/güvenli depolama. | frontend-layer-infrastructure |
| 🔄 State Orchestration | State unbundling: Server State (TanStack Query), Client State (Zustand), URL State (nuqs) ve Form Actions. |
frontend-state-orchestration |
| ⚡ Performance & Ergonomics | INP $\le 200\text{ ms}$, React 19 Compiler uyumu, FlashList v2, react-native-keyboard-controller, Safe Area. |
frontend-performance-ergonomics |
| 🛡️ Quality, Security & Tooling | Testing Trophy (Vitest, RTL, Playwright, MSW v2), Nonce CSP v3, DOMPurify, Biome ve PR bundle bütçesi. | frontend-quality-security-tooling |
🚫 2. KRİTİK MİMARİ KISITLAMALAR (MANDATORY & STRICT)
A. 150 Satır Kuralı ve Monolitik Bileşen Yasağı
- 150–200 satırı aşan veya birden fazla mantıksal alt görünümü (adım adım wizard, sekmeler, koşullu paneller) barındıran bileşenlerin tek dosyada tutulması kesinlikle yasaktır.
- Ekranlar bir Parent Orchestrator (sadece state ve akışı yöneten) ve
steps/veyacomponents/altında toplanan Atomic Child Components şeklinde ayrıştırılmalıdır.
B. Zorunlu Ön Denetim Fazı (Audit Before Coding)
Kod yazılmadan önce hedef dosya taranır:
- Monolitik Yapı: Dosya birden fazla ekranı veya adımı tek gövdede mi render ediyor?
- Hardcoded Metinler: Arayüzde
t('module.key')yerine doğrudan string var mı? - Altyapı Sızıntısı: UI bileşeni içinde doğrudan
fetch,axiosveya veritabanı sorgusu var mı?
- Eylem: İhlal tespit edilirse doğrudan kod yazılmaz; kullanıcıya refactoring planı sunulup onay alınır.
🔄 3. Katmanlar Arası Veri ve Kontrol Akışı
flowchart TD
subgraph UI["1. Presentation Layer"]
Orch["Parent Orchestrator"]
Pure["Pure UI Components"]
Orch --> Pure
end
subgraph Domain["2. Domain Layer"]
Hook["Custom Domain Hooks"]
UC["Use Cases & Calculators"]
Zod["Zod Entities & Value Objects"]
Hook --> UC
UC --> Zod
end
subgraph Infra["3. Infrastructure Layer"]
Repo["Repositories & API Clients"]
Map["DTO Data Mappers"]
Cache["TanStack Query Cache"]
Repo --> Map
Repo --> Cache
end
UI -->|Veri İster & Event Gönderir| Domain
Domain -->|Sözleşme Çağrısı Yapar| Infra
🚀 4. Orkestrasyon ve Yürütme Adımları
Geliştirici veya agent bir ekran/modül inşa ederken şu sırayı takip eder:
- Domain Tanımla: frontend-layer-domain ile Zod şemasını ve iş mantığı kurallarını saf TypeScript olarak yaz ve test et.
- Altyapıyı Bağla: frontend-layer-infrastructure ile Repository arayüzünü ve DTO mapper'ı oluştur.
- Durumu Orkestre Et: frontend-state-orchestration ile TanStack Query / Zustand bağlantısını kur.
- Sunumu İnşa Et: frontend-layer-presentation ile Orchestrator ve Pure UI bileşenlerini 150 satır kuralına uygun yaz.
- Ergonomi ve Performansı Denetle: frontend-performance-ergonomics ile liste sanallaştırma, keyboard ve safe area entegrasyonunu doğrula.
- Kalite ve Güvenlik Testlerini Koş: frontend-quality-security-tooling ile Vitest/MSW testlerini yaz ve güvenlik kontrollerini tamamla.