# Wie Agenten aktiviert werden: Namen, Rollen, Trigger und Chat-Befehle

> Rufe einen Agenten beim Namen, nutze Menücodes, lass Rollen über drei Trigger-Ebenen selbst wechseln und nutze bmad-help, autopilot und parallel. Was du prüfst, wenn ein Agent nicht antwortet.

Canonical: https://bmad-plus.rochetta.fr/de/docs/agents/agents-activation/
Language: de
BMAD+ version: 0.23.1
Documentation reviewed: 2026-10-19
Author: Laurent Rochetta
License: MIT

BMAD+ Dokumentation › [Agenten](https://bmad-plus.rochetta.fr/de/docs/agents/) › Wie Agenten aktiviert werden: Namen, Rollen, Trigger und Chat-Befehle

Die Installation von BMAD+ schreibt die Agenten in dein Projekt; einen zu aktivieren heißt einfach, mit deinem KI-Coding-Werkzeug zu sprechen. Es gibt keinen Prozess zu starten. Du sagst den Namen eines Agenten, dein Werkzeug lädt dessen Anweisungen, und der Agent begrüßt dich und arbeitet. Diese Seite erklärt, wie du einen Agenten rufst, wie ein Agent selbst die Rolle wechselt (und wie du das stoppst), was die Chat-Wörter `bmad-help`, `autopilot` und `parallel` tun und was du prüfst, wenn nichts antwortet.

<a id="call-by-name"></a>
## Einen Agenten rufen

- Mit Namen, gefolgt von der Aufgabe: `Atlas, analysiere den Markt für KI-Notiz-Apps.` Der Name kann jeden Satz eröffnen; auch ein Persona-Name funktioniert (`Miriam`, `Oholiab`, `Atelier`).
- Per Menücode, nachdem du den Agenten gerufen hast: Jeder Agent zeigt ein Menü mit Zwei-Buchstaben-Codes (`PR` für ein PRD bei Atlas, `CA` für eine Architektur bei Forge, `RG` für das Abnahme-Gate bei Sentinel, `AP` für den Autopilot bei Nexus). Ein Code, eine Zeilennummer oder eine ähnliche Beschreibung funktionieren, und der Agent ruft die Fähigkeit unter ihrem registrierten Namen auf, statt eine zu erfinden.
- Per Befehlswort bei den Packs, die eines definieren: `/seo …` (SEO / GEO) und `/design …` (Design) tippst du im Chat, und der Skill des Packs leitet sie weiter; dein Werkzeug registriert sie nicht als Slash-Befehle, eine normale Anfrage funktioniert also ebenso. `/backup`, `/backup-list`, `/backup-restore` und `/backup-clean` sind die vier Menüeinträge von Backup Manager. Das Animated-Pack hat keines: Beschreibe die Aufgabe, zum Beispiel `animated website from hero.mp4`.
- Per Dev-Studio-Workflow-ID: Nenne Persona und Workflow (`Yosef, validate-prd für docs/prd.md`). Jeder Workflow hört auch auf `bmad-<id>` und `bmad-plus-<id>`.

Beim ersten Aufruf liest ein Agent `_bmad/config.yaml` für deinen Namen, deine Kommunikationssprache, den Ausführungsmodus und die zwei Schalter unten, lädt eine `project-context.md` und die Rollen-Trigger, wenn er sie findet, begrüßt dich in deiner Sprache und zeigt sein Menü. Atlas, Shadow und Maker halten dann an und warten auf deine Wahl; bei ihnen nennst du die Aufgabe erneut oder wählst einen Menücode, falls nur das Menü zurückkommt. Forge, Sentinel, Nexus und Atelier machen weiter, wenn deine Anfrage schon klar ist, wie in den Beispielen unten, denn eine Begrüßung ist keine zweite Bestätigung; sie warten nur dann auf eine Auswahl, wenn du sie ohne Aufgabe gerufen hast.

<a id="example-agents-activation-by-name"></a>
### Einen Agenten mit klarer Aufgabe rufen

Die kürzeste Form: Name, Komma, Aufgabe.

**In deinem KI-Assistenten**

```text
Forge, untersuche, warum das Speichern einer geänderten Rechnung ein Duplikat erzeugt. Reproduziere das Problem, verfolge die Ursache und schlage die kleinste Korrektur vor.
```

**Das solltest du erhalten** Forge antwortet in deiner Kommunikationssprache und arbeitet je nach Formulierung als Developer oder Architect. Er berichtet den reproduzierten Fehler, die Ursache und eine gezielte Korrektur und trennt fehlgeschlagene, übersprungene und nicht ausgeführte Prüfungen.

<a id="example-agents-activation-menu-code"></a>
### Einen Menücode nutzen

Codes gelten je Agent: Dieselben zwei Buchstaben können bei verschiedenen Agenten Verschiedenes bedeuten (`CA` erstellt bei Forge eine Architektur und bei Maker einen Agenten; `QA` erzeugt bei Sentinel Tests und bei Maker einen Schnell-Agenten).

**In deinem KI-Assistenten**

```text
Sentinel, RG
```

**Das solltest du erhalten** Sentinel führt die Fähigkeit hinter `RG` aus: das Abnahme-Gate des menschlichen Protokolls berechnen und seinen Verifizierer für Nexus ausgeben. Er antwortet passed, failed, awaiting oder stale, mit Gründen, und markiert nie einen nicht durchgeführten Schritt als bestanden.

<a id="role-switching"></a>
## Rollen und automatischer Wechsel

Die meisten Agenten haben mehrere Rollen. Atlas ist Analyst und Product Manager; Forge Architect, Developer und Tech Writer; Sentinel QA Engineer, UX Reviewer und eine Recette-Rolle (menschliche Abnahme); Nexus Scrum Master, Quick Flow, Autopilot Controller und Parallel Supervisor. Ist `auto_role_activation` true (Standard), wechselt der Agent die Rolle selbst, wenn das Gespräch zu einer anderen passt, und sagt es vorher: „I’m switching to [Role] mode — [reason]. Say skip to stay in current mode.“ Antworte `skip`, und er bleibt. Du kannst eine Rolle auch ausdrücklich anfordern.

<a id="three-levels"></a>
### Die drei Trigger-Ebenen

**Wie eine Rolle gewählt wird**

| Ebene | Signal | Beispiel |
| --- | --- | --- |
| 1, Muster | Stichwörter in deiner Anfrage | Das Wort architecture schickt Forge in seine Architect-Rolle |
| 2, Kontexte | Während der Arbeit erkannte Situationen | Eine Änderung an mehr als fünf Dateien (`multi_file_change_gt_5`) ruft die Architect-Rolle; ein Release-Kandidat in einer Testumgebung ruft Sentinels Recette-Rolle |
| 3, Schlussfolgerung | Beim Ausführen gemachte Entdeckungen | Beim Programmieren zeigt sich ein Architekturproblem (`implementation_exposes_architectural_issue`), und die Architect-Rolle kehrt zurück |

**Beispiel-Stichwörter je Agent aus role-triggers.yaml**

| Agent | Standardrolle | Rollen und Beispiel-Stichwörter |
| --- | --- | --- |
| Atlas | `pm` | `analyst`: `analyze`, `research`, `market`, `benchmark`, `SWOT`, `stakeholder`; `pm`: `PRD`, `product brief`, `roadmap`, `MVP`, `user story` |
| Forge | `dev` | `architect`: `architecture`, `API`, `schema`, `stack`, `database`, `migration`; `dev`: `implement`, `code`, `build`, `fix`, `refactor`; `tech-writer`: `document`, `README`, `changelog`, `mermaid` |
| Sentinel | `qa` | `qa`: `test`, `review`, `bug`, `edge case`, `coverage`; `ux-review`: `UX`, `responsive`, `accessibility`, `usability`; `uat`: `recette`, `UAT`, `acceptance test`, `what should I check` |
| Nexus | `scrum-master` | `scrum-master`: `sprint`, `story`, `backlog`, `epic`; `quick-flow`: `quick`, `hotfix`, `simple`, `patch`; `autopilot`: `autopilot`, `full pipeline`, `from scratch`; `parallel-supervisor`: `parallel`, `concurrent`, `batch` |
| SEO Scout, Chief, Judge | `seo-chief` | `seo-chief`: `SEO`, `SERP`, `meta tags`; `seo-scout`: `crawl`, `sitemap`, `robots.txt`, `core web vitals`; `seo-judge`: `E-E-A-T`, `PageSpeed`, `CrUX`, `quality gate` |
| Atelier | `design-engine` | `Atelier`, `/design`, `design tokens`, `maquette`, `wireframe`, `landing page`, `make it look good`, `accessibility`, `redesign` |

Die Stichwörter enthalten französische und englische Wörter (zum Beispiel „recherche“, „marché“, „rapide“, „refonte“), sodass eine Anfrage in beiden Sprachen dieselben Rollen auslöst. Die vollständigen Listen stehen in `.agents/data/role-triggers.yaml`, die du lesen kannst. Beachte, dass die Datei Product Manager als Standardrolle von Atlas nennt, während Atlas’ eigene Anweisungen Analyst als Standard für Recherche und Discovery bezeichnen.

<a id="example-agents-activation-auto-role-skip"></a>
### Einen automatischen Rollenwechsel sehen und ablehnen

Beginne in Atlas’ Standardrolle (Product Manager in `role-triggers.yaml`) und nutze dann ein Recherche-Wort. Der Wechsel wird vor dem Vollzug angekündigt.

**In deinem KI-Assistenten**

```text
Atlas, vergleiche unsere Preise mit denen der drei wichtigsten Wettbewerber und erstelle zu jedem eine SWOT-Analyse.
```

**Das solltest du erhalten** Atlas begrüßt dich und zeigt zuerst sein Menü, da er bei der Aktivierung wartet; sende die Anfrage erneut, falls nur das Menü zurückkommt. Die Wörter benchmark und SWOT passen zu den Analyst-Mustern, also kündigt Atlas den Wechsel in den Analyst-Modus mit Begründung an und bietet an, im aktuellen Modus zu bleiben, wenn du skip antwortest. Antwortest du skip, macht er als Product Manager weiter und die Analyse wird entsprechend gerahmt.

<a id="example-agents-activation-explicit-role"></a>
### Eine Rolle ausdrücklich anfordern

Nützlich, wenn du eine Rolle willst, die der Wortlaut nicht auslösen würde, oder wenn der automatische Wechsel aus ist.

**In deinem KI-Assistenten**

```text
Sentinel, wechsle in deine UX-Reviewer-Rolle und prüfe den Bezahlablauf auf Tastaturzugang und Fehlerzustände.
```

**Das solltest du erhalten** Sentinel arbeitet für die ganze Antwort als UX Reviewer. Ist das Design-Pack installiert, gehört das Urteil zu visuellem Design und Barrierefreiheit Atelier, und Sentinel übergibt diese Punkte.

**Um den automatischen Wechsel zu stoppen, setze ihn in _bmad/config.yaml auf false**

```yaml
auto_role_activation: false

```

<a id="chat-words"></a>
## Die Chat-Wörter: bmad-help, autopilot, parallel

Drei Formulierungen sind Anweisungen an deinen Assistenten, keine Terminalbefehle. In einer Shell getippt, bewirken sie nichts.

**Chat-Wörter**

| Sage | Wirkung |
| --- | --- |
| `bmad-help` | Zeigt die installierten Agenten und Workflows und empfiehlt einen nächsten Schritt. Mit Dev Studio ist es auch ein Workflow von Miriam. |
| `autopilot` | Startet Nexus im Voll-Pipeline-Modus: Discovery, Build und Ship mit Checkpoints, nach dem Intake jedes beteiligten Packs. |
| `parallel` | Bittet Nexus, unabhängige Aufgaben zu erkennen und parallel zu überwachen; echte Parallelität hängt von deinem Host-Werkzeug ab. |

<a id="example-agents-activation-autopilot"></a>
### Nexus ein ganzes Projekt anvertrauen

Welche Halte auf dich warten, bestimmt `checkpoints` in `_bmad/config.yaml`. Der Wert `execution_mode` legt die Startrolle von Nexus fest: manual startet ihn als Scrum Master, autopilot als Autopilot Controller; hybrid hat keine eigene Startrolle.

**In deinem KI-Assistenten**

```text
autopilot. Das Projekt: ein Kundenportal, in dem Kunden ihre Rechnungen herunterladen und Support-Tickets öffnen. Halte beim PRD und bei der Architektur an.
```

**Das solltest du erhalten** Nexus wird zum Autopilot Controller und führt die Pipeline aus: Discovery mit Atlas (und Sentinels UX-Spezifikation), ein Checkpoint beim PRD, Build mit Forge, ein Checkpoint bei der Architektur, dann Stories, Tests und Ship. Mit `execution_mode: autopilot` meldet er, dass der Autopilot aktiv ist. Mit den Standardwerten von `checkpoints` gelten zwei weitere Halte: Jede fertige Story wird nur gemeldet (`story` ist im Autopilot-Modus `notify_only`), und die Endlieferung wartet auf deine Freigabe (`delivery`).

<a id="example-agents-activation-parallel"></a>
### Unabhängige Arbeit aufteilen

Unabhängige Stories ohne gemeinsame Dateien können parallel laufen; abhängige, Änderungen an derselben Datei, Architektur vor Code und Review vor Merge bleiben sequenziell.

**In deinem KI-Assistenten**

```text
Nexus, teile die freigegebene Arbeit in unabhängige Aufgaben. Gib jeder Rolle einen Umfang, zugehörige Dateien und eine Definition von fertig. Nutze parallele Agenten nur, wenn dieser Host sie unterstützt; sonst führe die Aufgaben nacheinander aus. Führe die Ergebnisse zusammen und lass Sentinel den ganzen Nutzerablauf prüfen.
```

**Das solltest du erhalten** Abgegrenzte Aufträge, explizite Abhängigkeiten und ein zusammengeführtes Review. Parallele Ausführung kommt vom Host-Werkzeug; kann es keine unabhängigen Agenten erzeugen, sagt Nexus das und arbeitet die Aufgaben nacheinander ab. Für eine dauerhafte Aufzeichnung von Versuchen und unabhängigen Prüfungen kann Nexus `bmad-plus nexus` nutzen.

<a id="execution-modes"></a>
## Ausführungsmodus und Checkpoints

**Einstellungen, die die Aktivierung prägen**

| Schlüssel in _bmad/config.yaml | Werte | Wirkung |
| --- | --- | --- |
| `execution_mode` | `manual`, `autopilot`, `hybrid` | Manual: du rufst die Agenten. Autopilot: Nexus steuert die Pipeline. Hybrid: vom Installer als Autopilot mit häufigen Checkpoints angeboten; die Anweisungen von Nexus definieren dafür kein Verhalten über die Werte von `checkpoints` hinaus. Wird bei der Installation mit `--mode` gesetzt; nur autopilot setzt `story` auf `notify_only`, die anderen Modi verlangen auch dort eine Freigabe. |
| `auto_role_activation` | `true`, `false` | Ob Agenten die Rolle selbst wechseln. |
| `parallel_execution` | `true`, `false` | Ob Nexus unabhängige Aufgaben parallel ausführen darf. |
| `checkpoints` | `discovery`, `architecture`, `story`, `delivery`: `require_approval`, `notify_only`, `auto` | Ob jede Phase für deine Freigabe anhält, nur meldet oder weitermacht und protokolliert. |

<a id="cohabitation"></a>
## Wenn zwei Agenten antworten könnten

- Core und Dev Studio überschneiden sich (Atlas und Miriam, Forge und Bezalel, Sentinel und Oholiab, Nexus und Oholiab bei Sprints). Beide können nebeneinander bestehen; es antwortet der, den du nennst.
- Design überschneidet sich mit Sentinels UX-Review und Rachel. Seine Auslösewörter sind bewusst eng (Atelier, /design, design tokens, maquette, wireframe, landing page, make it look good, Barrierefreiheit, Redesign): Die bloßen Wörter design, UI und interface gehören weiter Forge in der Architect-Rolle und Sentinels UX-Review. Ist Design installiert, bestimmen seine Regeln visuelles Design und Barrierefreiheit.
- Die SEO-Agenten (Scout, Chief, Judge) haben eigene Auslösewörter und leiten auch `/seo`-Befehlswörter weiter.

<a id="not-responding"></a>
## Wenn ein Agent nicht antwortet

1. **Den Assistenten im installierten Projekt öffnen** Das Werkzeug muss in dem Ordner laufen, in dem BMAD+ installiert wurde, damit es `AGENTS.md` und seine Adapterdatei (zum Beispiel `CLAUDE.md` oder `GEMINI.md`) lädt.
2. **Prüfen, ob die Dateien existieren** Nötig sind `AGENTS.md` im Projektstamm und der Ordner `.agents/skills/`. Wurde bei der Installation kein Adapter gewählt, starte die Installation mit `--tools` erneut.

   ```sh
   npx bmad-plus install --tools claude-code --yes
   ```
3. **Die Sitzung neu starten** Viele Werkzeuge lesen Projektanweisungen nur beim Sitzungsstart. Öffne eine neue Sitzung und sage den Namen des Agenten erneut.
4. **Die Diagnose ausführen** Sie prüft die Installation und nennt fehlende oder geänderte Dateien.

   ```sh
   npx bmad-plus doctor
   ```

> **Hinweis · Was die Aktivierung nicht tut** Ein Agent ist ein Satz von Anweisungen, denen dein Werkzeug folgt. Im Hintergrund läuft nichts, es gibt keinen Scheduler, und parallele Agenten, Browsen und Befehlsausführung gibt es nur, wenn dein Host-Werkzeug sie bietet. Berechtigungen und Modell kommen von diesem Werkzeug.

**Siehe auch**

- [Liste aller 48 Agenten](https://bmad-plus.rochetta.fr/de/docs/agents/agents-roster/)
- [Core-Pack](https://bmad-plus.rochetta.fr/de/docs/packs/core/)
- [Konfigurationsdatei](https://bmad-plus.rochetta.fr/de/docs/reference/config-yaml/)
- [Unterstützte Werkzeuge und Adapter](https://bmad-plus.rochetta.fr/de/docs/reference/adapters/)
- [Nexus und Orchestrierung](https://bmad-plus.rochetta.fr/de/docs/concepts/nexus-orchestration/)
- [Fehlerbehebung](https://bmad-plus.rochetta.fr/de/docs/faq/troubleshooting/)

[BMAD+ Dokumentation](https://bmad-plus.rochetta.fr/de/docs/) · [Agenten](https://bmad-plus.rochetta.fr/de/docs/agents/)

[Quellcode auf GitHub](https://github.com/lrochetta/BMAD-PLUS)