Conrad Schulz 045e2e7202 feat: add data/, history/, 3-target-group docs, pre-commit quality gate

- 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

2026-05-30 17:19:52 +00:00

1.9 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/{{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:

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

"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/summary/PROJECT_CONTEXT.md
# history/prompts/ ist gitignored – kein add nötig

1.9 KiB Raw Blame History Unescape Escape