2b20a985a5
Konvention geaendert: history/ -> docs/history/ (prompts + summary/PROJECT_CONTEXT.md). Harter Cutover im pre-commit Hook (Check 4 + Check 6 erwarten docs/history/). Bestehende Repos werden beim naechsten 'git copilot-update' automatisch per git mv migriert (Fallback mv; bei Konflikt Warnung statt Abbruch). Angepasst: pre-commit Hook, alle 6 Skripte + selftest, beide copilot-instructions.md, settings.json Session-Protokoll, history.prompt.md, README, USER/ADMIN/MAINTAINER (+ ADMIN Migrationsabschnitt). git-templates/history -> git-templates/docs/history (git mv). Validiert: shellcheck clean, fish -n clean, selftest PASS, Migrationstest PASS (sh+fish+both-present).
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 `docs/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 `docs/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 docs/history/
|
||
git commit -m "docs: update agent history and project context"
|
||
```
|