kimal3 0.2.0 → 0.2.1

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