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