kimal3 0.1.1 → 0.1.3

package/dist/projekt-zeilen.js

@@ -0,0 +1,253 @@
+/**
+ * Die Zeilen, die `kimal3 projekt liste` ausgibt — und das Lesen der Antwort.
+ *
+ * 🔑 Eine reine Rechnung, damit `check:cli` sie ohne Server pruefen kann --
+ * dieselbe Ueberlegung wie bei `firmen-liste.ts` und `fehler.ts`.
+ *
+ * ⚠️ **Warum hier eigene Formatierer stehen, obwohl die App `euroBetrag` und
+ * `datumLang` schon hat:** Die CLI ist ein eigenstaendiges npm-Paket mit
+ * `rootDir: src` -- sie kann aus `../../src` nichts importieren. Das ist kein
+ * Versehen, sondern der Preis dafuer, dass das Paket ohne die App baut.
+ *
+ * 🔴 Und ein Unterschied ist ABSICHT, kein Drift: `euroBetrag` in der App
+ * rundet auf ganze Euro, weil eine Monats-Selbstauskunft keine Cent-Genauigkeit
+ * hat. Hier werden Cents ANGEZEIGT, sobald welche dastehen. Grund ist die
+ * Hausregel "erst runden, DANN entscheiden": Wer 0,10 € eingetragen hat und im
+ * Terminal "0 €" liest, haelt seine Eingabe fuer verloren. Das Terminal ist der
+ * Ort der Nachschau, die oeffentliche Karte der Ort der Aussage.
+ */
+/** Ein Zahlenfeld: `null` heisst "nicht angegeben", `false` heisst "unlesbar". */
+function zahlFeld(o, name) {
+    const w = o[name];
+    if (w === undefined || w === null)
+        return null;
+    if (typeof w === "number" && Number.isFinite(w))
+        return w;
+    // 🔴 Eine Zahl, die als Zeichenkette ankommt, wird NICHT still zu "nicht
+    // angegeben". Genau das waere die Faktor-1000-Falle in ihrer leisen Form:
+    // Der Mensch sieht ein Projekt ohne Zahlen und glaubt, seine Eingabe sei nie
+    // angekommen. *Stilles Weglassen ist der schlechteste der drei Wege.*
+    return false;
+}
+/**
+ * Die Projekte aus der Antwort lesen.
+ *
+ * ⚠️ **`null` und `[]` sind zwei verschiedene Wirklichkeiten.** `[]` heisst
+ * "du hast noch keine Projekte" -- eine gueltige Antwort auf eine gueltige
+ * Frage. `null` heisst "diese Antwort war nicht lesbar". Faellt beides auf
+ * denselben Rueckgabewert, feiert der Befehl eine Stoerung als Erfolg und
+ * raet zum Eintragen von etwas, das laengst dasteht.
+ *
+ * 🔑 Auch eine ALTE App-Fassung landet hier auf `null`: Sie antwortet mit
+ * `{ "titel": [...] }` und ohne `projekte`. **Das ist aber NICHT das Ende** --
+ * `projekt-liste.ts` fragt danach `titelAusAlterAntwort` und zeigt die Liste
+ * ohne Zahlen, mit Rueckgabewert `0`. Diese Funktion sagt also nur "ich kann
+ * es nicht lesen", nicht "es ist kaputt".
+ *
+ * ⚠️ Hier stand bis zur Review-Runde 3 (2026-08-18) das Gegenteil: "Der Befehl
+ * meldet dann eine unlesbare Antwort und den Rueckgabewert `3`." Das war vor
+ * L-7 richtig und danach falsch -- und der widersprechende Text stand vierzig
+ * Zeilen ueber der Funktion, die es besser weiss.
+ * *In diesem Projekt sind Kommentare tragend* (siehe
+ * `docs/regeln/messen-und-pruefen.md`, Abschnitt 11, in genau diesem Zweig
+ * hinzugefuegt): Der naechste Leser haette geglaubt, den Rueckfallweg gebe es
+ * nicht -- und ihn vielleicht ein zweites Mal gebaut.
+ */
+export function projekteAusAntwort(koerper) {
+    if (!koerper || typeof koerper !== "object")
+        return null;
+    const roh = koerper.projekte;
+    if (!Array.isArray(roh))
+        return null;
+    const projekte = [];
+    for (const eintrag of roh) {
+        if (!eintrag || typeof eintrag !== "object")
+            return null;
+        const o = eintrag;
+        if (typeof o.titel !== "string")
+            return null;
+        if (typeof o.laeuft !== "boolean")
+            return null;
+        const liveSeit = o.live_seit;
+        if (liveSeit !== null && liveSeit !== undefined && typeof liveSeit !== "string")
+            return null;
+        const stunden = zahlFeld(o, "zeitersparnis_std_wo");
+        const ergebnis = zahlFeld(o, "ergebnis_monat_eur");
+        const umsatz = zahlFeld(o, "umsatz_monat_eur");
+        if (stunden === false || ergebnis === false || umsatz === false)
+            return null;
+        projekte.push({
+            titel: o.titel,
+            live_seit: typeof liveSeit === "string" ? liveSeit : null,
+            laeuft: o.laeuft,
+            zeitersparnis_std_wo: stunden,
+            ergebnis_monat_eur: ergebnis,
+            umsatz_monat_eur: umsatz,
+        });
+    }
+    return projekte;
+}
+const MONATE = [
+    "Januar", "Februar", "März", "April", "Mai", "Juni",
+    "Juli", "August", "September", "Oktober", "November", "Dezember",
+];
+/**
+ * "2026-07-01" → "1. Juli 2026". Bewusst aus der Zeichenkette gerechnet statt
+ * ueber `new Date()`: Ein ISO-Datum ohne Uhrzeit gilt als UTC-Mitternacht und
+ * kippt sonst je nach Zeitzone einen Tag zurueck -- und ein Terminal steht
+ * irgendwo auf der Welt.
+ *
+ * ⚠️ Erwartet ein REINES Datum (`JJJJ-MM-TT`), wie es die `date`-Spalte
+ * `live_seit` liefert. Passt es nicht, steht lieber das rohe Datum da als ein
+ * kaputter Satz ("NaN. August 2026" -- der Fehler vom 2026-08-12).
+ */
+function datumLang(isoDatum) {
+    const [jahr, monat, tag] = isoDatum.split("-");
+    const monatsname = MONATE[Number(monat) - 1];
+    if (!monatsname || !jahr || !Number.isFinite(Number(tag)))
+        return isoDatum;
+    return `${Number(tag)}. ${monatsname} ${jahr}`;
+}
+/**
+ * "1200" → "1.200 €", "0.1" → "0,10 €".
+ *
+ * Cents erscheinen nur, wenn welche da sind: "1.200,00 €" taeuscht eine
+ * Genauigkeit vor, die niemand behauptet hat -- "0 €" bei 0,10 € verschweigt
+ * dagegen eine, die dasteht.
+ */
+function euro(wert) {
+    const hatCent = Math.round(wert * 100) % 100 !== 0;
+    const stellen = hatCent ? 2 : 0;
+    return `${new Intl.NumberFormat("de-DE", {
+        minimumFractionDigits: stellen,
+        maximumFractionDigits: stellen,
+    }).format(wert)} €`;
+}
+/** "6" → "6", "6.5" → "6,5". Die Spalte ist numeric(6,2). */
+function stunden(wert) {
+    return new Intl.NumberFormat("de-DE", { maximumFractionDigits: 2 }).format(wert);
+}
+/** Was oben in der zweiten Zeile steht: laeuft, geplant oder noch nicht live. */
+function zustand(p) {
+    if (p.live_seit === null)
+        return "noch nicht live";
+    return p.laeuft
+        ? `live seit ${datumLang(p.live_seit)}`
+        : `geplant ab ${datumLang(p.live_seit)}`;
+}
+/**
+ * Zwei Zeilen je Projekt: Titel, darunter die Angaben.
+ *
+ * 🔑 **Was fehlt, wird als fehlend gezeigt** -- nie durch 0 ersetzt. Ein
+ * Projekt ohne Zahlen ist der Normalfall: Nicht jede Automation hat einen
+ * Eurobetrag, und eine erfundene 0 stuende spaeter oeffentlich auf der Karte
+ * eines Menschen. Eine ausdrueckliche 0 ist dagegen eine ANGABE und wird
+ * gezeigt -- deshalb wird auf `null` geprueft, nicht auf Wahrheitswert.
+ */
+export function projektZeilen(projekte) {
+    const zeilen = [];
+    projekte.forEach((p, i) => {
+        if (i > 0)
+            zeilen.push("");
+        zeilen.push(`    ${i + 1}. ${p.titel}`);
+        const teile = [zustand(p)];
+        if (p.zeitersparnis_std_wo !== null) {
+            teile.push(`${stunden(p.zeitersparnis_std_wo)} Std./Woche`);
+        }
+        if (p.ergebnis_monat_eur !== null) {
+            teile.push(`${euro(p.ergebnis_monat_eur)} Ergebnis/Monat`);
+        }
+        if (p.umsatz_monat_eur !== null) {
+            teile.push(`${euro(p.umsatz_monat_eur)} Umsatz/Monat`);
+        }
+        // Nur der Zustand steht da? Dann sagen wir das ausdruecklich, statt eine
+        // halbe Zeile hinzustellen, die aussieht, als sei etwas abgeschnitten.
+        if (teile.length === 1)
+            teile.push("keine Zahlen eingetragen");
+        zeilen.push(`       ${teile.join(" · ")}`);
+    });
+    return zeilen;
+}
+/**
+ * Liest die ALTE Antwortform (`titel: string[]`, ohne `projekte`).
+ *
+ * 🔑 **Wofuer das da ist** (Befund L-7, 2026-08-18): Die CLI kann neuer sein
+ * als die App -- in jedem Deployment-Fenster zwischen `npm publish` und dem
+ * fertigen Vercel-Build. Dann antwortet der Server voellig korrekt, nur in der
+ * alten Form. Ohne diese Funktion faellt das in denselben Topf wie eine
+ * kaputte Antwort, und die CLI raet zum Wiederholen -- was hier NIE hilft.
+ *
+ * Gibt `null` zurueck, wenn es auch die alte Form nicht ist. Dann ist die
+ * Antwort wirklich unlesbar, und der Rat zum Wiederholen stimmt.
+ */
+export function titelAusAlterAntwort(koerper) {
+    if (!koerper || typeof koerper !== "object")
+        return null;
+    const o = koerper;
+    // ⚠️ Nur wenn `projekte` FEHLT. Ist es da und war trotzdem unlesbar, ist die
+    // Antwort defekt -- dann darf sie nicht als "alte Version" durchgehen.
+    if ("projekte" in o)
+        return null;
+    // Ab Runde 6 stuetzt sich das auf `titelFeldLesen` -- dieselbe Regel darf
+    // nicht an zwei Orten stehen.
+    return titelFeldLesen(koerper);
+}
+/**
+ * Wie viele Projekte ein Erfolgsprofil hoechstens traegt.
+ *
+ * ⚠️ **Das ist eine KOPIE von `MAX_PROJEKTE` aus
+ * `src/app/(erfolgsprofil)/typen.ts`** — die CLI ist ein eigenstaendiges
+ * npm-Paket mit `rootDir: src` und kann aus der App nichts importieren.
+ *
+ * 🔴 **Deshalb misst `npm run check:cli`, dass die beiden Zahlen gleich sind**
+ * (Review-Befund, 2026-08-18). Vorher stand die `12` an zwei Stellen in
+ * `projekt-liste.ts` fest im Text, und nichts pruefte sie gegen die App: Wer
+ * die Grenze dort anhebt, laesst die CLI still weiter "von 12" behaupten.
+ * *Dieselbe Zahl an drei Tueren — das Muster, das dieses Projekt schon zweimal
+ * eingefangen hat.*
+ */
+export const MAX_PROJEKTE_ANZEIGE = 12;
+/**
+ * Sagt, ob die Antwort ueberhaupt ein Feld `projekte` mitbringt.
+ *
+ * 🔑 **Wofuer das da ist** (Review-Runde 4, 2026-08-18): Es schliesst die
+ * Vertraeglichkeits-Matrix in der letzten offenen Richtung. Bisher gab es
+ * zwei Faelle:
+ *   - die App ist AELTER (kein `projekte`, nur `titel`) -> `titelAusAlterAntwort`
+ *   - die Antwort ist Muell (WLAN-Portal, HTML) -> "nicht lesbar", noch mal
+ *
+ * Der dritte fehlte: **die App ist NEUER als die CLI.** Dann steht `projekte`
+ * da, aber ein Eintrag hat eine Form, die diese Fassung nicht kennt --
+ * `projekteAusAntwort` steigt beim ersten aus und gibt `null`. Elf gute
+ * Projekte verschwinden mit dem zwoelften, und der Mensch bekam den Rat,
+ * es gleich noch einmal zu versuchen. **Der Zustand ist aber stabil** --
+ * Wiederholen aendert nichts, bis das Werkzeug aktualisiert wird.
+ *
+ * *Genau die Form von B-5, B-7 und L-7 -- in der einen Richtung, die dieser
+ * Zweig noch nicht abgedeckt hatte.*
+ */
+export function antwortHatProjekteFeld(koerper) {
+    return !!koerper && typeof koerper === "object" && "projekte" in koerper;
+}
+/**
+ * Liest das Feld `titel` — **ohne** zu fragen, ob `projekte` daneben steht.
+ *
+ * 🔑 **Wofuer** (Review-Runde 6, 2026-08-18): Die neue Route liefert `titel`
+ * und `projekte` IMMER gemeinsam. Aendert eine spaetere App-Fassung die Form
+ * eines Eintrags, steigt `projekteAusAntwort` beim ersten aus -- die zwoelf
+ * Titel stehen aber unveraendert daneben. Sie dann nicht zu zeigen und
+ * stattdessen "npm install -g kimal3" zu sagen, wirft Daten weg, die man hat.
+ *
+ * *Wer dem Menschen etwas geben kann, gibt es ihm -- und sagt dazu, was
+ * fehlt.*
+ */
+export function titelFeldLesen(koerper) {
+    if (!koerper || typeof koerper !== "object")
+        return null;
+    const roh = koerper.titel;
+    if (!Array.isArray(roh))
+        return null;
+    if (!roh.every((t) => typeof t === "string"))
+        return null;
+    return roh;
+}

package/package.json

@@ -1,16 +1,27 @@
-{
-  "name": "kimal3",
-  "version": "0.1.1",
-  "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.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"
+}

package/skill/SKILL.md

@@ -1,43 +1,125 @@
----
-name: kimal3
-description: Use when the user has finished an AI project and wants it recorded in their kimal3 Erfolgsprofil, or asks to list/add projects there.
----
-
-# 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.
-
-## Rückgabewerte
-`0` erledigt · `1` Eingabe passt nicht · `2` Anmeldung fehlt · `3` vorübergehende Störung,
-einmal wiederholen · `4` angemeldet, aber kein Pro-Zugang — **nicht** wiederholen
+---
+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.*

package/skill/commands/k3.md

@@ -0,0 +1,44 @@
+---
+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**.

package/skill/commands/k3firma.md

@@ -0,0 +1,57 @@
+---
+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).

package/skill/commands/k3liste.md

@@ -0,0 +1,26 @@
+---
+description: Deine eingetragenen Projekte zeigen
+---
+
+<!-- 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. -->
+# Projekte zeigen
+
+```
+kimal3 projekt liste
+```
+
+Gib die Liste **lesbar** wieder, nicht als rohe Ausgabe: Titel, seit wann live, und die
+Zahlen, die dranstehen. Was fehlt, benenne als fehlend — erfinde nichts dazu.
+
+Drei Zustände kommen vor, und sie bedeuten Verschiedenes: **live seit …** läuft heute,
+**geplant ab …** liegt noch in der Zukunft, **noch nicht live** hat gar kein Datum. Wirf
+sie nicht zusammen — „geplant" ist keine Aussage über heute.
+
+Ist die Liste leer, ist das kein Fehler: Dann steht noch nichts im Erfolgsprofil, und der
+nächste Schritt ist `/k3projekt <was du gebaut hast>`.
+
+Klappt der Abruf nicht, deute den Rückgabewert nach **`~/.claude/skills/kimal3/SKILL.md`,
+Abschnitt „Rückgabewerte"** — vor allem: `4` **nicht** wiederholen und **nicht** `login`
+vorschlagen.

package/skill/commands/k3projekt.md

@@ -0,0 +1,44 @@
+---
+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.