← Zurück zur Score-Berechnung

Schwellenwerte & Entscheidungslogik

Die vollständige Schwellenwert-Matrix, die zweistufige Prüfung, Grenzfälle und Custom-Audience-Überschreibungen — mit komplettem Pseudocode

Auf dieser Seite

01Schwellenwert-Tabelle vollständig 02Zweistufige Schwellenwert-Prüfung 03Grenzfälle 04Custom-Zielgruppen-Schwellenwerte

01

Schwellenwert-Tabelle vollständig

Jede Kombination aus Zielgruppe und Level hat einen exakten Schwellenwert. Liegt der Helpfulness-Score (HS) eines Themas unter diesem Wert, bekommt das Thema keine eigene Seite auf diesem Level — stattdessen wird es als erweiterter Absatz oder Collapsible auf der Elternseite dargestellt.

Vollständige Schwellenwert-Matrix

Zielgruppe	max_level	L1 (eigenes Modul)	L2 (eigene Seite)	L3 (Deep-Dive)
🔧 Entwickler	L3	HS ≥ 6	HS ≥ 8	HS ≥ 8
👤 Anwender	L2	HS ≥ 7	HS ≥ 9	— (kein L3)
📊 Entscheider	L1	HS ≥ 8	— (kein L2)	— (kein L3)

Was passiert unter dem Schwellenwert?

📄

Erweiterter Absatz

Das Thema wird auf der Elternseite als ausführlicher Absatz dargestellt. Kein eigener Link, keine eigene URL. Der Inhalt ist da, aber nicht als eigene Seite navigierbar.

HS unter Schwelle

▶️

Collapsible

Alternativ: Das Thema wird als aufklappbarer Bereich auf der Elternseite dargestellt. Spart Platz, bietet aber trotzdem Zugang zum Inhalt für Interessierte.

Optional

Warum unterschiedliche Schwellenwerte?

Entwickler haben die niedrigsten Schwellenwerte, weil sie die größte Tiefe vertragen. Ein Thema mit HS=6 ist für Entwickler relevant genug für ein eigenes L1-Modul, aber für Anwender (Schwelle 7) oder Entscheider (Schwelle 8) nicht. Entscheider haben die höchsten Schwellenwerte, weil jedes Thema, das es auf ihre Seite schafft, extrem relevant sein muss — ihre Zeit ist am knappsten.

02

Zweistufige Schwellenwert-Prüfung

Die Schwellenwert-Prüfung erfolgt in zwei Gates. Beide müssen bestanden werden, bevor eine Seite geplant wird — und zusätzlich muss das nächste Level innerhalb der maximalen Tiefe der Audience liegen.

// ============================================
// ZWEISTUFIGE SCHWELLENWERT-PRÜFUNG
// ============================================

const THRESHOLDS = {
    // [audience][level] = minimum HS
    "entwickler": { L1: 6, L2: 8, L3: 8 },
    "anwender":   { L1: 7, L2: 9 },
    "entscheider": { L1: 8 }
}

const MAX_LEVEL = {
    "entwickler": 3,
    "anwender":   2,
    "entscheider": 1
}

function plan_depth(topic, audience):
    hs = topic.helpfulness_score[audience]
    max_lvl = MAX_LEVEL[audience]
    thresholds = THRESHOLDS[audience]
    planned = []

    // L0: Jedes Thema mit HS >= 1 wird erwähnt
    if hs >= 1:
        planned.push("L0_mention")

    // Für jedes Level ab L1:
    for level in [1, 2, 3]:
        if level > max_lvl:
            break  // Gate 0: Audience-Maximum

        threshold_own = thresholds["L" + level]

        // ---- GATE 1: Eigene Seite? ----
        // "Bekommt dieses Thema eine eigene Seite
        //  auf diesem Level?"
        if hs < threshold_own:
            // NEIN: Wird als Absatz auf Elternseite
            // dargestellt. Keine eigene URL.
            topic.fallback[level] = "paragraph_on_parent"
            break  // Tiefere Levels nicht prüfen

        // JA: Eigene Seite geplant
        planned.push("L" + level)

        // ---- GATE 2: Noch tiefer planen? ----
        // "Sollen wir das nächste Level planen?"
        next_level = level + 1
        if next_level > max_lvl:
            break  // Audience-Maximum erreicht

        threshold_deeper = thresholds["L" + next_level]
        if !threshold_deeper:
            break  // Kein Schwellenwert definiert

        if hs < threshold_deeper:
            // Score reicht nicht für tieferes Level
            break

        // Weiter zum nächsten Level

    return {
        topic: topic.name,
        audience: audience,
        hs: hs,
        planned_levels: planned,
        stop_reason: determine_stop_reason(hs, max_lvl, planned)
    }

// ============================================
// STOP-REASON BESTIMMUNG
// ============================================

function determine_stop_reason(hs, max_lvl, planned):
    deepest_planned = max(planned)  // z.B. "L2"
    deepest_num = parse_level_num(deepest_planned)

    if deepest_num == max_lvl:
        return "audience_max_level"

    next_threshold = THRESHOLDS[audience]["L" + (deepest_num + 1)]
    if next_threshold and hs < next_threshold:
        return "hs_below_threshold"

    return "complexity_exhausted"
            

Die zwei Gates:

Gate 1 — „Eigene Seite?“: Für jedes Level wird geprüft, ob der HS den Schwellenwert für eine eigene Seite erreicht. Wenn nicht, wird das Thema stattdessen als Absatz auf der Elternseite dargestellt. Alle tieferen Levels werden übersprungen — wenn ein Thema kein L2 bekommt, kann es auch kein L3 bekommen.

Gate 2 — „Noch tiefer?“: Wenn Gate 1 bestanden ist, wird geprüft, ob der HS auch den Schwellenwert des nächsten Levels erreicht UND ob das nächste Level innerhalb der maximalen Tiefe der Audience liegt. Beide Bedingungen müssen erfüllt sein.

Stop-Reason: Am Ende wird dokumentiert, warum nicht tiefer geplant wurde. Drei Gründe: Audience-Maximum erreicht, Score unter nächstem Schwellenwert, oder Komplexität des Themas erschöpft.

Beispiel-Durchlauf: Thema „API Design“, HS=8

Audience	Gate 1 (L1)	Gate 2 (L2)	Gate 2 (L3)	Ergebnis
🔧 Entwickler	8 ≥ 6 ✓	8 ≥ 8 ✓	8 ≥ 8 ✓	L0, L1, L2, L3
👤 Anwender	8 ≥ 7 ✓	8 < 9 ✗	—	L0, L1 (Stop: HS unter L2-Schwelle)
📊 Entscheider	8 ≥ 8 ✓	— (max L1)	—	L0, L1 (Stop: Audience-Max)

03

Grenzfälle

Was passiert an den Rändern der Schwellenwerte? Hier sind alle Grenzfälle dokumentiert — von exakt-am-Schwellenwert bis zur Überlauf-Behandlung.

Grenzfall	Regel	Beispiel
HS exakt am Schwellenwert	Inkludiert (≥, nicht >). Der Operator ist „größer oder gleich“.	HS=8, Schwelle=8 → eigene Seite
HS = 10 (Maximum)	Immer eigene Seite und tiefere Inhalte, soweit das Audience-Maximum es erlaubt.	HS=10 für Entscheider → L0 + L1 (nicht L2, max=L1)
HS = 1–2	Immer nur Kurznennung. Unter jedem L1-Schwellenwert. Bleibt als Erwähnung auf L0.	HS=2 für Entwickler → nur L0-Erwähnung
HS = 0	Nicht erwähnt. Thema wird komplett übersprungen, nicht einmal auf L0 genannt.	HS=0 → unsichtbar für diese Audience
Mehrere Themen mit gleichem HS	Sortierung: 1. Relevanz-Subscore (absteigend), 2. Alphabetisch nach Themenname.	Thema A (HS=8, Rel=0.9) vor Thema B (HS=8, Rel=0.7)
Mehr als 10 Themen pro Level	Top 10 nach HS. Restliche Themen werden als Absätze auf der Elternseite dargestellt.	15 Themen mit HS ≥ 6 auf L1 → Top 10 als Module, 5 als Absätze
Exakt 10 Themen	Alle inkludiert. 10 ist das Maximum, nicht ein Ausschluss-Trigger.	10 Themen → alle als eigene Module
HS-Gleichstand am 10er-Cutoff	Alle mit gleichem HS inkludieren. Kann zu 11–12 Themen führen. Pragmatismus vor starrer Regel.	Themen 9, 10, 11 alle HS=7 → alle drei inkludiert

// ============================================
// TOP-10 AUSWAHL PRO LEVEL
// ============================================

function select_topics_for_level(topics, level, audience):
    // Nur Themen, die den Schwellenwert erreichen
    eligible = topics.filter(t =>
        t.hs[audience] >= THRESHOLDS[audience]["L" + level]
    )

    // Sortieren: HS absteigend, dann Relevanz, dann Name
    eligible.sort((a, b) =>
        b.hs[audience] - a.hs[audience]
        or b.relevance - a.relevance
        or a.name.localeCompare(b.name)
    )

    if eligible.length <= 10:
        return {
            own_page: eligible,
            as_paragraph: []
        }

    // Mehr als 10: Top 10 nehmen
    cutoff_hs = eligible[9].hs[audience]

    // ABER: Alle mit gleichem HS wie #10 inkludieren
    own_page = eligible.filter(t =>
        eligible.indexOf(t) < 10
        or t.hs[audience] == cutoff_hs
    )

    as_paragraph = eligible.filter(t =>
        !own_page.includes(t)
    )

    return {
        own_page: own_page,       // Eigene Seiten (10+)
        as_paragraph: as_paragraph // Absätze auf Elternseite
    }
            

Die Top-10-Regel: Pro Level und Audience dürfen maximal 10 Themen eine eigene Seite bekommen. Gibt es mehr, werden sie nach HS absteigend sortiert, dann nach Relevanz-Subscore, dann alphabetisch. Die Top 10 bekommen eine eigene Seite. Der Rest wird als Absatz auf der Elternseite dargestellt.

Ausnahme bei Gleichstand: Wenn die Themen an Position 10 und 11 den gleichen HS haben, werden beide inkludiert. Das kann zu leicht mehr als 10 Themen führen, ist aber fairer als willkürliches Abschneiden.

Warum maximal 10? Mehr als 10 Module auf einem Level machen die Navigation unübersichtlich. Die Sibling-Nav wird zu lang, der Überblick geht verloren. 10 ist ein Kompromiss zwischen Vollständigkeit und Navigierbarkeit.

04

Custom-Zielgruppen-Schwellenwerte

Für 🏷️ Custom-Audiences (benutzerdefinierte Zielgruppen) gelten Standardwerte aus dem Anwender-Profil. Der User kann diese jedoch mit einer expliziten Überschreibungs-Syntax anpassen.

Standard-Verhalten für Custom-Audiences

Eigenschaft	Default	Quelle
max_level	2 (wie Anwender)	Anwender-Profil
L1-Schwellenwert	7 (wie Anwender)	Anwender-Profil
L2-Schwellenwert	9 (wie Anwender)	Anwender-Profil
Emoji	🏷️	Standard für Custom
Suffix	Slug des Namens (z.B. _devops-team)	Automatisch abgeleitet

Überschreibungs-Syntax:

// ============================================
// CUSTOM-AUDIENCE ÜBERSCHREIBUNG
// ============================================

// User-Eingabe-Formate (alle gültig):
//
// "Custom audience 'DevOps Team', max L2, threshold 7"
// "DevOps Team (custom, max_level=3, l1=6, l2=8, l3=8)"
// "QA Engineers: max L1, threshold 8"

function parse_custom_audience(input):
    result = {
        name: extract_name(input),
        // Defaults aus Anwender-Profil
        max_level: 2,
        thresholds: { L1: 7, L2: 9 },
        emoji: "🏷️",
        suffix: slugify(extract_name(input))
    }

    // max_level überschreiben
    if matches(input, /max\s*L?(\d)/i):
        level = parse_int(match[1])
        if level < 1 or level > 3:
            raise "max_level muss zwischen 1 und 3 liegen."
        result.max_level = level

        // Schwellenwerte an neues max_level anpassen
        if level >= 3:
            result.thresholds.L3 = result.thresholds.L2
            // Default: L3 = L2 Schwellenwert

    // Einzelnen Threshold überschreiben
    if matches(input, /threshold\s*(\d+)/i):
        t = parse_int(match[1])
        if t < 1 or t > 10:
            raise "Schwellenwert muss zwischen 1 und 10 liegen."
        // Einzelner Wert: auf alle Levels anwenden
        for level in range(1, result.max_level + 1):
            result.thresholds["L" + level] = t

    // Level-spezifische Thresholds
    for match in match_all(input, /l(\d)\s*=\s*(\d+)/ig):
        level = parse_int(match[1])
        value = parse_int(match[2])
        result.thresholds["L" + level] = value

    return result

// Beispiele:
//
// Input: "DevOps Team, max L2, threshold 7"
// Result: { name: "DevOps Team", max_level: 2,
//           thresholds: { L1: 7, L2: 7 },
//           suffix: "_devops-team" }
//
// Input: "QA Engineers (max_level=3, l1=6, l2=8, l3=9)"
// Result: { name: "QA Engineers", max_level: 3,
//           thresholds: { L1: 6, L2: 8, L3: 9 },
//           suffix: "_qa-engineers" }
//
// Input: "Marketing" (kein Override)
// Result: { name: "Marketing", max_level: 2,
//           thresholds: { L1: 7, L2: 9 },
//           suffix: "_marketing" }
            

So funktioniert die Überschreibung:

1. Jede Custom-Audience startet mit den Anwender-Defaults: max_level=2, L1-Schwelle=7, L2-Schwelle=9.

2. Der User kann max L3 angeben, um die maximale Tiefe zu ändern. Wird max_level auf 3 gesetzt, wird automatisch ein L3-Schwellenwert angelegt (gleicher Wert wie L2).

3. Ein einzelner threshold 7 wird auf alle Levels angewendet.

4. Level-spezifische Werte (l1=6, l2=8, l3=9) überschreiben einzelne Levels.

5. Ohne jegliche Angabe: reine Anwender-Defaults. „Marketing“ ohne weitere Parameter bekommt exakt das gleiche Verhalten wie die Standard-Anwender-Audience.

✏️ Wissenstest

Ein Thema hat HS=8 für 👤 Anwender. Es befindet sich auf L1. Soll der Skill eine L2-Seite planen?

Ja — HS=8 ist hoch genug, weil der Schwellenwert 8 ist

Nein — Anwender brauchen HS ≥ 9 für L2, und 8 < 9

Kommt drauf an — wenn das Thema komplex genug ist, wird eine Ausnahme gemacht

🔧 Entwickler — Alle L3-Seiten

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