kimal3 0.2.7 → 0.2.9

package/dist/befehle/kontext-hoch.js

@@ -4,6 +4,7 @@ import { FIRMEN_TEXTE, alsMerkzettel, bekannterStandAus, merkzettelNachHoch, } f
 import { traegtFragenVon } from "../fragen-lesen.js";
 import { leseEineDatei, leseMerkzettelDatei, schreibeMerkzettelDatei } from "../kontext-dateien.js";
 import { ERLAUBT, absage, arbeitsplatzOderAbsage, fremdeDateiAbsage } from "./kontext-gemeinsam.js";
+import { hochZeile } from "../kontext-hoch-zeile.js";
 /*
   🪦 **Hier stand `feldSchluessel`, gestrichen mit Ruling K-6 (Task 7).**
 
@@ -185,7 +186,7 @@ export async function kontextHoch(argv) {
       was daneben schiefging. Was hochgeschickt wurde, haengt nicht daran, ob ein
       Merkzettel auf der Platte landet.
     */
-    console.log(`✓ hochgeschickt: ${ergebnis.uebernommen.join(", ")}`);
+    console.log(hochZeile(ergebnis.uebernommen));
     const merkzettelSchreiben = schreibeMerkzettelDatei(ordner, zuSchreiben);
     if (!merkzettelSchreiben.ok) {
         /*
@@ -210,10 +211,17 @@ export async function kontextHoch(argv) {
         */
         console.error("Die Firma hat deine Änderungen gespeichert — nur der lokale Merkzettel ließ sich nicht schreiben:");
         console.error(merkzettelSchreiben.meldung);
-        return 1;
+        // B-d (Dennis, 17.09.): Das ist ein ERFOLG -- die Firma hat gespeichert.
+        // Der Rueckgabewert ist fuer Maschinen da, und fuer die ist "gespeichert"
+        // die Wahrheit; die Warnung steht auf stderr fuer den Menschen. Bis 0.2.7
+        // stand hier `1`, und zwei Anleitungen fuehrten eine Tabelle, nur um diese
+        // Zahl zu uebersetzen.
+        return 0;
     }
-    // US-3: WAS hochgeladen wurde, nicht nur "fertig" -- die Zeile steht seit
-    // Runde 4 oben, vor der Merkzettel-Pruefung (Begruendung dort).
+    // US-3: WAS sich bei der Firma geaendert hat, nicht nur "fertig" -- die
+    // Zeile steht seit Runde 4 oben, vor der Merkzettel-Pruefung (Begruendung
+    // dort). Seit Task 7 (B-e) kommt der Satz aus `hochZeile` und nennt nur
+    // die WIRKLICH geaenderten Dateien -- oder "nichts geaendert".
     //
     // 🔑 Der Erklaersatz darunter ist mit Fund F ersatzlos WEGGEFALLEN. Er
     // benannte eine Ausnahme, die es nicht mehr gibt -- fuenf Texte, zwei

package/dist/befehle/projekt-neu.js

@@ -2,11 +2,16 @@ import { feld, ruf } from "../api.js";
 import { schlussFehler } from "../fehler.js";
 import { BASIS_URL } from "../anmeldung.js";
 import { zerlege } from "../argumente.js";
+import { absage } from "./kontext-gemeinsam.js";
+import { befehlszeileOhneFirma, firmenKoerperAus, ohneFirmaAusArgv } from "../projekt-neu-firma.js";
 const OPTIONEN = [
     "titel", "beschreibung", "symbol", "stunden", "ergebnis", "umsatz",
-    "wirkung", "wirkung-label", "link", "live-seit",
+    "wirkung", "wirkung-label", "link", "live-seit", "firma", "firma-id",
 ];
-const HILFE = `
+// exportiert, damit `check:cli` die HILFE als AUSGABE-Text prueft (§24
+// erlaubt das: nicht die Anleitung, die den Text beschreibt, sondern der
+// Text, der wirklich auf dem Bildschirm des Kunden landet).
+export const HILFE = `
   kimal3 projekt neu --titel "Angebots-Generator" [Optionen]
 
     --titel          Pflicht. 2–80 Zeichen.
@@ -19,6 +24,9 @@ const HILFE = `
     --wirkung-label  Wozu, bis 40 Zeichen, z. B. "Angebotszeit".
     --link           Vollstaendige Adresse mit http:// oder https://.
     --live-seit      Datum als JJJJ-MM-TT.
+    --firma "Name"   Wenn du zu mehreren Firmen gehoerst: welche das Projekt bekommt.
+    --firma-id "…"   Falls zwei deiner Firmen gleich heissen.
+    --ohne-firma     Das Projekt gehoert keiner Firma (steht nur auf deinem Profil).
 `;
 export async function projektNeu(argv) {
     // ⚠️ VOR dem Zerlegen abfragen, nicht danach.
@@ -30,7 +38,12 @@ export async function projektNeu(argv) {
         console.log(HILFE);
         return 0;
     }
-    const z = zerlege(argv, OPTIONEN);
+    // ⚠️ `zerlege` kennt keine Optionen ohne Wert -- `--ohne-firma` wird
+    // deshalb VOR der Zerlegung herausgefiltert, genau wie `--ueberschreiben`
+    // in kontext-hoch.ts. Die Rechnung dahinter steht in projekt-neu-firma.ts,
+    // damit `check:cli` sie pruefen kann (Final-Review F-1).
+    const { rest, ohneFirma } = ohneFirmaAusArgv(argv);
+    const z = zerlege(rest, OPTIONEN);
     if (!z.ok) {
         console.error(z.meldung);
         return 1;
@@ -40,6 +53,15 @@ export async function projektNeu(argv) {
         console.error("Es fehlt --titel.\n" + HILFE);
         return 1;
     }
+    // 🔴 Final-Review F-3: `--ohne-firma` zusammen mit `--firma`/`--firma-id`
+    // liesse die Route den Schalter still gewinnen lassen (`firmenWunschAus` in
+    // route.ts prueft `ohne_firma` zuerst). Hier abweisen, bevor der Wunsch
+    // ueberhaupt losgeschickt wird.
+    const wunsch = firmenKoerperAus(o.firma, o["firma-id"], ohneFirma);
+    if (!wunsch.ok) {
+        console.error(wunsch.meldung);
+        return 1;
+    }
     const antwort = await ruf("/api/cli/projekt", {
         mitAusweis: true,
         koerper: {
@@ -48,6 +70,7 @@ export async function projektNeu(argv) {
             zeitersparnis_std_wo: o.stunden ?? "", ergebnis_monat_eur: o.ergebnis ?? "",
             umsatz_monat_eur: o.umsatz ?? "", link_url: o.link ?? "",
             live_seit: o["live-seit"] ?? "",
+            ...wunsch.koerper,
         },
     });
     if (antwort.status === 201) {
@@ -73,6 +96,13 @@ export async function projektNeu(argv) {
         console.error(`${meldung} Leg es hier an: ${BASIS_URL}/profil`);
         return 1;
     }
+    if (antwort.status === 409) {
+        // Firmen-Absage in der Form von arbeitsplatz/kontext: `absage` druckt die
+        // Meldung und die Firmen als fertige Befehle. Der Befehl in der Zeile
+        // traegt ALLE getippten Optionen mit, nicht nur --titel (Final-Review
+        // F-2) -- sonst verliert der Kunde beim Kopieren --stunden, --ergebnis &co.
+        return absage(antwort, `projekt neu ${befehlszeileOhneFirma(o)}`);
+    }
     // ⚠️ Hier landet auch die `503` "Konto gerade nicht prüfbar" — und sie MUSS
     // hier landen, nicht oben bei der 402. Rueckgabewert 3 heisst "nochmal
     // versuchen kann helfen"; 4 heisst laut SKILL.md ausdruecklich "nicht

package/dist/befehle/wache.js

@@ -107,9 +107,15 @@ function skillIstVeraltet() {
  */
 async function frageServer(schluessel, heute) {
     try {
+        // 🔴 Die Version reist mit, wie bei jedem anderen Befehl (`api.ts`). Bis
+        // 0.2.7 fehlte sie hier -- und der Server konnte nicht wissen, dass diese
+        // Fassung einen Update-Hinweis ohnehin verwirft; der belegte dann den
+        // einen Platz der Antwort, und ein Angebot kam ueber die Wache nie an
+        // (live gemessen 17.09.). Faellt die Version aus, geht der Kopf nicht mit.
+        const version = eigeneVersion();
         const antwort = await fetch(`${BASIS_URL}/api/cli/wache`, {
             method: "POST",
-            headers: { Authorization: `Bearer ${schluessel}` },
+            headers: { Authorization: `Bearer ${schluessel}`, ...(version ? { "X-Kimal3-Version": version } : {}) },
             signal: AbortSignal.timeout(ZEITGRENZE_MS),
         });
         const koerper = await antwort.json().catch(() => null);

package/dist/kimal3.js

@@ -390,8 +390,34 @@ function endeMitHinweis(code) {
     
           🔑 DIE NOTBREMSE BLEIBT, und sie ist die einzige Stelle, die noch hart
           beendet: Sie ist `unref`t, haelt die Schleife also nicht am Leben, und
-          feuert nur, wenn ein Kanal wirklich haengt. Nach zwei Sekunden ist die
-          Verbindung von draussen ohnehin zu -- der Absturz droht dort nicht.
+          feuert nur, wenn ein Kanal wirklich haengt.
+    
+          🔬 WARUM ZWEI SEKUNDEN -- gemessen statt behauptet (2026-09-10, nach
+          Review-Runde 1 am PR #31). Hier stand als Begruendung: "nach zwei
+          Sekunden ist die Verbindung von draussen ohnehin zu". Das war die
+          einzige ungemessene Zahl im ganzen Umbau, und der Review vermutete
+          genau darin die Gefahr -- die Notbremse koenne ausgerechnet in dem
+          Augenblick zuschlagen, gegen den dieser Fix gebaut ist.
+          Nachgemessen (echte Netzanfrage, danach hartes Beenden nach N ms, je
+          20 Laeufe, Node 24):
+                0 ms .... 20 von 20 Abstuerzen
+                1 ms .... 17 von 20
+                5 ms .... 14 von 20
+               10 ms ..... 7 von 20
+               25 ms ..... 0 von 20
+               50 ms ..... 0 von 20
+            2 000 ms ..... 0 von 20
+            5 000 ms ..... 0 von 20
+          Das gefaehrliche Fenster ist also rund 25 Millisekunden breit, nicht
+          Sekunden -- die zwei Sekunden liegen achtzigfach dahinter. Der Verdacht
+          des Reviews ist damit widerlegt, und Erhoehen wuerde nichts kaufen: Es
+          wuerde nur den einzigen Fall verlangsamen, in dem die Notbremse
+          ueberhaupt zaehlt (ein Kanal, der wirklich haengt).
+          ⚠️ Gemessen auf Node 24; ausgeliefert wird ab Node 20 (cli/package.json).
+          Auf Node 20 ist es NICHT nachgemessen -- auf diesem Rechner steht keine
+          solche Fassung. Was dagegen spricht, dass es dort anders liegt: Der
+          Abbruch haengt an einem Kanal, der gerade zugeht, und das ist eine Sache
+          von Millisekunden, nicht von Sekunden.
         */
         setTimeout(() => process.exit(code), 2000).unref();
         process.stdout.write("", () => {
@@ -524,8 +550,16 @@ haupt()
     // Kommentar an `endeMitHinweis` verbietet, denn auf Windows sind beide
     // Ausgabekanaele asynchron und `process.exit()` wirft Ausstehendes weg.
     // Ausgerechnet die Fehlermeldung waere das Erste, was verlorengeht.
-    // Beide Faelle entstehen NACH einer Netzanfrage, also drohte hier zusaetzlich
-    // derselbe Absturz wie in `endeMitHinweis` (D-18).
+    // ⚠️ Die beiden Faelle liegen dabei VERSCHIEDEN, und das stand hier bis zur
+    // dritten Review-Runde falsch ("beide entstehen nach einer Netzanfrage"):
+    // `NichtAngemeldet` wird in cli/src/api.ts:117 geworfen, BEVOR die Anfrage
+    // ueberhaupt hinausgeht (der `fetch` steht dort erst in Zeile 171) -- dort
+    // drohte der Absturz aus D-18 also nie. Nur die zweite Meldung ("nicht
+    // erreichbar") kommt nach einer Netzanfrage, und nur fuer sie galt das.
+    // 🔑 Fuer BEIDE gilt dagegen der Grund darueber: Auf Windows sind die
+    // Ausgabekanaele asynchron, und ein hartes Beenden wirft Ausstehendes weg.
+    // *Ein Kommentar, der eine richtige Aenderung halb falsch begruendet, ist
+    // gefaehrlicher als keiner -- der naechste Leser rechnet nicht nach.*
     // 🔑 `exitCode` statt `exit`: Die Zahl stimmt, die Meldung kommt an, und
     // Node laeuft aus, sobald die Kanaele leer sind.
     .catch((f) => {

package/dist/kontext-hoch-zeile.js

@@ -0,0 +1,11 @@
+/**
+ * Die Erfolgszeile von `kimal3 kontext hoch` -- als reine Rechnung, damit
+ * `check:cli` sie prueft. Sie nennt, was sich BEI DER FIRMA geaendert hat,
+ * nicht, was gesendet wurde (B-e, 29.08.: fuenf Dateien genannt, zwei
+ * geaendert, eine davon ohne Zutun des Menschen).
+ */
+export function hochZeile(uebernommen) {
+    if (uebernommen.length === 0)
+        return "✓ nichts geändert — alles war schon so";
+    return `✓ geändert bei der Firma: ${uebernommen.join(", ")}`;
+}

package/dist/projekt-neu-firma.js

@@ -0,0 +1,74 @@
+import { alsBefehlszeile } from "./argumente.js";
+/**
+ * Der Firmenwunsch bei `projekt neu` -- herausgeloest aus `befehle/projekt-neu.ts`,
+ * damit `check:cli` ihn als reine Rechnung pruefen kann (Final-Review F-1).
+ *
+ * 🔴 **Vorher stand hier keine Rechnung, sondern zwei Zeilen QUELLTEXT-Pruefung**
+ * in `check-cli.mts` (`quelle.includes(...)`, ein Regex auf `argv.filter(...)`).
+ * Die wurden rot, wenn jemand die Lambda-Variable umbenannte, und blieben gruen,
+ * wenn die CLI aufhoerte, `ohne_firma` zu senden -- genau das Fehlerbild aus
+ * `docs/regeln/messen-und-pruefen.md`, Abschnitt 24: Eine Wache, die Text gegen
+ * Text haelt, bewacht die Formulierung, nicht das Verhalten.
+ *
+ * Zwei Schritte, weil `--ohne-firma` ein Schalter OHNE Wert ist und `zerlege`
+ * das nicht kennt (Begruendung in argumente.ts) -- er muss deshalb VOR dem
+ * Zerlegen raus. `--firma`/`--firma-id` sind normale Optionen mit Wert und
+ * liegen erst NACH dem Zerlegen vor.
+ */
+/**
+ * Schritt 1, vor `zerlege`: `--ohne-firma` aus der Befehlszeile herausfiltern.
+ * Das ist die Rechnung, die vorher nur als Regex auf ihren eigenen Quelltext
+ * gewacht wurde.
+ */
+export function ohneFirmaAusArgv(argv) {
+    return {
+        rest: argv.filter((a) => a !== "--ohne-firma"),
+        ohneFirma: argv.includes("--ohne-firma"),
+    };
+}
+/**
+ * Schritt 2, nach `zerlege`: aus Firmenname, Firmen-ID und dem Schalter den
+ * Rumpf fuer `/api/cli/projekt` bauen -- oder abweisen (Final-Review F-3).
+ *
+ * 🔴 **Die Route (`firmenWunschAus` in `src/app/api/cli/projekt/route.ts`)
+ * laesst `ohne_firma` GEWINNEN, wenn beides genannt wird** -- `--firma` wird
+ * dort still ignoriert, ohne dass die Firma je zu Wort kommt. Statt die Route
+ * anzufassen (0.2.7-Vertrag, ein `git push` macht sie fuer ALLE sofort neu,
+ * s. CLAUDE.md "Einer CLI-Route eine neue Rueckfrage beibringen"), weist die
+ * CLI die widerspruechliche Eingabe VORHER ab -- wie beim fehlenden `--titel`
+ * daneben.
+ */
+export function firmenKoerperAus(firma, firmaId, ohneFirma) {
+    if (ohneFirma && (firma || firmaId)) {
+        return {
+            ok: false,
+            meldung: 'Entweder --ohne-firma ODER --firma/--firma-id -- nenn nur eines von beiden.',
+        };
+    }
+    return { ok: true, koerper: { firma: firma ?? "", firma_id: firmaId ?? "", ohne_firma: ohneFirma } };
+}
+/**
+ * Die kopierfertige Zeile fuer die Firmen-Absage (`absage` in
+ * `kontext-gemeinsam.ts`) -- ALLE getippten Optionen, nicht nur `--titel`
+ * (Final-Review F-2).
+ *
+ * 🔴 **Vorher fiel jede weitere Option unter den Tisch:** `absage` bekam
+ * immer nur `alsBefehlszeile(["--titel", o.titel])`. Wer `projekt neu --titel
+ * X --stunden 5 --ergebnis 1200` tippte und die 409-Absage bekam, sah einen
+ * Kopierbefehl, der `--stunden` und `--ergebnis` verschluckte -- beim Kopieren
+ * landete ein Projekt ohne Zeitersparnis und ohne Ergebnis.
+ *
+ * `--firma`/`--firma-id` fliegen hier raus, weil `absage` selbst genau diese
+ * Option anhaengt (`kimal3 ${befehl} --firma …`); `--ohne-firma` kommt nie in
+ * `o` an (s. `ohneFirmaAusArgv` oben) und braucht deshalb keinen eigenen
+ * Ausschluss.
+ */
+export function befehlszeileOhneFirma(o) {
+    const teile = [];
+    for (const [name, wert] of Object.entries(o)) {
+        if (name === "firma" || name === "firma-id")
+            continue;
+        teile.push(`--${name}`, wert);
+    }
+    return alsBefehlszeile(teile);
+}

package/package.json

@@ -1,27 +1,27 @@
-{
-  "name": "kimal3",
-  "version": "0.2.7",
-  "description": "Trag deine KI-Projekte dort ein, wo sie entstehen: im Terminal.",
-  "type": "module",
-  "bin": {
-    "kimal3": "dist/kimal3.js"
-  },
-  "files": [
-    "dist",
-    "skill",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=20"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "kimal3",
-    "cli"
-  ],
-  "homepage": "https://app.kimal3.de/pro",
-  "license": "SEE LICENSE IN README.md"
-}
+{
+  "name": "kimal3",
+  "version": "0.2.9",
+  "description": "Trag deine KI-Projekte dort ein, wo sie entstehen: im Terminal.",
+  "type": "module",
+  "bin": {
+    "kimal3": "dist/kimal3.js"
+  },
+  "files": [
+    "dist",
+    "skill",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "kimal3",
+    "cli"
+  ],
+  "homepage": "https://app.kimal3.de/pro",
+  "license": "SEE LICENSE IN README.md"
+}

package/skill/SKILL.md

@@ -192,6 +192,17 @@ Stelle.
 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.**
 
+   🔴 **Schreib die Antwort so, dass man sie als Rohtext lesen kann:**
+   - **Eine Zeile nie mitten im Satz umbrechen** — auch nicht, wenn sie lang wird. Ein Absatz
+     ist eine Zeile. Die `>`-Hinweise darüber sind umbrochen; **ahm sie nicht nach.**
+   - **Kein `**fett**`, keine Überschriften, keine Tabellen.**
+   - Mehrere Aussagen werden am besten eine Liste, jede Zeile beginnt mit `- `.
+
+   🔑 **Warum:** In der App (**Firma → Kontext**) steht jede Antwort in einem Eingabefeld, das
+   den Text zeigt, wie er in der Datei steht. Ein Umbruch nach ~100 Zeichen reißt dort den Satz
+   mitten durch, und `**fett**` erscheint als Sternchen — bei jeder Kollegin, die dort liest oder
+   weiterschreibt. *Aufgefallen am 25.09.2026 an unseren eigenen Antworten.*
+
    🔴 **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
@@ -222,11 +233,10 @@ auf dieser einen Zahl (`cli/src/befehle/kontext-hoch.ts`): unbekannte Option ·
 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.*
+🔴 **Ein Fall in `kontext-hoch.ts` (Merkzettel-Zweig) sieht wie ein Fehler aus und ist ein ERFOLG:**
+*„Die Firma hat deine Änderungen gespeichert — nur der lokale Merkzettel ließ sich nicht schreiben."*
+Ab 0.2.8 gibt dieser Fall **0** zurück — er ist ein Erfolg. Die Warnung auf `stderr` sagt, dass
+nur der lokale Merkzettel fehlt; beim nächsten `kontext runter` fällt das ohnehin auf.
 
 **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
@@ -251,7 +261,9 @@ jemand anderem geändert wurde. **Nur auf ausdrücklichen Wunsch einsetzen** —
 `kimal3 projekt liste` — steht es schon da, **nicht** noch einmal eintragen.
 
 ## Eintragen
-`kimal3 projekt neu --titel "…" [--stunden 6] [--ergebnis 1200] [--symbol bot]`
+`kimal3 projekt neu --titel "…" [--stunden 6] [--ergebnis 1200] [--symbol bot] [--firma "Name" | --ohne-firma]`
+Wer zu genau einer Firma gehört, braucht `--firma` nicht — das Projekt gehört ihr. Bei zwei
+Firmen nennt die Absage beide als fertige Befehle.
 Alle Optionen: `kimal3 projekt neu --help`
 
 ## 🔑 Zahlen nie erfinden

package/skill/commands/k3feierabend.md

@@ -1,43 +1,97 @@
----
-description: Sitzung sauber beenden — Stand sichern, aufräumen, zusammenfassen
----
-
-<!-- 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. -->
-# Feierabend
-
-> Sauberer Sitzungs-Abschluss: Stand sichern, aufräumen, zusammenfassen — damit der nächste
-> Start (in diesem oder einem anderen Projekt) sauber weitergeht.
-
-Führe die Schritte der Reihe nach aus. Bleib im Coaching-Ton: erklär kurz, was du tust, und hol
-dir **vor dem Veröffentlichen (Push)** ein OK. Ist ein Schritt hier nicht relevant, sag das kurz
-und überspring ihn — kein Leerlauf.
-
-## 1. Stand sichten
-- Ist es ein Git-Repo? Dann `git status` + `git diff --stat`: Was wurde in dieser Sitzung
-  geändert? Fass es in 1–2 Sätzen zusammen.
-- Kein Git-Repo? Sag das kurz und biete an, eins einzurichten (Sicherheitsnetz) — erzwing nichts.
-
-## 2. Lebende Dokumente nachziehen
-- **Status-/Übergabe-Doc:** Gibt es eine `WEITER-HIER.md` (oder `ROADMAP.md`)? Aktualisiere
-  „aktueller Stand" + „nächster Schritt" auf das, was heute passiert ist. Sag laut, was du
-  geändert hast. Gibt es keins und die Arbeit wächst über eine Sitzung hinaus: eins vorschlagen.
-- **Coach aktuell halten:** Prüf kurz, ob die `CLAUDE.md` (global oder Projekt) an eine neue
-  Arbeitsweise angepasst gehört — **nur bei echtem Anlass**, nicht als Pflichtübung.
-
-## 3. Aufräumen (leichtgewichtig)
-- Offensichtlichen Müll entfernen (`.DS_Store`, `*.tmp`, `*.log`, `__pycache__`).
-- Bei allem Unklaren: **nicht** löschen — auflisten und mich fragen.
-
-## 4. Sichern (mit meinem OK)
-- Stage die relevanten Änderungen — **niemals** Secrets oder `.env*`.
-- Zeig mir kurz, was in den Commit geht, und schlag eine Commit-Nachricht vor.
-- Nach meinem OK: committen. Dann **frag, ob du pushen sollst** (der Schritt „nach außen").
-  Erst nach meiner Bestätigung `git push`.
-
-## 5. Zusammenfassen & Abschied
-- 2–3 Sätze **ohne Fachjargon**: Was haben wir heute geschafft, was habe ich gelernt.
-- **Ein** konkreter, kleiner nächster Schritt fürs nächste Mal (der Cliffhanger — klein halten).
-- Kurzer, freundlicher Abschied wie ein guter Kollege, der Feierabend macht. Warte auf meine
-  Antwort, bevor die Sitzung endet.
+---
+description: Sitzung sauber beenden — Stand sichern, aufräumen, zusammenfassen
+---
+
+<!-- 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. -->
+# Feierabend
+
+> Sauberer Sitzungs-Abschluss: Stand sichern, aufräumen, zusammenfassen — damit der nächste
+> Start (in diesem oder einem anderen Projekt) sauber weitergeht.
+
+Führe die Schritte der Reihe nach aus. Bleib im Coaching-Ton: erklär kurz, was du tust, und hol
+dir **vor dem Veröffentlichen (Push)** ein OK. Ist ein Schritt hier nicht relevant, sag das kurz
+und überspring ihn — kein Leerlauf.
+
+## 1. Stand sichten
+- Ist es ein Git-Repo? Dann `git status` + `git diff --stat`: Was wurde in dieser Sitzung
+  geändert? Fass es in 1–2 Sätzen zusammen.
+- Kein Git-Repo? Sag das kurz und biete an, eins einzurichten (Sicherheitsnetz) — erzwing nichts.
+
+## 2. Status-Datei nachziehen — und aufräumen
+Die Status-Datei (`WEITER-HIER.md` oder `ROADMAP.md`) ist der Zettel für den nächsten Start. Sie
+taugt nur, solange man sie in einem Atemzug lesen kann. **Jeder Feierabend schreibt etwas dazu —
+also muss auch jeder Feierabend etwas wegräumen**, sonst wächst sie, bis niemand sie mehr liest.
+
+Gibt es keine Status-Datei und die Arbeit wächst über eine Sitzung hinaus: eine vorschlagen,
+dann weiter mit Schritt 3.
+
+1. **Nachziehen:** „Wo wir stehen" und „nächster Schritt" auf das setzen, was heute passiert ist.
+2. **Wegräumen, was nicht mehr gilt.** Ins Archiv wandert:
+   - was **erledigt** ist (fertige Aufgaben, abgehakte Punkte),
+   - die Geschichten **früherer Sitzungen** („Davor …", „Stand vom …") — in „Wo wir stehen" bleibt
+     nur der heutige Stand,
+   - was im Text **widerlegt oder überholt** ist.
+   Was bleibt: der aktuelle Stand, der nächste Schritt, die offenen Punkte, und je Idee für später
+   **höchstens zwei Sätze** — Ausführliches bekommt eine eigene Datei, die Status-Datei verlinkt sie.
+3. **Ins Archiv heißt: verschieben, nicht löschen.** Gibt es schon ein Archiv (steht meist im Kopf
+   der Status-Datei), dorthin; sonst `WEITER-HIER-archiv.md` daneben anlegen. Unten anhängen, mit
+   dem heutigen Datum als Überschrift, **im Wortlaut** — das Warum früherer Entscheidungen soll
+   auffindbar bleiben.
+4. **Messen statt schätzen:** Zeilen der Status-Datei **vorher und nachher zählen**. Steht in ihrem
+   Kopf eine Zielgröße, gilt die, sonst **150 Zeilen**. Liegt sie danach noch drüber, weiter
+   wegräumen — oder sag laut, warum der Rest bleiben muss. Prüf danach im Archiv nach, dass das
+   Verschobene wirklich dort steht (eine Zeile daraus suchen), bevor du es als erledigt meldest.
+5. **Sag laut, was du geändert hast:** was neu drinsteht, was ins Archiv ging, Zeilen vorher → nachher.
+
+## 3. Gelernte Regeln — gehört etwas festgehalten?
+**Nur bei echtem Anlass**, nicht als Pflichtübung. Ein Anlass ist: Ich habe dich heute korrigiert,
+eine Arbeitsweise ausdrücklich gewollt, oder dieselbe Art Frage zum dritten Mal gleich beantwortet.
+Kein Anlass? Sag das in einem Halbsatz und geh weiter.
+
+Gibt es einen, **schlag die Regel vor** — ein Satz, was du künftig anders machst, dazu Datum und
+Anlass in einem Satz — und trag sie erst nach meinem OK ein. Wohin, hängt davon ab, was sie ist:
+
+| Was ist es? | Wohin |
+|---|---|
+| **Eine Arbeitsregel** — wie du arbeiten, fragen, prüfen, erklären sollst | `~/.claude/rules/kimal3-coach.md`, **unten** im Abschnitt „Gelernte Regeln" (neueste unten) |
+| **Etwas über mich** — wer ich bin, meine Rollen, meine Werkzeuge | meine `~/.claude/CLAUDE.md` |
+| **Etwas über dieses Projekt** — Aufbau, Werkzeuge, Fallen | die `CLAUDE.md` im Projektordner |
+
+🔬 **Vorher nachsehen, ob es die Regel schon gibt** — im Coach und in den CLAUDE.md-Dateien. Steht
+sie schon da, trag sie **nicht** doppelt ein: Sag mir, wo sie steht und dass sie heute nicht
+gegriffen hat. Eine Regel, die zweimal dasteht, wird nicht besser befolgt.
+⚠️ **Gibt es `~/.claude/rules/kimal3-coach.md` nicht**, kommt auch eine Arbeitsregel in meine
+`~/.claude/CLAUDE.md`. Leg die Coach-Datei **nicht** selbst an — sie gehört kimal3.
+🔴 **Im Coach änderst du NUR den Abschnitt „Gelernte Regeln"** und schreibst nur unten dazu. Alles
+darüber ist die Vorlage von kimal3 — dort änderst du nichts.
+
+Sag danach laut, **welcher Satz in welcher Datei** steht (vollständiger Pfad). Der Ordner
+`~/.claude` ist meist kein Git-Repo — die Datei ist dann nicht über Git gesichert; sag das dazu.
+
+## 4. Projekt aufräumen (leichtgewichtig)
+- Offensichtlichen Müll entfernen (`.DS_Store`, `*.tmp`, `*.log`, `__pycache__`).
+- Bei allem Unklaren: **nicht** löschen — auflisten und mich fragen.
+
+## 5. Sichern (mit meinem OK)
+- Stage die relevanten Änderungen **Datei für Datei** — **niemals** Secrets oder `.env*`, und kein
+  `git add -A`, das fremde Arbeit mitnimmt.
+- Zeig mir kurz, was in den Commit geht — **und was bewusst draußen bleibt**: Dateien, die Git noch
+  nicht kennt und die nicht aus dieser Sitzung stammen, stehen mit Namen und einem Satz, was sie
+  sind, in derselben Liste. (Sie kommen oft aus einer anderen Sitzung und fallen sonst niemandem
+  auf.) Mein OK zum Commit gilt für die ganze Liste; will ich eine davon doch dabeihaben, sage ich es.
+- Schlag eine Commit-Nachricht vor.
+- Nach meinem OK: committen.
+- **Pushen, je nach Projekt:** Prüf mit `git remote`, ob es überhaupt ein Ziel gibt.
+  - Kein Ziel: sag das kurz — der Commit ist dann die Sicherung, fertig.
+  - Ein Ziel: **frag, ob du pushen sollst** (der Schritt „nach außen"). Steht in der
+    Projekt-`CLAUDE.md`, dass ein Push etwas auslöst (zum Beispiel die Live-Seite neu ausliefert),
+    sag das dazu. Erst nach meiner Bestätigung `git push`.
+
+## 6. Zusammenfassen & Abschied
+- 2–3 Sätze **ohne Fachjargon**: Was haben wir heute geschafft, was habe ich gelernt — und in
+  einem Satz, was aufgeräumt wurde.
+- **Ein** konkreter, kleiner nächster Schritt fürs nächste Mal (der Cliffhanger — klein halten).
+- Kurzer, freundlicher Abschied wie ein guter Kollege, der Feierabend macht. Warte auf meine
+  Antwort, bevor die Sitzung endet.

package/skill/commands/k3kontext.md

@@ -44,6 +44,8 @@ beantwortet keine davon gut. Genau deshalb ist das ein Gespräch und kein Formul
 
 Schreib die Antwort in die Datei, die `kimal3 kontext fragen` genannt hat, unter ihre
 `## `-Überschrift. Die `>`-Hinweiszeilen gehören uns: **stehen lassen, darunter schreiben.**
+**Wie die Antwort aussieht** (nie mitten im Satz umbrechen, kein Fett) steht in
+`SKILL.md`, Schritt 3 des Ablaufs — halte dich daran, sonst ist sie in der App kaum lesbar.
 
 🔴 **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.
@@ -78,12 +80,14 @@ Sammelausgang für mindestens sechs verschiedene Lagen, und sie verlangen Gegens
 | 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.*
+| **„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". (ab 0.2.8 Rückgabe 0) |
+
+⚠️ **Warum das hier so ausführlich steht:** Die letzte Zeile war bis 0.2.7 der teuerste Fall. Wer
+die `1` als „kein Admin" deutete, sagte einem Menschen, der gerade alle Fragen beantwortet und
+erfolgreich hochgeschickt hatte, er solle sich an seinen Admin wenden. *Ein Erfolg, als Absage
+vorgelesen.* Ab 0.2.8 trennt schon der Rückgabewert (`0` statt `1`) diesen Fall von einer
+echten Absage — bei einer älteren CLI gilt die alte Lesart weiter, deshalb bleibt die Meldung
+der verlässlichere Weg.
 
 **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".

package/skill/commands/k3projekt.md

@@ -32,8 +32,10 @@ $ARGUMENTS
 Pro-Bereich kopiert und unverändert abgeschickt. Dann ist **nichts** angegeben: Frag, um welches
 Projekt es geht, statt den Platzhalter als Titel zu nehmen.
 
-Bau daraus `kimal3 projekt neu --titel "…"` mit den passenden Optionen
-(`kimal3 projekt neu --help` nennt alle).
+Bau daraus `kimal3 projekt neu --titel "…" [--firma "Name" | --ohne-firma]` mit den passenden
+Optionen (`kimal3 projekt neu --help` nennt alle). Wer zu genau einer Firma gehört, braucht
+`--firma` nicht — das Projekt gehört ihr. Bei zwei Firmen nennt die Absage beide als fertige
+Befehle.
 
 🔴 **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: