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
93 lines
5.1 KiB
Markdown
93 lines
5.1 KiB
Markdown
# PROJECT_CONTEXT – rd13_copilot_setup
|
||
|
||
> Diese Datei ist der **persistente Gedächtnis-Speicher** für alle Agenten.
|
||
> Beim Start jeder neuen Agent-Session: **diese Datei zuerst lesen**.
|
||
> Nach Abschluss einer Aufgabe: **diesen Stand aktualisieren**.
|
||
|
||
---
|
||
|
||
## Aktueller Projektstatus
|
||
|
||
**Letzte Aktualisierung:** 2026-06-02 – Review-Findings behoben (7 Punkte)
|
||
**Phase:** Produktion / stabil – wird bei Bedarf erweitert
|
||
|
||
---
|
||
|
||
## Was ist dieses Projekt?
|
||
|
||
Portierbare GitHub Copilot Workspace-Konfiguration. Einmal eingerichtet, stattet es
|
||
jedes neue oder bestehende Git-Repo automatisch mit Copilot-Instruktionen, VS Code-
|
||
Einstellungen, Dokumentations-Templates, Agent-History-Struktur und einem pre-commit
|
||
Quality Gate aus.
|
||
|
||
**Stack:** Shell (POSIX sh + fish), Markdown
|
||
**Deployment:** `bash scripts/deploy.sh` oder `fish scripts/deploy.fish` auf jedem neuen System
|
||
|
||
---
|
||
|
||
## Erledigte Aufgaben (neueste zuerst)
|
||
|
||
| Datum | Aufgabe | Ergebnis | Entscheidungen |
|
||
|---|---|---|---|
|
||
| 2026-06-02 | Review-Findings behoben (7 Punkte) | `git-templates/hooks/pre-commit`, `.copilot-no-docs`, beide `copilot-instructions.md`, `prompts/history.prompt.md`, `scripts/copilot-bootstrap.sh` | `.copilot-no-docs` Opt-out analog zu `.copilot-no-tests`; history.prompt.md Append-Verhalten korrekt dokumentiert |
|
||
| 2026-06-02 | copilot-update.sh + git alias + post-merge Hook | `scripts/copilot-update.sh`, `scripts/copilot-update.fish`, `git-templates/hooks/post-merge` | SSH+HTTP-Fallback; opt-in Update-Hook; copilot-instructions.md nur bei TODO überschreiben |
|
||
| 2026-05-31 | Bug fix: mkdir -p .git/hooks + eigenes Repo bootstrapped | `e1f912f` | – |
|
||
| 2026-05-31 | history/prompts/ committed statt gitignored | `95d0360` | Vollständige History bleibt im Repo |
|
||
| 2026-05-30 | Initiale Erweiterungen: data/, history/, hooks, 3-Zielgruppen-Docs | `045e2e7` | Nur data/ gitignored |
|
||
| 2026-05-30 | Remote origin gesetzt + initial push | `ssh://git@192.168.178.6:2222/cschulz/rd13_copilot_setup.git` | – |
|
||
|
||
---
|
||
|
||
## Offene Aufgaben & bekannte Probleme
|
||
|
||
- [ ] `.github/copilot-instructions.md` TODO-Felder ausfüllen (Stack, Architecture, NFRs dieses Repos)
|
||
- [ ] Bei Änderungen an `git-templates/` immer `deploy.sh` neu ausführen (oder `git copilot-update` in einem anderen Repo zum Testen)
|
||
|
||
---
|
||
|
||
## Kritische Architekturentscheidungen
|
||
|
||
| Entscheidung | Begründung | Wo dokumentiert |
|
||
|---|---|---|
|
||
| `copilot-update.sh` mit SSH+HTTP-Fallback | Funktioniert ohne SSH-Key-Setup auf neuen Maschinen | `scripts/copilot-update.sh` |
|
||
| `copilot-instructions.md` nur bei TODO überschreiben | User-Content bleibt erhalten; Backup `.bak` wird erstellt | `scripts/copilot-update.sh` |
|
||
| post-merge Hook in bootstrapped Repos: opt-in | Kein Overhead bei jedem `git pull` in anderen Repos | `scripts/copilot-bootstrap.sh --with-update-hook` |
|
||
| Setup-Repo selbst: post-merge Hook auto-installed | `deploy.sh` nach jedem `git pull` auf Setup-Repo | `scripts/deploy.sh` Block 7 |
|
||
| `history/prompts/` committed | Lückenlose Projekt-History im Repo | `docs/MAINTAINER.md` |
|
||
| `data/` gitignored | Persistente Daten: Größe + Sicherheit | `docs/ADMIN.md` |
|
||
| POSIX sh für Bootstrap | Läuft überall ohne Abhängigkeiten | `docs/MAINTAINER.md` |
|
||
| Git-Alias statt Fish-Wrapper | Portabel: bash, sh, CI, GUI-Clients | `docs/MAINTAINER.md` |
|
||
| `.copilot-no-tests` + `.copilot-no-docs` Opt-outs | Pre-commit Check 1 (Tests) und Check 2 (Doku) deaktivierbar für Repos ohne Framework/Doku-Pflicht | `git-templates/hooks/pre-commit` |
|
||
| Kein `--no-verify` nirgendwo | Quality Gate darf nie umgangen werden; in `copilot-instructions.md` verboten, pre-commit enthält keinen Bypass-Hinweis | `git-templates/hooks/pre-commit`, `.github/copilot-instructions.md` |
|
||
|
||
---
|
||
|
||
## Wichtige Pfade & Konventionen
|
||
|
||
- **Persistente Daten:** `/data/` (gitignored, nie committen!)
|
||
- **Agent-Logs (voll):** `/history/prompts/` (committed – vollständige History bleibt erhalten)
|
||
- **Dieser Kontext:** `/history/summary/PROJECT_CONTEXT.md` (committed)
|
||
- **Deploy:** `bash scripts/deploy.sh` oder `fish scripts/deploy.fish`
|
||
- **Bootstrap einzelnes Repo:** `sh ~/.local/bin/copilot-bootstrap.sh [/pfad/zum/repo]`
|
||
- **Bootstrap mit Auto-Update-Hook:** `sh ~/.local/bin/copilot-bootstrap.sh --with-update-hook [/pfad]`
|
||
- **Templates updaten (global + repo-lokal):** `git copilot-update` (in jedem Repo)
|
||
- **Setup-Repo Cache:** `~/.copilot-setup/` (überschreibbar mit `COPILOT_SETUP_DIR=...`)
|
||
- **Git-Templates:** `~/.git-templates/` (nach Deploy)
|
||
- **Prompts:** `~/.vscode-server/data/User/prompts/` (nach Deploy)
|
||
|
||
---
|
||
|
||
## Für den nächsten Agenten: Startpunkt
|
||
|
||
1. Diese Datei gelesen? Gut – du kennst den Stand.
|
||
2. Neues Feature → `git-templates/` anpassen → `deploy.sh` ausführen → committen
|
||
3. Nach jeder Session: `history/prompts/YYYY-MM-DD_beschreibung.md` anlegen + diese Datei aktualisieren
|
||
|
||
---
|
||
|
||
## Bekannte Fallstricke / "Don't do this"
|
||
|
||
- `deploy.sh` nach jeder Änderung an `git-templates/` neu ausführen – sonst sind die lokalen Templates veraltet
|
||
- Beim Bootstrap neuer Repos ohne `hooks/`-Verzeichnis: `mkdir -p .git/hooks/` ist jetzt im Script (war Bug)
|
||
- `deploy.sh` skippt vorhandene Prompt-Dateien – neue Prompts werden aber korrekt hinzugefügt
|
||
|