# AILang-Agenten

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.

## Was hier liegt

| 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.                  |

## Aufruf-Schema

Jede `.md`-Datei besteht aus YAML-Frontmatter (`name`, `description`, `tools`)
und einem System-Prompt-Body. Es gibt zwei Wege, sie aufzurufen:

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`.

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.

## Agenten erweitern oder ändern

- 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.