kimal3 0.6.0 → 0.6.2

package/claude-plugins/kimal3-logo/.claude-plugin/plugin.json

@@ -1,6 +1,7 @@
-{
-  "name": "kimal3-logo",
-  "version": "0.2.0",
-  "description": "KImal3-Logo über dem Eingabefeld · KImal3 logo above the prompt",
-  "author": { "name": "KImal3", "url": "https://kimal3.de" }
-}
+{
+  "name": "kimal3-logo",
+  "version": "0.3.0",
+  "description": "KImal3-Logo über dem Eingabefeld, öffnet beim Start das Projekt in der App · KImal3 logo above the prompt, opens the project in the app on start",
+  "author": { "name": "KImal3", "url": "https://kimal3.de" },
+  "types": "./types/index.d.ts"
+}

package/claude-plugins/kimal3-logo/hooks/app-oeffnen.ts

@@ -0,0 +1,96 @@
+import { atom, read, update, type Engine, type Register } from 'claude-code'
+
+// Beim Start von Claude Code die Projektseite im Browser der Claude-App öffnen (Dennis, 23.10.: „Automatisch bei jedem
+// Start“, und zwar „in dem Browser in der Claude-Code-App“ — nicht im Standardbrowser).
+// Szenario-Tabelle: docs/superpowers/specs/2026-10-23-mod-app-oeffnen.md
+
+const APP = 'https://app.kimal3.de'
+// Positivliste (messen-und-pruefen §23): Nur eine Projektnummer kommt in die Adresse, nie ein anderer Wert aus der Datei (S-4).
+const PROJEKTNUMMER = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i
+// Der eingebaute Browser der Claude-App, wie ihn das Werkzeug `mcp__Claude_Browser__navigate` nennt.
+const BROWSER = 'Claude_Browser'
+const NAVIGATE = 'mcp__Claude_Browser__navigate'
+const geoeffnet = atom({ plugin: 'kimal3-logo', key: 'appGeoeffnet' } as const, false)
+
+/** Die Adresse für den Inhalt von `plan/stand.json` (`null`: keine Datei). Ohne gültige Nummer der Kurs, wie der Link in der Leiste (S-3, S-4). */
+export function adresseFuer(standJson: string | null): string {
+  if (standJson !== null) {
+    try {
+      // Ein BOM am Anfang (Windows-Editoren) lehnt JSON.parse ab, wie in `cli/src/plan-datei.ts`.
+      const id: unknown = JSON.parse(standJson.replace(/^\uFEFF/, ''))?.projekt_id
+      if (typeof id === 'string' && PROJEKTNUMMER.test(id)) return `${APP}/projekt/${id.toLowerCase()}`
+    } catch {
+      // kaputtes JSON: wie keine Datei
+    }
+  }
+  return `${APP}/kurs`
+}
+
+/** Die eigene Erlaubnis (unten): nur der Aufruf dieses Mods, nur eine Adresse der App. Herausgelöst, damit `check:logo` die Grenze prüft. */
+export function istEigenerAufruf(plugin: string, input: unknown): boolean {
+  const url = (input as { url?: unknown } | null)?.url
+  return plugin === 'kimal3-logo' && typeof url === 'string' && url.startsWith(`${APP}/`)
+}
+
+// Gegen zwei gleichzeitige Versuche in diesem Lauf (`session.start` und `session.attach` kurz hintereinander).
+// Das Neuladen des Mods setzt die Variable zurück; dagegen hält der Merker `geoeffnet`.
+let laeuft = false
+
+/**
+ * Höchstens einmal je Sitzung (S-7, S-8, S-10): Der Merker in `$.state` übersteht das Neuladen des Mods. Er wird erst
+ * nach einem gelungenen Aufruf gesetzt — scheitert der erste Versuch, darf ein späteres `session.attach` es noch einmal.
+ */
+async function einmalOeffnen($: Engine): Promise<void> {
+  if (laeuft || (await read($, geoeffnet))) return
+  laeuft = true
+  try {
+    if (await oeffne($)) await update($, geoeffnet, () => true)
+  } finally {
+    laeuft = false
+  }
+}
+
+async function oeffne($: Engine): Promise<boolean> {
+  const cwd = await $.session.cwd()
+  let stand: string | null = null
+  try {
+    stand = await $.fs.read(`${cwd}/plan/stand.json`)
+  } catch {
+    stand = null
+  }
+  // Scheitern meldet sich als Scheitern, nie im Chat (S-13): eine Zeile nur im Debug-Protokoll (`to: 'debug'` —
+  // ohne steht sie im Chatverlauf, Befund der Durchsicht 23.10.).
+  try {
+    const antwort = await $.mcp.call(BROWSER, 'navigate', { url: adresseFuer(stand) })
+    if (!antwort.isError) return true
+    $.ui.log(`kimal3-logo: Projektseite nicht geöffnet: ${JSON.stringify(antwort.content).slice(0, 300)}`, { to: 'debug' })
+  } catch (fehler) {
+    $.ui.log(`kimal3-logo: Projektseite nicht geöffnet: ${String(fehler).slice(0, 300)}`, { to: 'debug' })
+  }
+  return false
+}
+
+export const appOeffnen: Register = on => {
+  // Die eigene Erlaubnis, eng: nur der Aufruf dieses Mods, nur eine Adresse der App. Ohne sie lehnt der Auto-Modus
+  // ab, weil beim Start niemand um etwas gebeten hat (gemessen 23.10. mit einer Probe). Claudes eigene Aufrufe und
+  // jede andere Adresse entscheidet die Kette darunter wie bisher.
+  on('tool.check', { tool: NAVIGATE }, ($, e, next) =>
+    istEigenerAufruf(next.origin.plugin, e.input)
+      ? { decision: 'allow', reason: 'kimal3: die eigene Projektseite beim Start' }
+      : next(e),
+  )
+  // Den Browser gibt es nur in der Claude-App, nicht im Terminal oder in VS Code. Beim Start meldet die App
+  // `isInteractive: false`, ist aber schon angehängt (gemessen 23.10.: surfaces ["desktop"]). `claude -p`, Skripte,
+  // geplante Aufgaben, das Terminal: kein Aufruf (S-6).
+  on('session.start', async ($, e, next) => {
+    const result = await next(e)
+    if ((await $.session.surfaces()).includes('desktop')) await einmalOeffnen($)
+    return result
+  })
+  // Hängt sich die App erst nach dem Start an, kommt das Signal hier.
+  on('session.attach', async ($, e, next) => {
+    const result = await next(e)
+    if (e.surface === 'desktop') await einmalOeffnen($)
+    return result
+  })
+}

package/claude-plugins/kimal3-logo/hooks/register.tsx

@@ -1,80 +1,84 @@
-import type { Register } from 'claude-code'
-
-// Die Sprache des Kontos. `kimal3 einrichten` setzt diese Zeile beim Ablegen in `~/.kimal3/claude-plugins` und prüft
-// danach, dass sie gesetzt ist (`cli/src/logo-ablegen.ts`) — der Mod selbst kann keine Datei lesen.
-const SPRACHE: 'de' | 'en' = 'de'
-
-// Icon: docs/design/kimal3-icon-animated.svg, unverändert bis auf die viewBox:
-// Sie schneidet den leeren Rand um die drei Dreiecke weg (Original: 0 0 80 80).
-const ICON = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="20 19 40 36" width="24" height="22">
-  <style>
-    /* color-scheme: sonst malt der Browser hinter die Grafik eine eigene Fläche, wenn hell/dunkel nicht zur App passt */
-    :root { background: transparent; color-scheme: light dark; }
-    .icon { opacity: 0.8; }
-    .tri  { fill: none; stroke: hsl(194 100% 51%); stroke-width: 2.8; stroke-linejoin: round; opacity: 0.7; }
-    .t1 { animation: trianglePulse 3s ease-in-out infinite; }
-    .t2 { animation: trianglePulse 3.5s ease-in-out infinite; animation-delay: .4s; }
-    .t3 { animation: trianglePulse 4s ease-in-out infinite; animation-delay: .8s; }
-    @keyframes trianglePulse { 0%,100% { opacity: .5; } 50% { opacity: 1; } }
-  </style>
-  <g class="icon">
-    <polygon class="tri t1" points="33.28,21.6 22.08,41.0 44.48,41.0" />
-    <polygon class="tri t2" points="46.72,21.6 35.52,41.0 57.92,41.0" />
-    <polygon class="tri t3" points="40.00,33.36 28.80,52.76 51.20,52.76" />
-  </g>
-</svg>`
-
-// Das Cyan der Marke (kimal3.de, --brand in der App)
-const MARKEN_CYAN = '#00C3FF'
-// Der Kurs, für alle (Dennis, 15.10.: „mach alle auf den Kurs“). Abgemeldete schickt die App von dort zum Login.
-// Fest auf `/firma` zeigte der Link Kostenlosen ohne Firma eine leere Seite (Spec L-51). Im Terminal: Strg+Klick; Claude Code hängt dort die Adresse
-// grau dahinter, wenn es dem Terminal keine Links zutraut — FORCE_HYPERLINK hilft nicht.
-const APP = 'https://app.kimal3.de/kurs'
-
-// Vor und nach der Wortmarke. Englisch: „AI Workplace“, nie „workspace“ (Spec, Global Constraints).
-const TEXT = {
-  de: { vor: 'Dein ', nach: '-Arbeitsplatz', alt: 'KImal3-Logo' },
-  en: { vor: 'Your ', nach: ' AI Workplace', alt: 'KImal3 logo' },
-}[SPRACHE]
-
-export const register: Register = on => {
-  on('ui.render', { component: 'AbovePrompt' }, ($, e, next) => {
-    if (e.props.hasSurvey) {
-      return next(e)
-    }
-
-    // Im Terminal gibt es kein Svg: drei Dreiecke als Zeichen, die Wortmarke wie auf kimal3.de
-    // („KI" in Schriftfarbe, „mal3" im Marken-Cyan). Das Cyan steht als Farbwert, nicht als „cyan" —
-    // das Terminal-Cyan ist je nach Farbschema ein anderes, oft ein blasses Türkis.
-    if (e.surface === 'terminal') {
-      const { Box, Link, Text } = $.ui.resolve(e)
-      return (
-        <Box flexDirection="row" gap={1}>
-          <Text color={MARKEN_CYAN} bold>{'▲▲▲'}</Text>
-          <Text bold>
-            {TEXT.vor}
-            <Link href={APP}>
-              {'KI'}
-              <Text color={MARKEN_CYAN}>{'mal3'}</Text>
-              {TEXT.nach}
-            </Link>
-            {'.'}
-          </Text>
-        </Box>
-      )
-    }
-
-    // isInteractive: erst damit spielt die Leiste die CSS-Animation ab, sonst steht das Icon still.
-    const { Box, Link, Svg, Text } = $.ui.resolve(e)
-    return (
-      <Box flexDirection="row" alignItems="center" gap={1}>
-        <Svg source={ICON} alt={TEXT.alt} width={24} height={22} isInteractive />
-        <Text bold>
-          {TEXT.vor}
-          <Link href={APP}>{`KImal3${TEXT.nach}`}</Link>
-          {'.'}
-        </Text>
-      </Box>
-    )
-  })
-}
+import type { Register } from 'claude-code'
+import { appOeffnen } from './app-oeffnen'
+
+// Die Sprache des Kontos. `kimal3 einrichten` setzt diese Zeile beim Ablegen in `~/.kimal3/claude-plugins` und prüft
+// danach, dass sie gesetzt ist (`cli/src/logo-ablegen.ts`).
+const SPRACHE: 'de' | 'en' = 'de'
+
+// Icon: docs/design/kimal3-icon-animated.svg, unverändert bis auf die viewBox:
+// Sie schneidet den leeren Rand um die drei Dreiecke weg (Original: 0 0 80 80).
+const ICON = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="20 19 40 36" width="24" height="22">
+  <style>
+    /* color-scheme: sonst malt der Browser hinter die Grafik eine eigene Fläche, wenn hell/dunkel nicht zur App passt */
+    :root { background: transparent; color-scheme: light dark; }
+    .icon { opacity: 0.8; }
+    .tri  { fill: none; stroke: hsl(194 100% 51%); stroke-width: 2.8; stroke-linejoin: round; opacity: 0.7; }
+    .t1 { animation: trianglePulse 3s ease-in-out infinite; }
+    .t2 { animation: trianglePulse 3.5s ease-in-out infinite; animation-delay: .4s; }
+    .t3 { animation: trianglePulse 4s ease-in-out infinite; animation-delay: .8s; }
+    @keyframes trianglePulse { 0%,100% { opacity: .5; } 50% { opacity: 1; } }
+  </style>
+  <g class="icon">
+    <polygon class="tri t1" points="33.28,21.6 22.08,41.0 44.48,41.0" />
+    <polygon class="tri t2" points="46.72,21.6 35.52,41.0 57.92,41.0" />
+    <polygon class="tri t3" points="40.00,33.36 28.80,52.76 51.20,52.76" />
+  </g>
+</svg>`
+
+// Das Cyan der Marke (kimal3.de, --brand in der App)
+const MARKEN_CYAN = '#00C3FF'
+// Der Kurs, für alle (Dennis, 15.10.: „mach alle auf den Kurs“). Abgemeldete schickt die App von dort zum Login.
+// Fest auf `/firma` zeigte der Link Kostenlosen ohne Firma eine leere Seite (Spec L-51). Im Terminal: Strg+Klick; Claude Code hängt dort die Adresse
+// grau dahinter, wenn es dem Terminal keine Links zutraut — FORCE_HYPERLINK hilft nicht.
+const APP = 'https://app.kimal3.de/kurs'
+
+// Vor und nach der Wortmarke. Englisch: „AI Workplace“, nie „workspace“ (Spec, Global Constraints).
+const TEXT = {
+  de: { vor: 'Dein ', nach: '-Arbeitsplatz', alt: 'KImal3-Logo' },
+  en: { vor: 'Your ', nach: ' AI Workplace', alt: 'KImal3 logo' },
+}[SPRACHE]
+
+export const register: Register = (on, options) => {
+  // Beim Start die Projektseite in der App öffnen (hooks/app-oeffnen.ts).
+  appOeffnen(on, options)
+
+  on('ui.render', { component: 'AbovePrompt' }, ($, e, next) => {
+    if (e.props.hasSurvey) {
+      return next(e)
+    }
+
+    // Im Terminal gibt es kein Svg: drei Dreiecke als Zeichen, die Wortmarke wie auf kimal3.de
+    // („KI" in Schriftfarbe, „mal3" im Marken-Cyan). Das Cyan steht als Farbwert, nicht als „cyan" —
+    // das Terminal-Cyan ist je nach Farbschema ein anderes, oft ein blasses Türkis.
+    if (e.surface === 'terminal') {
+      const { Box, Link, Text } = $.ui.resolve(e)
+      return (
+        <Box flexDirection="row" gap={1}>
+          <Text color={MARKEN_CYAN} bold>{'▲▲▲'}</Text>
+          <Text bold>
+            {TEXT.vor}
+            <Link href={APP}>
+              {'KI'}
+              <Text color={MARKEN_CYAN}>{'mal3'}</Text>
+              {TEXT.nach}
+            </Link>
+            {'.'}
+          </Text>
+        </Box>
+      )
+    }
+
+    // isInteractive: erst damit spielt die Leiste die CSS-Animation ab, sonst steht das Icon still.
+    const { Box, Link, Svg, Text } = $.ui.resolve(e)
+    return (
+      <Box flexDirection="row" alignItems="center" gap={1}>
+        <Svg source={ICON} alt={TEXT.alt} width={24} height={22} isInteractive />
+        <Text bold>
+          {TEXT.vor}
+          <Link href={APP}>{`KImal3${TEXT.nach}`}</Link>
+          {'.'}
+        </Text>
+      </Box>
+    )
+  })
+}

package/claude-plugins/kimal3-logo/types/index.d.ts

@@ -0,0 +1,8 @@
+declare module 'claude-code' {
+  interface PluginState {
+    'kimal3-logo': {
+      // Die Projektseite wurde in dieser Sitzung schon geöffnet (hooks/app-oeffnen.ts) — übersteht das Neuladen des Mods.
+      appGeoeffnet: boolean
+    }
+  }
+}

package/dist/plan-datei.js

@@ -121,7 +121,7 @@ export function specKoepfeAus(json) {
 const rumpfBytes = (text) => Buffer.byteLength(JSON.stringify(text), "utf8");
 /**
  * Liest den Text jeder Spec. Jede Spec bekommt GENAU einen Eintrag: den Text oder den Grund, warum keiner da ist.
- * Passt der fertige Anfrage-Rumpf nicht in 4 MB, werden die groessten Texte zu `zu_gross`, bis er passt (US-16:
+ * Passt der fertige Anfrage-Rumpf nicht in 4 MB, werden die groessten Texte zu `zusammen_zu_gross`, bis er passt (US-16:
  * „am fertigen Anfrage-Rumpf"). `rumpf` baut genau den Rumpf, den `plan hoch` schickt (Stand, Schalter, Texte) --
  * dieselbe Funktion baut ihn dort auch, damit gemessen wird, was hinausgeht (Befund M-3).
  */
@@ -165,7 +165,7 @@ export function leseSpecTexte(ordner, specs, rumpf) {
         });
         if (groesster < 0)
             break;
-        eintraege[groesster] = { schluessel: specs[groesster].schluessel, grund: "zu_gross", pfad: specs[groesster].datei };
+        eintraege[groesster] = { schluessel: specs[groesster].schluessel, grund: "zusammen_zu_gross", pfad: specs[groesster].datei };
     }
     const ohne = eintraege.flatMap((e, i) => "grund" in e ? [{ titel: specs[i].titel, grund: keineTextdatei.has(i) ? "keine_textdatei" : e.grund, pfad: e.pfad }] : []);
     return { eintraege, ohne };

package/dist/texte/plan.js

@@ -38,7 +38,8 @@ const de = {
         : grund === "keine_datei" ? "keine Datei angegeben"
             : grund === "ausserhalb" ? "Pfad außerhalb des Projekts"
                 : grund === "keine_textdatei" ? "keine Textdatei"
-                    : "größer als 300 KB",
+                    : grund === "zusammen_zu_gross" ? "alle Spec-Texte zusammen größer als 4 MB"
+                        : "größer als 300 KB",
     specTexte: (angekommen, gesamt, ohne) => `Spec-Texte hochgeladen: ${angekommen} von ${gesamt}.${ohne.length === 0 ? "" : ` Ohne Text: ${ohne.join(", ")}.`}`,
     specTextOhneEintrag: (titel, grundText) => `„${titel}“ (${grundText})`,
     idNowInFile: "projekt_id und basis stehen jetzt in plan/stand.json.",
@@ -83,7 +84,8 @@ const en = {
         : grund === "keine_datei" ? "no file given"
             : grund === "ausserhalb" ? "path outside the project"
                 : grund === "keine_textdatei" ? "not a text file"
-                    : "larger than 300 KB",
+                    : grund === "zusammen_zu_gross" ? "all spec texts together larger than 4 MB"
+                        : "larger than 300 KB",
     specTexte: (angekommen, gesamt, ohne) => `Spec texts uploaded: ${angekommen} of ${gesamt}.${ohne.length === 0 ? "" : ` Without text: ${ohne.join(", ")}.`}`,
     specTextOhneEintrag: (titel, grundText) => `"${titel}" (${grundText})`,
     idNowInFile: "projekt_id and basis are now in plan/stand.json.",

package/package.json

@@ -1,30 +1,30 @@
-{
-  "name": "kimal3",
-  "version": "0.6.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": {
-    "kimal3": "dist/kimal3.js"
-  },
-  "files": [
-    "dist",
-    "skill",
-    "claude-plugins",
-    "coach",
-    "zeigen",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=20"
-  },
-  "scripts": {
-    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && 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.6.2",
+  "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": {
+    "kimal3": "dist/kimal3.js"
+  },
+  "files": [
+    "dist",
+    "skill",
+    "claude-plugins",
+    "coach",
+    "zeigen",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && 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/commands/k3kurs.md

@@ -1,41 +1,41 @@
----
-description: Zurück in den Mini-Kurs — da weiter, wo du aufgehört hast
----
-
-<!-- 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. -->
-# Kurs
-
-> Zurück in den Mini-Kurs: „Wo war ich nochmal?" — macht da weiter, wo du aufgehört hast.
-> Den Stand holt `kimal3 kurs` frisch von kimal3 — dieselben Haken, die der Mensch im Browser unter
-> https://app.kimal3.de/kurs sieht.
-
-Führe die Schritte der Reihe nach aus. Bleib im Coaching-Ton: Deutsch, freundlich, ein Schritt
-nach dem anderen, das Warum vor dem Wie, null Vorwissen vorausgesetzt.
-
-## 1. Den Stand holen
-- Führ `kimal3 kurs` aus (unter Windows so, wie es `SKILL.md` beschreibt).
-- Rückgabewert **2**: Der Mensch ist nicht angemeldet. Zeig ihm `kimal3 login`, lass ihn selbst im Browser bestätigen
-  und nenn **keinen** Kursstand.
-- Rückgabewert **3**: Der Stand ist gerade nicht abrufbar. Sag es in einem Satz und **erzähl den Kurs nicht aus dem
-  Gedächtnis**.
-- Kennt das Programm den Befehl nicht, ist es zu alt: Nenn `npm install -g kimal3@latest`, danach `kimal3 skill install`.
-
-## 2. Stand in einem Satz sagen
-- Sag in **einem** Satz, wo ihr im Kurs steht — aus der Ausgabe (Zeile `Kurs:`), nichts dazuerfinden. Kein Vortrag.
-
-## 3. Als Nächstes führen
-- Die Zeile `Als Nächstes:` nennt den nächsten Schritt. Führ **einen** Schritt nach dem anderen: zeigen, machen lassen,
-  verstehen. Nie die ganze Liste auf einmal.
-- Steht dahinter **„(du hakst ab)"** und hat der Mensch den Schritt offensichtlich schon getan (zum Beispiel „Claude ganz
-  beendet und neu geöffnet" — er sitzt ja gerade in Claude), führ ihn nicht noch einmal: Frag kurz nach und bitte ihn,
-  den Schritt unter https://app.kimal3.de/kurs abzuhaken.
-- Steht dahinter **„(setzt Claude)"** und ist er offen, lass die Einrichtung noch einmal laufen — über die Anleitung
-  `https://app.kimal3.de/einrichten` (lade sie wie der Kurs-Satz und folge ihr), **nicht** mit einem frei aufgerufenen
-  `kimal3 einrichten`. Bleibt der Schritt danach offen, nenn den Grund aus der Ausgabe von `einrichten` und schlag
-  keinen dritten Lauf vor.
-
-## 4. Abgeschlossen
-- Steht in der Ausgabe `Kurs: abgeschlossen`, gratuliere kurz und frag mit einem Vorschlag, woran er hier arbeiten
-  möchte. Kein Kurs-Gerede mehr.
+---
+description: Zurück in den Mini-Kurs — da weiter, wo du aufgehört hast
+---
+
+<!-- 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. -->
+# Kurs
+
+> Zurück in den Mini-Kurs: „Wo war ich nochmal?" — macht da weiter, wo du aufgehört hast.
+> Den Stand holt `kimal3 kurs` frisch von kimal3 — dieselben Haken, die der Mensch im Browser unter
+> https://app.kimal3.de/kurs sieht.
+
+Führe die Schritte der Reihe nach aus. Bleib im Coaching-Ton: Deutsch, freundlich, ein Schritt
+nach dem anderen, das Warum vor dem Wie, null Vorwissen vorausgesetzt.
+
+## 1. Den Stand holen
+- Führ `kimal3 kurs` aus (unter Windows so, wie es `SKILL.md` beschreibt).
+- Rückgabewert **2**: Der Mensch ist nicht angemeldet. Zeig ihm `kimal3 login`, lass ihn selbst im Browser bestätigen
+  und nenn **keinen** Kursstand.
+- Rückgabewert **3**: Der Stand ist gerade nicht abrufbar. Sag es in einem Satz und **erzähl den Kurs nicht aus dem
+  Gedächtnis**.
+- Kennt das Programm den Befehl nicht, ist es zu alt: Nenn `npm install -g kimal3@latest`, danach `kimal3 skill install`.
+
+## 2. Stand in einem Satz sagen
+- Sag in **einem** Satz, wo ihr im Kurs steht — aus der Ausgabe (Zeile `Kurs:`), nichts dazuerfinden. Kein Vortrag.
+
+## 3. Als Nächstes führen
+- Die Zeile `Als Nächstes:` nennt den nächsten Schritt. Führ **einen** Schritt nach dem anderen: zeigen, machen lassen,
+  verstehen. Nie die ganze Liste auf einmal.
+- Steht dahinter **„(du hakst ab)"** und hat der Mensch den Schritt offensichtlich schon getan (zum Beispiel „Claude ganz
+  beendet und neu geöffnet" — er sitzt ja gerade in Claude), führ ihn nicht noch einmal: Frag kurz nach und bitte ihn,
+  den Schritt unter https://app.kimal3.de/kurs abzuhaken.
+- Steht dahinter **„(setzt Claude)"** und ist er offen, lass die Einrichtung noch einmal laufen — über die Anleitung
+  `https://app.kimal3.de/einrichten` (lade sie wie der Kurs-Satz und folge ihr), **nicht** mit einem frei aufgerufenen
+  `kimal3 einrichten`. Bleibt der Schritt danach offen, nenn den Grund aus der Ausgabe von `einrichten` und schlag
+  keinen dritten Lauf vor.
+
+## 4. Abgeschlossen
+- Steht in der Ausgabe `Kurs: abgeschlossen`, gratuliere kurz und frag mit einem Vorschlag, woran er hier arbeiten
+  möchte. Kein Kurs-Gerede mehr.

package/skill/commands/k3plan.md

@@ -183,7 +183,8 @@ Die App zeigt sie dem Menschen in genau diesem Wortlaut („So bleibt die Planun
 - **Regel 2 — Neues:** Was dir beim Prüfen auffällt oder der Mensch im Gespräch sagt und was
   **keine** Spec verspricht, kommt nach `themen`:
   `{ "schluessel": "T-1", "text": "…", "quelle": "claude" | "mensch", "seit": "<heute>" }`.
-  Die fünf Plätze teilen sich `themen` und die offenen Notizen aus der App.
+  Nimm die nächste freie Nummer, auch über `eingeordnet` hinweg (dort bleibt ein Schlüssel
+  14 Tage belegt). Die fünf Plätze teilen sich `themen` und die offenen Notizen aus der App.
 - **Regel 3 — einordnen:** Jedes `Thema` aus `kimal3 plan` **und** jedes Thema, das schon von
   früher in `themen` steht, ordnest du **jetzt** ein — eins von dreien:
   - **neue Story:** schreib sie in die Spec, zu der sie gehört (User Story, Akzeptanzkriterium mit
@@ -195,8 +196,11 @@ Die App zeigt sie dem Menschen in genau diesem Wortlaut („So bleibt die Planun
 
   Für eine Notiz aus der App gehört die Antwort als **ein Satz** in `uebernommen` (die App zeigt
   sie unter „Zuletzt eingeordnet" als `<Notiz> → <Antwort>`); schreib sie darum **ohne** Pfeil
-  am Anfang. Ein Thema aus der Datei nimmst du aus `themen` heraus und nennst seine Einordnung im
-  Bericht.
+  am Anfang. Ein Thema aus der Datei nimmst du aus `themen` heraus und schreibst es mit seiner
+  Antwort nach `eingeordnet`: `{ "schluessel": "T-4", "text": "<Text wie in themen>", "antwort":
+  "<ein Satz>", "am": "<heute>" }` — die App zeigt es 14 Tage lang unter „Zuletzt eingeordnet".
+  Einträge, deren `am` mehr als 14 Tage zurückliegt, nimmst du dabei heraus. Nenn die Einordnung
+  auch im Bericht.
 - **Regel 4:** Weil du bei jedem `/k3plan` alles einordnest, liegt nichts lange. Ein Thema mit
   `seit` vor mehr als 14 Tagen ordnest du **auf jeden Fall** jetzt ein.
 - **Regel 5 und 6 — keine neue Spec beginnen**, solange eine andere Spec in Arbeit ist (eine ihrer
@@ -248,12 +252,15 @@ Die App zeigt sie dem Menschen in genau diesem Wortlaut („So bleibt die Planun
   ],
   "uebernommen": [
     { "rueckmeldung": 12, "antwort": "Befund an US-2" }
+  ],
+  "eingeordnet": [
+    { "schluessel": "T-2", "text": "Export als PDF", "antwort": "gestrichen: Der Drucken-Knopf kann das schon.", "am": "2026-10-21" }
   ]
 }
 ```
 
-**Die Felder** — jedes muss da sein, auch wenn es `null` oder leer ist; ein unbekanntes Feld
-(ein Tippfehler wie `"befund"`) lehnt der Server ab:
+**Die Felder** — jedes muss da sein, auch wenn es `null` oder leer ist (nur `eingeordnet` darf
+fehlen); ein unbekanntes Feld (ein Tippfehler wie `"befund"`) lehnt der Server ab:
 
 - `format`: genau `1`.
 - `projekt`: der Name wie in der App, 1–200 Zeichen.
@@ -276,6 +283,9 @@ Die App zeigt sie dem Menschen in genau diesem Wortlaut („So bleibt die Planun
   Plätze, Regel 2).
 - `uebernommen[]`: `{ "rueckmeldung": <Nummer aus kimal3 plan>, "antwort": "<ein Satz>" }`. Leert
   `kimal3 plan hoch` nach dem Hochladen selbst.
+- `eingeordnet[]`: `{ "schluessel", "text", "antwort": "<ein Satz>", "am": "JJJJ-MM-TT" }`, höchstens
+  50 — Themen aus `themen`, die du eingeordnet hast (Regel 3). Ein Schlüssel steht nie zugleich in
+  `themen` und `eingeordnet`.
 - Die ganze Datei: höchstens 300 KB.
 
 ## 7. Hochladen
@@ -305,7 +315,8 @@ Sag dem Menschen, dass `plan/stand.json` geändert ist und in den nächsten Comm
 Danach steht eine Zeile `Spec-Texte hochgeladen: 1 von 3. Ohne Text: …` — der Text der Specs geht mit hoch.
 Eine Spec ohne Text ist ein **Hinweis, kein Fehlschlag** (Rückgabewert `0`): Nenn dem Menschen die
 Specs, die in der Klammer stehen, und was zu tun ist (Pfad in `datei` berichtigen; über 300 KB
-lässt sich nicht hochladen).
+lässt sich nicht hochladen; bei „alle Spec-Texte zusammen größer als 4 MB" ist keine Datei allein
+zu groß — die größten bleiben draußen, bis der Rest passt).
 
 **Absagen — die Meldung lesen, beheben, Probelauf, noch einmal:**
 

package/skill/en/commands/k3course.md

@@ -1,41 +1,41 @@
----
-description: Back into the Mini course — pick up where you left off
----
-
-<!-- kimal3:erzeugt — this file is maintained by `kimal3 skill install` and
-     overwritten on every update. Your own changes will be lost; if you want
-     to keep them, copy the file under a different name. -->
-# Course
-
-> Back into the Mini course: “Where was I again?” — picks up where you left off.
-> `kimal3 course` fetches the status fresh from kimal3 — the same ticks the person sees in the browser at
-> https://app.kimal3.de/kurs.
-
-Carry out the steps in order. Stay in the coaching tone: English, friendly, one step at a
-time, the why before the how, no prior knowledge assumed.
-
-## 1. Fetch the status
-- Run `kimal3 course` (on Windows the way `SKILL.md` describes).
-- Exit code **2**: the person is not signed in. Show them `kimal3 login`, let them confirm in the browser themselves
-  and name **no** course status.
-- Exit code **3**: the status can't be fetched right now. Say so in one sentence and **do not retell the course from
-  memory**.
-- If the program doesn't know the command, it is too old: name `npm install -g kimal3@latest`, then `kimal3 skill install`.
-
-## 2. Say where you stand in one sentence
-- Say in **one** sentence where you are in the course — from the output (the `Course:` line), invent nothing. No lecture.
-
-## 3. Lead on with what comes next
-- The line `Next:` names the next step. Lead on **one** step at a time: show, let them do it, make sure they understand.
-  Never the whole list at once.
-- If it says **“(you tick it off)”** after it and the person has obviously already done the step (for example “closed
-  Claude completely and reopened it” — they are sitting in Claude right now), don't lead it again: ask briefly and
-  ask them to tick it off at https://app.kimal3.de/kurs.
-- If it says **“(Claude sets it)”** and it is open, run the setup once more — through the guide
-  `https://app.kimal3.de/setup` (load it the way the course sentence does and follow it), **not** with a freely called
-  `kimal3 setup`. If the step is still open afterwards, name the reason from the output of `setup` and don't suggest
-  a third run.
-
-## 4. Finished
-- If the output says `Course: complete`, congratulate them briefly and ask, with a suggestion, what they would like to
-  work on here. No more course talk.
+---
+description: Back into the Mini course — pick up where you left off
+---
+
+<!-- kimal3:erzeugt — this file is maintained by `kimal3 skill install` and
+     overwritten on every update. Your own changes will be lost; if you want
+     to keep them, copy the file under a different name. -->
+# Course
+
+> Back into the Mini course: “Where was I again?” — picks up where you left off.
+> `kimal3 course` fetches the status fresh from kimal3 — the same ticks the person sees in the browser at
+> https://app.kimal3.de/kurs.
+
+Carry out the steps in order. Stay in the coaching tone: English, friendly, one step at a
+time, the why before the how, no prior knowledge assumed.
+
+## 1. Fetch the status
+- Run `kimal3 course` (on Windows the way `SKILL.md` describes).
+- Exit code **2**: the person is not signed in. Show them `kimal3 login`, let them confirm in the browser themselves
+  and name **no** course status.
+- Exit code **3**: the status can't be fetched right now. Say so in one sentence and **do not retell the course from
+  memory**.
+- If the program doesn't know the command, it is too old: name `npm install -g kimal3@latest`, then `kimal3 skill install`.
+
+## 2. Say where you stand in one sentence
+- Say in **one** sentence where you are in the course — from the output (the `Course:` line), invent nothing. No lecture.
+
+## 3. Lead on with what comes next
+- The line `Next:` names the next step. Lead on **one** step at a time: show, let them do it, make sure they understand.
+  Never the whole list at once.
+- If it says **“(you tick it off)”** after it and the person has obviously already done the step (for example “closed
+  Claude completely and reopened it” — they are sitting in Claude right now), don't lead it again: ask briefly and
+  ask them to tick it off at https://app.kimal3.de/kurs.
+- If it says **“(Claude sets it)”** and it is open, run the setup once more — through the guide
+  `https://app.kimal3.de/setup` (load it the way the course sentence does and follow it), **not** with a freely called
+  `kimal3 setup`. If the step is still open afterwards, name the reason from the output of `setup` and don't suggest
+  a third run.
+
+## 4. Finished
+- If the output says `Course: complete`, congratulate them briefly and ask, with a suggestion, what they would like to
+  work on here. No more course talk.

package/skill/en/commands/k3plan.md

@@ -181,6 +181,7 @@ The app shows them to the person in exactly this wording ("How planning stays sh
 - **Rule 2 — something new:** what you notice while checking, or what the person says in the
   conversation, and what **no** spec promises goes into `themen`:
   `{ "schluessel": "T-1", "text": "…", "quelle": "claude" | "mensch", "seit": "<today>" }`.
+  Take the next free number, counting `eingeordnet` too (a key stays taken there for 14 days).
   The five places are shared by `themen` and the open notes from the app.
 - **Rule 3 — sort:** every `Topic` from `kimal3 plan` **and** every topic already in `themen` from
   earlier is sorted **now** — one of three:
@@ -193,8 +194,11 @@ The app shows them to the person in exactly this wording ("How planning stays sh
 
   For a note from the app, the answer goes into `uebernommen` as **one sentence** (the app shows
   it under "Recently sorted" as `<note> → <answer>`); so write it **without** an arrow at the
-  start. A topic from the file you take out of `themen` and name how it was sorted in the
-  report.
+  start. A topic from the file you take out of `themen` and write it with its answer into
+  `eingeordnet`: `{ "schluessel": "T-4", "text": "<text as in themen>", "antwort": "<one
+  sentence>", "am": "<today>" }` — the app shows it under "Recently sorted" for 14 days. Entries
+  whose `am` is more than 14 days ago you take out at the same time. Name how it was sorted in the
+  report too.
 - **Rule 4:** because you sort everything at every `/k3plan`, nothing stays long. A topic with
   `seit` more than 14 days ago is sorted now **in any case**.
 - **Rules 5 and 6 — don't start a new spec** while another spec is in progress (one of its
@@ -245,12 +249,15 @@ The app shows them to the person in exactly this wording ("How planning stays sh
   ],
   "uebernommen": [
     { "rueckmeldung": 12, "antwort": "Finding on US-2" }
+  ],
+  "eingeordnet": [
+    { "schluessel": "T-2", "text": "Export as PDF", "antwort": "dropped: the print button already does that.", "am": "2026-10-21" }
   ]
 }
 ```
 
-**The fields** — every one must be there, even if it is `null` or empty; the server refuses an
-unknown field (a typo like `"befund"`):
+**The fields** — every one must be there, even if it is `null` or empty (only `eingeordnet` may
+be missing); the server refuses an unknown field (a typo like `"befund"`):
 
 - `format`: exactly `1`.
 - `projekt`: the name as in the app, 1–200 characters.
@@ -273,6 +280,9 @@ unknown field (a typo like `"befund"`):
   rule 2).
 - `uebernommen[]`: `{ "rueckmeldung": <number from kimal3 plan>, "antwort": "<one sentence>" }`.
   `kimal3 plan upload` empties it itself after uploading.
+- `eingeordnet[]`: `{ "schluessel", "text", "antwort": "<one sentence>", "am": "YYYY-MM-DD" }`, at
+  most 50 — topics from `themen` that you have sorted (rule 3). A key is never in `themen` and
+  `eingeordnet` at the same time.
 - The whole file: at most 300 KB.
 
 ## 7. Upload
@@ -300,7 +310,9 @@ person that `plan/stand.json` has changed and belongs in the next commit.
 
 After that comes a line `Spec texts uploaded: 1 of 3. Without text: …` — the text of the specs goes up too.
 A spec without text is a **hint, not a failure** (exit code `0`): tell the person which specs are in
-the brackets and what to do (correct the path in `datei`; over 300 KB cannot be uploaded).
+the brackets and what to do (correct the path in `datei`; over 300 KB cannot be uploaded; with
+"all spec texts together larger than 4 MB" no single file is too large — the largest stay out
+until the rest fits).
 
 **Refusals — read the message, fix it, dry run, again:**