113 lines
5.3 KiB
Markdown
113 lines
5.3 KiB
Markdown
# 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.
|