Plan öncelikli iş akışları

Plan öncelikli iş akışları, Plan Mode'tan yararlanır; bu, Verdent'in herhangi bir değişiklik yapmadan önce kodu analiz ettiği, araştırma yürüttüğü ve ayrıntılı planlar oluşturduğu salt okunur bir yürütme modudur. Bu iş akışı, stratejik planlamayı uygulamadan ayırarak kod değişikliklerine geçmeden önce inceleme ve iyileştirme yapmanıza olanak tanır.

Plan Mode ne zaman kullanılır

Koordinasyon gerektiren karmaşık, çok dosyalı değişiklikler
En iyi uygulama yaklaşımı konusundaki belirsizlik
Üretim açısından kritik koda yapılan yüksek riskli değişiklikler
Keşif gerektiren tanıdık olmayan kod tabanlarındaki görevler
Yürütmeden önce onay gerektiren stratejik planlama ihtiyaçları

Yapay zeka destekli görev ayrıştırma

Verdent, yapay zeka destekli görev ayrıştırma yoluyla karmaşık istekleri yönetilebilir, ardışık adımlara otomatik olarak böler.

Ayrıştırma süreci

İstek analizi

Verdent, doğal dil isteğinizi analiz ederek şunları belirler:

Birincil amaç ve istenen sonuç
Etkilenen dosyalar, bileşenler veya sistemler
Gerekli teknik işlemler ve bağımlılıklar
Olası karmaşıklık faktörleri

Kod tabanı bağlamı

Verdent, şunları anlamak için proje yapınızı inceler:

Mevcut mimari ve yerleşik desenler
Dosya organizasyonu ve teknoloji yığını
Değişiklik gerektiren mevcut uygulamalar

Görev ayrıştırma

Verdent, isteği mantıksal alt görevlere böler:

Doğal kesme noktalarını ve uygulama aşamalarını belirler
Görevleri bağımlılığa göre sıralar (önce ön koşul görevleri)
İlgili işlemleri bir araya gruplar
Her alt görevin kapsamını ve karmaşıklığını tahmin eder

Etkileşimli netleştirme

Verdent, ayrıştırmayı iyileştirmek için sorular sorabilir:

"Mevcut doğrulamayı mı değiştireyim yoksa yeni bir doğrulayıcı mı oluşturayım?"
"Etkilenen tüm bileşenler için testleri güncellemek ister misiniz?"
"Bu değişiklik hem web hem de mobil bileşenlere uygulansın mı?"

Ayrıştırma özellikleri

15-45 dakikalık odaklanmış çalışma için boyutlandırılmış görevler
Test ve doğrulama için doğal kesme noktaları
Anlamlı olacak kadar karmaşık, yürütülecek kadar basit

Bağımlılıklara uyulur (uygulamadan önce kurulum)
Mantıksal ilerleme (veri katmanı → iş mantığı → arayüz)
Önemli aşamalardan sonra doğrulama adımları

Plan ayrıştırma biçimi, şunları kontrol etmek için plan_rules.md aracılığıyla özelleştirilebilir:

Ayrıntı düzeyi (üst düzey veya ayrıntılı)
Plan yapısı ve bölümleri
Dahil edilen bilgiler (süre tahminleri, riskler, bağımlılıklar)

Plan inceleme ve onay

Plan Mode'da bir istek gönderdikten sonra, Verdent incelemeniz için Chat View'da görüntülenen yapılandırılmış bir plan oluşturur.

İnceleme süreci

Yapılandırılmış planı alın

Verdent, net bölümler, numaralandırılmış adımlar, etkilenen dosyalar ve belirlenen bağımlılıklarla bir plan oluşturur

Plan kalitesini analiz edin

Şunları gözden geçirin:

Doğruluk: Yaklaşım sorunu çözüyor mu?
Eksiksizlik: Gerekli tüm adımlar dahil edildi mi?
Verimlilik: Bu en iyi yaklaşım mı?
Risk: Ne ters gidebilir? Uç durumlar veya güvenlik endişeleri var mı?

Netleştirici sorular sorun

Belirsiz bir şey varsa ek bilgi isteyin:

Can you explain step 3 in more detail?
Why are we modifying both the service and controller?
What happens if the API call fails in step 5?

Değişiklik isteyin

Planı gözden geçirmek için geri bildirim verin:

Let's use JWT tokens instead of OAuth2
Can we break step 4 into smaller substeps?
Add error handling considerations to the plan

Sonraki eyleminizi seçin

Verdent planı oluşturduktan sonra iki seçenek sunulur:

Edit: Değişiklik isteyin, netleştirici sorular sorun veya planı daha da iyileştirin
Start Building: Agent Mode'a geçin ve onaylanan planı yürütmeye başlayın

Plan etkileşim seçenekleri

Oluşturulan planı inceledikten sonra, Verdent iki seçenek sunar:

Edit:

Bu seçeneği şunlar için seçin:

Plan yaklaşımında belirli değişiklikler isteyin
Uygulama ayrıntıları hakkında netleştirici sorular sorun
Eksik öğeler veya hususlar ekleyin
Belirli adımları basitleştirin veya genişletin
Alternatif yaklaşımları keşfedin

Bu, herhangi bir değişiklik yürütmeden yinelemeli iyileştirme için sizi Plan Mode'da tutar.

Start Building:

Bu seçeneği şunlar için seçin:

Agent Mode'a geçin ve yürütmeye başlayın
Onaylanan planı tam özerklikle uygulayın
Planlandığı gibi dosya değişiklikleri yapın ve komutları yürütün

Ayrıca şunları da tercih edebilirsiniz:

Manuel uygulama: Planı inceleyin ve değişiklikleri kendiniz uygulayın
Artımlı yürütme: Verdent'ten, aşamalar arasında inceleme için kontrol noktaları olan belirli aşamaları uygulamasını isteyin

Plan üzerinde gerektiği kadar yineleme yapmak için Edit'i kullanın. Yalnızca yaklaşımın doğru ve eksiksiz olduğundan emin olduğunuzda Start Building'i seçin.

Yinelemeli planlama

Kullanıcılar, Edit'i seçerek ve sohbet biçiminde geri bildirim sağlayarak planları serbestçe değiştirebilir ve üzerinde yineleme yapabilir. Verdent, plan oluşturmayı etkileşimli, yinelemeli bir süreç olarak ele alır.

Değişiklik yöntemleri

Belirli değişiklikler isteyin:

Change step 3 to use Redux instead of Context API
Add input validation before the database insert
Swap the order of steps 4 and 5

Eksik öğeler ekleyin:

Add error handling for network failures
Include rollback procedures
Add performance optimization considerations

Basitleştirin veya genişletin:

This is too complex - can we simplify the approach?
Break down step 5 into more detailed substeps
Give me more detail on the database schema changes

Alternatifleri keşfedin:

What if we used webhooks instead?
Show me an alternative plan using microservices architecture
Can we accomplish this without changing the database schema?

Örnek yineleme akışı

User: "Add user authentication to the API"

[Verdent generates initial plan with JWT tokens]

User: "Actually, let's use OAuth2 instead of JWT"

[Verdent revises plan to use OAuth2]

User: "Add step for migrating existing users"

[Verdent adds migration step to plan]

User: "Can you break down the migration step more?"

[Verdent expands migration with detailed substeps]

User: Chooses **Start Building**

[Verdent switches to Agent Mode and begins execution]

Sınırsız yineleme:

Revizyon sayısında sınır yoktur
Her yineleme sohbet bağlamını korur
Önceki sürümler sohbet geçmişinde saklanır
Önceki plan sürümlerine başvurabilirsiniz: "ilk yaklaşıma geri dön"

Plan reddi, yinelemeli planlama sürecinin doğal bir parçasıdır. Yalnızca onaylanmış, iyi anlaşılmış stratejilerin yürütülmesini sağlayarak yanlış uygulamalar için harcanan çabayı azaltır.

SSS (Sıkça sorulan sorular)

Plan Mode dosyalarıma gerçekten kod yazıyor mu?

Hayır. Plan Mode kesinlikle salt okunurdur:

Verdent, dosyaları okuyabilir, kod arayabilir ve kod tabanınızı analiz edebilir
Plan Mode sırasında dosya yazma, düzenleme veya silme işlemi gerçekleşmez
Planlar yalnızca Chat View'da görüntülenir
Kod yürütme yalnızca siz açıkça onayladıktan ve Agent Mode'a geçtikten sonra başlar

Güvenlik garantisi: Plan Mode kodunuzu yanlışlıkla değiştiremez. Güvenli keşif ve strateji geliştirme için tasarlanmıştır.

Bir planı tek seferde değil, artımlı olarak yürütebilir miyim?

Evet. Artımlı yürütme tamamen desteklenir:

Artımlı onay deseni:

Let's start with Phase 1 first, then we'll review before continuing
Implement steps 1-3, then stop for review
Do the database migration first, I'll review before the API changes

Nasıl çalışır:

Verdent belirtilen adımları yürütür
İnceleme kontrol noktasında durur
Sonuçları inceler ve geri bildirim sağlarsınız
Sonraki aşamayla devam edin veya yaklaşımı ayarlayın
Tamamlanana kadar tekrarlayın

En uygun olduğu durumlar: Aşamalı dağıtımın riski azalttığı yüksek riskli değişiklikler, tanıdık olmayan desenler, üretim açısından kritik kod.

Artımlı yürütme, bir planın bazı bölümlerini onaylarken diğerlerini ertelemenize olanak tanır; bu, görev ortasında öncelikler değiştiğinde kullanışlıdır.

Bir planı reddedersem ne olur?

Plan reddi tamamen normaldir ve beklenir:

Verdent, geri bildiriminize göre yeni bir plan oluşturur
Önceki plan sürümleri başvuru için sohbet geçmişinde kalır
Hiçbir kod değişikliği gerçekleşmez (Plan Mode salt okunurdur)
Memnun kalana kadar sınırsız kez yineleme yapabilirsiniz

Yaygın reddetme nedenleri:

Yaklaşım çok karmaşık veya çok basit
Eksik uç durumlar veya hata işleme
Daha iyi bir alternatif mimari mevcut
Yanlış anlaşılan gereksinimler

İpucu: Reddetme sürecin bir parçasıdır. Planları yinelemeli olarak iyileştirmek, yanlış stratejileri yürütmek için çaba harcamaktan daha iyidir.

Plan Mode ve Agent Mode arasında nasıl geçiş yaparım?

Geçiş, Input Box aracılığıyla anında gerçekleşir:

Plan Mode'a geçmek için:

Input Box'taki Switch Mode düğmesine tıklayın
Açılır menüden Plan Mode'ı seçin
VEYA şunu söyleyin: "Switch to Plan Mode"

Plan Mode'tan çıkmak için:

Input Box'taki Switch Mode düğmesine tıklayın
Açılır menüden Agent Mode'ı seçin
VEYA bir planı inceledikten sonra Start Building'i seçin

Mod kalıcılığı:

Mod seçimi mevcut oturum içinde kalıcıdır
Yeni oturumlar varsayılan Agent Mode'da başlar
İstediğiniz zaman serbestçe mod değiştirebilirsiniz

Tipik iş akışı: Plan Mode → inceleme → Agent Mode → yürütme → bir sonraki karmaşık özellik için tekrar Plan Mode.

Oluşturulan planların biçimini ve ayrıntı düzeyini özelleştirebilir miyim?

Evet, plan_rules.md kullanarak:

Konum: ~/.verdent/plan_rules.md (genel yapılandırma dizini)

Özelleştirebilecekleriniz:

Ayrıntı düzeyi: Üst düzey genel bakış veya ayrıntılı adım adım
Plan yapısı: Dahil edilecek bölümler (özet, riskler, bağımlılıklar, test)
Dahil edilen bilgiler: Süre tahminleri, dosya yolları, doğrulama adımları
Biçim tercihleri: Numaralandırılmış listeler, aşamalar, kategorilendirme

Örnek plan_rules.md:

# Plan Rules

## Plan Structure
- Start with a brief summary (2-3 sentences)
- Include estimated time for each major step
- List prerequisites before implementation steps
- Identify potential risks and mitigation strategies

## Level of Detail
- Break tasks into subtasks of 15-30 minutes
- Include specific file paths for modifications
- List functions or components to create/modify
- Provide verification steps for each phase

Değişiklikler, yeni Plan Mode oturumlarına anında uygulanır.

Plan Mode, Agent Mode ile aynı bağlamı mı kullanır?

Hayır, Plan Mode'ın ayrı bir bağlam yönetimi vardır:

Plan Mode bağlamı: Analiz ve stratejik düşünme için optimize edilmiştir
Agent Mode bağlamı: Yürütme ve uygulama için optimize edilmiştir
Avantaj: Planlar, yürütme bağlamını keşif amaçlı araştırmalarla kirletmez

Ayrımın neden önemli olduğu:

Plan Mode, Agent Mode'u karıştırmadan birden fazla yaklaşımı keşfedebilir
Reddedilen plan denemeleri Agent Mode bağlamını tüketmez
Yürütmeye geçerken temiz bir başlangıç

Bağlam sıfırlama: Mod değiştirmek, yeni görev türü için taze bir bağlam sağlar.

Planlama sırasında Verdent netleştirici sorular sorarsa ne olur?

Netleştirici sorular ayrıştırma sürecinin bir parçasıdır:

Soruların neden sorulduğu:

Belirsiz gereksinimler netleştirme gerektirir
Birden fazla geçerli yaklaşım mevcuttur (birini seçin)
Henüz belirtilmemiş uç durumlar veya kısıtlamalar
İlk istekten net olmayan tercihler

Nasıl yanıt verilir:

Sohbet diliyle doğrudan yanıtlayın
Yardımcı olacaksa örnekler verin
Verdent'in yargısına güveniyorsanız "senin seçimin" deyin
Emin değilseniz karşı sorular sorun

Örnek diyalog:

Verdent: "Should I modify the existing validation or create a new validator?"
You: "Create a new validator - we'll deprecate the old one later"
Verdent: [Updates plan with new validator approach]

İpucu: Sorular, Verdent'in özel ihtiyaçlarınıza uygun, doğru ve ilgili planlar oluşturmasına yardımcı olur.