Files
2026-09-02 00:10:23 +02:00

82 lines
4.5 KiB
Markdown

# Agent-Infrastruktur der Kampagne „Morgendämmerung"
Diese Agents sind **Workflows**: mehrschrittige Abläufe, die konkrete Arbeit an Sub-Agents
delegieren. Standards stehen in `AGENTS.md`, wiederkehrende Einzelaufgaben in den Skills.
## Architektur
```
┌──────────────────────────────┐
│ dnd-orchestrator (Router) │ DeepSeek V4 Pro
│ erkennt den Use Case │
└──────────────┬───────────────┘
┌────────────────────────┼────────────────────────┐
▼ ▼ ▼
┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐
│ dnd-session-lead │ │ dnd-content-lead │ │ dnd-lore-lead │
│ Session-Workflow │ │ Content-Workflow │ │ Pflege-Workflow │
└────────┬─────────┘ └────────┬─────────┘ └────────┬─────────┘
└───────────────┬───────┴───────────────┬───────┘
▼ ▼
┌───────────────────────────────┐ ┌──────────────────────┐
│ General Sub-Agents (Flash) │ │ dnd-creative │
│ reader · writer · organizer │ │ (nur Ideen) │
└───────────────────────────────┘ └──────────────────────┘
```
## Die drei Workflows
### 1. `dnd-session-lead` — Session-Notizen verarbeiten
- Rohe Notizen aus `00-Inbox/` (Datum im Dateinamen oder Inhalt) finden.
- Passendes Prep (`01-Sessions/Episode XX.md`) zuordnen.
- **Sitzungsbericht** erstellen: vorheriges Prep + Notizen kombinieren.
- **Nächste Session** vorbereiten (`Episode XX+1.md`) auf Basis der offenen
Quests, Charaktere und Handlungsstränge.
### 2. `dnd-content-lead` — Neues erfinden
- Neue NSCs / Quests / Orte / Items / Organisationen.
- Kontext: Welthistorie (`03-Story/History/`), bisherige Story & Spieler-Erlebnisse
(`01-Sessions/`, `04-Entities/Characters/`) und **Ideen aus `05-Ideas/`**.
- Erstellt Inhalte über den `dnd-worker-writer` und verlinkt maximal.
### 3. `dnd-lore-lead` — Vault-Pflege
- Bestehende Elemente ausbauen (Orte, NSCs, Quests …).
- Neue Verbindungen zwischen Entitäten schaffen.
- Ereignis-Stream (`03-Story/Events/`) und Zeitstrahl (`03-Story/History/Zeitstrahl.md`) pflegen.
- Struktur-/Link-Hygiene.
## Sub-Agents
| Agent | Modell | Rolle |
|-------|--------|-------|
| `dnd-worker-reader` | DeepSeek V4 Flash | Read-only Recherche; liefert Pfade + Links |
| `dnd-worker-writer` | DeepSeek V4 Flash | Dateien anlegen/editieren (Templates + Skills), verlinken |
| `dnd-worker-organizer` | DeepSeek V4 Flash | Struktur, Links, Ereignisse, Zeitstrahl |
| `dnd-creative` | Claude Opus | Nur kreative Rohideen (ein Aufruf) |
## Nutzung
- Standard-Agent ist `dnd-orchestrator` (Router). Einfach die Anfrage tippen — er leitet sie
an den richtigen Lead weiter.
- Oder einen Lead direkt ansprechen, z. B. `@dnd-session-lead Verarbeite die Notizen vom 18.08.2026`.
## Robustheit: kleine Schritte
Um Timeouts bei großen Aufgaben zu vermeiden, gilt überall:
- **Große Aufgaben in kleine Schritte zerlegen** (eine Datei / ein Abschnitt / eine Ebene) und
mit `todowrite` tracken.
- **Pro Worker-Aufruf nur eine fokussierte Teilaufgabe.**
- **Große Quell-Dateien nicht wiederholt komplett einlesen** — gezielt lesen oder Inhalte inline
an den Worker weiterreichen.
- **Editierungen derselben Datei sequenziell**, nicht parallel.
- Bei Timeout/Fehlschlag den **Scope verkleinern** statt denselben großen Schritt zu wiederholen.
## Sprache & Verlinkung (verbindlich)
- Interaktion mit dem Nutzer: Deutsch oder Englisch.
- **Jeder Vault-Inhalt immer Deutsch.**
- **So viele `[[Wiki-Links]]` wie sinnvoll.**
Details: siehe `AGENTS.md`.