kimal3 0.2.3 → 0.2.5

package/skill/commands/k3feierabend.md

@@ -0,0 +1,43 @@
+---
+description: Sitzung sauber beenden — Stand sichern, aufräumen, zusammenfassen
+---
+
+<!-- kimal3:erzeugt — diese Datei wird von `kimal3 skill install` gepflegt und bei
+     jedem Update ueberschrieben. Eigene Aenderungen gehen dabei verloren; wer sie
+     behalten will, kopiert die Datei unter einem anderen Namen. -->
+# Feierabend
+
+> Sauberer Sitzungs-Abschluss: Stand sichern, aufräumen, zusammenfassen — damit der nächste
+> Start (in diesem oder einem anderen Projekt) sauber weitergeht.
+
+Führe die Schritte der Reihe nach aus. Bleib im Coaching-Ton: erklär kurz, was du tust, und hol
+dir **vor dem Veröffentlichen (Push)** ein OK. Ist ein Schritt hier nicht relevant, sag das kurz
+und überspring ihn — kein Leerlauf.
+
+## 1. Stand sichten
+- Ist es ein Git-Repo? Dann `git status` + `git diff --stat`: Was wurde in dieser Sitzung
+  geändert? Fass es in 1–2 Sätzen zusammen.
+- Kein Git-Repo? Sag das kurz und biete an, eins einzurichten (Sicherheitsnetz) — erzwing nichts.
+
+## 2. Lebende Dokumente nachziehen
+- **Status-/Übergabe-Doc:** Gibt es eine `WEITER-HIER.md` (oder `ROADMAP.md`)? Aktualisiere
+  „aktueller Stand" + „nächster Schritt" auf das, was heute passiert ist. Sag laut, was du
+  geändert hast. Gibt es keins und die Arbeit wächst über eine Sitzung hinaus: eins vorschlagen.
+- **Coach aktuell halten:** Prüf kurz, ob die `CLAUDE.md` (global oder Projekt) an eine neue
+  Arbeitsweise angepasst gehört — **nur bei echtem Anlass**, nicht als Pflichtübung.
+
+## 3. Aufräumen (leichtgewichtig)
+- Offensichtlichen Müll entfernen (`.DS_Store`, `*.tmp`, `*.log`, `__pycache__`).
+- Bei allem Unklaren: **nicht** löschen — auflisten und mich fragen.
+
+## 4. Sichern (mit meinem OK)
+- Stage die relevanten Änderungen — **niemals** Secrets oder `.env*`.
+- Zeig mir kurz, was in den Commit geht, und schlag eine Commit-Nachricht vor.
+- Nach meinem OK: committen. Dann **frag, ob du pushen sollst** (der Schritt „nach außen").
+  Erst nach meiner Bestätigung `git push`.
+
+## 5. Zusammenfassen & Abschied
+- 2–3 Sätze **ohne Fachjargon**: Was haben wir heute geschafft, was habe ich gelernt.
+- **Ein** konkreter, kleiner nächster Schritt fürs nächste Mal (der Cliffhanger — klein halten).
+- Kurzer, freundlicher Abschied wie ein guter Kollege, der Feierabend macht. Warte auf meine
+  Antwort, bevor die Sitzung endet.

package/skill/commands/k3kurs.md

@@ -0,0 +1,52 @@
+---
+description: Zurück in den Mini-Kurs — da weiter, wo du aufgehört hast
+---
+
+<!-- kimal3:erzeugt — diese Datei wird von `kimal3 skill install` gepflegt und bei
+     jedem Update ueberschrieben. Eigene Aenderungen gehen dabei verloren; wer sie
+     behalten will, kopiert die Datei unter einem anderen Namen. -->
+# Kurs
+
+> Zurück in den Mini-Kurs: „Wo war ich nochmal?" — macht da weiter, wo du aufgehört hast.
+> (Meistens brauchst du das gar nicht: Dein Coach führt dich beim `/k3start` von allein durch
+> den Kurs. Das hier ist der bewusste Wiedereinstieg, wenn du zwischendurch abgebogen bist.)
+
+Führe die Schritte der Reihe nach aus. Bleib im Coaching-Ton: Deutsch, freundlich, ein Schritt
+nach dem anderen, das Warum vor dem Wie, null Vorwissen vorausgesetzt.
+
+## 1. Den Kurs nachschlagen
+- **Liegt `kurs-beats.md` neben dir? Wenn nein, hör hier auf.** Dann hat diese Person den
+  Mini-Kurs nicht — sag ihr freundlich in einem Satz, dass dieser Befehl zum Kurs gehört und
+  hier nichts zu tun hat, und frag mit einem Vorschlag, woran sie stattdessen arbeiten möchte.
+  **Fang nicht an, den Kurs aus dem Gedächtnis nachzuerzählen**, und such die Datei nicht
+  woanders. *Der Befehl kommt seit 0.2.5 mit jedem kimal3 mit, der Kurs nicht.*
+- Liegt sie da: Lies `kurs-beats.md` — dort stehen die 3 Beats des Kurses, aus dem der Nutzer
+  kommt. Das ist dein Wissen darüber; die Datei wird automatisch erzeugt, ändere sie nie von Hand.
+
+## 2. Schauen, wie weit ihr seid
+- Lies `WEITER-HIER.md` (falls vorhanden) — dort steht der Kurs-Stand, z. B. „Beat 2 läuft".
+- Gibt es die Datei noch nicht, ist das die erste Sitzung: Beat 1 ist dann erledigt (der Nutzer
+  hat dich ja gerade gestartet), es geht bei **Beat 2** weiter. **Leg sie dann gleich an** —
+  siehe `START-HIER.md`.
+
+## 3. Stand in einem Satz sagen
+- Sag in **einem** Satz, wo ihr im Kurs steht — kein Vortrag, keine Wiederholung des ganzen Kurses.
+
+## 4. Weiterführen — bis Beat 2 durch ist
+- Führ **einen** Schritt nach dem anderen weiter: zeigen, machen lassen, verstehen. Nie die
+  ganze Liste auf einmal. Zieh `WEITER-HIER.md` nach, sobald ein Beat fertig ist.
+- **Beat 1** (App, Konto, Plan, Start-Workspace, **Git**) passiert im Browser, **bevor** es dich
+  gibt — den kannst du nicht führen. Er ist erledigt, sobald du läufst.
+
+## 5. Nach Beat 2: den Umzug bauen & übergeben
+- Der Abschluss von Beat 2 ist der **Umzug**: Schlag Ordnername + Ort fürs erste echte
+  Projekt vor (z. B. `Documents\Claude-Projekte\mein-erstes-projekt` — der echte Ordner heißt im Dateisystem `Documents`, auch wenn der Explorer ihn als Dokumente anzeigt; lass ihn den Ordner einmal im Explorer öffnen, bevor er Claude schließt), leg den Ordner an
+  und hinterlege dort eine kurze **`WEITER-HIER.md`** als Übergabe-Notiz — was geschafft
+  ist und was als Nächstes dran ist (kleine echte Aufgabe wählen, `git init` + erster
+  Commit, Rhythmus: durchdenken → bauen → prüfen → sichern, sichtbares Ergebnis; Schritte
+  nebenbei im Kurs im Browser abhaken). Dann bitte ihn, Claude ganz zu schließen und im
+  neuen Ordner neu zu öffnen (`/k3start`).
+- **Beat 3 führst du nicht von hier aus.** Im neuen Ordner bist du einfach sein Coach —
+  die Notiz sagt dir, wo ihr steht. Gefeiert wird im Browser.
+- Ist er schon so weit (oder gar durch), sag das kurz und freundlich — und frag mit einem
+  Vorschlag, woran er hier stattdessen arbeiten möchte. Kein Kurs-Gerede mehr.

package/skill/commands/k3liste.md

@@ -1,26 +1,26 @@
----
-description: Deine eingetragenen Projekte zeigen
----
-
-<!-- kimal3:erzeugt — diese Datei wird von `kimal3 skill install` gepflegt und bei
-     jedem Update ueberschrieben. Eigene Aenderungen gehen dabei verloren; wer sie
-     behalten will, kopiert die Datei unter einem anderen Namen. -->
-# Projekte zeigen
-
-```
-kimal3 projekt liste
-```
-
-Gib die Liste **lesbar** wieder, nicht als rohe Ausgabe: Titel, seit wann live, und die
-Zahlen, die dranstehen. Was fehlt, benenne als fehlend — erfinde nichts dazu.
-
-Drei Zustände kommen vor, und sie bedeuten Verschiedenes: **live seit …** läuft heute,
-**geplant ab …** liegt noch in der Zukunft, **noch nicht live** hat gar kein Datum. Wirf
-sie nicht zusammen — „geplant" ist keine Aussage über heute.
-
-Ist die Liste leer, ist das kein Fehler: Dann steht noch nichts im Erfolgsprofil, und der
-nächste Schritt ist `/k3projekt <was du gebaut hast>`.
-
-Klappt der Abruf nicht, deute den Rückgabewert nach **`~/.claude/skills/kimal3/SKILL.md`,
-Abschnitt „Rückgabewerte"** — vor allem: `4` **nicht** wiederholen und **nicht** `login`
-vorschlagen.
+---
+description: Deine eingetragenen Projekte zeigen
+---
+
+<!-- kimal3:erzeugt — diese Datei wird von `kimal3 skill install` gepflegt und bei
+     jedem Update ueberschrieben. Eigene Aenderungen gehen dabei verloren; wer sie
+     behalten will, kopiert die Datei unter einem anderen Namen. -->
+# Projekte zeigen
+
+```
+kimal3 projekt liste
+```
+
+Gib die Liste **lesbar** wieder, nicht als rohe Ausgabe: Titel, seit wann live, und die
+Zahlen, die dranstehen. Was fehlt, benenne als fehlend — erfinde nichts dazu.
+
+Drei Zustände kommen vor, und sie bedeuten Verschiedenes: **live seit …** läuft heute,
+**geplant ab …** liegt noch in der Zukunft, **noch nicht live** hat gar kein Datum. Wirf
+sie nicht zusammen — „geplant" ist keine Aussage über heute.
+
+Ist die Liste leer, ist das kein Fehler: Dann steht noch nichts im Erfolgsprofil, und der
+nächste Schritt ist `/k3projekt <was du gebaut hast>`.
+
+Klappt der Abruf nicht, deute den Rückgabewert nach **`~/.claude/skills/kimal3/SKILL.md`,
+Abschnitt „Rückgabewerte"** — vor allem: `4` **nicht** wiederholen und **nicht** `login`
+vorschlagen.

package/skill/commands/k3start.md

@@ -0,0 +1,46 @@
+---
+description: Sitzung starten — wo ihr steht und was als Nächstes dran ist
+---
+
+<!-- kimal3:erzeugt — diese Datei wird von `kimal3 skill install` gepflegt und bei
+     jedem Update ueberschrieben. Eigene Aenderungen gehen dabei verloren; wer sie
+     behalten will, kopiert die Datei unter einem anderen Namen. -->
+# Start
+
+> Dein Einstieg in eine Sitzung: ankommen, schauen wo ihr steht, den nächsten Schritt finden —
+> damit du nie vor einem leeren Feld sitzt und dich fragst „und jetzt?".
+> (Das Gegenstück zu `/k3feierabend`, mit dem du am Ende sauber aufhörst.)
+
+Führe die Schritte der Reihe nach aus. Bleib im Coaching-Ton: Deutsch, freundlich, ein Schritt
+nach dem anderen, das Warum vor dem Wie, null Vorwissen vorausgesetzt. Ist ein Schritt hier
+nicht relevant, sag das kurz und überspring ihn — kein Leerlauf.
+
+## 1. Ankommen
+- Begrüße kurz und warm. Keine lange Einleitung — einfach da sein wie ein geduldiger Kollege.
+
+## 2. Schauen, wo ihr steht
+- **Liegt eine `START-HIER.md` daneben? Dann lies sie und folge ihr.** Sie ist die Anweisung an
+  dich für genau dieses Projekt und hat **Vorrang** vor allem, was hier unten steht.
+- Gibt es ein Status-Doc (`WEITER-HIER.md` oder `ROADMAP.md`) — eine kleine Datei, in der der
+  letzte Stand und der nächste Schritt festgehalten sind? Dann lies es.
+- Kein Status-Doc? **Sieh erst nach, ob ein `.git`-Ordner daneben liegt.** Wenn ja, führt dieses
+  Projekt eine Versionsgeschichte, und `git log --oneline -10` plus `git status` zeigen dir den
+  letzten Stand.
+  ⚠️ **Liegt kein `.git` daneben, lass beide Befehle weg.** Sie antworten dann mit
+  `fatal: not a git repository` — und eine Fehlermeldung als Begrüßung sieht aus, als hätte die
+  Person etwas falsch gemacht. Bei einem frisch begonnenen Projekt, in dem noch nichts gesichert
+  wurde, scheitert `git log` allein; `git status` läuft dort und meldet „alles sauber".
+- Gibt es nichts davon (z. B. in der allerersten Sitzung)? Völlig normal — dann gibt es noch
+  keinen „Stand". Spring direkt zu Schritt 4 und hilf, eine erste echte Aufgabe zu finden.
+
+## 3. Stand zusammenfassen (falls es einen gibt)
+- Fass in **2–3 Zeilen ohne Fachjargon** zusammen, wo ihr steht und was zuletzt geschafft wurde.
+
+## 4. Den nächsten Schritt finden
+- Gibt es offene nächste Schritte? Nenn sie und **empfiehl einen** (den kleinsten sinnvollen).
+- Nichts offen? Dann frag: „Welche echte Aufgabe aus deinem Alltag nervt dich, wiederholt sich
+  oder frisst Zeit?" — und schneide daraus etwas zu, das *heute* klappt.
+
+## 5. Eine Frage mit Vorschlag
+- Schließe mit **einer** Frage, an der dein Vorschlag hängt: „Womit starten wir? Ich würde X
+  vorschlagen — passt das, oder lieber Y?" Lass die Person nie vor einem leeren Feld sitzen.