Bir Yapay Zeka Ajanını AsciiDoc ile Yönetmek: Bağlam Sızıntısı Olmayan Opencode Oturumları için Eager/Lazy Stratejim

@startuml
skinparam backgroundColor #FEFEFE
skinparam handwritten false

title Oturumların Evrimi — Oturum 1'den 150+'a
legend top
    |= Couleur |= Projet |
    | <#4CAF50> | cheroliv.com |
    | <#2196F3> | plantuml-plugin |
    | <#FF9800> | bakery-plugin |
    | <#9C27B0> | magic-stick |
endlegend

concise "Aktif Oturumlar" as S

@S
0 is "ham .md"
1 is "Migrasyon\nAsciiDoc"
10 is "Eager/Lazy\nbiçimselleştirilmiş"
62 is "Güvenlik kuralı\n(site.yml)"
87 is "Bağlam\nkırma"
109 is "Optimizasyon\n-%60 token"
133 is "133 oturum\n240 test PASS"

S@0 -> S@1 : Oturum 1\n(cheroliv.com)
S@1 -> S@10
S@10 -> S@62 : Oturum 62\n(plantuml-plugin)
S@62 -> S@87 : Oturum 87\n(Cry 4 help)
S@87 -> S@109 : Oturum 109\n(API Key Pool)
S@109 -> S@133 : Oturum 133\n(Aujourd'hui)

@enduml

@startuml
skinparam defaultTextAlignment center
skinparam wrapWidth 200

package "Proje Kökü (Eager - Otomatik Yüklenen)" {
    component "<b>AGENT.adoc</b>\nRmutlak kurallar\nStructure & Konvansiyonlar" as AGENT
    component "<b>PROMPT_REPRISE.adoc</b>\nMission N oturumu\nRözet N-1" as PROMPT
    component "<b>INDEX.adoc</b>\nPoint giriş\nRkurallar + Oturumlar" as INDEX
    component "<b>*_ESSENTIALS.adoc</b>\nContexte iş\nkritik" as ESS
}

package ".agents/ (Lazy - İstek üzerine yüklenir)" {
    component "<b>sessions/N-*.adoc</b>\nArchives ayrıntılı\nDkararlar & Çıktı" as SESS
    component "<b>SESSIONS_HISTORY.adoc</b>\nTableau özet\nDate/Type/Score" as HIST
    component "<b>PROCEDURES.adoc</b>\nTemplates oturum sonu\n6 adım\n" as PROC
    component "<b>*_REFERENCE.adoc</b>\nArchitecture tam\nRteknik referanslar" as REF
    component "<b>COMPLETED_TASKS_ARCHIVE</b>\nTtamamlanan görevler\nPar ay" as ARCH
    component "<b>AGENT_MODUS_OPERANDI.adoc</b>\nDocumentation strateji\nMmetodoloji" as MOD
    component "<b>*_REFERENCE.adoc</b>\nBoot testler, A/B bölümleme\nContextes özel" as SPEC
}

AGENT --> PROMPT : "Referanslar"
AGENT --> INDEX : "Referanslar"
INDEX --> SESS : "Dizin"
INDEX --> HIST : "Dizin"
INDEX --> PROC : "Referans"
INDEX --> ARCH : "Referans"
INDEX --> REF : "Referans"
PROMPT --> SESS : "Arşiv N-1"
PROMPT --> ESS : "İş bağlamı N"

@enduml

----
| magic-stick    | Session 23 | SCRIPT_VERIFICATION.adoc | 2026-04-27 |
| bakery-gradle  | Session 11 | TEST_COVERAGE_ANALYSIS   | 2026-04-27 |
| cheroliv.com   | Session 9  | TEST_COVERAGE_ANALYSIS   | 2026-04-27 |
| plantuml-gradle| Session 133| TEST_COVERAGE_ANALYSIS   | 2026-04-23 |
| jhipster-gradle-plugins | Session 1 | TEST_COVERAGE_ANALYSIS | 2026-04-28 |
----

**`*_ESSENTIALS.adoc`** -- Eager bağlamını daha da optimize etmek için yakın zamanda yapılan bir ekleme (Oturum 109, plantuml-plugin). API anahtarı havuzuna 200 satır iş bağlamı yüklemek yerine, temel kısımdan 50 satır yüklüyorum ve diğer 150 satır LAZY olarak içinde kalıyor`*_REFERENCE.adoc`.

Ölçülen sonuç: geçiş**~25k token EAGER'dan ~10k token'a**(%60 kazanç). Ajan artık enerji tüketen hatırlatıcılara ihtiyaç duymuyor.

==== Kayıp Halka: `opencode.json

Size, belgelemeyi neredeyse unuttuğum bir şeyi itiraf etmeliyim. Tüm bu .adoc dosyalarının üstünde, onsuz hiçbir şeyin çalışmadığı minik bir JSON dosyası var. Adı`opencode.json`ve altı satır ediyor. Kelimenin tam anlamıyla altı satır.

[source,json]
----
{
  "$schema": "https://opencode.ai/config.json",
  "instructions": [
    "AGENT.adoc"
  ]
}
----

Opencode'a şunu söyleyen dosya bu: « Başlangıçta, yükle`AGENT.adoc`otomatik olarak. » Onsuz, ajan tam olarak makalenin başında anlattığım gibi boş bir sayfadır. Onunla birlikte, ajan ben daha merhaba demeden mutlak kuralları, projenin mimarisini ve temel komutları elinde bulundurur.

Bu dosyanın önemini tesadüfen keşfettim. Üzerinde`bakery-plugin`, yoktu. Ajanın bu projede neden diğerlerine göre sistematik olarak daha « kayıp » olduğunu merak ediyordum. Mutlak kurallar gerçekten de içindeydi`AGENT.adoc`— ama`AGENT.adoc`hiç yüklenmezdi. Ajan her oturumda yalnızca ona manuel olarak okumasını söylediğim şeyleri okurdu. Bu, 11. oturumuydu`bakery-plugin`… yokluğunu fark ettiğimde`opencode.json`. Onu ben oluşturdum — ve 12. oturum diğerleri gibi başladı.

Bu dosya artık benim için o kadar apaçık ki onu artık düşünmüyordum bile. Aracını fazla iyi bilen bir geliştiricinin klasik hatası. Bugün ise onu sistematik olarak *önce* oluşturuyorum`AGENT.adoc`. Bu ilk taştır.

==== INDEX.adoc`'un İkiliği

Açıklığa kavuşturulmayı hak eden bir başka incelik:`INDEX.adoc`içinde yaşar`.agents/`— LAZY olarak sunduğum bir dosya. Ancak onu tüm tablolarımda EAGER olarak listeliyorum. Burada görünür bir gerilim var.

Saha gerçeği: dosyalar`.agents/INDEX.adoc`oturum başında otomatik olarak yüklenir, tıpkı`AGENT.adoc` et `PROMPT_REPRISE.adoc`. Onlar içinde`.agents/`düzenleme nedenleriyle — kök dizini işgal etmemek için — ancak davranışları EAGER.

Üzerinde`plantuml-plugin`, `INDEX.adoc`200 satır tutar ve mutlak kuralların *tamamını* tarihçeleriyle (geçmiş oturumların dersleri), skorlarıyla EPIC'leri ve proje portföyünü içerir. Ajanın «nerede olduğumuzu» bilmek için başvurduğu belge budur. Üzerinde`bakery-plugin`, yol haritası ve son oturumlarla birlikte 150 satır ediyor.

arasındaki kasıtlı yedeklilik`AGENT.adoc` et `INDEX.adoc`şaşırtabilir. Mutlak kurallar her ikisinde de mevcuttur. Neden? Çünkü iki farklı rolü yerine getirirler: içinde`AGENT.adoc`, bunlar *açıklayıcıdır* (kuralın hikâyesi, öğrenilen ders); içinde`INDEX.adoc`, bunlar *yürütücüdür* (çıplak kural, gerekçesiz, hızlı bir danışma için). Ajan okur`AGENT.adoc`bir kez *anlamak* için; yeniden okuyor`INDEX.adoc`her oturumda *uygulamak* için. İki kullanım, iki format.

[plantuml, format=svg, id=diag-dualite-agent-index, alt="Comparaison entre AGENT.adoc (narratif) et INDEX.adoc (exécutif)"]
----
@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center

title İkilik AGENT.adoc ←→ INDEX.adoc
left to right direction

rectangle "AGENT.adoc\n(Racine — EAGER)" as AGENT #E3F2FD {
  rectangle "📖 **Anlatı Formatı**\nLe kuralın hikâyeleştirilmesi\nöğrenilen ders, bağlam" as NARR
  rectangle "🏗️ **Tam Mimari**\nStructure proje, bileşenler\nBacklog ayrıntılı US" as ARCHI
  rectangle "📋 **Açıklayıcı Kurallar**\nPourquoi kural mevcut\nHistorique olayın" as EXPL
}

rectangle "INDEX.adoc\n(.agents/ — EAGER)" as INDEX #E8F5E9 {
  rectangle "⚡ **Yürütme Formatı**\nLa çıplak kural, gerekçesiz\nConsultation hızlı" as EXEC
  rectangle "📊 **Yol Haritası & EPICs**\nTableau özet\nProgression, Skor, Öncelik" as ROAD
  rectangle "🌐 **Proje Portföyü**\nVue yatay\n5 senkronize proje" as PORT
}

AGENT --> INDEX : "Ajan AGENT.adoc okur\n**anlamak** için 1 kez"
INDEX --> AGENT : "Ajan INDEX.adoc yeniden okur\nher oturumda **uygulamak** için"

note bottom of AGENT
Maksimum boyut: 200 satır
end note

note bottom of INDEX
Maksimum boyut: 200 satır
  Source de vérité en cas de divergence
end note

@enduml
----

Bu bilinçli yedeklilik bir tasarım tercihidir. Yaklaşık 50 satır ek EAGER token'ı tüketir — ancak ajanın kuralları her zaman gözünün önünde tutmasını sağlar; buna anında itaati kolaylaştıran kısa biçim de dahildir.

=== LAZY Dosyaları: Sahibinin El Kitabı

Bu dosyalar şurada bulunur:`.agents/`ve yalnızca ajanın ihtiyaç duyduğunda okunurlar. Yöntemin gerçek zenginliğini oluştururlar, çünkü proje bilgisini mevcut bağlamı kirletmeden biriktirirler.

[plantuml, format=svg, id=diag-agents-tree, alt="Arborescence complète du dossier .agents/"]
----
@startuml
skinparam folderBackgroundColor #E3F2FD
skinparam folderBorderColor #1565C0
skinparam fileBackgroundColor #FFF3E0
skinparam fileBorderColor #EF6C00

folder ".agents/" as ROOT {
  file "INDEX.adoc\n(EAGER -- 200 lignes)" as IDX #E8F5E9
  file "AGENT_SESSION_MANAGER.adoc\n(Template session)" as ASM
  file "SESSION_CHECKLIST.adoc\n(Quand changer)" as CHK
  file "PROCEDURES.adoc\n(6 étapes + LAZY/EAGER)" as PRO
  file "SESSIONS_HISTORY.adoc\n(Toutes sessions)" as HIS

  folder "sessions/" as SESS {
    file "1-chore-migration.adoc" as S1
    file "109-formalisation-lazy.adoc" as S109 #FFECB3
    file "133-epic11-article.adoc" as S133
    file "... +130 diğer" as SMORE
  }

  folder "archives/" as ARCH {
    file "COMPLETED_TASKS_2026-04.adoc" as CTA
    file "SESSIONS_HISTORY_83-95.adoc" as SHIST
    folder "sessions_summaries/" as SUM {
      file "SESSION_64_SUMMARY.adoc" as SU64
      file "SESSION_73_SUMMARY.adoc" as SU73
      file "..." as SUMORE
    }
    folder "prompts_archive/" as PARCH {
      file "PROMPT_REPRISE_S65.adoc" as PR65
      file "PROMPT_REPRISE_S75.adoc" as PR75
      file "..." as PMORE
    }
  }
}

IDX --> SESS : "Dizinle"
IDX --> HIS : "Dizinle"
IDX --> ARCH : "Referans"

note right of S109
Oturum 109 =
Strateji resmileştirme
LAZY/EAGER
Token : ~25k → ~10k
end note

@enduml
----

Yukarıdaki dizin ağacı, klasörün gerçek yapısını gösterir`.agents/`üzerinde`plantuml-plugin`, en olgun proje. Üç katmanlı derinliğe dikkat edin: kök dosyalar (meta veriler), klasör`sessions/`(kronolojik arşivler), ve dosya`archives/`(toplulaştırmalar ve özetler). Basit bir TODO dosyasının yönetişimini bir ... dönüştüren bu derinliktir**tam örgütsel hafıza**.

**.agents/sessions/{N}-{titre}.adoc**-- Her oturumun ayrıntılı arşivleri. Şu anda:

* `plantuml-plugin`:**133 arşivlenmiş oturum**(1. oturumdan 133. oturuma kadar)
* `bakery-plugin` : **11 seans**
* `magic-stick` : **23 oturum**
* `cheroliv.com`Çevrilecek metin sağlanmadı.**9 resmi oturum**+ 7 sistem öncesi oturum geriye dönük olarak yeniden oluşturuldu

Her arşiv, oturumun tam bağlamını, alınan kararları, karşılaşılan sorunları ve bunların çözümünü, yürütülen komutları ve bunların çıktısını içerir.

**.agents/SESSIONS_HISTORY.adoc**-- Tüm oturumların bir puanla birlikte özetlendiği bir tablo. Örnek:`cheroliv.com`:

| -6 | 2025-05 | chore | Initialisation projet Gradle/JBake | 7/10
|  1 | 2026-04-25 | chore | Migration gouvernance agent | 8/10
|  7 | 2026-04-27 | debug/fix | Correction publishSite | 9/10
|  8 | 2026-04-27 | analyse | Analyse article 0108 | 7/10

----
{N}-{type}-{sujet-kebab-case}.adoc
----

Somut örnekler:

* `1-chore-migration-gouvernance-agent.adoc`— oturum 1, koreografi türü
* `10-solidification-tests.adoc`— 10. oturum, açık tür belirtilmeden (konu yeterli)
* `036-debug-graphify-symlink-epic9.adoc`— sıralama için 3 haneli numaralı 36. oturum

Oturum numarası birincil sıralama ölçütüdür. 3 basamaklı numaralar (001, 036, 133) kullanan projeler, 99'un üzerine çıkıldığında sözlük sıralaması sorunlarını önler. Artık üzerinde kullandığım şey bu.`magic-stick` : `001-init-projet.adoc`, `036-debug-graphify-symlink-epic9.adoc`.

Tür isteğe bağlıdır ve oturumun anahtar sözcüklerinden (debug, feature, refactor, docs, chore, test) türetilir. Kebab-case biçimindeki konu en önemli kısımdır: dosyayı açmadan bir oturumu bulmayı sağlamalıdır. «Entegrasyon testlerinin zaman aşımını düzelttiğimiz oturum hangisiydi?» diye merak ediyorsanız, cevap`124-fix-timeout-integration-test.adoc`.

Yeniden oluşturulmuş tarihsel oturumlar için (yönetişimden önce doğan projeler), negatif numaralar kullanıyorum. Üzerinde`cheroliv.com`, -6'dan 0'a kadar olan oturumlar projenin yönetim öncesi tüm geçmişini kapsıyor. Ve « belgelenmemiş » veya kayıp oturumlar için, içine bir giriş oluşturuyorum`SESSIONS_HISTORY.adoc`ilgili arşiv olmadan, bir puanla`?`. Rol yapmaktan daha dürüst.

[plantuml, format=svg, id=diag-naming-convention, alt="Arbre de décision pour le nommage des fichiers de session"]
----
@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center
skinparam wrapWidth 200

title Oturum Adlandırma Sözleşmesi
start

:Bir oturum sona eriyor;
note right: Trigger "oturum sonu"

if (Session antérieure\nà la gouvernance ?) then (oui)
  :Numara **NÉGATIF**\n-6, -5 ... 0;
  note right: Geçmiş\nyeniden oluşturuldu
  :Sonek: yeniden oluşturma;
else (non)
  :Numara **POSITIF**\n99'dan büyükse 3 haneli;
  note right: 001, 036, 133\nleksikografik sıralama için

  :**TYPE**'ı algıla;
  if (Mots-clés trouvés ?) then (oui)
    :hata ayıklama / özellik / yeniden düzenleme\ndokümantasyon / rutin iş / test;
  else (non)
    :Omit the type\n(le sujet suffit);
  endif

  :**SUJET**'ı kebab-case olarak formüle edin;
  note right
Örn: fix-timeout-integration-test
Dosyayı açmadan bulmayı sağlamalı
  end note
endif

:Nihai ad: {N}-{type}-{sujet}.adoc;
note right
  • 1-chore-migration-gouvernance.adoc
  • 036-debug-graphify-symlink.adoc
  • 124-fix-timeout-integration-test.adoc
  • 133-epic11-article-blog-kg.adoc
end note

if (Session documentée ?) then (oui)
  :sessions/ içinde arşiv oluştur;
  :SESSIONS_HISTORY satırını ekle\nX/10 skoru ile;
else (non)
  :Satır ekle SESSIONS_HISTORY\n**?** puanı ile\n**arşivsiz**;
  note right: Dürüstlük\nboşluk yerine
endif

stop
@enduml
----

==== TEST_COVERAGE_ANALYSIS.adoc` — 5. Adımın Ayrıntılı İncelemesi

Oturum sonu prosedürünün 5. adımı en gizemli olanıdır. Şöyle der: « Güncelle`TEST_COVERAGE_ANALYSIS.adoc`testlerin eklenip eklenmediği veya değiştirilip değiştirilmediği. » Ama bu dosya neye benziyor?

Üzerinde`plantuml-plugin`, birkaç satırdan tam bir yapıya evrildi. İşte sabitlenmiş hali:

[source]
----
= Analyse de Couverture de Tests

== Suivi des Tests
|===
| Classe de test | Type | Tests | Statut | Dernière MAJ
| PlantumlServiceTest | unit | 45/45 | ✅ PASS | 2026-04-23
| ApiKeyPoolTest | integration | 15/15 | ✅ PASS | 2026-04-20
|===

== Historique par Session
| Session | Tests ajoutés | Tests modifiés | Couverture
| 133     | 0             | 2              | 100%
| 132     | 5             | 0              | 100%
|===
----

Önemli olan dosyanın kendisi değil — neyin değiştiğini *not etme* zorunluluğudur. Bu adım olmadan, 50 oturumdan sonra hangi testlerin neyi kapsadığını artık bilmezsiniz. Ajan da bilmez. Dosya, projenin test kapsamına ilişkin tek doğruluk kaynağı hâline gelir.

Geleneksel testleri olmayan projeler için (örneğin`magic-stick`bash betiklerini test eden), 5. adım ... ile değiştirilir`SCRIPT_VERIFICATION.adoc`. Mekanizma aynı: betiklerin doğrulama durumunu izleyen bir dosya. 5. adımı projenize uyarlayın, ancak asla atlamayın. Bu, sessiz gerilemeyi önleyen güvenlik ağıdır.

Projenizde *hiç* test yoksa — ne birim, ne işlevsel, ne de betik — yine de « Yapılacak: bir test stratejisi tanımla. » bölümü içeren boş dosyayı oluşturun. Bu, gelecekteki size bu konunun ele alınmadığını hatırlatacak bir yer imidir.

[plantuml, format=svg, id=diag-session-flow, alt="Flux d'une session type avec Eager/Lazy et agents"]
----
@startuml
skinparam backgroundColor #FEFEFE

start

:Oturum başlangıcı;
note right: Ajan boş bir sayfadır.

:EAGER otomatik yükleniyor;
note right
* AGENT.adoc (mutlak kurallar)
* PROMPT_REPRISE.adoc (görev N)
* INDEX.adoc (proje durumu)
end note

if (Mission claire ?) then (oui)
  :Doğrudan yürütme;
else (non)
  :Talep üzerine LAZY yükü;
  note right
* SESSIONS_HISTORY.adoc (geçmiş bağlam)
* sessions/{N-1}-*.adoc (kararlar)
* *_REFERENCE.adoc (mimari)
  end note
endif

:Uzman temsilci yetkilendirmesi?;

if (CODER ?) then (oui)
  :Yatak CODER.adoc;
  :Kurallara uyar FTL/CSS;
elseif (SCRUM Master ?) then (oui)
  :Yatak SCRUM_MASTER.adoc;
  :Zorunlu teslimat yapısı;
elseif (PlantUML ?) then (oui)
  :Yatak PLANTUML_DESIGNER.adoc;
  :Sözdizimi PUML + integrasyon;
else (non)
endif

:Oturum çalışması;

:Oturum sonu (kullanıcı tetikleyicisi);

:6 adımlı prosedür;
note right
1. Arşivle sessions/N-*.adoc
2. Güncelleme PROMPT_REPRISE.adoc (N+1)
3. Güncelleme SESSIONS_HISTORY.adoc
4. Güncelleme INDEX.adoc
5. Güncelleme TEST_COVERAGE (varsa)
6. Güncelleme COMPLETED_TASKS_ARCHIVE.adoc
end note

:Kontrol listesi [✅] x 6;

stop
@enduml
----

Yukarıdaki diyagram bir oturumun tam yaşam döngüsünü gösterir. Kilit nokta EAGER yüklemesindeki çatallanmadır: ya görev doğrudan yürütmek için yeterince açıktır (%80 durum), ya da ajan bir belirsizliği çözmek için LAZY yükler (%20 durum). Tokenleri tasarruf ettiren şey bu ayrımdır.

== Oturum Sonu Prosedürü: Altın Kural

=== Neden o vazgeçilmez

Bu prosedür olmadan Eager/Lazy stratejisi işe yaramaz. Oturumun çalışmasını kalıcı bilgiye dönüştüren odur. Yürütülür**kullanıcının açık talebi üzerine**(anahtar kelimeler: "oturum sonu", "ayrılıyorum", vb.), ve o**zorunlu**-- hiçbir istisna, hiçbir ihmal yok.

Dosya`SESSION_CHECKLIST.adoc`ideal oturum metriklerini tanımlar:

* Süre: 15-30 dakika
* Değiştirilen dosyalar: en fazla 1-3
* LLM etkileşimleri: 5-10 mesaj
* Bağlam token'ları: < 50k

Ve oturumu değiştirmek gerektiğine dair işaretler: _LLM daha önce düzeltilmiş hataları tekrarlıyor_, _Paralel olarak 3'ten fazla dosya değiştirildi_, _Konuşma > 50 mesaj_. Altın kural:**20 dakikalık 5 oturum, kaotik hata ayıklamayla geçen 2 saatlik bir oturumdan daha iyidir.**

=== 6 Adımın Akışı (Sessizce)

[plantuml, format=svg, id=diag-end-session-flow, alt="Flux de la procédure de fin de session"]
----
@startuml
skinparam defaultTextAlignment center
skinparam wrapWidth 200
skinparam activityBackgroundColor #E3F2FD

start
:L'utilisateur dit "oturum sonu";
note right: Tetikleyici anahtar kelimeler

:Agent tetikleyiciyi tespit eder;

:Adım 1 arşiv \nCroluştur\n`.agents/sessions/N-*.adoc`;
note right: Oturumun tüm bağlamı

:Adım 2\nMettre güncel\n`PROMPT_REPRISE.adoc`;
note right: Görev N + kabul kriterleri N+1

:Adım 3\nMettre güncel\n`SESSIONS_HISTORY.adoc`;
note right: Özet satırı : # / Tarih / Tür / Konu / Puan

:Adım 4\nMettre güncel\n`INDEX.adoc`;
note right: Mevcut durum, yol haritası, değiştirilmiş dosyalar

:Adım 5\nMettre güncel\n`TEST_COVERAGE_ANALYSIS.adoc`;
note right: Testler eklenirse veya değiştirilirse

:Adım 6\nMettre güncel\n`COMPLETED_TASKS_ARCHIVE.adoc`;
note right: Tamamlanan görevleri arşivle

:Onay kontrol listesini göster;
note right: Her [✅]'nin hak edildiğini doğrula.

stop
@enduml
----

=== 150+ Oturumun Sonuçları

İşte bu prosedürün dört projemde sistematik olarak uygulanmasının verdiği sonuç:

**PlantUML eklentisi** :

* **133 oturum**projenin başından itibaren
* **240/240 test BAŞARILI**(100% kapsam) -- EPIC'ler 1-7 tamamlandı
* **57 Cucumber BDD senaryosu**onaylanmış
* Gerçek bir hatadan doğan yapılandırma dosyalarına ilişkin güvenlik kuralı (Oturum 2 bakery-plugin)

**bakery-plugin** :

* **11 oturum**iki hafta içinde
* Supabase → Firebase geçişi tamamlandı (9 test düzeltildi)
* EPIC 6 (`publishProfile`) üretimde işlevsel
* Kural 0 oluşturuldu:`publishToMavenLocal`her değişiklikten sonra zorunlu

**sihirli çubuk**:

* **23 oturum**A/B bölümlü canlı bir Xubuntu sistemi oluşturmak için
* 10. oturumda oluşturulan ilk ISO
* QEMU + VNC önyükleme testleri resmileştirildi (144 satırlık LAZY dokümantasyonu)
* Çalışan CI/CD SourceForge

**cheroliv.com** :

* **9 resmi oturum**+ 7 sistem öncesi oturumun yeniden oluşturulması
* Makale 0101 (OpenCode PATH) yayımlandı
* Madde 0108 (bu madde), eksikliklerinin analizinden sonra yeniden yazıldı
* Yönetişim tamamen Markdown'dan AsciiDoc'a taşındı

=== Nihai Kontrol Listesi

6 adımın sessizce yürütülmesinin ardından, ajan bir onay kontrol listesi görüntülemelidir:

✅ Procédure de fin de session exécutée
📋 Checklist :
[✅] 1. Archive session N créée
[✅] 2. PROMPT_REPRISE.adoc mis à jour pour session N+1
[✅] 3. SESSIONS_HISTORY.adoc mis à jour
[✅] 4. INDEX.adoc mis à jour
[✅] 5. TEST_COVERAGE_ANALYSIS.adoc mis à jour (si applicable)
[✅] 6. COMPLETED_TASKS_ARCHIVE.adoc mis à jour

mkdir -p .agents/sessions .agents/archives

= {NOM_PROJET} — Directives Agent

[CAUTION]

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center
skinparam nodeBackgroundColor #E3F2FD

title Proje Portföyü — Çapraz Referanslar INDEX.adoc
node "**magic-stick**\nSession 037\nSCRIPT_VERIFICATION" as MS #E1BEE7
node "**bakery-gradle**\nSession 11\nTEST_COVERAGE" as BG #FFE0B2
node "**cheroliv.com**\nSession 10\nTEST_COVERAGE" as CH #C8E6C9
node "**plantuml-gradle**\nSession 133\nTEST_COVERAGE" as PG #BBDEFB
node "**jhipster-gradle**\nSession 1 🆕\nTEST_COVERAGE" as JG #FFCDD2

MS --> BG : INDEX.adoc referans
MS --> CH : INDEX.adoc referans
MS --> PG : INDEX.adoc referans
MS --> JG : INDEX.adoc referans 🆕

BG --> MS : INDEX.adoc referans
BG --> CH : INDEX.adoc referans
BG --> PG : INDEX.adoc referans
BG --> JG : INDEX.adoc referans 🆕

CH --> MS : INDEX.adoc referans
CH --> BG : INDEX.adoc referans
CH --> PG : INDEX.adoc referans
CH --> JG : INDEX.adoc référence 🆕

PG --> MS : INDEX.adoc referans
PG --> BG : INDEX.adoc referans
PG --> CH : INDEX.adoc referans
PG --> JG : INDEX.adoc referans 🆕

JG --> MS : INDEX.adoc referans
JG --> BG : INDEX.adoc referans
JG --> CH : INDEX.adoc referans
JG --> PG : INDEX.adoc referans

note bottom of JG
When adding a project:
• 4 INDEX.adoc to update
• 1 line per portfolio
• Cost: 5 minutes
end note

legend bottom
  |= Couleur |= Projet |
  | <#E1BEE7> | magic-stick — ISO Linux live |
  | <#FFE0B2> | bakery-gradle — Plugin JBake |
  | <#C8E6C9> | cheroliv.com — Site personnel |
  | <#BBDEFB> | plantuml-gradle — Plugin IA |
  | <#FFCDD2> | jhipster-gradle — Mono-repo JHipster |
endlegend

@enduml