Conrad Schulz fb1a01ba78 fix: review-findings behoben (7 Punkte)

1. pre-commit: --no-verify Kommentar entfernt
2. pre-commit: .copilot-no-docs Opt-out fuer Check 2 (Doku-Pflicht)
3. .copilot-no-docs angelegt (Setup-Repo = reines Script/Config-Repo)
4. copilot-instructions.md: _session.md Suffix in Agent-History Sektion korrigiert
5. history.prompt.md: Datumsvariablen explizit + Append-Verhalten korrigiert
6. copilot-bootstrap.sh: Hinweis auf git copilot-update fuer Hook-Updates
7. Orphan-Stub 2026-06-02_master_55fee83.md geloescht

2026-06-02 11:13:34 +00:00

2.5 KiB

Raw 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

Erstelle eine neue Datei history/prompts/YYYY-MM-DD_kurzbeschreibung_session.md mit der vollständigen Konversation. YYYY-MM-DD = heutiges Datum, kurzbeschreibung = 3-5 Wörter mit Bindestrichen (kein Leerzeichen). Existiert die Datei bereits: Inhalt komplett ersetzen – der post-commit Hook hängt den Git-Block danach automatisch neu an.

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:

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

"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 history/
git commit -m "docs: update agent history and project context"

2.5 KiB Raw Blame History Unescape Escape