kimal3 0.4.0-durchstich.3 → 0.4.0

package/dist/befehle/kurs.js

@@ -0,0 +1,77 @@
+import { feld, ruf } from "../api.js";
+import { sprache } from "../sprache.js";
+import { ALLGEMEIN_TEXTE } from "../texte/allgemein.js";
+import { KURS_TEXTE } from "../texte/kurs.js";
+import { schlussFehler } from "../fehler.js";
+import { BASIS_URL } from "../anmeldung.js";
+const istZahl = (w) => typeof w === "number" && Number.isFinite(w);
+function schrittAus(w) {
+    if (!w || typeof w !== "object")
+        return null;
+    const s = w;
+    if (typeof s.id !== "string" || !istZahl(s.beat) || typeof s.text !== "string" || (s.wer !== "claude" && s.wer !== "mensch"))
+        return null;
+    return { id: s.id, beat: s.beat, text: s.text, wer: s.wer };
+}
+/** Die Antwort von `GET /api/cli/kurs` -- `null`, wenn sie nicht die erwartete Form hat (z. B. ein WLAN-Anmeldeportal mit `200`). */
+function standAus(koerper) {
+    if (!koerper || typeof koerper !== "object")
+        return null;
+    const k = koerper;
+    if (!Array.isArray(k.beats) || !Array.isArray(k.offen) || typeof k.abgeschlossen !== "boolean")
+        return null;
+    const beats = k.beats.map((b) => {
+        const r = b && typeof b === "object" ? b : {};
+        return istZahl(r.nummer) && istZahl(r.erledigt) && istZahl(r.gesamt) && typeof r.fertig === "boolean"
+            ? { nummer: r.nummer, erledigt: r.erledigt, gesamt: r.gesamt, fertig: r.fertig }
+            : null;
+    });
+    const offen = k.offen.map(schrittAus);
+    const naechster = k.naechster === null ? null : schrittAus(k.naechster);
+    if (beats.includes(null) || offen.includes(null) || (k.naechster !== null && !naechster))
+        return null;
+    return { beats: beats, offen: offen, naechster, abgeschlossen: k.abgeschlossen };
+}
+/** Reine Rechnung: die Zeilen, die der Mensch (und Claude) zu sehen bekommen. */
+export function kursZeilen(stand, s, basisUrl) {
+    const t = KURS_TEXTE[s];
+    const browser = t.imBrowser(basisUrl);
+    if (stand.abgeschlossen)
+        return [t.alleErledigt(stand.beats.reduce((n, b) => n + b.gesamt, 0)), browser];
+    const beats = stand.beats.map((b) => (b.fertig ? t.beatFertig(b.nummer) : t.beatTeil(b.nummer, b.erledigt, b.gesamt)));
+    const zeilen = [t.uebersicht(beats.join(" · "))];
+    if (stand.naechster)
+        zeilen.push(t.naechster(stand.naechster.text, stand.naechster.wer === "claude"));
+    // Alles Offene ausser dem, was schon als „Als Nächstes“ dasteht -- über die Kennung: Zwei offene Schritte
+    // eines Beats können denselben Text tragen, und nur der eine ist der nächste.
+    const rest = stand.offen.filter((o) => o.id !== stand.naechster?.id);
+    if (rest.length > 0) {
+        zeilen.push(t.nochOffen);
+        rest.forEach((o) => zeilen.push(t.offenZeile(o.beat, o.text, o.wer === "claude")));
+    }
+    zeilen.push(browser);
+    return zeilen;
+}
+/** Wo der Mensch im Mini-Kurs steht -- die Grundlage von `/k3kurs`. */
+export async function kurs() {
+    const antwort = await ruf("/api/cli/kurs", { methode: "GET", mitAusweis: true }); // kein-anzeigetext: HTTP-Methode
+    // 🌐 Die Antwort kann die Kontosprache umgestellt haben: Was ab hier gedruckt wird, in der neuen.
+    const s = sprache();
+    if (antwort.status === 200) {
+        const stand = standAus(antwort.koerper);
+        if (!stand) {
+            console.error(ALLGEMEIN_TEXTE[s].unreadableAnswer);
+            return 3;
+        }
+        kursZeilen(stand, s, BASIS_URL).forEach((z) => console.log(z));
+        return 0;
+    }
+    const meldung = feld(antwort.koerper, "meldung") ?? ALLGEMEIN_TEXTE[s].genericFailure;
+    if (antwort.status === 401) {
+        console.error(`${meldung}${ALLGEMEIN_TEXTE[s].pleaseSignIn}`);
+        return 2;
+    }
+    const schluss = schlussFehler(antwort.status, meldung, s);
+    console.error(schluss.text);
+    return schluss.wert;
+}

package/dist/befehle/login.js

@@ -5,6 +5,7 @@ import { sprache } from "../sprache.js";
 import { anmeldeAdresse, oeffneImBrowser } from "../browser.js";
 import { ALLGEMEIN_TEXTE } from "../texte/allgemein.js";
 import { EINRICHTEN_TEXTE } from "../texte/einrichten.js";
+import { frischeCoachAuf } from "../coach-ablegen.js";
 import { stelleSkillUm } from "./skill-tausch.js";
 const warte = (ms) => new Promise((f) => setTimeout(f, ms));
 // 🌐 Die Sprache wird bei JEDER Ausgabe neu gelesen: Die Abhol-Antwort nennt die Kontosprache
@@ -27,7 +28,13 @@ export async function login() {
     console.log(t().loginOpen(BASIS_URL));
     console.log(t().loginEnterCode(start.nutzerCode));
     console.log(t().loginWaiting);
-    return warteAufBestaetigung(start.geraeteCode);
+    const code = await warteAufBestaetigung(start.geraeteCode);
+    // Der Coach zieht mit der Kontosprache mit -- nur beim BEFEHL `kimal3 login`, nicht in der geteilten Warteschleife:
+    // `einrichten` meldet anschließend seinen eigenen Coach, eine zweite Zeile wäre doppelt (Gesamt-Durchsicht, Fund 4;
+    // dasselbe Muster wie `skillInstallBefehl`). Frischt nur auf, legt nie an (Spec C-13b).
+    if (code === 0)
+        frischeCoachAuf(sprache());
+    return code;
 }
 /**
  * Die Anmeldung für `kimal3 einrichten` (Spec 2026-10-11, S-2): Code und Adresse auf eigenen

package/dist/befehle/skill-install.js

@@ -9,6 +9,7 @@ import { eigeneVersion } from "../version.js";
 import { sprache } from "../sprache.js";
 import { andereSpracheZuRaeumen, skillQuelle } from "../slash-befehle.js";
 import { SKILL_TEXTE } from "../texte/skill.js";
+import { frischeCoachAuf } from "../coach-ablegen.js";
 export const VERALTETE_BEFEHLE = [
     /*
       🔴 **Der ERSTE Eintrag ueberhaupt** (2026-08-28). `/k3firma` heisst jetzt
@@ -320,6 +321,17 @@ export async function skillInstall() {
     }
     return 0;
 }
+/**
+ * Der Befehl `kimal3 skill install`: die Anleitung ablegen und einen VORHANDENEN Coach mitziehen (Update, Sprachwechsel;
+ * angelegt wird keiner). Bewusst hier und nicht in `skillInstall()`: `einrichten` ruft das auch, hat seinen Coach aber
+ * schon selbst abgelegt und gemeldet -- ein zweites Auffrischen druckte dessen Zeile noch einmal (bei fehlender
+ * Trenn-Marke auch die Ersatzdatei ein zweites Mal).
+ */
+export async function skillInstallBefehl() {
+    const code = await skillInstall();
+    frischeCoachAuf(sprache());
+    return code;
+}
 /**
  * Kopiert die Slash-Befehle nach `~/.claude/commands/`.
  *

package/dist/befehle-katalog-en.js

@@ -118,6 +118,18 @@ export const BEFEHLE_EN = {
             "What it's really for: Claude looks here BEFORE adding a project. Without that check, the same project would sooner or later appear twice on a public page that carries your name.",
         ],
     },
+    "kimal3 kurs": {
+        stempel: "3a5c7600",
+        befehl: "kimal3 course",
+        tippen: "/k3course",
+        terminal: "kimal3 course",
+        beschreibung: "Show where you are in the mini-course",
+        rhythmusOderSatz: "where am I in the course",
+        details: [
+            "Shows which parts you have finished, what is next and what is still open — and for each step whether you tick it off or Claude sets it.",
+            "Claude reads this when you come back to the course and picks up exactly where you left off.",
+        ],
+    },
     "kimal3 firma daten": {
         stempel: "3195364c",
         befehl: "kimal3 company data",

package/dist/befehle-katalog.js

@@ -167,6 +167,18 @@ export const BEFEHLE = [
             "Wofür es wirklich da ist: Claude schaut hier VOR dem Eintragen nach. Ohne diesen Blick stünde dasselbe Projekt irgendwann zweimal auf einer öffentlichen Seite, die deinen Namen trägt.",
         ],
     },
+    {
+        befehl: "kimal3 kurs",
+        beschreibung: "Zeigen, wo du im Mini-Kurs stehst",
+        wer: "claude",
+        ausloeser: "wo stehe ich im Kurs",
+        tippen: "/k3kurs",
+        terminal: "kimal3 kurs",
+        details: [
+            "Zeigt, welche Beats du fertig hast, was als Nächstes dran ist und was noch offen ist — und bei jedem Schritt, ob du ihn abhakst oder Claude ihn setzt.",
+            "Claude liest das, wenn du in den Kurs zurückkehrst, und macht genau dort weiter, wo du aufgehört hast.",
+        ],
+    },
     {
         befehl: "kimal3 firma daten",
         beschreibung: "Die Daten deiner Firma holen, damit Claude sie auswerten kann",

package/dist/befehlswoerter.js

@@ -11,6 +11,7 @@ export const BEFEHLSWOERTER = {
     "projekt neu": { de: "projekt neu", en: "project new" }, // kein-anzeigetext: Befehlswörter (Spec Abschnitt 6)
     "projekt liste": { de: "projekt liste", en: "project list" }, // kein-anzeigetext: Befehlswörter (Spec Abschnitt 6)
     "firma daten": { de: "firma daten", en: "company data" }, // kein-anzeigetext: Befehlswörter (Spec Abschnitt 6)
+    kurs: { de: "kurs", en: "course" }, // kein-anzeigetext: Befehlswörter (Spec Abschnitt 6)
     wache: { de: "wache", en: "watch" },
     "wache an": { de: "wache an", en: "watch on" }, // kein-anzeigetext: Befehlswörter (Spec Abschnitt 6)
     "wache aus": { de: "wache aus", en: "watch off" }, // kein-anzeigetext: Befehlswörter (Spec Abschnitt 6)
@@ -56,6 +57,9 @@ export const SCHALTER_EN = {
     impact: "wirkung",
     "impact-label": "wirkung-label",
     "live-since": "live-seit",
+    // `kimal3 einrichten` / `setup` (Spec 2026-10-16, Bauform 6)
+    workplace: "arbeitsplatz",
+    workbench: "werkbank",
 };
 /** `company` -> `firma`; ein deutscher (oder unbekannter) Name bleibt, wie er ist. */
 export function deutscherSchalter(getippt) {

package/dist/coach-ablegen.js

@@ -0,0 +1,130 @@
+import { mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { coachNachher } from "./coach-rechnung.js";
+import { COACH_TEXTE } from "./texte/coach.js";
+/**
+ * Der Coach im Regel-Ordner (Spec 2026-10-16): Claude Code lädt jede Datei in `~/.claude/rules/` bei jedem Start mit,
+ * in jedem Ordner -- dort wirkt er, ohne dass `~/.claude/CLAUDE.md` angefasst wird (die gehört dem Menschen).
+ * Was in der Datei steht, rechnet `coach-rechnung.ts` (rein, bewacht von `check:wache`); hier wird nur gelesen und
+ * geschrieben. Gemessen am gebauten Programm von `check:cli-live`.
+ */
+export const coachPfad = () => join(homedir(), ".claude", "rules", "kimal3-coach.md"); // kein-anzeigetext: Dateiname
+/** Fehlt die Trenn-Marke, landet die neue Fassung HIER -- außerhalb des Regel-Ordners, sonst lüden zwei Coaches (UX-10). */
+export const coachErsatzPfad = () => join(homedir(), ".kimal3", "kimal3-coach-neu.md"); // kein-anzeigetext: Dateiname
+/** Der Coach aus dem alten Mini-Kurs, und wohin Claude ihn nach einem Ja verschiebt (S-14) -- `kimal3` schreibt ihn nie. */
+export const alterKursCoachPfad = () => join(homedir(), ".claude", "CLAUDE.md"); // kein-anzeigetext: Dateiname
+export const alterKursCoachAblage = () => join(homedir(), ".kimal3", "alter-kurs-coach.md"); // kein-anzeigetext: Dateiname
+/**
+ * Legt den Coach ab oder frischt ihn auf. `null` = es liegt keiner da, und dieser Aufruf darf keinen anlegen
+ * (nur `einrichten` darf das; `skill install` und `login` frischen nur auf).
+ * 🔑 Wirft nie: Jeder Lese- oder Schreibfehler wird `gescheitert` mit der Meldung des Systems -- die Einrichtung läuft
+ * weiter (C-10), und der Mensch erfährt den Grund statt einer Stapelspur.
+ */
+export function legeCoachAb(s, darfAnlegen) {
+    const pfad = coachPfad();
+    try {
+        const da = statSync(pfad, { throwIfNoEntry: false });
+        // Ein Ordner unter dem Namen gehört nicht uns -- nichts anfassen, wie bei einer fremden Datei (C-11).
+        if (da !== undefined && !da.isFile())
+            return { art: "fremd", pfad, spracheGewechselt: false };
+        if (da === undefined && !darfAnlegen)
+            return null;
+        // Die Vorlage erst NACH dem `null`: Wer keinen Coach hat, soll von `login` und `skill install` auch dann nichts hören,
+        // wenn die Vorlage im Paket fehlt (Gesamt-Durchsicht, Fund 6).
+        // `dist/coach-ablegen.js` -> `../coach/<sprache>/…` im installierten Paket (`files` in package.json).
+        const vorlage = readFileSync(fileURLToPath(new URL(`../coach/${s}/kimal3-coach.md`, import.meta.url)), "utf8"); // kein-anzeigetext: Paketpfad
+        const ergebnis = coachNachher(da === undefined ? null : readFileSync(pfad, "utf8"), vorlage);
+        switch (ergebnis.art) {
+            case "neu":
+                mkdirSync(dirname(pfad), { recursive: true });
+                tauscheEin(pfad, ergebnis.inhalt);
+                return { art: "angelegt", pfad, spracheGewechselt: false };
+            case "aktualisiert":
+                tauscheEin(pfad, ergebnis.inhalt);
+                return { art: "aktualisiert", pfad, spracheGewechselt: ergebnis.spracheVorher !== null && ergebnis.spracheVorher !== s };
+            case "ohne-trenner": {
+                // Das Original bleibt Byte für Byte (C-8): Ohne Trenn-Marke wüssten wir nicht, wo seine Regeln anfangen.
+                const ersatz = coachErsatzPfad();
+                mkdirSync(dirname(ersatz), { recursive: true });
+                writeFileSync(ersatz, ergebnis.inhalt, "utf8");
+                return { art: "ohne-trenner", pfad, ersatz };
+            }
+            case "vorlage-ohne-trenner":
+                return { art: "gescheitert", pfad, grund: COACH_TEXTE[s].templateWithoutSeparator };
+            default:
+                return { art: ergebnis.art, pfad, spracheGewechselt: false };
+        }
+    }
+    catch (e) {
+        return { art: "gescheitert", pfad, grund: e.message };
+    }
+}
+/**
+ * Erst in eine Nebendatei, dann tauschen (Durchsicht Aufgabe 5, Fund 1): `writeFileSync` leert die Datei, BEVOR es
+ * schreibt -- bei voller Platte wären die gelernten Regeln weg, und der nächste Lauf hielte den leeren Rest für fremd.
+ * 🔑 `kimal3-coach.md.neu` endet nicht auf `.md`: Claude lädt sie nie als zweiten Coach, auch wenn sie liegen bliebe.
+ * Scheitert ein Schritt, kommt die Nebendatei weg (ein Ordner unter dem Namen ist nicht unserer und bleibt), und der
+ * Fehler geht an `legeCoachAb`, das ihn zu `gescheitert` macht.
+ */
+function tauscheEin(pfad, inhalt) {
+    const neben = `${pfad}.neu`; // kein-anzeigetext: Dateiname
+    try {
+        writeFileSync(neben, inhalt, "utf8");
+        renameSync(neben, pfad);
+    }
+    catch (e) {
+        try {
+            rmSync(neben);
+        }
+        catch {
+            // Lag nie da, oder es ist ein Ordner -- dann nichts anfassen.
+        }
+        throw e;
+    }
+}
+/** Liegt unter dem Coach-Pfad eine DATEI (unsere oder eine fremde)? Daran hängt `beat2-coach` (E-5, E-9). Wirft nie. */
+export function coachDateiLiegt() {
+    try {
+        return statSync(coachPfad(), { throwIfNoEntry: false })?.isFile() === true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Die eine Zeile zu einer Ablage, in der Sprache des Laufs -- für `einrichten` (Task 5), `skill install` und `login`.
+ * `sprachwechselSagen`: Nur `login` und `skill install` sagen einen Sprachwechsel mit eigenem Satz (Spec 2.6) -- er
+ * sagt, was der Mensch dort sonst nicht merkt: dass seine Regeln den Wechsel überlebt haben. `einrichten` bleibt bei der
+ * Zeile mit `Coach:`, an der die Anleitung liest. Welche Fälle ein Aufruf verschweigt (`gleich`, `fremd` beim
+ * Auffrischen), entscheidet der Aufrufer.
+ */
+export function meldeCoach(ablage, s, sprachwechselSagen = false) {
+    if (ablage === null)
+        return;
+    const t = COACH_TEXTE[s];
+    if (ablage.art === "angelegt")
+        console.log(t.setUp(ablage.pfad));
+    else if (ablage.art === "gleich")
+        console.log(t.upToDate);
+    else if (ablage.art === "aktualisiert")
+        console.log(sprachwechselSagen && ablage.spracheGewechselt ? t.languageSwitched : t.updated);
+    else if (ablage.art === "fremd")
+        console.log(t.foreign(ablage.pfad));
+    else if (ablage.art === "ohne-trenner")
+        console.log(t.noSeparator(ablage.pfad, ablage.ersatz));
+    else if (ablage.art === "gescheitert")
+        console.log(t.failed(ablage.grund));
+}
+/**
+ * Für `skill install` und `login`: einen VORHANDENEN Coach auffrischen (Update, Sprachwechsel), nie einen anlegen --
+ * das darf nur `einrichten` (Spec C-13b: Auffrischen ist kein Anlegen). Schweigt, wenn nichts zu sagen ist: kein Coach,
+ * ein fremder, ein schon aktueller. Ein Sprachwechsel bekommt seinen eigenen Satz (Spec 2.6).
+ */
+export function frischeCoachAuf(s) {
+    const ablage = legeCoachAb(s, false);
+    if (ablage === null || ablage.art === "gleich" || ablage.art === "fremd")
+        return;
+    meldeCoach(ablage, s, true);
+}

package/dist/coach-rechnung.js

@@ -0,0 +1,40 @@
+// Ein BOM (U+FEFF) vor der ersten Zeile setzen manche Windows-Editoren; er gehört nicht zur Marke.
+const KOPF = /^\uFEFF?<!-- kimal3:coach/;
+const KOPF_SPRACHE = /^\uFEFF?<!-- kimal3:coach sprache=(de|en)(?![A-Za-z])/;
+// Nur am ZEILENANFANG, ohne Einrückung: Die Kopfzeile nennt die Trenn-Marke im Fließtext, und eine gelernte Regel darf
+// es auch. 🔑 Exportiert, weil `check:cli` die Vorlagen mit GENAU diesem Ausdruck prüft -- eine eigene, nachsichtigere
+// Erkennung dort ließe eine eingerückte Marke grün durch, die diese Rechnung nicht findet (Gesamt-Durchsicht, Fund 3).
+export const TRENNER = /^<!-- kimal3:gelernte-regeln/m;
+const ALTER_KURS_COACH = /^\uFEFF?# CLAUDE\.md — (Dein Claude-Coach|Your Claude coach)/;
+export const istUnserCoach = (inhalt) => KOPF.test(inhalt);
+export function coachSprache(inhalt) {
+    const treffer = KOPF_SPRACHE.exec(inhalt);
+    return treffer ? treffer[1] : null;
+}
+// Der Kurs-Coach von früher (Beat 2 des Mini-Kurses) beginnt mit dieser Überschrift, deutsch wie englisch.
+export const istAlterKursCoach = (inhalt) => ALTER_KURS_COACH.test(inhalt);
+// Alles bis einschließlich des Zeilenendes der ersten Trenn-Zeile (\n oder \r\n -- das \r steht vor dem \n und
+// gehört damit zur Zeile). Ohne Zeilenende danach reicht die Zeile bis zum Dateiende. -1 = keine Trenn-Zeile.
+function obenBis(text) {
+    const treffer = TRENNER.exec(text);
+    if (!treffer)
+        return -1;
+    const umbruch = text.indexOf("\n", treffer.index);
+    return umbruch === -1 ? text.length : umbruch + 1;
+}
+export function coachNachher(vorher, vorlage) {
+    const vorlageEnde = obenBis(vorlage);
+    if (vorlageEnde === -1)
+        return { art: "vorlage-ohne-trenner" };
+    if (vorher === null)
+        return { art: "neu", inhalt: vorlage };
+    if (!istUnserCoach(vorher))
+        return { art: "fremd" };
+    const altEnde = obenBis(vorher);
+    if (altEnde === -1)
+        return { art: "ohne-trenner", inhalt: vorlage };
+    const neu = vorlage.slice(0, vorlageEnde) + vorher.slice(altEnde);
+    if (neu === vorher)
+        return { art: "gleich" };
+    return { art: "aktualisiert", inhalt: neu, spracheVorher: coachSprache(vorher) };
+}

package/dist/kimal3.js

@@ -33,9 +33,10 @@ import { kontextRunter } from "./befehle/kontext-runter.js";
 import { kontextHoch } from "./befehle/kontext-hoch.js";
 import { login } from "./befehle/login.js";
 import { logout } from "./befehle/logout.js";
+import { kurs } from "./befehle/kurs.js";
 import { projektListe } from "./befehle/projekt-liste.js";
 import { projektNeu } from "./befehle/projekt-neu.js";
-import { skillDatei, skillInstall } from "./befehle/skill-install.js";
+import { skillDatei, skillInstallBefehl } from "./befehle/skill-install.js";
 import { wache, wacheSchalten } from "./befehle/wache.js";
 /** Eine Meldung pro Programmlauf -- s. "Einmal-Riegel" im Block darunter. */
 let schonGemeldet = false;
@@ -480,9 +481,10 @@ async function fuehreAus(name, rest) {
     switch (name) {
         case "login": return allein ? login() : null;
         case "logout": return allein ? logout() : null;
-        case "skill install": return allein ? skillInstall() : null;
+        case "skill install": return allein ? skillInstallBefehl() : null;
         case "projekt neu": return projektNeu(rest);
         case "projekt liste": return allein ? projektListe() : null;
+        case "kurs": return allein ? kurs() : null;
         // ⚠️ Rest wird durchgereicht, nicht auf Gleichheit geprueft: `firma daten --firma X` gehoert dazu.
         case "firma daten": return firmaDaten(rest);
         case "einrichten": return einrichten(rest);

package/dist/texte/coach.js

@@ -0,0 +1,27 @@
+import { EINRICHTEN_MARKEN } from "./einrichten-marken.js";
+const M = EINRICHTEN_MARKEN;
+const de = {
+    setUp: (pfad) => `  ${M.de.coach} eingerichtet (${pfad}).`,
+    upToDate: `  ${M.de.coach} ist aktuell.`,
+    updated: `  ${M.de.coach} aktualisiert — deine gelernten Regeln sind geblieben.`,
+    foreign: (pfad) => `  ${M.de.coach} Unter ${pfad} liegt schon eine Datei, die nicht von KImal3 stammt — ich lasse sie, wie sie ist.`,
+    noSeparator: (pfad, neu) => `  ${M.de.coach} nicht aktualisiert — in ${pfad} fehlt die Zeile, ab der deine gelernten Regeln stehen. Die neue Fassung liegt unter ${neu}.`,
+    failed: (grund) => `  ${M.de.coach} konnte nicht abgelegt werden — ${grund}`,
+    // Der Grund zu `failed`, wenn der Vorlage im Programm selbst die Trenn-Marke fehlt (ein Paketfehler, `coach-rechnung.ts`).
+    templateWithoutSeparator: "der Vorlage im Programm fehlt die Zeile, ab der die gelernten Regeln stehen. Das ist ein Fehler in kimal3 — bitte melde ihn uns.",
+    // Die Zeile spricht immer die Sprache, in die umgestellt wurde -- deshalb steht der Sprachname fest im Satz.
+    languageSwitched: "✓ Dein Coach ist jetzt auf Deutsch — deine gelernten Regeln sind geblieben.",
+    oldCourseCoach: (pfad, ablage) => `  ${M.de.alterKursCoach} Du hast im alten Mini-Kurs schon einmal einen Coach eingerichtet (${pfad}). Jetzt gibt es einen neuen, und zwei gleichzeitig würden sich widersprechen. Soll ich den alten beiseitelegen? Du findest ihn danach unter ${ablage}.`,
+};
+const en = {
+    setUp: (pfad) => `  ${M.en.coach} set up (${pfad}).`,
+    upToDate: `  ${M.en.coach} up to date.`,
+    updated: `  ${M.en.coach} updated — your learned rules are still there.`,
+    foreign: (pfad) => `  ${M.en.coach} There's already a file at ${pfad} that doesn't come from KImal3 — I'll leave it as it is.`,
+    noSeparator: (pfad, neu) => `  ${M.en.coach} not updated — ${pfad} is missing the line your learned rules start below. The new version is at ${neu}.`,
+    failed: (grund) => `  ${M.en.coach} couldn't be put in place — ${grund}`,
+    templateWithoutSeparator: "the program's template is missing the line your learned rules start below. That's a bug in kimal3 — please tell us.",
+    languageSwitched: "✓ Your coach is now in English — your learned rules are still there.",
+    oldCourseCoach: (pfad, ablage) => `  ${M.en.alterKursCoach} You set up a coach in the old mini course (${pfad}). There's a new one now, and two at once would contradict each other. Shall I put the old one aside? You'll find it at ${ablage} afterwards.`,
+};
+export const COACH_TEXTE = { de, en };

package/dist/texte/einrichten-marken.js

@@ -4,6 +4,6 @@
  * Programm druckt sie, die Anleitung nennt sie, `check:kurs` haelt beide gleich.
  */
 export const EINRICHTEN_MARKEN = {
-    de: { code: "Anmelde-Code:", adresse: "Adresse:", arbeitsplatz: "Arbeitsplatz:", werkbank: "Werkbank:", angemeldet: "Angemeldet als", plugins: "Plugins:" },
-    en: { code: "Sign-in code:", adresse: "Address:", arbeitsplatz: "Workplace:", werkbank: "Workbench:", angemeldet: "Signed in as", plugins: "Plugins:" },
+    de: { code: "Anmelde-Code:", adresse: "Adresse:", arbeitsplatz: "Arbeitsplatz:", werkbank: "Werkbank:", angemeldet: "Angemeldet als", plugins: "Plugins:", naechster: "Als Nächstes:", coach: "Coach:", alterKursCoach: "Alter Kurs-Coach:" },
+    en: { code: "Sign-in code:", adresse: "Address:", arbeitsplatz: "Workplace:", werkbank: "Workbench:", angemeldet: "Signed in as", plugins: "Plugins:", naechster: "Next:", coach: "Coach:", alterKursCoach: "Old course coach:" },
 };

package/dist/texte/einrichten.js

@@ -5,11 +5,36 @@ const de = {
     addressLine: (url) => `  ${M.de.adresse} ${url}`,
     browserOpened: "  Ich öffne die Seite gerade in deinem Browser. Bestätige dort nur, wenn derselbe Code dasteht.",
     browserNotOpened: "  Öffne die Adresse oben in deinem Browser. Bestätige dort nur, wenn derselbe Code dasteht.",
-    help: "\n  kimal3 einrichten [--firma \"Name\" | --firma-id \"…\"]\n\n  Meldet dich an (der Browser öffnet sich mit deinem Code), legt deinen\n  KI-Arbeitsplatz in deinem Benutzerordner an, richtet die /k3-Befehle und\n  die Wache ein und hakt die Schritte im Kurs ab. Ein zweiter Lauf ergänzt\n  nur, was fehlt.\n",
+    help: "\n  kimal3 einrichten [--firma \"Name\" | --firma-id \"…\"] [--arbeitsplatz \"<pfad>\"] [--werkbank <name>]\n\n  Meldet dich an (der Browser öffnet sich mit deinem Code), sucht deinen\n  KI-Arbeitsplatz oder legt ihn in deinem Benutzerordner an, richtet die\n  /k3-Befehle und die Wache ein und hakt die Schritte im Kurs ab. Ein\n  vorhandener Arbeitsplatz wird benutzt, nicht verändert.\n\n  --arbeitsplatz  wo dein Arbeitsplatz liegt oder neu entstehen soll\n  --werkbank      welche Werkbank darin deine ist\n",
     start: "\nIch richte deinen KI-Arbeitsplatz ein.",
     filesWritten: (neu, schonDa) => `\n✓ ${neu} Dateien angelegt, ${schonDa} lagen schon da.`,
     workplaceLine: (pfad) => `  ${M.de.arbeitsplatz} ${pfad}`,
     workbenchLine: (name) => `  ${M.de.werkbank} ${name}`,
+    // Was Sabine in der nächsten Sitzung schreibt (Spec 2026-10-16, Z-15): Steht die Anleitung für die erste
+    // Sitzung noch in ihrer Werkbank, der Startsatz der Vorlage; sonst der Befehl für jeden weiteren Tag.
+    nextLine: (offen) => `  ${M.de.naechster} ${offen ? "„Lass uns einrichten“" : "/k3start"}`,
+    // Vorhandener Arbeitsplatz (Spec 2026-10-16, „Neue Sätze“). Jede Rückfrage endet mit fertigen Befehlen.
+    foundWorkplace: (pfad) => `\nDein Arbeitsplatz liegt schon unter ${pfad} — ich benutze diesen.`,
+    severalFound: "\nIch habe mehrere Arbeitsplätze gefunden. Welchen soll ich benutzen?",
+    foreignFolder: (pfad) => `\nUnter ${pfad} liegt schon ein Ordner, der nicht von KImal3 stammt. Ich lege dort nichts ab.`,
+    searchIncomplete: "\nIch konnte nicht überall nachsehen. Hast du schon einen Arbeitsplatz?",
+    rememberedGone: (pfad) => `\nDein Arbeitsplatz lag unter ${pfad}, dort ist er nicht mehr. Wo liegt er jetzt?`,
+    noMatchingWorkbench: (pfad) => `\nIn ${pfad} finde ich keine Werkbank für dich.`,
+    confirmWorkbench: (name) => `\nIst ${name} deine Werkbank?`,
+    noWorkbenchInWorkplace: (pfad) => `\nIn ${pfad} gibt es noch keine Werkbank. Leg deine an und starte die Einrichtung danach noch einmal:`,
+    // Die Überschriften über den Befehlen der Rückfragen.
+    existingWorkplace: "  Er liegt hier (Pfad einsetzen):",
+    newWorkplace: "  Leg einen neuen an:",
+    otherPlace: "  Nimm einen anderen Ort, leer oder mit deinem Arbeitsplatz:",
+    yes: "  Ja:",
+    noOther: "  Nein, es ist eine andere:",
+    oneOfThese: "  Ist eine davon deine:",
+    ownWorkbench: "  Noch keine eigene? Leg sie an und starte die Einrichtung danach noch einmal:",
+    pathPlaceholder: "<pfad>",
+    // Ein mitkopierter Platzhalter in `--arbeitsplatz` -- Claude fragt dann nach dem echten Ort.
+    placeholderPath: (wert) => `\n${wert} ist ein Platzhalter, kein Ordner. Setz dort den echten Pfad deines Arbeitsplatzes ein; ich habe nichts angelegt.`,
+    commandLine: (rest) => `    kimal3 ${rest}`,
+    cdLine: (pfad) => `    cd ${pfad}`,
     courseMarked: "✓ Im Kurs abgehakt.",
     courseNotMarked: "  Die Haken im Kurs konnte ich gerade nicht setzen — der nächste Lauf holt das nach.",
     done: "\n✓ Fertig eingerichtet.",
@@ -36,11 +61,32 @@ const en = {
     addressLine: (url) => `  ${M.en.adresse} ${url}`,
     browserOpened: "  Opening the page in your browser now. Only confirm there if it shows the same code.",
     browserNotOpened: "  Open the address above in your browser. Only confirm there if it shows the same code.",
-    help: "\n  kimal3 setup [--company \"Name\" | --company-id \"…\"]\n\n  Signs you in (your browser opens with your code), creates your AI Workplace\n  in your user folder, sets up the /k3 commands and the watch, and ticks off\n  the course steps. A second run only adds what is missing.\n",
+    help: "\n  kimal3 setup [--company \"Name\" | --company-id \"…\"] [--workplace \"<path>\"] [--workbench <name>]\n\n  Signs you in (your browser opens with your code), finds your AI Workplace\n  or creates it in your user folder, sets up the /k3 commands and the watch,\n  and ticks off the course steps. An existing workplace is used, not changed.\n\n  --workplace  where your workplace is, or where a new one should go\n  --workbench  which workbench in it is yours\n",
     start: "\nSetting up your AI Workplace.",
     filesWritten: (neu, schonDa) => `\n✓ ${neu} files created, ${schonDa} were already there.`,
     workplaceLine: (pfad) => `  ${M.en.arbeitsplatz} ${pfad}`,
     workbenchLine: (name) => `  ${M.en.werkbank} ${name}`,
+    // The start sentence of the English template (workbench-your-name/CLAUDE.md, anleitung-en.ts) -- exactly that one.
+    nextLine: (offen) => `  ${M.en.naechster} ${offen ? "“Let's get set up”" : "/k3start"}`,
+    foundWorkplace: (pfad) => `\nYour workplace already exists at ${pfad} — I'll use that one.`,
+    severalFound: "\nI found more than one workplace. Which one should I use?",
+    foreignFolder: (pfad) => `\nThere's already a folder at ${pfad} that doesn't come from KImal3. I won't put anything there.`,
+    searchIncomplete: "\nI couldn't look everywhere. Do you already have a workplace?",
+    rememberedGone: (pfad) => `\nYour workplace was at ${pfad} and isn't there anymore. Where is it now?`,
+    noMatchingWorkbench: (pfad) => `\nI can't find a workbench for you in ${pfad}.`,
+    confirmWorkbench: (name) => `\nIs ${name} your workbench?`,
+    noWorkbenchInWorkplace: (pfad) => `\nThere's no workbench in ${pfad} yet. Create yours, then run the setup again:`,
+    existingWorkplace: "  It's here (fill in the path):",
+    newWorkplace: "  Create a new one:",
+    otherPlace: "  Choose another place, empty or with your workplace in it:",
+    yes: "  Yes:",
+    noOther: "  No, it's another one:",
+    oneOfThese: "  If one of these is yours:",
+    ownWorkbench: "  None of your own yet? Create it, then run the setup again:",
+    pathPlaceholder: "<path>",
+    placeholderPath: (wert) => `\n${wert} is a placeholder, not a folder. Put the real path of your workplace there; I haven't created anything.`,
+    commandLine: (rest) => `    kimal3 ${rest}`,
+    cdLine: (pfad) => `    cd ${pfad}`,
     courseMarked: "✓ Ticked off in the course.",
     courseNotMarked: "  I couldn't tick off the course steps just now — the next run will catch up.",
     done: "\n✓ All set up.",

package/dist/texte/kurs.js

@@ -0,0 +1,21 @@
+const de = {
+    beatFertig: (nummer) => `Beat ${nummer} ✓`,
+    beatTeil: (nummer, erledigt, gesamt) => `Beat ${nummer} — ${erledigt} von ${gesamt}`,
+    uebersicht: (beats) => `Kurs: ${beats}`,
+    alleErledigt: (anzahl) => `Kurs: abgeschlossen ✓ — alle ${anzahl} Schritte erledigt.`,
+    naechster: (text, claude) => `Als Nächstes: ${text} (${claude ? "setzt Claude" : "du hakst ab"})`,
+    nochOffen: "Noch offen:",
+    offenZeile: (beat, text, claude) => `  ○ Beat ${beat}: ${text} (${claude ? "setzt Claude" : "du hakst ab"})`,
+    imBrowser: (url) => `Im Browser: ${url}/kurs`,
+};
+const en = {
+    beatFertig: (nummer) => `Part ${nummer} ✓`,
+    beatTeil: (nummer, erledigt, gesamt) => `Part ${nummer} — ${erledigt} of ${gesamt}`,
+    uebersicht: (beats) => `Course: ${beats}`,
+    alleErledigt: (anzahl) => `Course: complete ✓ — all ${anzahl} steps done.`,
+    naechster: (text, claude) => `Next: ${text} (${claude ? "Claude sets it" : "you tick it off"})`,
+    nochOffen: "Still open:",
+    offenZeile: (beat, text, claude) => `  ○ Part ${beat}: ${text} (${claude ? "Claude sets it" : "you tick it off"})`,
+    imBrowser: (url) => `In the browser: ${url}/kurs`,
+};
+export const KURS_TEXTE = { de, en };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kimal3",
-  "version": "0.4.0-durchstich.3",
+  "version": "0.4.0",
   "description": "Trag deine KI-Projekte dort ein, wo sie entstehen: im Terminal. · Log your AI projects where they happen: in the terminal.",
   "type": "module",
   "bin": {
@@ -10,6 +10,7 @@
     "dist",
     "skill",
     "claude-plugins",
+    "coach",
     "README.md"
   ],
   "engines": {

package/skill/SKILL.md

@@ -24,7 +24,7 @@ den du erkennst.
 | `/k3` | Wo er steht — und alle kimal3-Befehle auf einen Blick |
 | `/k3start` | Sitzung starten: wo das Projekt steht und was als Nächstes dran ist |
 | `/k3feierabend` | Sitzung sauber beenden: Stand sichern, aufräumen, zusammenfassen |
-| `/k3kurs` | Zurück in den Mini-Kurs — da weiter, wo er aufgehört hat |
+| `/k3kurs` | Zurück in den Mini-Kurs — holt den Stand mit `kimal3 kurs` und macht da weiter, wo er aufgehört hat |
 | `/k3projekt` | Ein fertiges Projekt ins Erfolgsprofil eintragen |
 | `/k3liste` | Seine eingetragenen Projekte zeigen |
 | `/k3analyse` | Firmendaten holen und seine Frage dazu beantworten |
@@ -158,8 +158,7 @@ gemeinsam ausfüllen — es sind vier verschiedene. Such nach eckigen Klammern,
 zu folgen: Eine abgetippte Liste veraltet in dem Moment, in dem die Vorlage wächst. Frag nach,
 statt zu raten.
 
-⚠️ `[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.
+⚠️ `[FIRMA]` findest du meist schon ausgefüllt — den Namen setzt der Server beim Ausliefern ein. Was übrig bleibt, sind die Angaben über den **Menschen** vor dir.
 
 🔴 **Nur in der Werkbank — nirgends sonst.** Die oberste `CLAUDE.md` und alles in `kontext/` (in einer englischen Firma `context/`)
 gehören der **Firma**, nicht dem Menschen vor dir. Den Firmennamen setzt der Server beim
@@ -360,6 +359,11 @@ mitbestimmungspflichtig. Das entscheidet die Firma, nicht dieses Werkzeug.
 - „Was würdest du als Geschäftsführung als Nächstes automatisieren, gemessen an dem, was bisher
   funktioniert hat — und was davon lässt sich auf andere Abteilungen übertragen?"
 
+## Kursstand lesen (`kimal3 kurs`)
+Zeigt, wo der Mensch im Mini-Kurs steht: eine Zeile je Beat, `Als Nächstes:` mit dem nächsten Schritt und dahinter, wer
+ihn abhakt — „(du hakst ab)" oder „(setzt Claude)". Rückgabewert `2` heißt nicht angemeldet, `3` nicht erreichbar —
+dann **keinen Kurs aus dem Gedächtnis erzählen**. Der Slash-Befehl `/k3kurs` führt dadurch.
+
 ## Rückgabewerte
 `0` erledigt · `1` **Wiederholen hilft nicht — LIES DIE MELDUNG** · `2` Anmeldung fehlt ·
 `3` vorübergehende Störung, einmal wiederholen · `4` angemeldet, aber kein Pro-Zugang —

package/skill/commands/k3feierabend.md

@@ -24,10 +24,9 @@ Die Status-Datei (`WEITER-HIER.md` oder `ROADMAP.md`) ist der Zettel für den n
 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.
 
-**Der Statuszettel heißt `WEITER-HIER.md` — oder `NEXT-STEPS.md`, wenn der Ordner englisch angelegt wurde.** Liegt einer da, nimm ihn. Liegen beide da, frag, welcher gilt, und schreib in keinen, bevor die Antwort da ist. Muss einer neu entstehen: in `werkbank-…` heißt er `WEITER-HIER.md`, in `workbench-…` `NEXT-STEPS.md`, sonst `WEITER-HIER.md`.
+**Wo der Statuszettel liegt und wie er heißt.** Die Projektregel gilt **nur innerhalb eines Arbeitsplatzes**: Liegt ein Ordner `projekte/` oder `projects/` direkt in einem Ordner `werkbank-…` oder `workbench-…` (beide Schreibweisen kommen vor, auch gemischt) und steht die Sitzung in oder unter einem Ordner darin, ist dieser **Projektordner** der Ort. Name dort: unter `projekte/` `WEITER-HIER.md`, unter `projects/` `NEXT-STEPS.md`. **Überall sonst** (Starter-Paket, eigene Repos, auch ein Ordner `~/projects/mein-repo`) bleibt es wie bisher: Der Zettel liegt im Startordner, liegt einer da, nimm ihn; muss einer neu entstehen, heißt er `WEITER-HIER.md` — oder `NEXT-STEPS.md`, wenn der Ordner englisch angelegt wurde. Liegen beide da, frag, welcher gilt, und schreib in keinen, bevor die Antwort da ist. **Welcher gilt (im Arbeitsplatz):** Hat das Projekt einen, gilt der des Projekts. Sonst gilt ein vorhandener Werkbank-Zettel (`werkbank-…/WEITER-HIER.md` oder `workbench-…/NEXT-STEPS.md` aus der alten Vorlage) — den liest und pflegst du weiter. Gibt es keinen von beiden, entsteht er **im Projekt**. **Leg nie einen neuen Zettel in der Werkbank an.**
 
-Gibt es keine Status-Datei und die Arbeit wächst über eine Sitzung hinaus: eine vorschlagen,
-dann weiter mit Schritt 3.
+**Im Arbeitsplatz** schreibst du in den Zettel des Projekts, an dem heute gearbeitet wurde — fehlt er und liegt auch kein Werkbank-Zettel, leg ihn im Projekt an. **Nach einer reinen Profil-Sitzung** („Wer hier arbeitet“ ausgefüllt, noch kein Projekt) schreibst du **keinen** Zettel, sondern sagst, dass es beim nächsten Mal mit „Erste Sitzung“ in der Werkbank-`CLAUDE.md` weitergeht — dann weiter mit Schritt 3. **Außerhalb eines Arbeitsplatzes** gilt wie bisher: Gibt es keine Status-Datei und die Arbeit wächst über eine Sitzung hinaus, schlag eine vor, 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: