kimal3 0.1.2 → 0.1.4

package/README.md

@@ -34,10 +34,11 @@ 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 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/firma-daten.js

@@ -1,9 +1,9 @@
 import { zerlege } from "../argumente.js";
 import { feld, ruf } from "../api.js";
 import { schlussFehler } from "../fehler.js";
-import { firmenZeilen } from "../firmen-liste.js";
+import { firmenIdZeilen, firmenZeilen } from "../firmen-liste.js";
 import { BASIS_URL } from "../anmeldung.js";
-const ERLAUBT = ["firma"];
+const ERLAUBT = ["firma", "firma-id"];
 /**
  * Die Firmendaten holen — als JSON, unveraendert.
  *
@@ -17,14 +17,18 @@ const ERLAUBT = ["firma"];
  * Ueberschrift dazudruckt, macht die Ausgabe als JSON unlesbar — alles fuer
  * Menschen gehoert nach stderr (`console.error`).
  */
-const HILFE = `
-  kimal3 firma daten [--firma "Name"]
-
-  Holt die Daten deiner Firma als JSON: Kennzahlen, Menschen, Projekte.
-  Die Auswertung macht Claude daraus selbst.
-
-  --firma "Name"   Noetig, wenn du zu mehreren Firmen gehoerst.
-                   Die Absage nennt dir die Namen als fertige Befehle.
+const HILFE = `
+  kimal3 firma daten [--firma "Name" | --firma-id "…"]
+
+  Holt die Daten deiner Firma als JSON: Kennzahlen, Menschen, Projekte.
+  Die Auswertung macht Claude daraus selbst.
+
+  --firma "Name"   Noetig, wenn du zu mehreren Firmen gehoerst.
+                   Die Absage nennt dir die Namen als fertige Befehle.
+
+  --firma-id "…"   Fuer den Fall, dass zwei deiner Firmen GLEICH heissen.
+                   Auch diese Absage nennt dir fertige Befehle -- du musst
+                   nichts umbenennen und nichts nachschlagen.
 `;
 export async function firmaDaten(argv) {
     // ⚠️ VOR `zerlege`, genau wie bei `projekt neu`: Ein Schalter ist keine
@@ -46,9 +50,22 @@ export async function firmaDaten(argv) {
     // das ab. Wer hier auf Wahrheit prueft, wirft beides zusammen: `--firma=`
     // lieferte dann die Daten der einzigen Firma, als haette niemand gefragt.
     const wunsch = zerlegt.werte.optionen.firma;
-    const pfad = wunsch !== undefined
-        ? `/api/cli/firma?firma=${encodeURIComponent(wunsch)}`
-        : "/api/cli/firma";
+    /*
+      🔑 **`--firma-id` ist der Ausweg fuer doppelt benannte Firmen** (B-5,
+      zweite Haelfte, 2026-08-18 spaet). Vorher endete die Absage bei „benenne
+      eine davon um" -- und das setzt Admin-Rechte in einer FREMDEN Firma
+      voraus. *Eine Absage ohne Ausweg ist eine Sackgasse mit Begruendung.*
+  
+      ⚠️ Beides zusammen weist der Server ab, nicht diese Zeile: Die Regel
+      gehoert an die Grenze, nicht in die Optik. Hier wird nur weitergereicht.
+    */
+    const wunschId = zerlegt.werte.optionen["firma-id"];
+    const suche = new URLSearchParams();
+    if (wunsch !== undefined)
+        suche.set("firma", wunsch);
+    if (wunschId !== undefined)
+        suche.set("firma-id", wunschId);
+    const pfad = suche.toString() ? `/api/cli/firma?${suche.toString()}` : "/api/cli/firma";
     const antwort = await ruf(pfad, { methode: "GET", mitAusweis: true });
     if (antwort.status === 200) {
         // 🔴 Ein `200` mit unlesbarem Rumpf ist KEIN Erfolg (Review-Befund Runde 1):
@@ -83,17 +100,34 @@ export async function firmaDaten(argv) {
             ? koerper.firmen.filter((x) => typeof x === "string")
             : [];
         console.error(meldung);
-        // Die Namen als FERTIGE Befehle ausgeben, nicht als blosse Liste: Der
-        // naechste Schritt ist dann Kopieren statt Abtippen -- und ein Firmenname
-        // mit Leerzeichen braucht Anfuehrungszeichen, an die sonst niemand denkt.
-        //
-        // ⚠️ Welche Namen einen Befehl bekommen, entscheidet `firmenZeilen` (B-5):
-        // Ein doppelt vergebener Name bekommt KEINEN -- er waere ein Vorschlag,
-        // der garantiert wieder in derselben Absage endet.
-        const zeilen = firmenZeilen(namen);
-        if (zeilen.length > 0) {
-            console.error("\n  Deine Firmen:");
-            zeilen.forEach((z) => console.error(z));
+        /*
+          🔑 **Bei gleichnamigen Firmen fuehrt der Weg ueber die ID** (B-5, zweite
+          Haelfte). Die Route legt dafuer `auswahl` bei -- und erst damit ist die
+          Absage keine Sackgasse mehr.
+        */
+        const auswahl = Array.isArray(koerper.auswahl)
+            ? koerper.auswahl.filter((x) => !!x &&
+                typeof x === "object" &&
+                typeof x.id === "string" &&
+                typeof x.name === "string")
+            : [];
+        if (auswahl.length > 0) {
+            console.error("\n  Diese beiden heissen gleich — nimm die ID:");
+            firmenIdZeilen(auswahl).forEach((z) => console.error(z));
+        }
+        else {
+            // Die Namen als FERTIGE Befehle ausgeben, nicht als blosse Liste: Der
+            // naechste Schritt ist dann Kopieren statt Abtippen -- und ein Firmenname
+            // mit Leerzeichen braucht Anfuehrungszeichen, an die sonst niemand denkt.
+            //
+            // ⚠️ Welche Namen einen Befehl bekommen, entscheidet `firmenZeilen` (B-5):
+            // Ein doppelt vergebener Name bekommt KEINEN -- er waere ein Vorschlag,
+            // der garantiert wieder in derselben Absage endet.
+            const zeilen = firmenZeilen(namen);
+            if (zeilen.length > 0) {
+                console.error("\n  Deine Firmen:");
+                zeilen.forEach((z) => console.error(z));
+            }
         }
         if (grund === "keine-firma") {
             console.error(`\n  Eine Firma anlegen: ${BASIS_URL}/firma/neu`);

package/dist/befehle-katalog.js

@@ -14,28 +14,37 @@
  * ⚠️ 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.",
         ],
     },
     {
@@ -43,11 +52,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 +64,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 +76,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/firmen-liste.js

@@ -50,3 +50,21 @@ export function firmenZeilen(namen) {
     }
     return zeilen;
 }
+/**
+ * Die Zeilen für den Fall, dass zwei Firmen **gleich heissen**.
+ *
+ * 🔑 **Das ist die zweite Haelfte von B-5** (2026-08-18 spaet). Die erste
+ * Haelfte nahm dem doppelten Namen seinen Befehl, damit niemand einen Ausweg
+ * vorgespielt bekommt, den es nicht gibt. Damit war die Irrefuehrung weg --
+ * aber an die Daten kam man immer noch nicht. Die Absage sagte „benenne eine
+ * davon um", und das setzt **Admin-Rechte in einer fremden Firma** voraus.
+ *
+ * *Eine Absage ohne Ausweg ist eine Sackgasse mit Begruendung.*
+ *
+ * Jetzt liefert die Route die IDs mit, und hier entstehen daraus wieder
+ * kopierfertige Befehle. Der Name steht als Kommentar dahinter -- eine nackte
+ * UUID sagt einem Menschen nichts, und zwei davon untereinander noch weniger.
+ */
+export function firmenIdZeilen(auswahl) {
+    return auswahl.map((f, i) => `    kimal3 firma daten --firma-id "${f.id}"   # ${f.name} (${i + 1}.)`);
+}

package/dist/kimal3.js

@@ -71,10 +71,28 @@ function versionsZeilen() {
     }
     return `  kimal3 ${version}\n  spricht mit ${BASIS_URL}`;
 }
+/**
+ * Was diese Zeile sagen KANN — und was nicht.
+ *
+ * 🔴 **Sie liest nur die Datei, sie fragt den Server nicht** (Befund L-9,
+ * 2026-08-18). Hier stand vorher „● Angemeldet als …" — und genau das hat am
+ * selben Abend zehn Minuten Fehlersuche gekostet: Der Ausweis war
+ * serverseitig nicht mehr gueltig, die Zeile behauptete trotzdem munter
+ * „Angemeldet", und die Suche begann an der falschen Stelle.
+ *
+ * *Eine Behauptung ist keine Messung.* Der Zustand, den die Datei kennt,
+ * heisst „hier liegt ein Ausweis" — ob der Server ihn noch annimmt, weiss
+ * allein der Server.
+ *
+ * ⚠️ Bewusst wird trotzdem NICHT nachgefragt: `--version` soll ohne Netz
+ * antworten und darf keine Sekunde haengen. Der ehrliche Weg ist deshalb
+ * nicht mehr Auskunft, sondern **weniger Behauptung**.
+ */
 function zustandsZeile() {
     const a = leseAnmeldung();
     return a
-        ? `  ● Angemeldet als ${a.email}`
+        ? `  ● Ausweis hinterlegt für ${a.email}\n` +
+            "    (ob er noch gilt, zeigt erst der nächste Befehl)"
         : "  ● Nicht angemeldet.  →  kimal3 login";
 }
 async function haupt() {

package/package.json

@@ -1,27 +1,27 @@
-{
-  "name": "kimal3",
-  "version": "0.1.2",
-  "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.4",
+  "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/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.