MemoryCustodian

1) MemoryCustodian'ı yükleyin (ajanınıza/iş akışınıza uygun yolu seçin): Bir yükleme yöntemi seçin: - Kodlama ajanıza depodan beceriyi yüklemesini isteyin: https://github.com/waittim/MemoryCustodian - Codex (yerel pazar yeri): bir ödeme noktasından `codex plugin marketplace add .` komutunu çalıştırın, ardından `codex plugin add memory-custodian@memory-custodian-dev`. - Claude Code (eklenti): yerel test için `claude --plugin-dir .` komutunu çalıştırın veya `./install.sh claude` ile kişisel becerilere yükleyin. - Gemini tarzı ajanlar: `./install.sh gemini` veya `gemini skills link ./skills/memory-custodian` ile yükleyin. - CLI/kaynak ödeme: `scripts/memory-custodian ...` aracılığıyla depodan çalıştırın veya `python3 -m pip install -e .` ile düzenlenebilir olarak yükleyerek `memory-custodian` komutunu alın.

2) Bir projede MemoryCustodian'ı başlatın (depo başına bir kez): Her hedef proje için başlatmayı bir kez çalıştırın: - Bir konsol betiği olarak yüklendiyse: `memory-custodian init --project-root /path/to/project --agent all` - Bir kaynak ödeme noktasından: `scripts/memory-custodian init --project-root /path/to/project --agent all` Ajanınızın okuduğu ince önyükleme dosyasını/dosyalarını oluşturmak için `--agent codex`, `--agent claude`, `--agent gemini` veya `--agent all` kullanın.

3) Başlatmanın ne oluşturduğunu anlayın (belleğin nerede yaşadığı): Başlatma, `docs/memory/` altında varsayılan kalıcı bellek setini oluşturur: - `manifest.md` (ne yükleneceğini yönlendirir) - `brief.md` (mevcut proje şekli) - `decisions.md` (anahtar kararlar) - `constraints.md` (katı gereksinimler) - `do-not-use.md` (reddedilen yollar / mezar taşları) - `inbox.md` (hazırlık alanı) Platform önyükleme dosyaları (örn. `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`) ince kalır ve ajanları `docs/memory/`'ye yönlendirir.

4) Oluşturulan özeti güvenmeden önce düzenleyin: `init` sonrası, `brief.md` TODO'larla bir iskele olarak başlar. Belleği hazır olarak kabul etmeden önce yetkili proje kaynaklarından (README, kod, belgeler) doldurun. Özetin hala düzenlenmemiş olup olmadığını görmek için `memory-custodian status --project-root /path/to/project` (veya `scripts/memory-custodian status ...`) kullanın; `status` ve `check` düzenlenmemiş bir özeti rapor eder.

5) Bir görev için doğru belleği yükleyin (manifest-öncelikli okuma): Ajanlar için amaçlanan iş akışı şöyledir: 1) `docs/memory/manifest.md`'yi okuyun. 2) `docs/memory/brief.md`'yi okuyun. 3) Yalnızca manifest tarafından görevle ilgili olarak işaretlenen dosyaları yükleyin. Manuel inceleme için, bir bağlam paketi oluşturun: - `memory-custodian read --project-root /path/to/project --task planning` - `memory-custodian read --project-root /path/to/project --task implementation` - `memory-custodian read --project-root /path/to/project --task artifact`

6) Mevcut sohbetten sonra bir şeyin kalması gerektiğinde kalıcı bellek ekleyin: Kararları/kısıtlamaları/tercihleri/reddedilen yaklaşımları CLI kullanarak kaydedin: - `memory-custodian add "Manifest-öncelikli yüklemeyi seçtik." --type decision` - `memory-custodian add "Senkronizasyon yeniden deneme geri çekilmesini kalıcı hale getirin." --type decision --area sync --reason "Yeniden denemeleri başlatmalar arasında sınırlı tutun."` Karar girişlerini kısa tutun (araç bir belirteç kılavuzu uygular ve açıkça uzun girişlere izin vermediğiniz sürece çok uzun yazımları reddeder).

7) İsteğe bağlı bellek modüllerini yalnızca ilgili hale geldiklerinde etkinleştirin: İsteğe bağlı modüller (örn. kurallar, profiller, alanlar) isteğe bağlıdır ve manifest tarafından etkinleştirilmedikçe ve yönlendirilmedikçe yüklenmez. Gerektiğinde etkinleştirin: - `memory-custodian enable preferences` - `memory-custodian enable rules/output` - `memory-custodian enable profile/git` - `memory-custodian enable area/frontend` Etkinleştirme, mevcut bir modül dosyasının üzerine asla yazmaz.

8) Reddedilen yaklaşımları korumak ve regresyonları önlemek için 'do-not-use' kullanın: Bir yaklaşımı (örn. bir depolama arka ucu veya mimarisi) kasıtlı olarak reddettiğinizde, gelecekteki oturumların onu yeniden önermemesi için `docs/memory/do-not-use.md`'ye kaydedin (düzenlemeler veya uygun ekleme/unutma iş akışı aracılığıyla).

9) Sağlığı ve protokol uyumluluğunu düzenli olarak kontrol edin: Yapının, bütçelerin ve protokol meta verilerinin doğru olduğundan emin olmak için deterministik doğrulamayı çalıştırın: - `memory-custodian check --project-root /path/to/project` Hızlı bir genel bakış ve düzenlenmemiş bir özeti tespit etmek için `memory-custodian status` kullanın.

10) Belleği sıkıştırın ve koruyun (önizleme öncelikli, güvenli mutasyonlar): Belleği küçük ve güncel tutmak için bakım komutlarını kullanın: - `memory-custodian compact --project-root /path/to/project` Sıkıştırma korumalı ve önizleme önceliklidir; değişiklikleri yalnızca planı inceledikten sonra uygulayın. Gelen kutusu sıkıştırması muhafazakardır (örn. tam yinelenen üst düzey madde işareti birimi kaldırma ve mezar taşı filtreleme) ve bir ajanın/insanın kararlara/kısıtlamalara semantik yükseltme yapmasını bekler.

11) Eski bilgileri güvenli bir şekilde unutun (önizleme öncelikli): Eski konuları önizleme öncelikli unutma ile kaldırın veya redakte edin: - Önizleme: `memory-custodian forget "eski dağıtım notu" --mode soft --project-root /path/to/project` - İncelemeden sonra uygulayın: `memory-custodian forget "eski dağıtım notu" --mode soft --apply --project-root /path/to/project` Genel eşleşmeler açık onay gerektirir (örn. `--allow-broad-match`). Bazı durumlarda manuel yeniden yazma gerekir; araç güvenli olmayan toptan silmeleri reddedecektir.

12) Gerektiğinde mevcut bir kurulumu onarın veya değiştirin: Dosyalar eksikse veya meta verilerin düzenlenmiş içeriğin üzerine yazmadan güncellenmesi gerekiyorsa: - Onarım: `memory-custodian init --project-root /path/to/project --repair` Kasıtlı olarak tam bir değiştirme istiyorsanız, önizleme öncelikli değiştirmeyi kullanın ve yalnızca doğru olduğunda uygulayın: - `memory-custodian init --project-root /path/to/project --replace-existing` - ardından yalnızca listelenen dosyaların değiştirilmesi gerekiyorsa `--apply` ekleyin.

13) Araç güncellendiğinde protokol/proje bellek sürümlerini geçirin: `check` eski veya eksik protokol meta verilerini rapor ettiğinde, proje manifestini çevrimdışı geçirin: - Önizleme: `memory-custodian migrate --project-root /path/to/project` - İncelemeden sonra uygulayın: `memory-custodian migrate --apply --project-root /path/to/project`

14) Windows'ta veya kaynak ödeme noktasında doğru çağrıyı kullanın: Windows'ta konsol komutunu yükleyin ve `memory-custodian ...` kullanın. Herhangi bir platformda bir depo ödeme noktasından, sarmalayıcı olarak `scripts/memory-custodian ...` çalıştırabilirsiniz.