Coding Standards

Kodlama Standartları

Genel Kurallar

İsimlendirme

Prensipler

• ✅ Açıklayıcı: getUserById not getUser
• ✅ Boolean: is, has, can prefix
• ✅ Array: çoğul users, items
• ❌ Kısaltma: configuration not cfg
• ❌ Type prefix: IUser

Fonksiyon Kuralları

• Max satır: 20 (ideal: 10-15)
• Max parametre: 3 (fazlaysa options object)

async function getUserById(userId: string): Promise<User | null> {
  // 1. Early return / validation
  if (!userId) {
    throw new ValidationError('userId required')
  }

  // 2. Main logic
  const user = await userRepository.findById(userId)
  
  // 3. Return
  return user
}

Error Handling

// ✅ Specific error, meaningful message
throw new ValidationError('Email format invalid', { field: 'email' })

// ✅ Error'ı yakala ve handle et
try {
  await riskyOperation()
} catch (error) {
  if (error instanceof ValidationError) {
    // handle
  } else {
    logger.error('Unexpected', { error })
    throw error
  }
}

// ❌ Generic error
throw new Error('Error')

// ❌ Error yutma
try { ... } catch { /* sessiz */ }

Import Sırası

// 1. Built-in
import path from 'path'

// 2. External (alphabetical)
import express from 'express'

// 3. Internal (@/ paths)
import { UserService } from '@/services/user-service'

// 4. Relative
import { helper } from './helper'

// 5. Types
import type { User } from '@/types'

Code Smells

Edit/str_replace Best Practices

Anthropic SWE-Bench araştırmasına göre, doğru edit stratejisi başarı oranını önemli ölçüde artırır.

Temel Kurallar

str_replace Stratejisi

// ✅ DOĞRU: Yeterli context ile unique match
old_str: `
  async function getUserById(userId: string) {
    if (!userId) {
      throw new Error('userId required')
    }
    return await db.users.findById(userId)
  }
`

// ❌ YANLIŞ: Çok kısa, unique olmayabilir
old_str: `return await db.users.findById(userId)`

Hata Durumunda

Hata: "old_str not found" veya "multiple matches"

1. Dosyayı oku → mevcut içeriği gör
2. Daha geniş context ekle (±3 satır)
3. Whitespace'leri kontrol et (tab vs space)
4. Tekrar dene

Edit Sırası

1. Önce oku → Dosyanın mevcut halini anla
2. Küçük parçalar → Tek seferde 20 satırdan fazla değiştirme
3. Doğrula → Her edit sonrası oku
4. Lint kontrol → Syntax hatası olmadığından emin ol

Commit Messages

<type>(<scope>): <description>

[body]
[footer]