[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AKNF98VB0ENW5W746VGGD6":3,"skill-same:01M7AKNF98VB0ENW5W746VGGD6":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7AKNF98VB0ENW5W746VGGD6","coding-standards",null,"TypeScript, JavaScript, React ve Node.js geliştirme için evrensel kodlama standartları, en iyi uygulamalar ve kalıplar.","Cyrilthetecchieee\u002Fcyril-code-","Cyrilthetecchieee","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F219787998?v=4","01M7AF0MMMKRAA0H61XMJPV92H","Julian Cyril D ","01M7AF0MQ10AVG6QJQ1C2BC0F5",2,"MIT","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Ftr\u002Fskills\u002Fcoding-standards\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: coding-standards\ndescription: TypeScript, JavaScript, React ve Node.js geliştirme için evrensel kodlama standartları, en iyi uygulamalar ve kalıplar.\norigin: ECC\n---\n\n# Kodlama Standartları ve En İyi Uygulamalar\n\nTüm projelerde uygulanabilir evrensel kodlama standartları.\n\n## Ne Zaman Aktifleştirmelisiniz\n\n- Yeni bir proje veya modül başlatırken\n- Kod kalitesi ve sürdürülebilirlik için kod incelerken\n- Mevcut kodu kurallara uygun hale getirmek için refactor ederken\n- İsimlendirme, biçimlendirme veya yapısal tutarlılığı zorunlu kılarken\n- Linting, biçimlendirme veya tür kontrolü kuralları ayarlarken\n- Yeni katkıda bulunanları kodlama kurallarına alıştırırken\n\n## Kod Kalitesi İlkeleri\n\n### 1. Önce Okunabilirlik\n- Kod yazılmaktan çok okunur\n- Net değişken ve fonksiyon isimleri\n- Yorumlardan çok kendi kendini belgeleyen kod tercih edilir\n- Tutarlı biçimlendirme\n\n### 2. KISS (Keep It Simple, Stupid - Basit Tut)\n- Çalışan en basit çözüm\n- Aşırı mühendislikten kaçının\n- Erken optimizasyon yapmayın\n- Anlaşılır kod > akıllıca kod\n\n### 3. DRY (Don't Repeat Yourself - Kendini Tekrar Etme)\n- Ortak mantığı fonksiyonlara çıkarın\n- Yeniden kullanılabilir bileşenler oluşturun\n- Yardımcı araçları modüller arasında paylaşın\n- Kopyala-yapıştır programlamadan kaçının\n\n### 4. YAGNI (You Aren't Gonna Need It - İhtiyacın Olmayacak)\n- İhtiyaç duyulmadan özellikler oluşturmayın\n- Spekülatif genellemeden kaçının\n- Karmaşıklığı sadece gerektiğinde ekleyin\n- Basit başlayın, gerektiğinde refactor edin\n\n## TypeScript\u002FJavaScript Standartları\n\n### Değişken İsimlendirme\n\n```typescript\n\u002F\u002F PASS: İYİ: Açıklayıcı isimler\nconst marketSearchQuery = 'election'\nconst isUserAuthenticated = true\nconst totalRevenue = 1000\n\n\u002F\u002F FAIL: KÖTÜ: Belirsiz isimler\nconst q = 'election'\nconst flag = true\nconst x = 1000\n```\n\n### Fonksiyon İsimlendirme\n\n```typescript\n\u002F\u002F PASS: İYİ: Fiil-isim kalıbı\nasync function fetchMarketData(marketId: string) { }\nfunction calculateSimilarity(a: number[], b: number[]) { }\nfunction isValidEmail(email: string): boolean { }\n\n\u002F\u002F FAIL: KÖTÜ: Belirsiz veya sadece isim\nasync function market(id: string) { }\nfunction similarity(a, b) { }\nfunction email(e) { }\n```\n\n### Değişmezlik Kalıbı (KRİTİK)\n\n```typescript\n\u002F\u002F PASS: HER ZAMAN spread operatörü kullanın\nconst updatedUser = {\n  ...user,\n  name: 'New Name'\n}\n\nconst updatedArray = [...items, newItem]\n\n\u002F\u002F FAIL: ASLA doğrudan mutasyon yapmayın\nuser.name = 'New Name'  \u002F\u002F KÖTÜ\nitems.push(newItem)     \u002F\u002F KÖTÜ\n```\n\n### Hata Yönetimi\n\n```typescript\n\u002F\u002F PASS: İYİ: Kapsamlı hata yönetimi\nasync function fetchData(url: string) {\n  try {\n    const response = await fetch(url)\n\n    if (!response.ok) {\n      throw new Error(`HTTP ${response.status}: ${response.statusText}`)\n    }\n\n    return await response.json()\n  } catch (error) {\n    console.error('Fetch failed:', error)\n    throw new Error('Failed to fetch data')\n  }\n}\n\n\u002F\u002F FAIL: KÖTÜ: Hata yönetimi yok\nasync function fetchData(url) {\n  const response = await fetch(url)\n  return response.json()\n}\n```\n\n### Async\u002FAwait En İyi Uygulamaları\n\n```typescript\n\u002F\u002F PASS: İYİ: Mümkün olduğunda paralel yürütme\nconst [users, markets, stats] = await Promise.all([\n  fetchUsers(),\n  fetchMarkets(),\n  fetchStats()\n])\n\n\u002F\u002F FAIL: KÖTÜ: Gereksiz yere sıralı\nconst users = await fetchUsers()\nconst markets = await fetchMarkets()\nconst stats = await fetchStats()\n```\n\n### Tür Güvenliği\n\n```typescript\n\u002F\u002F PASS: İYİ: Doğru tipler\ninterface Market {\n  id: string\n  name: string\n  status: 'active' | 'resolved' | 'closed'\n  created_at: Date\n}\n\nfunction getMarket(id: string): Promise\u003CMarket> {\n  \u002F\u002F Implementation\n}\n\n\u002F\u002F FAIL: KÖTÜ: 'any' kullanımı\nfunction getMarket(id: any): Promise\u003Cany> {\n  \u002F\u002F Implementation\n}\n```\n\n## React En İyi Uygulamaları\n\n### Bileşen Yapısı\n\n```typescript\n\u002F\u002F PASS: İYİ: Tiplerle fonksiyonel bileşen\ninterface ButtonProps {\n  children: React.ReactNode\n  onClick: () => void\n  disabled?: boolean\n  variant?: 'primary' | 'secondary'\n}\n\nexport function Button({\n  children,\n  onClick,\n  disabled = false,\n  variant = 'primary'\n}: ButtonProps) {\n  return (\n    \u003Cbutton\n      onClick={onClick}\n      disabled={disabled}\n      className={`btn btn-${variant}`}\n    >\n      {children}\n    \u003C\u002Fbutton>\n  )\n}\n\n\u002F\u002F FAIL: KÖTÜ: Tip yok, belirsiz yapı\nexport function Button(props) {\n  return \u003Cbutton onClick={props.onClick}>{props.children}\u003C\u002Fbutton>\n}\n```\n\n### Özel Hook'lar\n\n```typescript\n\u002F\u002F PASS: İYİ: Yeniden kullanılabilir özel hook\nexport function useDebounce\u003CT>(value: T, delay: number): T {\n  const [debouncedValue, setDebouncedValue] = useState\u003CT>(value)\n\n  useEffect(() => {\n    const handler = setTimeout(() => {\n      setDebouncedValue(value)\n    }, delay)\n\n    return () => clearTimeout(handler)\n  }, [value, delay])\n\n  return debouncedValue\n}\n\n\u002F\u002F Kullanım\nconst debouncedQuery = useDebounce(searchQuery, 500)\n```\n\n### State Yönetimi\n\n```typescript\n\u002F\u002F PASS: İYİ: Doğru state güncellemeleri\nconst [count, setCount] = useState(0)\n\n\u002F\u002F Önceki state'e dayalı fonksiyonel güncelleme\nsetCount(prev => prev + 1)\n\n\u002F\u002F FAIL: KÖTÜ: Doğrudan state referansı\nsetCount(count + 1)  \u002F\u002F Async senaryolarda eski olabilir\n```\n\n### Koşullu Render\n\n```typescript\n\u002F\u002F PASS: İYİ: Açık koşullu render\n{isLoading && \u003CSpinner \u002F>}\n{error && \u003CErrorMessage error={error} \u002F>}\n{data && \u003CDataDisplay data={data} \u002F>}\n\n\u002F\u002F FAIL: KÖTÜ: Ternary cehennemi\n{isLoading ? \u003CSpinner \u002F> : error ? \u003CErrorMessage error={error} \u002F> : data ? \u003CDataDisplay data={data} \u002F> : null}\n```\n\n## API Tasarım Standartları\n\n### REST API Kuralları\n\n```\nGET    \u002Fapi\u002Fmarkets              # Tüm marketleri listele\nGET    \u002Fapi\u002Fmarkets\u002F:id          # Belirli marketi getir\nPOST   \u002Fapi\u002Fmarkets              # Yeni market oluştur\nPUT    \u002Fapi\u002Fmarkets\u002F:id          # Marketi güncelle (tam)\nPATCH  \u002Fapi\u002Fmarkets\u002F:id          # Marketi güncelle (kısmi)\nDELETE \u002Fapi\u002Fmarkets\u002F:id          # Marketi sil\n\n# Filtreleme için query parametreleri\nGET \u002Fapi\u002Fmarkets?status=active&limit=10&offset=0\n```\n\n### Response Formatı\n\n```typescript\n\u002F\u002F PASS: İYİ: Tutarlı response yapısı\ninterface ApiResponse\u003CT> {\n  success: boolean\n  data?: T\n  error?: string\n  meta?: {\n    total: number\n    page: number\n    limit: number\n  }\n}\n\n\u002F\u002F Başarılı response\nreturn NextResponse.json({\n  success: true,\n  data: markets,\n  meta: { total: 100, page: 1, limit: 10 }\n})\n\n\u002F\u002F Hata response\nreturn NextResponse.json({\n  success: false,\n  error: 'Invalid request'\n}, { status: 400 })\n```\n\n### Input Doğrulama\n\n```typescript\nimport { z } from 'zod'\n\n\u002F\u002F PASS: İYİ: Schema doğrulama\nconst CreateMarketSchema = z.object({\n  name: z.string().min(1).max(200),\n  description: z.string().min(1).max(2000),\n  endDate: z.string().datetime(),\n  categories: z.array(z.string()).min(1)\n})\n\nexport async function POST(request: Request) {\n  const body = await request.json()\n\n  try {\n    const validated = CreateMarketSchema.parse(body)\n    \u002F\u002F Doğrulanmış veriyle devam et\n  } catch (error) {\n    if (error instanceof z.ZodError) {\n      return NextResponse.json({\n        success: false,\n        error: 'Validation failed',\n        details: error.errors\n      }, { status: 400 })\n    }\n  }\n}\n```\n\n## Dosya Organizasyonu\n\n### Proje Yapısı\n\n```\nsrc\u002F\n├── app\u002F                    # Next.js App Router\n│   ├── api\u002F               # API routes\n│   ├── markets\u002F           # Market sayfaları\n│   └── (auth)\u002F           # Auth sayfaları (route groups)\n├── components\u002F            # React bileşenleri\n│   ├── ui\u002F               # Genel UI bileşenleri\n│   ├── forms\u002F            # Form bileşenleri\n│   └── layouts\u002F          # Layout bileşenleri\n├── hooks\u002F                # Özel React hooks\n├── lib\u002F                  # Yardımcı araçlar ve konfigürasyonlar\n│   ├── api\u002F             # API istemcileri\n│   ├── utils\u002F           # Yardımcı fonksiyonlar\n│   └── constants\u002F       # Sabitler\n├── types\u002F                # TypeScript tipleri\n└── styles\u002F              # Global stiller\n```\n\n### Dosya İsimlendirme\n\n```\ncomponents\u002FButton.tsx          # Bileşenler için PascalCase\nhooks\u002FuseAuth.ts              # 'use' öneki ile camelCase\nlib\u002FformatDate.ts             # Yardımcı araçlar için camelCase\ntypes\u002Fmarket.types.ts         # .types soneki ile camelCase\n```\n\n## Yorumlar ve Dokümantasyon\n\n### Ne Zaman Yorum Yapmalı\n\n```typescript\n\u002F\u002F PASS: İYİ: NİÇİN'i açıklayın, NE'yi değil\n\u002F\u002F Kesintiler sırasında API'yi aşırı yüklemekten kaçınmak için exponential backoff kullan\nconst delay = Math.min(1000 * Math.pow(2, retryCount), 30000)\n\n\u002F\u002F Büyük dizilerle performans için burada kasıtlı olarak mutasyon kullanılıyor\nitems.push(newItem)\n\n\u002F\u002F FAIL: KÖTÜ: Açık olanı belirtmek\n\u002F\u002F Sayacı 1 artır\ncount++\n\n\u002F\u002F İsmi kullanıcının ismine ayarla\nname = user.name\n```\n\n### Public API'ler için JSDoc\n\n```typescript\n\u002F**\n * Semantik benzerlik kullanarak market arar.\n *\n * @param query - Doğal dil arama sorgusu\n * @param limit - Maksimum sonuç sayısı (varsayılan: 10)\n * @returns Benzerlik skoruna göre sıralanmış market dizisi\n * @throws {Error} OpenAI API başarısız olursa veya Redis kullanılamazsa\n *\n * @example\n * ```typescript\n * const results = await searchMarkets('election', 5)\n * console.log(results[0].name) \u002F\u002F \"Trump vs Biden\"\n * ```\n *\u002F\nexport async function searchMarkets(\n  query: string,\n  limit: number = 10\n): Promise\u003CMarket[]> {\n  \u002F\u002F Implementation\n}\n```\n\n## Performans En İyi Uygulamaları\n\n### Memoization\n\n```typescript\nimport { useMemo, useCallback } from 'react'\n\n\u002F\u002F PASS: İYİ: Pahalı hesaplamaları memoize et\nconst sortedMarkets = useMemo(() => {\n  return markets.sort((a, b) => b.volume - a.volume)\n}, [markets])\n\n\u002F\u002F PASS: İYİ: Callback'leri memoize et\nconst handleSearch = useCallback((query: string) => {\n  setSearchQuery(query)\n}, [])\n```\n\n### Lazy Loading\n\n```typescript\nimport { lazy, Suspense } from 'react'\n\n\u002F\u002F PASS: İYİ: Ağır bileşenleri lazy yükle\nconst HeavyChart = lazy(() => import('.\u002FHeavyChart'))\n\nexport function Dashboard() {\n  return (\n    \u003CSuspense fallback={\u003CSpinner \u002F>}>\n      \u003CHeavyChart \u002F>\n    \u003C\u002FSuspense>\n  )\n}\n```\n\n### Veritabanı Sorguları\n\n```typescript\n\u002F\u002F PASS: İYİ: Sadece gerekli sütunları seç\nconst { data } = await supabase\n  .from('markets')\n  .select('id, name, status')\n  .limit(10)\n\n\u002F\u002F FAIL: KÖTÜ: Her şeyi seç\nconst { data } = await supabase\n  .from('markets')\n  .select('*')\n```\n\n## Test Standartları\n\n### Test Yapısı (AAA Kalıbı)\n\n```typescript\ntest('benzerliği doğru hesaplar', () => {\n  \u002F\u002F Arrange (Hazırla)\n  const vector1 = [1, 0, 0]\n  const vector2 = [0, 1, 0]\n\n  \u002F\u002F Act (İşle)\n  const similarity = calculateCosineSimilarity(vector1, vector2)\n\n  \u002F\u002F Assert (Doğrula)\n  expect(similarity).toBe(0)\n})\n```\n\n### Test İsimlendirme\n\n```typescript\n\u002F\u002F PASS: İYİ: Açıklayıcı test isimleri\ntest('sorguya uygun market bulunamadığında boş dizi döndürür', () => { })\ntest('OpenAI API anahtarı eksikse hata fırlatır', () => { })\ntest('Redis kullanılamazsa substring aramaya geri döner', () => { })\n\n\u002F\u002F FAIL: KÖTÜ: Belirsiz test isimleri\ntest('çalışır', () => { })\ntest('arama testi', () => { })\n```\n\n## Kod Kokusu Tespiti\n\nBu anti-kalıplara dikkat edin:\n\n### 1. Uzun Fonksiyonlar\n```typescript\n\u002F\u002F FAIL: KÖTÜ: 50 satırdan uzun fonksiyon\nfunction processMarketData() {\n  \u002F\u002F 100 satır kod\n}\n\n\u002F\u002F PASS: İYİ: Küçük fonksiyonlara böl\nfunction processMarketData() {\n  const validated = validateData()\n  const transformed = transformData(validated)\n  return saveData(transformed)\n}\n```\n\n### 2. Derin İç İçe Geçme\n```typescript\n\u002F\u002F FAIL: KÖTÜ: 5+ seviye iç içe geçme\nif (user) {\n  if (user.isAdmin) {\n    if (market) {\n      if (market.isActive) {\n        if (hasPermission) {\n          \u002F\u002F Bir şeyler yap\n        }\n      }\n    }\n  }\n}\n\n\u002F\u002F PASS: İYİ: Erken dönüşler\nif (!user) return\nif (!user.isAdmin) return\nif (!market) return\nif (!market.isActive) return\nif (!hasPermission) return\n\n\u002F\u002F Bir şeyler yap\n```\n\n### 3. Sihirli Sayılar\n```typescript\n\u002F\u002F FAIL: KÖTÜ: Açıklanmamış sayılar\nif (retryCount > 3) { }\nsetTimeout(callback, 500)\n\n\u002F\u002F PASS: İYİ: İsimlendirilmiş sabitler\nconst MAX_RETRIES = 3\nconst DEBOUNCE_DELAY_MS = 500\n\nif (retryCount > MAX_RETRIES) { }\nsetTimeout(callback, DEBOUNCE_DELAY_MS)\n```\n\n**Unutmayın**: Kod kalitesi pazarlık konusu değildir. Açık, sürdürülebilir kod hızlı geliştirme ve güvenli refactoring sağlar.\n","# Kodlama Standartları ve En İyi Uygulamalar\n\nTüm projelerde uygulanabilir evrensel kodlama standartları.\n\n## Ne Zaman Aktifleştirmelisiniz\n\n- Yeni bir proje veya modül başlatırken\n- Kod kalitesi ve sürdürülebilirlik için kod incelerken\n- Mevcut kodu kurallara uygun hale getirmek için refactor ederken\n- İsimlendirme, biçimlendirme veya yapısal tutarlılığı zorunlu kılarken\n- Linting, biçimlendirme veya tür kontrolü kuralları ayarlarken\n- Yeni katkıda bulunanları kodlama kurallarına alıştırırken\n\n## Kod Kalitesi İlkeleri\n\n### 1. Önce Okunabilirlik\n- Kod yazılmaktan çok okunur\n- Net değişken ve fonksiyon isimleri\n- Yorumlardan çok kendi kendini belgeleyen kod tercih edilir\n- Tutarlı biçimlendirme\n\n### 2. KISS (Keep It Simple, Stupid - Basit Tut)\n- Çalışan en basit çözüm\n- Aşırı mühendislikten kaçının\n- Erken optimizasyon yapmayın\n- Anlaşılır kod > akıllıca kod\n\n### 3. DRY (Don't Repeat Yourself - Kendini Tekrar Etme)\n- Ortak mantığı fonksiyonlara çıkarın\n- Yeniden kullanılabilir bileşenler oluşturun\n- Yardımcı araçları modüller arasında paylaşın\n- Kopyala-yapıştır programlamadan kaçının\n\n### 4. YAGNI (You Aren't Gonna Need It - İhtiyacın Olmayacak)\n- İhtiyaç duyulmadan özellikler oluşturmayın\n- Spekülatif genellemeden kaçının\n- Karmaşıklığı sadece gerektiğinde ekleyin\n- Basit başlayın, gerektiğinde refactor edin\n\n## TypeScript\u002FJavaScript Standartları\n\n### Değişken İsimlendirme\n\n```typescript\n\u002F\u002F PASS: İYİ: Açıklayıcı isimler\nconst marketSearchQuery = 'election'\nconst isUserAuthenticated = true\nconst totalRevenue = 1000\n\n\u002F\u002F FAIL: KÖTÜ: Belirsiz isimler\nconst q = 'election'\nconst flag = true\nconst x = 1000\n```\n\n### Fonksiyon İsimlendirme\n\n```typescript\n\u002F\u002F PASS: İYİ: Fiil-isim kalıbı\nasync function fetchMarketData(marketId: string) { }\nfunction calculateSimilarity(a: number[], b: number[]) { }\nfunction isValidEmail(email: string): boolean { }\n\n\u002F\u002F FAIL: KÖTÜ: Belirsiz veya sadece isim\nasync function market(id: string) { }\nfunction similarity(a, b) { }\nfunction email(e) { }\n```\n\n### Değişmezlik Kalıbı (KRİTİK)\n\n```typescript\n\u002F\u002F PASS: HER ZAMAN spread operatörü kullanın\nconst updatedUser = {\n  ...user,\n  name: 'New Name'\n}\n\nconst updatedArray = [...items, newItem]\n\n\u002F\u002F FAIL: ASLA doğrudan mutasyon yapmayın\nuser.name = 'New Name'  \u002F\u002F KÖTÜ\nitems.push(newItem)     \u002F\u002F KÖTÜ\n```\n\n### Hata Yönetimi\n\n```typescript\n\u002F\u002F PASS: İYİ: Kapsamlı hata yönetimi\nasync function fetchData(url: string) {\n  try {\n    const response = await fetch(url)\n\n    if (!response.ok) {\n      throw new Error(`HTTP ${response.status}: ${response.statusText}`)\n    }\n\n    return await response.json()\n  } catch (error) {\n    console.error('Fetch failed:', error)\n    throw new Error('Failed to fetch data')\n  }\n}\n\n\u002F\u002F FAIL: KÖTÜ: Hata yönetimi yok\nasync function fetchData(url) {\n  const response = await fetch(url)\n  return response.json()\n}\n```\n\n### Async\u002FAwait En İyi Uygulamaları\n\n```typescript\n\u002F\u002F PASS: İYİ: Mümkün olduğunda paralel yürütme\nconst [users, markets, stats] = await Promise.all([\n  fetchUsers(),\n  fetchMarkets(),\n  fetchStats()\n])\n\n\u002F\u002F FAIL: KÖTÜ: Gereksiz yere sıralı\nconst users = await fetchUsers()\nconst markets = await fetchMarkets()\nconst stats = await fetchStats()\n```\n\n### Tür Güvenliği\n\n```typescript\n\u002F\u002F PASS: İYİ: Doğru tipler\ninterface Market {\n  id: string\n  name: string\n  status: 'active' | 'resolved' | 'closed'\n  created_at: Date\n}\n\nfunction getMarket(id: string): Promise\u003CMarket> {\n  \u002F\u002F Implementation\n}\n\n\u002F\u002F FAIL: KÖTÜ: 'any' kullanımı\nfunction getMarket(id: any): Promise\u003Cany> {\n  \u002F\u002F Implementation\n}\n```\n\n## React En İyi Uygulamaları\n\n### Bileşen Yapısı\n\n```typescript\n\u002F\u002F PASS: İYİ: Tiplerle fonksiyonel bileşen\ninterface ButtonProps {\n  children: React.ReactNode\n  onClick: () => void\n  disabled?: boolean\n  variant?: 'primary' | 'secondary'\n}\n\nexport function Button({\n  children,\n  onClick,\n  disabled = false,\n  variant = 'primary'\n}: ButtonProps) {\n  return (\n    \u003Cbutton\n      onClick={onClick}\n      disabled={disabled}\n      className={`btn btn-${variant}`}\n    >\n      {children}\n    \u003C\u002Fbutton>\n  )\n}\n\n\u002F\u002F FAIL: KÖTÜ: Tip yok, belirsiz yapı\nexport function Button(props) {\n  return \u003Cbutton onClick={props.onClick}>{props.children}\u003C\u002Fbutton>\n}\n```\n\n### Özel Hook'lar\n\n```typescript\n\u002F\u002F PASS: İYİ: Yeniden kullanılabilir özel hook\nexport function useDebounce\u003CT>(value: T, delay: number): T {\n  const [debouncedValue, setDebouncedValue] = useState\u003CT>(value)\n\n  useEffect(() => {\n    const handler = setTimeout(() => {\n      setDebouncedValue(value)\n    }, delay)\n\n    return () => clearTimeout(handler)\n  }, [value, delay])\n\n  return debouncedValue\n}\n\n\u002F\u002F Kullanım\nconst debouncedQuery = useDebounce(searchQuery, 500)\n```\n\n### State Yönetimi\n\n```typescript\n\u002F\u002F PASS: İYİ: Doğru state güncellemeleri\nconst [count, setCount] = useState(0)\n\n\u002F\u002F Önceki state'e dayalı fonksiyonel güncelleme\nsetCount(prev => prev + 1)\n\n\u002F\u002F FAIL: KÖTÜ: Doğrudan state referansı\nsetCount(count + 1)  \u002F\u002F Async senaryolarda eski olabilir\n```\n\n### Koşullu Render\n\n```typescript\n\u002F\u002F PASS: İYİ: Açık koşullu render\n{isLoading && \u003CSpinner \u002F>}\n{error && \u003CErrorMessage error={error} \u002F>}\n{data && \u003CDataDisplay data={data} \u002F>}\n\n\u002F\u002F FAIL: KÖTÜ: Ternary cehennemi\n{isLoading ? \u003CSpinner \u002F> : error ? \u003CErrorMessage error={error} \u002F> : data ? \u003CDataDisplay data={data} \u002F> : null}\n```\n\n## API Tasarım Standartları\n\n### REST API Kuralları\n\n```\nGET    \u002Fapi\u002Fmarkets              # Tüm marketleri listele\nGET    \u002Fapi\u002Fmarkets\u002F:id          # Belirli marketi getir\nPOST   \u002Fapi\u002Fmarkets              # Yeni market oluştur\nPUT    \u002Fapi\u002Fmarkets\u002F:id          # Marketi güncelle (tam)\nPATCH  \u002Fapi\u002Fmarkets\u002F:id          # Marketi güncelle (kısmi)\nDELETE \u002Fapi\u002Fmarkets\u002F:id          # Marketi sil\n\n# Filtreleme için query parametreleri\nGET \u002Fapi\u002Fmarkets?status=active&limit=10&offset=0\n```\n\n### Response Formatı\n\n```typescript\n\u002F\u002F PASS: İYİ: Tutarlı response yapısı\ninterface ApiResponse\u003CT> {\n  success: boolean\n  data?: T\n  error?: string\n  meta?: {\n    total: number\n    page: number\n    limit: number\n  }\n}\n\n\u002F\u002F Başarılı response\nreturn NextResponse.json({\n  success: true,\n  data: markets,\n  meta: { total: 100, page: 1, limit: 10 }\n})\n\n\u002F\u002F Hata response\nreturn NextResponse.json({\n  success: false,\n  error: 'Invalid request'\n}, { status: 400 })\n```\n\n### Input Doğrulama\n\n```typescript\nimport { z } from 'zod'\n\n\u002F\u002F PASS: İYİ: Schema doğrulama\nconst CreateMarketSchema = z.object({\n  name: z.string().min(1).max(200),\n  description: z.string().min(1).max(2000),\n  endDate: z.string().datetime(),\n  categories: z.array(z.string()).min(1)\n})\n\nexport async function POST(request: Request) {\n  const body = await request.json()\n\n  try {\n    const validated = CreateMarketSchema.parse(body)\n    \u002F\u002F Doğrulanmış veriyle devam et\n  } catch (error) {\n    if (error instanceof z.ZodError) {\n      return NextResponse.json({\n        success: false,\n        error: 'Validation failed',\n        details: error.errors\n      }, { status: 400 })\n    }\n  }\n}\n```\n\n## Dosya Organizasyonu\n\n### Proje Yapısı\n\n```\nsrc\u002F\n├── app\u002F                    # Next.js App Router\n│   ├── api\u002F               # API routes\n│   ├── markets\u002F           # Market sayfaları\n│   └── (auth)\u002F           # Auth sayfaları (route groups)\n├── components\u002F            # React bileşenleri\n│   ├── ui\u002F               # Genel UI bileşenleri\n│   ├── forms\u002F            # Form bileşenleri\n│   └── layouts\u002F          # Layout bileşenleri\n├── hooks\u002F                # Özel React hooks\n├── lib\u002F                  # Yardımcı araçlar ve konfigürasyonlar\n│   ├── api\u002F             # API istemcileri\n│   ├── utils\u002F           # Yardımcı fonksiyonlar\n│   └── constants\u002F       # Sabitler\n├── types\u002F                # TypeScript tipleri\n└── styles\u002F              # Global stiller\n```\n\n### Dosya İsimlendirme\n\n```\ncomponents\u002FButton.tsx          # Bileşenler için PascalCase\nhooks\u002FuseAuth.ts              # 'use' öneki ile camelCase\nlib\u002FformatDate.ts             # Yardımcı araçlar için camelCase\ntypes\u002Fmarket.types.ts         # .types soneki ile camelCase\n```\n\n## Yorumlar ve Dokümantasyon\n\n### Ne Zaman Yorum Yapmalı\n\n```typescript\n\u002F\u002F PASS: İYİ: NİÇİN'i açıklayın, NE'yi değil\n\u002F\u002F Kesintiler sırasında API'yi aşırı yüklemekten kaçınmak için exponential backoff kullan\nconst delay = Math.min(1000 * Math.pow(2, retryCount), 30000)\n\n\u002F\u002F Büyük dizilerle performans için burada kasıtlı olarak mutasyon kullanılıyor\nitems.push(newItem)\n\n\u002F\u002F FAIL: KÖTÜ: Açık olanı belirtmek\n\u002F\u002F Sayacı 1 artır\ncount++\n\n\u002F\u002F İsmi kullanıcının ismine ayarla\nname = user.name\n```\n\n### Public API'ler için JSDoc\n\n```typescript\n\u002F**\n * Semantik benzerlik kullanarak market arar.\n *\n * @param query - Doğal dil arama sorgusu\n * @param limit - Maksimum sonuç sayısı (varsayılan: 10)\n * @returns Benzerlik skoruna göre sıralanmış market dizisi\n * @throws {Error} OpenAI API başarısız olursa veya Redis kullanılamazsa\n *\n * @example\n * ```typescript\n * const results = await searchMarkets('election', 5)\n * console.log(results[0].name) \u002F\u002F \"Trump vs Biden\"\n * ```\n *\u002F\nexport async function searchMarkets(\n  query: string,\n  limit: number = 10\n): Promise\u003CMarket[]> {\n  \u002F\u002F Implementation\n}\n```\n\n## Performans En İyi Uygulamaları\n\n### Memoization\n\n```typescript\nimport { useMemo, useCallback } from 'react'\n\n\u002F\u002F PASS: İYİ: Pahalı hesaplamaları memoize et\nconst sortedMarkets = useMemo(() => {\n  return markets.sort((a, b) => b.volume - a.volume)\n}, [markets])\n\n\u002F\u002F PASS: İYİ: Callback'leri memoize et\nconst handleSearch = useCallback((query: string) => {\n  setSearchQuery(query)\n}, [])\n```\n\n### Lazy Loading\n\n```typescript\nimport { lazy, Suspense } from 'react'\n\n\u002F\u002F PASS: İYİ: Ağır bileşenleri lazy yükle\nconst HeavyChart = lazy(() => import('.\u002FHeavyChart'))\n\nexport function Dashboard() {\n  return (\n    \u003CSuspense fallback={\u003CSpinner \u002F>}>\n      \u003CHeavyChart \u002F>\n    \u003C\u002FSuspense>\n  )\n}\n```\n\n### Veritabanı Sorguları\n\n```typescript\n\u002F\u002F PASS: İYİ: Sadece gerekli sütunları seç\nconst { data } = await supabase\n  .from('markets')\n  .select('id, name, status')\n  .limit(10)\n\n\u002F\u002F FAIL: KÖTÜ: Her şeyi seç\nconst { data } = await supabase\n  .from('markets')\n  .select('*')\n```\n\n## Test Standartları\n\n### Test Yapısı (AAA Kalıbı)\n\n```typescript\ntest('benzerliği doğru hesaplar', () => {\n  \u002F\u002F Arrange (Hazırla)\n  const vector1 = [1, 0, 0]\n  const vector2 = [0, 1, 0]\n\n  \u002F\u002F Act (İşle)\n  const similarity = calculateCosineSimilarity(vector1, vector2)\n\n  \u002F\u002F Assert (Doğrula)\n  expect(similarity).toBe(0)\n})\n```\n\n### Test İsimlendirme\n\n```typescript\n\u002F\u002F PASS: İYİ: Açıklayıcı test isimleri\ntest('sorguya uygun market bulunamadığında boş dizi döndürür', () => { })\ntest('OpenAI API anahtarı eksikse hata fırlatır', () => { })\ntest('Redis kullanılamazsa substring aramaya geri döner', () => { })\n\n\u002F\u002F FAIL: KÖTÜ: Belirsiz test isimleri\ntest('çalışır', () => { })\ntest('arama testi', () => { })\n```\n\n## Kod Kokusu Tespiti\n\nBu anti-kalıplara dikkat edin:\n\n### 1. Uzun Fonksiyonlar\n```typescript\n\u002F\u002F FAIL: KÖTÜ: 50 satırdan uzun fonksiyon\nfunction processMarketData() {\n  \u002F\u002F 100 satır kod\n}\n\n\u002F\u002F PASS: İYİ: Küçük fonksiyonlara böl\nfunction processMarketData() {\n  const validated = validateData()\n  const transformed = transformData(validated)\n  return saveData(transformed)\n}\n```\n\n### 2. Derin İç İçe Geçme\n```typescript\n\u002F\u002F FAIL: KÖTÜ: 5+ seviye iç içe geçme\nif (user) {\n  if (user.isAdmin) {\n    if (market) {\n      if (market.isActive) {\n        if (hasPermission) {\n          \u002F\u002F Bir şeyler yap\n        }\n      }\n    }\n  }\n}\n\n\u002F\u002F PASS: İYİ: Erken dönüşler\nif (!user) return\nif (!user.isAdmin) return\nif (!market) return\nif (!market.isActive) return\nif (!hasPermission) return\n\n\u002F\u002F Bir şeyler yap\n```\n\n### 3. Sihirli Sayılar\n```typescript\n\u002F\u002F FAIL: KÖTÜ: Açıklanmamış sayılar\nif (retryCount > 3) { }\nsetTimeout(callback, 500)\n\n\u002F\u002F PASS: İYİ: İsimlendirilmiş sabitler\nconst MAX_RETRIES = 3\nconst DEBOUNCE_DELAY_MS = 500\n\nif (retryCount > MAX_RETRIES) { }\nsetTimeout(callback, DEBOUNCE_DELAY_MS)\n```\n\n**Unutmayın**: Kod kalitesi pazarlık konusu değildir. Açık, sürdürülebilir kod hızlı geliştirme ve güvenli refactoring sağlar.\n",{"name":5,"origin":24,"description":7},"ECC","main","57e7aa6b6e03bce1a7d7862ba9c2ec312f7f19b5","src\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Ftr\u002Fskills\u002Fcoding-standards",0,"https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee","https:\u002F\u002Fwithcyril.me\u002F","Hi, I’m Julian Cyril D, a Computer Science and Business Systems student at PSNACET.\r\nI’m passionate about full-stack development, UI\u002FUX design, and building sma","2026-11-04 23:28:50",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add Cyrilthetecchieee\u002Fcyril-code- --skill coding-standards",{"tool":40,"command":41},"bunx","bunx skills add Cyrilthetecchieee\u002Fcyril-code- --skill coding-standards",{"tool":43,"command":44},"pnpm","pnpm dlx skills add Cyrilthetecchieee\u002Fcyril-code- --skill coding-standards","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Ftr\u002Fskills\u002Fcoding-standards\u002FSKILL.md",true,[],[49,58,65,73,80,87],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":53,"licenseFileUrl":54,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":19},"01M7AQV6CYX8RMC78420V9WZ62","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fwebapp-testing\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M7AQV2895N3S1MEX6K76G6G2","youtube-downloader","Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fvideo-downloader\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":53,"licenseFileUrl":69,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M7AQTRNX62DNKVZ5GXEHRBKB","theme-factory","Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors\u002Ffonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftheme-factory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftheme-factory\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7AQTNNVHAAN9H6DA8T6ZVE0","template-skill","Replace with description of the skill and when Claude should use it.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftemplate-skill\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7AQTJ3MQ6AKX152MEX2MYCC","tailored-resume-generator","Analyzes job descriptions and generates tailored resumes that highlight relevant experience, skills, and achievements to maximize interview chances","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftailored-resume-generator\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":53,"licenseFileUrl":91,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M7AQTD7D5MYET2YWG7HG9WM3","slack-gif-creator","Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives. This skill applies when users request animated GIFs or emoji animations for Slack from descriptions like \"make me a GIF for Slack of X doing Y\".","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fslack-gif-creator\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fslack-gif-creator\u002FSKILL.md",[],[]]