Translate project content to English

Make English the project-wide language: all comments, string literals,
CLI help text, design docs, journal, agent prompts, and README. Only
CLAUDE.md (the user's own instruction file) stays German, and the live
conversation between user and Claude continues in German.

Adds a new "Project language: English" section to docs/DESIGN.md as
the durable convention. No logic changes — translation only. Four
internal error strings in the typechecker were retranslated; no
test asserts on their wording.

Verified: cargo test --workspace passes (44/44).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-05-07 12:17:48 +02:00
parent b1dbafc6f2
commit 7577ab8a90
21 changed files with 992 additions and 984 deletions
+34 -34
View File
@@ -1,43 +1,43 @@
# AILang-Agenten
# AILang agents
Diese Agent-Definitionen sind Teil der Projekt-Toolchain. Sie bündeln Disziplin
und Kontext, die jede Aufgabe in diesem Repo braucht (welche Designdokumente
zuerst gelesen werden, welche Tests laufen müssen, welches Output-Format zurück
kommt). Sie sind versioniert, reviewbar und veränderbar wie jeder andere
Bestandteil des Repos.
These agent definitions are part of the project toolchain. They bundle the
discipline and context that every task in this repo needs (which design
documents to read first, which tests must run, which output format comes
back). They are versioned, reviewable, and changeable like any other part of
the repo.
## Was hier liegt
## What lives here
| Agent | Rolle |
|--------------------------|----------------------------------------------------------------|
| `ailang-implementer.md` | Setzt eng abgegrenzte Implementierungsaufgaben um. |
| `ailang-architect.md` | Read-only-Reviewer; prüft Drift gegen DESIGN.md nach Iterationen. |
| `ailang-tester.md` | Schreibt Beispiele und E2E-Tests. |
| `ailang-debugger.md` | Diagnostiziert Compiler- oder Codegen-Fehler. |
| Agent | Role |
|--------------------------|-------------------------------------------------------------------|
| `ailang-implementer.md` | Carries out tightly scoped implementation tasks. |
| `ailang-architect.md` | Read-only reviewer; checks for drift against DESIGN.md after iterations. |
| `ailang-tester.md` | Writes examples and E2E tests. |
| `ailang-debugger.md` | Diagnoses compiler or codegen bugs. |
## Aufruf-Schema
## Invocation scheme
Jede `.md`-Datei besteht aus YAML-Frontmatter (`name`, `description`, `tools`)
und einem System-Prompt-Body. Es gibt zwei Wege, sie aufzurufen:
Each `.md` file consists of YAML frontmatter (`name`, `description`, `tools`)
and a system-prompt body. There are two ways to invoke them:
1. **Als Subagent (bevorzugt, wenn das Tooling es unterstützt).** Wenn die Datei
unter `~/.claude/agents/` oder `.claude/agents/` liegt, lädt Claude Code sie
als `subagent_type` und ruft sie als nativen Agenten. Diese Files hier sind
bewusst NICHT in `.claude/`, weil sie zur Projekt-Toolchain gehören und
sichtbar sein sollen. Wer das Subagent-Loading aktivieren will, kann
symlinken: `ln -s $(pwd)/agents .claude/agents`.
1. **As a subagent (preferred, when the tooling supports it).** When the file
sits under `~/.claude/agents/` or `.claude/agents/`, Claude Code loads it
as a `subagent_type` and calls it as a native agent. The files here are
deliberately NOT in `.claude/` because they belong to the project
toolchain and should be visible. Anyone who wants to enable subagent
loading can symlink: `ln -s $(pwd)/agents .claude/agents`.
2. **Als Prompt-Präfix (immer verfügbar).** Der Body der `.md`-Datei wird vor
die konkrete Aufgabenbeschreibung gehängt und an einen `general-purpose`-
Agenten gegeben. Funktional identisch zum Subagent-Aufruf, nur muss der
Aufrufer den Body explizit mitschicken.
2. **As a prompt prefix (always available).** The body of the `.md` file is
prepended to the concrete task description and handed to a
`general-purpose` agent. Functionally identical to the subagent call,
except the caller has to send the body explicitly.
## Agenten erweitern oder ändern
## Extending or changing agents
- Neue Agenten anlegen: weitere `.md`-Datei mit Frontmatter (`name`,
`description`, `tools`) und System-Prompt-Body.
- Bestehende ändern: direkter Edit, wie jeder andere Code-File. Änderungen
werden im Git-Verlauf sichtbar.
- Konvention: Frontmatter-Feld `description` ist die Ein-Satz-Beschreibung, die
ein Orchestrator liest, um zu entscheiden, ob er den Agenten ruft. Kurz und
spezifisch halten.
- New agent: another `.md` file with frontmatter (`name`, `description`,
`tools`) and system-prompt body.
- Existing agent: edit directly, like any other code file. Changes show up
in git history.
- Convention: the frontmatter `description` field is the one-sentence
description an orchestrator reads to decide whether to call the agent.
Keep it short and specific.