Conrad Schulz 4c6fd1331c feat: post-commit hängt git-block an session-datei an

- Hook erkennt *_session.md Dateien (vom Agent via /history erstellt)
- Modus A: Git-Block an bestehende Konversations-Datei anhängen
- Modus B: Nur Git-Stub wenn kein Agent-Log vorhanden (Hinweis ausgeben)
- history.prompt.md: Dateinamen-Konvention _session.md dokumentiert

2026-06-02 09:30:23 +00:00

2.3 KiB

Raw Blame History

mode	description
agent	Agenten-History loggen oder Kontext-Summary aktualisieren

Agent History & Kontext

Du hilfst dabei die Projekt-History zu pflegen. Es gibt zwei Aufgaben:

Aufgabe A: Konversation loggen

Erstelle eine neue Datei history/prompts/{{DATUM}}_{{TITEL}}_session.md mit der vollständigen Konversation. Exsistiert die Datei nicht wird sie angelegt. Wenn Sie bereits wird nur der neue inhalt hinzugefügt.

Wichtig zum Dateinamen: Das Suffix _session.md ist zwingend — der post-commit Hook erkennt daran, dass ein Agent-Log existiert und hängt den Git-Block automatisch an statt eine neue Datei zu erstellen.

Format: YYYY-MM-DD_kurz-beschreibung_session.md
Beispiel: 2026-06-02_tile-server-martin-setup_session.md

Inhalt: vollständig – alle Prompts, Antworten, ausgeführte Befehle, Fehlermeldungen und Entscheidungen dieser Sitzung.

Struktur:

# [Aufgabe] – YYYY-MM-DD

## Aufgabe / Ziel
[Was sollte erreicht werden]

## Verlauf

### Prompt 1
[Frage/Anweisung des Users]

### Antwort 1
[Was der Agent geantwortet / getan hat, inkl. ausgeführter Befehle und deren Output]

### Prompt 2
…

## Ergebnis
[Was wurde erreicht? Welche Dateien geändert?]

## Entscheidungen
[Wichtige Entscheidungen die getroffen wurden]

## Offene Punkte
[Was wurde nicht abgeschlossen / zurückgestellt?]

Aufgabe B: PROJECT_CONTEXT.md aktualisieren

Lies history/summary/PROJECT_CONTEXT.md und aktualisiere:

"Letzte Aktualisierung" mit heutigem Datum und erledigter Aufgabe
"Erledigte Aufgaben" – neue Zeile oben einfügen (neueste zuerst)
"Offene Aufgaben" – Abgehaktes entfernen, Neues hinzufügen
"Für den nächsten Agenten" – klare Startpunkte für die nächste Session
"Bekannte Fallstricke" – neue Erkenntnisse ergänzen

Wichtig: PROJECT_CONTEXT.md muss immer den aktuellsten Stand widerspiegeln. Es ist das einzige Dokument, das ein Agent ohne vorherige Kenntnis des Projekts lesen muss um sofort produktiv zu sein.

Wann ausführen?

Am Ende jeder Copilot-Session die bedeutende Änderungen gemacht hat
Vor dem letzten Commit einer Feature-Branch
Bevor eine neue komplexe Aufgabe beginnt (Kontext prüfen)

Automatisierung

Nach Abschluss dieser Aufgabe:

git add history/
git commit -m "docs: update agent history and project context"

2.3 KiB Raw Blame History Unescape Escape