İstem mühendisliği

Örnek istemler:

Make the app better

Fix the bugs

Örnek istemler:

Add authentication

Örnek istemler:

Build the entire user management system with authentication, authorization, profiles, settings, and admin dashboard

Örnek istemler:

Update the validation logic

Örnek istemler:

Expecting Verdent to know your specific business rules or constraints

Örnek istemler:

Referencing files without including them in context

Örnek istemler:

Repeatedly asking for the same thing when Verdent encounters errors

Örnek istemler:

Requesting large refactorings or multi-file changes without using Plan Mode first

Örnek istemler:

Using Auto-Run or Skip Permission Mode without Git initialized

Örnek istemler:

Providing incomplete requirements and expecting Verdent to guess correctly

Açık gereksinimler ve kısıtlamalarla yeni işlevsellik oluşturma:

Create a POST /api/tasks endpoint that:
- Accepts task title (required), description (optional), and category_id (required)
- Validates that the category exists in the database
- Returns 400 if validation fails with descriptive error messages
- Saves the task to the database and returns the created task with 201 status
- Add this to the existing tasks router in routes/tasks.js
- Create the controller method in controllers/taskController.js
- Use the existing error handling pattern from other controllers

Bunu etkili kılan nedir:

• Girdiler ve doğrulama için açık gereksinimler
• Uygulama için belirli dosya konumları
• Tutarlılığı korumak için mevcut kalıplara referans
• Beklenen HTTP durum kodları ve hata işleme

Sorunları bağlam ve önerilen çözümlerle açıklama:

Fix the race condition in payment processing at checkout. When multiple users submit payments simultaneously, some transactions fail with "duplicate order ID" errors. The issue appears to be in PaymentController.js around line 45 where we generate order IDs. Implement proper locking or use UUID generation to ensure unique IDs even under concurrent load.

Bunu etkili kılan nedir:

• Belirtilerle açık sorun açıklaması
• Sorunun belirli konumu (dosya ve satır numarası)
• Ne zaman olduğu hakkında bağlam (eşzamanlı kullanıcılar)
• Önerilen çözüm yaklaşımları

Davranışı korurken uygulamayı değiştirme:

Refactor the authentication middleware in middleware/auth.js to use JWT tokens instead of session cookies. Keep the same authorization logic, but:
- Replace session validation with JWT verification
- Store tokens in httpOnly cookies
- Maintain the existing user object structure that routes expect
- Update only the authentication mechanism, don't change authorization rules
- Ensure all existing routes continue to work without modification

Bunu etkili kılan nedir:

• Açık hedef (oturumlar yerine JWT)
• Yeniden düzenlenecek belirli dosya
• Açık kısıtlamalar (neyin DEĞİŞMEMESİ gerektiği)
• Geriye dönük uyumluluk gereksinimi

Kapsamlı kapsama sahip testler yazma:

Write comprehensive unit tests for the UserService class in services/UserService.js. Cover:
- User creation with valid and invalid data
- Email validation edge cases (empty, malformed, duplicate)
- Password hashing verification
- User lookup by ID and email
- Error handling for database failures
Use Jest and follow the testing patterns in existing service tests

Bunu etkili kılan nedir:

• Test edilecek belirli sınıf/dosya
• Kapsanacak senaryoların tam listesi
• Belirtilen test çerçevesi
• Mevcut test kalıplarına referans

Ayrıntılı özelliklerle UI bileşenleri oluşturma:

Create a reusable SearchBar component for the product catalog with:
- Text input with real-time debounced search (300ms delay)
- Category dropdown filter (fetch options from /api/categories)
- Price range slider (min $0, max $1000)
- Clear filters button
- Use Material-UI components to match existing design
- Emit search parameters via onChange callback to parent
- Include PropTypes for all props

Bunu etkili kılan nedir:

• Belirli ayrıntılarla tam özellik listesi
• Teknik özellikler (300ms gecikme, fiyat aralığı)
• Belirtilen UI kütüphanesi (Material-UI)
• Entegrasyon yaklaşımı (üst bileşene geri çağırma)

Belirli dosyalara, bileşenlere veya alt aracılara referans verin:

@auth.js @UserController.js Refactor authentication to use the same validation pattern

Avantajlar:

• Belirli dosyaları açıkça dahil ederek Verdent'in tam bağlama sahip olmasını sağlar
• Benzer dosya adlarına sahip büyük kod tabanlarında belirsizliği önler
• Doğru yeniden düzenleme ve kalıp eşleştirme için tüm ilgili kodun aynı anda görünür olmasını garanti eder
• Bir dosyadaki uygulama kalıplarını başka bir dosyaya uygulamak için referans verirken kritiktir

Büyük değişiklikler için yürütmeden önce Plan Mode'a geçin:

Switch to Plan Mode
Refactor the entire API layer to use TypeScript with strict type checking

Avantajlar:

• Herhangi bir dosya değiştirilmeden önce Verdent'in tam yaklaşımını inceleyin
• Büyük yeniden düzenlemelerde veya mimari değişikliklerde maliyetli hataları önler
• Yürütme başlamadan önce plan üzerinde yineleyin, kısıtlamalar ekleyin veya tamamen yönlendirin
• Tüm gereksinimleri önceden toplamak için Verdent'in size açıklayıcı sorularla görüşme yapmasını isteyin

Özelleşmiş görevleri yerleşik veya özel alt aracılara devredin:

@Code-reviewer Review the security vulnerabilities in authentication flow
@Explorer Find all files that import the deprecated API client
@Verifier Validate the authentication logic in the middleware

Avantajlar:

• Belirli görevler için optimize edilmiş özelleşmiş aracılardan yararlanın (keşif, doğrulama, kod incelemesi)
• Genel amaçlı işlemeden daha odaklı uzmanlık ve daha hızlı sonuçlar
• Toplam yürütme süresini önemli ölçüde azaltmak için birden çok analizi paralel olarak çalıştırın
• Projenizin benzersiz gereksinimleri için alana özgü bilgiye sahip özel alt aracılar oluşturun

Yerleşik varsayılan alt aracılar:

• @Verifier - Hızlı kod kontrolleri ve doğrulama
• @Explorer - Hızlı kod tabanı keşfi ve dosya bulma
• @Code-reviewer - Kod kalitesi değerlendirmesi

Karmaşık zorluklar için genişletilmiş muhakemeyi etkinleştirin:

Think: Design the optimal database schema for a multi-tenant SaaS application

Avantajlar:

• Karmaşık sorunları birden çok açıdan daha derin analiz etmek için genişletilmiş muhakemeyi etkinleştirir
• Alternatif yaklaşımları ve uç durumları daha kapsamlı değerlendirir
• Doğruluğun en önemli olduğu sağlam çözümler üretir
• Daha yavaş yanıtlar ve daha yüksek kredi kullanımı, ancak aceleci, optimal olmayan çözümlerden kaynaklanan maliyetli yeniden çalışmayı önler

Önceki yanıtların üzerine kademeli iyileştirmeyle inşa edin:

Initial: "Create a dashboard component"
Follow-up: "Add real-time data updates using WebSockets"
Follow-up: "Now add filtering and sorting capabilities"

Avantajlar:

• Karmaşıklık eklemeden önce her adımda test ile kademeli geliştirmeyi sağlar
• Üzerine inşa etmeden önce her katmanın doğru çalıştığını doğrulayarak riski azaltır
• Yinelemeler beklenmedik sonuçlar üretirse hemen rotayı düzeltin
• Her yineleme küçük ve kontrollü olduğundan, hangi belirli değişikliğin bir hata getirdiğini belirlemeyi kolaylaştırır

Neyin değişeceğinin yanı sıra neyin DEĞİŞMEYECEĞİNİ belirtin:

Add caching to the API endpoints, but:
- Don't modify the authentication middleware
- Keep the existing error handling unchanged
- Maintain backward compatibility with mobile clients

Avantajlar:

• Kritik sistemleri (kimlik doğrulama, ödemeler) değiştirmeyi önlemek için sınırları açıkça tanımlar
• Uyumluluk veya risk gereksinimleri nedeniyle değişmeden kalması gereken kararlı sistemleri korur
• Değişiklikleri uygulama, bozuk işlevsellik keşfetme ve çözümleri yeniden çalışma gibi maliyetli döngülerden kaçınır
• Geriye dönük uyumluluğu korur ve test edilmiş kodu gereksiz yeniden düzenlemeden korur

Uygulama örnekleri olarak mevcut koda işaret edin:

Implement the new ProductService following the same pattern as UserService.js, including error handling, validation, and database transaction management

Avantajlar:

• Yeni uygulamaların yerleşik kurallarla tutarlılığını korumasını sağlar
• Kod tabanını daha bakımı kolay ve öngörülebilir hale getirir
• Gereken açıklamayı önemli ölçüde azaltır - yaklaşımları ayrıntılı tanımlamak yerine örneklere işaret edin
• Çözümleri yeniden icat etmek yerine kanıtlanmış, test edilmiş kalıplardan yararlanır
• Hataları azaltır ve mevcut sistemlerle sorunsuz entegrasyon sağlar

Karmaşık, çok adımlı görevleri izlemek için bir todos.md dosyası oluşturun:

Create a todos.md file with these tasks:
1. Refactor authentication to use JWT tokens
2. Update all controllers to use new auth middleware
3. Add tests for authentication flow
4. Update API documentation

Avantajlar:

• İncelenebilen, iyileştirilebilen ve ekip arkadaşlarıyla paylaşılabilen açık, yazılı bir yol haritası oluşturur
• Proje boyunca gereksinimler geliştikçe kolayca ayarlanır
• Oturumlar arasında kalıcı olduğundan çalışmaya ara verebilir, daha sonra devam edebilir ve nerede kaldığınızı hemen anlayabilirsiniz
• Neyin planlandığını, tamamlandığını ve gelecekteki bakım ve adaptasyon için kaldığını belgeleyen bir proje yapıtı görevi görür

Yeni bağlam için farklı todo'lar arasında yeni oturumlar başlatın:

After completing todo #1: "Start a new session"
Then: "Let's work on todo #2 from todos.md"

Avantajlar:

• Önceki görev ayrıntılarının mevcut çalışmayı uygunsuz biçimde etkilediği bağlam kirlenmesini önler
• Önceki görevlerin yükü olmadan yalnızca mevcut todo'ya odaklanmayı sağlar
• Gereksiz konuşma geçmişini yüklemeyerek token kullanımını azaltır
• Yanıtları daha hızlı ve daha kredi verimli hale getirir
• Test ve değişiklikleri commit etmek için doğal kontrol noktaları oluşturur, temiz git geçmişi korur ve sorun izolasyonunu kolaylaştırır

Özelleşmiş bağlam enjekte etmek için MCP (Model Context Protocol) sunucularını kullanın:

• Projeye özgü dokümantasyon
• API belirtimleri (OpenAPI, GraphQL şemaları)
• Çerçeveye özgü bilgi

Avantajlar:

• Verdent'in eğitim verilerinde olmayan özel çerçeveleri, dahili araçları ve özelleşmiş alanları anlamasını geliştirir
• Kuruluşa özgü API belirtimlerini ve dokümantasyonu doğrudan enjekte ederek özel sistemleri tekrar tekrar açıklama ihtiyacını ortadan kaldırır
• Yalnızca istemlerle iletilmesi imkânsız olan dahili API'lerin ve tescilli sistemlerin doğru kullanımını sağlar

İlgili dosyaları bağlama açıkça dahil edin:

@models/User.js @controllers/UserController.js Add password reset functionality

Ne zaman kullanılır:

• Sıkı bağlı dosyalarla çalışırken (model ve denetleyici, servis ve testler)
• Bir dosyadaki uygulama kalıplarını başka bir dosyaya uygulamak için referans verirken
• Birden çok ilgili dosyada değişiklikleri koordine ederken
• Otomatik tespitin bağlamı kaçırabileceği, benzer dosya adlarına sahip büyük kod tabanlarında
• Verdent'ten "şununla aynı kalıbı izle..." istediğinizde tam koda sahip olmasını sağlamak için daima kullanın

Yığınınız hakkında üst düzey bağlam ekleyin:

This is a MERN stack application (MongoDB, Express, React, Node.js) with JWT authentication. Add role-based access control following our existing middleware pattern.

Ne zaman kullanılır:

• Mevcut teknoloji yığınınızla entegre olması gereken özellikler uygularken
• Bir kod tabanında ilk kez çalışırken veya birden çok katmanı kapsayan özelliklerde (önyüzden veritabanına)
• Yığınınızın uygulama seçimlerini etkileyen güçlü tercihleri olduğunda (GraphQL vs REST, Redux vs Context API)
• Verdent'in genel bir çözüm yerine sisteminize uygun yaklaşımı seçmesini istediğinizde

Kurallarınızı gösteren koda işaret edin:

Follow the same error handling pattern used in ProductController.js - return consistent error objects with status codes and descriptive messages

Ne zaman kullanılır:

• Yeni kodun yerleşik kurallarla tutarlılığını korumasını istediğinizde (hata işleme, doğrulama, günlükleme, test)
• Kod tabanının yeni bir alanında benzer işlevsellik uygularken
• Mevcut kalıpları öğrenmek ve çoğaltmak istediğiniz, kod tabanının bilmediğiniz bölümlerine adapte olurken
• Kalıpları ayrıntılı tanımlamaktan kaçınmak ve Verdent'in ifade etmesi zor nüansları yakalamasını istediğinizde

Sınırlamaları veya gereksinimleri belirtin:

We're using TypeScript with strict mode enabled, React 18 with hooks only (no class components), and Material-UI v5 for styling

Ne zaman kullanılır:

• Projenizin belirli teknoloji gereksinimleri olduğunda (TypeScript katı mod, yalnızca React hook'ları, harici bağımlılık yok)
• Eski kısıtlamalarla çalışırken (IE11 desteği, Node.js 14 uyumluluğu)
• Uyumluluk gereksinimleri seçimleri belirlediğinde (WCAG erişilebilirliği, GDPR veri işleme)
• Sürümler arasında kırıcı değişiklikleri olan belirli kütüphane sürümlerini kullanırken
• Verdent'in projenizin teknik sınırlarını ihlal eden çözümler önermesini engellemeniz gerektiğinde

Alana özgü kuralları açıklayın:

Users can only view tasks assigned to them or their team. Managers can view all tasks in their department. Admins can view everything.

Ne zaman kullanılır:

• Verdent'in yalnızca koddan çıkaramayacağı alana özgü kuralları olan özellikler uygularken
• Yetkilendirme mantığı (kim neye erişebilir), iş akışları (onay süreçleri, durum makineleri)
• Doğrulama kuralları (parola politikaları, veri kısıtlamaları), alan kısıtlamaları (envanter limitleri, fiyatlandırma kuralları)
• Varlık ilişkilerinin ve kardinalitenin açıklama gerektirdiği veri modelleri oluştururken
• Hesaplamalar uygularken (indirim kuralları, vergi hesaplaması, komisyon yapıları)
• Verdent'in yalnızca işlevsel kod değil, kuruluşunuzun iş kurallarını doğru biçimde uygulamasını istediğinizde

Hata ayıklarken hata mesajlarını veya günlükleri paylaşın:

Getting "TypeError: Cannot read property 'id' of undefined" at UserController.js:42 when trying to update user profiles. The req.user object exists but doesn't have an id property after the recent auth middleware changes.

Ne zaman kullanılır:

• Hataları düzeltirken daima tam hata mesajlarını, yığın izlerini ve günlükleri ekleyin
• Çalışma zamanı hataları (istisnalar, çökmeler), derleme hataları (derleme hataları, lint ihlalleri)
• Test hataları (doğrulama hataları, zaman aşımı sorunları), beklenmedik davranış (yanlış çıktı, eksik veri)
• Satır numaraları ve çağrı zincirini gösteren tam yığın izi ile kesin hata mesajlarına sahip olduğunuzda
• Ne zaman oluştuğu hakkında bağlam sağlayabildiğinizde (her zaman, aralıklı, belirli koşullar)
• Verdent'in tahmin etmek yerine kök nedenleri belirleme yeteneğini önemli ölçüde geliştirmek istediğinizde

Verdent isteğinize göre ilgili dosyaları otomatik olarak yükler:

• İstemlerde adıyla bahsedilen dosyalar
• Aynı dizindeki ilgili dosyalar
• Sık erişilen proje dosyaları

Buna ne zaman güvenilir:

• İlişkilerin açık olduğu standart dosya referanslarında
• Bileşenlerden adıyla bahsederken ve Verdent'in o belirli dosyayı yüklemesi gerektiğinde
• Aynı dizinde genellikle birlikte çalışan dosyalarla çalışırken
• Sık kullanılan proje dosyalarına erişirken (package.json, yapılandırma dosyaları)
• İyi organize edilmiş kod tabanlarındaki basit senaryolarda iyi çalışır
• Karmaşık çok dosyalı yeniden düzenleme, uzak kod tabanı parçaları veya belirsiz dosya adları için bunun yerine açık @-bahsetmeleri kullanın

Kural dosyaları aracılığıyla kalıcı bağlam yapılandırın (Settings → Rules):

Kullanıcı kuralları (VERDENT.md): Tüm projelerde uygulanan genel tercihler

Proje kuralları (AGENTS.md): Projeye özgü standartlar - mimari kalıplar, kodlama standartları

Plan kuralları (plan_rules.md): Plan Mode'ta plan biçimini ve içeriğini özelleştirin

Ne zaman kullanılır:

• Oturumlar boyunca aynı bağlamı tekrar tekrar sağlarken
• Kişisel tercihler için kullanıcı kuralları (kodlama stili, tercih edilen kütüphaneler, beğendiğiniz kalıplar)
• Ekip standartları için proje kuralları (mimari kararlar, adlandırma kuralları, test gereksinimleri)
• Yeni ekip üyelerinin adaptasyonunda değerli (kabilesel bilgiyi kodlar)
• Büyük ekiplerde tutarlılığı korumak ve istem ayrıntısını azaltmak
• Projeniz belgelenmeye değer yerleşik kalıplara sahip olacak kadar olgunlaştığında kural dosyalarına yatırım yapın

Ekran görüntüleri, model çizimler veya diyagramlar ekleyin:

@screenshot.png Implement this UI design with React components

Ne zaman kullanılır:

• Görsel bilgi gereksinimleri metinden daha etkili ilettiğinde
• UI/UX uygulaması (tasarım model çizimleri, tel çerçeveler, kullanıcı akışları)
• Görsel sorunları hata ayıklarken (bozuk düzen ekran görüntüsü, render sorunları)
• Karmaşık mimarileri anlama (sistem diyagramları, veritabanı şemaları, akış şemaları)
• Duyarlı tasarım, erişilebilirlik analizi ve hata yeniden üretimi için esastır
• Figma veya Sketch gibi araçlardan tasarımları koda çevirme
• İyi yakalanmış tek bir ekran görüntüsü genellikle paragraflarca tanımlanması gereken ayrıntıları iletir

Harici dokümantasyona veya örneklere referans verin:

Ultrathink: Read this API documentation at https://api-docs.example.com/v1/endpoints and implement the authentication flow

Ne zaman kullanılır:

• Çevrimiçi resmi dokümantasyonu olan harici API'ler veya kütüphanelerle entegrasyonlar uygularken
• Özellikle kütüphane karmaşık yapılandırma seçeneklerine veya kimlik doğrulama akışlarına sahip olduğunda değerlidir
• Kod oluşturmadan önce Verdent'e web içeriğini getirmesini ve analiz etmesini söylemek için "Ultrathink:" önekini kullanın
• Dokümantasyonun eğitim verilerinden daha güncel olduğu hızla gelişen API'ler için esastır
• Çerçeveye özgü kalıpları takip ederken (Next.js App Router, Vue Composition API)
• Uygulamaların güncel API sürümleriyle eşleşmesini ve resmi önerileri takip etmesini sağlar

İlk istem:

Add authentication to the API

Verdent'in yanıtı genel olabilir. İyileştirin:

Use JWT tokens stored in httpOnly cookies, implement refresh token rotation, and follow the authentication pattern from our existing UserController

Ne zaman kullanılır: Genel bir istekle başlayıp ilk yanıta göre ayrıntılar ekleme

Verdent'in uygulaması beklentilerinizle eşleşmiyorsa:

The validation logic is good, but use Joi schema validation instead of manual checks. Match the validation pattern in ProductController.js

Ne zaman kullanılır: Çıktıyı inceleyip belirli iyileştirmeleri belirledikten sonra

Kademeli olarak inşa edin:

Initial: "Create a UserProfile component"
Follow-up: "Add an avatar upload feature with image preview"
Follow-up: "Add validation - max 5MB, only jpg/png formats"
Follow-up: "Show upload progress with a progress bar"

Ne zaman kullanılır: Aynı oturumda özellikleri kademeli olarak oluştururken

Uygulama beklenmedik görünüyorsa:

Why did you use Redux instead of Context API? Can you explain the trade-offs for this use case?

Sonra anlayışınıza göre iyileştirin:

Actually, use Context API for consistency with the rest of our application

Ne zaman kullanılır: Değişiklik istemeden önce mantığı anlama

Karmaşık değişiklikler için:

Switch to Plan Mode
Show me how you would refactor the authentication system to support OAuth providers

Planı inceleyin, sorular sorun, yürütmeden önce yaklaşım üzerinde yineleyin.

Ne zaman kullanılır: İnceleme gerektiren büyük mimari değişiklikler

Verdent'in stili sizinkiyle eşleşmiyorsa:

The component structure is close, but use this pattern instead:
[paste example of your preferred structure]
Apply this same pattern to the remaining components

Ne zaman kullanılır: Kod stili tercihlerini belirleme veya pekiştirme

Çıktı belirtilmemiş kısıtlamaları ihlal ediyorsa:

Good approach, but don't modify the database schema - work within the existing User table structure

Ne zaman kullanılır: İlk uygulamayı gördükten sonra keşfedilen kısıtlamaları ekleme

Temel işlevsellikle başlayın, özellikleri yinelemeli olarak ekleyin:

Step 1: "Create basic CRUD endpoints for tasks"
Step 2: "Add pagination to the GET endpoint"
Step 3: "Add filtering by status and priority"
Step 4: "Add full-text search across title and description"

Ne zaman kullanılır: Her adımda test ile karmaşık özellikleri kademeli oluşturma