Was gesichert ist: das Protokoll deines Ordners

In 30 Sekunden

Ein Projektordner (Repo) ist ein Ordner, der über sich selbst Buch führt. Neben deinen Dateien liegt ein Protokoll, in dem jeder festgehaltene Arbeitsstand als Eintrag steht.

Ein Projektordner mit aktuellen Dateien und einer Git-Historie aus mehreren festgehaltenen Arbeitsständen. — Git kann nur zurückholen, was zuvor als Stand festgehalten wurde (Commit).

Was einmal festgehalten war, ist im Protokoll. „Entfernt" heißt: ein neuer Eintrag, der alte bleibt. Was nie festgehalten war, ist der einzige echte Verlust.

Was du wissen musst

Jeder Eintrag ist ein festgehaltener Stand mit Datum und einem Satz dazu, was sich geändert hat.

Das Protokoll schreibt niemand von Hand. Dein Agent legt die Einträge an, wenn ein Arbeitsschritt fertig ist. Du kennst die Situation, in der er sagt: „Ich habe committet."

Eine Grenze gehört gleich dazu: das Protokoll kennt nur, was einmal festgehalten wurde. Eine Datei, die du heute anlegst und die noch in keinem Eintrag steht, ist für das Protokoll unsichtbar. Dasselbe gilt für Ordner, die absichtlich ausgenommen sind, etwa die Marketing-Ablage.

Gelöscht heißt: steht im Protokoll

Der aktuelle Stand ist der rechte Punkt. Jeder frühere Punkt bleibt erreichbar. Deshalb konnte dein Agent die Fotos „direkt wiederherstellen".

Im Papierkorb-Denken. Gelöscht heißt: weg, bis der Papierkorb geleert wird. Danach ist es endgültig.

Im Protokoll-Denken. Entfernt heißt: die Datei fehlt im aktuellen Stand. In jedem früheren Eintrag steht sie weiter vollständig drin, wie ein Absatz in einem alten Briefentwurf.

Wann etwas wirklich weg ist

Bevor du dich auf das Protokoll verlässt, kläre eine Frage: War die Datei je festgehalten? Frag den Agenten: „Stand die Datei jemals in einem Eintrag?"

Ja. Dann holt das Protokoll sie zurück, aus jedem Stand, in dem sie war. Der Probelauf dieses Bereichs zeigt dir den Weg an einer Testdatei.

Nein. Dann hilft das Protokoll nicht. Prüfe zuerst den Papierkorb, danach das Backup und zuletzt den Verlauf deines Editors.

Damit arbeitest du

AGENTS.md · Versionierung

## Versionierung
- Beschreibe jeden abgeschlossenen Git-Stand mit einem verständlichen Satz.
- Übertrage Änderungen zu GitHub erst nach meinem Go.