.ai klasörü · Yuli Code

Yuli'nin projenizin içinde neyi sakladığı, neyin ekiple birlikte sürümlendiği ve neyin yalnızca bilgisayarınızda kaldığı.

Yuli, her projenin .ai/ klasöründe kalite sözleşmesini, görevleri, belleği, kuralları ve çalışma verilerini saklar. Bir kısmı Git üzerinden ekiple paylaşılır; bir kısmı yereldir ve asla gönderilmez.

Yuli .gitignore dosyanızı asla düzenlemez. Git dışında kalması gerekenler, deponun sizin kopyanıza özgü olan .git/info/exclude dosyasına eklenir.

Git dışında kalanlar

Yuli şu satırları .git/info/exclude dosyasına ekler:

.yuli/
**/.ai/codebase/
**/.ai/state/

Yapı

.ai/
├── contract.json          kalite sözleşmesi
├── quality.json           ölçüm ayarları ve varsayımlar
├── memory/                proje belleği
├── rules/                 ekip kuralları ve öğrenilen kurallar
├── missions/              ajanın görevleri
├── state/                 çalışma verileri (yerel)
├── codebase/              kod dizini (yerel)
├── requirements/          gereksinim izlenebilirliği
├── design/                Web Studio design system'i
├── web/                   önizleme mock'ları ve sözleşmeleri
├── glossary.json          alan sözlüğü
├── team.json              ekip yapılandırması
├── devops.json            CI/CD bağlantıları
└── compound.yaml          Compound tanımı

Sürümlenen dosyalar

Yol	İçerik
`contract.json`	Kalite sözleşmesi. Korunan bir yoldur: bir ajan onu düzenleyemez.
`quality.json`	Ölçüm aşamasının ayarları ve tahminlerin varsayımları. İsteğe bağlı.
`memory/`	`memory.json` ve `MEMORY.md`: ajanın proje hakkında hatırlaması gerekenler.
`rules/`	`*.md` dosyalarında ekip kuralları ve öğrenilen kuralları içeren `learned.md`.
`glossary.json`	Yönetişim Merkezi'nden düzenlenebilen alan sözlüğü.
`team.json`	Ekibin paylaşılan ayarları.
`devops.json`	Projenin CI/CD bağlantıları.
`compound.yaml`	Web Studio'da Compound'un ayağa kaldırdığı servisler.
`requirements/traceability.json`	Kural ↔ test izlenebilirliği.
`design/system.json`	Web Studio'nun design system'i (token'lar).
`web/mocks.json` ve `web/contracts/`	API simülatörünün kuralları ve sözleşmeler.

Yerel klasörler

`state/`

Yalnızca sizin bilgisayarınızda anlamlı olan çalışma verileri. Asla gönderilmez.

Yol	İçerik
`state/quality/versions.json`	Geçerli sürümün ve N−1'in rakamları.
`state/quality/history.jsonl`	Kısa bir sayı serisi (en fazla 30 sürüm).
`state/quality/agent.jsonl`	Ajanın kendi istatistikleri.
`state/contract-audit.jsonl`	Sözleşmedeki her değişikliğin denetim kaydı.
`state/deployments.jsonl`	DORA için kaydedilen dağıtımlar.
`state/reviews.jsonl`	Bağımsız incelemeler.
`state/agent-cost.jsonl`	Ajanların maliyeti.

`codebase/`

Kod zekâsı dizini: sembol grafiğini içeren bir SQLite veritabanı olan code_intelligence.db. Kendiliğinden yeniden üretilir; hiçbir şey kaybetmeden silebilirsiniz.

Görevler

Ajanın her görevi iki dosyayla missions/<conversación>/ içinde durur:

mission.json: özgün istek, gereksinimler, kabul kriterleri, kararlar, varsayımlar, plan, dokunulan dosyalar ve devir noktası.
PLAN.md: okunabilir plan.

Bkz. Görevler ve aşamalar.

Projenin dışında

Kişisel olanlar .ai/ içinde durmaz. Ayarlarınız, kendi prompt'larınız, skill'leriniz ve hook'larınız ile sohbet geçmişi, kullanıcınıza ait Yuli yapılandırma klasöründedir. Windows'ta:

Klasör	Ne saklar
`%APPDATA%\.yulicode`	Ayarlar, prompt'lar, kendi skill'leriniz, hook'lar ve sohbet geçmişi.
`%LOCALAPPDATA%\.yulicode`	Çalışma zamanları, dizinler, önbellekler ve günlükler. Silinebilir.

Ajanın yazdığı belgeler

.ai/ dışında ajan yalnızca gerektiğinde belge yazar:

Yol	Ne zaman
`docs/quality/reporte-calidad.md`	Bir kalite sürümü kaydedildiğinde.
`docs/sistema/`	Yalnızca sistemi belgelemesini isterseniz.
`docs/architecture/`	Yönetişim Merkezi'nden ADR, tehdit modeli ve C4.