Ben revizyon esnasında hatalı tanımlar ile uğraşırken birleştirilmiş dosyaları çok önemsemedim.
Sonuç ise felaket oldu. 1 aylık kotam toplamda 12 saate varan sürede bitti. sonuçları gpt ile paylaştığımda giriş değerlerinin +100k -200k da sabitleniyor olması bir mimari sorunun varlığını gösterdi. agent sürekli büyük dosyalara referansı olduğu için aynı dosyayı tekrarlı okuyordu.
Yeni bir parçalama politikası için prompt istedim.
Örnek prompt'un bir kısmını sizler ile paylaşıyorum.

Mevcut XXXX dokümantasyon mimarisini tamamen yeniden tasarla.
Amaç yeni özellik eklemek değildir.
Amaç, AI Agent (OpenCode, Claude Code, Cursor, Cline vb.) için maksimum verimli, minimum token tüketen, modüler bir bilgi mimarisi oluşturmaktır.
---
# HEDEFLER
- Büyük markdown dosyalarını kaldır.
- Her dosya mümkün olduğunca tek bir konuyu anlatsın.
- Her dosya yalnızca gerektiğinde okunacak şekilde tasarlansın.
- Agent hiçbir görevde gereksiz doküman okumak zorunda kalmasın.
- Fazlar yalnızca ihtiyaç duyduğu dosyaları referans etsin.
- Arşiv dosyaları hiçbir aktif dosya tarafından referans alınmasın.
- Tüm referanslar doğrulansın.
- Kırık referans kalmasın.
- Yinelenen bilgi tamamen kaldırılsın.
- Aynı bilgi yalnızca tek yerde bulunsun.
---

# TASARIM KURALLARI
## 1)
Hiçbir markdown dosyası mümkün olduğunca büyük olmamalıdır.
Uzun dokümanlar mantıksal olarak bölünmelidir.
---

## 2)
Her dosya yalnızca tek amacı taşımalıdır.
Örneğin

stok/
ekran.md
db.md
fonksiyonlar.md
workflow.md
mockup.md
test.md
---

## 3)
Mockuplar tek dosyada bulunmayacaktır.
Her ekranın kendi mockup dosyası olacaktır.
---
## 4)
DB kuralları tek dosyada olmayacaktır.
Her modül kendi DB açıklamasına sahip olacaktır.
---

## 5)
Fonksiyon açıklamaları modül bazında ayrılacaktır.
---

## 6)
UI kuralları;
ortak
ve
modül bazında
ayrılacaktır.
---

diye uzuyor.

umarım faydalı olur.