kimal3 0.2.4 → 0.2.5

package/package.json

@@ -1,27 +1,27 @@
-{
-  "name": "kimal3",
-  "version": "0.2.4",
-  "description": "Trag deine KI-Projekte dort ein, wo sie entstehen: im Terminal.",
-  "type": "module",
-  "bin": {
-    "kimal3": "dist/kimal3.js"
-  },
-  "files": [
-    "dist",
-    "skill",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=20"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "kimal3",
-    "cli"
-  ],
-  "homepage": "https://app.kimal3.de/pro",
-  "license": "SEE LICENSE IN README.md"
-}
+{
+  "name": "kimal3",
+  "version": "0.2.5",
+  "description": "Trag deine KI-Projekte dort ein, wo sie entstehen: im Terminal.",
+  "type": "module",
+  "bin": {
+    "kimal3": "dist/kimal3.js"
+  },
+  "files": [
+    "dist",
+    "skill",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "kimal3",
+    "cli"
+  ],
+  "homepage": "https://app.kimal3.de/pro",
+  "license": "SEE LICENSE IN README.md"
+}

package/skill/SKILL.md

@@ -13,6 +13,33 @@ description: Projekte ins kimal3-Erfolgsprofil eintragen oder auflisten, Firmend
 Sobald der Mensch sagt, ein Projekt sei fertig, oder ausdrücklich bittet, es einzutragen.
 **Oder** wenn er seinen KI-Arbeitsplatz anlegen will — dann s. „Den Arbeitsplatz anlegen".
 
+## Die acht Slash-Befehle, die der Mensch hat
+
+`kimal3 skill install` legt sie global ab (`~/.claude/commands/`) — er kann sie also in
+**jedem** Ordner tippen. Sie sind der Weg, den er selbst auslöst; dieses Skill ist der Weg,
+den du erkennst.
+
+| Befehl | Wofür |
+|---|---|
+| `/k3` | Wo er steht — und alle kimal3-Befehle auf einen Blick |
+| `/k3start` | Sitzung starten: wo das Projekt steht und was als Nächstes dran ist |
+| `/k3feierabend` | Sitzung sauber beenden: Stand sichern, aufräumen, zusammenfassen |
+| `/k3kurs` | Zurück in den Mini-Kurs — da weiter, wo er aufgehört hat |
+| `/k3projekt` | Ein fertiges Projekt ins Erfolgsprofil eintragen |
+| `/k3liste` | Seine eingetragenen Projekte zeigen |
+| `/k3analyse` | Firmendaten holen und seine Frage dazu beantworten |
+| `/k3kontext` | Die offenen Fragen über seine Firma im Gespräch beantworten |
+
+🔴 **Nenne einen dieser Befehle nur, wenn du weißt, dass er ihn hat.** Sie kommen mit
+`kimal3 skill install`; wer das nie ausgeführt hat, sieht beim Tippen nichts, und ein Rat ins
+Leere sieht aus wie ein Fehler bei ihm. Im Zweifel beschreibst du, was du tust, statt auf
+einen Befehl zu zeigen.
+
+⚠️ **`/k3start`, `/k3feierabend` und `/k3kurs` kamen bis 0.2.4 NUR im Kursordner mit** — Pro-
+Kunden ohne Mini-Kurs hatten sie nie, und aktualisieren ließen sie sich gar nicht. Seit 0.2.5
+liefert das Programm alle acht aus. *Triffst du jemanden mit einer älteren Fassung, ist ein
+fehlender Befehl dort kein Fehler, sondern der alte Stand.*
+
 ## 🔴 Mehrere Firmen: DU WÄHLST NICHT
 
 Gilt für **jeden** Befehl, der eine Firma braucht: `arbeitsplatz neu` · `werkbank neu` ·

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.