Conrad Schulz 2b20a985a5 refactor(history): move agent history under docs/history + auto-migration

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

2026-06-10 12:06:35 +02:00

2.6 KiB

Raw Permalink Blame History

mode	description
agent	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):

# [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:

"Letzte Aktualisierung" mit heutigem Datum und erledigter Aufgabe
"Erledigte Aufgaben" – neue Zeile oben einfügen (neueste zuerst)
"Offene Aufgaben" – Abgehaktes entfernen, Neues hinzufügen
"Für den nächsten Agenten" – klare Startpunkte für die nächste Session
"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:

git add docs/history/
git commit -m "docs: update agent history and project context"

2.6 KiB Raw Permalink Blame History Unescape Escape