kimal3 0.1.5 → 0.2.0

package/skill/SKILL.md

@@ -13,37 +13,131 @@ description: Projekte ins kimal3-Erfolgsprofil eintragen oder auflisten, Firmend
 Sobald der Mensch sagt, ein Projekt sei fertig, oder ausdrücklich bittet, es einzutragen.
 **Oder** wenn er seinen KI-Arbeitsplatz anlegen will — dann s. „Den Arbeitsplatz anlegen".
 
-## Den Arbeitsplatz anlegen (`kimal3 arbeitsplatz neu`)
+## Den Arbeitsplatz anlegen (`kimal3 arbeitsplatz neu` · `kimal3 werkbank neu`)
 
 **Wann:** Der Mensch will „seinen KI-Arbeitsplatz", „den Ordner", „die Struktur" — oder ist
 frisch bei Pro und weiß nicht, wo er anfangen soll.
 
+🔴 **Zuerst EINE Frage klären, bevor du irgendetwas vorschlägst: Gibt es den Firmen-Ordner
+schon?** Sieh nach, ob neben dir ein `kontext/`-Ordner liegt (oder frag).
+
+| Lage | Befehl |
+|---|---|
+| Noch nichts da — die erste Person in dieser Firma | `kimal3 arbeitsplatz neu <vorname>` |
+| Firmen-Ordner steht schon — du brauchst nur deinen eigenen Platz | `kimal3 werkbank neu <vorname>` |
+
 ```
-kimal3 arbeitsplatz neu            # legt Mein-KI-Arbeitsplatz/ an
-kimal3 arbeitsplatz neu <name>     # eigener Ordnername
+kimal3 arbeitsplatz neu            # legt KI-Arbeitsplatz/ an (ganze Familie)
+kimal3 arbeitsplatz neu sabine     # dasselbe, Werkbank heisst werkbank-sabine
+kimal3 werkbank neu                # nur die Werkbank, im bestehenden Firmen-Ordner
+kimal3 werkbank neu sabine         # dasselbe, Ordner heisst werkbank-sabine
 ```
 
+🔴 **Das Argument ist der NAME DES MENSCHEN, nicht der Ordnername** (seit 2026-08-20). Der
+oberste Ordner heißt **immer** `KI-Arbeitsplatz`; mehrere Firmen trennt man über den Ordner
+darüber (`Kunden/ARNO/KI-Arbeitsplatz/`). Der Name wirkt eine Ebene tiefer: aus `sabine` wird
+`werkbank-sabine`.
+
+⚠️ **Ohne Angabe rät der Befehl nicht** — der Server bildet den Namen aus der Anmelde-Adresse.
+Das ist meist richtig, aber nicht immer schön (`s.mueller@…` wird zu `werkbank-s-mueller`).
+**Frag den Menschen nach seinem Vornamen und gib ihn mit**, statt es dem Server zu überlassen —
+er heißt selten so, wie seine Adresse aussieht.
+
+⚠️ **`werkbank neu` verlangt ein eigenes Pro-Konto.** Die Route prüft den Plan **pro Person**
+(`konto_plan`), nicht über die Firmen-Mitgliedschaft. Ein Kollege ohne eigenes Pro bekommt
+Rückgabewert `4` — dann **nicht** wiederholen und nicht raten, sondern genau das sagen: Sein
+Konto hat keinen Pro-Zugang.
+
 **Was dabei entsteht:** ein Firmen-Ordner mit Regeln für Marke, Systeme und Sicherheit, darin
-eine Werkbank zum Arbeiten und ein Beispiel-Projekt zum Ansehen.
+eine Werkbank zum Arbeiten und ein Beispiel-Projekt zum Ansehen. `werkbank neu` legt nur den
+zweiten Teil an und **fasst die Firmenebene nicht an**.
 
 🔑 **Er überschreibt nie etwas.** Ist der Zielordner vorhanden und nicht leer, bricht er ab
-(Rückgabewert 1) — dann einen anderen Namen anbieten, **nicht** überreden.
+(Rückgabewert 1).
+
+🔴 **Und dann NICHT einfach einen anderen Namen anbieten.** Hier stand genau dieser Rat, und er
+war ein Fehler (2026-08-20): Wer im Firmen-Ordner steht und `arbeitsplatz neu <name>` bekommt,
+erhält **eine zweite Firma im Bauch der ersten** — mit eigener `firma.md`, eigener `marke.md`,
+eigener `sicherheit.md`. Es gibt keine Fehlermeldung, und es fällt erst Tage später auf.
+**Frag stattdessen, welche der beiden Lagen oben zutrifft.**
+
+🔑 Seit der Umbenennung kann dieser Fehler über `arbeitsplatz neu` gar nicht mehr passieren:
+Der oberste Ordner heißt immer gleich, ein zweiter Name ist dort nicht mehr vorgesehen. Die
+Frage bleibt trotzdem stehen — **weil sie die richtige ist**, nicht weil die Falle noch offen
+wäre.
 
-**Danach:** in die Werkbank wechseln und **jeden Platzhalter in eckigen Klammern** gemeinsam
-ausfüllen — `[FIRMA]` und `[NAME]` sind nur die häufigsten, es sind zehn verschiedene. Sie
-stehen absichtlich noch drin — frag nach, statt zu raten. `[DATUM]` ist schon gefüllt.
+**Danach:** in die **Werkbank** wechseln und dort die Platzhalter in eckigen Klammern
+gemeinsam ausfüllen — es sind vier verschiedene. Such nach eckigen Klammern, statt einer Liste
+zu folgen: Eine abgetippte Liste veraltet in dem Moment, in dem die Vorlage wächst. Frag nach,
+statt zu raten.
 
-🔑 **Zuerst die zwei Dateien, die bei JEDEM Start mitladen** (`CLAUDE.md` der Firma und der
-Werkbank) — dort kostet ein leerer Vordruck jede Sitzung. Der Rest (`kontext/firma.md`) kann
-warten, bis er gebraucht wird.
+⚠️ `[FIRMA]` findest du meist schon ausgefüllt — den Namen setzt der Server beim Ausliefern ein.
+`[DATUM]` ebenso. Was übrig bleibt, sind die Angaben über den **Menschen** vor dir.
 
-⚠️ **Nicht nach dieser Liste suchen, sondern nach eckigen Klammern.** Hier stand bis zum
-2026-08-19 eine Aufzählung mit einem Platzhalter, den es gar nicht gab — „Rolle“ ist eine
-Beschriftung, kein Vordruck — und ohne sieben, die es gab. *Eine abgetippte Liste veraltet in dem Moment, in dem die Vorlage wächst.*
+🔴 **Nur in der Werkbank — nirgends sonst.** Die oberste `CLAUDE.md` und alles in `kontext/`
+gehören der **Firma**, nicht dem Menschen vor dir. Den Firmennamen setzt der Server beim
+Ausliefern selbst ein; die Fragen in `kontext/` beantwortet ihr über
+`kimal3 kontext fragen` (s. den nächsten Abschnitt). **Schreib dort nichts hinein, was du dir
+selbst ausgedacht hast** — beim nächsten `kimal3 kontext runter` ist es weg, und bis dahin steht
+dort eine Auskunft über die Firma, die sich niemand aus der Firma ausgedacht hat.
 
 ⚠️ **Nicht die Vorlage „aufräumen".** Das Beispiel-Projekt trägt oben groß, dass kein Code
 darin liegt. Nichts davon ausführen und nicht versuchen, es lauffähig zu machen.
 
+## Firmenkontext aktuell halten (`kimal3 kontext runter` · `kimal3 kontext hoch`)
+
+**Wann:** Der Mensch fragt, ob sein Firmenkontext aktuell ist, hat gerade `arbeitsplatz neu`
+oder `werkbank neu` ausgeführt, will wissen, was am Firmenkontext noch fehlt, oder will als
+Admin eine Änderung an `kontext/*.md` an die Firma weitergeben.
+
+`kimal3 kontext runter` holt `CLAUDE.md` und die fünf Dateien in `kontext/`
+(`kurzprofil.md`, `firma.md`, `marke.md`, `systeme.md`, `sicherheit.md`) von der Firma und legt
+sie im gefundenen KI-Arbeitsplatz ab. Lokal geänderte Dateien fasst er **nicht** an — er sagt in
+seiner Ausgabe, was als Nächstes zu tun ist (Admin: `kontext hoch`; sonst: an den genannten
+Admin weitergeben).
+
+### Den Firmenkontext ausfüllen — der Ablauf
+
+In `kontext/` stehen **Fragen über die Firma**, keine Lückentexte. Beantwortet werden sie im
+Gespräch mit dir — oder in der App unter **Firma → Kontext**. Beide Wege führen an dieselbe
+Stelle.
+
+1. **`kimal3 kontext fragen`** — er gibt jede Frage aus, unter der noch nichts steht: Datei,
+   Anker, Frage, Hinweis. Sind alle beantwortet, sagt er das in einem Satz, und du bist fertig.
+   Der Befehl liest nur; er braucht weder Netz noch Anmeldung.
+2. **Die Fragen EINZELN stellen.** Eine Frage, die Antwort abwarten, dann die nächste. Keine
+   Liste mit siebzehn Punkten und kein Fragebogen am Stück — es sind Fragen über die Firma
+   eines Menschen, und die beantwortet er nicht in einem Rutsch.
+3. **Die Antwort in die genannte Datei schreiben** — unter ihre `## `-Überschrift, über der der
+   Anker steht. Die Hinweiszeilen mit `>` gehören uns; **lass sie stehen und schreib darunter.**
+4. **`kimal3 kontext hoch`** — schickt alle fünf Dateien an die Firma. **Nur der Firmen-Admin
+   darf das.**
+
+🔴 **Erfinde keine Antwort, und schlage keine vor, die wie eine Antwort aussieht.** Genau
+deshalb gibt es diesen Umbau: Vorher standen dort fertige Beispieltexte von kimal3, und ein
+Klick machte sie zur Aussage der Firma. Weiß der Mensch etwas nicht, **bleibt die Frage offen**
+— sie ist dann beim nächsten `kimal3 kontext fragen` wieder da. Ein „[noch klären]", das er
+selbst schreibt, ist in Ordnung; ein Satz, den du dir ausdenkst, nicht.
+
+⚠️ **Sieht eine der fünf Dateien nicht mehr aus wie ihre Frageliste — etwa weil etwas Fremdes
+darüberkopiert wurde —, bricht `kontext hoch` ab und schickt gar nichts, auch die vier anderen
+nicht** (Rückgabewert `1`). Das ist **kein** „noch einmal versuchen": Sag dem Menschen, welche
+Datei gemeint ist, und hol sie mit `kimal3 kontext runter` zurück.
+
+🔴 **Die eine Regel, die du sonst falsch machst: Rückgabewert `1` bei `kontext hoch` heißt „du
+bist kein Admin dieser Firma" — nicht „noch einmal versuchen".** Das ist eine andere `1` als die
+üblichen Eingabefehler weiter unten. Ein zweiter Versuch ändert nichts, weil sich an der Rolle
+nichts ändert. **Sag dem Menschen, dass er kein Admin ist, und nenne, an wen er sich wendet** —
+lief vorher `kontext runter`, kennt dessen Ausgabe den Admin-Namen bereits; sonst frag, wer in
+der Firma Admin ist.
+
+⚠️ **Beide Befehle brauchen wie `werkbank neu` ein eigenes Pro-Konto** — ohne das kommt
+Rückgabewert `4`, dann **nicht wiederholen**.
+
+`kimal3 kontext hoch --ueberschreiben` erzwingt das Speichern, auch wenn die Firma inzwischen von
+jemand anderem geändert wurde. **Nur auf ausdrücklichen Wunsch einsetzen** — sonst geht die
+Änderung des Kollegen oder der Kollegin verloren.
+
 ## Erst nachsehen, dann schreiben
 `kimal3 projekt liste` — steht es schon da, **nicht** noch einmal eintragen.
 
@@ -149,9 +243,29 @@ mitbestimmungspflichtig. Das entscheidet die Firma, nicht dieses Werkzeug.
 **nicht** wiederholen
 
 🔴 **Die `1` hat mehrere Gründe, und sie verlangen Verschiedenes:** „wähl eine Firma", „leg
-zuerst ein Erfolgsprofil an", „die Eingabe passt nicht", „das Paket ist unvollständig". **Gib
-niemals einen Standard-Rat auf die Zahl allein** — die Meldung nennt jedes Mal, was zu tun ist.
+zuerst ein Erfolgsprofil an", „die Eingabe passt nicht", „das Paket ist unvollständig", und bei
+`kontext hoch` ausdrücklich **„du bist kein Admin"** (s. oben) — dort **nicht** wiederholen,
+sondern sagen, an wen sich der Mensch wendet. **Gib niemals einen Standard-Rat auf die Zahl
+allein** — die Meldung nennt jedes Mal, was zu tun ist.
 
 ⚠️ Hier stand kurzzeitig „dann ist `npm install -g kimal3` der Weg". Das hätte bei „du gehörst
 zu zwei Firmen" eine Neuinstallation empfohlen — für einen völlig normalen Fall. *Ein
 Rückgabewert sagt, OB man es noch einmal versuchen soll; WAS zu tun ist, steht im Text.*
+
+## Die `→`-Zeile am Ende ist KEIN Fehler
+
+Nach einem Befehl kann eine eingerückte Zeile mit `→` erscheinen — auf **stderr**, höchstens
+einmal am Tag. Das ist ein **Update-Hinweis**, kein Fehler:
+
+```
+  →  kimal3 0.2.0 ist da.  npm i -g kimal3@latest && kimal3 skill install
+```
+
+🔴 **Sie ändert den Rückgabewert nicht.** Steht dort eine `0`, ist der Befehl **erledigt** —
+auch wenn darunter noch eine `→`-Zeile steht. Wer die Zeile für eine Fehlermeldung hält,
+wiederholt einen Befehl, der längst durchgelaufen ist, oder meldet dem Menschen einen Fehlschlag,
+den es nicht gab.
+
+**Was stattdessen richtig ist:** Sag dem Menschen in einem Satz, dass ein Update bereitsteht, und
+biete an, den Befehl aus der Zeile auszuführen. **Führ ihn nicht ungefragt aus** — er
+installiert etwas auf seinem Rechner.