Çizeylem Öz

Öz, projenin içinde yaşayan bir hafızadır.

Projenin nereye gittiğini, neye söz verdiğini ve neyi yapmayacağını yazılı tutar. Böylece o depoda çalışan yapay zekâ ajanı her oturumda sıfırdan bilgilendirilmek zorunda kalmaz: ne yapacağını dosyadan okur, sınırı aştığında durur, kararı insana sorar.

Çizeylem ürünlerinde Öz zorunludur.

npx @cizeylem/oz kur

Ne kurar

Projenin köküne dört şey girer:

oz/ — projenin kendi içeriği. Yön, anayasa, kararlar ve açık meseleler. Dört dosya ve bunların geçmişini tutan bir archive/ dizini. Kurulumda boş gelir, projeye özel dolar.

AGENTS.md — agent protokolü. Her üründe aynıdır ve oz-protokol işaretleri arasında durur. Ajanın nasıl çalışacağını, ne zaman durup soracağını burası söyler.

CLAUDE.md ve GEMINI.md — AGENTS.md dosyasını okumayan araçlar için işaretçi.

.claude/skills/ — iki komut. task-yaz bir işi ajana verilebilir hale getirir; oz-guncelle Öz dosyalarını gerçeğe uygun tutar.

Kurulum mevcut hiçbir dosyanın üzerine yazmaz. AGENTS.md varsa protokolü sonuna ekler, içeriğini korur. oz/ zaten varsa hiçbir şey yapmadan durur.

Dosyalar oluştuktan sonrası ajanın işidir — depoyu inceler ve Öz'ü dolduran soruları sorar. Kurulum dokümanını ajana ver:

cat "$(npx @cizeylem/oz kurulum)"

Güncelleme

Öz kurulu bir projenin kökünde:

npx @cizeylem/oz@latest guncelle          # bakar, yazmaz
npx @cizeylem/oz@latest guncelle --yaz    # uygular

Yalnız iki şeyi tazeler: AGENTS.md içindeki protokol bloğu ve skill dosyaları. Bunlar her üründe ortaktır, sürümle gelir.

oz/ altına dokunmaz. Orası projenin kendi hafızası; yazdığın hiçbir söz bir paket güncellemesiyle değişmez.

Commit atmaz. Değişikliği görür, gözden geçirir, kendin commit edersin.

@latest yazmayı ihmal etme — npx yazmadığın sürüm için önbelleğindeki eski kopyayı çalıştırıp "güncel" diyebilir.

Durum

npx @cizeylem/oz durum     # kurulu mu, güncel mi
npx @cizeylem/oz yardim    # komutların tamamı

durum her şey güncelse 0, fark veya eksik varsa 1 döner. Böylece bir betik ya da CI adımı "bu proje sürümle aynı hizada mı" sorusunu çıktı okumadan sorabilir.

Lisans

Bu paket Çizeylem'e aittir ve Çizeylem ürünlerinde kullanılmak üzere yayınlanmıştır. Açık kaynak değildir; yazılı izin olmadan kullanılamaz, kopyalanamaz, türetilemez.

Öz'ün nasıl geliştirildiği GELISTIRME.md içindedir.