Prompt-Architektur

​

Übersicht

​

Research-Erkenntnisse (Version 2.0)

​

Lange Prompts sind korrekt

​

Strukturelle Prinzipien

​

Was aktuelle Prompts falsch machen

​

Prompt-Dateien Inventar

​

Detaillierte Prompt-Analyse

​

1. TOC Prompt (tocPrompt.js)

​

Stärken

• Umfassende Regeln für Graphen-Modell
• Klare Beispiele für Event-Struktur
• Explizite Zeitkonsistenz-Regeln

​

Herausforderungen

1. JSON-Struktur-Anforderungen
2. Zeitregeln (6 verschiedene zeitsynchrone Sektionen)
3. Verzweigungslogik
4. Assessment-Platzierung
5. NPC-Verwaltung
6. Konvergenz-Handling

​

Kritische Zeitregeln

ZEITREGEL (Aktuell):
- Jedes Event muss zeitlich nach seinen Vorgängern liegen
- Parallele Pfade müssen synchronisiert werden
- Konvergenzpunkte müssen alle Vorgänger berücksichtigen
- Tag/Uhrzeit Format: "Tag X, HH:MM Uhr"
- Zeitsprünge müssen narrativ begründet sein
- Keine Zeitschleifen

​

2. Event System Prompt (event/systemPrompt.js)

​

Struktur

• ~400 Zeilen mit 15+ Sektionen
• Literarischer Stil-Guide
• “Show don’t tell” Prinzipien
• Zeichenanzahl-Vorgaben

​

Kern-Anforderungen

​

Stil-Richtlinien

SHOW DON'T TELL Beispiele:

❌ Schlecht: "Sie sind nervös."
✅ Gut: "Ihre Finger trommeln auf dem Tisch."

❌ Schlecht: "Der Raum ist chaotisch."
✅ Gut: "Akten stapeln sich auf dem Boden, leere Kaffeetassen säumen den Schreibtisch."

​

3. Event Generate Prompt (event/generatePrompt.js)

​

Kontext-Injektion

1. Formular-Daten
   • Industrie
   • Szenario-Typ
   • Schwierigkeitsgrad
   • Titel & Beschreibung
2. TOC-Struktur
   • Vollständiger Graph
   • Alle Event-IDs
   • Verzweigungslogik
3. NPC-Registry
   • Bereits verwendete NPCs
   • Charakter-Beschreibungen
4. Vorgänger-Inhalte
   • Vollständiger Text aller direkten Vorgänger
   • Zeit-Constraints
5. Konvergenz-Information
   • Ob dieses Event ein Konvergenzpunkt ist
   • Welche Pfade zusammenlaufen

​

Typischer Prompt-Aufbau

Industrie: [X]
Szenario-Typ: [Y]
Schwierigkeitsgrad: [Z]

TOC-Struktur:
[Gesamter Graph als JSON]

Bereits verwendete NPCs:
[NPC-Liste]

Vorgänger-Event(s):
[Vollständiger Text]

Zeitbeschränkungen:
Muss nach: [Latest Predecessor Time]

GENERIERE JETZT: Event [event_id]

​

4. Validation Prompt (validatePrompt.js)

​

Validierungs-Kategorien

​

Explizite “Was NICHT flaggen”

NICHT flaggen:
- Kreative Entscheidungen im Stil
- Dramaturgische Variationen
- Unterschiedliche NPC-Darstellungen (solange konsistent)
- Zeitsprünge die narrativ begründet sind

​

Problem

​

5. Regeneration & Micro-Edit

​

Regenerate Prompt (event/regeneratePrompt.js)

• 44 Zeilen: Kompakt und fokussiert
• Integriert User-Feedback
• Behält Kontext bei

​

Micro-Edit Prompt (event/microEditPrompt.js)

• 118 Zeilen: Chirurgische Änderungen
• Für einzelne Probleme (z.B. Tippfehler, NPC-Namen)
• Verwendet Haiku-Modell (kostengünstig)

​

6. Model Selector Prompt (modelSelectorPrompt.js)

​

Entscheidungskriterien (aktuell)

Haiku:
- Einfache Struktur-Validierung
- Micro-Edits
- Standardisierte Aufgaben

Sonnet:
- Standard-Szenario-Generierung
- Mittlere Komplexität
- TOC mit <20 Events

Opus:
- Sehr komplexe Szenarien
- >30 Events
- Multiple Verzweigungen
- Hohe Qualitätsanforderungen

​

Problem

​

Helper-Funktionen

​

Zeit-Management (event/helpers.js)

​

Aktuelle Implementierung

// String-basierter Vergleich
pred.time_marker > latestPredecessor.time_marker

• “Tag 1, 23:59” vs “Tag 2, 00:01”
• Verschiedene Formatierungen

​

Vorgänger-Suche

function findAllPredecessorIds(eventId, toc) {
  // Aktuell: Ein Level tief
  // Problem: Verpasst transitive Abhängigkeiten
}

​

Prompt-Effizienz-Analyse

​

Redundanz-Probleme

​

Token-Verbrauch pro Aufgabe

TOC Generation:
Input: ~8.500 Tokens
Output: ~2.000 Tokens
Total: ~10.500 Tokens

Event Generation (3 Events):
Input: ~12.000 Tokens
Output: ~3.000 Tokens
Total: ~15.000 Tokens

Validation:
Input: ~15.000 Tokens (gesamtes Szenario)
Output: ~1.000 Tokens
Total: ~16.000 Tokens

​

Sprach-Konsistenz

// In User Prompts:
"Title: [titel]"           // English label, German content
"Industry: [industrie]"    // English label, German content

// Erwartete Ausgabe: Deutsch
// Kann zu Sprach-Leakage führen

​

Vorgeschlagene Prompt-Struktur

​

System Prompt Template (6 Sektionen)

1. IDENTITY & MISSION (~100-150 Wörter)
   • Wer du bist (Rolle, Expertise)
   • Was du produzierst
   • Kern-Constraints (Sprache, Perspektive)
2. OUTPUT FORMAT
   • JSON-Struktur-Skelett
   • Required Fields
   • Format FRÜH zeigen, damit Modell das Ziel kennt
3. RULES (hierarchisch)
   Copy

   <rules_must>
   UNVERHANDELBAR - Verletzung führt zu Ablehnung:
   - Valid JSON output
   - Unique event_ids
   - Time always forward
   </rules_must>
   
   <rules_should>
   QUALITÄTSSTANDARD - Verletzung mindert Qualität:
   - 500-2000 chars per event
   - 2-3 senses per event
   </rules_should>
   
   <rules_may>
   OPTIONAL - Verbessert das Ergebnis:
   - Specific NPC archetypes
   - Dramatic cliffhangers
   </rules_may>
   
4. DETAILED GUIDANCE
   • Domain-spezifische Instruktionen
   • Stil-Guide
   • Edge Cases
   • Organisiert mit XML-Tags: <time_rules>, <style_guide>, etc.
5. EXAMPLES
   Copy

   <examples>
   Ein komplettes, hochwertiges Beispiel des erwarteten Outputs
   </examples>
   
6. FINAL REMINDER (Sandwich)
   • MUST-Regeln in kondensierter Form wiederholen
   • JSON only
   • Time forward
   • All event_ids unique

​

User Prompt Template (3 Sektionen)

1. CONTEXT DATA (oben - longform zuerst)
   Copy

   <scenario_config>
   Full formData - ALLE Details für Konsistenz
   </scenario_config>
   
   <toc>
   Full TOC structure
   </toc>
   
   <previous_events>
   Previously generated events
   </previous_events>
   
2. DERIVED CONTEXT (berechnete Helfer)
   Copy

   <npc_registry>
   Welche NPCs wo eingeführt
   </npc_registry>
   
   <time_constraints>
   Latest predecessor times
   </time_constraints>
   
3. SPECIFIC TASK (unten - Query zuletzt)
   Copy

   <task>
   Clear instruction: was generieren, welche event_ids
   </task>
   
   <checklist>
   Quick self-check vor Output
   </checklist>
   

​

Regel-Framing: Negativ → Positiv

​

Konsolidierte Zeitregeln

<time_rules>
ZEITLOGIK

Eine einzige Regel: Zeit fließt vorwärts.

Für jedes Event gilt:
  time_marker MUSS später sein als ALLE Events, die zu diesem führen.

Bei Konvergenz (mehrere Pfade führen zu einem Event):
  Der Konvergenz-Event muss NACH dem spätesten aller Vorgänger liegen.

  Beispiel:
  - e4a endet um 10:15
  - e4b endet um 10:18
  - e4c endet um 10:20 ← spätester
  → e5 muss 10:21 oder später sein

Format: "Tag X, HH:MM Uhr"

Vor Abgabe prüfen:
  Folge jedem Pfad von e1 bis zum Ende.
  Ist die Zeit in jedem Schritt aufsteigend? ✓
</time_rules>

​

Best Practices (abgeleitet)

​

Was funktioniert gut

1. Klare Beispiele: “Show don’t tell” Beispiele sind sehr effektiv
2. Strukturierte Ausgabe: JSON-Format mit Schema funktioniert zuverlässig
3. Kontext-Injektion: Vorgänger-Inhalte helfen bei Konsistenz
4. Severity Levels: Klare Priorisierung in Validierung

​

Was verbessert werden sollte

1. Prompt-Restrukturierung mit XML-Tags (P0)
2. Regel-Hierarchie hinzufügen: MUST vs SHOULD vs MAY (P0)
3. Positives Regel-Framing: Negativ → Positiv konvertieren (P0)
4. Zeitregeln konsolidieren: Zu EINER Sektion zusammenfassen (P0)
5. Sandwich-Methode: MUST-Regeln am Ende wiederholen (P0)
6. Zeit-Parsing: Strukturierter Vergleich statt String (P1)
7. Sprach-Konsistenz: Alle Labels auf Deutsch (P1)
8. TOC-Output optimieren: Schlankere Struktur (P1)

​

Nächste Schritte