diff --git a/CLAUDE.md b/CLAUDE.md index 1cd7332..ecef8f8 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -194,9 +194,9 @@ is two-step and the two outputs share one text: The text must be written for the **user-as-reader who did not watch me work**: -- **Language: German.** This is a deliberate exception to the - English-only project rule, because WhatsNew is user-facing - communication, the same role German plays in our live chat. +- **Language: English.** Same as the rest of the repo; both + WhatsNew.md and the Notify push are permanent enough to be + treated as project content. - **No technical internals.** Don't name crates, function identifiers, type names, agent names, or iteration codes (`ct.1.7`, `18a`, etc.). Describe the *change in the project* @@ -208,13 +208,13 @@ watch me work**: not an essay. If the work covered multiple unrelated things, bullet them. - **Tone: factual, not performative.** No celebration, no "I have - successfully…". Just "X geht jetzt, Y ist behoben, Z ist neu". + successfully…". Just "X works now, Y is fixed, Z is new". **Bounce-backs** (asking the user for a design judgement or checkpoint) are *not* done-state and do **not** produce a WhatsNew entry — they stay as Notify-only. -Format of a WhatsNew entry: a `## YYYY-MM-DD — ` +Format of a WhatsNew entry: a `## YYYY-MM-DD — ` heading followed by the message body. The body must match the Notify text verbatim. @@ -270,12 +270,11 @@ Existing entries are not retroactively renamed. by `skills/implement`. - **`docs/WhatsNew.md`** (since 2026-05-11): the user-facing - changelog, written in German for the user-as-reader who does - not watch the implementation. Entries are appended at done-state + changelog, written for the user-as-reader who does not watch + the implementation. Entries are appended at done-state notifications and mirror the Notify text verbatim. See the "Done-state notifications" subsection above for the editorial - rules. This is the only file in the repo that is intentionally - not in English. + rules (in particular: no internals, lead with the change). Together these answer three questions: "what is the language right now?" (DESIGN), "how did we get here?" (JOURNAL, specs, plans), diff --git a/docs/WhatsNew.md b/docs/WhatsNew.md index 92472ba..adb3c02 100644 --- a/docs/WhatsNew.md +++ b/docs/WhatsNew.md @@ -1,15 +1,16 @@ -# Was ist neu in AILang +# What's New in AILang -Dies ist das benutzerlesbare Änderungsprotokoll. Es läuft parallel -zum technischen `JOURNAL.md` und ist in der gleichen Sprache verfasst, -in der wir uns unterhalten — Deutsch. +A user-facing changelog. It runs in parallel to the technical +`JOURNAL.md` and is written for the user-as-reader who did not watch +the work happen — no crate names, no iteration codes, no +implementation mechanics. -Jeder Eintrag entspricht einer Done-State-Notify, die ich an den -Benutzer geschickt habe, wenn er nicht am Rechner war. Der Text ist -identisch mit dem, was auf dem Handy ankam. Neue Einträge werden -unten angehängt. +Each entry corresponds to a done-state notification I sent to the +user when he was away. The text is identical to what arrived on his +phone. New entries are appended at the bottom. -Beschrieben wird, **was sich im Projekt geändert hat** — nicht, wie -es technisch umgesetzt wurde. Für Interna gibt es das `JOURNAL.md`. +What gets described here is **what changed in the project** — what +is now possible, fixed, or visible. For the internals, see +`JOURNAL.md`. ---