Conrad Schulz
d9508f7bf1
- git-templates/hooks/post-commit: no-op (kein automatischer Git-Block mehr) - Session-Datei: appended Git-Block entfernt, nur Agent-Inhalt bleibt - Auto-Stub 2026-06-03_master_ca7f52b.md geloescht - copilot-instructions.md (beide): Suffix-Erklaerung auf Check 6 umgeschrieben - prompts/history.prompt.md: post-commit Referenz entfernt - docs/MAINTAINER.md: post-commit Zeile aus Dateistruktur entfernt - README.md: post-commit Zeile aus Struktur + Tabelle entfernt - scripts/copilot-update.fish: post-commit nicht mehr kopiert - scripts/deploy.sh: post-commit nicht mehr installiert
81 lines
2.6 KiB
Markdown
81 lines
2.6 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
|
||
|
||
**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** — Check 6 im pre-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"
|
||
```
|