- history/prompts/2026-05-30_initiales-setup-erweiterungen.md: full session log - history/summary/PROJECT_CONTEXT.md: filled with real project state
91 lines
3.8 KiB
Markdown
91 lines
3.8 KiB
Markdown
# rd13_copilot_setup – Initiales Setup & Erweiterungen – 2026-05-30/31
|
||
|
||
## Aufgabe / Ziel
|
||
|
||
Bestehende Copilot-Workspace-Konfiguration erweitern um:
|
||
1. `/data/` Konvention für persistente Service-Daten
|
||
2. `/history/` für Agent-Session-Logging (vollständige Prompts + komprimierter Kontext)
|
||
3. pre-commit Quality Gate Hook (Tests + 3-Zielgruppen-Doku)
|
||
4. Dokumentation in 3 Zielgruppen (USER / ADMIN / MAINTAINER) als Pflicht
|
||
|
||
---
|
||
|
||
## Verlauf
|
||
|
||
### Prompt 1
|
||
Ergänze Instruktionen:
|
||
- `/data/` für persistente Service-Daten (Unterordner pro Service, gitignored)
|
||
- `/history/` mit `prompts/` (vollständige Logs) und `summary/PROJECT_CONTEXT.md` (komprimierter Kontext)
|
||
- Git Hooks die Tests und Doku prüfen
|
||
- Doku immer in 3 Zielgruppen: Nutzer, Admin, Maintainer/Entwickler
|
||
|
||
### Antwort 1 (2026-05-30)
|
||
Implementiert:
|
||
- `git-templates/hooks/pre-commit` – Quality Gate prüft: Tests staged? Doku aktualisiert? Alle 3 Zielgruppen-Docs vorhanden?
|
||
- `git-templates/docs/USER.md`, `ADMIN.md`, `MAINTAINER.md` – Templates für neue Repos
|
||
- `git-templates/history/summary/PROJECT_CONTEXT.md` – Template Agent-Kontext-Summary
|
||
- `prompts/history.prompt.md` – `/history` Prompt zum Loggen + Summary aktualisieren
|
||
- `git-templates/.github/copilot-instructions.md` – erweitert um neue Konventionen + erweitertes DoD
|
||
- `scripts/copilot-bootstrap.sh` – erstellt data/, history/, docs/, Hook, .gitignore-Einträge
|
||
- `scripts/deploy.sh` + `deploy.fish` – deployen Hooks, Doc-Templates, History-Template
|
||
- `docs/ADMIN.md` – neu angelegt für dieses Repo
|
||
- `docs/USER.md`, `docs/MAINTAINER.md` – aktualisiert
|
||
- `README.md` – aktualisiert
|
||
- Commit `045e2e7`, Push zu `ssh://git@192.168.178.6:2222/cschulz/rd13_copilot_setup.git`
|
||
|
||
### Prompt 2
|
||
Push zu `ssh://git@192.168.178.6:2222/cschulz/rd13_copilot_setup.git`
|
||
|
||
### Antwort 2
|
||
Remote `origin` hinzugefügt, `git push -u origin master` – 51 Objekte übertragen.
|
||
|
||
### Prompt 3
|
||
`history/prompts/` soll NICHT gitignored sein – die vollständige History soll erhalten bleiben.
|
||
|
||
### Antwort 3 (2026-05-31)
|
||
Fix in allen Dateien: `history/prompts/` ist jetzt committed, nicht gitignored.
|
||
Nur `data/` bleibt gitignored.
|
||
Geänderte Dateien: `copilot-bootstrap.sh`, `copilot-instructions.md`, `PROJECT_CONTEXT.md` (template),
|
||
`MAINTAINER.md` (template), `history.prompt.md`, `USER.md`, `ADMIN.md`, `MAINTAINER.md`, `README.md`.
|
||
Commit `95d0360`, Push erfolgreich.
|
||
|
||
### Prompt 4
|
||
Prompts im Chat nicht sichtbar, PROJECT_CONTEXT.md nicht vorhanden.
|
||
|
||
### Antwort 4
|
||
- `deploy.fish` neu ausgeführt → `history.prompt.md` jetzt deployed (`/history` im Chat verfügbar)
|
||
- `copilot-bootstrap.sh .` auf das eigene Repo angewendet → `history/summary/PROJECT_CONTEXT.md` angelegt
|
||
- Bug fix: `mkdir -p .git/hooks/` vor Hook-Installation fehlte → behoben
|
||
- Commit `e1f912f`, Push erfolgreich.
|
||
|
||
### Prompt 5
|
||
History und Prompts werden nicht ins Repo geloggt – sollen aber geloggt werden.
|
||
|
||
### Antwort 5
|
||
Diese Datei wird angelegt + `PROJECT_CONTEXT.md` befüllt. Commit + Push.
|
||
|
||
---
|
||
|
||
## Ergebnis
|
||
|
||
Vollständig implementiertes Copilot-Setup mit:
|
||
- `/data/` Konvention (gitignored)
|
||
- `/history/` Konvention (committed)
|
||
- pre-commit Quality Gate
|
||
- 3-Zielgruppen-Dokumentation als Pflicht
|
||
- Bootstrap + Deploy-Skripte aktualisiert
|
||
- Dieses Repo selbst gebootstrapped
|
||
|
||
## Entscheidungen
|
||
|
||
| Entscheidung | Begründung |
|
||
|---|---|
|
||
| `history/prompts/` committed (nicht gitignored) | Vollständige lückenlose Projekt-History im Repo |
|
||
| `data/` gitignored | Persistente Service-Daten gehören nicht ins Git (Größe, Sicherheit) |
|
||
| pre-commit mit `--no-verify` Escape | Quality Gate ohne harten Block – bewusstes Bypass möglich |
|
||
| 3 Zielgruppen-Docs als DoD-Pflicht | Klare Trennung: Nutzer ≠ Ops ≠ Dev |
|
||
|
||
## Offene Punkte
|
||
|
||
- TODO-Felder in `.github/copilot-instructions.md` noch ausfüllen (Stack, Architecture, NFRs)
|
||
- `history/summary/PROJECT_CONTEXT.md` mit realem Projektinhalt befüllen
|