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 mainundmerge productionautomatisiert 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.
git --version
node --version
claude --versionGelungen, 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:
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.
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.
mkdir ~/erste-stunde && cd ~/erste-stunde && git init -b mainGelungen, 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.
curl -O https://docs.mwolff.org/install.mjs
node install.mjsDer Installer fragt nacheinander; für die erste Stunde antwortest du so:
| Frage | Antwort |
|---|---|
| Sprache | de |
| Skills global oder nur für dieses Projekt | projekt |
| Code-Host | local |
| Issue-Tracker | local |
| alle übrigen, auch das Commit-Gate | Enter |
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/.
node .claude/kit/board.mjs issue listHole und starte das Board-UI in einem zweiten Terminal, das bis Schritt 14 offen bleibt, und öffne http://localhost:3000:
curl -o .claude/kit/board-ui.mjs https://docs.mwolff.org/board-ui.mjs
node .claude/kit/board-ui.mjsGelungen, 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:
"buildChecks": ["node --test"],Dann:
./checkrun.sh --stage pushGelungen, 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.
git add -A
git commit -m "Kit eingerichtet"
git status --shortGelungen, 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.
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.
node .claude/kit/board.mjs issue move <id> readyZiehe 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.
git show --stat HEAD
node --test
node .claude/kit/board.mjs issue move <id> doneLies 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:
node .claude/kit/board.mjs issue label add <id> kit:nightrun
./runner.sh --dry-run
./runner.shMeldet der Trockenlauf -> Session 1, setzt der echte Lauf die Karte um und zieht sie nach In Review; weiter mit Schritt 13.
Wie es weitergeht
- Auf GitHub oder GitLab umsteigen: Issue-Tracker und Code-Host.
- Veröffentlichen mit
push mainundmerge production: Push und Merge. - Prüfer aus einer anderen Modellfamilie, Team-Einstellungen: Team-Config, Einstellungen.
- Jeden Commit an einen grünen Prüflauf binden: Das Commit-Gate.
- Das Kit im eigenen Projekt: Installation, ohne Remote Lokal arbeiten.
- Vorhaben mit Abwägung auf Bahn 2: Drei Bahnen.
- Was zu Pro gehört und wie du es bekommst: Pro.
- Der Runner mit Kette, mehreren Karten und ohne Aufsicht: Die Kette.
- Der Runner unter Windows: Windows über WSL2.
- Alle einundzwanzig Skills: Die Skills.