Keşfetmeye Başla

/opsx:explore sizin düşünme ortağınız. Bir sorununuz var ama henüz bir planınız yoksa her zaman ona başvurun. Kod tabanınızı araştırır, seçenekleri sizinle birlikte tartar ve ne istediğinizi netleştirir; tüm bunlar tek bir çıktı veya satır kod oluşturulmadan önce yapılır. Resim netleştiğinde işi /opsx:propose komutuna devreder.

Bu belgelerden bir alışkanlık taşıyacaksanız, bunu taşıyın: emin değilseniz, önermeden önce keşfedin.

Bunun neden önemli olduğunu açıklayalım. Yapay zekâ kodlama asistanları heveslidir. Belirsiz bir şekilde sorarsanız, bir şey inşa etmeye güvenle başlarlar, ama belki de ihtiyacınız olan şey olmayabilir. Explore, bunun ilacıdır. Hem sizin hem de yapay zekânın birlikte doğru hamleyi belirlediği, hiçbir riski olmayan bir konuşmadır; böylece öneri yaptığınızda doğru şeyi önermiş olursunuz.

Ne zaman keşfetmeli

Keşfetmek, insanların düşündüğünden daha sık doğru ilk adımdır. Aşağıdakilerden herhangi biri geçerliyse kullanın:

• Sorunu biliyorsunuz ama çözümü bilmiyorsunuz. ("Sayfalar yavaş hissettiriyor." "Kimlik doğrulama bir karmaşa." "Sürekli mükerrer siparişler alıyoruz.")
• Yaklaşımlar arasında seçim yapıyorsunuz ve avantaj/dezavantajları gerçek kodunuza karşı ortaya koymak istiyorsunuz.
• Kod tabanına yeni geldiniz ve bir şeyi değiştirmeden önce nasıl çalıştığını anlamaya ihtiyacınız var.
• Gereksinimler belirsiz ve taahhüt vermeden önce netleştirmek istiyorsunuz.
• İşin göründüğünden daha büyük veya küçük olduğunu şüpheliyorsunuz ve kapsamını dürüstçe belirlemek istiyorsunuz.

Yalnızca ne istediğinizi ve nasıl yapacağınızı tam olarak bildiğinizde keşfetmeyi atlayın. Bu durumda doğrudan /opsx:propose komutuna geçin.

Ne yapar (ve ne yapmaz)

Explore bir konuşmadır, bir üretici değil.

Yaptıkları:

• Gerçek soruları yanıtlamak için kod tabanınızı okur ve arar.
• Seçenekleri karşılaştırır ve her birinin avantaj/dezavantajlarını belirtir.
• Bir tasarımı okunabilir kılmak için diyagramlar çizer.
• Belirsiz bir fikri somut, inşa edilebilir bir kapsama daraltmanıza yardımcı olur.
• Hazır olduğunuzda /opsx:propose komutuna geçiş yapar.

Yapmadıkları:

• Değişiklik klasörü oluşturmaz.
• Hiçbir çıktı yazmaz (öneri, spesifikasyon, tasarım veya görev yok).
• Kod yazmaz veya değiştirmez.

İşte mesele bu. Keşfetmek size hiçbir şey maliyet etmez ve sizi hiçbir şeye bağlamaz. Üç tane çıkmaz sokak keşfedebilir, her birinden bir şey öğrenebilir ve ancak o zaman hayatta kalan yolu öneri olarak sunabilirsiniz.

Zaten yüklü

Müjdeli haber: /opsx:explore, varsayılan core profiliyle birlikte gelir; propose, apply, update, sync ve archive komutlarının hemen yanında. Hiçbir şeyi etkinleştirmenize gerek yok. OpenSpec projenizde yapılandırıldıysa, explore yapay zekâ sohbetinizde hazır. (Tüm /opsx:* komutlarında olduğu gibi, bunu terminalde değil, asistanınızın sohbetinde yazarsınız. Bkz. Komutlar Nasıl Çalışır.)

Tam bir örnek

Belirsiz bir endişenin nasıl keskin, inşa edilebilir bir değişikliğe dönüştüğünü izleyin.

You: /opsx:explore

AI:  What would you like to explore?

You: Our checkout sometimes creates duplicate orders. I don't know why
     and I don't know how to fix it safely.

AI:  Let me dig into the checkout path...
     [reads the order service, the payment webhook handler, and the
      client submit logic]

     Here's what I found. There are two ways a duplicate can happen:

     1. The client can submit twice (double-click, retry on slow network).
        Nothing debounces it.
     2. The payment webhook can fire more than once, and the handler
        creates an order each time. There's no idempotency key.

     Cause #2 is the dangerous one: it can charge and fulfill twice.

     Three ways to fix it, roughly in order of robustness:
     - Idempotency key on the order-creation endpoint (handles both causes)
     - Dedup on the webhook by payment-intent id (handles #2 only)
     - Client-side debounce (handles #1 only, papers over the real bug)

     Given your code already stores the payment-intent id, the
     idempotency-key approach is a small change with the biggest payoff.
     Want me to scope that?

You: Yes, let's do the idempotency key.

You: /opsx:propose add-order-idempotency-key

AI:  Created openspec/changes/add-order-idempotency-key/, with a proposal
     and delta spec grounded in what we just found. Ready for implementation.

Ne olduğunu fark edin. Başlangıç noktası "bir şey yanlış ve dokunmaktan korkuyorum" idi. Yirmi saniyelik bir keşif, bunu adlandırılmış bir kök nedene, üç sıralı seçeneğe, mevcut koda bağlı bir öneriye ve kesin bir değişikliğe dönüştürdü. Sonraki öneri keskindir çünkü düşünme önce yapılmıştır.

Propose'a devretme

Explore hiçbir şeye arşivlenmez. Hazır olduğunuzda, basitçe bir değişiklik başlatırsınız ve yapay zekâ konuşmanızdan bağlamı çıktılara taşır.

explore  ──►  propose  ──►  apply  ──►  archive
 (think)     (agree)       (build)     (record)

Bunu düz dille söyleyebilirsiniz ("bunu bir değişikliğe dönüştürelim") veya doğrudan /opsx:propose <name> komutunu çalıştırabilirsiniz. Her iki durumda da, az önce yaptığınız keşif, atılacak bir sohbet değil, önerinin temeli haline gelir.

Genişletilmiş komut setini kullanıyorsanız, explore adım adım çıktı oluşturma için /opsx:new komutuna devredebilir. Bkz. Akışlar.

İyi bir keşif için ipuçları

• Sorunu getirin, çözümü değil. "Girişler yavaş hissettiriyor" yapay zekâya araştırma alanı verir. "Redis önbelleği ekleyin" henüz test etmediğiniz bir cevaba sizi önceden bağlar.
• Avantaj/dezavantajları açıkça sorun. "Her seçeneğin dezavantajları neler?" daha dürüst bir karşılaştırma sağlar.
• Önce okumasına izin verin. En iyi keşifler, yapay zekânın tahmin etmek yerine gerçekten kodunuza bakmasıyla başlar. Yardımcı oluyorsa ilgili alana yönlendirin.
• Vazgeçmek sorun değil. Keşif fikrin değmeyeceğini ortaya koyarsa, bu bir kazançtır. Ucuz bir şekilde öğrendiniz.
• Değişiklik sırasında tekrar keşfedin. /opsx:apply sırasında takıldınız mı? Geri adım atıp alt bir sorunu keşfedebilir, sonra geri dönebilirsiniz.

Dürüst avantaj/dezavantajlar

Kazanımlarınız: explore, yanlış dönüşleri mümkün olan en ucuz anda, herhangi bir çıktı var olmadan yakalar. Özellikle tanımadığınız kodda, yapay zekânın sistemi okuma ve özetleme yeteneği size bir öğleden fazla kazandırır.

Maliyeti: biraz sabır. Explore bir konuşmadır, bu yüzden /opsx:propose komutunu ateşleyip umut etmekten daha yavaştır. Gerçekten zaten anladığınız işler için bu ekstra adım saf bir yük demektir ve atlamalısınız.

Kural: Görev ne kadar belirsizse, explore o kadar kârlıdır. Görev ne kadar netse, doğrudan öneriye geçiş o kadar uygundur.

Sonraki adımlar

• Komutlar: /opsx:explore: kesin referans
• Akışlar: günlük döngünün bir parçası olarak explore
• Örnekler ve Tarifler: tam bir anlatımda explore
• Başlangıç: ilk değişiklik rehberi, keşif dahil