# GSD mit GitHub Copilot in VS Code nutzen Diese Anleitung beschreibt, wie **GSD** installiert und mit **GitHub Copilot Chat in VS Code** genutzt wird. Die Installation wird als **root** ausgeführt. --- ## 1. Was ist GSD? **GSD** steht für *Get Shit Done*. Es ist ein Workflow-System für KI-gestützte Entwicklung. GSD ergänzt Tools wie GitHub Copilot Chat, Claude Code, Codex, Cursor oder ähnliche Coding-Assistenten um strukturierte Abläufe. Ohne GSD arbeitet ein KI-Chat oft sehr frei: Man beschreibt ein Problem, bekommt Code zurück, testet etwas, korrigiert wieder, verliert Kontext und irgendwann weiß niemand mehr genau, was eigentlich gebaut werden sollte. Willkommen in der modernen Softwareentwicklung, jetzt mit noch mehr Chatfenstern. GSD soll genau dieses Problem lösen. Es zwingt die KI in einen klareren Ablauf: - Projekt oder Codebasis analysieren - Ziele und Anforderungen erfassen - Arbeit in Phasen zerlegen - Aufgaben planen - Änderungen schrittweise umsetzen - Ergebnisse prüfen - Fortschritt dokumentieren Das Ziel ist nicht, dass die KI einfach wild Dateien ändert. Das Ziel ist ein nachvollziehbarer Entwicklungsprozess mit Planung, Status, Aufgaben und Prüfung. --- ## 2. Welches Problem löst GSD? GSD hilft besonders bei diesen typischen Problemen: - **Kontextverlust:** Die KI vergisst nach längeren Chats, worum es eigentlich ging. - **Planloses Coden:** Änderungen werden gemacht, ohne dass vorher klar ist, was genau erreicht werden soll. - **Zu große Aufgaben:** Ein Feature wird nicht in kleine, prüfbare Schritte zerlegt. - **Fehlende Nachvollziehbarkeit:** Es ist später unklar, warum eine Änderung gemacht wurde. - **Schlechte Verifikation:** Code wird erzeugt, aber nicht sauber geprüft. GSD arbeitet deshalb mit Kommandos wie `/gsd-new-project`, `/gsd-discuss-phase`, `/gsd-plan-phase`, `/gsd-execute-phase` und `/gsd-verify-work`. --- ## 3. Voraussetzungen Für die Installation werden benötigt: - Debian oder ein ähnliches Linux-System - Root-Zugriff - Git - Node.js 22 oder neuer - npm - VS Code mit GitHub Copilot Chat Die folgenden Befehle werden als **root** ausgeführt. --- ## 4. Node.js und npm installieren Zuerst werden die benötigten Pakete installiert: ``` apt-get update apt-get install -y ca-certificates curl gnupg ``` Danach wird Node.js 22 eingerichtet: ``` curl -fsSL https://deb.nodesource.com/setup_22.x -o nodesource_setup.sh bash nodesource_setup.sh apt-get install -y nodejs ``` Anschließend prüfen: ``` node --version npm --version npx --version git --version ``` Erwartet wird ungefähr: ``` node: Version 22 oder neuer npm: Version 10 oder neuer git: installiert ``` --- ## 5. GSD global installieren Damit die GSD-Hilfsprogramme dauerhaft verfügbar sind, wird GSD global installiert: ``` npm install -g @opengsd/get-shit-done-redux@latest ``` Danach prüfen: ``` which get-shit-done-redux which gsd-sdk gsd-sdk --help ``` Wichtig ist, dass `gsd-sdk` gefunden wird. Einige GSD-Workflows verwenden dieses Hilfsprogramm intern. --- ## 6. GSD in einem Projekt installieren Nun in den gewünschten Projektordner wechseln: ``` cd /pfad/zum/projekt ``` Danach prüfen, ob es sich um ein Git-Projekt handelt: ``` git status ``` Anschließend GSD für GitHub Copilot lokal im Projekt installieren: ``` get-shit-done-redux --copilot --local --profile=core ``` Dadurch wird im Projekt ein Verzeichnis `.github` angelegt. Darin liegen unter anderem: - `.github/copilot-instructions.md` - `.github/skills/` - `.github/get-shit-done/` - `.github/gsd-file-manifest.json` - `.github/gsd-install-state.json` Installation prüfen: ``` ls -la .github find .github -maxdepth 3 -type f | sort ``` --- ## 7. GSD-Dateien ins Git übernehmen Wenn GSD dauerhaft Teil des Projekts sein soll, sollten die GSD-Dateien committed werden: ``` git status git add .github git commit -m "Add GSD Copilot workflow configuration" ``` Danach sind die Copilot-Anweisungen und GSD-Skills im Repository versioniert. Das ist sinnvoll, damit alle Beteiligten mit denselben KI-Regeln arbeiten. --- ## 8. GSD in VS Code testen Das Projekt in VS Code öffnen. Danach GitHub Copilot Chat öffnen und folgenden Befehl senden: ``` /gsd-help ``` Wenn GSD korrekt erkannt wird, zeigt Copilot eine Übersicht der verfügbaren GSD-Kommandos an. Für ein bestehendes Projekt ist danach dieser Befehl sinnvoll: ``` /gsd-map-codebase ``` Damit analysiert GSD die vorhandene Codebasis und kann spätere Aufgaben besser einordnen. --- ## 9. GSD für ein neues Projekt nutzen Für ein neues Projekt wird zuerst ein leerer oder vorbereiteter Projektordner angelegt und als Git-Repository initialisiert: ``` mkdir mein-neues-projekt cd mein-neues-projekt git init ``` Danach GSD im Projekt installieren: ``` get-shit-done-redux --copilot --local --profile=core ``` Danach das Projekt in VS Code öffnen und in Copilot Chat starten mit: ``` /gsd-new-project ``` GSD fragt dann nach Ziel, Umfang, Anforderungen und gewünschter Struktur. Daraus erstellt es eine Projektbasis mit Planungsdokumenten und nächsten Arbeitsschritten. --- ## 10. Typischer Workflow mit GSD Ein normaler GSD-Ablauf sieht so aus: 1. Projekt oder Feature beschreiben 2. Phase besprechen 3. Phase planen 4. Phase umsetzen lassen 5. Ergebnis prüfen 6. Fortschritt committen 7. Nächste Phase bearbeiten ### 10.1 Projektstatus anzeigen ``` /gsd-progress ``` Zeigt, wo das Projekt steht und welche nächsten Schritte sinnvoll sind. ### 10.2 Eine Phase besprechen ``` /gsd-discuss-phase 1 ``` Dieser Schritt dient dazu, Ziel, Annahmen, Risiken und offene Fragen der Phase zu klären. ### 10.3 Eine Phase planen ``` /gsd-plan-phase 1 ``` GSD erstellt daraus einen konkreten Plan. Dieser Plan sollte geprüft werden, bevor die KI Änderungen am Projekt macht. ### 10.4 Eine Phase ausführen ``` /gsd-execute-phase 1 ``` GSD setzt die geplanten Aufgaben um. Danach sollte immer geprüft werden, welche Dateien geändert wurden. ``` git status git diff ``` ### 10.5 Arbeit prüfen ``` /gsd-verify-work 1 ``` Dieser Schritt prüft, ob die Phase wirklich abgeschlossen ist. Das ist wichtig, weil „Code wurde erzeugt“ nicht automatisch bedeutet, dass „Code funktioniert“. Eine Erkenntnis, für die die Menschheit offenbar erst KI gebraucht hat. --- ## 11. Todos mit GSD erstellen Kleine Aufgaben, Ideen oder Backlog-Einträge können mit GSD erfasst werden. Beispiel: ``` /gsd-capture Todo: Login-Seite validieren und Fehlermeldungen verbessern ``` Weitere Beispiele: ``` /gsd-capture Idee: Statusseite für VPN-Verbindungen ergänzen ``` ``` /gsd-capture Bug: Formular speichert leere Werte ohne Fehlermeldung ``` ``` /gsd-capture Backlog: Exportfunktion für Konfigurationsdaten ergänzen ``` Danach kann mit folgendem Befehl geprüft werden, was als Nächstes ansteht: ``` /gsd-progress ``` --- ## 12. Todos abarbeiten lassen Für kleine, klar begrenzte Aufgaben kann `/gsd-quick` genutzt werden: ``` /gsd-quick Setze den offenen Todo "Login-Seite validieren und Fehlermeldungen verbessern" um. ``` Für sehr kleine Änderungen eignet sich `/gsd-fast`: ``` /gsd-fast "Korrigiere den Tippfehler in der Überschrift der Startseite." ``` Für größere Aufgaben sollte eine eigene Phase genutzt werden: ``` /gsd-discuss-phase 2 /gsd-plan-phase 2 /gsd-execute-phase 2 /gsd-verify-work 2 ``` Nach jeder Umsetzung prüfen: ``` git status git diff ``` Wenn die Änderungen passen: ``` git add . git commit -m "Implement planned GSD changes" ``` --- ## 13. Sichere Arbeitsweise GSD ist hilfreich, aber es bleibt ein KI-gestütztes Werkzeug. Deshalb sollte man es wie einen sehr schnellen Junior-Entwickler behandeln: produktiv, motiviert und gelegentlich komplett überzeugt von Unsinn. Empfohlene Regeln: - Vor jeder größeren Aufgabe erst planen lassen. - Vor Änderungen immer klären, welche Dateien betroffen sind. - Nach Änderungen immer `git status` und `git diff` prüfen. - Nicht blind committen. - Keine sensiblen Zugangsdaten in Prompts schreiben. - Große Aufgaben in kleine Phasen zerlegen. - Tests ausführen, wenn das Projekt Tests besitzt. --- ## 14. Nützliche GSD-Kommandos
KommandoZweck
`/gsd-help`Zeigt die GSD-Hilfe an.
`/gsd-map-codebase`Analysiert eine bestehende Codebasis.
`/gsd-new-project`Startet einen neuen GSD-Projektworkflow.
`/gsd-progress`Zeigt aktuellen Stand und nächste Schritte.
`/gsd-capture`Speichert Ideen, Todos, Bugs oder Backlog-Einträge.
`/gsd-discuss-phase `Bespricht Ziel und Rahmen einer Phase.
`/gsd-plan-phase `Erstellt einen konkreten Plan für eine Phase.
`/gsd-execute-phase `Setzt eine geplante Phase um.
`/gsd-verify-work `Prüft, ob die Arbeit korrekt abgeschlossen wurde.
`/gsd-quick`Bearbeitet eine kleine Aufgabe mit GSD-Struktur.
`/gsd-fast`Bearbeitet eine sehr kleine Änderung direkt.
--- ## 15. Beispiel: Kompletter Ablauf Beispiel für ein neues Feature: ``` /gsd-capture Todo: Benutzerrollen im Adminbereich verbessern ``` ``` /gsd-progress ``` ``` /gsd-discuss-phase 1 ``` ``` /gsd-plan-phase 1 ``` ``` /gsd-execute-phase 1 ``` ``` /gsd-verify-work 1 ``` Danach im Terminal prüfen: ``` git status git diff ``` Wenn alles passt: ``` git add . git commit -m "Improve admin user roles" ``` --- ## 16. Zusammenfassung GSD macht aus einem freien KI-Chat einen strukturierteren Entwicklungsprozess. Es hilft dabei, Anforderungen, Planung, Umsetzung, Todos und Prüfung sauberer zu organisieren. Der wichtigste Start für bestehende Projekte: ``` /gsd-map-codebase /gsd-progress ``` Der wichtigste Start für neue Projekte: ``` /gsd-new-project ``` Der wichtigste Sicherheitsgriff bleibt trotzdem: ``` git status git diff ``` Denn auch mit GSD gilt: Vertrauen ist gut, Versionskontrolle ist besser.