kimal3 0.1.4 → 0.1.6

package/dist/werkbank-name.js

@@ -0,0 +1,217 @@
+/**
+ * Wie eine Werkbank heisst — **eine** Regel fuer beide Auslieferungswege.
+ *
+ * 🔑 **Warum das eine eigene Datei ist** (2026-08-20, bei der Umbenennung von
+ * `meine-werkbank` auf `werkbank-<name>`): Der Ordnername entsteht an ZWEI
+ * Stellen. Der Server setzt ihn beim Ausliefern (Zip-Download auf `/pro` UND
+ * `/api/cli/arbeitsplatz`), und die CLI setzt ihn noch einmal, wenn der Mensch
+ * einen Namen mitgegeben hat. Waeren das zwei Regeln, hiesse derselbe Mensch je
+ * nach Weg anders — genau die Sorte Unterschied, die man erst Tage spaeter
+ * bemerkt.
+ *
+ * ⚠️ **DIESE DATEI IMPORTIERT NICHTS**, aus demselben Grund wie
+ * `befehle-katalog.ts`: Die CLI baut mit NodeNext (Import-Pfade enden auf
+ * `.js`), die App mit dem Bundler. Eine Datei ohne eigene Importe liest sich aus
+ * beiden Welten ohne Uebersetzung.
+ *
+ * 🔴 **Wozu das Ganze** (Entscheidung Dennis, 2026-08-20): *Besitz steht im
+ * Ordnernamen, nicht in einem Possessivpronomen.* Der Vorgaenger `meine-werkbank`
+ * hiess bei JEDEM gleich — liegen zwei davon nebeneinander oder gehen sie zu
+ * GitHub, ist nicht mehr erkennbar, wem welche gehoert. Wo ein Name steht
+ * (`werkbank-sabine`), gehoert der Ordner einer Person; wo keiner steht
+ * (`kontext/`, `KI-Arbeitsplatz/`), gehoert er allen. *Ein Nutzer muss diese
+ * Regel nicht lernen — er sieht sie im Baum.*
+ */
+/** Das Praefix, an dem man eine Werkbank erkennt. Bewacht von `check:arbeitsplatz` (11b). */
+export const WERKBANK_PRAEFIX = "werkbank-";
+/**
+ * Wie lang der Namensteil hoechstens werden darf.
+ *
+ * Nicht aus Geschmack: Windows deckelt einen ganzen Pfad bei 260 Zeichen, und
+ * dieser Ordner traegt darunter noch `projekte/<projekt>/referenzen/…`. Ein
+ * ellenlanger Name aus einer Sammel-Adresse wuerde erst dort unten Fehler
+ * erzeugen — an einer Stelle, an der niemand mehr an den Ordnernamen denkt.
+ */
+const MAX_LAENGE = 40;
+/**
+ * Aus dem, was ein Mensch eingibt (oder aus seiner Adresse kommt), ein Ordnername.
+ *
+ *     "Sabine"            → "werkbank-sabine"
+ *     "Sabine Müller"     → "werkbank-sabine-mueller"
+ *     "werkbank-sabine"   → "werkbank-sabine"   (nicht doppelt)
+ *     "sabine@arno.de"    → "werkbank-sabine"   (der Teil vor dem @)
+ *     "!!!"               → null                (nichts Brauchbares uebrig)
+ *
+ * 🔑 **Warum umgeschrieben und nicht abgelehnt wird:** Der Name landet als
+ * Ordner auf einer echten Platte. Ein `/` darin waere ein Unterordner, ein `:`
+ * unter Windows ein Laufwerk, ein Leerzeichen ein zweites Argument im naechsten
+ * `cd`. Wer „Sabine Müller" eingibt, hat nichts falsch gemacht — er hat einen
+ * Namen genannt, und Namen duerfen Umlaute und Leerzeichen haben.
+ *
+ * ⚠️ **Umlaute werden AUSGESCHRIEBEN, nicht entfernt.** `ü` einfach zu streichen
+ * machte aus „Müller" ein „Mller"; die deutsche Ersatzschreibung `ue` ist die,
+ * die jeder Mensch hier erwartet. Der Weg ueber `normalize("NFD")` allein reicht
+ * dafuer NICHT — er zerlegt `ü` in `u` + Trema und liefert damit „Muller".
+ * Deshalb stehen die vier deutschen Zeichen ausdruecklich davor.
+ *
+ * 📌 Gibt `null` zurueck, wenn nichts uebrig bleibt. Das ist **kein** Fehlerfall
+ * dieser Funktion, sondern eine Auskunft: Der Aufrufer entscheidet, ob er
+ * absagt (die CLI, wo ein Mensch etwas getippt hat) oder still beim Vordruck
+ * bleibt (der Server, wo niemand gefragt wurde).
+ */
+export function werkbankOrdnerAus(roh) {
+    /*
+      🔴 **Spitze Klammern sind eine ABSAGE, keine Zeichen zum Wegwerfen**
+      (Review-Runde 5 zu PR #25). Gemessen: `"<dein-vorname>"` wurde zu
+      `werkbank-dein-vorname` -- ein Ordner, der plausibel aussieht und den
+      niemand wollte.
+  
+      Und die Zeichenkette kommt nicht aus dem Nichts: Beide Absagen dieser CLI
+      und die Tabelle in `SKILL.md` legen sie dem Menschen woertlich hin
+      (`kimal3 werkbank neu <dein-vorname>`). In einer rohen Shell rettet der
+      Zufall -- dort ist `<` eine Umleitung und der Aufruf scheitert vorher. In
+      Claude Code, wo der Aufruf als Zeichenkette weitergereicht wird, rettet
+      nichts.
+  
+      *Genau der Fehler, gegen den `Anleitung.tsx` den Kopier-Kasten entworfen
+      hat: „Ein Platzhalter darin wird mitkopiert und ergibt einen Ordner, den
+      niemand wollte."* Er stand hier eine Ebene tiefer noch offen.
+    */
+    if (roh.includes("<") || roh.includes(">"))
+        return null;
+    const vorDemAt = roh.split("@")[0] ?? "";
+    const grundform = vorDemAt
+        .toLowerCase()
+        .replaceAll("ä", "ae")
+        .replaceAll("ö", "oe")
+        .replaceAll("ü", "ue")
+        .replaceAll("ß", "ss")
+        // Alles andere mit Akzent auf den Grundbuchstaben zurueck (é → e, ç → c).
+        .normalize("NFD")
+        .replace(/[\u0300-\u036f]/g, "")
+        // Was jetzt noch kein a–z oder 0–9 ist, wird zum Trennstrich -- und
+        // mehrere Trennstriche werden einer.
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    // Ein bereits vollstaendiger Ordnername soll nicht `werkbank-werkbank-sabine`
+    // werden. Das ist kein Sonderfall fuer Feinschmecker: Die Hilfe von
+    // `werkbank neu` hat bis heute genau diese Schreibweise beigebracht
+    // (`kimal3 werkbank neu werkbank-sabine`), und alte Anleitungen ueberleben
+    // laenger als der Code, den sie beschreiben.
+    const ohnePraefix = grundform.startsWith(WERKBANK_PRAEFIX)
+        ? grundform.slice(WERKBANK_PRAEFIX.length)
+        : grundform;
+    // ⚠️ Erst kuerzen, DANN den Trennstrich am Ende wegnehmen: Faellt der Schnitt
+    // mitten in „sabine-mueller", bliebe sonst ein „werkbank-sabine-" stehen.
+    const gekuerzt = ohnePraefix.slice(0, MAX_LAENGE).replace(/-+$/g, "");
+    if (gekuerzt === "")
+        return null;
+    return `${WERKBANK_PRAEFIX}${gekuerzt}`;
+}
+/**
+ * Die Vorlage auf einen anderen Werkbank-Namen umschreiben — **Pfade und Texte**.
+ *
+ * 🔑 **Warum auch die Texte** — und warum die Begruendung dafuer sich am
+ * 2026-08-20 zweimal gedreht hat:
+ *
+ * Zuerst hiess sie: *„Die `README.md` sagt woertlich `cd werkbank-dein-name`,
+ * und `check:arbeitsplatz` (Pruefung 11) haelt das fest."* Das stimmte —
+ * bis Review-Runde 3 zeigte, dass ein Name im GEMEINSAMEN Firmentext den Namen
+ * EINES Menschen ist, und Pruefung 11 daraufhin umgedreht wurde: Sie verbietet
+ * ihn dort jetzt.
+ *
+ * 🔬 **Heute nennt deshalb keine ausgelieferte Datei den Werkbank-Namen im
+ * Text** (nachgemessen: `grep` findet ihn nur im Ordnernamen). Die Ersetzung
+ * hat also aktuell **nichts zu tun** — und bleibt trotzdem drin, als Netz fuer
+ * den Fall, dass jemand in eine Werkbank-Datei `werkbank-sabine/projekte/`
+ * schreibt. Dort verbietet es keine Wache, und der Satz zeigte beim naechsten
+ * Menschen auf einen fremden Ordner.
+ *
+ * *Ein Netz, das heute niemand braucht, ist ehrlich zu beschreiben — nicht mit
+ * einer Zusicherung zu begruenden, die inzwischen das Gegenteil sagt.*
+ *
+ * ⚠️ Ersetzt wird der ganze Ordnername, nicht das Praefix — sonst traefe es
+ * jeden Text, der irgendeine Werkbank erwaehnt.
+ *
+ * 🔴 **Und das reicht NICHT, um erklaerende Beispiele zu schuetzen**
+ * (Review-Runde 1 zu PR #25). Hier stand, die Beispiele `werkbank-sabine` in der
+ * Vorlage blieben stehen. Das stimmt nur, solange `alt` der Vordruck ist — bei
+ * der CLI ist `alt` aber der Name, den der SERVER gesetzt hat. Heisst ein Konto
+ * `werkbank-sabine` und ruft `arbeitsplatz neu jonas` auf, wird aus dem
+ * erklaerenden Beispiel ebenfalls `werkbank-jonas`, und der Satz liest sich
+ * *„traegt seinen Namen: `werkbank-jonas`, `werkbank-jonas`"*.
+ *
+ * 🔑 Geschuetzt sind Beispiele deshalb nicht hier, sondern in der VORLAGE: Sie
+ * heissen `werkbank-<vorname>`, und diese Form kann kein echter Ordner tragen —
+ * `<` und `>` ueberleben `werkbankOrdnerAus` nicht. `check:arbeitsplatz` (11d)
+ * haelt das fest. *Eine Zusicherung, die nur fuer einen der beiden Aufrufer
+ * gilt, ist keine Zusicherung dieser Funktion.*
+ *
+ * 📌 Ist `alt` gleich `neu`, kommt die Liste unveraendert zurueck. Der Aufrufer
+ * muss also nicht selbst pruefen, ob sich etwas aendert.
+ */
+export function werkbankUmbenennen(dateien, alt, neu) {
+    if (alt === "" || neu === "" || alt === neu)
+        return [...dateien];
+    const altesPraefix = `${alt}/`;
+    const neuesPraefix = `${neu}/`;
+    /*
+      🔴 **Mit Wortgrenze, nicht mit `replaceAll`** (Review-Runde 5 zu PR #25).
+      Gemessen: Ein nacktes `replaceAll("werkbank-sabine", "werkbank-jonas")`
+      macht aus `werkbank-sabine-alt` ein `werkbank-jonas-alt` -- es zerlegt jedes
+      laengere Token, das mit dem Namen anfaengt.
+  
+      Heute stolpert niemand darueber, weil `check:arbeitsplatz` (11d) solche
+      Token aus der Vorlage haelt. Aber der Doku-Block oben verkauft die
+      Inhalts-Ersetzung ausdruecklich als **Netz fuer kuenftige Texte** -- und ein
+      Netz mit einem Loch ist genau das, was man erst am Tag des Sturzes merkt.
+  
+      Die Grenze gilt auf BEIDEN Seiten: `xwerkbank-sabine` ist ebenso wenig
+      gemeint wie `werkbank-sabine-alt`. Erlaubt sind nur Zeichen, die in keinem
+      Ordnernamen vorkommen koennen -- alles ausser `[a-z0-9-]`.
+    */
+    const grenze = new RegExp(`(?<![a-z0-9-])${maskiere(alt)}(?![a-z0-9-])`, "g");
+    return dateien.map((datei) => ({
+        ...datei,
+        pfad: datei.pfad.startsWith(altesPraefix)
+            ? `${neuesPraefix}${datei.pfad.slice(altesPraefix.length)}`
+            : datei.pfad,
+        inhalt: datei.inhalt.replace(grenze, neu),
+    }));
+}
+/**
+ * Welcher Unterordner die Werkbank ist — **abgeleitet, nicht getippt**.
+ *
+ * Erkennungsregel: der einzige Unterordner, der DIREKT eine eigene `CLAUDE.md`
+ * traegt (Pfad `<ordner>/CLAUDE.md`, genau zwei Teile). Dass es genau einen gibt,
+ * sichert `check:arbeitsplatz` (Pruefung 10) — ohne diese Wache waehlte die Regel
+ * bei mehreren stumm den ersten.
+ *
+ * 🔴 Diese Regel stand vorher ZWEIMAL im Projekt, wortgleich: einmal in
+ * `cli/src/arbeitsplatz-dateien.ts` (Befund R2-3) und einmal in
+ * `src/lib/arbeitsplatz/ausliefern.ts` (Runde 3). Beide Male war die Begruendung
+ * „nicht austippen" — und trotzdem wurde die Ableitung selbst kopiert.
+ * *Zwei Kopien einer Ableitung sind dieselbe zweite Wahrheit wie zwei Kopien des
+ * Namens, nur besser getarnt.*
+ */
+export function werkbankAusDateien(dateien) {
+    for (const datei of dateien) {
+        const teile = datei.pfad.split("/");
+        if (teile.length === 2 && teile[1] === "CLAUDE.md")
+            return teile[0];
+    }
+    return null;
+}
+/**
+ * Sonderzeichen eines regulaeren Ausdrucks entschaerfen.
+ *
+ * 🔑 Der Name kommt aus einer Server-Antwort. `werkbankOrdnerAus` laesst zwar
+ * nur `[a-z0-9-]` durch — aber `werkbankUmbenennen` bekommt `alt` NICHT von
+ * dort, sondern aus der gelieferten Dateiliste (`werkbankAusDateien`). Was von
+ * aussen kommt, wird nie zum Muster. *Eine Regel, die nur fuer den einen
+ * Aufrufer gilt, ist keine Regel dieser Funktion* -- dieselbe Lehre wie bei der
+ * Zusicherung ueber die Beispiele.
+ */
+function maskiere(text) {
+    return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kimal3",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Trag deine KI-Projekte dort ein, wo sie entstehen: im Terminal.",
   "type": "module",
   "bin": {

package/skill/SKILL.md

@@ -1,125 +1,212 @@
----
-name: kimal3
-description: Projekte ins kimal3-Erfolgsprofil eintragen oder auflisten — und Firmendaten auswerten. Sobald ein KI-Projekt fertig ist oder jemand danach fragt.
----
-
-# kimal3 — Projekte ins Erfolgsprofil eintragen
-
-> **`kimal3` nicht gefunden?** Zwei Gründe, und sie brauchen verschiedene Antworten:
-> die globale Installation fehlt (`npm install -g kimal3`) — **oder** sie ist da, aber diese
-> Sitzung kennt den Suchpfad noch nicht, dann hilft nur ein Neustart von Claude.
-
-## Wann
-Sobald der Mensch sagt, ein Projekt sei fertig, oder ausdrücklich bittet, es einzutragen.
-
-## Erst nachsehen, dann schreiben
-`kimal3 projekt liste` — steht es schon da, **nicht** noch einmal eintragen.
-
-## Eintragen
-`kimal3 projekt neu --titel "…" [--stunden 6] [--ergebnis 1200] [--symbol bot]`
-Alle Optionen: `kimal3 projekt neu --help`
-
-## 🔑 Zahlen nie erfinden
-Zeitersparnis, Umsatz und Ergebnis sind Behauptungen über die Wirklichkeit eines Menschen — und
-sie stehen anschließend **öffentlich** auf einer Seite mit seinem Namen. Ist eine Zahl nicht
-genannt worden: **fragen** oder das Feld weglassen. Niemals schätzen.
-
-## Nicht angemeldet?
-Dem Menschen `kimal3 login` zeigen und ihn selbst bestätigen lassen. Die Anmeldung **nie**
-selbst versuchen — sie braucht einen Menschen, der im Browser bestätigt.
-
-## Kein Pro-Zugang (Rückgabewert 4)
-Die Meldung enthält bereits die Adresse. Dem Menschen **die Meldung zeigen** und den Befehl
-**nicht wiederholen** — ein zweiter Versuch ändert nichts und wirkt wie ein Fehler im Werkzeug.
-Auch **nicht** `kimal3 login` vorschlagen: Der Mensch *ist* angemeldet, ihm fehlt das Konto.
-
-## Vorübergehende Störung (Rückgabewert 3)
-Server nicht erreichbar — oder das Konto ließ sich gerade nicht prüfen. Das ist **kein**
-endgültiges Nein: **einmal** wiederholen ist richtig. Klappt es wieder nicht, dem Menschen die
-Meldung zeigen und es dabei belassen.
-
-🔴 **Hierher gehört auch: „Diese Version der App kennt den Befehl noch nicht."** Dann ist die
-Eingabe des Menschen **richtig** und die App zu alt — meist im Fenster zwischen einer neuen
-CLI-Version und dem fertigen Deployment. **Sag ausdrücklich, dass er nichts falsch gemacht hat**,
-und schlag vor, es in ein paar Minuten erneut zu versuchen. Rate ihm **nicht**, den Befehl,
-Namen oder Schreibweisen zu prüfen — dort liegt der Fehler nicht.
-
-## Firma auswerten (`kimal3 firma daten`)
-
-Liefert die Firmendaten als JSON: Kennzahlen, Menschen, Projekte. **Nur auf ausdrücklichen
-Wunsch abrufen** — es sind personenbezogene Daten von Kolleginnen und Kollegen.
-
-`kimal3 firma daten` · bei mehreren Firmen: `kimal3 firma daten --firma "Name"`.
-🔴 **Bricht der Befehl mit mehreren Firmen ab, WÄHLST DU NICHT** — du legst dem Menschen die
-Liste vor und lässt ihn entscheiden. Auch dann nicht, wenn eine Firma offensichtlich die
-gemeinte ist: leer, verschrieben, „TEst". *Der Abbruch IST die Mehrdeutigkeit — sie ist schon
-festgestellt, du beurteilst sie nicht neu.* Wer hier auswählt, zeigt einem Menschen die
-personenbezogenen Daten einer Belegschaft, nach der er nicht gefragt hat.
-
-⚠️ Hier stand bis zum 2026-08-18 „nimm einen davon, statt zu raten" — und genau dieser Satz hat
-den Fehler ausgelöst. Er war gegen *Raten* gemeint und übersah, dass **Auswählen sich anders
-anfühlt als Raten, aber dasselbe Ergebnis hat**. (Befund von Dennis im Live-Durchlauf.)
-
-**Voraussetzung, die du nennen musst, sobald jemand das für seine echte Firma nutzen will:**
-Die Daten laufen durch das Claude-Konto der Firma. Dafür braucht es ein kommerzielles Konto
-(Team/Enterprise/API) mit Auftragsverarbeitungsvertrag — dort wird nicht mit Kundendaten
-trainiert. Und: Werden **Leistungen von Beschäftigten** ausgewertet, ist das in Deutschland
-mitbestimmungspflichtig. Das entscheidet die Firma, nicht dieses Werkzeug.
-
-### Regeln beim Auswerten
-- **Zahlen nie erfinden** — hier doppelt. Für Summen die mitgelieferten `kennzahlen` nehmen;
-  rechnest du selbst etwas aus, sag dazu, dass du es gerechnet hast.
-- `stand` ist der Tag der Abfrage. Bei älteren Daten nicht so tun, als wären sie von heute.
-- **Ehemalige nicht verschweigen, aber kennzeichnen** (`ehemalig: true`). Ihre Projekte laufen
-  weiter — eine Automatisierung hört nicht auf zu wirken, weil der Mensch gegangen ist.
-- `laeuft: false` heißt „noch nicht live". Solche Projekte haben noch nichts gebracht; ihre
-  Zahlen sind Erwartung, keine Bilanz. Wirf sie nie mit dem Laufenden in eine Summe.
-- `abteilung: "Ohne Abteilung"` ist ein echter Wert, kein fehlender.
-  ⚠️ Steht dort **„unbekannt"** und `abteilungen_bekannt: false`, ließen sich die Abteilungen
-  gerade nicht laden — dann **keine** Aussage über Abteilungen treffen, auch keine verneinende.
-- 🔴 **Für „pro Kopf" gilt `mitglieder_aktiv`, nicht `personen.length`** — aber nur
-  **firmenweit**. In `personen` stehen nur Menschen mit Erfolgsprofil; hat erst die Hälfte eines
-  angelegt, verdoppelt die falsche Zahl jedes Ergebnis. Weichen beide ab, sag dazu, auf welche du
-  dich beziehst.
-  🔴 **Je Abteilung gibt es KEINE verlässliche Kopfzahl.** `mitglieder_aktiv` ist firmenweit und
-  für einen Abteilungsvergleich unbrauchbar — sie ist für beide Seiten dieselbe. Vergleiche
-  Abteilungen deshalb über **Summen** (Projekte, Zeitersparnis, Ergebnis). Musst du doch pro Kopf
-  rechnen, sag ausdrücklich dazu, dass du über die Menschen **mit Erfolgsprofil** gerechnet hast.
-  ⚠️ **Und hat eine Abteilung keinen aktiven Menschen mehr, ist „pro Kopf" dort nicht definiert —
-  sag das, statt zu teilen.** Der Fall ist echt: Eine Abteilung, deren Projekte weiterlaufen,
-  während der letzte Mensch gegangen ist, hat kein Kopfzahl-Problem, sondern ein Betreuungsproblem.
-  **Das ist die Aussage, die zählt** — nenne sie, statt eine Zahl zu erzwingen.
-  📌 `mitglieder_gesamt` zählt **Ehemalige mit** — es ist die Zahl aller Mitgliedschaften, nicht
-  die Belegschaft von heute.
-  ⚠️ **Und es ist NICHT die Zahl der Team-Karten auf `/firma`.** Genau das stand hier und war
-  falsch: Die Karten zeigen nur Menschen **mit** Erfolgsprofil. Wer eine Mitgliedschaft ohne
-  Profil hat, zählt in `mitglieder_gesamt` mit und erscheint als keine Karte. **Willst du sagen,
-  wie viele Karten dort stehen, ist das `personen.length`** — und weichen die beiden Zahlen ab,
-  sag dazu, welche du meinst.
-- Zwei Menschen mit demselben Namen erscheinen als „Lena Meyer" und „Lena Meyer (2)". Das ist
-  kein Tippfehler, sondern die Unterscheidung — behandle sie als zwei Personen.
-- ⚖️ **Umsatz und Ergebnis nicht in einen Topf, wenn du Abteilungen vergleichst.**
-  `umsatz_monat_eur` gibt es nur, wo Umsatz entsteht — Support oder Buchhaltung sparen Kosten und
-  erzeugen keinen Umsatz. Deren `0` ist die Natur der Arbeit, kein Versagen. Wer die Gesamtsumme
-  vergleicht, erklärt umsatznahe Abteilungen automatisch zu den besseren. Stell **Ergebnis und
-  Zeitersparnis** nebeneinander und nenne den Umsatz getrennt.
-
-### Fragen, die sich lohnen
-- „Welche drei Projekte bringen den meisten messbaren Ertrag — und welche Abteilung hat am
-  längsten nichts Neues geliefert?"
-- „Vergleiche Vertrieb und Support: Projekte, Zeitersparnis, Ergebnis."
-- „Was würdest du als Geschäftsführung als Nächstes automatisieren, gemessen an dem, was bisher
-  funktioniert hat — und was davon lässt sich auf andere Abteilungen übertragen?"
-
-## Rückgabewerte
-`0` erledigt · `1` **Wiederholen hilft nicht — LIES DIE MELDUNG** · `2` Anmeldung fehlt ·
-`3` vorübergehende Störung, einmal wiederholen · `4` angemeldet, aber kein Pro-Zugang —
-**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.
-
-⚠️ 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.*
+---
+name: kimal3
+description: Projekte ins kimal3-Erfolgsprofil eintragen oder auflisten, Firmendaten auswerten — und den KI-Arbeitsplatz-Ordner anlegen. Sobald ein KI-Projekt fertig ist, jemand danach fragt, oder jemand seinen Arbeitsplatz einrichten will.
+---
+
+# kimal3 — Projekte ins Erfolgsprofil eintragen
+
+> **`kimal3` nicht gefunden?** Zwei Gründe, und sie brauchen verschiedene Antworten:
+> die globale Installation fehlt (`npm install -g kimal3`) — **oder** sie ist da, aber diese
+> Sitzung kennt den Suchpfad noch nicht, dann hilft nur ein Neustart von Claude.
+
+## Wann
+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` · `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 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. `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).
+
+🔴 **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.
+
+🔑 **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.
+
+⚠️ **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.*
+
+⚠️ **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.
+
+## Erst nachsehen, dann schreiben
+`kimal3 projekt liste` — steht es schon da, **nicht** noch einmal eintragen.
+
+## Eintragen
+`kimal3 projekt neu --titel "…" [--stunden 6] [--ergebnis 1200] [--symbol bot]`
+Alle Optionen: `kimal3 projekt neu --help`
+
+## 🔑 Zahlen nie erfinden
+Zeitersparnis, Umsatz und Ergebnis sind Behauptungen über die Wirklichkeit eines Menschen — und
+sie stehen anschließend **öffentlich** auf einer Seite mit seinem Namen. Ist eine Zahl nicht
+genannt worden: **fragen** oder das Feld weglassen. Niemals schätzen.
+
+## Nicht angemeldet?
+Dem Menschen `kimal3 login` zeigen und ihn selbst bestätigen lassen. Die Anmeldung **nie**
+selbst versuchen — sie braucht einen Menschen, der im Browser bestätigt.
+
+## Kein Pro-Zugang (Rückgabewert 4)
+Die Meldung enthält bereits die Adresse. Dem Menschen **die Meldung zeigen** und den Befehl
+**nicht wiederholen** — ein zweiter Versuch ändert nichts und wirkt wie ein Fehler im Werkzeug.
+Auch **nicht** `kimal3 login` vorschlagen: Der Mensch *ist* angemeldet, ihm fehlt das Konto.
+
+## Vorübergehende Störung (Rückgabewert 3)
+Server nicht erreichbar — oder das Konto ließ sich gerade nicht prüfen. Das ist **kein**
+endgültiges Nein: **einmal** wiederholen ist richtig. Klappt es wieder nicht, dem Menschen die
+Meldung zeigen und es dabei belassen.
+
+🔴 **Hierher gehört auch: „Diese Version der App kennt den Befehl noch nicht."** Dann ist die
+Eingabe des Menschen **richtig** und die App zu alt — meist im Fenster zwischen einer neuen
+CLI-Version und dem fertigen Deployment. **Sag ausdrücklich, dass er nichts falsch gemacht hat**,
+und schlag vor, es in ein paar Minuten erneut zu versuchen. Rate ihm **nicht**, den Befehl,
+Namen oder Schreibweisen zu prüfen — dort liegt der Fehler nicht.
+
+## Firma auswerten (`kimal3 firma daten`)
+
+Liefert die Firmendaten als JSON: Kennzahlen, Menschen, Projekte. **Nur auf ausdrücklichen
+Wunsch abrufen** — es sind personenbezogene Daten von Kolleginnen und Kollegen.
+
+`kimal3 firma daten` · bei mehreren Firmen: `kimal3 firma daten --firma "Name"`.
+🔴 **Bricht der Befehl mit mehreren Firmen ab, WÄHLST DU NICHT** — du legst dem Menschen die
+Liste vor und lässt ihn entscheiden. Auch dann nicht, wenn eine Firma offensichtlich die
+gemeinte ist: leer, verschrieben, „TEst". *Der Abbruch IST die Mehrdeutigkeit — sie ist schon
+festgestellt, du beurteilst sie nicht neu.* Wer hier auswählt, zeigt einem Menschen die
+personenbezogenen Daten einer Belegschaft, nach der er nicht gefragt hat.
+
+⚠️ Hier stand bis zum 2026-08-18 „nimm einen davon, statt zu raten" — und genau dieser Satz hat
+den Fehler ausgelöst. Er war gegen *Raten* gemeint und übersah, dass **Auswählen sich anders
+anfühlt als Raten, aber dasselbe Ergebnis hat**. (Befund von Dennis im Live-Durchlauf.)
+
+**Voraussetzung, die du nennen musst, sobald jemand das für seine echte Firma nutzen will:**
+Die Daten laufen durch das Claude-Konto der Firma. Dafür braucht es ein kommerzielles Konto
+(Team/Enterprise/API) mit Auftragsverarbeitungsvertrag — dort wird nicht mit Kundendaten
+trainiert. Und: Werden **Leistungen von Beschäftigten** ausgewertet, ist das in Deutschland
+mitbestimmungspflichtig. Das entscheidet die Firma, nicht dieses Werkzeug.
+
+### Regeln beim Auswerten
+- **Zahlen nie erfinden** — hier doppelt. Für Summen die mitgelieferten `kennzahlen` nehmen;
+  rechnest du selbst etwas aus, sag dazu, dass du es gerechnet hast.
+- `stand` ist der Tag der Abfrage. Bei älteren Daten nicht so tun, als wären sie von heute.
+- **Ehemalige nicht verschweigen, aber kennzeichnen** (`ehemalig: true`). Ihre Projekte laufen
+  weiter — eine Automatisierung hört nicht auf zu wirken, weil der Mensch gegangen ist.
+- `laeuft: false` heißt „noch nicht live". Solche Projekte haben noch nichts gebracht; ihre
+  Zahlen sind Erwartung, keine Bilanz. Wirf sie nie mit dem Laufenden in eine Summe.
+- `abteilung: "Ohne Abteilung"` ist ein echter Wert, kein fehlender.
+  ⚠️ Steht dort **„unbekannt"** und `abteilungen_bekannt: false`, ließen sich die Abteilungen
+  gerade nicht laden — dann **keine** Aussage über Abteilungen treffen, auch keine verneinende.
+- 🔴 **Für „pro Kopf" gilt `mitglieder_aktiv`, nicht `personen.length`** — aber nur
+  **firmenweit**. In `personen` stehen nur Menschen mit Erfolgsprofil; hat erst die Hälfte eines
+  angelegt, verdoppelt die falsche Zahl jedes Ergebnis. Weichen beide ab, sag dazu, auf welche du
+  dich beziehst.
+  🔴 **Je Abteilung gibt es KEINE verlässliche Kopfzahl.** `mitglieder_aktiv` ist firmenweit und
+  für einen Abteilungsvergleich unbrauchbar — sie ist für beide Seiten dieselbe. Vergleiche
+  Abteilungen deshalb über **Summen** (Projekte, Zeitersparnis, Ergebnis). Musst du doch pro Kopf
+  rechnen, sag ausdrücklich dazu, dass du über die Menschen **mit Erfolgsprofil** gerechnet hast.
+  ⚠️ **Und hat eine Abteilung keinen aktiven Menschen mehr, ist „pro Kopf" dort nicht definiert —
+  sag das, statt zu teilen.** Der Fall ist echt: Eine Abteilung, deren Projekte weiterlaufen,
+  während der letzte Mensch gegangen ist, hat kein Kopfzahl-Problem, sondern ein Betreuungsproblem.
+  **Das ist die Aussage, die zählt** — nenne sie, statt eine Zahl zu erzwingen.
+  📌 `mitglieder_gesamt` zählt **Ehemalige mit** — es ist die Zahl aller Mitgliedschaften, nicht
+  die Belegschaft von heute.
+  ⚠️ **Und es ist NICHT die Zahl der Team-Karten auf `/firma`.** Genau das stand hier und war
+  falsch: Die Karten zeigen nur Menschen **mit** Erfolgsprofil. Wer eine Mitgliedschaft ohne
+  Profil hat, zählt in `mitglieder_gesamt` mit und erscheint als keine Karte. **Willst du sagen,
+  wie viele Karten dort stehen, ist das `personen.length`** — und weichen die beiden Zahlen ab,
+  sag dazu, welche du meinst.
+- Zwei Menschen mit demselben Namen erscheinen als „Lena Meyer" und „Lena Meyer (2)". Das ist
+  kein Tippfehler, sondern die Unterscheidung — behandle sie als zwei Personen.
+- ⚖️ **Umsatz und Ergebnis nicht in einen Topf, wenn du Abteilungen vergleichst.**
+  `umsatz_monat_eur` gibt es nur, wo Umsatz entsteht — Support oder Buchhaltung sparen Kosten und
+  erzeugen keinen Umsatz. Deren `0` ist die Natur der Arbeit, kein Versagen. Wer die Gesamtsumme
+  vergleicht, erklärt umsatznahe Abteilungen automatisch zu den besseren. Stell **Ergebnis und
+  Zeitersparnis** nebeneinander und nenne den Umsatz getrennt.
+
+### Fragen, die sich lohnen
+- „Welche drei Projekte bringen den meisten messbaren Ertrag — und welche Abteilung hat am
+  längsten nichts Neues geliefert?"
+- „Vergleiche Vertrieb und Support: Projekte, Zeitersparnis, Ergebnis."
+- „Was würdest du als Geschäftsführung als Nächstes automatisieren, gemessen an dem, was bisher
+  funktioniert hat — und was davon lässt sich auf andere Abteilungen übertragen?"
+
+## Rückgabewerte
+`0` erledigt · `1` **Wiederholen hilft nicht — LIES DIE MELDUNG** · `2` Anmeldung fehlt ·
+`3` vorübergehende Störung, einmal wiederholen · `4` angemeldet, aber kein Pro-Zugang —
+**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.
+
+⚠️ 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.