kimal3 0.1.6 → 0.2.0

package/skill/SKILL.md

@@ -66,21 +66,78 @@ 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
+   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.
+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.**
+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.
+
+🔴 **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.
+
+⚠️ **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 +243,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