Conrad Schulz
fb1a01ba78
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
76 lines
2.5 KiB
Markdown
76 lines
2.5 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
|
||
|
||
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:
|
||
```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"
|
||
```
|