Plan Modu

Projenizin koduna ya da verisine dokunmadan önce ajanla birlikte düşünmeyi, araştırmayı ve iş planı çıkarmayı öğrenin.

Plan Modu nedir?

Plan modunda Numex ajanına soru sorar, fikir geliştirir ve işinizi uygulamaya geçmeden önce planlarsınız. Plan modu şunları yapmanızı sağlar:

• Fikir geliştirin ve projeniz için farklı yaklaşımları keşfedin
• İşi planlayın: isteğiniz sıralı adımlara, değişecek dosyalara ve risklere ayrılır
• Mimariyi birlikte kurun: veri modeli, API ve ekranlar kod yazılmadan konuşulur
• Danışın: ajan projenizi okur ve arar ama hiçbir dosyayı değiştirmez, komut çalıştırmaz
• Tek düğmeyle uygulamaya geçin: plan hazır olunca ajan aynı sohbette, planı görerek işe başlar

Plan sekmesi seçili değilken ajan Sohbet sekmesinde (Üstad modu) isteğinizi doğrudan uygular. Plan modu kod yazmadan önce düşünmeye ve planlamaya odaklanır.

Hangi modu ne zaman kullanmalı?

Başlarken

Plan moduna geçmek

1. Projenizi açın ve Numex sohbet panelini açın (Ctrl + Alt + M)
2. Panelin üstündeki Plan sekmesini seçin (Sohbet · Plan · Otonom · Hata Avcısı)
3. İsteğinizi yazıp gönderin. Yazma alanının altında mod ● Plan olarak görünür.

Kısayollar

Komut satırında (Numex CLI)

Terminaldeki Numex oturumunda /plan yazın; aynı komut plan modunu kapatır. Plan bitince /plan ile modu kapatıp "planı onaylıyorum, uygula" yazmanız yeterli.

$ numex
› /plan
Plan modu AÇIK — dosya yazma/komut kapalı. Model önce plan sunar.
› Siparişlere iade akışı ekleyeceğiz, adım adım planla.

Temel özellikler

Görev planlama

Plan modu karmaşık işleri yönetilebilir adımlara bölmekte güçlüdür. Ajana ne istediğinizi anlatın; ajan önce projenizi okur, sonra işi tamamlamak için gereken adımları sıralı bir plan olarak çıkarır. Her planda üç şey bulunur:

1. Ne yapılacak: adım adım, uygulanabilir sırayla
2. Hangi dosyalar değişecek ya da oluşacak
3. Riskler ve varsayımlar: neyin bozulabileceği, neyin değişmeyeceği

İş çok adımlıysa ajan planı ayrıca bir görev listesine döker. Uygulama başladığında bu liste panelin altında adım adım ilerler.

Ajanın plan modunda kullandığı araçlar

Plan modunda yalnız okuma, arama ve araştırma araçları açıktır:

Dosya yazma, düzenleme, silme ve komut çalıştırma (kurulum, derleme, sunucu) plan modunda kapalıdır. Plan sekmesini siz seçtiyseniz ajan plandan kendi kendine çıkamaz; uygulama yalnız sizin onayınızla ya da sekmeyi değiştirmenizle başlar.

Birlikte fikir geliştirme

• Birden çok çözüm yolu: "İki yol öner" deyin, ajan seçenekleri yan yana koysun
• Artı ve eksi analizi: hız, bakım kolaylığı ve maliyet açısından karşılaştırma
• Risk değerlendirmesi: eşzamanlı kullanım, veri kaybı, geriye dönük uyumluluk

Uçtan uca örnek: sepete kupon

Bir e-ticaret projesine kupon özelliği eklediğimizi düşünelim. Plan modunda tipik bir akış şöyle ilerler:

1. İsteği yazın

   Plan sekmesinde: "Sepete kupon kodu ekleyeceğiz. Nasıl yapalım, planla."

2. Ajan projeyi okur ve planı çıkarır

   Sepet, fiyat hesabı ve veritabanı şemasını okur; kupon tablosu, sunucuda doğrulama, API uçları, arayüz ve tarayıcıda doğrulama adımlarını sıralar. Riskleri de yazar.

3. Planı düzeltin

   Beğenmediğiniz yeri söyleyin: "Kupon tek kullanımlık olsun, mevcut orders tablosu değişmesin." Ajan planı yeniden düzenler. Bu aşamada değişiklik ucuzdur.

4. ▶ Planı uygula

   Panel Sohbet (Üstad) moduna geçer ve "Planı onaylıyorum, uygula." mesajını gönderir. Plan sohbette kaldığı için ajan onu görerek çalışır.

5. İlerlemeyi görev listesinden izleyin

   Panelin altındaki şerit kaçıncı adımda olunduğunu gösterir (2/5). İş sürerken yazdığınız yeni istekler planın yerine geçmez, listeye eklenir.

Akış: plandan uygulamaya

1. Planlama aşaması (Plan modu)

• Kapsamı ve hedefleri belirleyin
• Gereksinimleri somut özelliklere bölün
• Mimariyi ve teknolojiyi planlayın
• Bitti ölçütlerini yazın: "tarayıcıda kupon girilince toplam düşsün"

2. Onay ve uygulama

• Önerilen planı inceleyin, gerekiyorsa yazarak düzeltin
• Hazırsanız ▶ Planı uygula'ya basın; panel Sohbet (Üstad) moduna geçer
• Ajan planı uygular; değişiklikleri onayınıza sunar, ilerlemeyi görev listesinde gösterir

Plan onayı kartı

Plan sekmesine geçmeden de "önce planı göster" diyebilirsiniz. İsteğinizde aşağıdaki sözlerden biri geçerse ajan önce planı hazırlar, implementation_plan.md dosyasına yazar ve onay kartıyla bekler:

• "kodlamaya başlamadan önce …"
• "önce plan sun / yaz / hazırla"
• "onayımı bekle" · "onay bekle"
• "uygulama planı" · "implementation_plan.md"

Yalnız "adım adım" demek onay kartını açmaz; bu bir anlatım üslubu sayılır ve iş doğrudan başlar.

Karttaki düğmeler yerine yazarak da cevap verebilirsiniz:

Plan dosyası proje kökünde durur; kod incelemesinde ya da ekip arkadaşınızla paylaşmak için kullanabilirsiniz:

# Uygulama Planı

## Adımlar
1. returns tablosu ve RETURN_REQUESTED / RETURNED durumlarını ekle
2. Müşteri hesabında teslim edilmiş siparişe "İade talebi" formu
3. Yönetim panelinde iade listesi: onayla / reddet / tamamla
…

## Dosyalar
- src/db/schema.sql
- src/routes/returns.js
…

## Kabul Kriterleri
- Teslim edilmemiş sipariş için iade açılamaz
…

## Riskler
- Aynı satır için iki talep: adet sınırı sunucuda denetlenmeli

Otonom modda plan

Otonom mod uzun işler içindir; onay sormadan yazar, düzenler ve çalıştırır. Büyük bir işte ilk planı yine size sunar; siz onaylayınca ya da "doğrudan geliştir" dediyseniz durmadan sürer.

Hazır istemler

Aşağıdakileri kopyalayıp kendi projenize göre düzenleyin:

Kullanım alanları

Özellik planlama

• Karmaşık özellikleri uygulanabilir adımlara bölün
• Veritabanı değişikliklerini ve API güncellemelerini planlayın
• Arayüzü ve kullanıcı akışını tasarlayın
• Kenar durumlarını ve hata yönetimini baştan düşünün

Öğrenme ve keşif

• Farklı yaklaşımları karşılaştırın
• Yeni teknolojileri ve kütüphaneleri tanıyın; ajan gerekirse web'de araştırır
• Yabancı bir projenin nasıl çalıştığını sorun; hiçbir dosya değişmez
• Tasarım kalıpları ve iyi uygulamalar hakkında yol alın

İyi uygulamalar

Etkili istem yazma

• Somut olun: "Sepete kupon ekle; yüzde ve sabit tutar, tek kullanımlık, son kullanma tarihi olsun."
• Olmazsa olmazları söyleyin: "Mevcut sipariş tablosu değişmesin", "Türkçe arayüz".
• Seçenek isteyin: "İki yol öner, artı ve eksileriyle."
• Uygulamadan önce düzeltin: planda değişiklik ucuzdur; uygulama başladıktan sonra yön değiştirmek daha çok iş demektir.
• Önceki kararlara atıf yapın: "Dün konuştuğumuz gibi ödeme adımı en sonda."
• Bitti ölçütü verin: "Tarayıcıda kupon girilince toplam düşsün, yanlış kodda uyarı çıksın."

Daha fazlası için Prompt Rehberi'ne bakın.

Token kullanımı

Plan modu da diğer ajan etkileşimleri gibi token harcar: soruların cevapları, projede yapılan okuma ve aramalar, çıkarılan plan. Harcama aynı hesaptan düşer; büyük projelerde ve uzun sohbetlerde artar.

Tüm ajan etkileşimleri ücretlendirilir. Ajan yalnız metinle cevap verse de kod değiştirse de bir harcama olur; küçük istekler daha az tutar. Yine de planı uygulamadan önce düzeltmek, sonradan yön değiştirmekten genellikle daha ucuzdur. Kalan bakiyenizi Planlar sayfasından görebilirsiniz.

Sorun giderme

Sık sorulanlar