← Zurück zur Subagent-Architektur

Pipeline-Agent-Prompts

Die vollständigen Prompt-Templates für Pipeline- und Datei-Agenten, Variablen-Ersetzung und Qualitätsinstruktionen — annotiert und erklärt

Auf dieser Seite

01Pipeline-Agent-Prompt vollständig 02Datei-Agent-Prompt vollständig 03Variablen-Ersetzung 04Qualitätsinstruktionen im Prompt

01

Pipeline-Agent-Prompt vollständig

Der Pipeline-Agent erhält vom Orchestrator einen vollständigen Kontext über die zu generierende Audience-Variante. Hier ist das komplette Template mit Annotationen.

// ============================================
// PIPELINE-AGENT PROMPT TEMPLATE
// ============================================

Du bist ein Pipeline-Agent für den Stakeholder
Content Generator. Deine Aufgabe: Generiere alle
HTML-Dateien für EINE Audience-Variante.

// --- Audience-Kontext ---
AUDIENCE:
  Name:       {{audience_name}}
  Emoji:      {{audience_emoji}}
  Suffix:     {{audience_suffix}}
  max_level:  {{max_level}}

// --- Schwellenwerte ---
HS_THRESHOLDS:
  L1: {{threshold_l1}}
  L2: {{threshold_l2}}   // null wenn max_level < 2
  L3: {{threshold_l3}}   // null wenn max_level < 3

// --- Integration ---
INTEGRATION_MODE: {{mode}}
  // "standalone": mit Header/Footer
  // "embedded": ohne Header/Footer

// --- Ausgabe ---
OUTPUT_DIR:      {{output_dir}}
NAMING_PATTERN:  [slug]{{suffix}}_{{lang}}.html

// --- Curriculum-Baum ---
CURRICULUM:
  // Vom Orchestrator vorberechneter Baum
  // Nur Themen, die für DIESE Audience relevant sind
  [
    {
      theme: "Authentifizierung",
      slug:  "authentifizierung",
      hs:    10,
      planned_levels: ["L0", "L1", "L2", "L3"],
      sub_themes: [
        { name: "OAuth2 Flow", hs: 9 },
        { name: "JWT Handling", hs: 8 },
        { name: "Role-Based Access", hs: 7 }
      ]
    },
    {
      theme: "API Design",
      slug:  "api-design",
      hs:    8,
      planned_levels: ["L0", "L1", "L2"],
      sub_themes: [...]
    },
    ...
  ]

// --- Foundation-Referenz ---
CSS_JS_FOUNDATION:
  // Verwende die gleiche CSS/JS-Basis wie die
  // bestehenden Seiten. KEIN externes Framework.
  // Inline CSS & JS in jeder Datei.

// --- Sprache ---
LANGUAGE:       {{lang}}   // "de" oder "en"
LANG_PARTNER:   {{partner_lang}}  // "en" oder "de" (null wenn einsprachig)

// --- Instruktionen ---
Generiere für jedes Thema im Curriculum die
geplanten Levels als separate HTML-Dateien.

Für jede Datei: Starte einen Datei-Agent
(Subagent) mit dem Datei-Agent-Prompt.
            

Der Pipeline-Agent-Prompt enthält alles, was ein Agent braucht, um eine komplette Audience-Variante zu generieren:

1. Audience-Kontext: Name, Emoji, Suffix und maximale Tiefe. Damit weiß der Agent, für wen er schreibt und wie tief er gehen darf.

2. Schwellenwerte: Die HS-Schwellen pro Level. Braucht der Agent, um zu entscheiden, welche Themen eigene Seiten bekommen.

3. Integrationsmodus: Standalone (mit eigenem Header/Footer) oder Embedded (ohne, für Einbettung in eine bestehende Seite).

4. Curriculum-Baum: Nur die Themen, die für diese Audience relevant sind, mit vorberechneten HS-Werten und geplanten Levels. Der Pipeline-Agent muss keine eigene HS-Berechnung durchführen.

5. Naming-Convention und Sprache: Wie Dateien heißen sollen und in welcher Sprache der Inhalt geschrieben wird.

02

Datei-Agent-Prompt vollständig

Der Datei-Agent generiert eine einzelne HTML-Datei. Sein Prompt enthält alles, was für genau diese eine Seite relevant ist — vom Dateinamen bis zu den Quality Gates.

// ============================================
// DATEI-AGENT PROMPT TEMPLATE
// ============================================

Du generierst EINE HTML-Datei.

// --- Datei-Identität ---
FILENAME:     {{filename}}
  // z.B. "authentifizierung_dev_de.html"
PATH:         {{output_dir}}/{{level_dir}}/{{filename}}
  // z.B. "./output/l1/authentifizierung_dev_de.html"

// --- Kontext ---
AUDIENCE:     {{audience_name}} {{audience_emoji}}
LANGUAGE:     {{lang}}
LEVEL:        {{level}}    // 0, 1, 2 oder 3
THEME:        {{theme_name}}
HS_SCORE:     {{hs}}

// --- Integration ---
MODE:         {{integration_mode}}

// --- Inhalt ---
CONTENT_DESCRIPTION:
  {{content_brief}}
  // Vom Orchestrator/Pipeline-Agent generierte
  // Inhaltsbeschreibung: Was soll auf dieser
  // Seite stehen? Welche Aspekte abdecken?

// --- Navigation ---
BREADCRUMB:
  [
    { label: "Überblick", href: "{{l0_href}}", level: "L0" },
    { label: "{{l1_theme}}", href: "{{l1_href}}", level: "L1" },
    { label: "{{l2_theme}}", href: "{{l2_href}}", level: "L2" },
    { label: "{{current_theme}}", href: null, level: "L3" }
  ]
  // Nur so viele Einträge wie der Level erfordert

DEEP_DIVE_TARGETS:
  // Links zu tieferen Seiten (falls vorhanden)
  [
    { label: "{{dd_label}}", href: "{{dd_href}}" },
    ...
  ]
  // Leer wenn Level == max_level oder L3

SIBLING_PAGES:
  // Alle Seiten auf dem gleichen Level
  [
    { num: "01", label: "{{sib_label}}",
      href: "{{sib_href}}", current: false },
    { num: "02", label: "{{current_theme}}",
      href: null, current: true },
    ...
  ]

LANG_COUNTERPART:
  {{lang_partner_filename}}
  // z.B. "authentifizierung_dev_en.html"
  // null wenn einsprachig

AUDIENCE_SWITCH:
  // Nur auf L0-Seiten relevant
  {{audience_switch_placeholder}}

// --- CSS/JS ---
CSS_JS_REFERENCE:
  // Verwende inline CSS + JS
  // Kopiere Foundation aus bestehender Datei
  // KEIN CDN, KEIN externes Stylesheet

// --- Quality Gates ---
QUALITY_GATES:
  {{quality_instructions}}
  // Siehe Sektion 04 für Details
            

Der Datei-Agent-Prompt ist das detaillierteste Template:

Er enthält den exakten Dateinamen und Pfad, den Audience-Kontext, das Level, das Thema und seinen HS-Score. Außerdem die Inhaltsbeschreibung (was genau auf der Seite stehen soll), den vollständigen Breadcrumb-Pfad als Array von Objekten, die Deep-Dive-Ziele (falls tiefere Seiten geplant sind), die Sibling-Pages für die Navigation am Seitenende, den Sprachpartner-Dateinamen für den Sprachschalter, den Audience-Switch-Platzhalter (nur auf L0) und die Quality Gates.

Kernprinzip: Der Datei-Agent braucht keine globale Sicht. Er erhält genau die Informationen, die er für seine eine Datei braucht. Das ermöglicht Parallelisierung — mehrere Datei-Agenten können gleichzeitig arbeiten.

03

Variablen-Ersetzung

Der Orchestrator füllt die Template-Variablen mit konkreten Werten. Die Naming Convention ist dabei entscheidend — ein falscher Slug bricht alle Cross-Links.

Dateinamen-Konvention: [slug][suffix]_[lang].html

Schritt	Operation	Beispiel
1. Titel nehmen	Deutscher Themen-Titel	„Überblick & Architektur“
2. Lowercase	Alles kleinschreiben	„überblick & architektur“
3. Umlaute ersetzen	ä→ae, ö→oe, ü→ue, ß→ss	„ueberblick & architektur“
4. Sonderzeichen entfernen	Alles außer [a-z0-9-] entfernen	„ueberblick architektur“
5. Leerzeichen → Bindestriche	Spaces werden zu -	„ueberblick-architektur“
6. Doppel-Bindestriche bereinigen	-- wird zu -	„ueberblick-architektur“
7. Suffix anhängen	Audience-Suffix + Sprache	„ueberblick-architektur_dev_de.html“

// ============================================
// SLUG-ABLEITUNG & DATEINAMEN-ERZEUGUNG
// ============================================

function slugify(title):
    slug = title.toLowerCase()

    // Deutsche Umlaute
    slug = slug.replace("ä", "ae")
               .replace("ö", "oe")
               .replace("ü", "ue")
               .replace("ß", "ss")

    // Akzente entfernen (französisch etc.)
    slug = normalize_nfd(slug)
    slug = remove_diacritics(slug)

    // Nur [a-z0-9] behalten, Rest zu Leerzeichen
    slug = replace(/[^a-z0-9]+/g, " ", slug)

    // Trim und Leerzeichen zu Bindestrichen
    slug = trim(slug).replace(/\s+/g, "-")

    return slug

function build_filename(theme, audience, lang):
    slug = slugify(theme.name)
    suffix = audience.suffix  // "" oder "_dev" etc.
    return slug + suffix + "_" + lang + ".html"

// Beispiele:
// "Phasen-Steuerung" + _dev + de
//   → "phasen-steuerung_dev_de.html"
//
// "Überblick & Architektur" + "" + en
//   → "ueberblick-architektur_en.html"
//
// "Authentifizierung" + _exec + de
//   → "authentifizierung_exec_de.html"
//
// L0 Überblick: Sonderfall
//   → "index_dev_de.html" (immer "index")

function build_path(theme, audience, lang, level):
    filename = build_filename(theme, audience, lang)
    if level == 0:
        return output_dir + "/" + filename
    return output_dir + "/l" + level + "/" + filename
            

Die Slug-Ableitung folgt einem festen Schema:

Der deutsche Titel wird kleingeschrieben, Umlaute werden zu ae/oe/ue/ss, Sonderzeichen werden entfernt, Leerzeichen werden zu Bindestrichen. Das Ergebnis ist ein URL-sicherer Slug.

Sonderfall L0: Die L0-Überblickseite heißt immer „index“. Also index_dev_de.html, nicht ueberblick_dev_de.html.

Verzeichnisstruktur: L0-Dateien liegen im Root des Output-Verzeichnisses. L1, L2, L3-Dateien liegen in l1/, l2/, l3/ Unterverzeichnissen.

04

Qualitätsinstruktionen im Prompt

Jeder Datei-Agent bekommt einen Abschnitt mit Qualitätsregeln, die in die generierte HTML-Datei einfließen müssen. Hier ist das vollständige Quality-Gate-Template.

// ============================================
// QUALITY GATES — Prompt-Abschnitt
// ============================================

QUALITY_GATES:

// 1. WCAG AA Kontrast
- KEIN weißer Text auf hellem Hintergrund.
- Mindest-Kontrastverhältnis: 4.5:1 für normalen Text,
  3:1 für großen Text (≥ 18pt oder ≥ 14pt fett).
- Hero-Bereich: Weißer Text auf dunklem Hintergrund
  ist OK (navy #000099 background).
- Helle Hintergründe (#FFFFFF, #F3EFEB, #F8F5F2):
  Text muss #1A1A2E oder dunkler sein.
- NIEMALS rgba(255,255,255,...) als Textfarbe
  auf hellen Flächen.

// 2. Keine Level-Labels in Titeln
- Überschriften dürfen NICHT mit "L0:", "L1:",
  "L2:", "L3:", "Level 1:", etc. beginnen.
- Level-Information gehört in Breadcrumbs und
  Level-Dots, nicht in den Seitentitel.
- Falsch: "L2: Phasen-Steuerung im Detail"
- Richtig: "Phasen-Steuerung im Detail"

// 3. Tooltip-Anforderungen
- Fachbegriffe mit class="term" und
  data-tooltip="..." markieren.
- Tooltip-Container am Seitenende:
  <div class="term-tooltip" id="tooltip"></div>
- JS für Tooltip-Positionierung inkludieren.

// 4. Maximal 10 Themen pro Level
- Pro Level und Audience max. 10 eigene Seiten.
- Überschuss als Absätze auf Elternseite.
- Sibling-Nav darf max. 10 Einträge haben.

// 5. Keine toten Links
- Jeder interne Link muss auf eine generierte
  Datei zeigen.
- Deep-Dive-Links: Nur wenn das Ziel tatsächlich
  geplant und generiert wird.
- Im Zweifel: Link weglassen, nicht auf eine
  nicht-existente Datei zeigen.

// 6. Level-Dots korrekt
- L0: [active] [empty] [empty] [empty]
- L1: [done] [active] [empty] [empty]
- L2: [done] [done] [active] [empty]
- L3: [done] [done] [done] [active]
- Immer genau 4 Dots.

// 7. Breadcrumb-Konsistenz
- Breadcrumb muss den aktuellen Level-Pfad
  korrekt abbilden.
- Links müssen auf die Audience-spezifische
  Variante zeigen (nicht auf index_de.html
  wenn die Audience _dev ist).

// 8. Responsive Design
- Alle Layouts müssen auf 320px funktionieren.
- Tabellen: font-size reduzieren auf Mobile.
- Flow-Diagramme: vertikal auf Mobile.

// 9. Sibling-Nav Format
- Aktuelle Seite: span mit .sibling-nav-current
- Andere Seiten: a mit .sibling-nav-link
- Nummerierung: 01, 02, 03, ...
            

Die Quality Gates sind verbindliche Regeln, die jeder Datei-Agent einhalten muss:

WCAG-Kontrast: Kein weißer Text auf hellen Flächen. Das ist der häufigste Fehler. Auf dem dunklen Hero-Bereich ist weißer Text erlaubt, aber auf weißen oder beigen Hintergründen muss der Text dunkel (#1A1A2E) sein.

Keine Level-Labels: Seitentitel dürfen nicht mit „L2:“ beginnen. Das Level wird durch Breadcrumbs und Level-Dots kommuniziert — den Titel damit zu verschmutzen ist redundant und stört die Lesbarkeit.

Maximal 10: Mehr als 10 Seiten auf einem Level machen die Navigation unübersichtlich. Überschuss-Themen werden als Absätze auf der Elternseite dargestellt.

Keine toten Links: Jeder interne Link muss auf eine tatsächlich generierte Datei zeigen. Das ist die häufigste Fehlerquelle bei der Generierung — ein Deep-Dive-Link wird gesetzt, aber die Zielseite wurde nicht generiert, weil der HS zu niedrig war.

✏️ Wissenstest

Welches Suffix bekommt die erste/allgemeinste Zielgruppe in der Naming Convention?

_user — weil Anwender die allgemeinste Audience sind

_default — als expliziter Marker für die Standard-Ansicht

Kein Suffix — index_de.html, nicht index_user_de.html

🔧 Entwickler — Alle L3-Seiten

01 Weichenstellung-Logik 02 Schwellenwerte 03 Pipeline-Agent-Prompts