OpenSpec

Projenizi ayarlayın ​

Projeye OpenSpec ekleyin: init'i çalıştırın, ne yazdığını görün ve ayarlayın.

OpenSpec'in nerede olacağını seçin ​

  • Deponuzda (varsayılan): spesifikasyonlar ve değişiklikler, tanımladığı kodun yanında durur ve onunla birlikte sürümlenir. Bu sayfanın geri kalanı bu yolu izler.
  • Bir mağazada: kullanım sağlayan depolar tarafından paylaşılan, ayrı bir planlama deposu, çoklu depolu kurulumlar veya planlamayı depodan tamamen dışarı tutmak için. Stores (beta) bunu ne zaman değerli kılacağını ve nasıl kuracağını kapsar.

Projenizi başlatın ​

CLI kurulu olduğunda (Installation), projenizin kök dizininde init'i çalıştırın. Terminalinizde:

bash
cd <your-project>
openspec init

Init, hangi AI araçlarını kullandığınızı sorar, seçtiğinizler için iş akışı dosyalarını yazar ve elde ettiğinizi rapor eder:

OpenSpec Setup Complete

Created: Claude Code
6 skills and 6 commands in .claude/
Config: openspec/config.yaml (schema: spec-driven)

Yeni komutların etkili olması için IDE'nizi yeniden başlatın.

Init'i yeniden çalıştırmak güvenlidir:

  • Zaten kurduğunuz araçlar Created yerine Refreshed yazdırır.
  • Yeniden init çalıştırıp yeni bir araç seçtiğinizde o aracı ekler.
  • --tools bayrağı seçiciyi atlar (CLI referansı).

Mevcut bir project.md'yi geçirme ​

Init, eski openspec/project.md'yi config.yaml'ya kopyalamaz. Dosyayı korur ve AI destekli bir geçiş isteği yazdırır.

AI sohbetinizde:

Review openspec/project.md and migrate its useful content to openspec/config.yaml.
Keep context concise: include only project-wide facts needed during artifact creation, apply, and archive.
Move artifact-specific guidance into rules for the matching artifacts.
Move guidance for apply or archive into the matching operations entry.
Leave out generic, outdated, or verbose material. Do not delete project.md.

config.yaml'ı inceleyin, ardından hazır olduğunuzda project.md'yi silin.

Init neyi kurar ​

Init projenizde iki şey oluşturur:

  • Depo kökünde bir openspec/ klasörü
  • AI aracınızın klasörüne eklenen iş akışı dosyaları (beceri ve komutlar) (.agents/, .claude/ vb.)

Tümünü diğer kaynak kodunuz gibi commitleyin. Init deponuzdaki başka hiçbir şeyi değiştirmez (daha eski bir OpenSpec sürümünden kalıntı bulursa, temizlemeden önce sorar).

openspec/ klasörü ​

Her OpenSpec artefaktı burada, projenizin kökünde bulunur. Şöyle görünür:

openspec/
├── config.yaml     project settings and context for the AI
├── specs/          your specs (empty for now)
└── changes/        in-motion changes (empty for now)
    └── archive/    completed changes move here

Proje yapılandırması, config.yaml'ı kapsar.

İş akışı dosyaları (beceriler ve komutlar) ​

Bunlar OpenSpec iş akışlarıdır, çalışırken kullanacağınız eylemlerdir. İşte bunlar, çoğu aracın kullandığı paylaşılan .agents/ klasöründe kurulu beceriler olarak:

.agents/skills/
├── openspec-explore/              think through an idea first
├── openspec-propose/              propose a change
├── openspec-apply-change/         implement a change's tasks
├── openspec-update-change/        revise a change's plan
├── openspec-sync-specs/           sync a change's spec updates into specs/
├── openspec-archive-change/       move a finished change to the archive
├── openspec-verify-change/        check the implementation matches the plan (not included by default)
└── openspec-bulk-archive-change/  archive several changes at once (not included by default)

Bu varsayılan küme ve iki isteğe bağlı iş akışından oluşur. Profiller tüm on ikisini listeler.

Varsayılan olarak her iş akışı iki biçimde kurulur:

  • Beceri (openspec-apply-change): iş istediğinizde aracınızın kendi başına alacağı talimatlar.
  • Komut (Claude Code'da /opsx:apply): aynı iş akışının kısa bir ad altında yazılmış giriş noktası.

İkisi işlevsel olarak aynıdır. Bir iş akışının becerisi ve komutu aynı talimatları taşır.

Neden iki tane: komutlar önce geldi ve her araç onları kendi biçiminde yazar. Beceriler araçlar arasında paylaşılan daha yeni bir standarttır, ancak her araç bir beceriyi doğrudan çağıramaz, bu yüzden komutlar o araçların giriş noktası olarak kalır.

Bazı araçlar sadece beceri biçiminde kurar. Araç becerileri doğrudan çalıştırıyorsa, init komutları atlar ve bunu söyler (Komutlar atlandı: codex (becerileri kullanıyor)).

Becerileri tercih ediyoruz ve komutları sonunda kullanımdan kaldırmayı bekliyoruz.

Kurulacakları değiştirme ​

Etkileşimli seçici, teslimat biçimini ve iş akış kümesini değiştirir (Profiller). Terminalinizde:

bash
openspec config profile

Sadece becerilere geçiş örneği:

Current profile settings
  Delivery: both

? What do you want to configure? Delivery only
? Delivery mode (how workflows are installed): Skills only

Config changes:
  delivery: both -> skills
? Apply changes to this project now? (Y/n) y

Evet diyerek bunu mevcut projeye anında uygularsınız. Diğer projeler bir sonraki openspec update işlemlerinde bunu alır. Ayar makine bazında küreseldir.

Claude Code iş akışlarını göstermiyor ​

Claude Code, teslimat ayarınıza göre OpenSpec iş akışlarını bu proje yollarından birinden veya her ikisinden yükler:

  • Skills: .claude/skills/openspec-*/SKILL.md
  • Commands: .claude/commands/opsx/<id>.md

Dosyalar eksikse, projeyi yenileyin. Terminalinizde:

bash
openspec update

Komut dosyaları varsa ama /opsx: hiç OpenSpec komutu göstermiyorsa, Claude Code'u güncelleyin ve yeniden başlatın. Komutlar hala yüklenmiyorsa, becerileri de etkinleştirin. Terminalinizde:

bash
openspec config set delivery both
openspec update

Claude Code'u yeniden başlatın, ardından sohbetinde /openspec-propose çalıştırın. Sadece bazı iş akışları eksikse, profilinizi değiştirin.

Kurulum tamamlandı. Hızlı Başlangıç, ilk değişikliğinizi burada götürür.