kimal3 0.4.0-durchstich.3 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/README.md +6 -0
  2. package/claude-plugins/.claude-plugin/marketplace.json +8 -8
  3. package/claude-plugins/README.md +7 -7
  4. package/claude-plugins/kimal3-logo/.claude-plugin/plugin.json +6 -6
  5. package/claude-plugins/kimal3-logo/hooks/hooks.json +1 -1
  6. package/claude-plugins/kimal3-logo/hooks/register.tsx +80 -80
  7. package/coach/de/kimal3-coach.md +167 -0
  8. package/coach/en/kimal3-coach.md +167 -0
  9. package/dist/arbeitsplatz-dateien.js +1 -1
  10. package/dist/arbeitsplatz-finden.js +115 -0
  11. package/dist/arbeitsplatz-suche.js +176 -0
  12. package/dist/befehle/einrichten.js +250 -32
  13. package/dist/befehle/kurs.js +77 -0
  14. package/dist/befehle/login.js +12 -1
  15. package/dist/befehle/skill-install.js +15 -0
  16. package/dist/befehle/zeigen-einrichten.js +104 -0
  17. package/dist/befehle/zeigen-start.js +143 -0
  18. package/dist/befehle/zeigen.js +288 -0
  19. package/dist/befehle-katalog-en.js +39 -0
  20. package/dist/befehle-katalog.js +39 -0
  21. package/dist/befehlswoerter.js +15 -0
  22. package/dist/coach-ablegen.js +130 -0
  23. package/dist/coach-rechnung.js +40 -0
  24. package/dist/kimal3.js +14 -2
  25. package/dist/logo-ablegen.js +26 -6
  26. package/dist/slash-befehle.js +1 -0
  27. package/dist/texte/coach.js +27 -0
  28. package/dist/texte/einrichten-marken.js +2 -2
  29. package/dist/texte/einrichten.js +58 -5
  30. package/dist/texte/kurs.js +21 -0
  31. package/dist/texte/zeigen.js +189 -0
  32. package/dist/zeigen-rechnung.js +226 -0
  33. package/dist/zeigen-umgebung.js +190 -0
  34. package/package.json +3 -1
  35. package/skill/SKILL.md +10 -5
  36. package/skill/commands/k3.md +4 -3
  37. package/skill/commands/k3feierabend.md +2 -3
  38. package/skill/commands/k3kurs.md +27 -39
  39. package/skill/commands/k3start.md +4 -3
  40. package/skill/commands/k3zeigen.md +303 -0
  41. package/skill/en/SKILL.md +10 -5
  42. package/skill/en/commands/k3.md +4 -3
  43. package/skill/en/commands/k3course.md +27 -40
  44. package/skill/en/commands/k3show.md +302 -0
  45. package/skill/en/commands/k3start.md +4 -3
  46. package/skill/en/commands/k3wrapup.md +3 -4
  47. package/zeigen/gemeinsam.py +82 -0
  48. package/zeigen/starter.py +163 -0
  49. package/zeigen/werkzeug.py +250 -0
  50. package/zeigen/zeitleiste.py +393 -0
package/skill/SKILL.md CHANGED
@@ -13,7 +13,7 @@ description: Projekte ins kimal3-Erfolgsprofil eintragen oder auflisten, Firmend
13
13
  Sobald der Mensch sagt, ein Projekt sei fertig, oder ausdrücklich bittet, es einzutragen.
14
14
  **Oder** wenn er seinen KI-Arbeitsplatz anlegen will — dann s. „Den Arbeitsplatz anlegen".
15
15
 
16
- ## Die acht Slash-Befehle, die der Mensch hat
16
+ ## Die neun Slash-Befehle, die der Mensch hat
17
17
 
18
18
  `kimal3 skill install` legt sie global ab (`~/.claude/commands/`) — er kann sie also in
19
19
  **jedem** Ordner tippen. Sie sind der Weg, den er selbst auslöst; dieses Skill ist der Weg,
@@ -24,11 +24,12 @@ den du erkennst.
24
24
  | `/k3` | Wo er steht — und alle kimal3-Befehle auf einen Blick |
25
25
  | `/k3start` | Sitzung starten: wo das Projekt steht und was als Nächstes dran ist |
26
26
  | `/k3feierabend` | Sitzung sauber beenden: Stand sichern, aufräumen, zusammenfassen |
27
- | `/k3kurs` | Zurück in den Mini-Kurs — da weiter, wo er aufgehört hat |
27
+ | `/k3kurs` | Zurück in den Mini-Kurs — holt den Stand mit `kimal3 kurs` und macht da weiter, wo er aufgehört hat |
28
28
  | `/k3projekt` | Ein fertiges Projekt ins Erfolgsprofil eintragen |
29
29
  | `/k3liste` | Seine eingetragenen Projekte zeigen |
30
30
  | `/k3analyse` | Firmendaten holen und seine Frage dazu beantworten |
31
31
  | `/k3kontext` | Die offenen Fragen über seine Firma im Gespräch beantworten |
32
+ | `/k3zeigen` | Eine Aufgabe vormachen statt beschreiben — nimmt mit `kimal3 zeigen …` auf, wertet auf dem Rechner aus und schreibt den Plan; gelesen wird erst nach seinem Ja |
32
33
 
33
34
  🔴 **Nenne einen dieser Befehle nur, wenn du weißt, dass er ihn hat.** Sie kommen mit
34
35
  `kimal3 skill install`; wer das nie ausgeführt hat, sieht beim Tippen nichts, und ein Rat ins
@@ -37,7 +38,7 @@ einen Befehl zu zeigen.
37
38
 
38
39
  ⚠️ **`/k3start`, `/k3feierabend` und `/k3kurs` kamen bis 0.2.4 NUR im Kursordner mit** — Pro-
39
40
  Kunden ohne Mini-Kurs hatten sie nie, und aktualisieren ließen sie sich gar nicht. Seit 0.2.5
40
- liefert das Programm alle acht aus. *Triffst du jemanden mit einer älteren Fassung, ist ein
41
+ liefert das Programm sie alle aus. *Triffst du jemanden mit einer älteren Fassung, ist ein
41
42
  fehlender Befehl dort kein Fehler, sondern der alte Stand.*
42
43
 
43
44
  ## 🔴 Mehrere Firmen: DU WÄHLST NICHT
@@ -158,8 +159,7 @@ gemeinsam ausfüllen — es sind vier verschiedene. Such nach eckigen Klammern,
158
159
  zu folgen: Eine abgetippte Liste veraltet in dem Moment, in dem die Vorlage wächst. Frag nach,
159
160
  statt zu raten.
160
161
 
161
- ⚠️ `[FIRMA]` findest du meist schon ausgefüllt — den Namen setzt der Server beim Ausliefern ein.
162
- `[DATUM]` ebenso. Was übrig bleibt, sind die Angaben über den **Menschen** vor dir.
162
+ ⚠️ `[FIRMA]` findest du meist schon ausgefüllt — den Namen setzt der Server beim Ausliefern ein. Was übrig bleibt, sind die Angaben über den **Menschen** vor dir.
163
163
 
164
164
  🔴 **Nur in der Werkbank — nirgends sonst.** Die oberste `CLAUDE.md` und alles in `kontext/` (in einer englischen Firma `context/`)
165
165
  gehören der **Firma**, nicht dem Menschen vor dir. Den Firmennamen setzt der Server beim
@@ -360,6 +360,11 @@ mitbestimmungspflichtig. Das entscheidet die Firma, nicht dieses Werkzeug.
360
360
  - „Was würdest du als Geschäftsführung als Nächstes automatisieren, gemessen an dem, was bisher
361
361
  funktioniert hat — und was davon lässt sich auf andere Abteilungen übertragen?"
362
362
 
363
+ ## Kursstand lesen (`kimal3 kurs`)
364
+ Zeigt, wo der Mensch im Mini-Kurs steht: eine Zeile je Beat, `Als Nächstes:` mit dem nächsten Schritt und dahinter, wer
365
+ ihn abhakt — „(du hakst ab)" oder „(setzt Claude)". Rückgabewert `2` heißt nicht angemeldet, `3` nicht erreichbar —
366
+ dann **keinen Kurs aus dem Gedächtnis erzählen**. Der Slash-Befehl `/k3kurs` führt dadurch.
367
+
363
368
  ## Rückgabewerte
364
369
  `0` erledigt · `1` **Wiederholen hilft nicht — LIES DIE MELDUNG** · `2` Anmeldung fehlt ·
365
370
  `3` vorübergehende Störung, einmal wiederholen · `4` angemeldet, aber kein Pro-Zugang —
@@ -83,17 +83,18 @@ Stell die Liste in zwei Gruppen dar:
83
83
  | `/k3projekt <was du gebaut hast>` | Ein fertiges Projekt ins Erfolgsprofil eintragen |
84
84
  | `/k3liste` | Deine eingetragenen Projekte zeigen |
85
85
  | `/k3analyse <deine Frage>` | Firmendaten holen und deine Frage dazu beantworten |
86
+ | `/k3zeigen` | Eine Aufgabe vormachen statt beschreiben — ich nehme auf und mache daraus einen Plan |
86
87
 
87
88
  Sag dazu: Die Slash-Befehle sind der **sichere** Weg — du musst dir keinen Satz merken. Ohne
88
89
  sie geht es auch: „das Projekt ist fertig" genügt, dann greife ich über den Skill.
89
90
 
90
- ## 6. Der neunte Eintrag im Menü: `/kimal3` ist KEIN Befehl
91
+ ## 6. Der zehnte Eintrag im Menü: `/kimal3` ist KEIN Befehl
91
92
 
92
93
  In derselben `/`-Liste steht auch **`/kimal3`**. Erklär den Unterschied **ungefragt** — das Menü
93
94
  wirft zwei verschiedene Sorten in eine Liste, und genau daran hat sich der erste Mensch gestoßen,
94
95
  der die Familie gesehen hat (Dennis, 2026-08-19):
95
96
 
96
- - Die acht **`/k3…`** sind **Slash-Befehle** (Dateien in `~/.claude/commands/`) — **der Mensch**
97
+ - Die neun **`/k3…`** sind **Slash-Befehle** (Dateien in `~/.claude/commands/`) — **der Mensch**
97
98
  tippt sie bewusst.
98
99
  - **`/kimal3`** ist der **Skill** (`~/.claude/skills/kimal3/SKILL.md`) — meine
99
100
  Bedienungsanleitung. Sie ist der Grund, warum „das Projekt ist fertig" genügt: Ich schlage sie
@@ -101,5 +102,5 @@ der die Familie gesehen hat (Dennis, 2026-08-19):
101
102
  sie mehrere Dinge auf einmal und liest sich nicht wie ein Menüpunkt.
102
103
 
103
104
  Sag auch, was `/kimal3` **nicht** ist: **nicht die Installation.** Die ist `kimal3 skill install`
104
- im Terminal — der eine Befehl, der beides ablegt, den Skill **und** die acht `/k3…`. Was im Menü
105
+ im Terminal — der eine Befehl, der beides ablegt, den Skill **und** die neun `/k3…`. Was im Menü
105
106
  steht, ist sein Ergebnis.
@@ -24,10 +24,9 @@ Die Status-Datei (`WEITER-HIER.md` oder `ROADMAP.md`) ist der Zettel für den n
24
24
  taugt nur, solange man sie in einem Atemzug lesen kann. **Jeder Feierabend schreibt etwas dazu —
25
25
  also muss auch jeder Feierabend etwas wegräumen**, sonst wächst sie, bis niemand sie mehr liest.
26
26
 
27
- **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`.
27
+ **Wo der Statuszettel liegt und wie er heißt.** Die Projektregel gilt **nur innerhalb eines Arbeitsplatzes**: Liegt ein Ordner `projekte/` oder `projects/` direkt in einem Ordner `werkbank-…` oder `workbench-…` (beide Schreibweisen kommen vor, auch gemischt) und steht die Sitzung in oder unter einem Ordner darin, ist dieser **Projektordner** der Ort. Name dort: unter `projekte/` `WEITER-HIER.md`, unter `projects/` `NEXT-STEPS.md`. **Überall sonst** (Starter-Paket, eigene Repos, auch ein Ordner `~/projects/mein-repo`) bleibt es wie bisher: Der Zettel liegt im Startordner, liegt einer da, nimm ihn; muss einer neu entstehen, heißt er `WEITER-HIER.md` — oder `NEXT-STEPS.md`, wenn der Ordner englisch angelegt wurde. Liegen beide da, frag, welcher gilt, und schreib in keinen, bevor die Antwort da ist. **Welcher gilt (im Arbeitsplatz):** Hat das Projekt einen, gilt der des Projekts. Sonst gilt ein vorhandener Werkbank-Zettel (`werkbank-…/WEITER-HIER.md` oder `workbench-…/NEXT-STEPS.md` aus der alten Vorlage) — den liest und pflegst du weiter. Gibt es keinen von beiden, entsteht er **im Projekt**. **Leg nie einen neuen Zettel in der Werkbank an.**
28
28
 
29
- Gibt es keine Status-Datei und die Arbeit wächst über eine Sitzung hinaus: eine vorschlagen,
30
- dann weiter mit Schritt 3.
29
+ **Im Arbeitsplatz** schreibst du in den Zettel des Projekts, an dem heute gearbeitet wurde — fehlt er und liegt auch kein Werkbank-Zettel, leg ihn im Projekt an. **Nach einer reinen Profil-Sitzung** („Wer hier arbeitet“ ausgefüllt, noch kein Projekt) schreibst du **keinen** Zettel, sondern sagst, dass es beim nächsten Mal mit „Erste Sitzung“ in der Werkbank-`CLAUDE.md` weitergeht — dann weiter mit Schritt 3. **Außerhalb eines Arbeitsplatzes** gilt wie bisher: Gibt es keine Status-Datei und die Arbeit wächst über eine Sitzung hinaus, schlag eine vor, dann weiter mit Schritt 3.
31
30
 
32
31
  1. **Nachziehen:** „Wo wir stehen" und „nächster Schritt" auf das setzen, was heute passiert ist.
33
32
  2. **Wegräumen, was nicht mehr gilt.** Ins Archiv wandert:
@@ -8,46 +8,34 @@ description: Zurück in den Mini-Kurs — da weiter, wo du aufgehört hast
8
8
  # Kurs
9
9
 
10
10
  > Zurück in den Mini-Kurs: „Wo war ich nochmal?" — macht da weiter, wo du aufgehört hast.
11
- > (Meistens brauchst du das gar nicht: Dein Coach führt dich beim `/k3start` von allein durch
12
- > den Kurs. Das hier ist der bewusste Wiedereinstieg, wenn du zwischendurch abgebogen bist.)
11
+ > Den Stand holt `kimal3 kurs` frisch von kimal3 — dieselben Haken, die der Mensch im Browser unter
12
+ > https://app.kimal3.de/kurs sieht.
13
13
 
14
14
  Führe die Schritte der Reihe nach aus. Bleib im Coaching-Ton: Deutsch, freundlich, ein Schritt
15
15
  nach dem anderen, das Warum vor dem Wie, null Vorwissen vorausgesetzt.
16
16
 
17
- ## 1. Den Kurs nachschlagen
18
- - **Liegt `kurs-beats.md` (oder `course-parts.md`) neben dir? Wenn nein, hör hier auf.** Dann hat diese Person den
19
- Mini-Kurs nicht — sag ihr freundlich in einem Satz, dass dieser Befehl zum Kurs gehört und
20
- hier nichts zu tun hat, und frag mit einem Vorschlag, woran sie stattdessen arbeiten möchte.
21
- **Fang nicht an, den Kurs aus dem Gedächtnis nachzuerzählen**, und such die Datei nicht
22
- woanders. *Der Befehl kommt seit 0.2.5 mit jedem kimal3 mit, der Kurs nicht.*
23
- - Liegt sie da: Lies `kurs-beats.md` (oder `course-parts.md`) — dort stehen die 3 Beats des Kurses, aus dem der Nutzer
24
- kommt. Das ist dein Wissen darüber; die Datei wird automatisch erzeugt, ändere sie nie von Hand.
25
-
26
- ## 2. Schauen, wie weit ihr seid
27
- - Lies `WEITER-HIER.md` (falls vorhanden) — dort steht der Kurs-Stand, z. B. „Beat 2 läuft".
28
- - **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`.
29
- - Gibt es die Datei noch nicht, ist das die erste Sitzung: Beat 1 ist dann erledigt (der Nutzer
30
- hat dich ja gerade gestartet), es geht bei **Beat 2** weiter. **Leg sie dann gleich an** —
31
- siehe `START-HIER.md` (oder `START-HERE.md`).
32
-
33
- ## 3. Stand in einem Satz sagen
34
- - Sag in **einem** Satz, wo ihr im Kurs steht — kein Vortrag, keine Wiederholung des ganzen Kurses.
35
-
36
- ## 4. Weiterführen — bis Beat 2 durch ist
37
- - Führ **einen** Schritt nach dem anderen weiter: zeigen, machen lassen, verstehen. Nie die
38
- ganze Liste auf einmal. Zieh `WEITER-HIER.md` (oder `NEXT-STEPS.md`) nach, sobald ein Beat fertig ist.
39
- - **Beat 1** (App, Konto, Plan, Start-Workspace, **Git**) passiert im Browser, **bevor** es dich
40
- gibt — den kannst du nicht führen. Er ist erledigt, sobald du läufst.
41
-
42
- ## 5. Nach Beat 2: den Umzug bauen & übergeben
43
- - Der Abschluss von Beat 2 ist der **Umzug**: Schlag Ordnername + Ort fürs erste echte
44
- 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
45
- und hinterlege dort eine kurze **`WEITER-HIER.md`** (liegt dort schon ein `NEXT-STEPS.md`, nimm den) als Übergabe-Notiz — was geschafft
46
- ist und was als Nächstes dran ist (kleine echte Aufgabe wählen, `git init` + erster
47
- Commit, Rhythmus: durchdenken → bauen → prüfen → sichern, sichtbares Ergebnis; Schritte
48
- nebenbei im Kurs im Browser abhaken). Dann bitte ihn, Claude ganz zu schließen und im
49
- neuen Ordner neu zu öffnen (`/k3start`).
50
- - **Beat 3 führst du nicht von hier aus.** Im neuen Ordner bist du einfach sein Coach —
51
- die Notiz sagt dir, wo ihr steht. Gefeiert wird im Browser.
52
- - Ist er schon so weit (oder gar durch), sag das kurz und freundlich — und frag mit einem
53
- Vorschlag, woran er hier stattdessen arbeiten möchte. Kein Kurs-Gerede mehr.
17
+ ## 1. Den Stand holen
18
+ - Führ `kimal3 kurs` aus (unter Windows so, wie es `SKILL.md` beschreibt).
19
+ - Rückgabewert **2**: Der Mensch ist nicht angemeldet. Zeig ihm `kimal3 login`, lass ihn selbst im Browser bestätigen
20
+ und nenn **keinen** Kursstand.
21
+ - Rückgabewert **3**: Der Stand ist gerade nicht abrufbar. Sag es in einem Satz und **erzähl den Kurs nicht aus dem
22
+ Gedächtnis**.
23
+ - Kennt das Programm den Befehl nicht, ist es zu alt: Nenn `npm install -g kimal3@latest`, danach `kimal3 skill install`.
24
+
25
+ ## 2. Stand in einem Satz sagen
26
+ - Sag in **einem** Satz, wo ihr im Kurs steht — aus der Ausgabe (Zeile `Kurs:`), nichts dazuerfinden. Kein Vortrag.
27
+
28
+ ## 3. Als Nächstes führen
29
+ - Die Zeile `Als Nächstes:` nennt den nächsten Schritt. Führ **einen** Schritt nach dem anderen: zeigen, machen lassen,
30
+ verstehen. Nie die ganze Liste auf einmal.
31
+ - Steht dahinter **„(du hakst ab)"** und hat der Mensch den Schritt offensichtlich schon getan (zum Beispiel „Claude ganz
32
+ beendet und neu geöffnet" — er sitzt ja gerade in Claude), führ ihn nicht noch einmal: Frag kurz nach und bitte ihn,
33
+ den Schritt unter https://app.kimal3.de/kurs abzuhaken.
34
+ - Steht dahinter **„(setzt Claude)"** und ist er offen, lass die Einrichtung noch einmal laufen — über die Anleitung
35
+ `https://app.kimal3.de/einrichten` (lade sie wie der Kurs-Satz und folge ihr), **nicht** mit einem frei aufgerufenen
36
+ `kimal3 einrichten`. Bleibt der Schritt danach offen, nenn den Grund aus der Ausgabe von `einrichten` und schlag
37
+ keinen dritten Lauf vor.
38
+
39
+ ## 4. Abgeschlossen
40
+ - Steht in der Ausgabe `Kurs: abgeschlossen`, gratuliere kurz und frag mit einem Vorschlag, woran er hier arbeiten
41
+ möchte. Kein Kurs-Gerede mehr.
@@ -23,11 +23,12 @@ nicht relevant, sag das kurz und überspring ihn — kein Leerlauf.
23
23
  dich für genau dieses Projekt und hat **Vorrang** vor allem, was hier unten steht.
24
24
  - Gibt es ein Status-Doc (`WEITER-HIER.md` oder `ROADMAP.md`) — eine kleine Datei, in der der
25
25
  letzte Stand und der nächste Schritt festgehalten sind? Dann lies es.
26
- - **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`.
27
- - Kein Status-Doc? **Sieh erst nach, ob ein `.git`-Ordner daneben liegt.** Wenn ja, führt dieses
26
+ - **Wo der Statuszettel liegt und wie er heißt.** Die Projektregel gilt **nur innerhalb eines Arbeitsplatzes**: Liegt ein Ordner `projekte/` oder `projects/` direkt in einem Ordner `werkbank-…` oder `workbench-…` (beide Schreibweisen kommen vor, auch gemischt) und steht die Sitzung in oder unter einem Ordner darin, ist dieser **Projektordner** der Ort. Name dort: unter `projekte/` `WEITER-HIER.md`, unter `projects/` `NEXT-STEPS.md`. **Überall sonst** (Starter-Paket, eigene Repos, auch ein Ordner `~/projects/mein-repo`) bleibt es wie bisher: Der Zettel liegt im Startordner, liegt einer da, nimm ihn; muss einer neu entstehen, heißt er `WEITER-HIER.md` — oder `NEXT-STEPS.md`, wenn der Ordner englisch angelegt wurde. Liegen beide da, frag, welcher gilt, und schreib in keinen, bevor die Antwort da ist. **Welcher gilt (im Arbeitsplatz):** Hat das Projekt einen, gilt der des Projekts. Sonst gilt ein vorhandener Werkbank-Zettel (`werkbank-…/WEITER-HIER.md` oder `workbench-…/NEXT-STEPS.md` aus der alten Vorlage) — den liest und pflegst du weiter. Gibt es keinen von beiden, entsteht er **im Projekt**. **Leg nie einen neuen Zettel in der Werkbank an.**
27
+ - **Stehst du in der Werkbank selbst (`werkbank-…` oder `workbench-…`), nicht in einem Projekt?** Steht in ihrer `CLAUDE.md` der Abschnitt „Erste Sitzung“ (englisch „First session“), folge **ihm** — er hat Vorrang vor allem Folgenden. Steht er nicht (mehr) da, zeig die Projekte in `projekte/` bzw. `projects/` (ohne `beispiel-rechnungen-erfassen` und `example-capture-invoices`) mit je der **ersten Stand-Zeile** ihres Zettels, oder „noch kein Zettel“, wenn keiner da ist; ein vorhandener Werkbank-Zettel (`WEITER-HIER.md` oder `NEXT-STEPS.md`) steht darüber. Empfiehl daraus **eines** und stell **eine** Frage dazu. Wählt der Mensch ein Projekt aus der Liste oder nennt eine neue Aufgabe (dann legst du erst Ordner und Statuszettel im Projekt an, nie in der Werkbank), bring die Sitzung in den Projektordner: mit `change_directory` (steht es nur als Name in deiner Werkzeugliste, lade es über die Werkzeugsuche) — und sag vorher: „Gleich fragt dich die Claude-App, ob ich den Ordner wechseln darf, und danach, ob du ihm vertraust — beides ist richtig so, klick jeweils auf Erlauben. Landest du danach in einem leeren Gespräch, tipp dort `/k3start`; dieses Gespräch findest du links in der Liste wieder.“ Ohne das Werkzeug oder wenn der Mensch ablehnt: nenne den genauen Projektordner (nicht die Werkbank darüber) — in der App „Ordner wählen“ und diesen Ordner nehmen, im Terminal `/exit`, `cd '‹Pfad›'`, `claude` — und dann `/k3start`. Bei einem neuen Projekt lies vorher `projekte/CLAUDE.md` (englisch `projects/CLAUDE.md`): ab jetzt gilt sie.
28
+ - Kein Status-Doc? **Sieh erst nach, ob ein `.git`-Ordner im Zettel-Ort liegt** (im Arbeitsplatz der Projektordner, sonst der Startordner). Wenn ja, führt dieses
28
29
  Projekt eine Versionsgeschichte, und `git log --oneline -10` plus `git status` zeigen dir den
29
30
  letzten Stand.
30
- ⚠️ **Liegt kein `.git` daneben, lass beide Befehle weg.** Sie antworten dann mit
31
+ ⚠️ **Liegt dort kein `.git`, lass beide Befehle weg.** Sie antworten dann mit
31
32
  `fatal: not a git repository` — und eine Fehlermeldung als Begrüßung sieht aus, als hätte die
32
33
  Person etwas falsch gemacht. Bei einem frisch begonnenen Projekt, in dem noch nichts gesichert
33
34
  wurde, scheitert `git log` allein; `git status` läuft dort und meldet „alles sauber".
@@ -0,0 +1,303 @@
1
+ ---
2
+ description: Eine Aufgabe vormachen statt beschreiben — ich nehme auf und mache daraus einen Plan
3
+ ---
4
+
5
+ <!-- kimal3:erzeugt — diese Datei wird von `kimal3 skill install` gepflegt und bei
6
+ jedem Update ueberschrieben. Eigene Aenderungen gehen dabei verloren; wer sie
7
+ behalten will, kopiert die Datei unter einem anderen Namen. -->
8
+ # Zeigen
9
+
10
+ > Du machst eine Aufgabe einmal am Bildschirm vor und sagst dabei laut, was du tust und warum.
11
+ > Ich nehme das auf, werte es auf deinem Rechner aus und schreibe daraus eine Beschreibung ins
12
+ > Projekt — damit wir die Aufgabe danach automatisieren können, ohne dass du sie erst als
13
+ > Anforderung aufschreiben musst.
14
+
15
+ Führe die Schritte der Reihe nach aus. Bleib im Coaching-Ton: Deutsch, freundlich, **eine Frage
16
+ auf einmal und immer mit Vorschlag**, das Warum vor dem Wie, null Vorwissen vorausgesetzt. Das
17
+ Mechanische macht das Programm (`kimal3 zeigen …`), du führst das Gespräch mit dem Menschen. Wie du
18
+ allgemein mit den Rückgabewerten von `kimal3` umgehst, steht in `~/.claude/skills/kimal3/SKILL.md`;
19
+ hier stehen nur die Fälle dieses Befehls.
20
+
21
+ ## 🔴 Drei Regeln für das ganze Gespräch
22
+
23
+ 1. **Vor dem Ja in Schritt 10 liest du nichts aus der Aufnahme.** Kein `zeitleiste.md`, kein Bild,
24
+ kein Protokoll, keine andere Datei aus `material/aufnahmen/` — und du **suchst** dort auch nicht:
25
+ kein Grep, kein Glob, keine Dateisuche über das Projekt, die diesen Ordner einschließt. Was dort
26
+ liegt, verlässt den Rechner erst mit dem Ja des Menschen. Die Ausgaben von `kimal3 zeigen …`
27
+ darfst du lesen — sie enthalten nur Zahlen, Uhrzeiten und Ordnernamen.
28
+ 2. **Nichts installieren, nichts aufnehmen, nichts löschen ohne ein ausdrückliches Ja zu genau
29
+ diesem Schritt.** Eine Datei aus der Aufnahme öffnest du für den Menschen nur in Notepad, und so,
30
+ dass dein Aufruf sofort zurückkommt: in Bash `cmd //c start "" notepad "<pfad>"`, in PowerShell
31
+ `Start-Process notepad -ArgumentList '"<pfad>"'`. Ein nacktes `notepad "<pfad>"` blockiert, bis
32
+ das Fenster wieder zu ist. Nie in einer IDE oder einem Editor, an dem Claude Code hängt (dort
33
+ landen markierte Zeilen von selbst im Gespräch).
34
+ 3. **Ein Fehlschlag sieht nie aus wie ein Erfolg.** Endet ein `kimal3 zeigen …` nicht mit `0`,
35
+ sag ehrlich, was seine Meldung sagt, und mach nicht weiter, als hätte es geklappt.
36
+
37
+ Alle `kimal3 zeigen …` laufen **im Projektordner** (Schritt 3) — das Programm findet die Aufnahme
38
+ über den Ordner, in dem es gestartet wird. Liegt eine Aufnahme in einem anderen Projekt, wechselst
39
+ du zuerst dorthin: Der Projektordner ist der Teil des Pfads vor `material/aufnahmen/`.
40
+
41
+ ## 1. Ankommen und nachsehen
42
+
43
+ Führe zuerst `kimal3 zeigen status` aus. Es liest nur. Den Block „Eingerichtet:" liest du dem
44
+ Menschen **nicht** vor — du merkst dir nur, ob darin etwas fehlt (eine Zeile mit „fehlt", „nicht
45
+ prüfbar", „kann ich nicht feststellen" oder „(gebraucht wird …)" → Schritt 4).
46
+
47
+ | Die Ausgabe sagt | Was du tust |
48
+ |---|---|
49
+ | `kimal3 zeigen` gibt es bisher nur unter Windows; der Mac folgt. | Sag genau das, freundlich: Vormachen geht auf diesem Rechner noch nicht, der Mac kommt. Biete an, dass der Mensch die Aufgabe stattdessen in Worten beschreibt. Hier endet der Befehl. |
50
+ | „Ob gerade aufgenommen wird, kann ich nicht feststellen." (Rückgabewert 1) | Sag ehrlich, dass du es gerade nicht feststellen kannst. **Starte nichts.** Biete an, in einer Minute noch einmal nachzusehen. |
51
+ | „Läuft seit 09:12 (3 Minuten), Ordner `…`, stoppt spätestens 09:27." | Eine Aufnahme aus einer früheren Sitzung läuft noch. Steht im Ordner ein voller Pfad außerhalb dieses Projekts, wechsle zuerst in dessen Projektordner. Dann frag: „Da läuft noch eine Aufnahme von 09:12 — bist du mit dem Vormachen durch? Dann stoppe ich sie jetzt." Ja → Schritt 8. |
52
+ | „Läuft (in einer anderen Sitzung gestartet)." | Es läuft eine Aufnahme, die dieses Projekt nicht zuordnen kann. Sag das, **starte keine zweite**, und schlag vor, mit `kimal3 zeigen status` nachzusehen, sobald sie zu Ende ist. |
53
+ | „Keine Aufnahme läuft." und darunter „Die letzte (`…`) hat nach 15 Minuten von selbst gestoppt." | Eine Aufnahme ist fertig, aber vermutlich noch nicht ausgewertet. **Starte nicht still eine neue darüber.** Frag mit Vorschlag: „Die Aufnahme von 09:12 hat nach 15 Minuten von selbst aufgehört — soll ich sie auswerten, oder machst du die Aufgabe neu vor? Ich würde sie auswerten; was du nach den 15 Minuten gemacht hast, fehlt dann." Auswerten → Schritt 9 (die Uhrzeit steht im Ordnernamen, `…-0912`). Neu → weiter hier. |
54
+ | „Keine Aufnahme läuft." und darunter „Die letzte (`…`) ist abgebrochen." | Freundlich: Die letzte Aufnahme ist mittendrin abgebrochen — der Mensch hat nichts falsch gemacht. Biete an, die Aufgabe neu vorzumachen. |
55
+ | „Keine Aufnahme läuft." | Weiter. |
56
+
57
+ Die letzte Zeile sagt, ob der Ordner passt — merk sie dir für Schritt 3:
58
+ „Aufnahmen landen hier in: …" (passt) · „Wechsle zuerst in ein Projekt …" (die Sitzung steht in
59
+ der Werkbank) · „Der Projektordner liegt zu tief für den Aufnehmer …" (der Pfad ist zu lang).
60
+
61
+ Steht die Sitzung in der Werkbank, sag **das zuerst**, in einem Satz: Die Aufnahme gehört in ein
62
+ Projekt, und eins schlägst du gleich vor. Dann erklär in höchstens fünf kurzen Sätzen, was
63
+ passiert, und stell **eine** Frage:
64
+
65
+ > „Du machst mir die Aufgabe einmal vor und sprichst dabei. Ich nehme dabei Bildschirm, Ton,
66
+ > Klicks und Tasten auf. Das bleibt auf deinem Rechner. Bevor ich etwas davon lese, frage ich
67
+ > dich. Welche Aufgabe willst du mir zeigen — in einem Satz?"
68
+
69
+ Bis der Mensch geantwortet hat, ist nichts installiert und nichts aufgenommen.
70
+
71
+ ## 2. Die Aufgabe in einem Satz
72
+
73
+ Warte auf die Antwort. Den Satz des Menschen übernimmst du **unverändert** — er steht später im
74
+ Kopf der Zeitleiste, und gerade dort, wo er und die Vorführung auseinandergehen, steckt die
75
+ wichtigste Rückfrage (Schritt 11). Ein grober Satz reicht; bohr nicht nach.
76
+
77
+ ## 3. Der richtige Ordner
78
+
79
+ - **Aufnahmen landen hier schon richtig?** Weiter mit Schritt 4.
80
+ - **Die Sitzung steht in der Werkbank** (`werkbank-…`): Schlag ein Projekt mit einem kurzen Namen
81
+ aus der Aufgabe vor — Kleinbuchstaben, Bindestriche: „Ich würde dafür das Projekt
82
+ `projekte/angebotsliste` anlegen — passt das?" (heißt der Ordner in der Werkbank `projects/`,
83
+ dann dort). Erst nach dem Ja legst du **nur** `plan/` und `material/` darin an, nichts auf
84
+ Vorrat. Ab jetzt läuft jeder `kimal3 zeigen …` in diesem Projektordner (z. B.
85
+ `cd "<projektordner>" && kimal3 zeigen status`). Sieh mit `kimal3 zeigen status` nach, dass
86
+ die letzte Zeile jetzt „Aufnahmen landen hier in: …" sagt.
87
+ - **Der Pfad ist zu tief:** Nenn die Zahl aus der Meldung und warum (der Aufnehmer scheitert an
88
+ langen Pfaden). Schlag vor, das Projekt näher am Laufwerk anzulegen, und frag, bevor du etwas
89
+ anlegst.
90
+
91
+ ## 4. Einrichten — nur wenn etwas fehlt
92
+
93
+ Fehlt nichts, überspring diesen Schritt ohne ein Wort darüber. Fehlt etwas, sag **vorher genau
94
+ das** und warte auf die Antwort:
95
+
96
+ > „Dafür richte ich einmal den Aufnehmer ein — ein freies Programm, das Bildschirm, Ton, Klicks
97
+ > und Tasten aufzeichnet. Etwa 2,1 GB, je nach Leitung 10 bis 20 Minuten, nur in deinem
98
+ > Benutzerordner, ohne Adminrechte. Weil er Tasten mitschreibt, kann der Virenschutz deiner Firma
99
+ > ihn melden; auf einem Firmenrechner frag im Zweifel vorher die IT. Soll ich?"
100
+
101
+ - **Ja:** Starte `kimal3 zeigen einrichten` **im Hintergrund** — es kann länger dauern als die zehn
102
+ Minuten, die ein Befehl im Vordergrund laufen darf. Sag, dass es läuft und der Mensch solange
103
+ etwas anderes tun kann. **Warte auf die Meldung, dass es fertig ist** — frag nicht
104
+ zwischendurch nach, und schlaf nicht in einer Schleife. Danach:
105
+ - Rückgabewert `0` → `kimal3 zeigen status`; stehen alle vier Teile da (uv, Aufnehmer, FFmpeg,
106
+ Sprachmodell), weiter mit Schritt 5.
107
+ - Rückgabewert `1` („Schritt … hat nicht geklappt.") → nenn diesen Schritt und biete eine
108
+ fertige Nachricht an die IT an: **was** (uv von Astral · der Aufnehmer openadapt-capture 1.3.0,
109
+ Lizenz MIT, mit Python 3.12 · FFmpeg · das Sprachmodell large-v3-turbo von Hugging Face),
110
+ **wozu** (eine Arbeitsaufgabe einmal am Bildschirm vorführen und auf dem Rechner auswerten),
111
+ **woher** (astral.sh bzw. winget, pypi.org, huggingface.co), **welche Ordner** (nur der
112
+ Benutzerordner, ohne Adminrechte).
113
+ - **Nein:** „Kein Problem — mit `/k3zeigen` geht es jederzeit später." Hier endet der Befehl.
114
+
115
+ ## 5. Die Ansage vor dem Start
116
+
117
+ Sag diese vier Punkte, bevor irgendetwas aufnimmt:
118
+
119
+ 1. Aufgenommen werden **alle Bildschirme**. Schließ, was fremde Daten zeigt, schalte „Nicht
120
+ stören" ein, und nicht während eines Anrufs. Wenn es geht, nimm einen **Testkunden** statt
121
+ eines echten.
122
+ 2. **Tippe kein Passwort** — jede Taste wird mitgeschrieben.
123
+ 3. Sprich laut, **warum** du etwas tust.
124
+ 4. Wenn du fertig bist, komm hierher zurück und schreib **„fertig"**; spätestens nach 15 Minuten
125
+ stoppt die Aufnahme von selbst.
126
+
127
+ Dann: „Schreib ‚los‘, wenn alles bereit ist." — und warte.
128
+
129
+ - **Ein klares Startsignal** — „los", „bereit", „kann losgehen", „start" — → Schritt 6.
130
+ - **Ein bloßes „ok" oder „ja"** → frag einmal: „Soll ich jetzt starten?"
131
+ - **Etwas anderes** → antworte und sag, dass es mit „los" losgeht.
132
+
133
+ **Vor dem Startsignal startet nichts.**
134
+
135
+ ## 6. Starten
136
+
137
+ Nach dem Startsignal: `kimal3 zeigen start '<Satz des Menschen>'`. Übergib den Satz als **ein**
138
+ Argument, so dass die Shell nichts daran ändert — in Bash in einfachen Anführungszeichen (ein `'`
139
+ darin als `'\''`), in PowerShell in einfachen Anführungszeichen (ein `'` darin verdoppelt).
140
+ `--hoechstens` (1 bis 15 Minuten) nur, wenn der Mensch ausdrücklich kürzer will.
141
+
142
+ | Die Ausgabe sagt | Was du tust |
143
+ |---|---|
144
+ | „Die Aufnahme läuft (Ordner …), stoppt spätestens um …" (Rückgabewert 0) | Sag genau: „Läuft. Mach vor — und schreib hier ‚fertig‘, wenn du durch bist." **Dann beende deinen Zug** — kein weiterer Befehl, kein Nachsehen. |
145
+ | „Es läuft schon eine Aufnahme (seit 09:12, Ordner `…`)." · „Gerade startet schon eine Aufnahme …" | Es entsteht keine zweite. Frag: „Da läuft noch eine Aufnahme von 09:12 — soll ich sie stoppen, damit wir neu anfangen?" Ja → `kimal3 zeigen stopp` (Schritt 8), danach zurück zu Schritt 5. |
146
+ | „Es läuft schon eine Aufnahme (in einer anderen Sitzung gestartet)." | Frag: „Da läuft noch eine Aufnahme aus einer anderen Sitzung — soll ich sie stoppen, damit wir neu anfangen?" Ja → `kimal3 zeigen stopp`; sagt es, dass es sie hier nicht zuordnen kann, sag das ehrlich und schlag vor, zu warten, bis sie von selbst aufhört (`kimal3 zeigen status`). |
147
+ | „Ob gerade aufgenommen wird, kann ich nicht feststellen — deshalb starte ich keine zweite." | Ehrlich sagen, nichts erzwingen, später noch einmal nachsehen. |
148
+ | „Der Aufnehmer ist noch nicht eingerichtet: `kimal3 zeigen einrichten`." | Zurück zu Schritt 4. |
149
+ | „Die Aufnahme ist nicht gestartet: <Grund>. Protokoll: …" | Nenn den Grund. **Öffne das Protokoll nicht** — darin stehen Fenstertitel. Folgt „Ob der Aufnehmer noch läuft, sagt `kimal3 zeigen status`.", führ `kimal3 zeigen status` aus und sag, was es meldet. Biete einen neuen Versuch an. |
150
+ | „Wechsle zuerst in ein Projekt …" · „Der Projektordner liegt zu tief …" | Zurück zu Schritt 3. |
151
+
152
+ ## 7. Während der Aufnahme
153
+
154
+ Schreibt der Mensch etwas anderes als „fertig" (eine Frage, einen Gedanken), antworte kurz und
155
+ schließ mit: „Die Aufnahme läuft noch — schreib ‚fertig‘, wenn du durch bist." Öffne dabei nichts
156
+ auf dem Bildschirm (es landete im Video) und stoppe die Aufnahme nicht von dir aus.
157
+ „fertig", „bin durch", „done" und Ähnliches → Schritt 8.
158
+
159
+ ## 8. Stoppen
160
+
161
+ Sag zuerst: „Ich schließe die Aufnahme ab — das kann eine Minute dauern, bei einer langen Aufnahme
162
+ auch mehrere." Während des Abschließens sieht der Mensch sonst nichts passieren.
163
+
164
+ Dann `kimal3 zeigen stopp` — mit der **längsten Wartezeit, die das Werkzeug erlaubt (10 Minuten)**: Der
165
+ Aufnehmer schließt dabei das Video ab, und bei einer langen Aufnahme dauert das; mit der
166
+ Voreinstellung von 2 Minuten bräche der Aufruf mittendrin ab. Das Programm antwortet spätestens nach
167
+ gut 8 Minuten, also bevor die 10 Minuten um sind.
168
+
169
+ | Die Ausgabe sagt | Was du tust |
170
+ |---|---|
171
+ | „Aufnahme gestoppt: 1:33 Minuten, 30 Klicks, 49 Tasten, Ton ist da." | Die Zahlen in einem Satz wiederholen, weiter mit Schritt 9. |
172
+ | „Die Aufnahme wird noch abgeschlossen — gleich noch einmal `kimal3 zeigen stopp`." (Rückgabewert 1) | Sag: „Der Aufnehmer schließt die Aufnahme noch ab — ich frag gleich noch einmal nach." Dann `kimal3 zeigen stopp` noch einmal, wieder mit 10 Minuten Wartezeit. **Nie** „nicht sauber" und keine neue Aufnahme anbieten. |
173
+ | „Die Aufnahme hat nach 15 Minuten von selbst gestoppt: …" (Rückgabewert 0) | Sag: „Die Aufnahme hat nach 15 Minuten von selbst aufgehört — was du danach gemacht hast, ist nicht drin." Weiter mit Schritt 9. |
174
+ | „Es läuft keine Aufnahme." | Sieh mit `kimal3 zeigen status` nach. Steht dort „Die letzte (`…`) hat nach … Minuten von selbst gestoppt.", geht es mit Schritt 9 weiter; sonst sag ehrlich, dass keine Aufnahme da ist. |
175
+ | „Ob gerade aufgenommen wird, kann ich nicht feststellen." | Ehrlich sagen — **nie** „gestoppt". Biete an, in einer Minute mit `kimal3 zeigen status` noch einmal nachzusehen. |
176
+ | „Die Aufnahme ist nicht sauber abgeschlossen: <Grund>." (Rückgabewert 1) | Nenn den Grund und biete eine neue Aufnahme an. |
177
+ | „Die Aufnahme ist abgebrochen: <Grund>. …" (Rückgabewert 1) | Freundlich: Der Mensch hat nichts falsch gemacht. Nenn den Grund und biete eine neue Aufnahme an. |
178
+ | „Die Aufnahme ließ sich nicht stoppen …" · „Es läuft eine Aufnahme, die ich hier nicht zuordnen kann …" | `kimal3 zeigen status` ausführen und ehrlich sagen, was es meldet — **nie** „gestoppt". Läuft die Sitzung im falschen Ordner, wechsle in das Projekt der Aufnahme. |
179
+
180
+ ## 9. Auswerten — auf dem Rechner des Menschen
181
+
182
+ `kimal3 zeigen auswerten` (ohne Ordner nimmt es die jüngste Aufnahme des Projekts; die Sprache
183
+ der Erkennung folgt dem Konto — `--sprache en` oder `--sprache de` nur, wenn der Mensch in der
184
+ anderen Sprache gesprochen hat). Das dauert etwa so lange wie die Aufnahme:
185
+
186
+ - **Aufnahme bis etwa 3 Minuten:** im Vordergrund, mit der längsten Wartezeit (10 Minuten).
187
+ - **Länger — und immer, wenn sie nach 15 Minuten von selbst aufgehört hat:** **im Hintergrund**,
188
+ wie beim Einrichten. Sag, dass es etwa so lange dauert wie die Aufnahme, und **warte auf die
189
+ Meldung, dass es fertig ist** — kein Nachfragen zwischendurch, keine Schleife.
190
+
191
+ | Die Ausgabe sagt | Was du tust |
192
+ |---|---|
193
+ | „Zeitleiste fertig: … Datei: `…`." | Die Zahlen in einem Satz sagen. Den Pfad merken — **die Datei nicht öffnen**. Weiter mit Schritt 10. |
194
+ | „Ich habe keine Sprache erkannt — war das Mikrofon stumm oder das falsche gewählt?" | Genau das fragen und eine neue Aufnahme anbieten. |
195
+ | „Die Aufnahme hat keine Tonspur — ohne Ton entsteht keine Zeitleiste. Eine neue Aufnahme hilft." | Eine neue Aufnahme anbieten. |
196
+ | „In diesem Projekt finde ich keine Aufnahme (`material/aufnahmen/`)." | Die Sitzung steht nicht im Projekt der Aufnahme: Wechsle dorthin (der Teil des Pfads vor `material/aufnahmen/`, aus `kimal3 zeigen status` oder der Stopp-Meldung) und werte noch einmal aus. |
197
+ | „Den Aufnahmeordner gibt es nicht: …" | Sag ehrlich, dass die Aufnahme dort nicht (mehr) liegt. Mit `kimal3 zeigen status` nachsehen; sonst eine neue Aufnahme anbieten. |
198
+ | „Der Aufnehmer ist noch nicht eingerichtet: `kimal3 zeigen einrichten`." | Zurück zu Schritt 4, danach noch einmal auswerten. |
199
+ | „Die Zeitleiste ist nicht entstanden: <Grund>." | Nenn den Grund; fehlt das Sprachmodell, zurück zu Schritt 4. |
200
+ | „Die Aufnahme läuft noch — erst `kimal3 zeigen stopp`." | Zurück zu Schritt 8. |
201
+
202
+ ## 10. Datenschutz — bevor du liest
203
+
204
+ Zuerst eine Frage, und warte auf die Antwort:
205
+
206
+ > „Waren in der Vorführung echte Daten von Menschen zu sehen — Kundennamen, Mailadressen?"
207
+
208
+ **Ja:** Dann gehen die vier Fragen aus `kontext/sicherheit.md` (im Arbeitsplatz über der Werkbank)
209
+ **jetzt**, vor dem Lesen — einzeln, jede mit Vorschlag: welche Felder · wohin (an Anthropic, die
210
+ Firma hinter Claude, Rechenzentren in den USA) · auf welcher Grundlage · geht es sparsamer, z. B.
211
+ noch einmal mit Testkunden. Die Antworten schreibst du nach `ergebnisse/datenschutz-vorfuehrung.md`.
212
+ Ist die Antwort „noch einmal mit Testkunden", lies nichts, schlag vor, diese Aufnahme zu löschen
213
+ (Schritt 13, Satz **ohne** Plan), und fang bei Schritt 5 neu an.
214
+
215
+ Dann diese Frage, wörtlich:
216
+
217
+ > „Damit ich die Zeitleiste lesen kann, geht sie an Anthropic: was du gesagt hast, wohin du
218
+ > geklickt hast (mit den Namen der Knöpfe und Felder, darin können Namen stehen) und was du
219
+ > getippt hast. Bildschirmfotos zeigen deinen ganzen Bildschirm — die schaue ich mir nur an, wo
220
+ > der Text nicht reicht, und frage dich vor jedem einzeln. Soll ich die Datei für dich öffnen,
221
+ > damit du vorher hineinsehen kannst? Einverstanden — oder lieber ohne die getippten Stellen?"
222
+
223
+ - **„Öffnen":** in Notepad, wie in Regel 2 (`cmd //c start "" notepad "<voller pfad>"` bzw.
224
+ `Start-Process`), mit dem vollen Pfad zur `zeitleiste.md` (Projektordner plus der Pfad aus
225
+ Schritt 9). Der Mensch liest selbst; du liest nicht mit. Danach dieselbe Frage nach dem
226
+ Einverständnis noch einmal.
227
+ - **„Ohne die getippten Stellen":** `kimal3 zeigen auswerten --ohne-getipptes` — mit demselben
228
+ `--sprache` wie beim ersten Mal, falls du eins gesetzt hattest, und mit derselben Wartezeit-Regel
229
+ wie in Schritt 9. Die Zeitleiste wird neu geschrieben, Getipptes steht dann als
230
+ „[getippt, ausgelassen]". Der Mensch hat damit dieser Fassung zugestimmt → Schritt 11.
231
+ - **Einverstanden:** → Schritt 11.
232
+ - **Nein:** Lies nichts. Sag: „Du kannst die Datei selbst lesen und mir die Aufgabe beschreiben —
233
+ oder ich lösche die Aufnahme."
234
+ - **Beschreibt der Mensch selbst:** Nimm seine Beschreibung, frag wie in Schritt 11, Punkt 4,
235
+ nach (eine Frage auf einmal), und weiter mit Schritt 12 — Plan und Bauweg **aus der
236
+ Beschreibung**, ohne etwas aus der Aufnahme zu lesen. Danach Schritt 13.
237
+ - **Löschen:** Schritt 13, Satz **ohne** Plan.
238
+
239
+ ## 11. Lesen, zurückerzählen, nachfragen
240
+
241
+ Jetzt — und erst jetzt — liest du `zeitleiste.md`, und nur diese Datei.
242
+
243
+ 1. **Erzähl die Aufgabe zurück:** in nummerierten Schritten, in den **Worten des Menschen** (zitier,
244
+ was gesagt wurde), je Schritt mit dem Zeitpunkt aus der Zeitleiste (`0:26`).
245
+ 2. **Such die Widersprüche, ausdrücklich.** Drei Quellen sagen etwas über die Aufgabe: der
246
+ Aufgabensatz im Kopf der Zeitleiste, was der Mensch **sagt**, und was er **anklickt und tippt**.
247
+ Geh den Aufgabensatz Teil für Teil durch (was, wohin, an wen, wann) und frag bei jedem Teil:
248
+ Zeigt die Vorführung genau das? Dann jeden gesprochenen Satz gegen den Klick daneben. Jede
249
+ Stelle, an der zwei Quellen auseinandergehen, nennst du im Zurückerzählen mit ⚠️ — zum Beispiel:
250
+ „Du hast auf ‚morgen‘ geklickt, aber gesagt ‚für den aktuellen Tag‘ — was gilt?" oder „Im
251
+ Aufgabensatz steht ‚in einen Channel‘, vorgemacht hast du eine Direktnachricht — was gilt?"
252
+ *Genau diese Stellen sind der Grund, warum Vormachen mehr verrät als Beschreiben.*
253
+ 3. **Bildschirmfotos nur einzeln und nur gefragt.** Reicht der Text an einer Stelle nicht (ein
254
+ Klick ohne Namen, ein Satz, der auf etwas Sichtbares zeigt), frag vorher: „Bei 0:26 sagt der
255
+ Text nur ‚…‘. Darf ich mir den Bildschirm an der Stelle ansehen?" Ja → `kimal3 zeigen bild 0:26`;
256
+ es meldet „Bild: <pfad>", und du siehst dir **nur dieses eine** Bild an. Nein → frag, was dort
257
+ zu sehen war.
258
+ 4. **Dann fragen — eine Frage auf einmal, immer mit Vorschlag:** zuerst die Widersprüche, einer
259
+ nach dem anderen. Danach, was eine einzige Vorführung nie zeigen kann: **wie oft und wann**
260
+ („Ich vermute jeden Montag früh — stimmt das?") · **was bei einer Ausnahme passiert**
261
+ (Feiertag, leere Liste, das System ist nicht erreichbar) · **an wen das Ergebnis geht**.
262
+
263
+ ## 12. In den Plan schreiben und einen Bauweg vorschlagen
264
+
265
+ Schreib `plan/aufgabe-vorgefuehrt.md` mit diesen Teilen:
266
+
267
+ - **Ziel** in einem Satz
268
+ - **Die Schritte**, nummeriert
269
+ - **Regeln und Ausnahmen** aus den Antworten
270
+ - **Was offen ist**
271
+ - **Woher es stammt:** Vorführung vom <Datum> (oder: Beschreibung vom <Datum>, wenn nichts gelesen
272
+ wurde)
273
+
274
+ Der Plan trägt den Inhalt **selbst** und verweist nicht auf Dateien in der Aufnahme — die soll
275
+ gleich weg. Getipptes, das nach Zugangsdaten aussieht, kommt nicht hinein.
276
+
277
+ Dann sag, wie du es **bauen würdest**: über die Schnittstellen der Programme (die Daten direkt
278
+ holen, die Nachricht direkt schicken), **nicht** durch Nachklicken der Klicks — so bricht es
279
+ nicht, wenn sich eine Oberfläche ändert. Gebaut wird nicht hier; das ist der nächste Schritt im
280
+ Projekt, gern gleich oder in der nächsten Sitzung mit `/k3start`.
281
+
282
+ ## 13. Die Aufnahme löschen — nur nach Ja
283
+
284
+ Miss die Größe des Aufnahmeordners und schlag vor, mit den echten Werten. Steht die Aufgabe im
285
+ Plan (Schritt 12):
286
+
287
+ > „Die Aufnahme ist 12,9 MB groß und liegt in `material/aufnahmen/2026-10-19-0912`. Ich würde sie
288
+ > löschen — die Beschreibung steht im Plan, und in der Aufnahme steckt alles, was du getippt hast.
289
+ > Was ich davon gelesen habe, steht noch im Gesprächsverlauf auf diesem Rechner. Passt das?"
290
+
291
+ Kommt der Vorschlag ohne Plan (Nein in Schritt 10, oder „noch einmal mit Testkunden"), lass den
292
+ Satz über den Plan weg:
293
+
294
+ > „Die Aufnahme ist 12,9 MB groß und liegt in `material/aufnahmen/2026-10-19-0912`. Ich würde sie
295
+ > löschen — in der Aufnahme steckt alles, was du getippt hast. Was ich davon gelesen habe, steht noch
296
+ > im Gesprächsverlauf auf diesem Rechner. Passt das?"
297
+
298
+ - **Ja:** Lösch **genau diesen einen** Ordner — nicht `material/aufnahmen/` als Ganzes, nicht die
299
+ `.gitignore` und `.ignore` daneben — und sieh nach, dass er weg ist.
300
+ - **Nein:** Er bleibt liegen. Sag, wo, und dass er nicht in Git landet.
301
+
302
+ Zum Schluss in zwei Sätzen ohne Fachjargon, was jetzt im Projekt steht, und **ein** konkreter
303
+ nächster Schritt.
package/skill/en/SKILL.md CHANGED
@@ -13,7 +13,7 @@ description: Add projects to the kimal3 success profile or list them, analyse co
13
13
  As soon as the person says a project is finished, or explicitly asks for it to be added.
14
14
  **Or** when they want to set up their AI Workplace — then see “Setting up the workplace”.
15
15
 
16
- ## The eight slash commands the person has
16
+ ## The nine slash commands the person has
17
17
 
18
18
  `kimal3 skill install` puts them in the global folder (`~/.claude/commands/`) — so the person can
19
19
  type them in **any** folder. They are the route the person triggers themselves; this skill is the
@@ -24,11 +24,12 @@ route you recognise.
24
24
  | `/k3` | Where they stand — and all kimal3 commands at a glance |
25
25
  | `/k3start` | Start a session: where the project stands and what comes next |
26
26
  | `/k3wrapup` (German: `/k3feierabend`) | End a session cleanly: save the status, tidy up, summarise |
27
- | `/k3course` (German: `/k3kurs`) | Back into the Mini course — picking up where they left off |
27
+ | `/k3course` (German: `/k3kurs`) | Back into the Mini course — fetches the status with `kimal3 course` and picks up where they left off |
28
28
  | `/k3project` (German: `/k3projekt`) | Add a finished project to the success profile |
29
29
  | `/k3list` (German: `/k3liste`) | Show the projects they have added |
30
30
  | `/k3analyse` | Fetch company data and answer their question about it |
31
31
  | `/k3context` (German: `/k3kontext`) | Answer the open questions about their company in conversation |
32
+ | `/k3show` (German: `/k3zeigen`) | Show a task instead of describing it — records with `kimal3 show …`, evaluates on the computer and writes the plan; nothing is read before their yes |
32
33
 
33
34
  `/k3`, `/k3start` and `/k3analyse` have the same name in German. Colleagues whose account is set to German have the German names — if someone says they ran `/k3feierabend`, that is `/k3wrapup`.
34
35
 
@@ -39,7 +40,7 @@ of pointing to a command.
39
40
 
40
41
  ⚠️ **`/k3start`, `/k3wrapup` and `/k3course` came ONLY with the course folder up to 0.2.4** — Pro
41
42
  customers without the Mini course never had them, and they could not be updated at all. Since 0.2.5
42
- the program delivers all eight. *If you meet someone on an older version, a missing command there
43
+ the program delivers all of them. *If you meet someone on an older version, a missing command there
43
44
  is not an error but the old state.*
44
45
 
45
46
  ## 🔴 Several companies: YOU DO NOT CHOOSE
@@ -157,8 +158,7 @@ same — **because it is the right one**, not because the trap is still open.
157
158
  together — there are four different ones. Search for square brackets instead of following a list:
158
159
  a typed-out list goes out of date the moment the template grows. Ask, instead of guessing.
159
160
 
160
- ⚠️ You will usually find `[FIRMA]` already filled in — the server puts the name in when it delivers the folder.
161
- `[DATUM]` likewise. What is left are the details about the **person** in front of you.
161
+ ⚠️ You will usually find `[FIRMA]` already filled in — the server puts the name in when it delivers the folder. What is left are the details about the **person** in front of you.
162
162
 
163
163
  🔴 **Only in the workbench — nowhere else.** The top-level `CLAUDE.md` and everything in `context/` (`kontext/` in a German company)
164
164
  belong to the **company**, not to the person in front of you. The server puts in the company name
@@ -357,6 +357,11 @@ a legal right of co-determination over it. That is for the company to decide, no
357
357
  - “If you were running the company, what would you automate next, measured against what has
358
358
  worked so far — and which of it can be carried over to other departments?”
359
359
 
360
+ ## Reading the course status (`kimal3 course`)
361
+ Shows where the person stands in the Mini course: one line per part, `Next:` with the next step and, behind it, who ticks
362
+ it off — "(you tick it off)" or "(Claude sets it)". Exit code `2` means not signed in, `3` not reachable — then **do not
363
+ retell the course from memory**. The slash command `/k3course` leads through it.
364
+
360
365
  ## Exit codes
361
366
  `0` done · `1` **Retrying won't help — READ THE MESSAGE** · `2` sign-in missing ·
362
367
  `3` temporary problem, retry once · `4` signed in, but no Pro access —
@@ -84,17 +84,18 @@ Show the list in two groups:
84
84
  | `/k3project <what you built>` (German: `/k3projekt`) | Add a finished project to the success profile |
85
85
  | `/k3list` (German: `/k3liste`) | Show the projects you have added |
86
86
  | `/k3analyse <your question>` | Fetch company data and answer your question about it |
87
+ | `/k3show` (German: `/k3zeigen`) | Show a task instead of describing it — I record it and turn it into a plan |
87
88
 
88
89
  Also tell them: the slash commands are the **safe** route — you don't have to remember any sentence.
89
90
  It works without them too: “the project is finished” is enough, and then I use the skill.
90
91
 
91
- ## 6. The ninth entry in the menu: `/kimal3` is NOT a command
92
+ ## 6. The tenth entry in the menu: `/kimal3` is NOT a command
92
93
 
93
94
  The same `/` list also shows **`/kimal3`**. Explain the difference **without being asked** — the
94
95
  menu throws two different kinds into one list, and that is exactly what tripped up the first
95
96
  person who saw the family (Dennis, 19 August 2026):
96
97
 
97
- - The eight **`/k3…`** are **slash commands** (files in `~/.claude/commands/`) — **the person**
98
+ - The nine **`/k3…`** are **slash commands** (files in `~/.claude/commands/`) — **the person**
98
99
  types them on purpose.
99
100
  - **`/kimal3`** is the **skill** (`~/.claude/skills/kimal3/SKILL.md`) — my
100
101
  operating manual. It is the reason “the project is finished” is enough: I open it
@@ -102,5 +103,5 @@ person who saw the family (Dennis, 19 August 2026):
102
103
  names several things at once and doesn't read like a menu item.
103
104
 
104
105
  Also say what `/kimal3` is **not**: **not the installation.** That is `kimal3 skill install`
105
- in the terminal — the one command that puts both in place, the skill **and** the eight `/k3…`.
106
+ in the terminal — the one command that puts both in place, the skill **and** the nine `/k3…`.
106
107
  What appears in the menu is its result.