Files
AILang/agents/README.md
T
Brummel 44243a515e Agenten als Toolchain-Bestandteil + Ökosystem-Notiz
Vier spezialisierte Agent-Definitionen (implementer, architect, tester,
debugger) im sichtbaren agents/-Verzeichnis. DESIGN.md erweitert um den
Abschnitt "Projekt-Ökosystem" — AILang ist Sprache + CLI + Examples +
Agents + Doku + Tests gleichermaßen. JOURNAL hält den Workflow-Wechsel
auf Orchestrator-Modus fest und ordnet Iteration 4 neu.
2026-05-07 11:02:24 +02:00

2.2 KiB

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.