kimal3 0.2.10 → 0.3.1

package/skill/commands/k3feierabend.md

@@ -1,97 +1,99 @@
----
-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. Status-Datei nachziehen — und aufräumen
-Die Status-Datei (`WEITER-HIER.md` oder `ROADMAP.md`) ist der Zettel für den nächsten Start. Sie
-taugt nur, solange man sie in einem Atemzug lesen kann. **Jeder Feierabend schreibt etwas dazu —
-also muss auch jeder Feierabend etwas wegräumen**, sonst wächst sie, bis niemand sie mehr liest.
-
-Gibt es keine Status-Datei und die Arbeit wächst über eine Sitzung hinaus: eine vorschlagen,
-dann weiter mit Schritt 3.
-
-1. **Nachziehen:** „Wo wir stehen" und „nächster Schritt" auf das setzen, was heute passiert ist.
-2. **Wegräumen, was nicht mehr gilt.** Ins Archiv wandert:
-   - was **erledigt** ist (fertige Aufgaben, abgehakte Punkte),
-   - die Geschichten **früherer Sitzungen** („Davor …", „Stand vom …") — in „Wo wir stehen" bleibt
-     nur der heutige Stand,
-   - was im Text **widerlegt oder überholt** ist.
-   Was bleibt: der aktuelle Stand, der nächste Schritt, die offenen Punkte, und je Idee für später
-   **höchstens zwei Sätze** — Ausführliches bekommt eine eigene Datei, die Status-Datei verlinkt sie.
-3. **Ins Archiv heißt: verschieben, nicht löschen.** Gibt es schon ein Archiv (steht meist im Kopf
-   der Status-Datei), dorthin; sonst `WEITER-HIER-archiv.md` daneben anlegen. Unten anhängen, mit
-   dem heutigen Datum als Überschrift, **im Wortlaut** — das Warum früherer Entscheidungen soll
-   auffindbar bleiben.
-4. **Messen statt schätzen:** Zeilen der Status-Datei **vorher und nachher zählen**. Steht in ihrem
-   Kopf eine Zielgröße, gilt die, sonst **150 Zeilen**. Liegt sie danach noch drüber, weiter
-   wegräumen — oder sag laut, warum der Rest bleiben muss. Prüf danach im Archiv nach, dass das
-   Verschobene wirklich dort steht (eine Zeile daraus suchen), bevor du es als erledigt meldest.
-5. **Sag laut, was du geändert hast:** was neu drinsteht, was ins Archiv ging, Zeilen vorher → nachher.
-
-## 3. Gelernte Regeln — gehört etwas festgehalten?
-**Nur bei echtem Anlass**, nicht als Pflichtübung. Ein Anlass ist: Ich habe dich heute korrigiert,
-eine Arbeitsweise ausdrücklich gewollt, oder dieselbe Art Frage zum dritten Mal gleich beantwortet.
-Kein Anlass? Sag das in einem Halbsatz und geh weiter.
-
-Gibt es einen, **schlag die Regel vor** — ein Satz, was du künftig anders machst, dazu Datum und
-Anlass in einem Satz — und trag sie erst nach meinem OK ein. Wohin, hängt davon ab, was sie ist:
-
-| Was ist es? | Wohin |
-|---|---|
-| **Eine Arbeitsregel** — wie du arbeiten, fragen, prüfen, erklären sollst | `~/.claude/rules/kimal3-coach.md`, **unten** im Abschnitt „Gelernte Regeln" (neueste unten) |
-| **Etwas über mich** — wer ich bin, meine Rollen, meine Werkzeuge | meine `~/.claude/CLAUDE.md` |
-| **Etwas über dieses Projekt** — Aufbau, Werkzeuge, Fallen | die `CLAUDE.md` im Projektordner |
-
-🔬 **Vorher nachsehen, ob es die Regel schon gibt** — im Coach und in den CLAUDE.md-Dateien. Steht
-sie schon da, trag sie **nicht** doppelt ein: Sag mir, wo sie steht und dass sie heute nicht
-gegriffen hat. Eine Regel, die zweimal dasteht, wird nicht besser befolgt.
-⚠️ **Gibt es `~/.claude/rules/kimal3-coach.md` nicht**, kommt auch eine Arbeitsregel in meine
-`~/.claude/CLAUDE.md`. Leg die Coach-Datei **nicht** selbst an — sie gehört kimal3.
-🔴 **Im Coach änderst du NUR den Abschnitt „Gelernte Regeln"** und schreibst nur unten dazu. Alles
-darüber ist die Vorlage von kimal3 — dort änderst du nichts.
-
-Sag danach laut, **welcher Satz in welcher Datei** steht (vollständiger Pfad). Der Ordner
-`~/.claude` ist meist kein Git-Repo — die Datei ist dann nicht über Git gesichert; sag das dazu.
-
-## 4. Projekt aufräumen (leichtgewichtig)
-- Offensichtlichen Müll entfernen (`.DS_Store`, `*.tmp`, `*.log`, `__pycache__`).
-- Bei allem Unklaren: **nicht** löschen — auflisten und mich fragen.
-
-## 5. Sichern (mit meinem OK)
-- Stage die relevanten Änderungen **Datei für Datei** — **niemals** Secrets oder `.env*`, und kein
-  `git add -A`, das fremde Arbeit mitnimmt.
-- Zeig mir kurz, was in den Commit geht — **und was bewusst draußen bleibt**: Dateien, die Git noch
-  nicht kennt und die nicht aus dieser Sitzung stammen, stehen mit Namen und einem Satz, was sie
-  sind, in derselben Liste. (Sie kommen oft aus einer anderen Sitzung und fallen sonst niemandem
-  auf.) Mein OK zum Commit gilt für die ganze Liste; will ich eine davon doch dabeihaben, sage ich es.
-- Schlag eine Commit-Nachricht vor.
-- Nach meinem OK: committen.
-- **Pushen, je nach Projekt:** Prüf mit `git remote`, ob es überhaupt ein Ziel gibt.
-  - Kein Ziel: sag das kurz — der Commit ist dann die Sicherung, fertig.
-  - Ein Ziel: **frag, ob du pushen sollst** (der Schritt „nach außen"). Steht in der
-    Projekt-`CLAUDE.md`, dass ein Push etwas auslöst (zum Beispiel die Live-Seite neu ausliefert),
-    sag das dazu. Erst nach meiner Bestätigung `git push`.
-
-## 6. Zusammenfassen & Abschied
-- 2–3 Sätze **ohne Fachjargon**: Was haben wir heute geschafft, was habe ich gelernt — und in
-  einem Satz, was aufgeräumt wurde.
-- **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.
+---
+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. Status-Datei nachziehen — und aufräumen
+Die Status-Datei (`WEITER-HIER.md` oder `ROADMAP.md`) ist der Zettel für den nächsten Start. Sie
+taugt nur, solange man sie in einem Atemzug lesen kann. **Jeder Feierabend schreibt etwas dazu —
+also muss auch jeder Feierabend etwas wegräumen**, sonst wächst sie, bis niemand sie mehr liest.
+
+**Der Statuszettel heißt `WEITER-HIER.md` — oder `NEXT-STEPS.md`, wenn der Ordner englisch angelegt wurde.** Liegt einer da, nimm ihn. Liegen beide da, frag, welcher gilt, und schreib in keinen, bevor die Antwort da ist. Muss einer neu entstehen: in `werkbank-…` heißt er `WEITER-HIER.md`, in `workbench-…` `NEXT-STEPS.md`, sonst `WEITER-HIER.md`.
+
+Gibt es keine Status-Datei und die Arbeit wächst über eine Sitzung hinaus: eine vorschlagen,
+dann weiter mit Schritt 3.
+
+1. **Nachziehen:** „Wo wir stehen" und „nächster Schritt" auf das setzen, was heute passiert ist.
+2. **Wegräumen, was nicht mehr gilt.** Ins Archiv wandert:
+   - was **erledigt** ist (fertige Aufgaben, abgehakte Punkte),
+   - die Geschichten **früherer Sitzungen** („Davor …", „Stand vom …") — in „Wo wir stehen" bleibt
+     nur der heutige Stand,
+   - was im Text **widerlegt oder überholt** ist.
+   Was bleibt: der aktuelle Stand, der nächste Schritt, die offenen Punkte, und je Idee für später
+   **höchstens zwei Sätze** — Ausführliches bekommt eine eigene Datei, die Status-Datei verlinkt sie.
+3. **Ins Archiv heißt: verschieben, nicht löschen.** Gibt es schon ein Archiv (steht meist im Kopf
+   der Status-Datei), dorthin; sonst neben `WEITER-HIER.md` ein `WEITER-HIER-archiv.md`, neben `NEXT-STEPS.md` ein `NEXT-STEPS-archive.md` anlegen. Unten anhängen, mit
+   dem heutigen Datum als Überschrift, **im Wortlaut** — das Warum früherer Entscheidungen soll
+   auffindbar bleiben.
+4. **Messen statt schätzen:** Zeilen der Status-Datei **vorher und nachher zählen**. Steht in ihrem
+   Kopf eine Zielgröße, gilt die, sonst **150 Zeilen**. Liegt sie danach noch drüber, weiter
+   wegräumen — oder sag laut, warum der Rest bleiben muss. Prüf danach im Archiv nach, dass das
+   Verschobene wirklich dort steht (eine Zeile daraus suchen), bevor du es als erledigt meldest.
+5. **Sag laut, was du geändert hast:** was neu drinsteht, was ins Archiv ging, Zeilen vorher → nachher.
+
+## 3. Gelernte Regeln — gehört etwas festgehalten?
+**Nur bei echtem Anlass**, nicht als Pflichtübung. Ein Anlass ist: Ich habe dich heute korrigiert,
+eine Arbeitsweise ausdrücklich gewollt, oder dieselbe Art Frage zum dritten Mal gleich beantwortet.
+Kein Anlass? Sag das in einem Halbsatz und geh weiter.
+
+Gibt es einen, **schlag die Regel vor** — ein Satz, was du künftig anders machst, dazu Datum und
+Anlass in einem Satz — und trag sie erst nach meinem OK ein. Wohin, hängt davon ab, was sie ist:
+
+| Was ist es? | Wohin |
+|---|---|
+| **Eine Arbeitsregel** — wie du arbeiten, fragen, prüfen, erklären sollst | `~/.claude/rules/kimal3-coach.md`, **unten** im Abschnitt „Gelernte Regeln" (in einem englischen Coach „Learned rules") (neueste unten) |
+| **Etwas über mich** — wer ich bin, meine Rollen, meine Werkzeuge | meine `~/.claude/CLAUDE.md` |
+| **Etwas über dieses Projekt** — Aufbau, Werkzeuge, Fallen | die `CLAUDE.md` im Projektordner |
+
+🔬 **Vorher nachsehen, ob es die Regel schon gibt** — im Coach und in den CLAUDE.md-Dateien. Steht
+sie schon da, trag sie **nicht** doppelt ein: Sag mir, wo sie steht und dass sie heute nicht
+gegriffen hat. Eine Regel, die zweimal dasteht, wird nicht besser befolgt.
+⚠️ **Gibt es `~/.claude/rules/kimal3-coach.md` nicht**, kommt auch eine Arbeitsregel in meine
+`~/.claude/CLAUDE.md`. Leg die Coach-Datei **nicht** selbst an — sie gehört kimal3.
+🔴 **Im Coach änderst du NUR den Abschnitt „Gelernte Regeln" (in einem englischen Coach „Learned rules")** und schreibst nur unten dazu. Alles
+darüber ist die Vorlage von kimal3 — dort änderst du nichts.
+
+Sag danach laut, **welcher Satz in welcher Datei** steht (vollständiger Pfad). Der Ordner
+`~/.claude` ist meist kein Git-Repo — die Datei ist dann nicht über Git gesichert; sag das dazu.
+
+## 4. Projekt aufräumen (leichtgewichtig)
+- Offensichtlichen Müll entfernen (`.DS_Store`, `*.tmp`, `*.log`, `__pycache__`).
+- Bei allem Unklaren: **nicht** löschen — auflisten und mich fragen.
+
+## 5. Sichern (mit meinem OK)
+- Stage die relevanten Änderungen **Datei für Datei** — **niemals** Secrets oder `.env*`, und kein
+  `git add -A`, das fremde Arbeit mitnimmt.
+- Zeig mir kurz, was in den Commit geht — **und was bewusst draußen bleibt**: Dateien, die Git noch
+  nicht kennt und die nicht aus dieser Sitzung stammen, stehen mit Namen und einem Satz, was sie
+  sind, in derselben Liste. (Sie kommen oft aus einer anderen Sitzung und fallen sonst niemandem
+  auf.) Mein OK zum Commit gilt für die ganze Liste; will ich eine davon doch dabeihaben, sage ich es.
+- Schlag eine Commit-Nachricht vor.
+- Nach meinem OK: committen.
+- **Pushen, je nach Projekt:** Prüf mit `git remote`, ob es überhaupt ein Ziel gibt.
+  - Kein Ziel: sag das kurz — der Commit ist dann die Sicherung, fertig.
+  - Ein Ziel: **frag, ob du pushen sollst** (der Schritt „nach außen"). Steht in der
+    Projekt-`CLAUDE.md`, dass ein Push etwas auslöst (zum Beispiel die Live-Seite neu ausliefert),
+    sag das dazu. Erst nach meiner Bestätigung `git push`.
+
+## 6. Zusammenfassen & Abschied
+- 2–3 Sätze **ohne Fachjargon**: Was haben wir heute geschafft, was habe ich gelernt — und in
+  einem Satz, was aufgeräumt wurde.
+- **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/k3kontext.md

@@ -32,7 +32,7 @@ weiter die echten Dateien und schickt leere Antworten hoch — beide Seiten meld
 Arbeit ist trotzdem weg.
 
 **Kein Arbeitsplatz gefunden?** Die Meldung heißt „ich habe von hier aufwärts keinen gefunden" —
-**nicht** „es gibt keinen". Frag erst: *Hast du schon einen KI-Arbeitsplatz-Ordner?* Ja → dorthin
+**nicht** „es gibt keinen". Frag erst: *Hast du schon einen KI-Arbeitsplatz-Ordner?* (In einer englischen Firma heißt er `AI-Workplace`.) Ja → dorthin
 wechseln und noch einmal. Nein → `kimal3 arbeitsplatz neu`. ⚠️ Wer hier falsch rät, legt einen
 zweiten, leeren Arbeitsplatz an.
 

package/skill/commands/k3kurs.md

@@ -15,33 +15,34 @@ Führe die Schritte der Reihe nach aus. Bleib im Coaching-Ton: Deutsch, freundli
 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
+- **Liegt `kurs-beats.md` (oder `course-parts.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
+- Liegt sie da: Lies `kurs-beats.md` (oder `course-parts.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".
+- **Der Statuszettel heißt `WEITER-HIER.md` — oder `NEXT-STEPS.md`, wenn der Ordner englisch angelegt wurde.** Liegt einer da, nimm ihn. Liegen beide da, frag, welcher gilt, und schreib in keinen, bevor die Antwort da ist. Muss einer neu entstehen: in `werkbank-…` heißt er `WEITER-HIER.md`, in `workbench-…` `NEXT-STEPS.md`, sonst `WEITER-HIER.md`.
 - 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`.
+  siehe `START-HIER.md` (oder `START-HERE.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.
+  ganze Liste auf einmal. Zieh `WEITER-HIER.md` (oder `NEXT-STEPS.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
+  und hinterlege dort eine kurze **`WEITER-HIER.md`** (liegt dort schon ein `NEXT-STEPS.md`, nimm den) 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

package/skill/commands/k3start.md

@@ -19,10 +19,11 @@ nicht relevant, sag das kurz und überspring ihn — kein Leerlauf.
 - 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
+- **Liegt eine `START-HIER.md` (oder `START-HERE.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.
+- **Der Statuszettel heißt `WEITER-HIER.md` — oder `NEXT-STEPS.md`, wenn der Ordner englisch angelegt wurde.** Liegt einer da, nimm ihn. Liegen beide da, frag, welcher gilt, und schreib in keinen, bevor die Antwort da ist. Muss einer neu entstehen: in `werkbank-…` heißt er `WEITER-HIER.md`, in `workbench-…` `NEXT-STEPS.md`, sonst `WEITER-HIER.md`.
 - 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.