kimal3 0.2.0 → 0.2.2

package/skill/SKILL.md

@@ -13,6 +13,41 @@ description: Projekte ins kimal3-Erfolgsprofil eintragen oder auflisten, Firmend
 Sobald der Mensch sagt, ein Projekt sei fertig, oder ausdrücklich bittet, es einzutragen.
 **Oder** wenn er seinen KI-Arbeitsplatz anlegen will — dann s. „Den Arbeitsplatz anlegen".
 
+## 🔴 Mehrere Firmen: DU WÄHLST NICHT
+
+Gilt für **jeden** Befehl, der eine Firma braucht: `arbeitsplatz neu` · `werkbank neu` ·
+`kontext runter` · `kontext hoch` · `firma daten`.
+
+Gehört der Mensch zu mehreren Firmen, **bricht der Befehl ab** und nennt seine Firmen als
+fertige Zeilen zum Kopieren. Das ist keine Störung, sondern **die Rückfrage — und sie ist an
+den Menschen gerichtet, nicht an dich.**
+
+🔴 **Bricht ein Befehl mit mehreren Firmen ab, WÄHLST DU NICHT** — du legst dem Menschen die
+Zeilen 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.*
+
+⚠️ **Wiederhole den Befehl aber auch nicht unverändert.** Ohne `--firma` kommt dieselbe
+Rückfrage noch einmal, und der Mensch sieht zweimal dasselbe, ohne je gefragt worden zu sein.
+Die Reihenfolge ist: **fragen → seine Antwort abwarten → die Zeile nehmen, die er genannt hat.**
+
+⚠️ **Diese Regel steht hier oben, weil sie schon ZWEIMAL an einer einzelnen Stelle verloren
+ging** — beide Male durch einen Satz, der gegen etwas ganz anderes gemeint war:
+
+| Stand bis | Wo | War gemeint gegen | Wurde gelesen als |
+|---|---|---|---|
+| 2026-08-18 | `firma daten` | „nicht raten" | „such dir einen aus" |
+| 2026-09-02 | `arbeitsplatz neu` | „keine Wiederholungsschleife" | „nimm eine der Zeilen" |
+
+Beide übersahen dasselbe: **Auswählen fühlt sich anders an als Raten, hat aber dasselbe
+Ergebnis.** Der erste wurde 2026-08-18 repariert, der zweite blieb weitere zwei Wochen stehen —
+*wer einen Fehler behebt, sucht danach nicht mehr nach ihm.* Deshalb steht die Regel jetzt
+**einmal**, statt bei jedem Befehl neu formuliert zu werden.
+📌 Den ersten fand Dennis im Live-Durchlauf; der zweite fiel beim Nachmessen einer Spec auf, bei
+`kontext runter`/`kontext hoch` fehlte die Regel bis dahin ganz.
+
+📌 **Was jeweils auf dem Spiel steht**, ist bei den Befehlen verschieden und steht dort.
+
 ## Den Arbeitsplatz anlegen (`kimal3 arbeitsplatz neu` · `kimal3 werkbank neu`)
 
 **Wann:** Der Mensch will „seinen KI-Arbeitsplatz", „den Ordner", „die Struktur" — oder ist
@@ -43,6 +78,25 @@ 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.
+
+🔴 **→ Es gilt „Mehrere Firmen: DU WÄHLST NICHT" ganz oben: Leg dem Menschen die Zeilen vor und
+frag ihn, welche Firma.** Was hier auf dem Spiel steht: Der Ordner trägt den Namen der Firma
+**und nimmt ihr Firmenwissen auf**. Wer selbst auswählt, legt einem Menschen das Wissen einer
+Firma auf die Platte, nach der er nicht gefragt hat — und er merkt es nicht, weil auf seinem
+Bildschirm nur „✓ angelegt" steht.
+
 ⚠️ **`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
@@ -106,10 +160,19 @@ Stelle.
    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
-   Liste mit siebzehn Punkten und kein Fragebogen am Stück — es sind Fragen über die Firma
-   eines Menschen, und die beantwortet er nicht in einem Rutsch.
+   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.**
 
@@ -124,12 +187,31 @@ darüberkopiert wurde —, bricht `kontext hoch` ab und schickt gar nichts, auch
 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.
 
-🔴 **Die eine Regel, die du sonst falsch machst: Rückgabewert `1` bei `kontext hoch` heißt „du
-bist kein Admin dieser Firma" — nicht „noch einmal versuchen".** Das ist eine andere `1` als die
-üblichen Eingabefehler weiter unten. Ein zweiter Versuch ändert nichts, weil sich an der Rolle
-nichts ändert. **Sag dem Menschen, dass er kein Admin ist, und nenne, an wen er sich wendet** —
-lief vorher `kontext runter`, kennt dessen Ausgabe den Admin-Namen bereits; sonst frag, wer in
-der Firma Admin ist.
+🔴 **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.
+
+🔴 **Nennt die Meldung `--firma` als Ausweg, gilt „Mehrere Firmen: DU WÄHLST NICHT" ganz oben:
+frag den Menschen, welche Firma — wähl nicht selbst.** Was hier auf dem Spiel steht, ist bei
+den beiden Befehlen verschieden und in beide Richtungen unangenehm: `kontext runter` schreibt
+das Wissen der gewählten Firma **auf seine Platte**, `kontext hoch` schickt seine Texte **in
+die gewählte Firma** — dort sehen sie alle Kolleginnen und Kollegen. *Eine falsche Wahl ist
+hier keine falsche Anzeige, sondern eine Datei am falschen Ort.*
 
 ⚠️ **Beide Befehle brauchen wie `werkbank neu` ein eigenes Pro-Konto** — ohne das kommt
 Rückgabewert `4`, dann **nicht wiederholen**.
@@ -176,15 +258,9 @@ Liefert die Firmendaten als JSON: Kennzahlen, Menschen, Projekte. **Nur auf ausd
 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.)
+🔴 **→ Es gilt „Mehrere Firmen: DU WÄHLST NICHT" ganz oben.** Was hier auf dem Spiel steht: Wer
+selbst auswählt, zeigt einem Menschen die personenbezogenen Daten einer ganzen Belegschaft,
+nach der er nicht gefragt hat.
 
 **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

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".