Conrad Schulz ca7f52b0ba fix: pre-commit Check 6 – Session-Datei muss in Commit gestaged sein

- Check 6 blockiert wenn keine *_session.md in den gestagten Dateien ist
- Besser als Datumspruefung: prueft den konkreten Commit, nicht den Kalendertag
- Mehrere Commits in einer Session: /history ergaenzt nur neuen Teil
- history.prompt.md: liest bestehende Session-Datei, ergaenzt nur fehlenden Teil
- .copilot-no-session: Opt-out fuer dieses Setup-Repo (manuelle Commits)

2026-06-03 05:55:36 +00:00

2.6 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

Schritt 1: Bestehende Session-Datei prüfen

Suche nach einer Datei history/prompts/YYYY-MM-DD_*_session.md für das heutige Datum.

Wenn eine existiert: Lies sie vollständig. Stelle fest welche Prompts/Antworten bereits dokumentiert sind. Ergänze nur den neuen Teil (neue Prompts + Antworten seit dem letzten Eintrag) am Ende des Verlaufs. Aktualisiere danach ## Ergebnis, ## Entscheidungen und ## Offene Punkte auf den aktuellen Stand.
Wenn keine existiert: Lege eine neue Datei an.

Dateiname: YYYY-MM-DD_kurzbeschreibung_session.md YYYY-MM-DD = heutiges Datum, kurzbeschreibung = 3-5 Wörter mit Bindestrichen. Das Suffix _session.md ist zwingend — der post-commit Hook erkennt daran das Agent-Log.

Beispiel: 2026-06-03_tile-server-martin-setup_session.md

Inhalt: Vollständig – alle Prompts, Antworten, Befehle, Fehlermeldungen, Entscheidungen.

Struktur (bei neuer Datei):

# [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.6 KiB Raw Blame History Unescape Escape