kimal3 0.1.3 → 0.1.5

package/README.md

@@ -34,10 +34,12 @@ auf und bestätigst den Code dort in deinem eingeloggten Konto — so wie bei `g
 ```
 kimal3                    Zeigt, ob dieser Rechner angemeldet ist
 kimal3 login              Diesen Rechner mit deinem Konto verbinden
-kimal3 logout             Verbindung wieder aufheben
+kimal3 skill install      Claude beibringen, dieses Werkzeug zu benutzen — und dir die /k3-Befehle geben
+kimal3 arbeitsplatz neu   Deine KI-Arbeitsplatz-Vorlage als Ordner anlegen
 kimal3 projekt neu …      Ein Projekt ins Erfolgsprofil eintragen
 kimal3 projekt liste      Deine eingetragenen Projekte anzeigen
-kimal3 skill install      Claude beibringen, dieses Werkzeug zu benutzen
+kimal3 firma daten        Die Daten deiner Firma holen, damit Claude sie auswerten kann
+kimal3 logout             Verbindung wieder aufheben
 ```
 
 Mehr zu einem Befehl: `kimal3 projekt neu --help`

package/dist/befehle/arbeitsplatz.js

@@ -0,0 +1,284 @@
+import { existsSync, mkdirSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { feld, ruf } from "../api.js";
+import { schlussFehler } from "../fehler.js";
+/**
+ * Holt die KI-Arbeitsplatz-Vorlage vom Server und legt sie lokal an --
+ * `CLAUDE.md`, Takt-Befehle, die Werkbank fuer eigene Projekte.
+ *
+ * 🔑 **Warum dieser Befehl NICHTS interpretiert** (wie `firma daten`): Die
+ * Vorlage entsteht an EINER Stelle (`arbeitsplatz/vorlage/…` im Repo, gebaut
+ * zu `src/lib/arbeitsplatz/vorlage-daten.ts`) und wird von dort an ZWEI Wegen
+ * ausgeliefert -- Download auf `/pro` und hier ueber die CLI. Wuerde dieser
+ * Befehl die Struktur selbst zusammenbauen, gaebe es zwei Wahrheiten ueber
+ * denselben Ordner, und sie liefen beim naechsten Aendern der Vorlage
+ * auseinander.
+ */
+const HILFE = `
+  kimal3 arbeitsplatz neu [ordnername]
+
+  Holt deine KI-Arbeitsplatz-Vorlage und legt sie hier als Ordner an.
+
+  ordnername   Optional. Ohne Angabe heisst der Ordner wie in der Vorlage.
+
+  🔴 Bricht ab, wenn der Zielordner schon existiert und NICHT leer ist --
+     eigene Arbeit wird dadurch nie versehentlich ueberschrieben.
+`;
+export async function arbeitsplatzNeu(argv) {
+    // ⚠️ VOR dem Lesen des Ordnernamens, wie bei `projekt neu` und
+    // `firma daten`: `--help` ist ein Schalter, kein Wert, der geprueft
+    // werden muesste.
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(HILFE);
+        return 0;
+    }
+    const ordnerArg = argv[0];
+    // 🔴 R2-2: Ein LEERES Argument ist kein "kein Argument" -- `?? daten.wurzel`
+    // greift nur bei `undefined`, ein leerer String bleibt stehen und `resolve("")`
+    // ist das aktuelle Verzeichnis. Wer "Ordner anlegen, hinein wechseln, Befehl
+    // tippen" macht, packt die Vorlage sonst versehentlich ins cwd.
+    if (ordnerArg !== undefined && ordnerArg.trim() === "") {
+        console.error(`Ein leerer Ordnername ist kein gueltiger Name.\n${HILFE}`);
+        return 1;
+    }
+    if (ordnerArg !== undefined && ordnerArg.startsWith("--")) {
+        console.error(`Die Option „${ordnerArg}" kenne ich nicht.\n${HILFE}`);
+        return 1;
+    }
+    if (argv.length > 1) {
+        console.error(`Mit „${argv[1]}" kann ich hier nichts anfangen -- nur EIN Ordnername ist erlaubt.\n${HILFE}`);
+        return 1;
+    }
+    const antwort = await ruf("/api/cli/arbeitsplatz", { methode: "GET", mitAusweis: true });
+    if (antwort.status === 200) {
+        // 🔴 Ein `200` mit unlesbarem Rumpf ist KEIN Erfolg -- dieselbe Wache wie
+        // bei `firma daten`. `ruf` verschluckt Parse-Fehler zu `null`.
+        const daten = alsArbeitsplatzAntwort(antwort.koerper);
+        if (daten === null) {
+            console.error("Die Antwort war nicht lesbar. Bitte gleich noch einmal.");
+            return 3;
+        }
+        return dateienAnlegen(daten, ordnerArg);
+    }
+    const meldung = feld(antwort.koerper, "meldung") ?? "Das hat nicht geklappt.";
+    // 402 VOR 401: Beide heissen "kommst hier nicht rein", verlangen aber
+    // Gegenteiliges. Wer sie zusammenwirft, raet `kimal3 login` -- und der
+    // meldet sich dann erfolgreich an, ohne dass es etwas aendert.
+    if (antwort.status === 402) {
+        console.error(meldung);
+        return 4;
+    }
+    if (antwort.status === 401) {
+        console.error(`${meldung} Bitte \`kimal3 login\` ausführen.`);
+        return 2;
+    }
+    // 🔑 Den Rest entscheidet `schlussFehler` fuer alle Befehle gemeinsam --
+    // insbesondere die `404` (die App kennt die Route noch nicht) und `429`/
+    // `408` (ueberlastet, wiederholbar).
+    const schluss = schlussFehler(antwort.status, meldung);
+    console.error(schluss.text);
+    return schluss.wert;
+}
+/** Prueft die Antwort-Form, ohne `any` -- eine falsche Form ist unlesbar, keine Ausnahme. */
+function alsArbeitsplatzAntwort(koerper) {
+    if (!koerper || typeof koerper !== "object")
+        return null;
+    const wurzel = koerper.wurzel;
+    const dateienRoh = koerper.dateien;
+    if (typeof wurzel !== "string" || wurzel.trim() === "")
+        return null;
+    if (!Array.isArray(dateienRoh))
+        return null;
+    const dateien = [];
+    for (const eintrag of dateienRoh) {
+        if (!eintrag || typeof eintrag !== "object")
+            return null;
+        const pfad = eintrag.pfad;
+        const inhalt = eintrag.inhalt;
+        if (typeof pfad !== "string" || pfad.trim() === "")
+            return null;
+        if (typeof inhalt !== "string")
+            return null;
+        dateien.push({ pfad, inhalt });
+    }
+    return { wurzel, dateien };
+}
+/**
+ * 🔴 **Nie ueberschreiben** -- die wichtigste Eigenschaft dieses Befehls.
+ * Angelegt wird nur, wenn am Zielort NICHTS liegt oder ein LEERER Ordner.
+ *
+ * Genauer, weil hier zwei verschiedene Absagen stecken:
+ * - Zielort ist eine **Datei** (auch eine leere): Abbruch. An einer Datei kann
+ *   kein Ordner entstehen, ohne sie zu loeschen -- und geloescht wird nichts.
+ * - Zielort ist ein **Ordner mit Inhalt**: Abbruch.
+ * - Zielort ist ein **leerer Ordner** oder gibt es nicht: los geht's.
+ *
+ * ⚠️ **Hier stand "eine leere Datei ... ist kein Hindernis"** (Review-Runde 4 zu
+ * PR #24) -- das war nie wahr. Wer `touch Mein-KI-Arbeitsplatz` gemacht hat oder
+ * wessen Editor eine leere Datei dieses Namens liegen liess, bekam den Abbruch,
+ * waehrend der Kommentar Durchlass versprach.
+ * *Die Prueffrage aus CLAUDE.md: Beschreibt das ein Verhalten, das jemand WILL --
+ * oder nur eines, das PASSIERT?* Hier wollte niemand das Beschriebene; der Code
+ * war richtig und der Satz darueber falsch.
+ */
+function dateienAnlegen(daten, ordnerArg) {
+    // 🔴 B-7: eine leere Lieferung ist ein FEHLERFALL, kein Erfolg mit null
+    // Dateien -- sonst meldet der Befehl "✓ 0 Dateien angelegt." und legt dabei
+    // nicht einmal einen Ordner an. Derselbe Rueckgabewert wie bei anderen
+    // unlesbaren Antworten (3): der Nutzer hat hier nichts falsch gemacht.
+    if (daten.dateien.length === 0) {
+        console.error("Die Antwort enthielt keine einzige Datei -- das ist kein gueltiges Ergebnis.");
+        console.error("Bitte gleich noch einmal versuchen.");
+        return 3;
+    }
+    const ordnerName = ordnerArg ?? daten.wurzel;
+    // 🔴 R2-1: `daten.wurzel` kommt genauso ROH vom Server wie jeder `datei.pfad`
+    // -- dieselbe Gefahr (manipulierte Antwort, z. B. ueber ein umgebogenes
+    // `KIMAL3_URL`), dieselbe Bremse. Nur wenn KEIN eigener Ordnername uebergeben
+    // wurde, fliesst `daten.wurzel` ueberhaupt in den Zielpfad ein -- aber geprueft
+    // wird sie immer, damit hier nie zwischen "gerade unbenutzt" und "sicher"
+    // verwechselt wird.
+    if (istUnsichererPfad(daten.wurzel)) {
+        console.error(`Die Antwort enthaelt einen unsicheren Ordnernamen: „${daten.wurzel}". Bitte melden.`);
+        return 3;
+    }
+    const ziel = resolve(ordnerName);
+    /*
+      🔴 Diese drei Aufrufe brauchen ein eigenes Netz (Review-Runde 3). Sie lagen
+      ausserhalb jedes `try`: Ist der Zielordner vorhanden, aber nicht lesbar
+      (fremder Besitzer, gesperrte Netzfreigabe -- EACCES), flog `readdirSync`
+      bis in den Auffang-Block von `kimal3.ts` durch. Der druckt dann
+      „kimal3 ist gerade nicht erreichbar." und gibt 3 zurueck.
+  
+      Das ist gleich doppelt falsch: Der Mensch sucht den Fehler beim Server,
+      obwohl er auf seiner eigenen Platte sitzt -- und 3 heisst fuer Claude laut
+      SKILL.md „gleich noch einmal versuchen", was hier nie helfen kann.
+      *Ein Fehlerfall darf nie denselben Namen tragen wie ein anderer.*
+    */
+    try {
+        if (existsSync(ziel)) {
+            if (!statSync(ziel).isDirectory()) {
+                console.error(`„${ordnerName}" gibt es schon -- als DATEI, nicht als Ordner.`);
+                console.error("Gib einen anderen Namen an: kimal3 arbeitsplatz neu <anderer-name>");
+                return 1;
+            }
+            /*
+              ⚠️ **Betriebssystem-Krimskrams zaehlt nicht als Inhalt** (Review-Runde 5).
+              `readdirSync` zaehlte vorher ALLES. Wer den Ordner angelegt und ihn nur
+              einmal im Finder (`.DS_Store`) oder Explorer (`desktop.ini`) geoeffnet
+              hat, bekam "gibt es schon und ist nicht leer" fuer einen Ordner, der fuer
+              ihn leer AUSSIEHT -- und keine Chance zu verstehen, warum. *Ein Grund, den
+              der Mensch nicht sehen kann, ist keine Begruendung, sondern eine Absage.*
+      
+              Bewusst eine geschlossene Liste und kein "alles, was mit Punkt anfaengt":
+              Eine `.env` oder ein `.git` IST Inhalt, und den fassen wir nicht an.
+            */
+            const OS_KRIMSKRAMS = [".DS_Store", "desktop.ini", "Thumbs.db"];
+            const echterInhalt = readdirSync(ziel).filter((n) => !OS_KRIMSKRAMS.includes(n));
+            if (echterInhalt.length > 0) {
+                console.error(`Der Ordner „${ordnerName}" gibt es schon und ist nicht leer.`);
+                console.error("Ich fasse ihn nicht an -- so geht nie versehentlich eigene Arbeit verloren.");
+                console.error("Gib einen anderen Namen an: kimal3 arbeitsplatz neu <anderer-name>");
+                return 1;
+            }
+        }
+    }
+    catch (fehler) {
+        console.error(`Ich komme an den Ordner „${ordnerName}" nicht heran.`);
+        console.error(`Grund: ${fehler instanceof Error ? fehler.message : String(fehler)}`);
+        console.error("Das liegt an diesem Rechner, nicht am Server -- Rechte pruefen oder");
+        console.error("einen anderen Namen angeben: kimal3 arbeitsplatz neu <anderer-name>");
+        return 1;
+    }
+    // 🔴 B-6: ALLE Pfade pruefen, BEVOR die erste Datei geschrieben wird. Wuerde
+    // erst waehrend des Schreibens geprueft, koennte ein unsicherer Pfad mitten
+    // in der Liste einen halb beschriebenen Ordner hinterlassen -- der naechste
+    // Versuch liefe dann in die "nicht leer"-Absage oben, ohne dass der Nutzer
+    // je erfaehrt, dass der Ordner unvollstaendig ist.
+    for (const datei of daten.dateien) {
+        if (istUnsichererPfad(datei.pfad)) {
+            console.error(`Die Antwort enthaelt einen unsicheren Pfad: „${datei.pfad}". Bitte melden.`);
+            return 3;
+        }
+    }
+    try {
+        for (const datei of daten.dateien) {
+            const ort = join(ziel, ...datei.pfad.split("/"));
+            mkdirSync(dirname(ort), { recursive: true });
+            // 🔑 B-2-Folge: Platzhalter wie [DATUM] fuellt seit PR #24 der SERVER
+            // (`src/lib/arbeitsplatz/ausliefern.ts`), fuer beide Auslieferungswege
+            // gleichzeitig -- Download auf `/pro` UND diese CLI. Wuerde die CLI
+            // zusaetzlich selbst ersetzen, gaebe es wieder zwei Wahrheiten ueber
+            // denselben Inhalt (genau das war der urspruengliche Befund). Die CLI
+            // schreibt den Inhalt deshalb hier UNVERAENDERT auf die Platte.
+            writeFileSync(ort, datei.inhalt, "utf8");
+        }
+    }
+    catch (fehler) {
+        /*
+          🔴 **Hier stand `return 3` (Review-Runde 5 zu PR #24).** `3` heisst laut
+          `cli/skill/SKILL.md` "voruebergehende Stoerung -- gleich noch einmal
+          versuchen". Ein voller Datentraeger oder ein EACCES ist aber keine
+          Server-Stoerung, und der zweite Versuch kann gar nicht mehr gutgehen:
+          Der Zielordner EXISTIERT jetzt und ist nicht leer, also faellt der Lauf
+          oben in die Nicht-leer-Wache und endet mit `1` = "Eingabe passt nicht".
+          Claude sagt dem Menschen dann, sein Ordnername sei falsch -- und der
+          wahre Grund (Platte voll) kommt nie an.
+    
+          Dieselbe Begruendung steht 40 Zeilen weiter oben schon einmal, beim
+          `readdirSync`-catch. *Ein Fehler, der einmal verstanden und
+          aufgeschrieben wurde, ist im Nachbar-catch trotzdem wieder neu.*
+        */
+        console.error(`Schreiben fehlgeschlagen: ${fehler instanceof Error ? fehler.message : String(fehler)}`);
+        console.error(`Der Ordner „${ordnerName}" ist dadurch UNVOLLSTAENDIG -- er darf geloescht werden.`);
+        console.error("Das liegt an diesem Rechner, nicht am Server -- Platz und Rechte pruefen.");
+        return 1;
+    }
+    console.log(`✓ ${daten.dateien.length} ${daten.dateien.length === 1 ? "Datei" : "Dateien"} angelegt.`);
+    console.log(`  ${ziel}`);
+    console.log("");
+    console.log("  Weiter geht's:");
+    const werkbank = werkbankOrdner(daten.dateien);
+    const cdZiel = werkbank !== null ? `${ordnerName}/${werkbank}` : ordnerName;
+    console.log(`    cd ${cdZiel.includes(" ") ? `"${cdZiel}"` : cdZiel}`);
+    console.log("    claude");
+    console.log('    dann "Lass uns einrichten" tippen');
+    return 0;
+}
+/**
+ * 🔴 R2-3: Der Name der Werkbank stand hier vorher FEST getippt
+ * (`meine-werkbank`) -- eine zweite Wahrheit ueber den Aufbau der Vorlage,
+ * genau das, wogegen der Kopfkommentar dieser Datei argumentiert. Wird der
+ * Werkbank-Ordner in `arbeitsplatz/vorlage/` umbenannt, bleibt
+ * `check:arbeitsplatz` gruen -- die CLI wuerde weiter in einen Ordner
+ * schicken, den es nicht mehr gibt.
+ *
+ * Stattdessen wird der Name aus der GELIEFERTEN Dateiliste abgeleitet: Der
+ * Werkbank-Ordner ist der Unterordner mit einer EIGENEN `CLAUDE.md` direkt
+ * darin (Pfad `<ordner>/CLAUDE.md`, genau zwei Teile) -- das ist die Stelle,
+ * an die `README.md` und diese Meldung Menschen schicken, um dort `claude`
+ * zu starten. Aendert sich der Name in der Vorlage, aendert sich diese
+ * Meldung automatisch mit.
+ */
+function werkbankOrdner(dateien) {
+    for (const datei of dateien) {
+        const teile = datei.pfad.split("/");
+        if (teile.length === 2 && teile[1] === "CLAUDE.md") {
+            return teile[0];
+        }
+    }
+    return null;
+}
+/**
+ * Ein `..`-Segment oder ein absoluter Pfad duerften das Ziel verlassen.
+ *
+ * 🔴 B-8: Zerlegt an `/` UND `\` -- eine fehlerhafte oder manipulierte
+ * Server-Antwort koennte sonst mit `..\..\boese.md` durchkommen. `join()`
+ * trennt unter Windows auch am Backslash, dieser Schutz muss also beide
+ * Trenner kennen wie `join()` selbst.
+ */
+function istUnsichererPfad(pfad) {
+    if (pfad.startsWith("/") || /^[a-zA-Z]:/.test(pfad))
+        return true;
+    return pfad.split(/[\\/]/).some((teil) => teil === "..");
+}

package/dist/befehle-katalog.js

@@ -14,28 +14,50 @@
  * ⚠️ Der Katalog beschreibt, WAS ES GIBT — nicht, wer es darf. Die Pro-Schranke
  * sitzt in der Route und im Befehl, nicht hier.
  */
+/**
+ * ⚠️ **Die Reihenfolge ist der Weg, den ein Mensch geht** (Auftrag Dennis,
+ * 2026-08-19), nicht die, in der die Befehle entstanden sind: erst einrichten
+ * (`login`, `skill install`), dann arbeiten, und `logout` zuletzt -- den
+ * braucht man fast nie. Sie schlaegt auf die Terminal-Hilfe durch, und das ist
+ * Absicht: Dort liest man sie mit derselben Frage.
+ */
 export const BEFEHLE = [
     {
         befehl: "kimal3 login",
         beschreibung: "Diesen Rechner mit deinem Konto verbinden",
         wer: "du",
         rhythmus: "einmal pro Rechner",
-        beispiel: "kimal3 login",
+        tippen: "! kimal3 login",
+        terminal: "kimal3 login",
         details: [
-            "Der Befehl zeigt dir eine Adresse und einen kurzen Code. Die Adresse im Browser öffnen, den Code eintippen, fertig — das Terminal merkt die Bestätigung von selbst. Zehn Minuten hast du dafür Zeit.",
-            "Danach musst du dich NICHT bei jedem Start neu anmelden: Der Ausweis liegt als Datei in deinem Benutzerordner und übersteht IDE-Neustarts, Rechner-Neustarts und Updates. Bei jedem Aufruf wird er im Hintergrund aufgefrischt, ohne dass du etwas merkst.",
-            "Gelegentlich reißt diese Kette trotzdem — dann sagt ein Befehl „Bitte kimal3 login ausführen\". Das ist kein Fehler, sondern der Normalfall nach längerer Pause: einmal wiederholen und weitermachen.",
+            "Er zeigt dir eine Adresse und einen Code: Adresse im Browser öffnen, Code eintippen. Das Terminal merkt die Bestätigung von selbst — du hast zehn Minuten Zeit.",
+            "Danach bleibt es so. Der Ausweis liegt als Datei in deinem Benutzerordner und übersteht IDE-Neustarts, Rechner-Neustarts und Updates. Reißt die Kette nach längerer Pause doch einmal, sagt dir ein Befehl Bescheid — dann einmal wiederholen, das ist kein Fehler.",
         ],
     },
     {
-        befehl: "kimal3 logout",
-        beschreibung: "Verbindung wieder aufheben",
+        befehl: "kimal3 skill install",
+        beschreibung: "Claude beibringen, dieses Werkzeug zu benutzen — und dir die /k3-Befehle geben",
         wer: "du",
-        rhythmus: "nur wenn nötig",
-        beispiel: "kimal3 logout",
+        rhythmus: "einmal — und nach jedem Update",
+        tippen: "! kimal3 skill install",
+        terminal: "kimal3 skill install",
         details: [
-            "Hebt die Verbindung dieses einen Rechners auf. Für den Alltag brauchst du ihn nicht.",
-            "Sinnvoll ist er, wenn du auf einem fremden oder geteilten Rechner gearbeitet hast — oder wenn ein Gerät abhandenkommt. Deine anderen Rechner bleiben angemeldet.",
+            "Der Befehl, der aus den anderen erst etwas macht: Er legt 🤖 Claudes Anleitung ab (den „Skill“) und 🧑 deine vier Slash-Befehle.",
+            "Er läuft NICHT automatisch — einmal nach der Installation, und nach jedem Update noch einmal. Sonst arbeitet Claude weiter mit der alten Anleitung.",
+            "Geklappt hat es, wenn er „Skill angelegt“ meldet und die Slash-Befehle aufzählt. Beides kennt Claude ab der NÄCHSTEN Sitzung — die laufende einmal neu starten.",
+        ],
+    },
+    {
+        befehl: "kimal3 arbeitsplatz neu",
+        beschreibung: "Deine KI-Arbeitsplatz-Vorlage als Ordner anlegen",
+        wer: "du",
+        rhythmus: "einmal pro Arbeitsplatz",
+        tippen: "! kimal3 arbeitsplatz neu",
+        terminal: "kimal3 arbeitsplatz neu",
+        details: [
+            "Holt die Vorlage von deinem Pro-Konto und legt sie hier als echten Ordner an — CLAUDE.md, Takt-Befehle, die Werkbank für deine Projekte. Dasselbe Paket, das auch als Download auf /pro liegt.",
+            "Ohne Angabe heißt der Ordner wie in der Vorlage. Brauchst du mehrere (z. B. je Firma), gib einen eigenen Namen mit: kimal3 arbeitsplatz neu <name>.",
+            "Gibt es den Zielordner schon und ist er nicht leer, bricht der Befehl ab, statt etwas zu überschreiben — deine Arbeit ist sicher. Geklappt hat es, wenn er die Zahl der angelegten Dateien nennt.",
         ],
     },
     {
@@ -43,11 +65,11 @@ export const BEFEHLE = [
         beschreibung: "Ein Projekt ins Erfolgsprofil eintragen",
         wer: "claude",
         ausloeser: "trag das als Projekt ein",
-        beispiel: 'kimal3 projekt neu --titel "Angebots-Generator" --stunden 4 --ergebnis 1200',
+        tippen: "/k3projekt <was du gebaut hast>",
+        terminal: 'kimal3 projekt neu --titel "Angebots-Generator" --stunden 4 --ergebnis 1200',
         details: [
-            "Wenn du in Claude etwas fertig gebaut hast und sagst „trag das als Projekt ein\", stellt Claude den Befehl selbst zusammen — mit Titel, Zeitersparnis, Ergebnis und allem, was ihr gerade besprochen habt. Das ist der bequeme Weg, weil Claude die Zahlen schon kennt.",
-            "Selbst tippen kannst du ihn genauso. Pflicht ist nur --titel; alles andere ist freiwillig. Die vollständige Liste aller Angaben zeigt: kimal3 projekt neu --help",
-            "Das Projekt landet in deinem Erfolgsprofil und ist damit Teil deines nachprüfbaren Nachweises.",
+            "Sag es einfach, wenn du etwas fertig hast — Claude stellt Titel, Zeitersparnis und Ergebnis selbst zusammen, er kennt die Zahlen aus eurem Gespräch. Der Slash-Befehl ist derselbe Weg, nur mit einem Griff.",
+            "Dahinter läuft kimal3 projekt neu. Pflicht ist nur der Titel; alle Angaben zeigt kimal3 projekt neu --help.",
         ],
     },
     {
@@ -55,9 +77,10 @@ export const BEFEHLE = [
         beschreibung: "Deine eingetragenen Projekte anzeigen",
         wer: "claude",
         ausloeser: "zeig meine Projekte",
-        beispiel: "kimal3 projekt liste",
+        tippen: "/k3liste",
+        terminal: "kimal3 projekt liste",
         details: [
-            "Zeigt, was schon in deinem Erfolgsprofil steht.",
+            "Zeigt, was schon in deinem Erfolgsprofil steht — mit Datum und Zahlen.",
             "Wofür es wirklich da ist: Claude schaut hier VOR dem Eintragen nach. Ohne diesen Blick stünde dasselbe Projekt irgendwann zweimal auf einer öffentlichen Seite, die deinen Namen trägt.",
         ],
     },
@@ -66,25 +89,23 @@ export const BEFEHLE = [
         beschreibung: "Die Daten deiner Firma holen, damit Claude sie auswerten kann",
         wer: "claude",
         ausloeser: "werte meine Firma aus",
-        beispiel: 'kimal3 firma daten --firma "Nordwind Handel GmbH"',
+        tippen: "/k3firma <deine Frage>",
+        terminal: 'kimal3 firma daten --firma "Nordwind Handel GmbH"',
         details: [
-            "Holt Kennzahlen, Menschen und Projekte deiner Firma und gibt sie an Claude weiter. Die Auswertung macht dann Claude — frag einfach los: „Welche drei Projekte bringen den meisten messbaren Ertrag?\" oder „Was sollten wir als Nächstes automatisieren?\"",
-            "Gehörst du zu mehreren Firmen, fragt der Befehl nach — er wählt nie still eine aus.",
+            "Holt Kennzahlen, Menschen und Projekte deiner Firma — auswerten tut Claude. Frag einfach los: „Welche drei Projekte bringen den meisten messbaren Ertrag?“",
+            "Gehörst du zu mehreren Firmen, wählt er nie still eine aus, sondern legt sie dir als fertige Befehle hin. Heißen zwei GLEICH, hilft --firma-id — ebenfalls fertig zum Kopieren, du musst nichts umbenennen.",
             "⚠️ Es sind personenbezogene Daten von Kolleginnen und Kollegen. Für den Einsatz in einer echten Firma braucht es ein kommerzielles Claude-Konto mit Auftragsverarbeitungsvertrag; werden Leistungen von Beschäftigten ausgewertet, ist das in Deutschland mitbestimmungspflichtig.",
         ],
     },
     {
-        befehl: "kimal3 skill install",
-        beschreibung: "Claude beibringen, dieses Werkzeug zu benutzen — und dir die /k3-Befehle geben",
+        befehl: "kimal3 logout",
+        beschreibung: "Verbindung wieder aufheben",
         wer: "du",
-        rhythmus: "einmal — und nach jedem Update",
-        beispiel: "kimal3 skill install",
+        rhythmus: "nur wenn nötig",
+        tippen: "! kimal3 logout",
+        terminal: "kimal3 logout",
         details: [
-            "Das ist der Befehl, der aus den anderen erst etwas macht. Er legt ZWEI Dinge in deinem Claude-Ordner ab: eine Anleitung für Claude (das „Skill\") und vier Slash-Befehle für dich.",
-            "🤖 Die Anleitung sorgt dafür, dass Claude von selbst weiß, dass es kimal3 gibt — du sagst „das Projekt ist fertig\", er trägt es ein.",
-            "🧑 Die Slash-Befehle sind dein eigener Griff: Tipp /k3 in Claude Code, und du siehst die ganze Familie — /k3 · /k3projekt · /k3liste · /k3firma. Damit musst du dir keinen Satz merken.",
-            "Er läuft NICHT automatisch. Einmal nach der Installation ausführen — und noch einmal nach jedem Update des Werkzeugs, sonst arbeitet Claude weiter mit der alten Anleitung.",
-            "Woran du merkst, dass es geklappt hat: Der Befehl meldet „Skill angelegt\" (oder „aktualisiert\") und zählt die Slash-Befehle auf. Beides kennt Claude ab der NÄCHSTEN Sitzung — die laufende muss also einmal neu gestartet werden.",
+            "Hebt die Verbindung dieses einen Rechners auf — sinnvoll auf einem fremden oder geteilten Gerät, oder wenn eins abhandenkommt. Deine anderen Rechner bleiben angemeldet.",
         ],
     },
 ];

package/dist/kimal3.js

@@ -15,6 +15,7 @@ import { readFileSync } from "node:fs";
 import { BASIS_URL, leseAnmeldung } from "./anmeldung.js";
 import { NichtAngemeldet } from "./api.js";
 import { hilfeText } from "./befehle-katalog.js";
+import { arbeitsplatzNeu } from "./befehle/arbeitsplatz.js";
 import { firmaDaten } from "./befehle/firma-daten.js";
 import { login } from "./befehle/login.js";
 import { logout } from "./befehle/logout.js";
@@ -123,6 +124,8 @@ async function haupt() {
         return firmaDaten(argv.slice(2));
     if (wort === "skill install")
         return skillInstall();
+    if (argv[0] === "arbeitsplatz" && argv[1] === "neu")
+        return arbeitsplatzNeu(argv.slice(2));
     console.error(`Den Befehl „${wort}" kenne ich nicht.\n${HILFE}`);
     return 1;
 }

package/package.json

@@ -1,27 +1,27 @@
-{
-  "name": "kimal3",
-  "version": "0.1.3",
-  "description": "Trag deine KI-Projekte dort ein, wo sie entstehen: im Terminal.",
-  "type": "module",
-  "bin": {
-    "kimal3": "dist/kimal3.js"
-  },
-  "files": [
-    "dist",
-    "skill",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=20"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "kimal3",
-    "cli"
-  ],
-  "homepage": "https://kimal3-app.vercel.app/pro",
-  "license": "SEE LICENSE IN README.md"
-}
+{
+  "name": "kimal3",
+  "version": "0.1.5",
+  "description": "Trag deine KI-Projekte dort ein, wo sie entstehen: im Terminal.",
+  "type": "module",
+  "bin": {
+    "kimal3": "dist/kimal3.js"
+  },
+  "files": [
+    "dist",
+    "skill",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "kimal3",
+    "cli"
+  ],
+  "homepage": "https://kimal3-app.vercel.app/pro",
+  "license": "SEE LICENSE IN README.md"
+}

package/skill/SKILL.md

@@ -1,125 +1,157 @@
----
-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`)
+
+**Wann:** Der Mensch will „seinen KI-Arbeitsplatz", „den Ordner", „die Struktur" — oder ist
+frisch bei Pro und weiß nicht, wo er anfangen soll.
+
+```
+kimal3 arbeitsplatz neu            # legt Mein-KI-Arbeitsplatz/ an
+kimal3 arbeitsplatz neu <name>     # eigener Ordnername
+```
+
+**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.
+
+🔑 **Er überschreibt nie etwas.** Ist der Zielordner vorhanden und nicht leer, bricht er ab
+(Rückgabewert 1) — dann einen anderen Namen anbieten, **nicht** überreden.
+
+**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.*

package/skill/commands/k3.md

@@ -1,44 +1,61 @@
----
-description: Übersicht — alle kimal3-Befehle und was du damit tun kannst
----
-
-<!-- kimal3:erzeugt — diese Datei wird von `kimal3 skill install` gepflegt und bei
-     jedem Update ueberschrieben. Eigene Aenderungen gehen dabei verloren; wer sie
-     behalten will, kopiert die Datei unter einem anderen Namen. -->
-# kimal3 — Übersicht
-
-Zeig dem Menschen, was dieses Werkzeug kann. **Nichts abrufen, nichts eintragen** — dieser
-Befehl erklärt nur.
-
-## 1. Die Befehlsliste holen, nicht auswendig aufsagen
-
-Führe `kimal3 --version` aus, dann `kimal3 --help`. Die Liste kommt aus dem Werkzeug selbst —
-so kann sie nicht veralten.
-
-Antwortet die Shell mit „nicht gefunden", ist das einer von zwei Fällen; welcher, steht in
-`~/.claude/skills/kimal3/SKILL.md` ganz oben. Nenn beide, rate nicht.
-
-## 2. So aufbereiten, dass klar wird, WER tippt
-
-Stell die Liste in zwei Gruppen dar:
-
-**🧑 Was du selbst tippst** — alles, was einen Menschen braucht:
-- `kimal3 login` bestätigst du im Browser. Das kann ich nicht für dich tun.
-- `kimal3 skill install` einmal nach der Installation und nach jedem Update.
-
-**🤖 Was du mir sagst** — hier tippe ich den Befehl:
-
-| Slash-Befehl | Wofür |
-|---|---|
-| `/k3projekt <was du gebaut hast>` | Ein fertiges Projekt ins Erfolgsprofil eintragen |
-| `/k3liste` | Deine eingetragenen Projekte zeigen |
-| `/k3firma <deine Frage>` | Firmendaten holen und deine Frage dazu beantworten |
-
-Sag dazu: Die Slash-Befehle sind der **sichere** Weg — du musst dir keinen Satz merken. Ohne
-sie geht es auch: „das Projekt ist fertig" genügt, dann greife ich über den Skill.
-
-## 3. Zum Schluss der Stand
-
-Nenn aus der `--version`-Ausgabe die Version und mit welcher App das Werkzeug spricht, und ob
-ein Konto angemeldet ist. Ist keins angemeldet, ist der nächste Schritt `kimal3 login` —
-**vom Menschen getippt**.
+---
+description: Übersicht — alle kimal3-Befehle und was du damit tun kannst
+---
+
+<!-- kimal3:erzeugt — diese Datei wird von `kimal3 skill install` gepflegt und bei
+     jedem Update ueberschrieben. Eigene Aenderungen gehen dabei verloren; wer sie
+     behalten will, kopiert die Datei unter einem anderen Namen. -->
+# kimal3 — Übersicht
+
+Zeig dem Menschen, was dieses Werkzeug kann. **Nichts abrufen, nichts eintragen** — dieser
+Befehl erklärt nur.
+
+## 1. Die Befehlsliste holen, nicht auswendig aufsagen
+
+Führe `kimal3 --version` aus, dann `kimal3 --help`. Die Liste kommt aus dem Werkzeug selbst —
+so kann sie nicht veralten.
+
+Antwortet die Shell mit „nicht gefunden", ist das einer von zwei Fällen; welcher, steht in
+`~/.claude/skills/kimal3/SKILL.md` ganz oben. Nenn beide, rate nicht.
+
+## 2. So aufbereiten, dass klar wird, WER tippt
+
+Stell die Liste in zwei Gruppen dar:
+
+**🧑 Was du selbst tippst** — alles, was einen Menschen braucht:
+- `kimal3 login` bestätigst du im Browser. Das kann ich nicht für dich tun.
+- `kimal3 skill install` einmal nach der Installation und nach jedem Update.
+
+**🤖 Was du mir sagst** — hier tippe ich den Befehl:
+
+| Slash-Befehl | Wofür |
+|---|---|
+| `/k3projekt <was du gebaut hast>` | Ein fertiges Projekt ins Erfolgsprofil eintragen |
+| `/k3liste` | Deine eingetragenen Projekte zeigen |
+| `/k3firma <deine Frage>` | Firmendaten holen und deine Frage dazu beantworten |
+
+Sag dazu: Die Slash-Befehle sind der **sichere** Weg — du musst dir keinen Satz merken. Ohne
+sie geht es auch: „das Projekt ist fertig" genügt, dann greife ich über den Skill.
+
+## 3. Der fünfte Eintrag im Menü: `/kimal3` ist KEIN Befehl
+
+In derselben `/`-Liste steht auch **`/kimal3`**. Erklär den Unterschied **ungefragt** — das Menü
+wirft zwei verschiedene Sorten in eine Liste, und genau daran hat sich der erste Mensch gestoßen,
+der die Familie gesehen hat (Dennis, 2026-08-19):
+
+- Die vier **`/k3…`** sind **Slash-Befehle** (Dateien in `~/.claude/commands/`) — **der Mensch**
+  tippt sie bewusst.
+- **`/kimal3`** ist der **Skill** (`~/.claude/skills/kimal3/SKILL.md`) — meine
+  Bedienungsanleitung. Sie ist der Grund, warum „das Projekt ist fertig" genügt: Ich schlage sie
+  von selbst auf, niemand muss sie rufen. Ihre Beschreibungszeile IST der Auslöser — deshalb nennt
+  sie mehrere Dinge auf einmal und liest sich nicht wie ein Menüpunkt.
+
+Sag auch, was `/kimal3` **nicht** ist: **nicht die Installation.** Die ist `kimal3 skill install`
+im Terminal — der eine Befehl, der beides ablegt, den Skill **und** die vier `/k3…`. Was im Menü
+steht, ist sein Ergebnis.
+
+## 4. Zum Schluss der Stand
+
+Nenn aus der `--version`-Ausgabe die Version und mit welcher App das Werkzeug spricht, und ob
+ein Konto angemeldet ist. Ist keins angemeldet, ist der nächste Schritt `kimal3 login` —
+**vom Menschen getippt**.

package/skill/commands/k3firma.md

@@ -1,57 +1,59 @@
----
-description: Firmendaten holen und deine Frage dazu beantworten
-argument-hint: <deine Frage zur Firma>
----
-
-<!-- kimal3:erzeugt — diese Datei wird von `kimal3 skill install` gepflegt und bei
-     jedem Update ueberschrieben. Eigene Aenderungen gehen dabei verloren; wer sie
-     behalten will, kopiert die Datei unter einem anderen Namen. -->
-# Firma auswerten
-
-## 1. Zuerst die Regeln lesen — nicht aus dem Kopf auswerten
-
-Lies **`~/.claude/skills/kimal3/SKILL.md`, Abschnitt „Firma auswerten"**. Dort stehen die
-Fallen, die man den Zahlen nicht ansieht: wofür `mitglieder_aktiv` gilt und wofür nicht, warum
-„pro Kopf" je Abteilung keine Aussage ist, wie Ehemalige und noch nicht gestartete Projekte
-zählen, und warum Umsatz und Ergebnis nicht in denselben Vergleich gehören.
-
-🔑 **Die Regeln stehen dort und nur dort.** Diese Datei wiederholt sie bewusst nicht — sonst
-gäbe es zwei Wahrheiten, die auseinanderlaufen.
-
-## 2. Die Daten holen
-
-```
-kimal3 firma daten
-```
-
-🔴 **Gehört der Mensch zu mehreren Firmen, bricht der Befehl ab — und dann WÄHLST DU NICHT.**
-Leg ihm die Liste vor und frag, welche er meint. **Immer**, ohne Ausnahme: Der Abbruch ist die
-Mehrdeutigkeit, du beurteilst sie nicht neu. Auch nicht, wenn eine Firma offensichtlich leer
-oder verschrieben ist — „offensichtlich" ist deine Einschätzung, nicht seine Entscheidung.
-
-⚠️ Hier stand bis zum 2026-08-18 „Nimm einen davon — rate nie … und frag, wenn die Liste
-mehrdeutig ist." Der Satz lud genau den Fehler ein: Ich habe die Liste für *eindeutig* gehalten
-und deshalb nicht gefragt. **In einer echten Firma zeigt das einem Menschen die
-personenbezogenen Daten der falschen Belegschaft.**
-
-Rückgabewerte deutest du nach `SKILL.md`, Abschnitt „Rückgabewerte". Vor allem: `4` heißt
-**nicht wiederholen**, und „diese Version der App kennt den Befehl nicht" ist **kein** Fehler
-des Menschen.
-
-## 3. Die Frage beantworten
-
-Die Frage des Menschen lautet:
-
-$ARGUMENTS
-
-Ist dort nichts angegeben, frag **eine** Frage zurück und schlag die drei Fragen aus
-`SKILL.md` („Fragen, die sich lohnen") als Auswahl vor — nicht einfach drauflos auswerten.
-
-Antworte in **Fließtext für einen Menschen**, nicht als JSON-Abschrift. Nenn Zahlen mit dem,
-was sie bedeuten, und sag ausdrücklich dazu, was du selbst gerechnet hast und was mitgeliefert
-war.
-
-⚠️ **Es sind personenbezogene Daten von Kolleginnen und Kollegen.** Nur auf ausdrücklichen
-Wunsch abrufen. Will jemand das für seine echte Firma nutzen, nenn die Voraussetzung aus
-`SKILL.md` (kommerzielles Claude-Konto mit Auftragsverarbeitungsvertrag; Mitbestimmung, sobald
-Leistungen von Beschäftigten ausgewertet werden).
+---
+description: Firmendaten holen und deine Frage dazu beantworten
+argument-hint: <deine Frage zur Firma>
+---
+
+<!-- kimal3:erzeugt — diese Datei wird von `kimal3 skill install` gepflegt und bei
+     jedem Update ueberschrieben. Eigene Aenderungen gehen dabei verloren; wer sie
+     behalten will, kopiert die Datei unter einem anderen Namen. -->
+# Firma auswerten
+
+## 1. Zuerst die Regeln lesen — nicht aus dem Kopf auswerten
+
+Lies **`~/.claude/skills/kimal3/SKILL.md`, Abschnitt „Firma auswerten"**. Dort stehen die
+Fallen, die man den Zahlen nicht ansieht: wofür `mitglieder_aktiv` gilt und wofür nicht, warum
+„pro Kopf" je Abteilung keine Aussage ist, wie Ehemalige und noch nicht gestartete Projekte
+zählen, und warum Umsatz und Ergebnis nicht in denselben Vergleich gehören.
+
+🔑 **Die Regeln stehen dort und nur dort.** Diese Datei wiederholt sie bewusst nicht — sonst
+gäbe es zwei Wahrheiten, die auseinanderlaufen.
+
+## 2. Die Daten holen
+
+```
+kimal3 firma daten
+```
+
+🔴 **Gehört der Mensch zu mehreren Firmen, bricht der Befehl ab — und dann WÄHLST DU NICHT.**
+Leg ihm die Liste vor und frag, welche er meint. **Immer**, ohne Ausnahme: Der Abbruch ist die
+Mehrdeutigkeit, du beurteilst sie nicht neu. Auch nicht, wenn eine Firma offensichtlich leer
+oder verschrieben ist — „offensichtlich" ist deine Einschätzung, nicht seine Entscheidung.
+
+⚠️ Hier stand bis zum 2026-08-18 „Nimm einen davon — rate nie … und frag, wenn die Liste
+mehrdeutig ist." Der Satz lud genau den Fehler ein: Ich habe die Liste für *eindeutig* gehalten
+und deshalb nicht gefragt. **In einer echten Firma zeigt das einem Menschen die
+personenbezogenen Daten der falschen Belegschaft.**
+
+Rückgabewerte deutest du nach `SKILL.md`, Abschnitt „Rückgabewerte". Vor allem: `4` heißt
+**nicht wiederholen**, und „diese Version der App kennt den Befehl nicht" ist **kein** Fehler
+des Menschen.
+
+## 3. Die Frage beantworten
+
+Die Frage des Menschen lautet:
+
+$ARGUMENTS
+
+Ist dort nichts angegeben — **oder steht dort wörtlich der Platzhalter** (`<deine Frage>`,
+`<deine Frage zur Firma>`), weil jemand die Zeile im Pro-Bereich kopiert und unverändert
+abgeschickt hat —, frag **eine** Frage zurück und schlag die drei Fragen aus
+`SKILL.md` („Fragen, die sich lohnen") als Auswahl vor — nicht einfach drauflos auswerten.
+
+Antworte in **Fließtext für einen Menschen**, nicht als JSON-Abschrift. Nenn Zahlen mit dem,
+was sie bedeuten, und sag ausdrücklich dazu, was du selbst gerechnet hast und was mitgeliefert
+war.
+
+⚠️ **Es sind personenbezogene Daten von Kolleginnen und Kollegen.** Nur auf ausdrücklichen
+Wunsch abrufen. Will jemand das für seine echte Firma nutzen, nenn die Voraussetzung aus
+`SKILL.md` (kommerzielles Claude-Konto mit Auftragsverarbeitungsvertrag; Mitbestimmung, sobald
+Leistungen von Beschäftigten ausgewertet werden).

package/skill/commands/k3projekt.md

@@ -1,44 +1,48 @@
----
-description: Ein fertiges Projekt ins Erfolgsprofil eintragen
-argument-hint: <was du gebaut hast>
----
-
-<!-- kimal3:erzeugt — diese Datei wird von `kimal3 skill install` gepflegt und bei
-     jedem Update ueberschrieben. Eigene Aenderungen gehen dabei verloren; wer sie
-     behalten will, kopiert die Datei unter einem anderen Namen. -->
-# Projekt eintragen
-
-## 1. Zuerst die Regeln lesen
-
-Lies **`~/.claude/skills/kimal3/SKILL.md`** — vor allem „Erst nachsehen, dann schreiben",
-„Eintragen" und „Zahlen nie erfinden". Diese Datei wiederholt die Regeln bewusst nicht.
-
-## 2. Nachsehen, ob es schon drinsteht
-
-```
-kimal3 projekt liste
-```
-
-Steht das Projekt schon da: **nicht** noch einmal eintragen. Sag dem Menschen, dass es bereits
-drin ist, und frag, ob er es ändern will.
-
-## 3. Eintragen
-
-Das Projekt, um das es geht:
-
-$ARGUMENTS
-
-Bau daraus `kimal3 projekt neu --titel "…"` mit den passenden Optionen
-(`kimal3 projekt neu --help` nennt alle).
-
-🔴 **Zeitersparnis, Umsatz und Ergebnis nie schätzen.** Diese Zahlen stehen anschließend
-**öffentlich** auf einer Seite mit dem Namen des Menschen. Wurde eine Zahl nicht genannt:
-**frag danach** oder lass das Feld weg. Eine plausible Zahl ist hier schlimmer als keine.
-
-Zeig dem Menschen **vor** dem Ausführen, was du eintragen wirst, und lass ihn bestätigen —
-das Ergebnis ist öffentlich und nicht mit einem Tastendruck zurückgeholt.
-
-## 4. Danach
-
-Nenn den Rückgabewert-Fall nach `SKILL.md`, falls es nicht geklappt hat. Hat es geklappt,
-zeig kurz, was jetzt im Profil steht.
+---
+description: Ein fertiges Projekt ins Erfolgsprofil eintragen
+argument-hint: <was du gebaut hast>
+---
+
+<!-- kimal3:erzeugt — diese Datei wird von `kimal3 skill install` gepflegt und bei
+     jedem Update ueberschrieben. Eigene Aenderungen gehen dabei verloren; wer sie
+     behalten will, kopiert die Datei unter einem anderen Namen. -->
+# Projekt eintragen
+
+## 1. Zuerst die Regeln lesen
+
+Lies **`~/.claude/skills/kimal3/SKILL.md`** — vor allem „Erst nachsehen, dann schreiben",
+„Eintragen" und „Zahlen nie erfinden". Diese Datei wiederholt die Regeln bewusst nicht.
+
+## 2. Nachsehen, ob es schon drinsteht
+
+```
+kimal3 projekt liste
+```
+
+Steht das Projekt schon da: **nicht** noch einmal eintragen. Sag dem Menschen, dass es bereits
+drin ist, und frag, ob er es ändern will.
+
+## 3. Eintragen
+
+Das Projekt, um das es geht:
+
+$ARGUMENTS
+
+⚠️ **Steht dort wörtlich der Platzhalter** (`<was du gebaut hast>`), hat jemand die Zeile im
+Pro-Bereich kopiert und unverändert abgeschickt. Dann ist **nichts** angegeben: Frag, um welches
+Projekt es geht, statt den Platzhalter als Titel zu nehmen.
+
+Bau daraus `kimal3 projekt neu --titel "…"` mit den passenden Optionen
+(`kimal3 projekt neu --help` nennt alle).
+
+🔴 **Zeitersparnis, Umsatz und Ergebnis nie schätzen.** Diese Zahlen stehen anschließend
+**öffentlich** auf einer Seite mit dem Namen des Menschen. Wurde eine Zahl nicht genannt:
+**frag danach** oder lass das Feld weg. Eine plausible Zahl ist hier schlimmer als keine.
+
+Zeig dem Menschen **vor** dem Ausführen, was du eintragen wirst, und lass ihn bestätigen —
+das Ergebnis ist öffentlich und nicht mit einem Tastendruck zurückgeholt.
+
+## 4. Danach
+
+Nenn den Rückgabewert-Fall nach `SKILL.md`, falls es nicht geklappt hat. Hat es geklappt,
+zeig kurz, was jetzt im Profil steht.