# AGENTS — Vault-Standards für die Kampagne „Morgendämmerung"

Diese Datei ist die zentrale **Standard- und Anweisungsquelle** für alle Agents und
Skills in diesem Vault. Sie gilt immer und überall.

## Prinzip: Drei Ebenen der Trennung

| Ebene | Wo | Zweck |
|-------|----|-------|
| **Standards** | `AGENTS.md` (diese Datei) | Globale Regeln, Konventionen, Sprach- und Verlinkungsregeln |
| **Wiederkehrende Aufgaben** | `.opencode/skills/dnd-*/SKILL.md` | Einzelne, wiederkehrende Tätigkeiten (NPC erstellen, Quest entwerfen, Session-Bericht …) |
| **Workflows** | `.opencode/agents/*.md` | Mehrschrittige Abläufe, die Aufgaben koordinieren und an Sub-Agents delegieren |

Halte diese Trennung ein: Neue Regeln → hier. Neue wiederkehrende Einzelaufgabe → Skill.
Neuer mehrschrittiger Ablauf → Agent.

## Sprache

- **Interaktion mit dem Nutzer**: Deutsch oder Englisch erlaubt. Antworte in der Sprache des Nutzers.
- **Jeder im Vault erzeugte Inhalt** (Notizen, Frontmatter-Werte, Zusammenfassungen, Berichte,
  Abschnittsüberschriften, Beschreibungen) ist **immer Deutsch**.
- Eigennamen, Ortsnamen, Monster-, Zauber- und Item-Namen bleiben in ihrer etablierten Form
  (auch wenn sie englisch sind, z. B. `Goblin`, `Hobgoblin Captain`).

## Verlinkung

- Erzeuge **so viele `[[Wiki-Links]]` wie sinnvoll** möglich — großzügig, aber nicht erzwungen.
- Verlinke bei jeder Erwähnung: NSCs, Orte, Organisationen, Items, Quests/Arcs, Ereignisse,
  History-Einträge und Sessions.
- Ein Link `[[Name]]` zeigt auf eine Datei mit diesem Namen. Neue Dateien werden genau so benannt,
  dass der Link-Namen zum Dateinamen passt.
- Nutze Abschnitts-Links `[[Datei#Abschnitt]]` für präzise Verweise.

## Vault-Struktur

```
Kampagne-01/
├── 00-Inbox/                 # Rohe Session-Notizen, temporäre Ideen (Intake)
├── 01-Sessions/              # Chronologische Session-Prep/Notizen („Episode XX.md")
├── 02-World/                 # Die "Lore-Bibel"
│   ├── Locations/            #   (inkl. Dungeons/, Regions/)
│   ├── Items/
│   └── Spells/
├── 03-Story/                 # Narratives Gerüst
│   ├── Arcs/                 #   langfristige Handlungsbögen
│   ├── Quests/               #   konkrete Quests
│   ├── Events/               #   Ereignis-Stream (einzelne Geschehnisse)
│   └── History/              #   Weltgeschichte + Zeitstrahl („Zeitstrahl.md")
├── 04-Entities/              # Wer ist wer
│   ├── Organizations/
│   ├── NPCs/
│   ├── Characters/           #   (Spieler-Charaktere)
│   └── Monsters/
├── 05-Ideas/                 # Intake für neue Ideen (input.md + Unterordner)
├── 06-Assets/                # Nicht-Markdown (Maps, Bilder, Handouts)
├── 07-Compendium/            # Offizieller D&D-Content (nur Referenz)
├── 08-Archiv/                # Abgeschlossenes/Archiviertes
└── Templates/                # Wiederverwendbare Vorlagen
```

## Datei- und Namenskonventionen

- Session-Prep/Bericht: `01-Sessions/Episode XX.md` (XX = fortlaufende Nummer, z. B. `Episode 12`).
- Rohe Session-Notizen: `00-Inbox/` mit **Datum im Dateinamen** (`18.08.2026.md`) **oder** im Inhalt.
- NSCs: `04-Entities/NPCs/<Name>.md`
- Orte: `02-World/Locations/<Name>.md`
- Quests: `03-Story/Quests/<Name>.md` · Arcs: `03-Story/Arcs/<Name>.md`
- Ereignisse: `03-Story/Events/<Name>.md`
- Historie: `03-Story/History/<Name>.md` · Zeitstrahl: `03-Story/History/Zeitstrahl.md`
- Organisationen: `04-Entities/Organizations/<Name>.md`
- Items: `02-World/Items/<Name>.md`
- Kurze, beschreibende Dateinamen ohne Sonderzeichen (kein `Name - Der Titel.md`, sondern `Name.md`).

## Frontmatter / Metadaten

- Jede neue Datei erhält Frontmatter mit mindestens `type` und `campaign: Morgendämmerung`
  sowie passende `tags`.
- Vorlagen liegen in `Templates/` und geben das verbindliche Schema vor — verwende sie.

## Vorlagen

| Vorlage | Für |
|---------|-----|
| `Templates/session-template.md` | Session-Prep & -Notizen |
| `Templates/npc-template.md` | NSCs |
| `Templates/location-template.md` | Orte |
| `Templates/quest-template.md` | Quests/Arcs |
| `Templates/event-template.md` | Ereignisse |
| `Templates/item-template.md` | Items |
| `Templates/organization-template.md` | Organisationen |
| `Templates/character-template.md` | Charaktere |
| `Templates/monster-template.md` | Monster |
| `Templates/spell-template.md` | Zauber |
| `Templates/idea-template.md` | Ideen (05-Ideas) |

## Sessions

- Session-Datum steht im Dateinamen (`DD.MM.YYYY`) oder im Inhalt der `00-Inbox`-Notiz.
- Prep-Notizen folgen `Templates/session-template.md` und tragen `dnd_session_date` im Frontmatter.
- Nach der Session: vorheriges Prep in einen **Sitzungsbericht** überführen (Prep + tatsächliche
  Notizen kombinieren) und das nächste Prep anlegen.

## Ereignisse & Timeline

- Wichtige Geschehnisse als Ereignis in `03-Story/Events/<Name>.md` pflegen.
- Den Zeitstrahl `03-Story/History/Zeitstrahl.md` aktuell halten (chronologisch, mit Links).
- Verbindungen zwischen Ereignissen, Orten, NSCs und Handlungsbögen immer setzen.

## Daten nicht zerstören

- Originale Session-Notizen und bestehende Dateien nie löschen, ohne den Nutzer zu fragen.
- Änderungen an bestehenden Inhalten minimal-invasiv und mit Links anreichern, nicht umschreiben.