Conrad Schulz
bc23bd7f92
- 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
74 lines
2.2 KiB
Markdown
74 lines
2.2 KiB
Markdown
---
|
||
mode: agent
|
||
description: 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.
|
||
|
||
**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:
|
||
```markdown
|
||
# [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:
|
||
1. **"Letzte Aktualisierung"** mit heutigem Datum und erledigter Aufgabe
|
||
2. **"Erledigte Aufgaben"** – neue Zeile oben einfügen (neueste zuerst)
|
||
3. **"Offene Aufgaben"** – Abgehaktes entfernen, Neues hinzufügen
|
||
4. **"Für den nächsten Agenten"** – klare Startpunkte für die nächste Session
|
||
5. **"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:
|
||
```bash
|
||
git add history/
|
||
git commit -m "docs: update agent history and project context"
|
||
```
|