halilneed
TREN

gardener

CLAUDE.md, AGENTS.md, GEMINI.md ve bunların içe aktardığı her şey her istekte yüklenir. gardener bu içe aktarma zincirini tek bir envantere çözer, maliyetini satır ve tahmini token olarak hesaplar; kırık içe aktarımları, eskimiş yolları ve tekrarlı kuralları işaretler. Betik hiçbir dosyayı düzenlemez.

Kontroller
10
Okunan ajanlar
Claude Code, Codex CLI, Gemini CLI
Ağ çağrısı
yok
Düzenlenen dosya
betik tarafından yok
Lisans
MIT

Örnek çıktı

Aşağıdaki alıntı, bu sitenin hazırlandığı makinede her zaman yüklenen talimat dosyaları üzerinde --audit --md --lang en ile yapılan gerçek bir çalıştırmadan kısaltıldı. Klasör adları genellendi ve bir bulgu etiketi çevrildi. Her sayı betiğin yazdığı gibi. Tarama hiçbir ağ çağrısı yapmadı.

# gardener — hot context audit

Source note: 6 files · 182 lines · ~2638 estimated tokens, per request · 76 directives · score: 12 (good)

Budgets: 300/600 lines per file, 4000/8000 estimated tokens in total.
Token counts are a bytes/4 estimate, not a real tokenizer.

## What loads

| File                          | scope   | depth | lines | ~tokens |
|-------------------------------|---------|-------|-------|---------|
| `~/.claude/CLAUDE.md`         | global  | 0     |     7 |      60 |
| `~/agent-defs/instructions.md`| global  | 1     |    53 |     749 |
| `~/agent-defs/identity.md`    | global  | 2     |    46 |     553 |
| `~/agent-defs/memory/MEMORY.md`| global | 2     |    30 |     676 |
| `~/.gemini/GEMINI.md`         | global  | 0     |     1 |       0 |
| `<repo>/.claude/CLAUDE.md`   | project | 0     |    45 |     600 |
| **total**                     |         |       | **182** | **2638** |

## Findings

| Sev  | Check               | where              | what        |
|------|---------------------|--------------------|-------------|
| warn | duplicate-directive | instructions.md:52 | 86% overlap |
| warn | duplicate-directive | instructions.md:32 | 69% overlap |
| warn | duplicate-directive | instructions.md:28 | 67% overlap |

Her bulgu, tetiklenen kontrolü, dosyayı ve satırı gösterir. Tekrarlarda örtüşen iki metni de gösterir. Böylece tek bir bulguya itiraz edebilirsiniz. Kontroller açıp okuyabileceğiniz tek bir dosyada belgelenmiş. Katılmadığınız bir kontrolü --ignore ile kapatabilirsiniz.

Kurulum

# bir kez
> /plugin marketplace add halilneed/plugins

# eklenti
> /plugin install gardener@hailneed

# ve deneyin
> /gardener:audit

Market kimliği hailneed, kurulum satırının @hailneed ile bitmesinin nedeni bu.

  • Claude Code ve Node.js 18 ya da daha yenisi.
  • Bağımlılık, derleme adımı, API anahtarı ya da hesap gerekmez.
  • Eklenti olmadan da çalışır: node scripts/gardener.mjs --audit --repo . --md
  • CI için --audit --out audit.json sabit bir çıktı biçimi verir. totals.tokens ya da score.raw belirlediğiniz eşiği aştığında derlemeyi başarısız sayabilirsiniz. --selftest ağ gerektirmez.

Komutlar

/gardener:audit

Her istekte neyin yüklendiğini raporlar. İçe aktarma zinciri, dolaylı içe aktarımlar dahil tek bir envantere çözülür ve satır ile tahmini token olarak fiyatlanır. Kırık içe aktarımlar, eskimiş yollar ve tekrarlı talimatlar listelenir. Çözülemeyen bir içe aktarım her zaman listede yer alır. Böylece yüklenmeyen kuralları yükleniyor sanmazsınız.

/gardener:compliance

Yasaklara uyulup uyulmadığını kontrol eder. Yasaklı komutlar, yerel oturumlarda çalıştırılan komutlarla karşılaştırılır. İhlal adayları çıkarır ve bunlar raporlanmadan önce satır satır doğrulanır. Konusu hiç geçmemiş kuralları da listeler. Konusu hiç geçmemiş kurallar, uyulan kurallardan ayrı listelenir.

/gardener:prune

İşaretlenen her talimatı gerekçesiyle birlikte sil, taşı, düzelt, yeniden yaz ya da zorunlu kıl olarak işaretleyen satır satır bir plan yazar. Her zaman yüklenen dosyaya ait olanı, gerektiğinde yüklenmesi gerekenden ayırır. Satırları gösterir, onay ister ve sonra her seferinde tek bir dosyayı düzenler.

Ne yapar, ne yapmaz

  • Betik ağ çağrısı yapmaz ve hiçbir dosyayı düzenlemez. gardener.mjs diskinizde zaten bulunan talimat dosyalarını ve oturum kayıtlarını okur ve bir plan çıkarır. prune skill’i CLAUDE.md dosyasını ancak satırları size gösterip onayınızı aldıktan sonra değiştirir.
  • Token sayıları bir tokenizer’dan değil, bytes/4 tahmininden gelir. Dosyaları karşılaştırmak ve değişimi zaman içinde izlemek için bu yeterli. Her rapor bunu belirtir.
  • Uyum eşleşmesi yalnızca bir adaydır. Kuralın önemsediği bağlamı kaçırmış olabilir. Bu yüzden skill her adayı açar, dökümle karşılaştırarak doğrular ve kaçını elediğini raporlar.
  • Hiç rastlanmayan bir yasak olası bir başarı olarak raporlanır. Skill, sıfır sayıma bakarak bir güvenlik kuralının silinmesini önermez.
  • 10 kontrol var, model yargısı yok. checks.md her birini önem düzeyi ve değerlendirme notuyla belgeler. --selftest bunları verilerinize dokunmadan 19 test örneği üzerinde çalıştırır.
  • Okunamayan oturumlar kaynak notunda sayılır.
  • MIT lisanslı (LICENSE). Hesap, kayıt ya da telemetri yok.

Planlanan

Barındırılan bir sürüm, gardener Cloud, planlanıyor. Eklenti ücretsiz ve yerel kalacak.

  • Sürekli bütçe takibi: ekibinizin talimat dosyalarının sıcak bağlam maliyeti, bir kez denetlenmek yerine zaman içinde izlenir.
  • Kural değişiklikleri için önce ve sonra: değişen bir kuralın ajan davranışına etkisi, değişikliğin iki yanı karşılaştırılarak.
  • Oryantasyon özeti: yeni ekip üyeleri için bu repoda geçerli kurallar.

Hazır olduğunda haber almak için yazılar sayfasından abone olun.