OpenSpec

Worksets (beta) ​

Store'u ve onu kullanan repo'ları tek bir editör penceresinde açın; böylece agent'ınız her ikisini de görür.

Bir store ile agent'ınızın ihtiyaç duyduğu bağlam klasörlere bölünür. Spesifikasyonlar ve değişiklikler store'da, kod ise her repo'da bulunur. Bir repo'da başlatılan agent yalnızca o repo'yu okuyup grep'leyebilir; başka hiçbir şeyi göremez, bu yüzden resmin yalnızca yarısıyla çalışır.

Worksets, OpenSpec'in bunun için sunduğu yardımcı araçtır. Bir workset, birlikte açtığınız klasörlerin kaydedilmiş, adlandırılmış listesidir. Bu sayfa, store'un makinenizde zaten kurulmuş ve kayıtlı olduğunu varsayar. Store'lar (beta) bunu ele alır.

Nasıl çalışır ​

  • Nedir: yalnızca makinenizde saklanan adlandırılmış bir klasör listesi. Üye klasörlere hiçbir şey yazılmaz ve hiçbir şey commit'lenmez.
  • Açma ne yapar: OpenSpec listeden bir .code-workspace dosyası oluşturur ve editörünüzü bu dosyayla başlatır. Her üye klasör tek bir pencerede yer alır.
  • Ne elde edersiniz: Editörünüzün araması ve o pencerede çalıştırdığınız herhangi bir agent, her üye klasörü okuyabilir. Agent, tek bir oturumda store'un spesifikasyonlarını ve repo'nun kodunu grep'leyebilir.
  • Neyi değiştirmez: bir komutun hangi openspec/ klasörünü kullanacağını değiştirmez. Bu, hâlâ Artefaktların nerede oluşturulduğu kuralına uyar.

Kurulum ​

  1. Workset'i kaydedin (makine başına bir kez). Repo'yu ve store'u üye olarak listeleyin ve bunları açmak için kullanılacak aracı belirtin:

    bash
    # birlikte açtığınız klasörlerin adlandırılmış listesini kaydedin
openspec workset create platform \
  --member ~/src/web-app \
  --member ~/openspec/team-plans \
  --tool code
    yaml
    Saved workset 'platform' (2 members) to your machine.
Open it any time with: openspec workset open platform

  2. İşe başladığınızda açın:

    bash
    # her üyeyi tek bir VS Code penceresinde açın
openspec workset open platform

openspec workset list kaydettiklerinizi gösterir; openspec workset remove <name> ise üye klasörlere dokunmadan bir workset'i siler:

yaml
platform  (opens in VS Code)
  web-app     /Users/you/src/web-app
  team-plans  /Users/you/openspec/team-plans

Kullanım: tek değişiklik, iki klasör ​

Diyelim ki add-login değişikliği team-plans store'unda, kodu ise web-app içinde. platform workset'ini açın ve agent'ınızdan değişikliği uygulamasını isteyin. Tek bir oturumda agent şunları yapabilir:

  • team-plans/openspec/changes/add-login/ dizinini ve yanındaki spesifikasyonları okuyabilir
  • web-app/ içindeki kodu düzenleyebilir
  • web-app içinden openspec komutlarını çalıştırabilir

Workset olmadan agent yalnızca başlatıldığı klasörü görür.

Hazır gelen araçlar ​

  • VS Code (--tool code) ve Cursor (--tool cursor): yerleşik olarak gelir. Her biri tüm üye klasörlerle tek bir pencere açar.
  • Terminalde Claude Code ve Codex: bu akış yeniden düzenlenirken workset açıcı olarak geçici olarak devre dışı bırakıldı. --tool claude veya --tool codex bunu belirten bir hatayla durur ve sizi VS Code veya Cursor'a yönlendirir.
  • Diğer editörler: bunları CLI ayarları (config.json) içindeki openers anahtarı altına ekleyin.