92 lines
3.8 KiB
Markdown
92 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
|