Conrad Schulz
045e2e7202
- New repo convention: /data/<service>/ for all persistent service data (gitignored) - New repo convention: /history/prompts/ (gitignored) + /history/summary/PROJECT_CONTEXT.md for agent session logging and compressed project context - git-templates/hooks/pre-commit: quality gate checking tests + docs on every commit - git-templates/docs/: USER.md, ADMIN.md, MAINTAINER.md templates (3 target groups) - git-templates/history/summary/PROJECT_CONTEXT.md: agent context template - prompts/history.prompt.md: /history prompt for logging sessions + updating summary - copilot-bootstrap.sh: creates all new folders, .gitignore entries, installs hook - deploy.sh + deploy.fish: deploy hooks, doc templates, history template - docs/ADMIN.md: new admin handbook for this project - docs/USER.md + docs/MAINTAINER.md: updated with new conventions - git-templates/.github/copilot-instructions.md: extended DoD + new conventions - README.md: updated structure overview + prompt table
69 lines
1.9 KiB
Markdown
69 lines
1.9 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/{{DATUM}}_{{TITEL}}.md` mit folgendem Inhalt:
|
||
- Alle Fragen, Antworten, Entscheidungen aus dieser Sitzung
|
||
- Datum und Aufgabentitel im Dateinamen (Format: `YYYY-MM-DD_kurz-beschreibung.md`)
|
||
- Vollständig – nichts weglassen
|
||
|
||
Struktur:
|
||
```markdown
|
||
# [Aufgabe] – YYYY-MM-DD
|
||
|
||
## Aufgabe / Ziel
|
||
[Was sollte erreicht werden]
|
||
|
||
## Verlauf
|
||
### Prompt 1
|
||
[Frage/Anweisung]
|
||
|
||
### Antwort 1
|
||
[Was der Agent geantwortet / getan hat]
|
||
|
||
### 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/summary/PROJECT_CONTEXT.md
|
||
# history/prompts/ ist gitignored – kein add nötig
|
||
```
|