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.
- package/README.md +135 -0
- package/dist/api.js +16 -7
- package/dist/arbeitsplatz-dateien.js +62 -30
- package/dist/argumente.js +25 -97
- package/dist/befehle/arbeitsplatz.js +51 -68
- package/dist/befehle/firma-daten.js +24 -26
- package/dist/befehle/kontext-fragen.js +62 -44
- package/dist/befehle/kontext-gemeinsam.js +86 -43
- package/dist/befehle/kontext-hoch.js +40 -46
- package/dist/befehle/kontext-runter.js +70 -51
- package/dist/befehle/login.js +23 -9
- package/dist/befehle/logout.js +9 -4
- package/dist/befehle/projekt-liste.js +24 -29
- package/dist/befehle/projekt-neu.js +25 -31
- package/dist/befehle/skill-install.js +78 -49
- package/dist/befehle/skill-tausch.js +28 -0
- package/dist/befehle/wache.js +12 -6
- package/dist/befehle/werkbank.js +118 -88
- package/dist/befehle-katalog-en.js +185 -0
- package/dist/befehle-katalog.js +10 -49
- package/dist/befehlswoerter.js +69 -0
- package/dist/einstellungen-mischen.js +2 -2
- package/dist/einstellungen-schreiben.js +8 -5
- package/dist/fehler.js +5 -5
- package/dist/firmen-liste.js +42 -5
- package/dist/format.js +41 -0
- package/dist/fragen-lesen.js +3 -3
- package/dist/hilfe.js +24 -0
- package/dist/kimal3.js +77 -71
- package/dist/kontext-dateien.js +30 -23
- package/dist/kontext-hoch-zeile.js +5 -3
- package/dist/kontext-rat.js +151 -0
- package/dist/kontext-stand.js +68 -210
- package/dist/nachricht.js +39 -15
- package/dist/projekt-neu-firma.js +9 -9
- package/dist/projekt-zeilen.js +40 -54
- package/dist/slash-befehle.js +36 -0
- package/dist/sprache.js +114 -0
- package/dist/texte/allgemein.js +99 -0
- package/dist/texte/arbeitsplatz.js +135 -0
- package/dist/texte/kontext-hoch.js +128 -0
- package/dist/texte/kontext.js +171 -0
- package/dist/texte/projekte.js +126 -0
- package/dist/texte/skill.js +87 -0
- package/dist/texte/wache.js +36 -0
- package/dist/texte/werkbank.js +161 -0
- package/dist/wache-rechnung.js +27 -40
- package/dist/wache-schalter.js +40 -5
- package/dist/werkbank-name.js +28 -10
- package/dist/wort.js +98 -0
- package/package.json +27 -27
- package/skill/SKILL.md +18 -10
- package/skill/commands/k3.md +1 -1
- package/skill/commands/k3feierabend.md +99 -97
- package/skill/commands/k3kontext.md +2 -2
- package/skill/commands/k3kurs.md +6 -5
- package/skill/commands/k3start.md +2 -1
- package/skill/en/SKILL.md +451 -0
- package/skill/en/commands/k3.md +106 -0
- package/skill/en/commands/k3analyse.md +59 -0
- package/skill/en/commands/k3context.md +92 -0
- package/skill/en/commands/k3course.md +54 -0
- package/skill/en/commands/k3list.md +26 -0
- package/skill/en/commands/k3project.md +50 -0
- package/skill/en/commands/k3start.md +47 -0
- package/skill/en/commands/k3wrapup.md +99 -0
- 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
|
|
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
|
|
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
|
|
package/skill/commands/k3.md
CHANGED
|
@@ -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
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
|
59
|
-
|
|
60
|
-
| **
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
- **
|
|
96
|
-
|
|
97
|
-
|
|
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`
|
|
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
|
|
package/skill/commands/k3kurs.md
CHANGED
|
@@ -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.
|