Sliding Window dan Gelombang Dingin: Saat Konteks Agent Meledak dan Perlu Diarsipkan Tanpa Kehilangan

wc -l .agents/INDEX.adoc .agents/SESSIONS_HISTORY.adoc \
  .agents/archives/COMPLETED_TASKS_ARCHIVE_2026-04.adoc

@startuml
skinparam backgroundColor #FEFEFE
skinparam handwritten false

title Pertumbuhan Konteks Agent — Sesi 1 hingga 48
rectangle "Sesi 1-10" as S10 #E8F5E9
rectangle "Sesi 11-20" as S20 #C8E6C9
rectangle "Sesi 21-30" as S30 #A5D6A7
rectangle "Sesi 31-40" as S40 #81C784
rectangle "Sesi 41-48" as S48 #66BB6A

note right of S10
  INDEX : ~50 lignes
  SESSIONS : ~10 lignes
  ARCHIVE : ~100 lignes
  **Total : ~300 lignes**
end note

note right of S20
  INDEX : ~100 lignes
  SESSIONS : ~20 lignes
  ARCHIVE : ~400 lignes
  **Total : ~800 lignes**
end note

note right of S30
  INDEX : ~160 lignes
  SESSIONS : ~30 lignes
  ARCHIVE : ~900 lignes
  **Total : ~1800 lignes**
end note

note right of S40
  INDEX : ~220 lignes
  SESSIONS : ~45 lignes
  ARCHIVE : ~1400 lignes
  **Total : ~3200 lignes**
end note

note right of S48
  INDEX : **260 lignes**
  SESSIONS : **55 lignes**
  ARCHIVE : **1756 lignes**
  **Total : 5200 lignes** ⚠️
end note

S10 -[#green]-> S20
S20 -[#green]-> S30
S30 -[#FF9800]-> S40
S40 -[#red]-> S48

@enduml

----
----
.agents/
├── INDEX.adoc                         → Sessions N-9 à N (10 dernières)
├── SESSIONS_HISTORY.adoc              → Sessions N-9 à N
├── SCRIPT_VERIFICATION.adoc           → Dernière vérif (pas d'historique)
├── PROMPT_REPRISE.adoc                → Session N+1 uniquement
├── sessions/                          → Sessions N-1 à N uniquement
└── backup/
    └── Y2026-sessions-001-039/          ← Vague froide, COPIE INTÉGRALE
        ├── INDEX.adoc                  → Sessions 001 à 039 (complet)
        ├── SESSIONS_HISTORY.adoc       → Sessions 001 à 039 (complet)
        ├── COMPLETED_TASKS_ARCHIVE.adoc → Sessions 001 à 039 (complet)
        └── sessions/                   → 001.adoc, 002.adoc...
----

Kunci dari mekanisme :**cadangan bukan merupakan indeks pusat, ini adalah salinan tepat dari gelombang yang lalu**. Melebihi batas 10 sesi aktif, tidak ada yang dihapus. Tidak ada yang di-reindex. Tidak ada yang digabung. Kami mengambil paket file agen seperti sesi N-10, dan memindahkannya ke`backup/`.

File-file aktif, mereka, terpotong:

* INDEX : hanya 10 baris terakhir (sliding window)
* SESSIONS_HISTORY : sama
* COMPLETED_TASKS_ARCHIVE : file baru untuk periode saat ini
* sessions/: hanya 2 sesi terakhir

[plantuml, format=svg, id=diag-hot-warm-cold, alt="Architecture Hot/Warm/Cold du contexte agent — EAGER/LAZY/backup"]
----
@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center
skinparam wrapWidth 200

title Arsitektur Hot / Warm / Cold dari Konteks Agent
package "HOT (EAGER)
Dimuat otomatis
~300 baris" as HOT #FFCDD2 {
  file "INDEX.adoc
(10 sesi)" as IDX_HOT
  file "PROMPT_REPRISE
(sesi N+1)" as PRO_HOT
  file "AGENT.adoc\n(aturan mutlak)" as AG_HOT
}

package "WARM (LAZY)
Dimuat saat diminta
~500 baris" as WARM #FFF9C4 {
  file "SESSIONS_HISTORY
(10 terakhir)" as HIS_WARM
  file "SCRIPT_VERIFICATION\n(terakhir)" as VER_WARM
  file "PROCEDURES.adoc
(templates)" as PRO_WARM
  file "*_REFERENCE.adoc\n(dokumen teknis)" as REF_WARM
}

package "COLD (backup/)
Tidak pernah diisi
Hanya bacaan manusia" as COLD #BBDEFB {
  folder "Y2026-001-039/" as WAVE {
    file "INDEX (lengkap)" as IDX_COLD
    file "SESSIONS_HISTORY
(lengkap)" as HIS_COLD
    file "COMPLETED_TASKS\n(selesai)" as ARCH_COLD
    folder "sesi/ (001-039)" as SESS_COLD
  }
  folder "Y2026-040-???
(future)" as FUTURE
}

HOT --> WARM : "Agent naik
jika diperlukan"
WARM --> COLD : "Tidak pernah otomatis
Manusia pergi ke sana sendiri"

note bottom of COLD
  Règle : COPIE INTÉGRALE
  Pas de transformation
  Pas de réindexation
  Read-only après archivage
end note

@enduml
----

Keuntungan langsung sangat besar : konteks EAGER beralih dari**~5200 baris hingga ~300 baris**. Pembagian dengan 17. Tanpa kehilangan satu baris pun dari data historis.

== Mengapa ini bukan tempat untuk segalanya

Agen, dalam iterasi pertamanya, khawatir bahwa`backup/`menjadi sebuah kotak hitam — sebuah folder tempat menaruh file yang tidak akan pernah dibaca lagi. Ini adalah rasa takut yang sah. Namun itu berbasis pada sebuah kebingungan.

Sebuah tempat menyimpan segala-galanya, itu ketika seseorang melempar berkas.**tanpa struktur, tanpa konvensi, tanpa logika pengelompokan**. Di sini, backup terstruktur berdasarkan periode (Y2026-001-039), dan setiap folder backup berisi**struktur yang sama**bahwa dokumen`.agents/`aktif : INDEX, SESSIONS_HISTORY, COMPLETED_TASKS_ARCHIVE, sessions/.

Bukan ini sebuah tempat untuk menyimpan segala-galanya. Ini adalah**snapshot dengan stempel waktu**. Bahkan bisa dikatakan bahwa ini adalah mekanisme versioning yang disederhanakan — kecuali bahwa ia tidak melakukan versioning pada file secara individual, tetapi pada paket lengkap dari tata kelola pada suatu saat T.

Saat Anda ingin menemukan informasi lama, Anda tidak memerlukan indeks sentral. Anda memiliki dua pilihan:

1. **grep` ditargetkan**:`grep -r "zsh" backup/Y2026-001-039/`— dan Anda menemukan semua yang menyebutkan zsh dalam periode tersebut, tidak peduli sudutnya (INDEX, SESSIONS_HISTORY, arsip sesi).
2. **Reintegrasi manual**: Anda menyalin sementara folder backup ke konteks aktif, dan Anda meminta agen untuk menganalisis periode tertentu ini.

Indeksnya bersifat implisit. Dia berada dalam struktur file itu sendiri — masing-masing file sudah menjadi indeks dari sudut pandangnya masing-masing.

== Metafora dari rak-rak

Agar mekanisme tersebut intuitif, saya mengonsepsikan menjadi tiga rak:

* **Rak 1 (EAGER)**— rencana kerja. Yang saya butuh *sekarang*. INDEX terbaru, PROMPT_REPRISE, aturan mutlak. Ringan, segera, kritis.
* **Rak 2 (LAZY)**— perpustakaan konsultasi. Yang bisa saya ambil berdasarkan permintaan. Referensi teknis, riwayat terkini, prosedur. Lebih besar, tetapi tidak dimuat ke memori.
* **Gua (cadangan/)**— arsip dingin. Semua yang sudah lalu tetapi saya tidak ingin membuangnya. Agen tidak pernah masuk ke sana. Manusia turun ke sana ketika ia ingin mendistil.

Agent menawarkan awalnya sebuah rak keempat — satu`index-backup.adoc`yang akan LAZY dan berisi daftar isi seluruh backup. Saya menolak. Ini akan menjadi redundansi tambahan dalam sistem yang sudah menderita dari pertumbuhan linear. Struktur file-file yang terarsip sudah menjadi sebuah indeks.

== Sensor dengan dua pemicu

Konseptualisasinya kuat, tapi masih ada titik buta:**kapan tepat memicu rotasi?**Artikel awal mengidentifikasinya sebagai pertanyaan terbuka. Dua hari kemudian, jawaban tersebut dikodifikasi dalam file-file governansi dari enam proyek: sebuah sensor dengan dua trigger.

=== Pemicu Otomatis — `N % 10 == 0

Pemicu pertama bersifat matematika. Ketika nomor sesi adalah kelipatan 10 — sesi 10, 20, 30, 40 — rotasi backup dieksekusi secara otomatis dalam prosedur akhir sesi, tepat setelah langkah 6.

Mengapa 10? Ini adalah kompromi antara dua gaya yang berlawanan: jendela yang terlalu pendek (5 sesi) kehilangan konteks yang diperlukan untuk keberlanjutan; jendela yang terlalu panjang (20 sesi) tidak menyelesaikan masalah konteks berlebihan. Sepuluh sesi, dengan ritmo satu hingga dua sesi per hari, mencakup sekitar satu minggu kerja — cukup agar agen mengingat keputusan terbaru, namun tidak cukup untuk meledaknya konteks.

=== Pemicu Ambang — 500 Baris EAGER

Pemicu kedua bersifat dinamis. Terlepas dari nomor sesi, jika file-file EAGER yang terakumulasi melebihi**500 baris**, rotasi terpicu.

Ambang batas ini melindungi dari skenario di mana sesi-sesi sangat produktif — banyak konten yang ditulis dalam sedikit sesi. Sesi yang menghasilkan 120 baris konten redaksi memperbesar `COMPLETED_TASKS_ARCHIVE` jauh lebih cepat dibandingkan sesi debug yang memperbaiki dua baris. Ambang batas 500 baris, yang diukur melalui`wc -l .agents/INDEX.adoc .agents/archives/COMPLETED_TASKS_ARCHIVE_*.adoc PROMPT_REPRISE.adoc`, menangkup ketidaksimetrian ini.

=== Pemicu Manual — "cadangan rotasi

Akhirnya, manusia tetap menguasai. Kata kunci`rotation backup`, `backup rotation` ou `lance la rotation backup`memicu prosedur atas permintaan, terlepas dari akhir sesi. Bermanfaat ketika kita merasa konteks menjadi berat tetapi kita belum sampai kelipatan 10, atau ketika kita ingin mengarsipkan fase kerja sebelum memulai yang baru.

[plantuml, format=svg, id=diag-capteur-trigger, alt="Les trois déclencheurs du capteur de rotation backup — automatique, seuil, manuel"]
----
@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center
skinparam wrapWidth 200

title Sensor Cadangan Rotasi — Tiga Pemicu
start

:Procédure de fin de session;
note right: Mots-clés "akhir sesi"\nou "Kita berhenti di sini"

:Étapes 1 à 6\n(archivage standard);
note right
  1. Archive sessions/N.adoc
  2. MAJ PROMPT_REPRISE
  3. MAJ SESSIONS_HISTORY
  4. MAJ INDEX.adoc
  5. MAJ TEST_COVERAGE
  6. MAJ COMPLETED_TASKS
end note

if (N % 10 == 0\nOU\nEAGER cumulé > 500 lignes ?) then (oui)
  :⚙️ Rotation Backup\n(étape 7);
  note right
    1. Créer backup/Y20XX-sessions-X-Y/
    2. Copier intégrale INDEX + HISTORY
       + COMPLETED_TASKS + sessions/
    3. Tronquer actifs à 10 sessions
    4. Ajouter _Localisation active_
  end note
else (non)
  :Pas de rotation;
endif

:Checklist [✅] x 7\n(si applicable);

stop

@enduml
----

Diagram ini menunjukkan pemasangan sensor yang tepat dalam prosedur akhir sesi. Langkah 7 bersifat opsional — ia hanya dieksekusi jika salah satu dari dua kondisi terpenuhi — tetapi ia secara sistematis *terverifikasi*. Checklist akhir mencakup`[✅] 7. Backup roté (si applicable)`.

=== lingkaran tertutup

Sensor ini menutup loop yang dibuka oleh artikel sebelumnya. Governance Eager/Lazy telah menyelesaikan masalah memori agen antara dua sesi. Mekanisme Hot/Warm/Cold telah menyelesaikan masalah memori yang bertambah. Sensor dengan dua pemicu menyelesaikan masalah *kapan* — menghilangkan beban mental manusia untuk memantau ukuran konteks.

[plantuml, format=svg, id=diag-boucle-fermee, alt="Les trois couches de la gouvernance agent — Eager/Lazy, Hot/Warm/Cold, Capteur"]
----
@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center

title Tiga Lapisan Tata Kelola Agen
left to right direction

package "Lapisan 1 — Memori\n(Pasal 0108)" as C1 #E8F5E9 {
  rectangle "**EAGER**
Dashboard
Dimuat otomatis" as EAG
  rectangle "**LAZY**
Manual pemilik
Dimuat saat diperlukan" as LAZ
  EAG -[hidden]right-> LAZ
}

package "Lapisan 2 — Penuaan
(Artikel 0110)" as C2 #FFF9C4 {
  rectangle "**HOT**
10 sesi aktif
~300 baris" as HOT
  rectangle "**WARM**
Referensi
Prosedur" as WRM
  rectangle "**COLD**
backup/
gelombang dingin" as CLD
  HOT -[hidden]right-> WRM
  WRM -[hidden]right-> CLD
}

package "Lapisan 3 — Pemicu\n(Hari ini)" as C3 #BBDEFB {
  rectangle "**Otomatis**
N % 10 == 0" as AUTO
  rectangle "**Ambang**
> 500 baris" as SEUIL
  rectangle "**Manual**
cadangan rotasi" as MAN
  AUTO -[hidden]right-> SEUIL
  SEUIL -[hidden]right-> MAN
}

C1 --> C2 : "Memori tumbuh
→ diperlukan mekanisme
penuaan"
C2 --> C3 : "Penuaan
→ perlu sebuah pemicu
untuk mengeksekusinya"

note bottom of C3
  ✅ Déployé sur 6 projets
  magic-stick · bakery-gradle
  plantuml-gradle · cheroliv.com
  jhipster-gradle-plugins
  quizz-benchmark-gradle
end note

@enduml
----

Tiga lapisan tersebut menumpuk secara logis. Lapisan pertama memberikan memori kepada agen. Lapisan kedua mencegah memori tersebut menghabisi agen. Lapisan ketiga mengotomatisasi pemeliharaan memori tersebut agar manusia tidak perlu memikirkannya.

=== Migrasi Efektif di cheroliv.com

Mekanisme itu tidak tetap teoretis. Pada`cheroliv.com`, rotasi backup pertama telah dieksekusi pada 29 april 2026 — sesi -6 hingga 2 telah bermigrasi ke`.agents/backup/Y2026-sessions-neg6-a-002/`:

|===
|Berkas |Sebelum rotasi |Setelah rotasi |keuntungan |`.agents/INDEX.adoc` |19 sesi tercantum |10 sesi (3-12) |-9 entri |`.agents/SESSIONS_HISTORY.adoc` |18 sesi |10 sesi |-8 entri |`COMPLETED_TASKS_ARCHIVE` |161 baris (sesi 1-12) |135 baris (sesi 3-12) |-26 baris |`sessions/` |20 file |10 file |-10 file |**cadangan/** |tidak ada |1 gelombang dingin (10 sesi yang diarsipkan) |+1 paket dingin
|===

Peningkatan dalam jumlah baris modest — proyek ini masih muda, 12 sesi — namun yang penting adalah bahwa**mekanisme telah ditempatkan**. Rotasi otomatis berikutnya akan dipicu pada sesi 20, atau lebih awal jika 500 baris EAGER tercapai.

== Pelajaran Manusia-Agen

Sesi 048 ini mengajarkan saya sesuatu yang fundamental tentang kolaborasi dengan agen AI.

Agen memiliki bias alami: dia mencari untuk**mengoptimalkan**, à **menyederhanakan**, à **menghilangkan redundansi**. Ini adalah bias dari sistem yang dilatih untuk menghasilkan respons yang rapi dan ringkas. Di hadapan dataset yang kaya dan multidimensi, refleks pertamanya adalah menguranginya menjadi bentuk paling sederhana.

Manusia, dia, memiliki intuisi yang berbeda: dia merasakan bahwa redundansi terstruktur adalah sebuah**kelebihan**, bukan kesalahan. Bahwa keragaman sudut pandang atas satu realitas itu adalah apa yang secara tepat akan memungkinkan, kemudian, penyaringan kualitas.

Bukan karena agen salah. Yang dimaksud adalah bahwa "optimum" -nya bukan milik saya. Agen mengoptimalkan untuk**hadir**— konteks segera, jawaban cepat atas pertanyaan yang diajukan. Manusia mengoptimalkan untuk**masa depan**— kemampuan untuk menemukan, menyilangkan, mengdistil dalam tiga bulan atau tiga tahun.

____ Yang saya inginkan adalah bahan mentah. Pikiranmu, ragu-ragumu, jawabanmu atas pertanyaan-pertanyaan saya. Bukan sintesismu. Saya tahu cara membuat sintesis lebih baik daripadamu. Saya ingin bahan mentah. ____

Kalimat yang saya katakan padanya di akhir sesi ini merangkum semuanya. Agent adalah alat produksi. Manusia adalah alat distilasi. Tata kelola tidak dibuat agar agen memahami semuanya sendiri — ia dibuat agar manusia bisa, nanti, mengolah bahan yang diproduksi.

Gelombang dingin identik adalah terjemahan arsitektur dari filosofi ini: kita tidak membuang apa-apa, kita tidak menggabungkan apa-apa, kita tidak mengindeks ulang apa-apa. Kita memindahkan paket utuh. Distilasi akan datang nanti, secara manual, oleh manusia.

== Lanjutan Logis dari Artikel Sebelumnya

Jika Anda telah membacalink:/blog/2026/0108_gouvernance_agent_opencode_eager_lazy_post.html[artikel tentang strategi Eager/Lazy], Anda akan mengenal progresi alami :

1. **Pasal 0108**— Tata kelola Eager/Lazy : *comment* menyusun konteks agent pada dua tingkat ketersediaan
2. **Artikel 0110**— Mekanisme cadangan: *bagaimana* membuat konteks ini tua tanpa kehilangan ketika ia terlalu besar

Artikel pertama menjawab pertanyaan: « Agen tidak mengingat apa-apa di antara dua sesi, bagaimana memberi agen memori?

Dia menjawab pertanyaan yang timbul secara tak terelakkan dari yang pertama : « Memori bertambah setiap sesi, bagaimana mencegahnya melumuri agen tanpa menghapusnya ?

Jawabannya hanya berisi satu pola:**Panas/Hangat/Dingin**, diterapkan pada file tata kelola. Dan sebagai satu prinsip:**tidak tidak kehilangan apa-apa, selalu memindahkan kembali semuanya**.

== Tautan

* Artikel sebelumnya :link:/blog/2026/0108_gouvernance_agent_opencode_eager_lazy_post.html[Mengatur Agen AI dengan AsciiDoc]
* Situs saya : https://cheroliv.com
* Proyek`magic-stick`: https://github.com/cheroliv/magic-stick

---

*Sistem tata kelola yang baik tidak pernah menghapus data. Ia mengelola data.*
----