GitHub SpecKit: AI Kod Üretimini Kaostan Üretime Hazır Sistemlere Dönüştürme

Hiç bir AI aracının kod ürettiğini izleyip "Bu çalışıyor ama bunu production'a asla göndermem" diye düşündün mü? Yalnız değilsin. AI kodlama araçları prototip geliştirme hızımızı devrim niteliğinde artırdı, ancak çoğu zaman yapılandırılmamış, sürdürülmesi zor kod üretiyorlar - ki bu da çözümden çok sorun yaratıyor.

Bu kalıp geliştirme takımlarında ortaya çıkıyor: daha hızlı development için AI araçlarını benimsiyor, ancak alarma verici oranda teknik borç biriktiriyorlar. AI hızı yapı ve spesifikasyon olmadan uzun vadede pahalıya mal oluyor. Üretilen kod demolar için çalışıyor ama ölçeklendirmesi refactoring ve debugging kabusu haline geliyor.

AI destekli development ile çalışmak bana yapının her şeyi değiştirdiğini öğretti. Specification-driven bir yaklaşım kaotik kod üretimini sürdürülebilir, üretime hazır sistemler üreten sistematik geliştirmeye dönüştürüyor. Senin deneyimin farklı olabilir, ancak önceden açık gereksinimler belirlemek sürekli olarak AI araçlarının doğru tahmin etmesini ummaktan daha iyi sonuçlar veriyor. SpecKit'in dört aşaması (Constitution, Specify, Clarify, Plan) tam da bu boşluğu dolduruyor – önce ne istediğini netleştir, sonra implementasyona geç.

Yapılandırılmamış AI Kod Üretiminin Gizli Maliyeti

Çoğu developer AI araçlarıyla doğrudan implementasyona atlıyor, onlara belirsiz promptlar veriyor ve en iyisini umuyorlar. Bu "vibe coding" yaklaşımı hızlı MVP'ler için işe yarıyor ama takımlarla çalışırken bunun birkaç sorun yarattığını gördüm:

typescript

// Spesifikasyon olmadan tipik AI üretimi kodfunction processUserData(data: any): any {  // AI ne istediğini tahmin etmeye çalışır  const result = data.map((item: any) => {    if (item.type === 'user') {      return { ...item, processed: true };    }    return item;  });  return result;}

// Spesifikasyon olmadan tipik AI üretimi kodfunction processUserData(data: any): any {  // AI ne istediğini tahmin etmeye çalışır  const result = data.map((item: any) => {    if (item.type === 'user') {      return { ...item, processed: true };    }    return item;  });  return result;}

Açık spesifikasyonlar olmadan, AI araçları gereksinimler, mimari ve implementation detayları hakkında varsayımlar yapar. Sonuç teknik olarak çalışan ama production sistemler için gereken yapı ve sürdürülebilirlikten yoksun kod oluyor. SpecKit bu boşluğu specification-driven yaklaşımla kapatmayı hedefliyor. Kısa vadede "vibe coding" hızlı demolar üretir; uzun vadede bakım maliyeti ve debugging süresi artar.

Yapılandırılmış AI Development için Framework

SpecKit, AI kodlamasını kaotik üretimden sistematik geliştirmeye yapılandırılmış bir workflow ile dönüştürüyor:

Bu yapılandırılmış workflow, AI araçlarının sadece neyi değil, projenin prensipleri ve standartlarına göre nasıl doğru geliştireceğini anlamasını sağlıyor.

1. Aşama: Constitution (Opsiyonel) - Proje Prensiplerini Belirle

Constitution aşaması, spesifik gereksinimlere dalmadan önce projenin temel prensiplerini ve standartlarını belirlemeye yardımcı olur.

bash

# Proje constitution'ı oluştur/constitution
# Örnek proje constitution'ı"Bu authentication sistemi şunları öncelemeli:- Kolaylık yerine güvenlik- Sessiz hatalar yerine açık error handling- Akıllı implementasyonlar yerine test edilebilir kod- Self-documenting kod yerine açık dokümantasyon- Cutting-edge özellikler yerine progressive enhancement"

# Proje constitution'ı oluştur/constitution
# Örnek proje constitution'ı"Bu authentication sistemi şunları öncelemeli:- Kolaylık yerine güvenlik- Sessiz hatalar yerine açık error handling- Akıllı implementasyonlar yerine test edilebilir kod- Self-documenting kod yerine açık dokümantasyon- Cutting-edge özellikler yerine progressive enhancement"

2. Aşama: Specify - Ne Geliştirdiğini Tanımla

Spesifikasyon aşaması, kod üretilmeden önce gereksinimlerini açıkça formüle etmeni zorlar. Bu, AI araçlarının ihtiyaçların hakkında yanlış varsayımlar yapması klasik sorununu önler.

Kurulum ve Yapılandırma

bash

# Tek kullanımlık kurulumuvx --from git+https://github.com/github/spec-kit.git specify init my-project
# Kalıcı kurulum (önerilen)uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
# Belirli AI araçları için yapılandırmaspecify init my-project --ai claude    # Claude Code içinspecify init my-project --ai copilot   # GitHub Copilot içinspecify init my-project --ai gemini    # Gemini CLI için
# Mevcut projede başlatmaspecify init --here --ai claude

# Tek kullanımlık kurulumuvx --from git+https://github.com/github/spec-kit.git specify init my-project
# Kalıcı kurulum (önerilen)uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
# Belirli AI araçları için yapılandırmaspecify init my-project --ai claude    # Claude Code içinspecify init my-project --ai copilot   # GitHub Copilot içinspecify init my-project --ai gemini    # Gemini CLI için
# Mevcut projede başlatmaspecify init --here --ai claude

İlk Spesifikasyonunu Oluştur

bash

# Spesifikasyon sürecini başlat/specify
# Kullanıcı authentication sistemi için örnek spesifikasyon"Next.js uygulaması için şunları destekleyen kullanıcı authentication sistemi geliştir:- Email/şifre ile kayıt ve giriş- Refresh tokenlarla JWT token yönetimi- Email ile şifre sıfırlama işlevi- Auth endpointler için rate limiting- Mevcut TypeScript codebase ile entegrasyon- Production kullanımı için güvenlik best practiceslerine uyum"

# Spesifikasyon sürecini başlat/specify
# Kullanıcı authentication sistemi için örnek spesifikasyon"Next.js uygulaması için şunları destekleyen kullanıcı authentication sistemi geliştir:- Email/şifre ile kayıt ve giriş- Refresh tokenlarla JWT token yönetimi- Email ile şifre sıfırlama işlevi- Auth endpointler için rate limiting- Mevcut TypeScript codebase ile entegrasyon- Production kullanımı için güvenlik best practiceslerine uyum"

SpecKit bu üst düzey açıklamayı detaylı user storyler ve kabul kriterlerine dönüştürür:

markdown

## SpecKit Tarafından Üretilen User Storyler
### Epic: Kullanıcı Authentication Sistemi- **US-001**: Yeni kullanıcı olarak, uygulamaya erişebilmek için email/şifre ile kayıt olmak istiyorum- **US-002**: Kayıtlı kullanıcı olarak, korumalı özelliklere erişmek için kimlik bilgilerimle giriş yapmak istiyorum- **US-003**: Kullanıcı olarak, unutursam hesabıma yeniden erişmek için şifremi sıfırlamak istiyorum- **US-004**: Sistem olarak, brute force saldırılarını önlemek için authentication denemelerini sınırlamak istiyorum
### Kabul Kriterleri- Kayıt geçerli email formatı ve şifre güçlü doğrulaması gerektirir- JWT tokenları yapılandırılabilir süre sonra expire olur- Refresh tokenlar kesintisiz session uzatmayı sağlar- Şifre sıfırlama emailleri 15 dakika sonra expire olur- Rate limiting IP başına dakikada maksimum 5 denemeye izin verir

## SpecKit Tarafından Üretilen User Storyler
### Epic: Kullanıcı Authentication Sistemi- **US-001**: Yeni kullanıcı olarak, uygulamaya erişebilmek için email/şifre ile kayıt olmak istiyorum- **US-002**: Kayıtlı kullanıcı olarak, korumalı özelliklere erişmek için kimlik bilgilerimle giriş yapmak istiyorum- **US-003**: Kullanıcı olarak, unutursam hesabıma yeniden erişmek için şifremi sıfırlamak istiyorum- **US-004**: Sistem olarak, brute force saldırılarını önlemek için authentication denemelerini sınırlamak istiyorum
### Kabul Kriterleri- Kayıt geçerli email formatı ve şifre güçlü doğrulaması gerektirir- JWT tokenları yapılandırılabilir süre sonra expire olur- Refresh tokenlar kesintisiz session uzatmayı sağlar- Şifre sıfırlama emailleri 15 dakika sonra expire olur- Rate limiting IP başına dakikada maksimum 5 denemeye izin verir

3. Aşama: Clarify (Opsiyonel) - Belirsiz Alanları Gider

Clarify aşaması, teknik planlamaya geçmeden önce gereksinimlerdeki belirsizlikleri veya eksik detayları çözmeye yardımcı olur.

bash

# Belirsiz alanları açıklığa kavuştur/clarify
# SpecKit belirsiz gereksinimleri tanımlar ve çözmeye yardımcı olur"Sistem aynı kullanıcıdan gelen eşzamanlı giriş denemelerini nasıl ele almalı?""Kullanıcı zaten kullanımda olan bir email ile kayıt olmaya çalışırsa ne olacak?""Şifre sıfırlama tokenları tek kullanımlık mı yoksa yeniden kullanılabilir mi?"

# Belirsiz alanları açıklığa kavuştur/clarify
# SpecKit belirsiz gereksinimleri tanımlar ve çözmeye yardımcı olur"Sistem aynı kullanıcıdan gelen eşzamanlı giriş denemelerini nasıl ele almalı?""Kullanıcı zaten kullanımda olan bir email ile kayıt olmaya çalışırsa ne olacak?""Şifre sıfırlama tokenları tek kullanımlık mı yoksa yeniden kullanılabilir mi?"

4. Aşama: Plan - Mimari ve Teknik Kararları Tanımla

Planlama aşaması teknik stack'ini ve mimari kısıtlarını belirler. Bu, AI araçlarının mevcut sistemlerinle uyumlu olmayan keyfi teknoloji seçimleri yapmasını önler.

bash

/plan
# Teknik kısıtlarını tanımla"Tech stack: Next.js 15 App Router ile, TypeScript, PostgreSQL ile Prisma ORMMimari: Auth operasyonları için server actionlar, route koruma için middlewareGüvenlik: Şifre hashleme için bcrypt, JWT işleme için joseEmail: SMTP ile NodemailerKısıtlar: Mevcut shadcn/ui componentleriyle entegre olmalı, güncel proje yapısını takip etmeli"

/plan
# Teknik kısıtlarını tanımla"Tech stack: Next.js 15 App Router ile, TypeScript, PostgreSQL ile Prisma ORMMimari: Auth operasyonları için server actionlar, route koruma için middlewareGüvenlik: Şifre hashleme için bcrypt, JWT işleme için joseEmail: SMTP ile NodemailerKısıtlar: Mevcut shadcn/ui componentleriyle entegre olmalı, güncel proje yapısını takip etmeli"

SpecKit kapsamlı bir teknik plan üretir:

markdown

## Teknik Mimari Planı
### Teknoloji Stack'i- **Frontend**: Next.js 15 App Router, TypeScript, shadcn/ui- **Backend**: Next.js API routes, Server Actions- **Database**: PostgreSQL Prisma ORM ile- **Authentication**: Refresh tokenları ile JWT- **Güvenlik**: bcrypt, jose, rate-limiting middleware- **Email**: SMTP yapılandırmasıyla Nodemailer
### Database Şeması```sql-- Users tablosuCREATE TABLE users (  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),  email VARCHAR(255) UNIQUE NOT NULL,  password_hash VARCHAR(255) NOT NULL,  created_at TIMESTAMP DEFAULT NOW(),  updated_at TIMESTAMP DEFAULT NOW());
-- Refresh tokens tablosuCREATE TABLE refresh_tokens (  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),  user_id UUID REFERENCES users(id) ON DELETE CASCADE,  token VARCHAR(255) UNIQUE NOT NULL,  expires_at TIMESTAMP NOT NULL,  created_at TIMESTAMP DEFAULT NOW());

## Teknik Mimari Planı
### Teknoloji Stack'i- **Frontend**: Next.js 15 App Router, TypeScript, shadcn/ui- **Backend**: Next.js API routes, Server Actions- **Database**: PostgreSQL Prisma ORM ile- **Authentication**: Refresh tokenları ile JWT- **Güvenlik**: bcrypt, jose, rate-limiting middleware- **Email**: SMTP yapılandırmasıyla Nodemailer
### Database Şeması```sql-- Users tablosuCREATE TABLE users (  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),  email VARCHAR(255) UNIQUE NOT NULL,  password_hash VARCHAR(255) NOT NULL,  created_at TIMESTAMP DEFAULT NOW(),  updated_at TIMESTAMP DEFAULT NOW());
-- Refresh tokens tablosuCREATE TABLE refresh_tokens (  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),  user_id UUID REFERENCES users(id) ON DELETE CASCADE,  token VARCHAR(255) UNIQUE NOT NULL,  expires_at TIMESTAMP NOT NULL,  created_at TIMESTAMP DEFAULT NOW());

Güvenlik Hususları

bcrypt ile şifre hashleme (salt rounds: 12)
JWT access tokenları (15 dakika expiry)
Refresh tokenları (7 gün expiry)
Rate limiting: IP başına dakikada 5 deneme
SameSite cookies ile CSRF koruma


## 5. Aşama: Tasks - Implementasyonu Yönetilebilir Adımlara Böl
Task aşaması AI'ın sistematik olarak takip edebileceği Jira benzeri bir development planı oluşturur. Bu, her şeyi bir anda implement etmeye çalışmanın bunaltıcı yaklaşımını önler.
```bash/tasks


## 5. Aşama: Tasks - Implementasyonu Yönetilebilir Adımlara Böl
Task aşaması AI'ın sistematik olarak takip edebileceği Jira benzeri bir development planı oluşturur. Bu, her şeyi bir anda implement etmeye çalışmanın bunaltıcı yaklaşımını önler.
```bash/tasks

SpecKit numaralandırılmış, öncelik sıralı, açık bağımlılıklara sahip tasklar üretir:

markdown

## Implementation Taskları
### Setup ve Yapılandırma (Öncelik: Yüksek)1. **Task 1**: Users ve refresh_tokens tabloları için Prisma şeması kurulumu   - Bağımlılıklar: Yok   - Tahmini süre: 30 dakika   - Çıktı: Migrationlarla çalışan database şeması
2. **Task 2**: Authentication utilities oluştur (şifre hashleme, JWT işleme)   - Bağımlılıklar: Task 1   - Tahmini süre: 45 dakika   - Çıktı: Auth operasyonları için utility fonksiyonlar
3. **Task 3**: Rate limiting middleware implement et   - Bağımlılıklar: Yok   - Tahmini süre: 30 dakika   - Çıktı: Redis/memory store ile middleware fonksiyon
### Authentication Implementation (Öncelik: Yüksek)4. **Task 4**: Kayıt server action geliştir   - Bağımlılıklar: Task 1, Task 2   - Tahmini süre: 1 saat   - Çıktı: Validasyonla kayıt endpoint
5. **Task 5**: JWT üretimiyle login server action geliştir   - Bağımlılıklar: Task 1, Task 2   - Tahmini süre: 1 saat   - Çıktı: Access/refresh tokenları dönen login endpoint
6. **Task 6**: Token refresh mekanizması implement et   - Bağımlılıklar: Task 2, Task 5   - Tahmini süre: 45 dakika   - Çıktı: Token refresh endpoint
### UI Components (Öncelik: Orta)7. **Task 7**: shadcn/ui bileşenleriyle login formu oluştur   - Bağımlılıklar: Task 5   - Tahmini süre: 1 saat   - Çıktı: Validasyonlu stilli login formu
8. **Task 8**: Kayıt formu oluştur   - Bağımlılıklar: Task 4   - Tahmini süre: 1 saat   - Çıktı: Şifre güç validasyonuyla kayıt formu

## Implementation Taskları
### Setup ve Yapılandırma (Öncelik: Yüksek)1. **Task 1**: Users ve refresh_tokens tabloları için Prisma şeması kurulumu   - Bağımlılıklar: Yok   - Tahmini süre: 30 dakika   - Çıktı: Migrationlarla çalışan database şeması
2. **Task 2**: Authentication utilities oluştur (şifre hashleme, JWT işleme)   - Bağımlılıklar: Task 1   - Tahmini süre: 45 dakika   - Çıktı: Auth operasyonları için utility fonksiyonlar
3. **Task 3**: Rate limiting middleware implement et   - Bağımlılıklar: Yok   - Tahmini süre: 30 dakika   - Çıktı: Redis/memory store ile middleware fonksiyon
### Authentication Implementation (Öncelik: Yüksek)4. **Task 4**: Kayıt server action geliştir   - Bağımlılıklar: Task 1, Task 2   - Tahmini süre: 1 saat   - Çıktı: Validasyonla kayıt endpoint
5. **Task 5**: JWT üretimiyle login server action geliştir   - Bağımlılıklar: Task 1, Task 2   - Tahmini süre: 1 saat   - Çıktı: Access/refresh tokenları dönen login endpoint
6. **Task 6**: Token refresh mekanizması implement et   - Bağımlılıklar: Task 2, Task 5   - Tahmini süre: 45 dakika   - Çıktı: Token refresh endpoint
### UI Components (Öncelik: Orta)7. **Task 7**: shadcn/ui bileşenleriyle login formu oluştur   - Bağımlılıklar: Task 5   - Tahmini süre: 1 saat   - Çıktı: Validasyonlu stilli login formu
8. **Task 8**: Kayıt formu oluştur   - Bağımlılıklar: Task 4   - Tahmini süre: 1 saat   - Çıktı: Şifre güç validasyonuyla kayıt formu

6. Aşama: Implement - Taskları Sistematik Olarak Gerçekleştir

Implementation aşaması taskları teker teker gerçekleştirir, her adımda review ve iterasyona imkan tanır. Bu hataların birikmesini önler ve development boyunca kod kalitesini garanti eder.

Task 1 Implementation Örneği

typescript

// prisma/schema.prisma - SpecKit guidance ile üretildimodel User {  id            String         @id @default(cuid())  email         String         @unique  passwordHash  String         @map("password_hash")  createdAt     DateTime       @default(now()) @map("created_at")  updatedAt     DateTime       @updatedAt @map("updated_at")  refreshTokens RefreshToken[]
  @@map("users")}
model RefreshToken {  id        String   @id @default(cuid())  userId    String   @map("user_id")  token     String   @unique  expiresAt DateTime @map("expires_at")  createdAt DateTime @default(now()) @map("created_at")  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
  @@map("refresh_tokens")}

// prisma/schema.prisma - SpecKit guidance ile üretildimodel User {  id            String         @id @default(cuid())  email         String         @unique  passwordHash  String         @map("password_hash")  createdAt     DateTime       @default(now()) @map("created_at")  updatedAt     DateTime       @updatedAt @map("updated_at")  refreshTokens RefreshToken[]
  @@map("users")}
model RefreshToken {  id        String   @id @default(cuid())  userId    String   @map("user_id")  token     String   @unique  expiresAt DateTime @map("expires_at")  createdAt DateTime @default(now()) @map("created_at")  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
  @@map("refresh_tokens")}

Task 2 Implementation Örneği

typescript

// lib/auth.ts - Düzgün error handling ile utility fonksiyonlarimport bcrypt from 'bcryptjs';import { SignJWT, jwtVerify } from 'jose';
export class AuthError extends Error {  constructor(message: string, public code: string) {    super(message);    this.name = 'AuthError';  }}
export async function hashPassword(password: string): Promise<string> {  try {    return await bcrypt.hash(password, 12);  } catch (error) {    throw new AuthError('Şifre hashleme başarısız', 'HASH_ERROR');  }}
export async function verifyPassword(  password: string,  hash: string): Promise<boolean> {  try {    return await bcrypt.compare(password, hash);  } catch (error) {    throw new AuthError('Şifre doğrulama başarısız', 'VERIFY_ERROR');  }}
export async function generateAccessToken(  payload: { userId: string; email: string }): Promise<string> {  const secret = new TextEncoder().encode(process.env.JWT_SECRET);
  return new SignJWT(payload)    .setProtectedHeader({ alg: 'HS256' })    .setExpirationTime('15m')    .setIssuedAt()    .sign(secret);}
export async function verifyAccessToken(  token: string): Promise<{ userId: string; email: string }> {  try {    const secret = new TextEncoder().encode(process.env.JWT_SECRET);    const { payload } = await jwtVerify(token, secret);
    return payload as { userId: string; email: string };  } catch (error) {    throw new AuthError('Geçersiz token', 'TOKEN_INVALID');  }}

// lib/auth.ts - Düzgün error handling ile utility fonksiyonlarimport bcrypt from 'bcryptjs';import { SignJWT, jwtVerify } from 'jose';
export class AuthError extends Error {  constructor(message: string, public code: string) {    super(message);    this.name = 'AuthError';  }}
export async function hashPassword(password: string): Promise<string> {  try {    return await bcrypt.hash(password, 12);  } catch (error) {    throw new AuthError('Şifre hashleme başarısız', 'HASH_ERROR');  }}
export async function verifyPassword(  password: string,  hash: string): Promise<boolean> {  try {    return await bcrypt.compare(password, hash);  } catch (error) {    throw new AuthError('Şifre doğrulama başarısız', 'VERIFY_ERROR');  }}
export async function generateAccessToken(  payload: { userId: string; email: string }): Promise<string> {  const secret = new TextEncoder().encode(process.env.JWT_SECRET);
  return new SignJWT(payload)    .setProtectedHeader({ alg: 'HS256' })    .setExpirationTime('15m')    .setIssuedAt()    .sign(secret);}
export async function verifyAccessToken(  token: string): Promise<{ userId: string; email: string }> {  try {    const secret = new TextEncoder().encode(process.env.JWT_SECRET);    const { payload } = await jwtVerify(token, secret);
    return payload as { userId: string; email: string };  } catch (error) {    throw new AuthError('Geçersiz token', 'TOKEN_INVALID');  }}

Kalite Farkı: SpecKit Öncesi vs Sonrası

SpecKit Öncesi (Tipik AI Üretimi)

typescript

// Yapılandırılmamış AI üretimi authexport default async function handler(req: any, res: any) {  if (req.method === 'POST') {    const { email, password } = req.body;    // Şifreyi bir şekilde hashle    const hash = bcrypt.hashSync(password, 10);    // Databaseye kaydet    const user = await prisma.user.create({      data: { email, password: hash }    });    // Bir şey dön    res.json({ success: true });  }}

// Yapılandırılmamış AI üretimi authexport default async function handler(req: any, res: any) {  if (req.method === 'POST') {    const { email, password } = req.body;    // Şifreyi bir şekilde hashle    const hash = bcrypt.hashSync(password, 10);    // Databaseye kaydet    const user = await prisma.user.create({      data: { email, password: hash }    });    // Bir şey dön    res.json({ success: true });  }}

SpecKit Sonrası (Specification-Driven)

typescript

// server/auth/register.ts - Yapılandırılmış, sürdürülebilir implementationimport { z } from 'zod';import { ratelimit } from '@/lib/rate-limit';import { hashPassword } from '@/lib/auth';import { prisma } from '@/lib/prisma';
const registerSchema = z.object({  email: z.string().email('Geçersiz email formatı'),  password: z.string()    .min(8, 'Şifre en az 8 karakter olmalı')    .regex(/^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)/,           'Şifre büyük harf, küçük harf ve sayı içermeli')});
export async function registerUser(formData: FormData) {  // Rate limiting  const { success } = await ratelimit.limit('auth_register');  if (!success) {    throw new Error('Çok fazla kayıt denemesi. Lütfen daha sonra tekrar deneyin.');  }
  // Input validation  const result = registerSchema.safeParse({    email: formData.get('email'),    password: formData.get('password')  });
  if (!result.success) {    throw new Error(`Validasyon hatası: ${result.error.issues.map(i => i.message).join(', ')}`);  }
  const { email, password } = result.data;
  try {    // Kullanıcı var mı kontrol et    const existingUser = await prisma.user.findUnique({      where: { email }    });
    if (existingUser) {      throw new Error('Bu email ile kullanıcı zaten mevcut');    }
    // Hashlenmiş şifre ile kullanıcı oluştur    const passwordHash = await hashPassword(password);    const user = await prisma.user.create({      data: {        email,        passwordHash      },      select: {        id: true,        email: true,        createdAt: true      }    });
    return { success: true, user };  } catch (error) {    if (error instanceof Error) {      throw error;    }    throw new Error('Kayıt başarısız. Lütfen tekrar deneyin.');  }}

// server/auth/register.ts - Yapılandırılmış, sürdürülebilir implementationimport { z } from 'zod';import { ratelimit } from '@/lib/rate-limit';import { hashPassword } from '@/lib/auth';import { prisma } from '@/lib/prisma';
const registerSchema = z.object({  email: z.string().email('Geçersiz email formatı'),  password: z.string()    .min(8, 'Şifre en az 8 karakter olmalı')    .regex(/^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)/,           'Şifre büyük harf, küçük harf ve sayı içermeli')});
export async function registerUser(formData: FormData) {  // Rate limiting  const { success } = await ratelimit.limit('auth_register');  if (!success) {    throw new Error('Çok fazla kayıt denemesi. Lütfen daha sonra tekrar deneyin.');  }
  // Input validation  const result = registerSchema.safeParse({    email: formData.get('email'),    password: formData.get('password')  });
  if (!result.success) {    throw new Error(`Validasyon hatası: ${result.error.issues.map(i => i.message).join(', ')}`);  }
  const { email, password } = result.data;
  try {    // Kullanıcı var mı kontrol et    const existingUser = await prisma.user.findUnique({      where: { email }    });
    if (existingUser) {      throw new Error('Bu email ile kullanıcı zaten mevcut');    }
    // Hashlenmiş şifre ile kullanıcı oluştur    const passwordHash = await hashPassword(password);    const user = await prisma.user.create({      data: {        email,        passwordHash      },      select: {        id: true,        email: true,        createdAt: true      }    });
    return { success: true, user };  } catch (error) {    if (error instanceof Error) {      throw error;    }    throw new Error('Kayıt başarısız. Lütfen tekrar deneyin.');  }}

Fark çarpıcı. SpecKit kılavuzlu kod düzgün validation, error handling, rate limiting içeriyor ve baştan itibaren production'a hazır hale getiren kurulmuş kalıpları takip ediyor.

Takım Adaptasyon Stratejileri

Aşamalı İmplementasyon Yaklaşımı

SpecKit'in değerini göstermek için tek bir özellikle başla:

bash

# Hafta 1: Ertelenmiş karmaşık bir özellik seçspecify init payment-processing --ai claude
# Hafta 2: Dört aşamayı da kullanarak özelliği tamamla# Yatırılan zamana karşı elde edilen kaliteyi dokümante et
# Hafta 3: Önce/sonra karşılaştırmalarıyla sonuçları takıma sun# Code review süresi ve bug raporlarındaki azalmayı göster

# Hafta 1: Ertelenmiş karmaşık bir özellik seçspecify init payment-processing --ai claude
# Hafta 2: Dört aşamayı da kullanarak özelliği tamamla# Yatırılan zamana karşı elde edilen kaliteyi dokümante et
# Hafta 3: Önce/sonra karşılaştırmalarıyla sonuçları takıma sun# Code review süresi ve bug raporlarındaki azalmayı göster

Takım Standartları Oluştur

Yaygın proje türleri için spesifikasyon şablonları belirle:

markdown

## API Endpoint Spesifikasyon Şablonu
### Fonksiyonel Gereksinimler- [ ] Input parametrelerini ve validation kurallarını tanımla- [ ] Output formatını ve error responslarını belirle- [ ] Authentication/authorization gereksinimlerini dokümante et- [ ] Rate limiting ve caching stratejilerini tanımla
### Teknik Gereksinimler- [ ] Database etkileşimlerini ve sorguları belirle- [ ] Logging ve monitoring gereksinimlerini tanımla- [ ] External servislerle entegrasyon noktalarını dokümante et- [ ] Test gereksinimlerini belirle (unit, integration, e2e)
### Performans Gereksinimleri- [ ] Response time hedefleri- [ ] Concurrent kullanıcı handling- [ ] Database sorgu optimizasyon gereksinimleri- [ ] Caching stratejisi ve invalidation kuralları

## API Endpoint Spesifikasyon Şablonu
### Fonksiyonel Gereksinimler- [ ] Input parametrelerini ve validation kurallarını tanımla- [ ] Output formatını ve error responslarını belirle- [ ] Authentication/authorization gereksinimlerini dokümante et- [ ] Rate limiting ve caching stratejilerini tanımla
### Teknik Gereksinimler- [ ] Database etkileşimlerini ve sorguları belirle- [ ] Logging ve monitoring gereksinimlerini tanımla- [ ] External servislerle entegrasyon noktalarını dokümante et- [ ] Test gereksinimlerini belirle (unit, integration, e2e)
### Performans Gereksinimleri- [ ] Response time hedefleri- [ ] Concurrent kullanıcı handling- [ ] Database sorgu optimizasyon gereksinimleri- [ ] Caching stratejisi ve invalidation kuralları

Code Review Süreciyle Entegrasyon

SpecKit üretimi kod context sağlayarak code reviewları basitleştiriyor:

typescript

// Her implementation spesifikasyon referansı içeriyor/** * Task 4: Kayıt server action * Spesifikasyon: US-001 - Email/şifre ile kullanıcı kayıt * Bağımlılıklar: Task 1 (database şema), Task 2 (auth utilities) * Güvenlik gereksinimleri: Şifre güçlü validasyon, rate limiting */export async function registerUser(formData: FormData) {  // Implementation spesifikasyonu tam olarak takip ediyor}

// Her implementation spesifikasyon referansı içeriyor/** * Task 4: Kayıt server action * Spesifikasyon: US-001 - Email/şifre ile kullanıcı kayıt * Bağımlılıklar: Task 1 (database şema), Task 2 (auth utilities) * Güvenlik gereksinimleri: Şifre güçlü validasyon, rate limiting */export async function registerUser(formData: FormData) {  // Implementation spesifikasyonu tam olarak takip ediyor}

Reviewerlar gereksinimleri tahmin etmek yerine implementasyonun spesifikasyonlara uyup uymadığını doğrulayabiliyor.

Etkiyi Ölçmek: Gerçek Dünya Sonuçları

SpecKit kullanan takımlar birkaç temel alanda iyileştirmeler rapor ediyor, ancak sonuçlar takım deneyimi, proje karmaşıklığı ve implementasyon yaklaşımına bağlı olarak önemli ölçüde değişiklik gösteriyor:

Önemli Bağlam: 2025'teki son araştırmalar AI geliştirme araçlarıyla karışık sonuçlar gösteriyor. Bazı takımlar verimlilik artışı görürken, diğerleri yapılandırılmış workflow'lara adapte olurken daha yavaş başlangıç deneyimliyorlar. Senin deneyimin takımının mevcut pratiklerine ve yaptığın proje türlerine çok bağımlı olacak.

Kod Kalite Metrikleri (Sonuçlar Değişebilir)

Teknik borç azalması: Bazı takımlar daha az "TODO" yorumları ve hızlı fix rapor ediyor
Bug raporları: Daha iyi spesifikasyon uyumundan azalan production sorunları
Code review süresi: Spesifikasyonlar açık ve takip edildiğinde daha hızlı reviewlar
Test coverage: Specification-driven test gereksinimleri sayesinde iyileşen coverage

Development Hızı (Bağlama Bağımlı)

Özellik teslimi: Bazı takımlar workflow'a adapte olduktan sonra daha hızlı end-to-end teslimat görüyor
Context switching: Belirsiz gereksinimleri anlama süresinde azalma
Rework döngüleri: Daha az mid-development gereksinim değişikliği

Not: Bu faydalar genellikle öğrenme periyodundan sonra ortaya çıkar ve tutarlı takım adaptasyonuna bağımlıdır.

Takım Dinamikleri

Onboarding süresi: Yeni takım üyeleri AI üretimi kodu 3 kat daha hızlı anlıyor
Bilgi paylaşımı: Spesifikasyonlar yaşayan dokümantasyon olarak hizmet veriyor
Karar tracking: Mimari kararlar ve trade-offların açık kaydı

İleri Seviye Teknikler ve Best Practiceler

Değişen Gereksinimleri Yönetme

SpecKit iteratif yapısı sayesinde gereksinim değişikliklerine uyum sağlıyor:

bash

# Development ortasında gereksinimler değiştiğinde/specify --update
# Yeni gereksinimleri sağla"Mevcut auth sistemine Google ve GitHub ile OAuth entegrasyonu ekle"
# SpecKit spesifikasyonları günceller ve etkilenen taskları yeniden oluşturur# Değişikliklerin mevcut implementation üzerindeki etkisini analiz eder

# Development ortasında gereksinimler değiştiğinde/specify --update
# Yeni gereksinimleri sağla"Mevcut auth sistemine Google ve GitHub ile OAuth entegrasyonu ekle"
# SpecKit spesifikasyonları günceller ve etkilenen taskları yeniden oluşturur# Değişikliklerin mevcut implementation üzerindeki etkisini analiz eder

Mevcut Araçlarla Entegrasyon

SpecKit mevcut development workflow'unla birlikte çalışıyor:

typescript

// .speckit/config.js - Takım yapılandırmasıexport default {  aiTool: 'claude',  projectStructure: {    srcDir: 'src',    testDir: '__tests__',    docsDir: 'docs'  },  codeStandards: {    formatter: 'prettier',    linter: 'eslint',    testing: 'jest'  },  integrations: {    jira: {      enabled: true,      projectKey: 'AUTH'    },    github: {      issueTemplates: true,      prTemplates: true    }  }};

// .speckit/config.js - Takım yapılandırmasıexport default {  aiTool: 'claude',  projectStructure: {    srcDir: 'src',    testDir: '__tests__',    docsDir: 'docs'  },  codeStandards: {    formatter: 'prettier',    linter: 'eslint',    testing: 'jest'  },  integrations: {    jira: {      enabled: true,      projectKey: 'AUTH'    },    github: {      issueTemplates: true,      prTemplates: true    }  }};

Farklı Proje Türleri için Spesifikasyon Kalıpları

API Projeleri:

bash

/specify "Ürün kataloğu, envanter yönetimi ve sipariş işleme ile e-ticaret platformu için REST API. 1000+ eşzamanlı kullanıcı ve 200ms altı response time desteklemeli."

/specify "Ürün kataloğu, envanter yönetimi ve sipariş işleme ile e-ticaret platformu için REST API. 1000+ eşzamanlı kullanıcı ve 200ms altı response time desteklemeli."

Frontend Uygulamaları:

bash

/specify "Gerçek zamanlı grafikler, veri filtreleme ve export ile satış analitiği için React dashboard. Mobil cihazlarda çalışmalı ve dark mode desteklemeli."

/specify "Gerçek zamanlı grafikler, veri filtreleme ve export ile satış analitiği için React dashboard. Mobil cihazlarda çalışmalı ve dark mode desteklemeli."

CLI Araçları:

bash

/specify "Rollback desteği, ortam yönetimi ve audit logging ile veritabanı migration'ları için komut satırı aracı. Farklı veritabanı sağlayıcılarıyla çalışmalı."

/specify "Rollback desteği, ortam yönetimi ve audit logging ile veritabanı migration'ları için komut satırı aracı. Farklı veritabanı sağlayıcılarıyla çalışmalı."

Yaygın Tuzaklar ve Nasıl Önlenir

Aşırı Spesifikasyon Tuzağı

Her implementation detayını belirtme. Gereksinimlere ve kısıtlara odaklan:

markdown

Kötü: "Array'i iterate etmek için for döngüsü kullan ve filter fonksiyon uygula"İyi: "Son 30 günden sadece aktif kullanıcıları göstermek için kullanıcı datasını filtrele"

Kötü: "Array'i iterate etmek için for döngüsü kullan ve filter fonksiyon uygula"İyi: "Son 30 günden sadece aktif kullanıcıları göstermek için kullanıcı datasını filtrele"

Spesifikasyon Drift

Implementation geliştikçe spesifikasyonları güncel tut:

bash

# Düzenli spesifikasyon güncellemeleri/specify --review
# Implementation öğrenimlerine dayalı spesifikasyonları günceller# Spec ve gerçeklik arasındaki uyumu korur

# Düzenli spesifikasyon güncellemeleri/specify --review
# Implementation öğrenimlerine dayalı spesifikasyonları günceller# Spec ve gerçeklik arasındaki uyumu korur

Araç Kilitleme Endişeleri

SpecKit herhangi bir AI aracıyla çalışan standart dokümantasyon üretir:

markdown

# Üretilen spesifikasyonlar araç-bağımsız## Requirements Document- Claude Code, GitHub Copilot, Gemini ile uyumlu- Standart markdown format- Açık kabul kriterleri- Farklı AI kodlama araçları arasında taşınabilir

# Üretilen spesifikasyonlar araç-bağımsız## Requirements Document- Claude Code, GitHub Copilot, Gemini ile uyumlu- Standart markdown format- Açık kabul kriterleri- Farklı AI kodlama araçları arasında taşınabilir

AI Destekli Geliştirmenin Geleceği

SpecKit specification-driven AI development yönünde bir değişimi temsil ediyor. AI araçlarını akıllı autocomplete olarak görmek yerine, onları yapılandırılmış development partnerları olarak görme yönünde ilerliyoruz.

Bu yaklaşımdan ortaya çıkan temel trendler:

İşbirlikçi AI Development

Sessionlar arası proje contextini koruyan AI araçlar
Spesifikasyon farkında kod üretimi
Proje yönetim araçlarıyla entegrasyon
Otomatik dokümantasyon üretimi

Kalite-İlk AI Kodlama

Built-in test gereksinimleri
Güvenlik hususları şablonları
Performans gereksinim tracking
Teknik borç önleme

Takım Ölçeğinde AI Entegrasyonu

Paylaşılan spesifikasyon kütüphaneleri
Takımlar arasında tutarlı AI araç yapılandırması
Spesifikasyonlar üzerinden bilgi transferi
Standartlaştırılmış AI üretimi kod kalıpları

Başlangıç: İlk SpecKit Projen

AI kodlama workflow'unu dönüştürmeye hazır mısın? İşte 30 dakikalık pratik bir egzersiz:

Gerçek Bir Özellik Seç

Karmaşıklığı yüzünden ertelediğin bir şey seç:

Kullanıcı authentication sistemi
Real-time notification servisi
Data export işlevi
API entegrasyon katmanı

Dört Aşamayı da Geç

bash

# 1. Kur ve başlatuvx --from git+https://github.com/github/spec-kit.git specify init test-feature --ai claude
# 2. Spesifikasyon oluştur (10 dakika)/specify "Açık gereksinimlerle özellik açıklaman"
# 3. Teknik planı tanımla (5 dakika)/plan "Tech stackin ve kısıtların"
# 4. Task breakdown oluştur (5 dakika)/tasks
# 5. İlk taski implement et (10 dakika)# SpecKit guidance takip ederek en yüksek öncelikli taski gerçekleştir

# 1. Kur ve başlatuvx --from git+https://github.com/github/spec-kit.git specify init test-feature --ai claude
# 2. Spesifikasyon oluştur (10 dakika)/specify "Açık gereksinimlerle özellik açıklaman"
# 3. Teknik planı tanımla (5 dakika)/plan "Tech stackin ve kısıtların"
# 4. Task breakdown oluştur (5 dakika)/tasks
# 5. İlk taski implement et (10 dakika)# SpecKit guidance takip ederek en yüksek öncelikli taski gerçekleştir

Sonuçları Karşılaştır

Kod kalitesi: Yapılandırılmış yaklaşım normal AI üretimi kodunla nasıl karşılaştırılıyor?
Sürdürülebilirlik: Bunu production'a gönderme konusunda rahat olur musun?
Dokümantasyon: Üretilen dokümantasyon ne kadar kapsamlı?
Test: Test gereksinimleri açık ve actionable mı?

Anahtar Çıkarımlar

GitHub SpecKit AI destekli geliştirmedeki temel problemi çözüyor: kaotik implementasyonlar yerine yapılandırılmış, sürdürülebilir kod elde etme. Dört aşamalı yaklaşım (Specify, Plan, Tasks, Implement) AI araçlarını hızlı prototyping asistanlarından sistematik development partnerlerine dönüştürüyor.

Bireysel developerlar için SpecKit cognitive load'u azaltıyor ve yapılandırılmamış AI üretiminden kaynaklanan teknik borç birikimini önlüyor. Sistematik yaklaşım AI üretimi kodun baştan itibaren production standartlarını karşılamasını sağlıyor.

Takımlar için SpecKit AI destekli development için ortak vocabular yaratıyor. Spesifikasyonlar yaşayan dokümantasyon haline geliyor, code reviewlar daha odaklı hale geliyor ve yeni takım üyelerinin onboarding'i önemli ölçüde kolaylaşıyor.

Yatırım minimal - farkı görmek için 30 dakika, karmaşık özellik için 2 saat - ama kod kalitesi ve sürdürülebilirlik üzerindeki etkisi önemli.

AI araçları software development'ta daha yaygın hale geldikçe, specification-driven yaklaşımları benimseyen takımlar kod kalitesi, development hızı ve teknik borç yönetiminde avantaj görme eğiliminde - ancak bireysel sonuçlar takım kültürüne ve mevcut pratiklere çok bağımlı.

Dönüşüm zaten gerçekleşiyor. Seçim bunu kaosa doğru sürüklenmesine mi izin vereceğin yoksa yapılandırılmış, sürdürülebilir sistemlere mi yönlendireceğin. SpecKit yapıyı seçmek için bir framework sağlıyor, ancak bu yaklaşımın takımının workflow'una uyup uymadığını değerlendirmekte fayda var.

SpecKit'i önce kritik olmayan bir özellikte denemeyi düşün, development stilinle nasıl çalıştığını gör. Yapılandırılmış yaklaşım başlangıçta daha yavaş hissedebilir, ancak uzun vadeli sürdürülebilirlik faydaları genellikle ön yatırımı haklı çıkarır.

Yapılandırılmamış AI Kod Üretiminin Gizli Maliyeti#

Yapılandırılmış AI Development için Framework#

1. Aşama: Constitution (Opsiyonel) - Proje Prensiplerini Belirle#

2. Aşama: Specify - Ne Geliştirdiğini Tanımla#

Kurulum ve Yapılandırma#

İlk Spesifikasyonunu Oluştur#

3. Aşama: Clarify (Opsiyonel) - Belirsiz Alanları Gider#

4. Aşama: Plan - Mimari ve Teknik Kararları Tanımla#

Güvenlik Hususları#

6. Aşama: Implement - Taskları Sistematik Olarak Gerçekleştir#

Task 1 Implementation Örneği#

Task 2 Implementation Örneği#

Kalite Farkı: SpecKit Öncesi vs Sonrası#

SpecKit Öncesi (Tipik AI Üretimi)#

SpecKit Sonrası (Specification-Driven)#

Takım Adaptasyon Stratejileri#

Aşamalı İmplementasyon Yaklaşımı#

Takım Standartları Oluştur#

Code Review Süreciyle Entegrasyon#

Etkiyi Ölçmek: Gerçek Dünya Sonuçları#

Kod Kalite Metrikleri (Sonuçlar Değişebilir)#

Development Hızı (Bağlama Bağımlı)#

Takım Dinamikleri#

İleri Seviye Teknikler ve Best Practiceler#

Değişen Gereksinimleri Yönetme#

Mevcut Araçlarla Entegrasyon#

Farklı Proje Türleri için Spesifikasyon Kalıpları#

Yaygın Tuzaklar ve Nasıl Önlenir#

Aşırı Spesifikasyon Tuzağı#

Spesifikasyon Drift#

Araç Kilitleme Endişeleri#

AI Destekli Geliştirmenin Geleceği#

İşbirlikçi AI Development#

Kalite-İlk AI Kodlama#

Takım Ölçeğinde AI Entegrasyonu#

Başlangıç: İlk SpecKit Projen#

Gerçek Bir Özellik Seç#

Dört Aşamayı da Geç#

Sonuçları Karşılaştır#

Anahtar Çıkarımlar#

İlgili Yazılar

Yapılandırılmamış AI Kod Üretiminin Gizli Maliyeti

Yapılandırılmış AI Development için Framework

1. Aşama: Constitution (Opsiyonel) - Proje Prensiplerini Belirle

2. Aşama: Specify - Ne Geliştirdiğini Tanımla

Kurulum ve Yapılandırma

İlk Spesifikasyonunu Oluştur

3. Aşama: Clarify (Opsiyonel) - Belirsiz Alanları Gider

4. Aşama: Plan - Mimari ve Teknik Kararları Tanımla

Güvenlik Hususları

6. Aşama: Implement - Taskları Sistematik Olarak Gerçekleştir

Task 1 Implementation Örneği

Task 2 Implementation Örneği

Kalite Farkı: SpecKit Öncesi vs Sonrası

SpecKit Öncesi (Tipik AI Üretimi)

SpecKit Sonrası (Specification-Driven)

Takım Adaptasyon Stratejileri

Aşamalı İmplementasyon Yaklaşımı

Takım Standartları Oluştur

Code Review Süreciyle Entegrasyon

Etkiyi Ölçmek: Gerçek Dünya Sonuçları

Kod Kalite Metrikleri (Sonuçlar Değişebilir)

Development Hızı (Bağlama Bağımlı)

Takım Dinamikleri

İleri Seviye Teknikler ve Best Practiceler

Değişen Gereksinimleri Yönetme

Mevcut Araçlarla Entegrasyon

Farklı Proje Türleri için Spesifikasyon Kalıpları

Yaygın Tuzaklar ve Nasıl Önlenir

Aşırı Spesifikasyon Tuzağı

Spesifikasyon Drift

Araç Kilitleme Endişeleri

AI Destekli Geliştirmenin Geleceği

İşbirlikçi AI Development

Kalite-İlk AI Kodlama

Takım Ölçeğinde AI Entegrasyonu

Başlangıç: İlk SpecKit Projen

Gerçek Bir Özellik Seç

Dört Aşamayı da Geç

Sonuçları Karşılaştır

Anahtar Çıkarımlar