Astra Kullanıyorsanız AGENTS.md ve Skills DOsyalarını Optimize Edin

14-09-2026, 02:55:07

#1

metapak
Codex tarafında Astra’ya geçtiyseniz eski AGENTS.md, skills ve proje kurallarını
aynen bırakmak çok mantıklı olmayabilir.

Eski yapıda özellikle şunlar zamanla gereksiz yük oluşturabiliyor:
- Çok geniş tanımlanmış skill tetikleri
- Basit bir iş için alakasız dokümanların zorunlu okutulması
- Aynı kontrolün birden fazla yerde tekrar edilmesi
- Birbirine çakışan kurallar
- Düşük riskli işlemlerde bile sürekli kullanıcı onayı istenmesi
- Küçük görevlerde gereğinden fazla context/token kullanılması
Önce Astra’ya mevcut yapıyı değiştirmeden analiz ettir.

Codex’e şu promptu verebilirsiniz:

Review the current project's AGENTS.md files and Skills.

Identify:
- overly broad Skill triggers,
- mandatory reading of irrelevant documentation,
- duplicate checks,
- conflicting rules,
- instructions that request confirmation too frequently.

For each issue:
- point to the exact file/rule involved,
- explain why it may cause unnecessary work, context usage, or token consumption,
- suggest the smallest possible change.

Do not modify any files yet.

Çıkan rapor mantıklıysa ikinci aşamada sadeleştirme yaptırabilirsiniz:

Based on the audit you just completed, optimize the project's AGENTS.md files and Skills.

Goals:
- narrow overly broad Skill triggers,
- remove unnecessary documentation reads,
- merge duplicate checks,
- resolve conflicting rules,
- reduce unnecessary confirmations for low-risk tasks.

Preserve:
- safety boundaries,
- confirmation for sensitive or destructive actions,
- required tests and verification,
- project-specific constraints that still serve a clear purpose.

Prefer the smallest effective changes. Do not rewrite files unnecessarily.

After making the changes, list exactly what you changed and why.

Son olarak basit bir görevle kontrol edin:

Inspect the README for one obvious spelling or grammar mistake and fix it.

Read only the files genuinely necessary for this task.
Do not load unrelated documentation or Skills.

If there is no clear spelling or grammar mistake, report that and make no change.

Eğer basit bir README düzeltmesinde bile hâlâ onlarca dosya, skill ve doküman okuyorsa
eski kuralların bir kısmı sistemi gereksiz yere yönlendiriyor olabilir.
Kısacası:
Modeli yükseltmek tek başına yetmiyor. Orkestrasyon kuralları, AGENTS.md ve Skills
tarafını da yeni modele göre sadeleştirmek gerekiyor.

Ben özellikle büyük repo ve çok ajanlı Codex yapısı kullananların bunu kontrol etmesini öneririm.
14-09-2026, 06:35:06

#2

oozanakbulut

teşekkürler paylaşım için, en büyük tokeni test aşamasında yiyor galiba. baştan aşağı test ediyor, o yüzden promptlarımın sonuna testini yapma ben yaparım diyorum . bu verdiklerini deneyeceğim
14-09-2026, 11:09:31

#3

LyriC

Hocam ben ChatGPT masaüstü uygulamasından GPT-6 ASTRA kullanıyorum "Computer Use" özelliği ile beraber ama günlük kotayı 2-3 dakikada komple götürüyor.
Sizin bu verdiğiniz promtları tam olarak nereye gireceğim
14-09-2026, 14:41:58

#4

metapak

oozanakbulut adlı üyeden alıntı: mesajı görüntüle

teşekkürler paylaşım için, en büyük tokeni test aşamasında yiyor galiba. baştan aşağı test ediyor, o yüzden promptlarımın sonuna testini yapma ben yaparım diyorum . bu verdiklerini deneyeceğim

test için ben daha çok alt modelleri kullanıyorum hocam. luna yüksek veya sol orta gibi

LyriC adlı üyeden alıntı: mesajı görüntüle

Hocam ben ChatGPT masaüstü uygulamasından GPT-6 ASTRA kullanıyorum "Computer Use" özelliği ile beraber ama günlük kotayı 2-3 dakikada komple götürüyor.
Sizin bu verdiğiniz promtları tam olarak nereye gireceğim

ilgili proje dosyasındaki codex sohbetine yazabilirsiniz hocam.
imzamdaki repoyu inceleyin isterseniz bahsettiğiniz oran çok fazla belki bi yararı olur
14-09-2026, 16:07:17

#5

tosunpasa

@metapak;
bu tür işlemlerin en kolay yanı şu şekilde.
Ben proje mimarisini ve agent a yüklediğim plugin ve skillerin isimlerini claude web (free) ye veriyorum. daha sonra kullanacağım agent için bir agents.md - .opencode - .claude gibi yapıları oluşturmasını istiyorum.
konumuz agents.md olduğu için , bu dosyayı olabildiğince ufak oluşturmasını ve mimari proje dosyalarına referans vermesini, "devam et - analiz et " gibi promptlar için ise hedef bir md dosyasını göstermesini istiyorum. bir benzer komut da "faza devam et".
bu şekilde tüm dosyaları ve context e çok fazla bilgi yüklenmesini engelliyorum.

Zaman zaman bir analiz sonucunda revizyon planı oluşturursanız, llm modelleri bu revizyon.md dosyasını genelde agents.md veya durum.md gibi dosyaya referans dosya olarak ekler. işlem bitiminden sonra işi biten dosya isimleri ve ona ait referansları silmesini belirtirim.
yani işi biten dosyalarında da işlem yapmasa bile referans - not olarak kalmasını engellerim.
arşivlenecek ise, arşiv dizine taşınır ama referans bilgisi aktif mimari plan içinde açıklama/referans olarak da kalmamalı.

başarılar
14-09-2026, 22:23:23

#6

metapak

tosunpasa adlı üyeden alıntı: mesajı görüntüle

@metapak;
bu tür işlemlerin en kolay yanı şu şekilde.
Ben proje mimarisini ve agent a yüklediğim plugin ve skillerin isimlerini claude web (free) ye veriyorum. daha sonra kullanacağım agent için bir agents.md - .opencode - .claude gibi yapıları oluşturmasını istiyorum.
konumuz agents.md olduğu için , bu dosyayı olabildiğince ufak oluşturmasını ve mimari proje dosyalarına referans vermesini, "devam et - analiz et " gibi promptlar için ise hedef bir md dosyasını göstermesini istiyorum. bir benzer komut da "faza devam et".
bu şekilde tüm dosyaları ve context e çok fazla bilgi yüklenmesini engelliyorum.

Zaman zaman bir analiz sonucunda revizyon planı oluşturursanız, llm modelleri bu revizyon.md dosyasını genelde agents.md veya durum.md gibi dosyaya referans dosya olarak ekler. işlem bitiminden sonra işi biten dosya isimleri ve ona ait referansları silmesini belirtirim.
yani işi biten dosyalarında da işlem yapmasa bile referans - not olarak kalmasını engellerim.
arşivlenecek ise, arşiv dizine taşınır ama referans bilgisi aktif mimari plan içinde açıklama/referans olarak da kalmamalı.

başarılar

mantıklı hocam. özellikle agents.md’yi ana bilgi deposu değil de yönlendirme dosyası gibi kullanmak daha temiz duruyor.
detaylı mimari/iş akışını ayrı md’lerde tutup ihtiyaç oldukça referans vermek hem context’i hem token kullanımını azaltır.
iş bitince eski revision/durum referanslarını temizlemek de önemli, yoksa model geçmiş işi aktif kural sanabiliyor.