---
name: av-guardrails
description: Meta-Skill des 7-Dimensionen-Readiness-Audits, der jeden Output ehrlich hält — vergibt die Evidenz-Labels MEASURED/VERIFIED/HYPOTHESIS/MISSING_DATA, erzwingt die Non-Negotiable-Truth-Rules (keine Ranking-/Traffic-/Citation-/Revenue-Garantien, Daten + Datum immer zeigen, bei fehlenden Daten „not measured" statt 0) und die Human-Review-Gates G1–G5. Nutzen, bevor irgendein Dimensions- oder Report-Output freigegeben wird.
---

# av-guardrails — Wahrheits- und Freigabe-Leitplanken

Querschnitt-/Meta-Skill für das gesamte Search-&-AI-Readiness-Audit. Er bewertet keine Dimension selbst, sondern **prüft und labelt** die Outputs der anderen Skills, damit kein Score, keine Beobachtung und keine Empfehlung das Audit über das hinaus verspricht, was die Evidenz hergibt.

## Wann nutzen

- Bevor ein Dimensions-Score (av-organic-reach, av-tech-discoverability, av-evidence-trust, av-actionability u.a.) oder der Gesamtreport freigegeben wird.
- Wenn ein Output auf Garantie-Sprache, fehlende Datums-/Quellenangaben oder „0 statt not measured" geprüft werden soll.

## Methode

### 1. Evidenz-Labels vergeben (aus 02_AI_SKILL_AND_GUARDRAIL_SPEC)

Jeder Output trägt genau eines:
- `MEASURED` — direkt aus angebundenem Tool/API/Export.
- `VERIFIED` — manuell gegen eine Live-URL / Quelle geprüft.
- `HYPOTHESIS` — plausibel, aber noch nicht verifiziert.
- `MISSING_DATA` — nicht ableitbar.

### 2. Non-Negotiable-Truth-Rules erzwingen

1. Niemals externe Daten erfinden.
2. Niemals eine Inferenz zur Tatsache machen.
3. Datenquelle + Datum **immer** zeigen.
4. Niemals ein Ranking-, Traffic-, Lead-, Conversion-, Citation- oder Revenue-Ergebnis garantieren.
5. Niemals eine generische Idee ohne offizielle Quelle als „Google-Anforderung" ausgeben.
6. Bei regulierten Themen: Experten-Review vor Veröffentlichung.
7. Bei fehlenden Daten „**not measured**" sagen statt 0 zu scoren.
8. **Score-Validität vor Interpretation.** Ein Score zählt nur, wenn die zugrunde liegende Seite
   **voll gecrawlt** wurde. Body-blinde/abgeschnittene Crawls (kein Body-H1 trotz erfolgreichem Fetch),
   nicht crawlbare Seiten und reine Schätz-Profile (alle Achsen B/C) werden **sichtbar geflaggt statt
   still publiziert** (`validity_warnings` + Validitäts-Block im Report). Vorher prüft das
   deterministische **SEO-Grundpräsenz-Gate**, ob die Seite überhaupt Auffindbarkeit betreibt.
9. **Floor-Effekt offenlegen.** Liegen Marke und Peer-Median niedrig, AVI-Achsen relativ zum Peer lesen,
   nicht als absolute 0–100-Note — sonst liest sich Nischen-Normalität als Versagen.

Garantie-Sprache ersetzen durch: „erwarteter Beitrag", „zu validierende Hypothese" oder „reduziert eine dokumentierte Zugangs-/Abdeckungs-Lücke".

### 3. Confidence-Grade prüfen

Kein client-seitiger Spider-Score ohne Confidence-Grade darunter:
- `A / High` — First-Party-Daten und/oder repliziert + dokumentiert.
- `B / Medium` — direkte öffentliche Inspektion + kontrollierte Tests.
- `C / Directional` — öffentlicher Proxy / unvollständiger Zugang.

### 4. Human-Review-Gates G1–G5 durchsetzen

- **G1** — kommerzieller Brief freigegeben.
- **G2** — Keyword-/SERP-Strategie freigegeben.
- **G3** — technische Fixes vom Entwickler freigegeben.
- **G4** — Gesundheits-/Rechts-/Finanz-Inhalt von qualifiziertem Reviewer freigegeben.
- **G5** — finaler Client-Report vom Strategen freigegeben.

## Inputs

- Der zu prüfende Output (Dimensions-JSON, Maßnahme, Report-Abschnitt).
- Access-Flags + `regulated_topic` aus dem Intake (av-intake) für Confidence- und G4-Logik.

## Output-Format (JSON)

```json
{
  "checked_artifact": "axis:organic_search_reach",
  "evidence_label": "VERIFIED",
  "confidence": "C",
  "truth_rule_violations": [],
  "rewrites": [{"from": "verbessert die KI-Sichtbarkeit", "to": "erwarteter Beitrag, zu validieren"}],
  "gates_required": ["G4", "G5"],
  "verdict": "pass | needs_rework"
}
```

## Guardrails (für diesen Skill selbst)

- Im Zweifel **strenger** labeln (eher HYPOTHESIS/MISSING_DATA als MEASURED).
- Ein Score ist nur zulässig, wenn Formel, Zähler, Nenner, Gewichtung, Datenquelle, Aktualität und Confidence offenliegen.
- Scores verschiedener Clients nicht vergleichen, außer Markt, Prompt-Set, Engine, Zeitfenster und Methodik sind vergleichbar.

## Verwandte Skills

- **av-intake** — liefert Access-Flags + Regulated-Flag.
- **Alle Dimensions-Scorer** — deren Outputs werden hier gelabelt und auf Truth-Rules geprüft.
- **av-gap-strategist / Report** — erhalten nur Truth-Rule-konforme, gelabelte Eingaben.