kimal3 0.1.1 → 0.1.2

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.