kimal3 0.2.9 → 0.3.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 (67) hide show
  1. package/README.md +135 -0
  2. package/dist/api.js +16 -7
  3. package/dist/arbeitsplatz-dateien.js +62 -30
  4. package/dist/argumente.js +25 -97
  5. package/dist/befehle/arbeitsplatz.js +51 -68
  6. package/dist/befehle/firma-daten.js +24 -26
  7. package/dist/befehle/kontext-fragen.js +62 -44
  8. package/dist/befehle/kontext-gemeinsam.js +86 -43
  9. package/dist/befehle/kontext-hoch.js +40 -46
  10. package/dist/befehle/kontext-runter.js +70 -51
  11. package/dist/befehle/login.js +23 -9
  12. package/dist/befehle/logout.js +9 -4
  13. package/dist/befehle/projekt-liste.js +24 -29
  14. package/dist/befehle/projekt-neu.js +25 -31
  15. package/dist/befehle/skill-install.js +78 -49
  16. package/dist/befehle/skill-tausch.js +28 -0
  17. package/dist/befehle/wache.js +12 -6
  18. package/dist/befehle/werkbank.js +118 -88
  19. package/dist/befehle-katalog-en.js +185 -0
  20. package/dist/befehle-katalog.js +10 -49
  21. package/dist/befehlswoerter.js +69 -0
  22. package/dist/einstellungen-mischen.js +2 -2
  23. package/dist/einstellungen-schreiben.js +8 -5
  24. package/dist/fehler.js +5 -5
  25. package/dist/firmen-liste.js +42 -5
  26. package/dist/format.js +41 -0
  27. package/dist/fragen-lesen.js +3 -3
  28. package/dist/hilfe.js +24 -0
  29. package/dist/kimal3.js +77 -71
  30. package/dist/kontext-dateien.js +30 -23
  31. package/dist/kontext-hoch-zeile.js +5 -3
  32. package/dist/kontext-rat.js +151 -0
  33. package/dist/kontext-stand.js +68 -210
  34. package/dist/nachricht.js +39 -15
  35. package/dist/projekt-neu-firma.js +9 -9
  36. package/dist/projekt-zeilen.js +40 -54
  37. package/dist/slash-befehle.js +36 -0
  38. package/dist/sprache.js +114 -0
  39. package/dist/texte/allgemein.js +99 -0
  40. package/dist/texte/arbeitsplatz.js +135 -0
  41. package/dist/texte/kontext-hoch.js +128 -0
  42. package/dist/texte/kontext.js +171 -0
  43. package/dist/texte/projekte.js +126 -0
  44. package/dist/texte/skill.js +87 -0
  45. package/dist/texte/wache.js +36 -0
  46. package/dist/texte/werkbank.js +161 -0
  47. package/dist/wache-rechnung.js +27 -40
  48. package/dist/wache-schalter.js +40 -5
  49. package/dist/werkbank-name.js +28 -10
  50. package/dist/wort.js +98 -0
  51. package/package.json +27 -27
  52. package/skill/SKILL.md +18 -10
  53. package/skill/commands/k3.md +1 -1
  54. package/skill/commands/k3feierabend.md +99 -97
  55. package/skill/commands/k3kontext.md +2 -2
  56. package/skill/commands/k3kurs.md +6 -5
  57. package/skill/commands/k3start.md +2 -1
  58. package/skill/en/SKILL.md +451 -0
  59. package/skill/en/commands/k3.md +106 -0
  60. package/skill/en/commands/k3analyse.md +59 -0
  61. package/skill/en/commands/k3context.md +92 -0
  62. package/skill/en/commands/k3course.md +54 -0
  63. package/skill/en/commands/k3list.md +26 -0
  64. package/skill/en/commands/k3project.md +50 -0
  65. package/skill/en/commands/k3start.md +47 -0
  66. package/skill/en/commands/k3wrapup.md +99 -0
  67. package/dist/zz-kaputt.js +0 -1
package/skill/SKILL.md CHANGED
@@ -81,7 +81,7 @@ Ergebnis.** Der erste wurde 2026-08-18 repariert, der zweite blieb weitere zwei
81
81
  frisch bei Pro und weiß nicht, wo er anfangen soll.
82
82
 
83
83
  🔴 **Zuerst EINE Frage klären, bevor du irgendetwas vorschlägst: Gibt es den Firmen-Ordner
84
- schon?** Sieh nach, ob neben dir ein `kontext/`-Ordner liegt (oder frag).
84
+ schon?** Sieh nach, ob neben dir ein `kontext/`-Ordner (in einer englischen Firma `context/`) liegt (oder frag).
85
85
 
86
86
  | Lage | Befehl |
87
87
  |---|---|
@@ -89,16 +89,16 @@ schon?** Sieh nach, ob neben dir ein `kontext/`-Ordner liegt (oder frag).
89
89
  | Firmen-Ordner steht schon — du brauchst nur deinen eigenen Platz | `kimal3 werkbank neu <vorname>` |
90
90
 
91
91
  ```
92
- kimal3 arbeitsplatz neu # legt KI-Arbeitsplatz/ an (ganze Familie)
92
+ kimal3 arbeitsplatz neu # legt KI-Arbeitsplatz/ an (ganze Familie; englische Firma: AI-Workplace/)
93
93
  kimal3 arbeitsplatz neu sabine # dasselbe, Werkbank heisst werkbank-sabine
94
94
  kimal3 werkbank neu # nur die Werkbank, im bestehenden Firmen-Ordner
95
95
  kimal3 werkbank neu sabine # dasselbe, Ordner heisst werkbank-sabine
96
96
  ```
97
97
 
98
98
  🔴 **Das Argument ist der NAME DES MENSCHEN, nicht der Ordnername** (seit 2026-08-20). Der
99
- oberste Ordner heißt **immer** `KI-Arbeitsplatz`; mehrere Firmen trennt man über den Ordner
99
+ oberste Ordner heißt **immer** `KI-Arbeitsplatz` (in einer englischen Firma `AI-Workplace`); mehrere Firmen trennt man über den Ordner
100
100
  darüber (`Kunden/ARNO/KI-Arbeitsplatz/`). Der Name wirkt eine Ebene tiefer: aus `sabine` wird
101
- `werkbank-sabine`.
101
+ `werkbank-sabine` (bei englischem Konto `workbench-sabine`).
102
102
 
103
103
  ⚠️ **Ohne Angabe rät der Befehl nicht** — der Server bildet den Namen aus der Anmelde-Adresse.
104
104
  Das ist meist richtig, aber nicht immer schön (`s.mueller@…` wird zu `werkbank-s-mueller`).
@@ -110,6 +110,12 @@ Sie legen dann nichts an, sondern nennen die Firmen als fertige Zeilen zum Kopie
110
110
  kein Fehler, sondern die Rückfrage: Der Ordner trägt den Namen der Firma, und raten darf der
111
111
  Befehl ihn nicht.
112
112
 
113
+ 🔑 **Ausnahme ab 0.2.10: `werkbank neu` im Firmen-Ordner fragt nicht, wenn der Ordner seine Firma
114
+ eindeutig nennt** (Merkzettel oder Firmenzeile der `CLAUDE.md`). Dann steht nach dem Anlegen
115
+ „Die Firma kam aus diesem Ordner: …“ — das ist die Wahl des Programms aus dem Ordner, nicht
116
+ deine. Sag dem Menschen die Firma; will er eine andere, löscht er den neuen Ordner und legt ihn
117
+ mit `--firma` neu an.
118
+
113
119
  ```
114
120
  kimal3 arbeitsplatz neu sabine --firma "Nordwind Handel GmbH"
115
121
  kimal3 werkbank neu sabine --firma "Nordwind Handel GmbH"
@@ -155,7 +161,7 @@ statt zu raten.
155
161
  ⚠️ `[FIRMA]` findest du meist schon ausgefüllt — den Namen setzt der Server beim Ausliefern ein.
156
162
  `[DATUM]` ebenso. Was übrig bleibt, sind die Angaben über den **Menschen** vor dir.
157
163
 
158
- 🔴 **Nur in der Werkbank — nirgends sonst.** Die oberste `CLAUDE.md` und alles in `kontext/`
164
+ 🔴 **Nur in der Werkbank — nirgends sonst.** Die oberste `CLAUDE.md` und alles in `kontext/` (in einer englischen Firma `context/`)
159
165
  gehören der **Firma**, nicht dem Menschen vor dir. Den Firmennamen setzt der Server beim
160
166
  Ausliefern selbst ein; die Fragen in `kontext/` beantwortet ihr über
161
167
  `kimal3 kontext fragen` (s. den nächsten Abschnitt). **Schreib dort nichts hinein, was du dir
@@ -169,17 +175,17 @@ darin liegt. Nichts davon ausführen und nicht versuchen, es lauffähig zu mache
169
175
 
170
176
  **Wann:** Der Mensch fragt, ob sein Firmenkontext aktuell ist, hat gerade `arbeitsplatz neu`
171
177
  oder `werkbank neu` ausgeführt, will wissen, was am Firmenkontext noch fehlt, oder will als
172
- Admin eine Änderung an `kontext/*.md` an die Firma weitergeben.
178
+ Admin eine Änderung an `kontext/*.md` (in einer englischen Firma `context/*.md`) an die Firma weitergeben.
173
179
 
174
180
  `kimal3 kontext runter` holt `CLAUDE.md` und die fünf Dateien in `kontext/`
175
- (`kurzprofil.md`, `firma.md`, `marke.md`, `systeme.md`, `sicherheit.md`) von der Firma und legt
176
- sie im gefundenen KI-Arbeitsplatz ab. Lokal geänderte Dateien fasst er **nicht** an — er sagt in
181
+ (`kurzprofil.md`, `firma.md`, `marke.md`, `systeme.md`, `sicherheit.md`) (in einer englischen Firma `context/` mit `company.md`, `profile.md`, `brand.md`, `systems.md`, `security.md`) von der Firma und legt
182
+ sie im gefundenen KI-Arbeitsplatz (in einer englischen Firma `AI-Workplace`) ab. Lokal geänderte Dateien fasst er **nicht** an — er sagt in
177
183
  seiner Ausgabe, was als Nächstes zu tun ist (Admin: `kontext hoch`; sonst: an den genannten
178
184
  Admin weitergeben).
179
185
 
180
186
  ### Den Firmenkontext ausfüllen — der Ablauf
181
187
 
182
- In `kontext/` stehen **Fragen über die Firma**, keine Lückentexte. Beantwortet werden sie im
188
+ In `kontext/` (in einer englischen Firma `context/`) stehen **Fragen über die Firma**, keine Lückentexte. Beantwortet werden sie im
183
189
  Gespräch mit dir — oder in der App unter **Firma → Kontext**. Beide Wege führen an dieselbe
184
190
  Stelle.
185
191
 
@@ -223,7 +229,9 @@ selbst schreibt, ist in Ordnung; ein Satz, den du dir ausdenkst, nicht.
223
229
  ⚠️ **Sieht eine der fünf Dateien nicht mehr aus wie ihre Frageliste — etwa weil etwas Fremdes
224
230
  darüberkopiert wurde —, bricht `kontext hoch` ab und schickt gar nichts, auch die vier anderen
225
231
  nicht** (Rückgabewert `1`). Das ist **kein** „noch einmal versuchen": Sag dem Menschen, welche
226
- Datei gemeint ist, und hol sie mit `kimal3 kontext runter` zurück.
232
+ Datei gemeint ist. Zurück holt sie `kimal3 kontext runter` nur, wenn sie **fehlt** — eine
233
+ bearbeitete Datei fasst es nicht an. Also: Datei umbenennen (etwa `firma-alt.md`), dann
234
+ `kimal3 kontext runter`; die Fassung der Firma kommt frisch, seine bleibt daneben liegen.
227
235
 
228
236
  🔴 **Bei `kontext hoch` sagt die Zahl `1` allein GAR NICHTS — die Meldung sagt es. LIES SIE.**
229
237
 
@@ -49,7 +49,7 @@ fehlt. Auch `4` (kein Pro-Zugang) ist hier **kein** Grund zu schweigen.
49
49
  | Lage | Was du sagst |
50
50
  |---|---|
51
51
  | `--version` sagt `Nicht angemeldet.` | `! kimal3 login` — **der Mensch tippt das selbst**, er bestätigt im Browser. Das kann ich nicht für ihn tun. |
52
- | Angemeldet, aber `kontext fragen` bricht mit `1` und „Hier steht kein KI-Arbeitsplatz" ab | 🔴 **Rate hier NICHT sofort `arbeitsplatz neu`.** Die Meldung heißt „ich habe von hier aufwärts keinen gefunden" — nicht „es gibt keinen". Der häufigere Fall ist, dass der Mensch schlicht woanders steht; die CLI selbst rät deshalb „Wechsle in deinen Arbeitsplatz-Ordner". **Frag erst: „Hast du schon einen KI-Arbeitsplatz-Ordner?"** Ja → dorthin wechseln und noch einmal. Nein → `! kimal3 arbeitsplatz neu`, vom Menschen getippt. ⚠️ Wer hier falsch rät, legt einen **zweiten, leeren** Arbeitsplatz an; der Firmenkontext steht danach in zwei Ordnern, und `kontext hoch` schickt aus dem falschen. |
52
+ | Angemeldet, aber `kontext fragen` bricht mit `1` und „Hier steht kein KI-Arbeitsplatz" ab | 🔴 **Rate hier NICHT sofort `arbeitsplatz neu`.** Die Meldung heißt „ich habe von hier aufwärts keinen gefunden" — nicht „es gibt keinen". Der häufigere Fall ist, dass der Mensch schlicht woanders steht; die CLI selbst rät deshalb „Wechsle in deinen Arbeitsplatz-Ordner". **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`, vom Menschen getippt. ⚠️ Wer hier falsch rät, legt einen **zweiten, leeren** Arbeitsplatz an; der Firmenkontext steht danach in zwei Ordnern, und `kontext hoch` schickt aus dem falschen. |
53
53
  | Arbeitsplatz da, Fragen offen | `/k3kontext` — ich stelle die Fragen einzeln. |
54
54
  | `projekt liste` sagt „Du hast noch kein Erfolgsprofil" | Das Profil entsteht im Kurs. Nenn die Adresse aus seiner Meldung (`…/profil`) — **nicht** `/k3projekt`: Ohne Profil gibt es nichts, worin ein Projekt stehen könnte. |
55
55
  | Alles beantwortet, Profil da, aber keine Projekte | `/k3projekt <was du gebaut hast>` |
@@ -1,97 +1,99 @@
1
- ---
2
- description: Sitzung sauber beenden — Stand sichern, aufräumen, zusammenfassen
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
- # Feierabend
9
-
10
- > Sauberer Sitzungs-Abschluss: Stand sichern, aufräumen, zusammenfassen — damit der nächste
11
- > Start (in diesem oder einem anderen Projekt) sauber weitergeht.
12
-
13
- Führe die Schritte der Reihe nach aus. Bleib im Coaching-Ton: erklär kurz, was du tust, und hol
14
- dir **vor dem Veröffentlichen (Push)** ein OK. Ist ein Schritt hier nicht relevant, sag das kurz
15
- und überspring ihn — kein Leerlauf.
16
-
17
- ## 1. Stand sichten
18
- - Ist es ein Git-Repo? Dann `git status` + `git diff --stat`: Was wurde in dieser Sitzung
19
- geändert? Fass es in 1–2 Sätzen zusammen.
20
- - Kein Git-Repo? Sag das kurz und biete an, eins einzurichten (Sicherheitsnetz) — erzwing nichts.
21
-
22
- ## 2. Status-Datei nachziehen — und aufräumen
23
- Die Status-Datei (`WEITER-HIER.md` oder `ROADMAP.md`) ist der Zettel für den nächsten Start. Sie
24
- taugt nur, solange man sie in einem Atemzug lesen kann. **Jeder Feierabend schreibt etwas dazu —
25
- also muss auch jeder Feierabend etwas wegräumen**, sonst wächst sie, bis niemand sie mehr liest.
26
-
27
- Gibt es keine Status-Datei und die Arbeit wächst über eine Sitzung hinaus: eine vorschlagen,
28
- dann weiter mit Schritt 3.
29
-
30
- 1. **Nachziehen:** „Wo wir stehen" und „nächster Schritt" auf das setzen, was heute passiert ist.
31
- 2. **Wegräumen, was nicht mehr gilt.** Ins Archiv wandert:
32
- - was **erledigt** ist (fertige Aufgaben, abgehakte Punkte),
33
- - die Geschichten **früherer Sitzungen** („Davor …", „Stand vom …") — in „Wo wir stehen" bleibt
34
- nur der heutige Stand,
35
- - was im Text **widerlegt oder überholt** ist.
36
- Was bleibt: der aktuelle Stand, der nächste Schritt, die offenen Punkte, und je Idee für später
37
- **höchstens zwei Sätze** — Ausführliches bekommt eine eigene Datei, die Status-Datei verlinkt sie.
38
- 3. **Ins Archiv heißt: verschieben, nicht löschen.** Gibt es schon ein Archiv (steht meist im Kopf
39
- der Status-Datei), dorthin; sonst `WEITER-HIER-archiv.md` daneben anlegen. Unten anhängen, mit
40
- dem heutigen Datum als Überschrift, **im Wortlaut** — das Warum früherer Entscheidungen soll
41
- auffindbar bleiben.
42
- 4. **Messen statt schätzen:** Zeilen der Status-Datei **vorher und nachher zählen**. Steht in ihrem
43
- Kopf eine Zielgröße, gilt die, sonst **150 Zeilen**. Liegt sie danach noch drüber, weiter
44
- wegräumen — oder sag laut, warum der Rest bleiben muss. Prüf danach im Archiv nach, dass das
45
- Verschobene wirklich dort steht (eine Zeile daraus suchen), bevor du es als erledigt meldest.
46
- 5. **Sag laut, was du geändert hast:** was neu drinsteht, was ins Archiv ging, Zeilen vorher → nachher.
47
-
48
- ## 3. Gelernte Regeln — gehört etwas festgehalten?
49
- **Nur bei echtem Anlass**, nicht als Pflichtübung. Ein Anlass ist: Ich habe dich heute korrigiert,
50
- eine Arbeitsweise ausdrücklich gewollt, oder dieselbe Art Frage zum dritten Mal gleich beantwortet.
51
- Kein Anlass? Sag das in einem Halbsatz und geh weiter.
52
-
53
- Gibt es einen, **schlag die Regel vor** — ein Satz, was du künftig anders machst, dazu Datum und
54
- Anlass in einem Satz — und trag sie erst nach meinem OK ein. Wohin, hängt davon ab, was sie ist:
55
-
56
- | Was ist es? | Wohin |
57
- |---|---|
58
- | **Eine Arbeitsregel** — wie du arbeiten, fragen, prüfen, erklären sollst | `~/.claude/rules/kimal3-coach.md`, **unten** im Abschnitt „Gelernte Regeln" (neueste unten) |
59
- | **Etwas über mich** — wer ich bin, meine Rollen, meine Werkzeuge | meine `~/.claude/CLAUDE.md` |
60
- | **Etwas über dieses Projekt** — Aufbau, Werkzeuge, Fallen | die `CLAUDE.md` im Projektordner |
61
-
62
- 🔬 **Vorher nachsehen, ob es die Regel schon gibt** — im Coach und in den CLAUDE.md-Dateien. Steht
63
- sie schon da, trag sie **nicht** doppelt ein: Sag mir, wo sie steht und dass sie heute nicht
64
- gegriffen hat. Eine Regel, die zweimal dasteht, wird nicht besser befolgt.
65
- ⚠️ **Gibt es `~/.claude/rules/kimal3-coach.md` nicht**, kommt auch eine Arbeitsregel in meine
66
- `~/.claude/CLAUDE.md`. Leg die Coach-Datei **nicht** selbst an — sie gehört kimal3.
67
- 🔴 **Im Coach änderst du NUR den Abschnitt „Gelernte Regeln"** und schreibst nur unten dazu. Alles
68
- darüber ist die Vorlage von kimal3 — dort änderst du nichts.
69
-
70
- Sag danach laut, **welcher Satz in welcher Datei** steht (vollständiger Pfad). Der Ordner
71
- `~/.claude` ist meist kein Git-Repo — die Datei ist dann nicht über Git gesichert; sag das dazu.
72
-
73
- ## 4. Projekt aufräumen (leichtgewichtig)
74
- - Offensichtlichen Müll entfernen (`.DS_Store`, `*.tmp`, `*.log`, `__pycache__`).
75
- - Bei allem Unklaren: **nicht** löschen — auflisten und mich fragen.
76
-
77
- ## 5. Sichern (mit meinem OK)
78
- - Stage die relevanten Änderungen **Datei für Datei** — **niemals** Secrets oder `.env*`, und kein
79
- `git add -A`, das fremde Arbeit mitnimmt.
80
- - Zeig mir kurz, was in den Commit geht — **und was bewusst draußen bleibt**: Dateien, die Git noch
81
- nicht kennt und die nicht aus dieser Sitzung stammen, stehen mit Namen und einem Satz, was sie
82
- sind, in derselben Liste. (Sie kommen oft aus einer anderen Sitzung und fallen sonst niemandem
83
- auf.) Mein OK zum Commit gilt für die ganze Liste; will ich eine davon doch dabeihaben, sage ich es.
84
- - Schlag eine Commit-Nachricht vor.
85
- - Nach meinem OK: committen.
86
- - **Pushen, je nach Projekt:** Prüf mit `git remote`, ob es überhaupt ein Ziel gibt.
87
- - Kein Ziel: sag das kurz — der Commit ist dann die Sicherung, fertig.
88
- - Ein Ziel: **frag, ob du pushen sollst** (der Schritt „nach außen"). Steht in der
89
- Projekt-`CLAUDE.md`, dass ein Push etwas auslöst (zum Beispiel die Live-Seite neu ausliefert),
90
- sag das dazu. Erst nach meiner Bestätigung `git push`.
91
-
92
- ## 6. Zusammenfassen & Abschied
93
- - 2–3 Sätze **ohne Fachjargon**: Was haben wir heute geschafft, was habe ich gelernt — und in
94
- einem Satz, was aufgeräumt wurde.
95
- - **Ein** konkreter, kleiner nächster Schritt fürs nächste Mal (der Cliffhanger — klein halten).
96
- - Kurzer, freundlicher Abschied wie ein guter Kollege, der Feierabend macht. Warte auf meine
97
- Antwort, bevor die Sitzung endet.
1
+ ---
2
+ description: Sitzung sauber beenden — Stand sichern, aufräumen, zusammenfassen
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
+ # Feierabend
9
+
10
+ > Sauberer Sitzungs-Abschluss: Stand sichern, aufräumen, zusammenfassen — damit der nächste
11
+ > Start (in diesem oder einem anderen Projekt) sauber weitergeht.
12
+
13
+ Führe die Schritte der Reihe nach aus. Bleib im Coaching-Ton: erklär kurz, was du tust, und hol
14
+ dir **vor dem Veröffentlichen (Push)** ein OK. Ist ein Schritt hier nicht relevant, sag das kurz
15
+ und überspring ihn — kein Leerlauf.
16
+
17
+ ## 1. Stand sichten
18
+ - Ist es ein Git-Repo? Dann `git status` + `git diff --stat`: Was wurde in dieser Sitzung
19
+ geändert? Fass es in 1–2 Sätzen zusammen.
20
+ - Kein Git-Repo? Sag das kurz und biete an, eins einzurichten (Sicherheitsnetz) — erzwing nichts.
21
+
22
+ ## 2. Status-Datei nachziehen — und aufräumen
23
+ Die Status-Datei (`WEITER-HIER.md` oder `ROADMAP.md`) ist der Zettel für den nächsten Start. Sie
24
+ taugt nur, solange man sie in einem Atemzug lesen kann. **Jeder Feierabend schreibt etwas dazu —
25
+ also muss auch jeder Feierabend etwas wegräumen**, sonst wächst sie, bis niemand sie mehr liest.
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`.
28
+
29
+ Gibt es keine Status-Datei und die Arbeit wächst über eine Sitzung hinaus: eine vorschlagen,
30
+ dann weiter mit Schritt 3.
31
+
32
+ 1. **Nachziehen:** „Wo wir stehen" und „nächster Schritt" auf das setzen, was heute passiert ist.
33
+ 2. **Wegräumen, was nicht mehr gilt.** Ins Archiv wandert:
34
+ - was **erledigt** ist (fertige Aufgaben, abgehakte Punkte),
35
+ - die Geschichten **früherer Sitzungen** („Davor …", „Stand vom …") — in „Wo wir stehen" bleibt
36
+ nur der heutige Stand,
37
+ - was im Text **widerlegt oder überholt** ist.
38
+ Was bleibt: der aktuelle Stand, der nächste Schritt, die offenen Punkte, und je Idee für später
39
+ **höchstens zwei Sätze** — Ausführliches bekommt eine eigene Datei, die Status-Datei verlinkt sie.
40
+ 3. **Ins Archiv heißt: verschieben, nicht löschen.** Gibt es schon ein Archiv (steht meist im Kopf
41
+ 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
42
+ dem heutigen Datum als Überschrift, **im Wortlaut** — das Warum früherer Entscheidungen soll
43
+ auffindbar bleiben.
44
+ 4. **Messen statt schätzen:** Zeilen der Status-Datei **vorher und nachher zählen**. Steht in ihrem
45
+ Kopf eine Zielgröße, gilt die, sonst **150 Zeilen**. Liegt sie danach noch drüber, weiter
46
+ wegräumen — oder sag laut, warum der Rest bleiben muss. Prüf danach im Archiv nach, dass das
47
+ Verschobene wirklich dort steht (eine Zeile daraus suchen), bevor du es als erledigt meldest.
48
+ 5. **Sag laut, was du geändert hast:** was neu drinsteht, was ins Archiv ging, Zeilen vorher → nachher.
49
+
50
+ ## 3. Gelernte Regeln — gehört etwas festgehalten?
51
+ **Nur bei echtem Anlass**, nicht als Pflichtübung. Ein Anlass ist: Ich habe dich heute korrigiert,
52
+ eine Arbeitsweise ausdrücklich gewollt, oder dieselbe Art Frage zum dritten Mal gleich beantwortet.
53
+ Kein Anlass? Sag das in einem Halbsatz und geh weiter.
54
+
55
+ Gibt es einen, **schlag die Regel vor** — ein Satz, was du künftig anders machst, dazu Datum und
56
+ Anlass in einem Satz — und trag sie erst nach meinem OK ein. Wohin, hängt davon ab, was sie ist:
57
+
58
+ | Was ist es? | Wohin |
59
+ |---|---|
60
+ | **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) |
61
+ | **Etwas über mich** — wer ich bin, meine Rollen, meine Werkzeuge | meine `~/.claude/CLAUDE.md` |
62
+ | **Etwas über dieses Projekt** — Aufbau, Werkzeuge, Fallen | die `CLAUDE.md` im Projektordner |
63
+
64
+ 🔬 **Vorher nachsehen, ob es die Regel schon gibt** — im Coach und in den CLAUDE.md-Dateien. Steht
65
+ sie schon da, trag sie **nicht** doppelt ein: Sag mir, wo sie steht und dass sie heute nicht
66
+ gegriffen hat. Eine Regel, die zweimal dasteht, wird nicht besser befolgt.
67
+ ⚠️ **Gibt es `~/.claude/rules/kimal3-coach.md` nicht**, kommt auch eine Arbeitsregel in meine
68
+ `~/.claude/CLAUDE.md`. Leg die Coach-Datei **nicht** selbst an — sie gehört kimal3.
69
+ 🔴 **Im Coach änderst du NUR den Abschnitt „Gelernte Regeln" (in einem englischen Coach „Learned rules")** und schreibst nur unten dazu. Alles
70
+ darüber ist die Vorlage von kimal3 — dort änderst du nichts.
71
+
72
+ Sag danach laut, **welcher Satz in welcher Datei** steht (vollständiger Pfad). Der Ordner
73
+ `~/.claude` ist meist kein Git-Repo — die Datei ist dann nicht über Git gesichert; sag das dazu.
74
+
75
+ ## 4. Projekt aufräumen (leichtgewichtig)
76
+ - Offensichtlichen Müll entfernen (`.DS_Store`, `*.tmp`, `*.log`, `__pycache__`).
77
+ - Bei allem Unklaren: **nicht** löschen — auflisten und mich fragen.
78
+
79
+ ## 5. Sichern (mit meinem OK)
80
+ - Stage die relevanten Änderungen **Datei für Datei** — **niemals** Secrets oder `.env*`, und kein
81
+ `git add -A`, das fremde Arbeit mitnimmt.
82
+ - Zeig mir kurz, was in den Commit geht — **und was bewusst draußen bleibt**: Dateien, die Git noch
83
+ nicht kennt und die nicht aus dieser Sitzung stammen, stehen mit Namen und einem Satz, was sie
84
+ sind, in derselben Liste. (Sie kommen oft aus einer anderen Sitzung und fallen sonst niemandem
85
+ auf.) Mein OK zum Commit gilt für die ganze Liste; will ich eine davon doch dabeihaben, sage ich es.
86
+ - Schlag eine Commit-Nachricht vor.
87
+ - Nach meinem OK: committen.
88
+ - **Pushen, je nach Projekt:** Prüf mit `git remote`, ob es überhaupt ein Ziel gibt.
89
+ - Kein Ziel: sag das kurz — der Commit ist dann die Sicherung, fertig.
90
+ - Ein Ziel: **frag, ob du pushen sollst** (der Schritt „nach außen"). Steht in der
91
+ Projekt-`CLAUDE.md`, dass ein Push etwas auslöst (zum Beispiel die Live-Seite neu ausliefert),
92
+ sag das dazu. Erst nach meiner Bestätigung `git push`.
93
+
94
+ ## 6. Zusammenfassen & Abschied
95
+ - 2–3 Sätze **ohne Fachjargon**: Was haben wir heute geschafft, was habe ich gelernt — und in
96
+ einem Satz, was aufgeräumt wurde.
97
+ - **Ein** konkreter, kleiner nächster Schritt fürs nächste Mal (der Cliffhanger — klein halten).
98
+ - Kurzer, freundlicher Abschied wie ein guter Kollege, der Feierabend macht. Warte auf meine
99
+ Antwort, bevor die Sitzung endet.
@@ -32,7 +32,7 @@ weiter die echten Dateien und schickt leere Antworten hoch — beide Seiten meld
32
32
  Arbeit ist trotzdem weg.
33
33
 
34
34
  **Kein Arbeitsplatz gefunden?** Die Meldung heißt „ich habe von hier aufwärts keinen gefunden" —
35
- **nicht** „es gibt keinen". Frag erst: *Hast du schon einen KI-Arbeitsplatz-Ordner?* Ja → dorthin
35
+ **nicht** „es gibt keinen". Frag erst: *Hast du schon einen KI-Arbeitsplatz-Ordner?* (In einer englischen Firma heißt er `AI-Workplace`.) Ja → dorthin
36
36
  wechseln und noch einmal. Nein → `kimal3 arbeitsplatz neu`. ⚠️ Wer hier falsch rät, legt einen
37
37
  zweiten, leeren Arbeitsplatz an.
38
38
 
@@ -78,7 +78,7 @@ Sammelausgang für mindestens sechs verschiedene Lagen, und sie verlangen Gegens
78
78
  | „Hier steht kein KI-Arbeitsplatz" | **Nicht** `arbeitsplatz neu` raten! Siehe Abschnitt 2 — der Ordner existiert meist, nur steht der Mensch woanders. |
79
79
  | „Der Kontext wurde inzwischen … geändert" | Der Ausweg steht in derselben Meldung: `--ueberschreiben`. Schlag ihn nur vor, wenn der Mensch die fremde Änderung wirklich verwerfen will — sie ist die Arbeit eines Kollegen. |
80
80
  | mehrere Firmen / mehrdeutig | Der Ausweg heißt `--firma "…"`. **Du wählst nicht** — leg die Liste vor. |
81
- | eine Datei ist nicht lesbar oder trägt keine Fragen mehr | `kimal3 kontext runter` holt sie zurück. |
81
+ | eine Datei ist nicht lesbar oder trägt keine Fragen mehr | Die Datei umbenennen (etwa `firma-alt.md`), dann holt `kimal3 kontext runter` die Fassung der Firma frisch. Eine selbst bearbeitete Datei fasst `runter` sonst **nicht** an. |
82
82
  | **„Du gehörst keiner Firma an."** | 🔴 **Schick ihn NICHT zu einem Admin — es gibt keinen.** Das trifft ausgerechnet den frischen Pro-Käufer: Er bekommt seinen Arbeitsplatz mit allen Fragen offen, beantwortet sie brav, und hier ist niemand, an den sie gehen könnten. Sag ihm, dass seine Antworten **in seinen Dateien stehen und dort bleiben**, und dass sie hochgehen, sobald es eine Firma gibt. Nichts geht verloren. |
83
83
  | **„Die Firma hat deine Änderungen gespeichert — nur der lokale Merkzettel …"** | 🔴 **Das ist ein ERFOLG.** Alles ist oben angekommen; nur eine Datei auf der Platte ließ sich nicht schreiben. Sag genau das — **niemals** „das hat nicht geklappt". (ab 0.2.8 Rückgabe 0) |
84
84
 
@@ -15,33 +15,34 @@ Führe die Schritte der Reihe nach aus. Bleib im Coaching-Ton: Deutsch, freundli
15
15
  nach dem anderen, das Warum vor dem Wie, null Vorwissen vorausgesetzt.
16
16
 
17
17
  ## 1. Den Kurs nachschlagen
18
- - **Liegt `kurs-beats.md` neben dir? Wenn nein, hör hier auf.** Dann hat diese Person den
18
+ - **Liegt `kurs-beats.md` (oder `course-parts.md`) neben dir? Wenn nein, hör hier auf.** Dann hat diese Person den
19
19
  Mini-Kurs nicht — sag ihr freundlich in einem Satz, dass dieser Befehl zum Kurs gehört und
20
20
  hier nichts zu tun hat, und frag mit einem Vorschlag, woran sie stattdessen arbeiten möchte.
21
21
  **Fang nicht an, den Kurs aus dem Gedächtnis nachzuerzählen**, und such die Datei nicht
22
22
  woanders. *Der Befehl kommt seit 0.2.5 mit jedem kimal3 mit, der Kurs nicht.*
23
- - Liegt sie da: Lies `kurs-beats.md` — dort stehen die 3 Beats des Kurses, aus dem der Nutzer
23
+ - Liegt sie da: Lies `kurs-beats.md` (oder `course-parts.md`) — dort stehen die 3 Beats des Kurses, aus dem der Nutzer
24
24
  kommt. Das ist dein Wissen darüber; die Datei wird automatisch erzeugt, ändere sie nie von Hand.
25
25
 
26
26
  ## 2. Schauen, wie weit ihr seid
27
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`.
28
29
  - Gibt es die Datei noch nicht, ist das die erste Sitzung: Beat 1 ist dann erledigt (der Nutzer
29
30
  hat dich ja gerade gestartet), es geht bei **Beat 2** weiter. **Leg sie dann gleich an** —
30
- siehe `START-HIER.md`.
31
+ siehe `START-HIER.md` (oder `START-HERE.md`).
31
32
 
32
33
  ## 3. Stand in einem Satz sagen
33
34
  - Sag in **einem** Satz, wo ihr im Kurs steht — kein Vortrag, keine Wiederholung des ganzen Kurses.
34
35
 
35
36
  ## 4. Weiterführen — bis Beat 2 durch ist
36
37
  - Führ **einen** Schritt nach dem anderen weiter: zeigen, machen lassen, verstehen. Nie die
37
- ganze Liste auf einmal. Zieh `WEITER-HIER.md` nach, sobald ein Beat fertig ist.
38
+ ganze Liste auf einmal. Zieh `WEITER-HIER.md` (oder `NEXT-STEPS.md`) nach, sobald ein Beat fertig ist.
38
39
  - **Beat 1** (App, Konto, Plan, Start-Workspace, **Git**) passiert im Browser, **bevor** es dich
39
40
  gibt — den kannst du nicht führen. Er ist erledigt, sobald du läufst.
40
41
 
41
42
  ## 5. Nach Beat 2: den Umzug bauen & übergeben
42
43
  - Der Abschluss von Beat 2 ist der **Umzug**: Schlag Ordnername + Ort fürs erste echte
43
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
44
- und hinterlege dort eine kurze **`WEITER-HIER.md`** als Übergabe-Notiz — was geschafft
45
+ und hinterlege dort eine kurze **`WEITER-HIER.md`** (liegt dort schon ein `NEXT-STEPS.md`, nimm den) als Übergabe-Notiz — was geschafft
45
46
  ist und was als Nächstes dran ist (kleine echte Aufgabe wählen, `git init` + erster
46
47
  Commit, Rhythmus: durchdenken → bauen → prüfen → sichern, sichtbares Ergebnis; Schritte
47
48
  nebenbei im Kurs im Browser abhaken). Dann bitte ihn, Claude ganz zu schließen und im
@@ -19,10 +19,11 @@ nicht relevant, sag das kurz und überspring ihn — kein Leerlauf.
19
19
  - Begrüße kurz und warm. Keine lange Einleitung — einfach da sein wie ein geduldiger Kollege.
20
20
 
21
21
  ## 2. Schauen, wo ihr steht
22
- - **Liegt eine `START-HIER.md` daneben? Dann lies sie und folge ihr.** Sie ist die Anweisung an
22
+ - **Liegt eine `START-HIER.md` (oder `START-HERE.md`) daneben? Dann lies sie und folge ihr.** Sie ist die Anweisung an
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`.
26
27
  - Kein Status-Doc? **Sieh erst nach, ob ein `.git`-Ordner daneben liegt.** Wenn ja, führt dieses
27
28
  Projekt eine Versionsgeschichte, und `git log --oneline -10` plus `git status` zeigen dir den
28
29
  letzten Stand.