kimal3 0.1.6 → 0.2.1

package/dist/nachricht.js

@@ -62,6 +62,21 @@ function teile(v) {
     }
     return zahlen;
 }
+/**
+ * Laesst sich das ueberhaupt als Versionsstand lesen?
+ *
+ * 🔴 **Gebraucht, weil `istAelter` unten bei Muell `false` sagt** -- und
+ * `false` heisst dort „nicht aelter", was ein Aufrufer als „neu genug" liest.
+ * Fuer den Update-Hinweis ist das richtig („im Zweifel schweigen"), fuer eine
+ * Faehigkeits-Frage (`cli/src/faehigkeiten.ts`) ist es genau verkehrt: Dort
+ * wuerde ein unlesbarer Kopf zur Auskunft „die Fassung kann alles".
+ *
+ * *Dieselbe Antwort `false` bedeutet an zwei Stellen Verschiedenes -- deshalb
+ * muss die Frage „ist das ueberhaupt eine Nummer" getrennt gestellt werden.*
+ */
+export function istVersionsstand(v) {
+    return teile(v) !== null;
+}
 /**
  * Ist `a` aelter als `b`? Zahl fuer Zahl, nicht als Text.
  *
@@ -100,9 +115,73 @@ export function heuteAus(d) {
     return new Intl.DateTimeFormat("sv-SE", { timeZone: "Europe/Berlin" }).format(d);
 }
 /**
- * Die ganze Entscheidung, als Funktion von vier Werten.
+ * Die Kennung eines FIRMENKONTEXT-Hinweises faengt hiermit an, und dahinter
+ * steht der Server-Stand, den er meint (`kontext-2026-08-26T09:00:00Z`).
+ *
+ * 🔑 Sie steht als eigener Name da, weil sie von ZWEI Seiten gebraucht wird:
+ * `firmenHinweisAus` baut die Kennung, `hinweisErledigt` liest sie wieder
+ * auseinander. Zwei getippte `"kontext-"` waeren zwei Wahrheiten -- und die
+ * zweite verrottete lautlos, weil ein Hinweis, der nicht mehr erkannt wird,
+ * einfach wieder erscheint, statt einen Fehler zu machen.
  */
-export function sollZeigen(h, eigeneVersion, gesehen, heute) {
+export const KONTEXT_HINWEIS_PRAEFIX = "kontext-";
+/**
+ * Ist der ANLASS dieses Hinweises inzwischen erledigt?
+ *
+ * 🔴 DER FALL, DER DIESE FUNKTION RECHTFERTIGT (offener Punkt A-4, gemessen
+ * am 2026-08-26): Direkt nach `kimal3 kontext runter` stand da
+ *
+ *     Dein Firmenkontext ist aktuell.
+ *     Nordwind hat den Firmenkontext aktualisiert.  kimal3 kontext runter
+ *
+ * -- die zweite Zeile riet zu genau dem Befehl, der gerade gelaufen war. Kein
+ * Rechenfehler: Die CLI schickt ihren Stand VOR dem Herunterladen mit, der
+ * Server vergleicht ihn mit seinem eigenen und haengt den Hinweis an. Bis der
+ * Hinweis ausgegeben wird, hat der Befehl den lokalen Stand laengst
+ * nachgezogen. *Die Meldung kam einen Aufruf zu spaet.*
+ *
+ * Die Regel dagegen: **Ein Hinweis, dessen Stand der lokale Merkzettel JETZT
+ * traegt, ist erledigt und wird nicht ausgegeben.**
+ *
+ * ⚠️ NUR Kontext-Hinweise. Die globale Nachricht aus der Datenbank traegt eine
+ * UUID als Kennung und darf durch diese Regel NIE verstummen -- sie hat mit
+ * dem Firmenkontext nichts zu tun, und ein Kanal, der sich versehentlich selbst
+ * stilllegt, faellt niemandem auf.
+ *
+ * ⚠️ `null` und leer heissen "wir wissen es nicht", nicht "erledigt": Wer den
+ * lokalen Stand nicht kennt, darf keinen Hinweis unterdruecken. Im Zweifel
+ * zeigen -- eine Zeile zu viel ist harmlos, eine verschluckte Zeile nicht.
+ */
+export function hinweisErledigt(hinweisId, lokalerStandJetzt) {
+    if (!hinweisId)
+        return false;
+    if (!hinweisId.startsWith(KONTEXT_HINWEIS_PRAEFIX))
+        return false;
+    const gemeinterStand = hinweisId.slice(KONTEXT_HINWEIS_PRAEFIX.length);
+    if (gemeinterStand === "")
+        return false;
+    if (lokalerStandJetzt === null || lokalerStandJetzt === "")
+        return false;
+    return gemeinterStand === lokalerStandJetzt;
+}
+/**
+ * Die ganze Entscheidung, als Funktion von fuenf Werten.
+ *
+ * 🔴 `lokalerKontextStandJetzt` IST ABSICHTLICH PFLICHT, nicht optional
+ * (A-4). Am 2026-08-26 hat dieses Projekt gemessen, was ein optionales
+ * Argument anrichtet: `lageFuerDatei` konnte erkennen, dass sich unsere
+ * Vorlage geaendert hat -- die Aufrufstelle uebergab den noetigen Wert nie,
+ * und weil das Argument optional war, fehlte keine Zeile, meckerte kein
+ * Compiler und wurde kein Waechter rot. Die Rechnung war gebaut, geprueft,
+ * dokumentiert und in der Wirklichkeit tot. *Ein Pflicht-Argument ist die
+ * einzige Verdrahtung, die der Compiler fuer einen mitdenkt.*
+ *
+ * 🔑 UND ER MUSS FRISCH SEIN. Der Wert, den die CLI im Kopf mitschickt, wird
+ * VOR dem Netzaufruf gelesen; dieser hier gehoert an das ENDE des Befehls.
+ * Wer denselben Wert zweimal benutzt, baut den Fehler wieder ein, gegen den
+ * `hinweisErledigt` geschrieben ist.
+ */
+export function sollZeigen(h, eigeneVersion, gesehen, heute, lokalerKontextStandJetzt) {
     if (!h.id)
         return false;
     if (!h.text || h.text.trim() === "")
@@ -110,6 +189,11 @@ export function sollZeigen(h, eigeneVersion, gesehen, heute) {
     // Leeres Feld = alle sehen es. Sonst nur, wer aelter ist als die Grenze.
     if (h.gilt_unter_version && !istAelter(eigeneVersion, h.gilt_unter_version))
         return false;
+    // Der Anlass ist erledigt -- der Befehl, zu dem geraten wird, ist gerade
+    // gelaufen. Bewusst VOR der Tagessperre: Ein Hinweis, der gar nicht mehr
+    // gilt, soll auch nicht den einen Platz des Tages verbrauchen.
+    if (hinweisErledigt(h.id, lokalerKontextStandJetzt))
+        return false;
     // Hoechstens einmal am Tag -- auch bei zwanzig Befehlen.
     if (gesehen[h.id] === heute)
         return false;
@@ -196,3 +280,54 @@ export function skillZustand(inhalt, eigeneVersion) {
 export function skillMeldung() {
     return "\n  →  Deine kimal3-Skilldateien sind aelter als die CLI.  kimal3 skill install\n";
 }
+/**
+ * Zerlegt den Kopf `X-Kimal3-Kontext-Stand`: `<firmen-id>:<stand>` (Task 10).
+ *
+ * ⚠️ AM ERSTEN DOPPELPUNKT TRENNEN, nicht am `split(":")[1]`: `stand` ist oft
+ * ein ISO-Zeitstempel und traegt selbst Doppelpunkte
+ * (`2026-08-21T07:12:33.456Z`). Ein `split` wuerde ihn mitten durchschneiden.
+ *
+ * Fehlt der Kopf, ist er leer, hat keinen Doppelpunkt oder ist eine Seite
+ * leer -> `null`. Diese Datei rechnet nur; SIE PRUEFT NICHT, ob die Firmen-ID
+ * echt ist oder der Anrufer ihr Mitglied ist -- das ist Datenbankzugriff und
+ * gehoert der Aufrufstelle (`src/lib/cli/nachricht.ts`).
+ */
+export function kontextStandAusKopf(wert) {
+    if (!wert)
+        return null;
+    const trenner = wert.indexOf(":");
+    if (trenner <= 0)
+        return null;
+    const firmaId = wert.slice(0, trenner);
+    const stand = wert.slice(trenner + 1);
+    if (stand === "")
+        return null;
+    return { firmaId, stand };
+}
+/**
+ * Die ZWEITE Quelle des Update-Kanals (Task 10) -- rein: Sie bekommt den
+ * lokalen Stand (aus dem Kopf, schon geparst) und den server-gefuehrten
+ * Stand samt Firmennamen fertig nachgeschlagen und ENTSCHEIDET nur noch.
+ *
+ * 🔴 WARUM DER SERVER-STAND UND NICHT DER ROHE KOPF VERGLICHEN WIRD: Der
+ * Server weiss nicht, was auf der Platte des Kunden liegt -- die CLI schickt
+ * ihren Stand, die App vergleicht ihn nur mit ihrem eigenen (Bauplan Step 2).
+ *
+ * 🔑 `id: kontext-<serverStand>` (Step 3): Die Tagessperre der CLI merkt sich
+ * Hinweise nach `id` -- aendert die Firma den Kontext ein zweites Mal am
+ * selben Tag, aendert sich `serverStand` und damit automatisch die `id`. Der
+ * Hinweis erscheint also je NEUEM Stand genau einmal, ohne dass diese
+ * Funktion selbst je ein Datum ansieht.
+ *
+ * 🔑 US-8: `firmenName` steht IM TEXT, nicht nur die ID -- wer in zwei Firmen
+ * ist, muss lesen koennen, WELCHE gemeint ist.
+ */
+export function firmenHinweisAus(lokalerStand, serverStand, firmenName) {
+    if (lokalerStand === serverStand)
+        return null;
+    return {
+        id: `${KONTEXT_HINWEIS_PRAEFIX}${serverStand}`,
+        text: `${firmenName} hat den Firmenkontext aktualisiert.  kimal3 kontext runter`,
+        gilt_unter_version: null,
+    };
+}

package/package.json

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

package/skill/SKILL.md

@@ -43,6 +43,21 @@ Das ist meist richtig, aber nicht immer schön (`s.mueller@…` wird zu `werkban
 **Frag den Menschen nach seinem Vornamen und gib ihn mit**, statt es dem Server zu überlassen —
 er heißt selten so, wie seine Adresse aussieht.
 
+🔴 **Gehört der Mensch zu MEHREREN Firmen, fragen beide Befehle nach — mit `--firma`.**
+Sie legen dann nichts an, sondern nennen die Firmen als fertige Zeilen zum Kopieren. Das ist
+kein Fehler, sondern die Rückfrage: Der Ordner trägt den Namen der Firma, und raten darf der
+Befehl ihn nicht.
+
+```
+kimal3 arbeitsplatz neu sabine --firma "Nordwind Handel GmbH"
+kimal3 werkbank neu sabine --firma "Nordwind Handel GmbH"
+kimal3 werkbank neu sabine --firma-id "…"      # falls zwei Firmen GLEICH heissen
+```
+
+⚠️ Der Rückgabewert ist dann `1` und die Absage steht auf der Fehlerausgabe. **Nimm eine der
+angebotenen Zeilen, statt es unverändert zu wiederholen** — ohne `--firma` kommt dieselbe
+Rückfrage noch einmal.
+
 ⚠️ **`werkbank neu` verlangt ein eigenes Pro-Konto.** Die Route prüft den Plan **pro Person**
 (`konto_plan`), nicht über die Firmen-Mitgliedschaft. Ein Kollege ohne eigenes Pro bekommt
 Rückgabewert `4` — dann **nicht** wiederholen und nicht raten, sondern genau das sagen: Sein
@@ -66,21 +81,99 @@ Der oberste Ordner heißt immer gleich, ein zweiter Name ist dort nicht mehr vor
 Frage bleibt trotzdem stehen — **weil sie die richtige ist**, nicht weil die Falle noch offen
 wäre.
 
-**Danach:** in die Werkbank wechseln und **jeden Platzhalter in eckigen Klammern** gemeinsam
-ausfüllen — `[FIRMA]` und `[NAME]` sind nur die häufigsten, es sind zehn verschiedene. Sie
-stehen absichtlich noch drin — frag nach, statt zu raten. `[DATUM]` ist schon gefüllt.
+**Danach:** in die **Werkbank** wechseln und dort die Platzhalter in eckigen Klammern
+gemeinsam ausfüllen — es sind vier verschiedene. Such nach eckigen Klammern, statt einer Liste
+zu folgen: Eine abgetippte Liste veraltet in dem Moment, in dem die Vorlage wächst. Frag nach,
+statt zu raten.
 
-🔑 **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.
+⚠️ `[FIRMA]` findest du meist schon ausgefüllt — den Namen setzt der Server beim Ausliefern ein.
+`[DATUM]` ebenso. Was übrig bleibt, sind die Angaben über den **Menschen** vor dir.
 
-⚠️ **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.*
+🔴 **Nur in der Werkbank — nirgends sonst.** Die oberste `CLAUDE.md` und alles in `kontext/`
+gehören der **Firma**, nicht dem Menschen vor dir. Den Firmennamen setzt der Server beim
+Ausliefern selbst ein; die Fragen in `kontext/` beantwortet ihr über
+`kimal3 kontext fragen` (s. den nächsten Abschnitt). **Schreib dort nichts hinein, was du dir
+selbst ausgedacht hast** — beim nächsten `kimal3 kontext runter` ist es weg, und bis dahin steht
+dort eine Auskunft über die Firma, die sich niemand aus der Firma ausgedacht hat.
 
 ⚠️ **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.
 
+## Firmenkontext aktuell halten (`kimal3 kontext runter` · `kimal3 kontext hoch`)
+
+**Wann:** Der Mensch fragt, ob sein Firmenkontext aktuell ist, hat gerade `arbeitsplatz neu`
+oder `werkbank neu` ausgeführt, will wissen, was am Firmenkontext noch fehlt, oder will als
+Admin eine Änderung an `kontext/*.md` an die Firma weitergeben.
+
+`kimal3 kontext runter` holt `CLAUDE.md` und die fünf Dateien in `kontext/`
+(`kurzprofil.md`, `firma.md`, `marke.md`, `systeme.md`, `sicherheit.md`) von der Firma und legt
+sie im gefundenen KI-Arbeitsplatz ab. Lokal geänderte Dateien fasst er **nicht** an — er sagt in
+seiner Ausgabe, was als Nächstes zu tun ist (Admin: `kontext hoch`; sonst: an den genannten
+Admin weitergeben).
+
+### Den Firmenkontext ausfüllen — der Ablauf
+
+In `kontext/` stehen **Fragen über die Firma**, keine Lückentexte. Beantwortet werden sie im
+Gespräch mit dir — oder in der App unter **Firma → Kontext**. Beide Wege führen an dieselbe
+Stelle.
+
+1. **`kimal3 kontext fragen`** — er gibt jede Frage aus, unter der noch nichts steht: Datei,
+   Anker, Frage, Hinweis. Sind alle beantwortet, sagt er das in einem Satz, und du bist fertig.
+   Der Befehl liest nur; er braucht weder Netz noch Anmeldung.
+2. **Die Fragen EINZELN stellen.** Eine Frage, die Antwort abwarten, dann die nächste. Keine
+   lange Liste und kein Fragebogen am Stück — es sind Fragen über die Firma eines Menschen, und
+   die beantwortet er nicht in einem Rutsch.
+3. **Die Antwort in die genannte Datei schreiben** — unter ihre `## `-Überschrift, über der der
+   Anker steht. Die Hinweiszeilen mit `>` gehören uns; **lass sie stehen und schreib darunter.**
+
+   🔴 **Die Pfade zählen ab dem Ordner, den `kontext fragen` als `Arbeitsplatz:` nennt — nicht
+   ab deinem Arbeitsverzeichnis.** Der Normalfall ist, dass beides auseinanderfällt:
+   `kimal3 arbeitsplatz neu` rät ausdrücklich, in die **Werkbank** zu wechseln und dort Claude
+   zu starten; die fünf Dateien liegen dann eine Ebene höher. **Setz jeden Pfad an den
+   genannten Arbeitsplatz an, bevor du schreibst.**
+   ⚠️ Wer das übergeht, legt eine **neue** Datei am falschen Ort an. `kimal3 kontext hoch` liest
+   weiter die echten Dateien und schickt leere Antworten hoch — *beide Seiten melden Erfolg, und
+   die Arbeit des Menschen ist trotzdem weg.*
+4. **`kimal3 kontext hoch`** — schickt alle fünf Dateien an die Firma. **Nur der Firmen-Admin
+   darf das.**
+
+🔴 **Erfinde keine Antwort, und schlage keine vor, die wie eine Antwort aussieht.** Genau
+deshalb gibt es diesen Umbau: Vorher standen dort fertige Beispieltexte von kimal3, und ein
+Klick machte sie zur Aussage der Firma. Weiß der Mensch etwas nicht, **bleibt die Frage offen**
+— sie ist dann beim nächsten `kimal3 kontext fragen` wieder da. Ein „[noch klären]", das er
+selbst schreibt, ist in Ordnung; ein Satz, den du dir ausdenkst, nicht.
+
+⚠️ **Sieht eine der fünf Dateien nicht mehr aus wie ihre Frageliste — etwa weil etwas Fremdes
+darüberkopiert wurde —, bricht `kontext hoch` ab und schickt gar nichts, auch die vier anderen
+nicht** (Rückgabewert `1`). Das ist **kein** „noch einmal versuchen": Sag dem Menschen, welche
+Datei gemeint ist, und hol sie mit `kimal3 kontext runter` zurück.
+
+🔴 **Bei `kontext hoch` sagt die Zahl `1` allein GAR NICHTS — die Meldung sagt es. LIES SIE.**
+
+⚠️ **Hier stand bis zum 2026-08-28: „Rückgabewert `1` heißt ‚du bist kein Admin dieser
+Firma'".** Das war falsch und gefährlich. `kontext hoch` hat **sechs** verschiedene Ausgänge
+auf dieser einen Zahl (`cli/src/befehle/kontext-hoch.ts`): unbekannte Option · kein
+Arbeitsplatz gefunden · eine Datei nicht lesbar · eine Datei ohne Fragen · „jemand anderes hat
+geändert" (Ausweg `--ueberschreiben`) · mehrere Firmen (Ausweg `--firma`) — und die Rolle.
+
+🔴 **Der teuerste davon steht in `kontext-hoch.ts` (Merkzettel-Zweig) und ist ein ERFOLG:** *„Die Firma hat
+deine Änderungen gespeichert — nur der lokale Merkzettel ließ sich nicht schreiben."* Auch das
+gibt `1` zurück. Wer die Zahl als „kein Admin" deutet, sagt einem Menschen, der gerade alle
+Fragen beantwortet und **erfolgreich hochgeschickt** hat, er solle sich an seinen Admin wenden.
+*Ein Erfolg, als Absage vorgelesen — und er tippt danach alles noch einmal.*
+
+**Also:** Nimm den Satz, den der Befehl geschrieben hat, und sag dem Menschen, was er bedeutet.
+Geht es wirklich um die Rolle, nenne den Admin — lief vorher `kontext runter`, kennt dessen
+Ausgabe den Namen bereits; sonst frag, wer in der Firma Admin ist. Ein zweiter Versuch hilft nur
+dort, wo die Meldung einen Ausweg nennt (`--ueberschreiben`, `--firma`), sonst nie.
+
+⚠️ **Beide Befehle brauchen wie `werkbank neu` ein eigenes Pro-Konto** — ohne das kommt
+Rückgabewert `4`, dann **nicht wiederholen**.
+
+`kimal3 kontext hoch --ueberschreiben` erzwingt das Speichern, auch wenn die Firma inzwischen von
+jemand anderem geändert wurde. **Nur auf ausdrücklichen Wunsch einsetzen** — sonst geht die
+Änderung des Kollegen oder der Kollegin verloren.
+
 ## Erst nachsehen, dann schreiben
 `kimal3 projekt liste` — steht es schon da, **nicht** noch einmal eintragen.
 
@@ -186,8 +279,10 @@ mitbestimmungspflichtig. Das entscheidet die Firma, nicht dieses Werkzeug.
 **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.
+zuerst ein Erfolgsprofil an", „die Eingabe passt nicht", „das Paket ist unvollständig", und bei
+`kontext hoch` ausdrücklich **„du bist kein Admin"** (s. oben) — dort **nicht** wiederholen,
+sondern sagen, an wen sich der Mensch wendet. **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

package/skill/commands/k3.md

@@ -1,24 +1,69 @@
 ---
-description: Übersicht — alle kimal3-Befehle und was du damit tun kannst
+description: Wo du stehst — und alle kimal3-Befehle auf einen Blick
 ---
 
 <!-- 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
+# kimal3 — wo du stehst
+
+Beantworte zuerst **„wo stehe ich?"**, erst danach kommt die Befehlsliste. Dieser Befehl
+**trägt nichts ein** — er liest nur.
+
+## 1. Den Stand holen — drei Aufrufe in dieser Reihenfolge
+
+```
+kimal3 --version
+kimal3 kontext fragen
+kimal3 projekt liste
+```
+
+🔴 **Die tragende Regel: Was lokal beantwortbar ist, wird IMMER beantwortet.** Die ersten
+beiden lesen nur Dateien auf der Platte — weder Netz noch Anmeldung. Nur der dritte geht
+ins Netz. Kommt er mit **irgendeinem** Wert außer `0` zurück, **brich nicht ab**: schreib bei
+den Projekten, was seine Meldung sagt, und **stell die beiden lokalen Zeilen trotzdem hin**.
+
+🔴 **Und `1` ist bei `projekt liste` KEINE Störung, sondern der Normalzustand eines frischen
+Pro-Käufers:** *„Du hast noch kein Erfolgsprofil."* Ein Profil hat erst, wer den Kurs durch
+hat — der Kunde, für den dieser Befehl gebaut ist, sieht das also beim ersten Mal fast immer.
+„Gerade nicht abrufbar" wäre hier **falsch**; schreib `Erfolgsprofil: noch keins` und nimm den
+Schritt aus Abschnitt 3.
+⚠️ Die Liste `2`/`3`/`4` stand hier bis zur vierten Prüfrunde allein — und ließ ausgerechnet
+den häufigsten Fall ungedeckt. *Zähl bei Rückgabewerten nie auf, was du kennst; sag, was bei
+allem anderen gilt.*
+*Ein Befehl, der sagt, wo man steht, darf nicht ausgerechnet dann verstummen, wenn etwas
+nicht stimmt* — sonst schweigt er genau in dem Moment, in dem jemand wissen will, was ihm
+fehlt. Auch `4` (kein Pro-Zugang) ist hier **kein** Grund zu schweigen.
+
+## 2. Die vier Zeilen, die du hinschreibst
+
+| Zeile | Woher — und was dabei zu beachten ist |
+|---|---|
+| `Ausweis hinterlegt für <adresse>` | Aus `--version`. ⚠️ Sag **nicht** „angemeldet als": Die Zeile liest nur die Ausweis-Datei; ob der Server ihn noch annimmt, weiß allein der Server. Steht dort `Nicht angemeldet.`, ist **das** die Lage. |
+| `Firmenkontext: <N> von <M> Fragen noch offen` | Aus `kontext fragen`, **wörtlich übernommen**. ⚠️ Die Platzhalter stehen hier mit Absicht: Eine Beispielzahl in genau der Zeile, die „wörtlich übernehmen" sagt, lädt zum Abschreiben ein. 🔴 **Rechne die Zahl NICHT um** in „3 von 17 beantwortet": Das wäre eine zweite Wahrheit über dieselbe Sache, und sie wird falsch, sobald sich der Fragenkatalog ändert. Sind alle beantwortet, sagt er es selbst (`✓ Alle … Fragen …`) — dann übernimm auch das. ⚠️ Die Gesamtzahl ist **nicht fest**: Sie hängt am Fragenkatalog des Ordners und wächst mit ihm. Nenne nie eine Zahl, die du nicht gerade gelesen hast. |
+| `Projekte im Profil: 2` | Aus `projekt liste`. Klappt der Abruf nicht: „gerade nicht abrufbar", und weiter nach der Regel oben. |
+| **`Dein nächster Schritt: …`** | Aus den drei Zeilen abgeleitet — s. Abschnitt 3. Fehlt eine Angabe, nenn den Schritt **so weit wie möglich**, statt gar keinen. |
+
+## 3. Der nächste Schritt — die Lage entscheidet, nicht die Gewohnheit
 
-Zeig dem Menschen, was dieses Werkzeug kann. **Nichts abrufen, nichts eintragen** — dieser
-Befehl erklärt nur.
+| Lage | Was du sagst |
+|---|---|
+| `--version` sagt `Nicht angemeldet.` | `! kimal3 login` — **der Mensch tippt das selbst**, er bestätigt im Browser. Das kann ich nicht für ihn tun. |
+| Angemeldet, aber `kontext fragen` bricht mit `1` und „Hier steht kein KI-Arbeitsplatz" ab | 🔴 **Rate hier NICHT sofort `arbeitsplatz neu`.** Die Meldung heißt „ich habe von hier aufwärts keinen gefunden" — nicht „es gibt keinen". Der häufigere Fall ist, dass der Mensch schlicht woanders steht; die CLI selbst rät deshalb „Wechsle in deinen Arbeitsplatz-Ordner". **Frag erst: „Hast du schon einen KI-Arbeitsplatz-Ordner?"** Ja → dorthin wechseln und noch einmal. Nein → `! kimal3 arbeitsplatz neu`, vom Menschen getippt. ⚠️ Wer hier falsch rät, legt einen **zweiten, leeren** Arbeitsplatz an; der Firmenkontext steht danach in zwei Ordnern, und `kontext hoch` schickt aus dem falschen. |
+| Arbeitsplatz da, Fragen offen | `/k3kontext` — ich stelle die Fragen einzeln. |
+| `projekt liste` sagt „Du hast noch kein Erfolgsprofil" | Das Profil entsteht im Kurs. Nenn die Adresse aus seiner Meldung (`…/profil`) — **nicht** `/k3projekt`: Ohne Profil gibt es nichts, worin ein Projekt stehen könnte. |
+| Alles beantwortet, Profil da, aber keine Projekte | `/k3projekt <was du gebaut hast>` |
+| Alles steht | Sag genau das — **erfinde keinen Schritt**, nur damit einer dasteht. |
 
-## 1. Die Befehlsliste holen, nicht auswendig aufsagen
+## 4. 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.
+Führe `kimal3 --help` aus. 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
+## 5. So aufbereiten, dass klar wird, WER tippt
 
 Stell die Liste in zwei Gruppen dar:
 
@@ -30,20 +75,22 @@ Stell die Liste in zwei Gruppen dar:
 
 | Slash-Befehl | Wofür |
 |---|---|
+| `/k3` | Wo du stehst — dieser Befehl hier |
+| `/k3kontext` | Durch die offenen Fragen über deine Firma führen |
 | `/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 |
+| `/k3analyse <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
+## 6. Der sechste 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**
+- Die fünf **`/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
@@ -51,11 +98,5 @@ der die Familie gesehen hat (Dennis, 2026-08-19):
   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ü
+im Terminal — der eine Befehl, der beides ablegt, den Skill **und** die fünf `/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/k3kontext.md

@@ -0,0 +1,89 @@
+---
+description: Die offenen Fragen über deine Firma im Gespräch beantworten
+---
+
+<!-- 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. -->
+# Firmenkontext ausfüllen
+
+## 1. Zuerst die Regeln lesen
+
+Lies **`~/.claude/skills/kimal3/SKILL.md`**, „Firmenkontext aktuell halten" und „Den
+Firmenkontext ausfüllen — der Ablauf". Diese Datei wiederholt die Regeln bewusst nicht —
+sonst gäbe es zwei Wahrheiten, die auseinanderlaufen.
+
+## 2. Nachsehen, was offen ist
+
+```
+kimal3 kontext fragen
+```
+
+Er liest nur und braucht weder Netz noch Anmeldung. **Nichts offen?** Sag das in einem Satz und
+hör auf.
+
+🔴 **Die Zeile `Arbeitsplatz: …` ist die wichtigste der ganzen Ausgabe — die Pfade darunter
+zählen ab dort, nicht ab deinem Arbeitsverzeichnis.** Der Normalfall ist, dass beides
+auseinanderfällt: `arbeitsplatz neu` rät ausdrücklich, in die **Werkbank** zu wechseln und dort
+Claude zu starten; die Dateien liegen dann eine Ebene höher. **Setz jeden Pfad an den genannten
+Arbeitsplatz an, bevor du schreibst.**
+⚠️ Wer das übergeht, legt eine **neue** Datei am falschen Ort an. `kimal3 kontext hoch` liest
+weiter die echten Dateien und schickt leere Antworten hoch — beide Seiten melden Erfolg, und die
+Arbeit ist trotzdem weg.
+
+**Kein Arbeitsplatz gefunden?** Die Meldung heißt „ich habe von hier aufwärts keinen gefunden" —
+**nicht** „es gibt keinen". Frag erst: *Hast du schon einen KI-Arbeitsplatz-Ordner?* Ja → dorthin
+wechseln und noch einmal. Nein → `kimal3 arbeitsplatz neu`. ⚠️ Wer hier falsch rät, legt einen
+zweiten, leeren Arbeitsplatz an.
+
+## 3. Die Fragen stellen — eine nach der anderen
+
+🔴 **Eine Frage, die Antwort abwarten, dann die nächste.** Kein Fragebogen am Stück.
+🔑 Es sind Fragen über die Firma eines Menschen — wer sie alle auf einmal bekommt,
+beantwortet keine davon gut. Genau deshalb ist das ein Gespräch und kein Formular.
+
+Schreib die Antwort in die Datei, die `kimal3 kontext fragen` genannt hat, unter ihre
+`## `-Überschrift. Die `>`-Hinweiszeilen gehören uns: **stehen lassen, darunter schreiben.**
+
+🔴 **Nichts erfinden**, auch nichts vorschlagen, was wie eine Antwort aussieht. Weiß der Mensch
+etwas nicht, **bleibt die Frage offen** und ist beim nächsten Mal wieder da.
+
+⚠️ **Ein Abbruch mittendrin ist kein Sonderfall:** Die gegebenen Antworten stehen schon in den
+Dateien, beim nächsten `/k3kontext` sind einfach weniger offen. **Verwalte keinen
+Zwischenstand** — die Dateien *sind* der Stand.
+
+## 4. Hochschicken — erst zeigen, dann fragen
+
+Zeig dem Menschen, **was an die Firma geht**, und warte auf sein ausdrückliches Ja. Erst dann:
+
+```
+kimal3 kontext hoch
+```
+
+🔑 Die fünf Dateien gehören der **Firma** — alle Kolleginnen und Kollegen bekommen sie beim
+nächsten `kimal3 kontext runter` zu sehen.
+⚠️ `kimal3 kontext hoch --ueberschreiben` **nur auf ausdrücklichen Wunsch**: Es verwirft, was
+inzwischen jemand anderes an der Firma geändert hat.
+
+## 5. Wenn es nicht klappt
+
+🔴 **Bei `kontext hoch` sagt die Zahl `1` allein GAR NICHTS — lies die Meldung.** Sie ist der
+Sammelausgang für mindestens sechs verschiedene Lagen, und sie verlangen Gegensätzliches:
+
+| Was in der Meldung steht | Was es heißt |
+|---|---|
+| „Den Firmenkontext pflegt der Firmen-Admin." | An der Rolle ändert ein zweiter Versuch nichts. Nenn den Admin — lief vorher `kimal3 kontext runter`, steht sein Name in dessen Ausgabe. |
+| „Hier steht kein KI-Arbeitsplatz" | **Nicht** `arbeitsplatz neu` raten! Siehe Abschnitt 2 — der Ordner existiert meist, nur steht der Mensch woanders. |
+| „Der Kontext wurde inzwischen … geändert" | Der Ausweg steht in derselben Meldung: `--ueberschreiben`. Schlag ihn nur vor, wenn der Mensch die fremde Änderung wirklich verwerfen will — sie ist die Arbeit eines Kollegen. |
+| mehrere Firmen / mehrdeutig | Der Ausweg heißt `--firma "…"`. **Du wählst nicht** — leg die Liste vor. |
+| eine Datei ist nicht lesbar oder trägt keine Fragen mehr | `kimal3 kontext runter` holt sie zurück. |
+| **„Du gehörst keiner Firma an."** | 🔴 **Schick ihn NICHT zu einem Admin — es gibt keinen.** Das trifft ausgerechnet den frischen Pro-Käufer: Er bekommt seinen Arbeitsplatz mit allen Fragen offen, beantwortet sie brav, und hier ist niemand, an den sie gehen könnten. Sag ihm, dass seine Antworten **in seinen Dateien stehen und dort bleiben**, und dass sie hochgehen, sobald es eine Firma gibt. Nichts geht verloren. |
+| **„Die Firma hat deine Änderungen gespeichert — nur der lokale Merkzettel …"** | 🔴 **Das ist ein ERFOLG.** Alles ist oben angekommen; nur eine Datei auf der Platte ließ sich nicht schreiben. Sag genau das — **niemals** „das hat nicht geklappt". |
+
+⚠️ **Warum das hier so ausführlich steht:** Die letzte Zeile ist der teuerste Fall. Wer die `1`
+als „kein Admin" deutet, sagt einem Menschen, der gerade alle Fragen beantwortet und
+erfolgreich hochgeschickt hat, er solle sich an seinen Admin wenden. *Ein Erfolg, als Absage
+vorgelesen.*
+
+**Rückgabewert `4`**: angemeldet, aber kein Pro-Zugang — die Meldung zeigen, den Befehl **nicht**
+wiederholen. Alles Übrige deutest du nach `SKILL.md`, Abschnitt „Rückgabewerte".