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:
+34
-34
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user