Brummel
44243a515e
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.
44 lines
2.2 KiB
Markdown
44 lines
2.2 KiB
Markdown
# 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.
|