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

**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):
```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"
```