kimal3 0.4.0-durchstich.3 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,53 +1,41 @@
1
- ---
2
- description: Zurück in den Mini-Kurs — da weiter, wo du aufgehört hast
3
- ---
4
-
5
- <!-- kimal3:erzeugt — diese Datei wird von `kimal3 skill install` gepflegt und bei
6
- jedem Update ueberschrieben. Eigene Aenderungen gehen dabei verloren; wer sie
7
- behalten will, kopiert die Datei unter einem anderen Namen. -->
8
- # Kurs
9
-
10
- > Zurück in den Mini-Kurs: „Wo war ich nochmal?" — macht da weiter, wo du aufgehört hast.
11
- > (Meistens brauchst du das gar nicht: Dein Coach führt dich beim `/k3start` von allein durch
12
- > den Kurs. Das hier ist der bewusste Wiedereinstieg, wenn du zwischendurch abgebogen bist.)
13
-
14
- Führe die Schritte der Reihe nach aus. Bleib im Coaching-Ton: Deutsch, freundlich, ein Schritt
15
- nach dem anderen, das Warum vor dem Wie, null Vorwissen vorausgesetzt.
16
-
17
- ## 1. Den Kurs nachschlagen
18
- - **Liegt `kurs-beats.md` (oder `course-parts.md`) neben dir? Wenn nein, hör hier auf.** Dann hat diese Person den
19
- Mini-Kurs nicht — sag ihr freundlich in einem Satz, dass dieser Befehl zum Kurs gehört und
20
- hier nichts zu tun hat, und frag mit einem Vorschlag, woran sie stattdessen arbeiten möchte.
21
- **Fang nicht an, den Kurs aus dem Gedächtnis nachzuerzählen**, und such die Datei nicht
22
- woanders. *Der Befehl kommt seit 0.2.5 mit jedem kimal3 mit, der Kurs nicht.*
23
- - Liegt sie da: Lies `kurs-beats.md` (oder `course-parts.md`) — dort stehen die 3 Beats des Kurses, aus dem der Nutzer
24
- kommt. Das ist dein Wissen darüber; die Datei wird automatisch erzeugt, ändere sie nie von Hand.
25
-
26
- ## 2. Schauen, wie weit ihr seid
27
- - Lies `WEITER-HIER.md` (falls vorhanden) — dort steht der Kurs-Stand, z. B. „Beat 2 läuft".
28
- - **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`.
29
- - Gibt es die Datei noch nicht, ist das die erste Sitzung: Beat 1 ist dann erledigt (der Nutzer
30
- hat dich ja gerade gestartet), es geht bei **Beat 2** weiter. **Leg sie dann gleich an** —
31
- siehe `START-HIER.md` (oder `START-HERE.md`).
32
-
33
- ## 3. Stand in einem Satz sagen
34
- - Sag in **einem** Satz, wo ihr im Kurs steht — kein Vortrag, keine Wiederholung des ganzen Kurses.
35
-
36
- ## 4. Weiterführen — bis Beat 2 durch ist
37
- - Führ **einen** Schritt nach dem anderen weiter: zeigen, machen lassen, verstehen. Nie die
38
- ganze Liste auf einmal. Zieh `WEITER-HIER.md` (oder `NEXT-STEPS.md`) nach, sobald ein Beat fertig ist.
39
- - **Beat 1** (App, Konto, Plan, Start-Workspace, **Git**) passiert im Browser, **bevor** es dich
40
- gibt — den kannst du nicht führen. Er ist erledigt, sobald du läufst.
41
-
42
- ## 5. Nach Beat 2: den Umzug bauen & übergeben
43
- - Der Abschluss von Beat 2 ist der **Umzug**: Schlag Ordnername + Ort fürs erste echte
44
- Projekt vor (z. B. `Documents\Claude-Projekte\mein-erstes-projekt` — der echte Ordner heißt im Dateisystem `Documents`, auch wenn der Explorer ihn als Dokumente anzeigt; lass ihn den Ordner einmal im Explorer öffnen, bevor er Claude schließt), leg den Ordner an
45
- und hinterlege dort eine kurze **`WEITER-HIER.md`** (liegt dort schon ein `NEXT-STEPS.md`, nimm den) als Übergabe-Notiz — was geschafft
46
- ist und was als Nächstes dran ist (kleine echte Aufgabe wählen, `git init` + erster
47
- Commit, Rhythmus: durchdenken → bauen → prüfen → sichern, sichtbares Ergebnis; Schritte
48
- nebenbei im Kurs im Browser abhaken). Dann bitte ihn, Claude ganz zu schließen und im
49
- neuen Ordner neu zu öffnen (`/k3start`).
50
- - **Beat 3 führst du nicht von hier aus.** Im neuen Ordner bist du einfach sein Coach —
51
- die Notiz sagt dir, wo ihr steht. Gefeiert wird im Browser.
52
- - Ist er schon so weit (oder gar durch), sag das kurz und freundlich — und frag mit einem
53
- Vorschlag, woran er hier stattdessen arbeiten möchte. Kein Kurs-Gerede mehr.
1
+ ---
2
+ description: Zurück in den Mini-Kurs — da weiter, wo du aufgehört hast
3
+ ---
4
+
5
+ <!-- kimal3:erzeugt — diese Datei wird von `kimal3 skill install` gepflegt und bei
6
+ jedem Update ueberschrieben. Eigene Aenderungen gehen dabei verloren; wer sie
7
+ behalten will, kopiert die Datei unter einem anderen Namen. -->
8
+ # Kurs
9
+
10
+ > Zurück in den Mini-Kurs: „Wo war ich nochmal?" — macht da weiter, wo du aufgehört hast.
11
+ > Den Stand holt `kimal3 kurs` frisch von kimal3 — dieselben Haken, die der Mensch im Browser unter
12
+ > https://app.kimal3.de/kurs sieht.
13
+
14
+ Führe die Schritte der Reihe nach aus. Bleib im Coaching-Ton: Deutsch, freundlich, ein Schritt
15
+ nach dem anderen, das Warum vor dem Wie, null Vorwissen vorausgesetzt.
16
+
17
+ ## 1. Den Stand holen
18
+ - Führ `kimal3 kurs` aus (unter Windows so, wie es `SKILL.md` beschreibt).
19
+ - Rückgabewert **2**: Der Mensch ist nicht angemeldet. Zeig ihm `kimal3 login`, lass ihn selbst im Browser bestätigen
20
+ und nenn **keinen** Kursstand.
21
+ - Rückgabewert **3**: Der Stand ist gerade nicht abrufbar. Sag es in einem Satz und **erzähl den Kurs nicht aus dem
22
+ Gedächtnis**.
23
+ - Kennt das Programm den Befehl nicht, ist es zu alt: Nenn `npm install -g kimal3@latest`, danach `kimal3 skill install`.
24
+
25
+ ## 2. Stand in einem Satz sagen
26
+ - Sag in **einem** Satz, wo ihr im Kurs steht — aus der Ausgabe (Zeile `Kurs:`), nichts dazuerfinden. Kein Vortrag.
27
+
28
+ ## 3. Als Nächstes führen
29
+ - Die Zeile `Als Nächstes:` nennt den nächsten Schritt. Führ **einen** Schritt nach dem anderen: zeigen, machen lassen,
30
+ verstehen. Nie die ganze Liste auf einmal.
31
+ - Steht dahinter **„(du hakst ab)"** und hat der Mensch den Schritt offensichtlich schon getan (zum Beispiel „Claude ganz
32
+ beendet und neu geöffnet" — er sitzt ja gerade in Claude), führ ihn nicht noch einmal: Frag kurz nach und bitte ihn,
33
+ den Schritt unter https://app.kimal3.de/kurs abzuhaken.
34
+ - Steht dahinter **„(setzt Claude)"** und ist er offen, lass die Einrichtung noch einmal laufen — über die Anleitung
35
+ `https://app.kimal3.de/einrichten` (lade sie wie der Kurs-Satz und folge ihr), **nicht** mit einem frei aufgerufenen
36
+ `kimal3 einrichten`. Bleibt der Schritt danach offen, nenn den Grund aus der Ausgabe von `einrichten` und schlag
37
+ keinen dritten Lauf vor.
38
+
39
+ ## 4. Abgeschlossen
40
+ - Steht in der Ausgabe `Kurs: abgeschlossen`, gratuliere kurz und frag mit einem Vorschlag, woran er hier arbeiten
41
+ möchte. Kein Kurs-Gerede mehr.
@@ -23,11 +23,12 @@ nicht relevant, sag das kurz und überspring ihn — kein Leerlauf.
23
23
  dich für genau dieses Projekt und hat **Vorrang** vor allem, was hier unten steht.
24
24
  - Gibt es ein Status-Doc (`WEITER-HIER.md` oder `ROADMAP.md`) — eine kleine Datei, in der der
25
25
  letzte Stand und der nächste Schritt festgehalten sind? Dann lies es.
26
- - **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`.
27
- - Kein Status-Doc? **Sieh erst nach, ob ein `.git`-Ordner daneben liegt.** Wenn ja, führt dieses
26
+ - **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.**
27
+ - **Stehst du in der Werkbank selbst (`werkbank-…` oder `workbench-…`), nicht in einem Projekt?** Steht in ihrer `CLAUDE.md` der Abschnitt „Erste Sitzung“ (englisch „First session“), folge **ihm** — er hat Vorrang vor allem Folgenden. Steht er nicht (mehr) da, zeig die Projekte in `projekte/` bzw. `projects/` (ohne `beispiel-rechnungen-erfassen` und `example-capture-invoices`) mit je der **ersten Stand-Zeile** ihres Zettels, oder „noch kein Zettel“, wenn keiner da ist; ein vorhandener Werkbank-Zettel (`WEITER-HIER.md` oder `NEXT-STEPS.md`) steht darüber. Empfiehl daraus **eines** und stell **eine** Frage dazu.
28
+ - Kein Status-Doc? **Sieh erst nach, ob ein `.git`-Ordner im Zettel-Ort liegt** (im Arbeitsplatz der Projektordner, sonst der Startordner). Wenn ja, führt dieses
28
29
  Projekt eine Versionsgeschichte, und `git log --oneline -10` plus `git status` zeigen dir den
29
30
  letzten Stand.
30
- ⚠️ **Liegt kein `.git` daneben, lass beide Befehle weg.** Sie antworten dann mit
31
+ ⚠️ **Liegt dort kein `.git`, lass beide Befehle weg.** Sie antworten dann mit
31
32
  `fatal: not a git repository` — und eine Fehlermeldung als Begrüßung sieht aus, als hätte die
32
33
  Person etwas falsch gemacht. Bei einem frisch begonnenen Projekt, in dem noch nichts gesichert
33
34
  wurde, scheitert `git log` allein; `git status` läuft dort und meldet „alles sauber".
package/skill/en/SKILL.md CHANGED
@@ -24,7 +24,7 @@ route you recognise.
24
24
  | `/k3` | Where they stand — and all kimal3 commands at a glance |
25
25
  | `/k3start` | Start a session: where the project stands and what comes next |
26
26
  | `/k3wrapup` (German: `/k3feierabend`) | End a session cleanly: save the status, tidy up, summarise |
27
- | `/k3course` (German: `/k3kurs`) | Back into the Mini course — picking up where they left off |
27
+ | `/k3course` (German: `/k3kurs`) | Back into the Mini course — fetches the status with `kimal3 course` and picks up where they left off |
28
28
  | `/k3project` (German: `/k3projekt`) | Add a finished project to the success profile |
29
29
  | `/k3list` (German: `/k3liste`) | Show the projects they have added |
30
30
  | `/k3analyse` | Fetch company data and answer their question about it |
@@ -157,8 +157,7 @@ same — **because it is the right one**, not because the trap is still open.
157
157
  together — there are four different ones. Search for square brackets instead of following a list:
158
158
  a typed-out list goes out of date the moment the template grows. Ask, instead of guessing.
159
159
 
160
- ⚠️ You will usually find `[FIRMA]` already filled in — the server puts the name in when it delivers the folder.
161
- `[DATUM]` likewise. What is left are the details about the **person** in front of you.
160
+ ⚠️ You will usually find `[FIRMA]` already filled in — the server puts the name in when it delivers the folder. What is left are the details about the **person** in front of you.
162
161
 
163
162
  🔴 **Only in the workbench — nowhere else.** The top-level `CLAUDE.md` and everything in `context/` (`kontext/` in a German company)
164
163
  belong to the **company**, not to the person in front of you. The server puts in the company name
@@ -357,6 +356,11 @@ a legal right of co-determination over it. That is for the company to decide, no
357
356
  - “If you were running the company, what would you automate next, measured against what has
358
357
  worked so far — and which of it can be carried over to other departments?”
359
358
 
359
+ ## Reading the course status (`kimal3 course`)
360
+ Shows where the person stands in the Mini course: one line per part, `Next:` with the next step and, behind it, who ticks
361
+ it off — "(you tick it off)" or "(Claude sets it)". Exit code `2` means not signed in, `3` not reachable — then **do not
362
+ retell the course from memory**. The slash command `/k3course` leads through it.
363
+
360
364
  ## Exit codes
361
365
  `0` done · `1` **Retrying won't help — READ THE MESSAGE** · `2` sign-in missing ·
362
366
  `3` temporary problem, retry once · `4` signed in, but no Pro access —
@@ -1,54 +1,41 @@
1
- ---
2
- description: Back into the Mini course — pick up where you left off
3
- ---
4
-
5
- <!-- kimal3:erzeugt — this file is maintained by `kimal3 skill install` and
6
- overwritten on every update. Your own changes will be lost; if you want
7
- to keep them, copy the file under a different name. -->
8
- # Course
9
-
10
- > Back into the Mini course: “Where was I again?” — picks up where you left off.
11
- > (Most of the time you won't need this: your coach takes you through the course on its own
12
- > when you run `/k3start`. This is the deliberate way back in if you got sidetracked along the way.)
13
-
14
- Carry out the steps in order. Stay in the coaching tone: English, friendly, one step at a
15
- time, the why before the how, no prior knowledge assumed.
16
-
17
- ## 1. Look up the course
18
- - **Is there a `course-parts.md` (or `kurs-beats.md`) next to you? If not, stop here.** Then this person does not have the
19
- Mini course — tell them kindly in one sentence that this command belongs to the course and
20
- isn't needed here, and ask, with a suggestion, what they would like to work on instead.
21
- **Do not start retelling the course from memory**, and do not look for the file
22
- anywhere else. *Since 0.2.5 the command comes with every kimal3, but the course does not.*
23
- - If it is there: read `course-parts.md` (or `kurs-beats.md`) — it holds the 3 parts of the course the person
24
- comes from. That is your knowledge of it; the file is generated automatically, never change it by hand.
25
- - If only `kurs-beats.md` is there (a German course folder): carry on in English with the content of that file — the course text in the browser is in English for this person, and a “Beat” there is a “Part” here.
26
-
27
- ## 2. See how far you have got
28
- - Read `NEXT-STEPS.md` (if it exists) — it holds the course status, for example “Part 2 in progress”.
29
- - **The status file is called `NEXT-STEPS.md` — or `WEITER-HIER.md` if the folder was created in German.** If one exists, use it. If both exist, ask which one applies and write to neither until you have the answer. If one has to be created: inside `workbench-…` it is `NEXT-STEPS.md`, inside `werkbank-…` it is `WEITER-HIER.md`, anywhere else `NEXT-STEPS.md`.
30
- - If the file doesn't exist yet, this is the first session: Part 1 is then done (the person
31
- has just started you, after all), and it carries on at **Part 2**. **Create it straight away** —
32
- see `START-HERE.md` (or `START-HIER.md`).
33
-
34
- ## 3. Say where you stand in one sentence
35
- - Say in **one** sentence where you are in the course — no lecture, no repeat of the whole course.
36
-
37
- ## 4. Carry on — until Part 2 is done
38
- - Lead on **one** step at a time: show, let them do it, make sure they understand. Never the
39
- whole list at once. Update `NEXT-STEPS.md` (or `WEITER-HIER.md`) as soon as a part is finished.
40
- - **Part 1** (app, account, plan, Start-Workspace, **Git**) happens in the browser, **before** you
41
- exist — you can't lead it. It is done as soon as you are running.
42
-
43
- ## 5. After Part 2: build the move & hand over
44
- - The end of Part 2 is the **move**: suggest a folder name + location for the first real
45
- project (for example `Documents\Claude-Projects\my-first-project` — the real folder is called `Documents` in the file system, even if Explorer shows it under a translated name; have them open the folder once in Explorer before closing Claude), create the folder
46
- and put a short **`NEXT-STEPS.md`** there (if there is already a `WEITER-HIER.md`, use that) as a handover note — what has been done
47
- and what comes next (pick a small real task, `git init` + first
48
- commit, rhythm: think it through → build → check → save, a visible result; tick off the steps
49
- in the course in the browser as you go). Then ask them to close Claude completely and reopen it in the
50
- new folder (`/k3start`).
51
- - **You don't lead Part 3 from here.** In the new folder you are simply their coach —
52
- the note tells you where you stand. The celebrating happens in the browser.
53
- - If they are already that far (or even finished), say so briefly and kindly — and ask, with a
54
- suggestion, what they would like to work on here instead. No more course talk.
1
+ ---
2
+ description: Back into the Mini course — pick up where you left off
3
+ ---
4
+
5
+ <!-- kimal3:erzeugt — this file is maintained by `kimal3 skill install` and
6
+ overwritten on every update. Your own changes will be lost; if you want
7
+ to keep them, copy the file under a different name. -->
8
+ # Course
9
+
10
+ > Back into the Mini course: “Where was I again?” — picks up where you left off.
11
+ > `kimal3 course` fetches the status fresh from kimal3 — the same ticks the person sees in the browser at
12
+ > https://app.kimal3.de/kurs.
13
+
14
+ Carry out the steps in order. Stay in the coaching tone: English, friendly, one step at a
15
+ time, the why before the how, no prior knowledge assumed.
16
+
17
+ ## 1. Fetch the status
18
+ - Run `kimal3 course` (on Windows the way `SKILL.md` describes).
19
+ - Exit code **2**: the person is not signed in. Show them `kimal3 login`, let them confirm in the browser themselves
20
+ and name **no** course status.
21
+ - Exit code **3**: the status can't be fetched right now. Say so in one sentence and **do not retell the course from
22
+ memory**.
23
+ - If the program doesn't know the command, it is too old: name `npm install -g kimal3@latest`, then `kimal3 skill install`.
24
+
25
+ ## 2. Say where you stand in one sentence
26
+ - Say in **one** sentence where you are in the course — from the output (the `Course:` line), invent nothing. No lecture.
27
+
28
+ ## 3. Lead on with what comes next
29
+ - The line `Next:` names the next step. Lead on **one** step at a time: show, let them do it, make sure they understand.
30
+ Never the whole list at once.
31
+ - If it says **“(you tick it off)”** after it and the person has obviously already done the step (for example “closed
32
+ Claude completely and reopened it” — they are sitting in Claude right now), don't lead it again: ask briefly and
33
+ ask them to tick it off at https://app.kimal3.de/kurs.
34
+ - If it says **“(Claude sets it)”** and it is open, run the setup once more — through the guide
35
+ `https://app.kimal3.de/setup` (load it the way the course sentence does and follow it), **not** with a freely called
36
+ `kimal3 setup`. If the step is still open afterwards, name the reason from the output of `setup` and don't suggest
37
+ a third run.
38
+
39
+ ## 4. Finished
40
+ - If the output says `Course: complete`, congratulate them briefly and ask, with a suggestion, what they would like to
41
+ work on here. No more course talk.
@@ -23,11 +23,12 @@ say so briefly and skip it — no filler.
23
23
  you for exactly this project and **takes priority** over everything below.
24
24
  - Is there a status file (`NEXT-STEPS.md` or `ROADMAP.md`) — a small file in which the
25
25
  latest status and the next step are written down? Then read it.
26
- - **The status file is called `NEXT-STEPS.md` — or `WEITER-HIER.md` if the folder was created in German.** If one exists, use it. If both exist, ask which one applies and write to neither until you have the answer. If one has to be created: inside `workbench-…` it is `NEXT-STEPS.md`, inside `werkbank-…` it is `WEITER-HIER.md`, anywhere else `NEXT-STEPS.md`.
27
- - No status file? **First check whether there is a `.git` folder next to it.** If there is, this
26
+ - **Where the status file lives and what it is called.** The project rule applies **only inside a workplace**: if a folder `projects/` or `projekte/` sits directly in a folder `workbench-…` or `werkbank-…` (both spellings occur, also mixed) and the session is in or under a folder in it, that **project folder** is the place. Name there: under `projects/` it is `NEXT-STEPS.md`, under `projekte/` `WEITER-HIER.md`. **Everywhere else** (starter package, your own repos, even a folder `~/projects/my-repo`) it stays as before: the file lives in the folder you started in; if one exists, use it; if one has to be created, it is called `NEXT-STEPS.md` — or `WEITER-HIER.md` if the folder was created in German. If both exist, ask which one applies and write to neither until you have the answer. **Which one applies (in a workplace):** if the project has one, the project's applies. Otherwise an existing workbench note (`workbench-…/NEXT-STEPS.md` or `werkbank-…/WEITER-HIER.md` from the old template) applies — you keep reading and maintaining it. If neither exists, it is created **in the project**. **Never create a new status file in the workbench.**
27
+ - **Are you in the workbench itself (`workbench-…` or `werkbank-…`), not inside a project?** If its `CLAUDE.md` has the section “First session” (German: “Erste Sitzung”), follow **it** — it takes priority over everything below. If it isn't there (any more), show the projects in `projects/` or `projekte/` (without `example-capture-invoices` and `beispiel-rechnungen-erfassen`) with the **first status line** of each one's status file, or “no status file yet” if there is none; an existing workbench note (`NEXT-STEPS.md` or `WEITER-HIER.md`) goes above them. Recommend **one** of them and ask **one** question about it.
28
+ - No status file? **First check whether there is a `.git` folder where the status file would live** (in a workplace the project folder, otherwise the folder you started in). If there is, this
28
29
  project keeps a version history, and `git log --oneline -10` plus `git status` show you the
29
30
  latest state.
30
- ⚠️ **If there is no `.git` next to it, leave both commands out.** They then answer with
31
+ ⚠️ **If there is no `.git` there, leave both commands out.** They then answer with
31
32
  `fatal: not a git repository` — and an error message as a greeting looks as if the
32
33
  person did something wrong. In a freshly started project where nothing has been saved
33
34
  yet, `git log` fails on its own; `git status` runs there and reports “nothing to commit”.
@@ -24,10 +24,9 @@ The status file (`NEXT-STEPS.md` or `ROADMAP.md`) is the note for the next start
24
24
  useful as long as it can be read in one go. **Every wrap-up adds something to it —
25
25
  so every wrap-up also has to clear something out**, otherwise it grows until nobody reads it any more.
26
26
 
27
- **The status file is called `NEXT-STEPS.md` — or `WEITER-HIER.md` if the folder was created in German.** If one exists, use it. If both exist, ask which one applies and write to neither until you have the answer. If one has to be created: inside `workbench-…` it is `NEXT-STEPS.md`, inside `werkbank-…` it is `WEITER-HIER.md`, anywhere else `NEXT-STEPS.md`.
27
+ **Where the status file lives and what it is called.** The project rule applies **only inside a workplace**: if a folder `projects/` or `projekte/` sits directly in a folder `workbench-…` or `werkbank-…` (both spellings occur, also mixed) and the session is in or under a folder in it, that **project folder** is the place. Name there: under `projects/` it is `NEXT-STEPS.md`, under `projekte/` `WEITER-HIER.md`. **Everywhere else** (starter package, your own repos, even a folder `~/projects/my-repo`) it stays as before: the file lives in the folder you started in; if one exists, use it; if one has to be created, it is called `NEXT-STEPS.md` — or `WEITER-HIER.md` if the folder was created in German. If both exist, ask which one applies and write to neither until you have the answer. **Which one applies (in a workplace):** if the project has one, the project's applies. Otherwise an existing workbench note (`workbench-…/NEXT-STEPS.md` or `werkbank-…/WEITER-HIER.md` from the old template) applies — you keep reading and maintaining it. If neither exists, it is created **in the project**. **Never create a new status file in the workbench.**
28
28
 
29
- If there is no status file and the work is growing beyond one session: suggest one,
30
- then carry on with step 3.
29
+ **In a workplace** you write into the status file of the project you worked on today — if it is missing and there is no workbench note either, create it in the project. **After a pure profile session** (“Who works here” filled in, no project yet) you write **no** status file; instead say that next time it continues with “First session” in the workbench `CLAUDE.md` — then carry on with step 3. **Outside a workplace** it stays as before: if there is no status file and the work is growing beyond one session, suggest one, then carry on with step 3.
31
30
 
32
31
  1. **Update:** set “Where we stand” and “next step” to what happened today.
33
32
  2. **Clear out what no longer applies.** Into the archive goes:
@@ -38,7 +37,7 @@ then carry on with step 3.
38
37
  What stays: the current status, the next step, the open items, and for each idea for later
39
38
  **at most two sentences** — anything longer gets its own file, which the status file links to.
40
39
  3. **Into the archive means: move, not delete.** If there is already an archive (usually named in the head of
41
- the status file — the AI Workplace template uses `archive/next-steps-archive.md`), use it; otherwise create next to `NEXT-STEPS.md` a `NEXT-STEPS-archive.md`, next to `WEITER-HIER.md` a `WEITER-HIER-archiv.md`. Append at the bottom, with
40
+ the status file), use it; otherwise create next to `NEXT-STEPS.md` a `NEXT-STEPS-archive.md`, next to `WEITER-HIER.md` a `WEITER-HIER-archiv.md`. Append at the bottom, with
42
41
  today's date as the heading, **word for word** — the why behind earlier decisions should
43
42
  stay findable.
44
43
  4. **Measure, don't estimate:** count the lines of the status file **before and after**. If its