Skip to content

Die erste Stunde ​

Am Ende dieser Stunde steht eine Karte in Done: aus einer Idee gemacht, von dir freigegeben, in einer Sitzung mit /implement-next oder vom Runner ohne Sitzung umgesetzt, von einem zweiten Claude-Modell in frischer Sitzung geprüft und von dir durchgesehen. Die Stunde zählt ab einem Rechner mit macOS, Linux oder bereitstehendem WSL2. Unter Windows richtest du zuerst WSL2 nach Windows über WSL2 ein; das dauert samt Neustart etwa 30 Minuten.

Für wen das Kit nicht passt ​

  • Projekte ohne ausführbare Prüfung. Die Umsetzung committet nur nach einem grünen Prüflauf, und ohne Prüfung auf der Paketstufe startet der Runner nicht.
  • Teams ohne Claude Code. Die Skills sind für Claude Code geschrieben. Anweisungen für andere KI-Werkzeuge pflegst du selbst in deren Formaten.
  • Wer die drei Stop-Punkte abgeben will. Das GO, push main und merge production automatisiert das Kit absichtlich nicht. Dem Runner kannst du das GO höchstens vorab geben.

Voraussetzungen ​

  • macOS, Linux oder Windows mit WSL2
  • git, Node.js ab Version 18 und curl
  • Claude Code
  • ein Claude-Zugang, mit dem du dich anmeldest
  • deine git-Identität

Das lokale Board braucht kein weiteres Konto.

Die Schritte ​

1. Werkzeuge prüfen ​

Dauer: etwa 5 Minuten.

bash
git --version
node --version
claude --version

Gelungen, wenn jeder Befehl eine Versionsnummer ausgibt, node mindestens v18.

Sonst: Fehlt Node.js oder ist es älter, installiere es über nvm mit nvm install --lts. Fehlt Claude Code, installiere es mit npm install -g @anthropic-ai/claude-code. git kommt aus dem Paketmanager deines Systems.

2. Bei Claude anmelden ​

Dauer: etwa 3 Minuten.

Rufe claude auf, melde dich an und beende die Sitzung wieder. Dann:

bash
claude -p "Antworte nur mit OK"

Gelungen, wenn die Ausgabe OK ist.

Sonst: Rufe claude noch einmal auf und schließe die Anmeldung ab.

3. git-Identität setzen ​

Dauer: etwa 1 Minute.

bash
git config --global user.name "Dein Name"
git config --global user.email "du@example.org"

Gelungen, wenn git config user.email deine Adresse ausgibt.

Sonst: Gibt der Befehl nichts aus, wiederhole die zweite Zeile.

4. Projekt anlegen ​

Dauer: etwa 1 Minute.

bash
mkdir ~/erste-stunde && cd ~/erste-stunde && git init -b main

Gelungen, wenn git status den Zweig main nennt.

Sonst: Kennt git die Option -b nicht, ist es älter als 2.28. Aktualisiere git und rufe im Ordner git init -b main auf.

5. Kit installieren ​

Dauer: etwa 3 Minuten.

bash
curl -O https://docs.mwolff.org/install.mjs
node install.mjs

Der Installer fragt nacheinander; für die erste Stunde antwortest du so:

FrageAntwort
Sprachede
Skills global oder nur für dieses Projektprojekt
Code-Hostlocal
Issue-Trackerlocal
alle übrigen, auch das Commit-GateEnter

Was jede Frage bedeutet, steht unter Installation. Am Ende meldet der Installer ACHTUNG: Es liegen uncommittete Dateien im Workspace; das räumt Schritt 8 auf.

Gelungen, wenn ls .claude/kit unter anderem board.mjs zeigt.

Sonst: Prüfe die Netzverbindung und wiederhole den Schritt.

6. Das Board prüfen ​

Dauer: etwa 3 Minuten.

Mit der Antwort local beim Issue-Tracker entsteht das lokale Board; Spalten und Labels legst du nicht an. Jede Karte ist eine Datei unter issues/.

bash
node .claude/kit/board.mjs issue list

Hole und starte das Board-UI in einem zweiten Terminal, das bis Schritt 14 offen bleibt, und öffne http://localhost:3000:

bash
curl -o .claude/kit/board-ui.mjs https://docs.mwolff.org/board-ui.mjs
node .claude/kit/board-ui.mjs

Gelungen, wenn die Ausgabe [] ist und der Browser fünf leere Spalten von Backlog bis Done zeigt.

Sonst: Steht in .claude/workflow.config.json nicht "issueTracker": "local", wiederhole Schritt 5 und antworte beim Issue-Tracker local. Bricht das UI mit EADDRINUSE ab, starte es mit --port 3001.

7. Prüfkommando eintragen ​

Dauer: etwa 2 Minuten.

Die Umsetzung committet nur nach einem grünen Prüflauf. Ersetze in .claude/workflow.config.json die Zeile "buildChecks": [], durch:

json
"buildChecks": ["node --test"],

Dann:

bash
./checkrun.sh --stage push

Gelungen, wenn die Ausgabe die Zeile gelaufen: node --test → gruen enthält.

Sonst: Meldet das Kommando einen Fehler in der Config, vergleiche die Zeile Zeichen für Zeichen mit der oben.

8. Workspace sauber machen ​

Dauer: etwa 2 Minuten.

bash
git add -A
git commit -m "Kit eingerichtet"
git status --short

Gelungen, wenn git status --short nichts ausgibt.

Sonst: Fehlen beim Commit Name oder E-Mail, wiederhole Schritt 3. Nennt git status --short noch Dateien, wiederhole die ersten beiden Zeilen.

9. Idee anlegen ​

Dauer: etwa 1 Minute.

bash
node .claude/kit/board.mjs issue create --art idea --author-model mensch --title "Begrüßung als Funktion" --body 'Eine Datei gruss.mjs mit export function begruesse(name), die Hallo, <name>! zurückgibt, dazu ein Test mit node:test unter test/.'

Gelungen, wenn die Ausgabe eine id nennt, eine vierstellige Nummer; sie steht in den folgenden Befehlen für <id>.

Sonst: Meldet der Befehl Kein Autor-Modell angegeben, fehlt --author-model mensch.

10. Idee durchsprechen ​

Dauer: etwa 10 Minuten.

Starte im Projekt claude und rufe auf:

/triage <id>

/triage klärt offene Punkte mit dir und schlägt Bahn 3 vor, ein einzelnes Arbeitspaket. Bestätige; /task legt das Paket an. Beende die Sitzung.

Gelungen, wenn node .claude/kit/board.mjs issue list eine Karte mit [Task] im Titel und "status": "backlog" zeigt. Ab hier ist <id> ihre Nummer.

Sonst: Schlägt /triage eine andere Bahn vor, antworte, dass nichts abzuwägen ist, und wähle Bahn 3. Fehlt die Karte danach, rufe /task <id> mit der Nummer der Idee auf.

11. Karte freigeben ​

Dauer: etwa 1 Minute.

bash
node .claude/kit/board.mjs issue move <id> ready

Ziehe die Karte im UI nach Ready oder nimm den Befehl: dein GO.

Gelungen, wenn issue list die Karte mit "status": "ready" zeigt.

Sonst: Gibt es die Karte nicht, hast du die Nummer der Idee genommen; nimm die der [Task]-Karte.

12. Karte umsetzen ​

Dauer: etwa 15 Minuten, das meiste davon Warten.

Starte im Projekt claude und rufe auf:

/implement-next <id>

/implement-next setzt genau diese Karte um, prüft mit node --test und committet lokal. Im UI wandert die Karte nach In Review, sonst neu laden. Beende die Sitzung.

Gelungen, wenn issue list die Karte mit "status": "in_review" zeigt und git log --oneline oben einen neuen Commit trägt.

Sonst:

  • Issue #<id> liegt nicht (mehr) in Ready: zurück zu Schritt 11.
  • Endet die Sitzung ohne Commit, nennt sie den Grund; fehlt das Prüfkommando, zurück zu Schritt 7.

13. Ergebnis prüfen lassen ​

Dauer: etwa 5 Minuten.

Starte eine frische Sitzung mit claude und schreibe:

/kit-review Karte <id>

Ein zweites Claude-Modell liest die Änderung ohne Kenntnis der Umsetzung und schreibt seinen Befund an die Karte.

Gelungen, wenn node .claude/kit/board.mjs issue get <id> einen Kommentar mit ## Code-Review (Schritt 6) zeigt.

Sonst: Steht der Befund nur im Chat, nenne in derselben Sitzung noch einmal die Kartennummer.

14. Durchsehen und nach Done ziehen ​

Dauer: etwa 5 Minuten.

bash
git show --stat HEAD
node --test
node .claude/kit/board.mjs issue move <id> done

Lies den Befund und den Commit, dann ziehe die Karte im UI nach Done oder nimm den letzten Befehl: deine Abnahme.

Gelungen, wenn git show --stat HEAD gruss.mjs und eine Datei unter test/ nennt, node --test mit fail 0 endet und issue list die Karte mit "status": "done" zeigt.

Sonst: Ziehe nicht nach Done. Schreibe den Mangel mit issue comment <id> --text "…" an die Karte, ziehe sie nach ready und starte Schritt 12 erneut.

Runner starten ​

Statt Schritt 12 setzt der Runner die Karte ohne dich um, prüft und committet. Setze nach Schritt 11 das Label, das ihm die Karte erlaubt, und starte ihn:

bash
node .claude/kit/board.mjs issue label add <id> kit:nightrun
./runner.sh --dry-run
./runner.sh

Meldet der Trockenlauf -> Session 1, setzt der echte Lauf die Karte um und zieht sie nach In Review; weiter mit Schritt 13.

Wie es weitergeht ​

claude-workflow-kit — frei verfügbar