cschulz/rd13_copilot_setup
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
rd13_copilot_setup/history/summary/PROJECT_CONTEXT.md
Conrad Schulz d31db9086f fix: alle --no-verify Referenzen entfernt + pre-commit Nummerierung 
- docs/USER.md: --no-verify FAQ-Hinweis durch .copilot-no-tests/.copilot-no-docs ersetzt
- docs/ADMIN.md: Hook-pro-Commit-Deaktivierung und Troubleshooting-Eintrag bereinigt
- docs/MAINTAINER.md: Escape-Valve Formulierung durch Opt-out Beschreibung ersetzt
- copilot-instructions.md (beide): DoD 'oder Bypass bewusst begruendet' entfernt
- pre-commit: Check-Nummerierung [1/3]+[2/3] -> [1/4]+[2/4]
2026-06-02 17:38:34 +00:00

5.4 KiB
Raw Blame History

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 – Konsistenzprüfung: alle --no-verify Referenzen entfernt 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 Konsistenzprüfung: alle --no-verify Referenzen entfernt docs/USER.md, docs/ADMIN.md, docs/MAINTAINER.md, beide copilot-instructions.md, pre-commit Check-Nummerierung [1/3]→[1/4] Opt-outs (.copilot-no-tests/.copilot-no-docs) als Ersatz für --no-verify in Doku
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