Sliding Window und Kältewelle: Wenn der Agenten-Kontext explodiert und archiviert werden muss, ohne Verluste

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 Wachstum des Agenten-Kontexts — Sitzungen 1 bis 48
rectangle "Sitzung 1-10" as S10 #E8F5E9
rectangle "Sitzung 11-20" as S20 #C8E6C9
rectangle "Sitzung 21-30" as S30 #A5D6A7
rectangle "Sitzung 31-40" as S40 #81C784
rectangle "Sitzung 41-48" as S48 #66BB6A

note right of S10
INDEX : ~50 Zeilen
SESSIONS : ~10 Zeilen
ARCHIV : ~100 Zeilen
**Gesamt : ~300 Zeilen**
end note

note right of S20
INDEX : ~100 Zeilen
SESSIONS : ~20 Zeilen
ARCHIV : ~400 Zeilen
**Gesamt : ~800 Zeilen**
end note

note right of S30
INDEX : ~160 Zeilen
SESSIONS : ~30 Zeilen
ARCHIV : ~900 Zeilen
**Gesamt : ~1800 Zeilen**
end note

note right of S40
INDEX : ~220 Zeilen
SESSIONS : ~45 Zeilen
ARCHIV : ~1400 Zeilen
**Gesamt : ~3200 Zeilen**
end note

note right of S48
INDEX : **260 Zeilen**
SESSIONS : **55 Zeilen**
ARCHIV : **1756 Zeilen**
**Gesamt : 5200 Zeilen** ⚠️
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...
----

Der Schlüssel des Mechanismus :**Das Backup ist kein zentraler Index, es ist eine exakte Kopie der vergangenen Welle.**. Wenn man den Horizont von 10 aktiven Sitzungen überschreitet, löscht man nichts. Man reindexiert nichts. Man fusioniert nichts. Man nimmt das Paket der Agenten-Dateien, wie es in Sitzung N-10 war, und verschiebt es hinein`backup/`.

Die aktiven Dateien, sie, sind abgeschnitten:

* INDEX: nur die letzten 10 Zeilen (schiebendes Fenster)
* SESSIONS_HISTORY : gleich
* COMPLETED_TASKS_ARCHIVE: neue Datei für den laufenden Zeitraum
* sessions/ : nur die letzten 2 Sitzungen

[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 Architecture Hot / Warm / Cold des Kontext-Agents
package "HOT (EAGER)\nAutomatisch geladen\n~300 Zeilen" as HOT #FFCDD2 {
  file "INDEX.adoc\n(10 Sitzungen)" as IDX_HOT
  file "PROMPT_WIEDERHOLEN\n(Sitzung N+1)" as PRO_HOT
  file "AGENT.adoc\n(absoluten Regeln)" as AG_HOT
}

package "WARM (LAZY)\nBei Bedarf geladen\n~500 Zeilen" as WARM #FFF9C4 {
  file "SESSIONS_HISTORY\n(10 letzte)" as HIS_WARM
  file "SCRIPT_VERIFICATION\n(letzte)" as VER_WARM
  file "PROCEDURES.adoc\n(Vorlagen)" as PRO_WARM
  file "*_REFERENCE.adoc\n(technisches Dokument)" as REF_WARM
}

package "COLD (backup/)\nNie geladen\nNur menschenlesbar" as COLD #BBDEFB {
  folder "Y2026-001-039/" as WAVE {
    file "INDEX (vollständig)" as IDX_COLD
    file "SESSIONS_HISTORY\n(vollständig)" as HIS_COLD
    file "COMPLETED_TASKS\n(vollständig)" as ARCH_COLD
    folder "Sitzungen/ (001-039)" as SESS_COLD
  }
  folder "Y2026-040-???\n(Zukunft)" as FUTURE
}

HOT --> WARM : "Agent steigt\nbei Bedarf"
WARM --> COLD : "Nie automatisch\nDer Mensch geht dort allein"

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

@enduml
----

Der sofortige Gewinn ist massiv: der EAGER-Kontext geht von**~5200 Zeilen zu ~300 Zeilen**. Eine Division durch 17. Ohne eine einzige Zeile historischer Daten verloren zu haben.

== Warum es kein Sammelsurium ist

Der Agent, in seiner ersten Iteration, fürchtete, dass`backup/`Wird zu einer schwarzen Kiste — einem Ordner, in den man Dateien wirft, die man nie wieder lesen wird. Das ist eine berechtigte Angst. Aber sie beruht auf einem Missverständnis.

Ein Sammelsurium ist, wenn man Dateien wirft.**ohne Struktur, ohne Konvention, ohne Gruppierungslogik**. Hier ist das Backup nach Zeitraum (Y2026-001-039) strukturiert, und jedes Backup-Verzeichnis enthält**die gleiche Struktur**dass das Dossier`.agents/`aktiv : INDEX, SESSIONS_HISTORY, COMPLETED_TASKS_ARCHIVE, sessions/

Das ist kein Sammelsurium. Es ist ein**Zeitstempel-Snapshot**. Man könnte sogar sagen, dass es ein vereinfachtes Versionierungsmechanismus ist — mit dem Unterschied, dass es nicht einzelne Dateien versioniert, sondern das komplette Paket der Governance zu einem Zeitpunkt T.

Wenn Sie nach einer alten Information suchen, benötigen Sie keinen zentralen Index. Sie haben zwei Optionen:

1. **gezielte `grep**(Empty output)`grep -r "zsh" backup/Y2026-001-039/`— und du findest alles, was Zsh in diesem Zeitraum erwähnt, unabhängig vom Winkel (INDEX, SESSIONS_HISTORY, Sitzungsarchiv).
2. **Manuelle Wiedereingliederung**: Sie kopieren den Backup-Ordner vorübergehend in den aktiven Kontext, und Sie bitten den Agenten, diesen spezifischen Zeitraum zu analysieren.

Der Index ist implizit. Er befindet sich in der Struktur selbst der Dateien — jede Datei ist bereits ein Index aus ihrer eigenen Perspektive.

== Die Metapher der Regale

Um den Mechanismus intuitiv zu machen, habe ich ihn in drei Regale konzipiert :

* **Regal 1 (EAGER)**— der Arbeitsplan. Was ich *jetzt* brauche. INDEX kürzlich, PROMPT_REPRISE, absolute Regeln. Leicht, unmittelbar, kritisch.
* **Regal 2 (LAZY)**— die Nachschlagebibliothek. Was ich auf Anfrage abrufen kann. Technische Referenzen, aktuelle Historie, Verfahren. Umfangreicher, aber nicht im Speicher geladen.
* **Höhle (Sicherung/)**— Die kalten Archive. Alles, was vergangen ist, doch das ich nicht wegwerfen mag. Der Agent betritt es nie. Der Mensch steigt hinab, wenn er destillieren will.

Der Agent hat ursprünglich ein viertes Regal vorgeschlagen — ein`index-backup.adoc`der wäre LAZY und würde ein Inhaltsverzeichnis des gesamten Backups enthalten. Ich habe abgelehnt. Das wäre eine zusätzliche Redundanz in einem System, das bereits unter linearem Wachstum leidet. Die Struktur der archivierten Dateien ist bereits ein Index.

== Der Sensor mit zwei Auslösern

Die Konzeption war solide, aber es blieb ein blinder Fleck :**Wann genau soll die Rotation ausgelöst werden?**Der ursprüngliche Artikel identifizierte es als offene Frage. Zwei Tage später wurde die Antwort in den Governance-Dateien von sechs Projekten kodifiziert: ein Sensor mit zwei Auslösern.

=== Der automatische Auslöser — `N % 10 == 0

Der erste Auslöser ist mathematisch. Wenn die Sitzungsnummer ein Vielfaches von 10 ist — Sitzung 10, 20, 30, 40 — wird die Backup‑Rotation automatisch im Rahmen der Sitzungsendprozedur ausgeführt, direkt nach Schritt 6.

Warum 10? Das ist der Kompromiss zwischen zwei gegensätzlichen Kräften: Ein zu kurzes Fenster (5 Sitzungen) verliert den für die Kontinuität notwendigen Kontext; ein zu langes Fenster (20 Sitzungen) löst das Problem der Kontextüberlastung nicht. Zehn Sitzungen, bei einem Tempo von einer bis zwei Sitzungen pro Tag, decken etwa eine Arbeitswoche ab – ausreichend, damit der Agent sich an kürzliche Entscheidungen erinnert, aber nicht genug, damit der Kontext explodiert.

=== Schwellwert-Trigger — 500 Zeilen EAGER

Der zweite Trigger ist dynamisch. Unabhängig von der Sitzungsnummer, wenn die akkumulierten EAGER-Dateien überschreiten**500 Zeilen**, die Drehung wird ausgelöst.

Dieser Schwellenwert schützt gegen das Szenario, wo die Sitzungen außerordentlich produktiv sind – viel Text wird in wenigen Sitzungen geschrieben. Eine Sitzung, die 120 Zeilen redaktionellen Inhalts produziert, lässt COMPLETED_TASKS_ARCHIVE deutlich schneller anwachsen als eine Debug‑Sitzung, die nur zwei Zeilen korrigiert. Der Schwellenwert von 500 Zeilen, gemessen via`wc -l .agents/INDEX.adoc .agents/archives/COMPLETED_TASKS_ARCHIVE_*.adoc PROMPT_REPRISE.adoc`, erfasst diese Asymmetrie.

=== Der manuelle Auslöser — "rotation backup

Endlich behält der Mensch die Oberhand. Die Schlüsselwörter`rotation backup`, `backup rotation` ou `lance la rotation backup`Sie lösen die Prozedur auf Anforderung aus, unabhängig vom Sitzungsende. Nützlich, wenn man spürt, dass der Kontext schwer wird, aber man noch nicht ein Vielfaches von 10 erreicht hat, oder wenn man eine Arbeitsphase archivieren möchte, bevor man eine neue beginnt.

[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 Backup-Drehzahlsensor — Die drei Auslöser
start

:Procédure de fin de session;
note right: Mots-clés "Ende der Sitzung"\nou "wir hören hier auf"

:É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
----

Dieses Diagramm zeigt die genaue Einfügung des Sensors in das Verfahren zum Sitzungsende. Schritt 7 ist optional — er wird nur ausgeführt, wenn eine der beiden Bedingungen erfüllt ist — aber er wird systematisch *überprüft*. Die abschließende Checkliste enthält`[✅] 7. Backup roté (si applicable)`.

=== Die geschlossene Schleife

Dieser Sensor schließt die von dem vorherigen Artikel geöffnete Schleife. Die Eager/Lazy-Governance hatte das Problem des Agentenspeichers zwischen zwei Sitzungen gelöst. Der Hot/Warm/Cold-Mechanismus hat das Problem des wachsenden Speichers gelöst. Der Sensor mit zwei Auslösern löst das Problem des *wann* — indem er dem Menschen die mentale Belastung nimmt, die Größe des Kontextes zu überwachen.

[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 Die drei Schichten der Governance Agent
left to right direction

package "Schicht 1 — Speicher\n(Artikel 0108)" as C1 #E8F5E9 {
  rectangle "**EAGER**\nDashboard\nAutomatisch geladen" as EAG
  rectangle "**LAZY**\nBesitzerhandbuch\nAuf Anfrage geladen" as LAZ
  EAG -[hidden]right-> LAZ
}

package "Schicht 2 — Alterung\n(Artikel 0110)" as C2 #FFF9C4 {
  rectangle "**HOT**\n10 aktive Sitzungen\n~300 Zeilen" as HOT
  rectangle "**WARM**\nReferenzen\nVerfahren" as WRM
  rectangle "**COLD**\nbackup/\nKalte Welle" as CLD
  HOT -[hidden]right-> WRM
  WRM -[hidden]right-> CLD
}

package "Schicht 3 — Trigger\n(Heute)" as C3 #BBDEFB {
  rectangle "**Auto**\nN % 10 == 0" as AUTO
  rectangle "**Schwelle**\n> 500 Zeilen" as SEUIL
  rectangle "**Handbuch**\nRotation Sicherung" as MAN
  AUTO -[hidden]right-> SEUIL
  SEUIL -[hidden]right-> MAN
}

C1 --> C2 : "Die Speichergröße wächst\n→ es braucht einen Mechanismus\ndes Alterns"
C2 --> C3 : "Das Altern\n→ Es braucht einen Auslöser\num ihn auszuführen"

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
----

Die drei Schichten werden logisch geschichtet. Die erste gibt dem Agenten ein Gedächtnis. Die zweite verhindert, dass dieses Gedächtnis den Agenten überlastet. Die dritte automatisiert die Wartung dieses Gedächtnisses, damit der Mensch nicht darüber nachdenken muss.

=== Die effektive Migration auf cheroliv.com

Der Mechanismus blieb nicht theoretisch. Auf`cheroliv.com`, die erste Backup-Rotation wurde am 29. April 2026 ausgeführt — die Sitzungen -6 bis 2 sind zu`.agents/backup/Y2026-sessions-neg6-a-002/`:

|===
|Datei |Vor der Rotation |Nach der Drehung |Gewinn |`.agents/INDEX.adoc` |19 gelistete Sitzungen |10 Sitzungen (3-12) |-9 Einträge |`.agents/SESSIONS_HISTORY.adoc` |18 Sitzungen |10 Sitzungen |-8 Einträge |`COMPLETED_TASKS_ARCHIVE` |161 Zeilen (Sitzungen 1-12) |135 Zeilen (Sitzungen 3-12) |-26 Zeilen |`sessions/` |20 Dateien |10 Dateien |-10 Dateien |**Backup/** |Nicht vorhanden |1 kalte Welle (10 archivierte Sitzungen) |+1 kaltes Paket
|===

Der Gewinn an Zeilen war gering — das Projekt ist jung, 12 Sitzungen — aber wichtig ist, dass das**Der Mechanismus ist vorhanden**. Die nächste automatische Rotation wird bei Sitzung 20 ausgelöst, oder früher, wenn die 500 EAGER-Zeilen erreicht sind.

== Die Lektion Mensch-Agent

Diese Sitzung 048 hat mir etwas Grundlegendes über die Zusammenarbeit mit einem KI-Agenten beigebracht.

Der Agent hat einen natürlichen Bias: er versucht zu**optimieren**, à **vereinfachen**, à **Redundanzen eliminieren**. Es ist die Verzerrung eines Systems, das darauf trainiert wurde, klare und prägnante Antworten zu produzieren. Bei einem reichen und multidimensionalen Datensatz ist sein erster Reflex, ihn auf seine einfachste Form zu reduzieren.

Der Mensch hingegen hat eine andere Intuition: er ahnt, dass strukturierte Redundanz ein**Vorteil**, kein Defekt. Dass die Vielfalt der Blickwinkel auf ein und dieselbe Wirklichkeit genau das ist, was später eine hochwertige Destillation ermöglichen wird.

Es ist nicht so, dass der Agent falsch liegt. Es ist, dass sein "Optimum" nicht meins ist. Der Agent optimiert für das**anwesend**— der unmittelbare Kontext, die schnelle Antwort auf die gestellte Frage. Der Mensch optimiert für das**Zukunft**— die Fähigkeit, wiederzufinden, zu verknüpfen und zu destillieren in drei Monaten oder drei Jahren.

____ Was ich will, ist das Rohmaterial. Deine Überlegungen, dein Zögern, deine Antworten auf meine Fragen. Nicht deine Synthese. Die Synthese, das kann ich besser als du. Ich will das Rohmaterial. ____

Dieser Satz, den ich ihm am Ende der Sitzung gesagt habe, fasst alles zusammen. Der Agent ist ein Produktionswerkzeug. Der Mensch ist das Destillationswerkzeug. Die Governance ist nicht dafür da, dass der Agent alles allein versteht — sie ist dafür da, dass der Mensch später das produzierte Material bearbeiten kann.

Die identische kalte Welle ist die architektonische Übersetzung dieser Philosophie: Man wirft nichts weg, man verschmilzt nichts, man reindiziert nichts. Man verschiebt das Paket intakt. Die Destillation erfolgt später manuell durch den Menschen.

== Die logische Fortsetzung des vorherigen Artikels

Wenn Sie gelesen habenlink:/blog/2026/0108_gouvernance_agent_opencode_eager_lazy_post.html[der Artikel über die Eager/Lazy-Strategie], Sie werden die natürliche Progression erkennen :

1. **Artikel 0108**— Die Eager/Lazy-Governance: *wie* den Agentenkontext in zwei Verfügbarkeitsstufen zu strukturieren
2. **Dieser Artikel 0110**Der Backup-Mechanismus: *comment* diesen Kontext altern lassen, ohne ihn zu verlieren, wenn er zu voluminös wird.

Der erste Artikel antwortete auf die Frage: « Der Agent erinnert sich zwischen zwei Sitzungen an nichts, wie kann man ihm ein Gedächtnis geben?

Das beantwortet die Frage, die sich unvermeidlich aus der ersten ergibt: « Der Speicher vergrößert sich bei jeder Sitzung, wie verhindere ich, dass er den Agenten erstickt, ohne ihn zu löschen?

Die Antwort besteht aus einem Pattern :**Heiß/Warm/Kalt**, angewendet auf die Governance-Dateien. Und zu einem Prinzip:**niemals etwas verlieren,immer alles verlagern**.

== Links

* Vorheriger Artikel:link:/blog/2026/0108_gouvernance_agent_opencode_eager_lazy_post.html[Ein KI-Agent mit AsciiDoc verwalten]
* Meine Seite: https://cheroliv.com
* Das Projekt`magic-stick`: https://github.com/cheroliv/magic-stick

---

*Ein gutes Governance-System löscht niemals Daten. Es ordnet sie an.*
----
----

Der Schlüssel zum Mechanismus:**das Backup ist kein zentraler Index, sondern eine exakte Kopie der vergangenen Welle**Wenn man den Horizont von 10 aktiven Sitzungen überschreitet, wird nichts gelöscht. Es wird nichts neu indexiert. Es wird nichts zusammengeführt. Man nimmt das Paket der Agenten-Dateien so, wie es in Sitzung N-10 war, und verschiebt es nach`backup/`Please provide the text you would like me to translate.

Die aktiven Dateien hingegen werden abgeschnitten:

* INDEX: nur die letzten 10 Zeilen (sliding window)
* SESSIONS_HISTORY : ebenfalls
* COMPLETED_TASKS_ARCHIVE : neue Datei für den aktuellen Zeitraum
* sessions/ : nur die letzten 2 Sitzungen

[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 Hot / Warm / Cold Architektur des Agenten-Kontexts
package "HOT (EAGER)\nAutomatisch geladen\n~300 Zeilen" as HOT #FFCDD2 {
  file "INDEX.adoc\n(10 Sitzungen)" as IDX_HOT
  file "PROMPT_REPRISE\n(Sitzung N+1)" as PRO_HOT
  file "AGENT.adoc\n(absolute Regeln)" as AG_HOT
}

package "WARM (LAZY)\nAuf Anfrage geladen\n~500 Zeilen" as WARM #FFF9C4 {
  file "SESSIONS_HISTORY\n(letzte 10)" as HIS_WARM
  file "SCRIPT_VERIFICATION\n(letzte)" as VER_WARM
  file "PROCEDURES.adoc\n(Templates)" as PRO_WARM
  file "*_REFERENCE.adoc\n(technische Dok.)" as REF_WARM
}

package "COLD (backup/)\nNie geladen\nNur für menschliche Lektüre" as COLD #BBDEFB {
  folder "Y2026-001-039/" as WAVE {
    file "INDEX (vollständig)" as IDX_COLD
    file "SESSIONS_HISTORY\n(vollständig)" as HIS_COLD
    file "COMPLETED_TASKS\n(vollständig)" as ARCH_COLD
    folder "sessions/ (001-039)" as SESS_COLD
  }
  folder "Y2026-040-???\n(zukünftig)" as FUTURE
}

HOT --> WARM : "Agent greift bei\nBedarf darauf zurück"
WARM --> COLD : "Nie automatisch\nDer Mensch geht selbst hinein"

note bottom of COLD
Regel: VOLLSTÄNDIGE KOPIE
Keine Transformation
Keine Neuindexierung
Schreibgeschützt nach Archivierung
end note

@enduml
----

Der unmittelbare Gewinn ist massiv: der EAGER-Kontext wechselt von**~5200 Zeilen auf ~300 Zeilen**. Eine Division durch 17. Ohne eine einzige Zeile historischer Daten verloren zu haben.

== Warum es kein Sammelbecken ist

Der Agent befürchtete in seiner ersten Iteration, dass`backup/`wird zu einer Blackbox — einem Ordner, in den man Dateien wirft, die man nie wieder lesen wird. Das ist eine berechtigte Angst. Aber sie beruht auf einer Verwechslung.

Ein Sammelbecken ist es, wenn man Dateien hineinwirft**ohne Struktur, ohne Konvention, ohne Gruppierungslogik**. Hier ist das Backup nach Zeitraum strukturiert (`Y2026-001-039`), und jeder Backup-Ordner enthält**die gleiche Struktur**dass die Akte`.agents/`aktiv: INDEX, SESSIONS_HISTORY, COMPLETED_TASKS_ARCHIVE, sessions/.

Das ist kein Sammelbecken. Es ist ein**zeitgestempelter Snapshot**Man könnte sogar sagen, dass es sich um einen vereinfachten Versionierungsmechanismus handelt – mit dem Unterschied, dass nicht die einzelnen Dateien versioniert werden, sondern das gesamte Governance-Paket zu einem bestimmten Zeitpunkt T.

Wenn Sie eine alte Information wiederfinden möchten, benötigen Sie keinen zentralen Index. Sie haben zwei Optionen:

1. **gezieltes `grep**Bitte geben Sie den Text an, den Sie übersetzen möchten.`grep -r "zsh" backup/Y2026-001-039/`— und Sie finden alles, was in diesem Zeitraum zsh erwähnt, unabhängig vom Aspekt (INDEX, SESSIONS_HISTORY, Sitzungsarchiv).
2. **Manuelle Wiedereingliederung**: Sie kopieren den Backup-Ordner vorübergehend in den aktiven Kontext und bitten den Agenten, diesen spezifischen Zeitraum zu analysieren.

Der Index ist implizit. Er befindet sich in der Struktur der Dateien selbst – wobei jede bereits aus ihrem eigenen Blickwinkel ein Index ist.

== Die Regal-Metapher

Um den Mechanismus intuitiv zu gestalten, habe ich ihn in drei Regale konzipiert:

* **Regal 1 (EAGER)**— der Arbeitsplan. Was ich *jetzt* brauche. Aktueller INDEX, PROMPT_REPRISE, absolute Regeln. Leicht, unmittelbar, kritisch.
* **Regal 2 (LAZY)**— die Referenzbibliothek. Das, was ich auf Anfrage abrufen kann. Technische Referenzen, aktuelle Historie, Verfahrensanweisungen. Umfangreicher, aber nicht im Arbeitsspeicher geladen.
* **Cave (backup/)**— die Kaltarchive. Alles, was vergangen ist, was ich aber nicht wegwerfen will. Der Agent betritt sie nie. Der Mensch steigt hinab, wenn er destillieren will.

Der Agent hatte ursprünglich ein viertes Regal vorgeschlagen — ein`index-backup.adoc`die `LAZY` wäre und ein Inhaltsverzeichnis des gesamten Backups enthalten würde. Ich habe abgelehnt. Das wäre eine weitere Redundanz in einem System, das bereits unter linearem Wachstum leidet. Die Struktur der archivierten Dateien ist bereits ein Index.

== Der Zwei-Auslöser-Sensor

Die Konzeption war solide, aber es blieb ein blinder Fleck:**wann genau soll die Rotation ausgelöst werden?**Der ursprüngliche Artikel identifizierte dies als eine offene Frage. Zwei Tage später ist die Antwort in den Governance-Dateien von sechs Projekten kodifiziert: ein Sensor mit zwei Triggern.

=== Der automatische Auslöser — `N % 10 == 0

Der erste Auslöser ist mathematisch. Wenn die Sitzungsnummer ein Vielfaches von 10 ist — Sitzung 10, 20, 30, 40 — wird die Backup-Rotation automatisch innerhalb des Sitzungsbeendungsverfahrens, direkt nach Schritt 6, ausgeführt.

Warum 10? Es ist der Kompromiss zwischen zwei gegensätzlichen Kräften: Ein zu kurzes Fenster (5 Sitzungen) verliert den für die Kontinuität notwendigen Kontext; ein zu langes Fenster (20 Sitzungen) löst das Problem des Kontext-Überflusses nicht. Zehn Sitzungen, bei einem Rhythmus von ein bis zwei Sitzungen pro Tag, decken etwa eine Arbeitswoche ab – genug, damit sich der Agent an aktuelle Entscheidungen erinnert, aber nicht genug, damit der Kontext explodiert.

=== Der Schwellenwert-Auslöser — 500 Zeilen EAGER

Der zweite Auslöser ist dynamisch. Unabhängig von der Sitzungsnummer, wenn die kumulierten EAGER-Dateien**500 Zeilen**, wird die Rotation ausgelöst.

Diese Schwelle schützt vor dem Szenario, in dem Sitzungen außergewöhnlich produktiv sind – viel geschriebener Inhalt in wenigen Sitzungen. Eine Sitzung, die 120 Zeilen redaktionellen Inhalts produziert, lässt `COMPLETED_TASKS_ARCHIVE` viel schneller anwachsen als eine Debug-Sitzung, die zwei Zeilen korrigiert. Die Schwelle von 500 Zeilen, gemessen über`wc -l .agents/INDEX.adoc .agents/archives/COMPLETED_TASKS_ARCHIVE_*.adoc PROMPT_REPRISE.adoc`, erfasst diese Asymmetrie.

=== Der manuelle Auslöser — `rotation backup

Schließlich behält der Mensch die Kontrolle. Die Schlüsselwörter`rotation backup`, `backup rotation` ou `lance la rotation backup`lösen das Verfahren auf Anfrage aus, unabhängig vom Ende der Sitzung. Nützlich, wenn man das Gefühl hat, dass der Kontext zu umfangreich wird, man aber noch kein Vielfaches von 10 erreicht hat, oder wenn man eine Arbeitsphase archivieren möchte, bevor man eine neue beginnt.

[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 Backup-Rotationssensor — Die drei Auslöser
start

:Procédure de fin de session;
note right: Mots-clés "Sitzungsende"\nou "wir hören hier auf"

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

if (N % 10 == 0\nOU\nEAGER cumulé > 500 lignes ?) then (oui)
  :⚙️ Rotation Backup\n(étape 7);
  note right
1. `backup/Y20XX-sessions-X-Y/` erstellen
2. Vollständige Kopie von `INDEX` + `HISTORY`
+ `COMPLETED_TASKS` + `sessions/`
3. Aktive Sitzungen auf 10 begrenzen
4. _Aktive Lokalisierung_ hinzufügen
  end note
else (non)
  :Pas de rotation;
endif

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

stop

@enduml
----

Dieses Diagramm zeigt die genaue Einfügung des Sensors in das Verfahren zum Beenden der Sitzung. Schritt 7 ist optional – er wird nur ausgeführt, wenn eine der beiden Bedingungen wahr ist – wird jedoch systematisch *geprüft*. Die finale Checklist enthält`[✅] 7. Backup roté (si applicable)`Please provide the text you would like me to translate.

=== Der geschlossene Regelkreis

Dieser Sensor schließt den offenen Kreis aus dem vorherigen Artikel. Die Eager/Lazy-Governance hatte das Problem des Agent-Gedächtnisses zwischen zwei Sitzungen gelöst. Der Hot/Warm/Cold-Mechanismus löste das Problem des wachsenden Speichers. Der Sensor mit zwei Triggern löst das Problem des *Wann* — indem er dem Menschen die mentale Belastung nimmt, die Kontextgröße überwachen zu müssen.

[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 Die Drei Schichten der Agent-Governance
left to right direction

package "Schicht 1 — Speicher\n(Artikel 0108)" as C1 #E8F5E9 {
  rectangle "**EAGER**\nDashboard\nAuto-geladen" as EAG
  rectangle "**LAZY**\nBenutzerhandbuch\nAuf Anfrage geladen" as LAZ
  EAG -[hidden]right-> LAZ
}

package "Schicht 2 — Alterung\n(Artikel 0110)" as C2 #FFF9C4 {
  rectangle "**HOT**\n10 aktive Sitzungen\n~300 Zeilen" as HOT
  rectangle "**WARM**\nReferenzen\nProzeduren" as WRM
  rectangle "**COLD**\nbackup/\nKaltwelle" as CLD
  HOT -[hidden]right-> WRM
  WRM -[hidden]right-> CLD
}

package "Schicht 3 — Trigger\n(Heute)" as C3 #BBDEFB {
  rectangle "**Auto**\nN % 10 == 0" as AUTO
  rectangle "**Schwellenwert**\n> 500 Zeilen" as SEUIL
  rectangle "**Manuell**\nBackup-Rotation" as MAN
  AUTO -[hidden]right-> SEUIL
  SEUIL -[hidden]right-> MAN
}

C1 --> C2 : "Der Speicher wächst\n→ es wird ein Mechanismus\nzur Alterung benötigt"
C2 --> C3 : "Die Alterung\n→ es wird ein Trigger\nfür die Ausführung benötigt"

note bottom of C3
✅ In 6 Projekten eingesetzt
`magic-stick` · `bakery-gradle`
`plantuml-gradle` · `cheroliv.com`
`jhipster-gradle-plugins`
`quizz-benchmark-gradle
end note

@enduml
----

Die drei Schichten stapeln sich logisch. Die erste verleiht dem Agenten ein Gedächtnis. Die zweite verhindert, dass dieses Gedächtnis den Agenten erstickt. Die dritte automatisiert die Wartung dieses Gedächtnisses, damit der Mensch nicht darüber nachdenken muss.

=== Die effektive Migration auf cheroliv.com

Der Mechanismus blieb nicht theoretisch. Auf`cheroliv.com`, die erste Backup-Rotation wurde am 29. April 2026 ausgeführt — die Sessions -6 bis 2 migrierten nach`.agents/backup/Y2026-sessions-neg6-a-002/`Please provide the text you would like me to translate.

|===
|Datei |Vor der Rotation |Nach der Rotation |Gewinn |`.agents/INDEX.adoc` |19 aufgelistete Sitzungen |10 Sitzungen (3-12) |-9 Eingänge |`.agents/SESSIONS_HISTORY.adoc` |18 Sitzungen |10 Sitzungen |-8 Eingänge |`COMPLETED_TASKS_ARCHIVE` |161 Zeilen (Sitzungen 1-12) |135 Zeilen (Sitzungen 3-12) |-26 Zeilen |`sessions/` |20 Dateien |10 Dateien |-10 Dateien |**Backup/** |Nicht vorhanden |1 Kältewelle (10 archivierte Sitzungen) |+1 Kältepack
|===

Der Zuwachs an Zeilen war bescheiden – das Projekt ist jung, 12 Sessions – aber wichtig ist, dass der**Mechanismus ist implementiert**Die nächste automatische Rotation wird bei Sitzung 20 ausgelöst, oder früher, wenn die 500 EAGER-Zeilen erreicht werden.

== Die Mensch-Agent-Lektion

Diese Sitzung 048 hat mich etwas Grundlegendes über die Zusammenarbeit mit einem KI-Agenten gelehrt.

Der Agent hat eine natürliche Tendenz: Er versucht,**optimieren**, à **vereinfachen**, à **Redundanzen eliminieren**. Das ist der Bias eines Systems, das darauf trainiert wurde, saubere und prägnante Antworten zu liefern. Angesichts eines reichen und multidimensionalen Datasets ist sein erster Reflex, dieses auf seinen einfachsten Ausdruck zu reduzieren.

Der Mensch hingegen hat eine andere Intuition: Er ahnt, dass strukturierte Redundanz ein**Trumpfkarte**, kein Makel. Dass die Vielfalt der Blickwinkel auf dieselbe Realität genau das ist, was später eine qualitative Destillation ermöglichen wird.

Es ist nicht so, dass der Agent unrecht hat. Es ist nur so, dass sein „Optimum“ nicht meines ist. Der Agent optimiert für das**vorhanden**— der unmittelbare Kontext, die schnelle Antwort auf die gestellte Frage. Der Mensch optimiert für den**Zukunft**— die Fähigkeit, in drei Monaten oder drei Jahren wiederzufinden, abzugleichen und zu destillieren.

Please provide the text you would like me to translate. Was ich will, ist das Rohmaterial. Deine Überlegungen, deine Zögerlichkeiten, deine Antworten auf meine Fragen. Nicht deine Synthese. Die Synthese kann ich besser als du. Ich will den Rohstoff. Please provide the text you would like me to translate.

Dieser Satz, den ich ihm am Ende der Sitzung gesagt habe, fasst alles zusammen. Der Agent ist ein Produktionswerkzeug. Der Mensch ist das Destillationswerkzeug. Die Governance ist nicht dazu da, dass der Agent alles alleine versteht – sie ist dazu da, dass der Mensch später das produzierte Material bearbeiten kann.

Die identische Kältewelle ist die architektonische Übersetzung dieser Philosophie: man wirft nichts weg, man verschmilzt nichts, man reindiziert nichts. Man verschiebt das Paket unversehrt. Die Destillation erfolgt später, manuell, durch den Menschen.

== Die logische Fortsetzung des vorherigen Artikels

Wenn Sie gelesen habenlink:/blog/2026/0108_gouvernance_agent_opencode_eager_lazy_post.html[der Artikel über die Eager/Lazy-Strategie], werden Sie die natürliche Progression erkennen:

1. **Artikel 0108**— Die Eager/Lazy-Governance: *wie* man den Agenten-Kontext in zwei Verfügbarkeitsstufen strukturiert
2. **Dieser Artikel 0110**— Der Backup-Mechanismus: *wie* man diesen Kontext altern lässt, ohne ihn zu verlieren, wenn er zu umfangreich wird

Der erste Artikel beantwortete die Frage: „Der Agent erinnert sich zwischen zwei Sitzungen an nichts, wie gibt man ihm ein Gedächtnis?“

Letzterer beantwortet die Frage, die sich zwangsläufig aus der ersten ergibt: „Der Speicher wächst bei jeder Sitzung, wie verhindert man, dass er den Agenten erstickt, ohne ihn zu löschen?“

Die Antwort lässt sich in einem Pattern zusammenfassen:**Heiß/Warm/Kalt**, angewendet auf die Governance-Dateien. Und zu einem Prinzip:**niemals etwas verlieren, immer alles wiederfinden**Please provide the text you would like me to translate.

== Links

* Vorheriger Artikel:link:/blog/2026/0108_gouvernance_agent_opencode_eager_lazy_post.html[Einen KI-Agenten mit AsciiDoc steuern]
* Meine Website: https://cheroliv.com
* Das Projekt`magic-stick`: https://github.com/cheroliv/magic-stick

---

Ein gutes Governance-System löscht niemals Daten. Es archiviert sie.