---
name: forschung-zu-thesis
description: Regelwerk für die Überführung von Forschungs-Logs und -Artefakten aus dem Schwester-Repo `research/` in wissenschaftlichen Thesis-Text (LaTeX). Diesen Skill IMMER konsultieren bei Übernahme aus LOG_SFD, LOG_STATS, LOG_DATA, LOG_FI, LOG_ML, LOG_BIE, LOG_LIT, LOG_CLD, LOG_DISPO, LOG_COACHING, HYPOTHESEN.md, DATENMODELL.md, PIPELINES.md; bei Berichten von Hypothesentests, Verwerfungsfällen, BIE-Zyklen, ML-Resultaten, SD-vs-ML-Vergleichen; bei Methodik-Reflexion, Limitationen, Gütekriterien; bei Strukturierung der Resultate-, Diskussions-, Schluss-Kapitel (Kap. 4–7). Erweitert wiss-schreiben-bsc um forschungs-spezifische Berichts-Formate. Triggert auch, wenn ein Ziel-Unterkapitel im LaTeX noch nicht existiert (Strukturvorschlag-Workflow). Trigger-Beispiele "übernimm aus LOG_SFD", "berichte H07", "schreibe Kap. 5.3 aus dem Forschungs-Log", "Verwerfungsfall B3 als Thesis-Text", "ML-Resultate aus PIPELINES.md", "BIE-Zyklus Z5 darstellen", "Limitationen aus den Forschungs-Logs", "Sterman-21.4-Tests berichten", "Modell-Boundary-Diskussion", "mach mir das Hypothesen-Kapitel", "synthese SD vs. ML", "Methoden-Reflexion schreiben", "übernimm Phase D aus LOG_SFD", "schreibe Resultate-Einleitung", "Iterationsbilanz aus den BIE-Zyklen".
---

# Forschungs-Log → Thesis-Text (BSc Yanick Fischer)

> Dieser Skill regelt, wie Inhalte aus dem Forschungs-Repo `research/` (im Schreib-Projekt via Symlink erreichbar) in wissenschaftlichen LaTeX-Thesis-Text überführt werden. Er ergänzt — nicht ersetzt — die anderen Skills.

**Abgrenzung:**

- **Stil, APA-Regeln, Anti-KI-Stilfallen, Plagiatsvermeidung, Schweizer Orthographie** → [`wiss-schreiben-bsc`](../wiss-schreiben-bsc/SKILL.md). Dieser Skill ist *immer* zuerst aktiv, dann der hier.
- **KI-Deklaration (Inline-Belege, Anhang-Verzeichnis, Methoden-Reflexion)** → [`ki-deklaration-bsc`](../ki-deklaration-bsc/SKILL.md).
- **Layout, Struktur-Pflichten, Umfang, Verzeichnisse** → [`formales-bsc`](../formales-bsc/SKILL.md).
- **Diagramme** → [`mermaid`](../mermaid/SKILL.md) (für Mermaid-Code); SFD/CLD-Snapshots aus Vensim sind extern (PDF-Einbindung).

**Verbindliche Vorab-Lektüre vor jedem grösseren Import:**

1. [`research-inventory.md`](../../../research-inventory.md) — Inventar mit Kapitel-Zuordnungs-Vorschlägen, Konflikt-Liste, Pilot-Empfehlung.
2. `research/CONTEXT.md` — aktueller Forschungsstand (Z6-bereinigt).
3. Das relevante Detail-Log für den jeweiligen Bereich (z.B. `research/3-Vensim-Modellierung/LOG_SFD.md` für SFD-Themen).

---

## 1. Grundprinzip

**Forschungs-Logs sind Steinbruch, nicht Quelle.** Die Thesis ist ein eigenständiges wissenschaftliches Dokument, das auf Logs aufsetzt, sie aber nicht zitiert (siehe Abschnitt 5 zur Quellen-Haltung). Logs enthalten:

- chronologische Entscheidungs-Historie (oft mit verworfenen Alternativen)
- methodische Reflexionen, eingebettet in den jeweiligen Phasen
- Statistiken, Tabellen, Verweise auf externe Quellen
- direkte Übernahmen aus externen Quellen (mit APA-Beleg)

**Aufgabe der Übernahme:**

- Aus dem Log die *zentrale, finale, zitierfähige Aussage* destillieren (nicht die Genealogie).
- Externe Belege aus dem Log mit-übernehmen — Citation-Key gegen `latex/bibliography/Bachelor-Thesis.bib` verifizieren.
- Verworfene Alternativen kommen nur dort in den Thesis-Text, wo sie methodisch belehrend sind (Diskussion, Limitationen).
- Tabellen / Statistiken können 1:1 übernommen werden, neu betitelt und mit Querverweis.
- falls im Statistiken, Zahlen und Resultate erwähnt werden, aber kein klarer Link zum jeweiligen Beweis dazu erkennbar ist, mit "TODO: Beleg fehlt" im Thesis-Text an der richtigen Stelle markieren — nicht raten, nicht stillschweigend übernehmen.

**Verbindliche Z6-Endwerte** (Modell-Freeze 20.05.2026 nachmittag):

- SFD: **R² 0.6936**, **MAPE 3.71 %**, **Bias −0.03 %**
- CLD-Loops: **6** (nach Konsolidierung 19.05., nicht mehr 7)
- SD-vs-ML-Vorsprung nach Z6: **+0.211 R²**

Ältere Werte in den Logs (R² 0.5846, 7 Loops, +0.105 R²) sind veraltet und dürfen *nicht* in den Thesis-Text wandern.

---

## 2. Workflow «Forschungs-Log → Thesis-Sektion»

Strikt in dieser Reihenfolge — jeder Sprung über einen Schritt produziert Drift oder Plagiat-Risiko.

### 2.1 Auftrag verstehen

- Welches Forschungs-Material? (Datei + Sektion im Log)
- Welches Ziel-Kapitel? (Pfad in `latex/chapters/`)
- Existiert die Ziel-Sektion schon, oder muss sie neu angelegt werden? → siehe Abschnitt 7.
- Erwarteter Umfang? (1 Absatz / 1 Unterkapitel / 1 ganzes Kapitel)

### 2.2 Quellenlage im Log prüfen

Bevor du schreibst, im Log identifizieren:

- Welche **externen Belege** sind im Log-Abschnitt bereits zitiert? Citation-Keys gegen `latex/bibliography/Bachelor-Thesis.bib` prüfen (mit `grep`).
- Gibt es im Log einen Block **«Zitierfähige Aussage»** (gilt insbesondere für `LOG_SFD.md` — laut Forschungs-CLAUDE der Gold-Standard-Log)? Solche Blöcke sind paste-ready und im Stil schon Thesis-tauglich.
- Welche **Stand-Daten** stehen im Log (Datum, Phase, Iteration)? Wenn vor 20.05. Z6-Bereinigung: gegen `CONTEXT.md` und Z6-Endwerte abgleichen.

### 2.3 Zentrale Aussagen destillieren

Pro Log-Sektion 3–5 Bullet-Aussagen aufschreiben (in deinem Arbeitsspeicher, nicht im Output), die wissenschaftliche Substanz tragen. Faustregel:

- *Was* wurde gemacht?
- *Warum* wurde es so gemacht (Methode, mit externer Begründung)?
- *Was* kam raus (mit Zahlen, Endwerten)?
- *Was* bedeutet das für die Forschungsfrage?

Verworfenes (Genealogie) raus, ausser methodisch belehrend.

### 2.4 Text formulieren

Regeln aus `wiss-schreiben-bsc` anwenden (Schweizer Hochdeutsch, kein Ich/Wir, APA-Belege unantastbar, Anti-KI-Marker prüfen). Berichts-Formate aus Abschnitt 3 dieses Skills nach Themen-Typ.

**Mini-Intro / Mini-Outro pro Hauptkapitel:** Pflicht-Konvention (siehe `wiss-schreiben-bsc` Abschnitt 4.1). Bei Übernahme in ein Hauptkapitel der Thesis (Kap. 4 Modellartefakte und Befunde, Kap. 5 Diskussion, Kap. 6 Schlussfolgerung) sicherstellen, dass das Ziel-Kapitel eine 1–2-Satz-Mini-Intro nach `\chapter{...}` und eine 1–2-Satz-Mini-Outro vor dem Kapitel-Ende hat. Bei Forschungs-Übernahmen besonders relevant, weil dort die Brückenbildung Befund → Diskussion → Schluss tragend ist. Wenn die Mini-Intro / Mini-Outro im Ziel-Kapitel fehlt: entweder erzeugen oder im Bericht (Abschnitt 9) als `Offener Punkt` melden.

### 2.5 Externe Belege setzen

- Wenn das Log einen `\parencite{key}` oder `(Autor, Jahr, S. X)` enthält: Beleg in den Thesis-Text mit-übernehmen.
- Wenn das Log eine **Aussage aus externer Literatur** verwendet, aber keinen Beleg im Log steht: **nicht raten**. Yanick fragen oder Stelle als `% Beleg fehlt — Yanick: bitte prüfen` markieren.
- Citation-Keys nie erfinden. Existenz mit `grep -i "<autor>" latex/bibliography/Bachelor-Thesis.bib` verifizieren.

### 2.6 Verifikation bei KI-Wissens-Zitaten

Aus der Inventur (siehe `research-inventory.md`, Konflikt-Sektion): mehrere Forschungs-Logs nennen KI-vermittelte Zitate aus Sterman, Sein, Barlas, Donkor mit Seitenzahlen. Vor Übernahme in die Thesis Pflicht-Check:

1. Citation-Key in Bib finden.
2. PDF-Pfad aus dem `file`-Feld lesen (zeigt auf `sources/<id>/...pdf` via Zotero-Symlink).
3. `pdftotext -layout "<pfad>.pdf" - | grep -nC2 "<Stichwort der zitierten Aussage>"` — die Aussage muss im PDF auffindbar sein.
4. Wenn nicht: Yanick fragen, nicht erfinden, nicht stillschweigend übernehmen.

Diese Verifikations-Pflicht ist konsistent mit dem Verifikations-Workflow in `wiss-schreiben-bsc` Abschnitt 3.1.

### 2.7 Build-Verifikation

Nach jedem Edit:

```bash
cd latex && touch main.tex && make 2>&1 | tail -10
```

Keine «citation undefined»- oder LaTeX-Errors. Bei `\abx@aux@*`: `make clean && make`.

### 2.8 Bericht an Yanick

Output-Format siehe Abschnitt 9.

---

## 3. Berichts-Formate pro Themen-Typ

### 3.1 Hypothesentests (APA-7)

Pro Hypothese H0X einen kompakten Block. Quelle: `research/4-QuantitativeAnalyse/LOG_STATS.md` und `Hypothesenregister.md`.

**Block-Struktur (Vorschlag):**

1. **Hypothesen-Statement** (H0: …, H1: …)
2. **Methode + Datengrundlage** (z.B. zweiseitiger t-Test, OLS-Residual-Fit, Konfounder-Kontrolle nach …)
3. **Befund** mit Teststatistik, p-Wert (oder Konfidenzintervall), Effektgrösse
4. **Interpretation in 1–2 Sätzen** (Was bedeutet das für die Forschungsfrage?)

**LaTeX-Beispiel (Fliesstext-Variante):**

```latex
Die Prüfung von Hypothese~H07 (saisonale Verschiebung des Spitzenlast-Bedarfs)
mittels zweiseitigem $t$-Test auf den Tagesresiduen 2015--2020 ergibt
$t(n{=}2{'}191) = 4{,}82$, $p < 0{,}001$ bei einer Effektgrösse von
$d = 0{,}21$. H0 wird verworfen; die Saisonalitäts-Hypothese stützt die
Strukturwahl im SFD (\cref{sec:sfd-saison}).
```

**Tabellenform** bei mehreren Hypothesen — `booktabs` + `tabularx` mit Spalten: ID, Hypothese, Methode, $n$, Teststatistik, $p$, Befund.

**Wichtig:**

- p-Werte mit Dezimalkomma (Schweizer Norm) — `p = 0{,}023`.
- Stichprobengrössen mit Tausenderapostroph: `n = 2{'}191`.
- «Signifikant» nur, wenn Statistik dahintersteht — sonst Anti-KI-Falle (`wiss-schreiben-bsc` Abschnitt 3.1).
- Bei nicht-Verwerfung: explizit «H0 wird nicht verworfen» — nicht «H1 bewiesen», nicht «kein Effekt».

### 3.2 Verwerfungsfälle (SFD-Erweiterungen, die rausgeflogen sind)

Sieben dokumentierte Cases (Stand Inventur): **B3b, B4, C2, C5, C6, D-4, D-5**, plus **D-X** (strukturell-aktiv, parametrisch-inaktiv) und **D-6** (Conditional Acceptance). Quelle: `research/3-Vensim-Modellierung/LOG_SFD.md`.

**Berichts-Block:**

1. **Was wurde geprüft** (Variable / Mechanismus / Polarität)
2. **Empirische Vor-Prüfung** (Hypothesentest, OLS, AIC/BIC)
3. **Cross-Validation-Ergebnis** (Train-R² vs. Test-R²)
4. **Begründung der Verwerfung** (Generalisierungs-Lücke, fehlende Erklärbarkeit, Overfit, kausale Unplausibilität)
5. **Methodische Lehre** (was zeigt der Fall über die Modellierungs-Disziplin?)

**Beispiel-Phrasierung:**

```latex
Die Erweiterung~C5 (variable Pro-Kopf-Konsumdynamik) zeigt im
Trainingsfenster 2015--2020 einen R²-Zuwachs von 0{,}012, fällt aber im
Test 2021--2022 mit $\Delta R^2 = -0{,}018$ zurück. Die kausale
Begründung der Variable bleibt unscharf; gemäss der in
\cref{sec:methodik-akzeptanz} festgehaltenen Akzeptanzregel
(Test-R² $\geq$ Train-R²) wird~C5 verworfen.
```

**Tabellarische Zusammenfassung** aller sieben Cases in Kap. 5 oder 6 — als Iterationsbilanz. Spalten: ID, Mechanismus, Vor-Prüfung, $\Delta R^2$ Test, Verwerfungs-Grund.

### 3.3 ML-Resultate / SD-vs-ML-Synthese

Quellen: `research/4-QuantitativeAnalyse/sas-pipeline-runs/LOG_ML.md`, `PIPELINES.md`, `LOG_FI.md`.

**Berichts-Block:**

1. **Pipeline-Setup** (SAS Viya / Python; Trainings-/Testfenster; verwendete Algorithmen; Hyperparameter-Suche)
2. **Champion-Genealogie** (welcher Run, welche Features, welche Konfiguration)
3. **Metriken** (R², RMSE, MAPE) mit Train- und Test-Werten
4. **SD-Modell-Vergleich** — auf identischem Test-Set
5. **Interpretation** (Erklärbarkeit, Generalisierung, Domänen-Plausibilität)

**SD-vs-ML-Tabelle:**

| Modell | $R^2_{\text{train}}$ | $R^2_{\text{test}}$ | MAPE | Erklärbarkeit |
|---|---|---|---|---|
| SFD (Z6-bereinigt) | … | **0.6936** | 3.71 % | hoch (kausale Struktur) |
| ML-Champion (SAS Viya) | … | 0.483 | … | gering (Permutation Importance) |

(Werte aus dem Log holen, nicht erfinden.)

**Interpretations-Leitlinie:** Der SD-Vorteil ist *kein* Beweis für SD-Überlegenheit allgemein, sondern für **diese Problemstellung mit diesen Daten**. Diese Vorsicht ist Pflicht.

### 3.4 BIE-Zyklen (Action Design Research)

Quellen: `research/5-BIE-Interventionen/LOG_BIE.md` und die Per-Meeting-Detail-Logs `research/5-BIE-Interventionen/Zyklus*/Z*_Meeting-Notes_*.md`.

**Pro Zyklus (Z1–Z6):**

1. **Build** — was wurde dem WVZ-Praxispartner gezeigt
2. **Intervene** — wie wurde die Intervention durchgeführt, welche Daten / Reaktionen kamen
3. **Evaluate** — welche methodischen oder modellbezogenen Konsequenzen wurden gezogen

**Iterationsbilanz** (Tabelle in Kap. 5 oder 6, z.B. `5.4-iterationsbilanz.tex`) — Spalten: Zyklus, Datum, Fokus, B / I / E, Konsequenz.

Verweis auf die Meeting-Notes als Forschungs-internes Material — keine externe Zitation, aber Beleg-Hinweis im LaTeX-Kommentar (`% Quelle: research/5-BIE-Interventionen/Zyklus5/Z5_Meeting-Notes_2026-05-13.md`) erleichtert Yanick die Rückverfolgung.

### 3.5 Methodik-Reflexion, Limitationen, Gütekriterien

Laut Yanick **kein dediziertes File** im Forschungs-Repo — Reflexionen sind in den LOG_*.md eingebettet. Vor dem Schreiben:

1. `grep -rn -i "limitation\|stolperstein\|reflektion\|reflexion\|gütekriterien\|limit\|verworfen" research/` — Fundstellen sammeln.
2. Pro Thema einen Bullet-Auszug erstellen.
3. Synthese im Thesis-Text — typischerweise:
   - **Kap. 4 (Methodik):** Gütekriterien (Sterman-21.4 + 21.5-Tests, Cross-Validation, Empirie-First-Disziplin)
   - **Kap. 6 (Diskussion):** Limitationen, methodische Reflexion, Verwerfungen als Lehre
   - **Kap. 7 (Schluss):** Aussagekraft, Übertragbarkeit, Forschungsausblick

**Sterman-Validitätstests** (Sterman 2000, Kap. 21.4 + 21.5) sind in `LOG_SFD.md` komplett dokumentiert — paste-ready für Kap. 4 oder 5.

---

## 4. «Zitierfähige Aussagen»-Blöcke aus LOG_SFD.md

`LOG_SFD.md` (4147 Zeilen) enthält pro Phase explizit markierte **«Zitierfähige Aussage»**-Blöcke. Diese sind:

- bereits in wissenschaftlichem Stil formuliert
- mit Endwerten (Z6-bereinigt, falls jüngere Phase)
- mit externen Belegen, sofern relevant

**Workflow:**

1. Block identifizieren (Suche im Log nach «Zitierfähige Aussage» oder ähnlichem Marker)
2. Mit Z6-Endwerten abgleichen (siehe Abschnitt 1)
3. In den Thesis-Text einsetzen
4. **Stil-Check** mit `wiss-schreiben-bsc` (auch zitierfähige Blöcke sind keine Garantie gegen Bluff-Adjektive)
5. Externe Belege gegen Bib verifizieren

---

## 5. Quellen-Haltung: eigene Befunde vs. externe Literatur

Drei Kategorien — sauber zu unterscheiden im Thesis-Text:

### 5.1 Eigene Forschungs-Befunde

Beispiele: SFD-Endwerte, Hypothesentest-Ergebnisse, BIE-Zyklus-Befunde, Permutation Importance Rankings.

- **Kein externer Beleg** möglich (es gibt keinen).
- Innerhalb der Thesis mit `\cref{sec:...}` oder `\cref{tab:...}` referenzieren.
- *Nicht* als unbelegte Behauptung formulieren — der Kontext (Methodikkapitel, Resultatekapitel) macht klar, dass es ein Befund dieser Arbeit ist.
- *Nicht* die Forschungs-Logs als Quelle zitieren — Logs sind nicht publiziert, nicht referenzierbar, sondern Arbeitsmaterial.

### 5.2 Externe Literatur

Beispiele: Sterman-Validitätstests, ADR-Definition (Sein et al.), Donkor-MAPE-Schwelle.

- `\parencite{key}` / `\textcite{key}` mit verifiziertem Bib-Key und Seitenangabe.
- Bei KI-vermittelten Seitenangaben → Verifikation Pflicht (Abschnitt 2.6).

### 5.3 Disposition als Selbstzitat

Yanicks Disposition (`0_Archiv/1-Disposition/VFinal_…`) wurde am 19.03.2026 als eigenständige Prüfungsleistung abgegeben. Übernahmen in die Thesis sind nach `wiss-schreiben-bsc` Abschnitt 6 **als Selbstzitat zu behandeln** (vgl. dortige Regel). Falls Yanick eine andere Konvention bevorzugt (Disposition als integraler Vorprozess der gleichen Arbeit), darf das nur nach expliziter Bestätigung angepasst werden.

---

## 6. Strukturvorschlag bei fehlendem Ziel-Unterkapitel

Wenn beim Mapping ein Forschungs-Inhalt in ein Ziel-Unterkapitel müsste, das im LaTeX noch nicht existiert (typisch: `06-diskussion.tex` und `07-schlussfolgerung.tex` ohne Sub-Files; einzelne Sub-Sektionen in Kap. 5).

**Workflow:**

1. **Vorschlag formulieren** — pro Kapitel eine Sub-Struktur in Bullet-Form, mit Begründung je Unterkapitel.
2. **Yanick zur Bestätigung** vorlegen — *vor* dem Anlegen der `.tex`-Stubs.
3. **Nach Bestätigung:** `.tex`-Stub anlegen (Header, `\label{sec:...}`, leere oder Platzhalter-Sektionen), Wrapper-File mit `\input{...}` aktualisieren, Build verifizieren.
4. **Erst dann** den Forschungs-Inhalt in den neuen Stub einsetzen.

**Beispiel** für Kap. 6 (Diskussion) — Vorschlag:

```
6.1 Hauptbefunde im Überblick
6.2 SFD-Modell: strukturelle Geltung und Grenzen
6.3 Hypothesen-Befunde im Kontext der Literatur
6.4 SD vs. ML: methodische Triangulation
6.5 BIE-Zyklen: Erkenntnisse aus der Praxispartnerschaft
6.6 Limitationen
6.7 Methodische Reflexion
```

Den Vorschlag *immer* mit dem Inventur-Mapping (`research-inventory.md`) abgleichen — der Inventur-Bericht enthält pro Bereich einen Kapitel-Zuordnungs-Vorschlag.

---

## 7. Figure-Konventionen für Forschungs-Diagramme

Drei Typen kommen aus der Forschung:

### 7.1 Vensim-Snapshots (CLD, SFD)

- Aus Vensim als PDF exportieren (View → Print to PDF).
- Ablegen unter `latex/figures/vensim/<name>.pdf`.
- Einbinden mit `\includegraphics[width=\linewidth]{figures/vensim/<name>}`.
- Caption: Was zeigt das Diagramm, welche Phase / welcher Stand (Z6-Bereinigung), Quelle (eigene Darstellung).

**Beispiel:**

```latex
\begin{figure}[h]
  \centering
  \includegraphics[width=\linewidth]{figures/vensim/sfd-phase-d}
  \caption[SFD nach Phase D]{Stock-and-Flow-Diagramm des Wasserverbrauchs-Modells
    nach Phase D (Stand 20.05.2026, Z6-bereinigt). Eigene Darstellung,
    Modellierung in Vensim Pro 9.}
  \label{fig:sfd-phase-d}
\end{figure}
```

### 7.2 Mermaid-Diagramme

Konsistent mit [`mermaid`](../mermaid/SKILL.md): Quellen in `latex/figures/mermaid/<name>.mmd`, gerendert als PDF (`mmdc -i ... -o ... -b transparent --pdfFit`). Einbindung wie 7.1.

**Pflicht-Deklaration:** KI-generierter Mermaid-Code zählt als KI-Bilderstellung → Eintrag in `latex/appendices/ai-disclosure.tex` mit Verwendungszweck «Erstellung von Diagrammen mit Mermaid». Details in `ki-deklaration-bsc`.

### 7.3 Statistik-Plots (SAS, Python)

- Direkt aus SAS Viya bzw. matplotlib als PDF/PNG exportieren.
- Ablegen unter `latex/figures/stats/<name>.<ext>`.
- Caption: Methode, Datengrundlage, Tool — z.B. «Permutation Importance, RandomForest auf Test-Set 2021–2022, n = 730 Tage. Eigene Berechnung, Python 3.11.»

---

## 8. KI-Tool-Deklaration: Forschungs-Tools

Die Forschungsphase verwendete Tools, die im aktuellen `latex/appendices/ai-disclosure.tex` möglicherweise noch nicht aufgeführt sind. Pflicht-Check bei jedem Import:

| Tool | Wofür eingesetzt | Im KI-Verzeichnis? |
|---|---|---|
| Vensim Pro 9 (Ventana Systems) | Modellbildung CLD/SFD | Nicht-KI — Software, kein Eintrag |
| SAS Viya | ML-Pipeline | Nicht-KI — Eintrag nur, wenn AutoML / Insights generative KI nutzt |
| Python (RandomForest, Permutation Importance) | Feature Importance | Nicht-KI |
| ChatGPT / Claude / Perplexity / NotebookLM | Schreibhilfe, Literatur-Sondierung | Pflicht-Eintrag (bereits in `ai-disclosure.tex`) |
| DeepL | Fachbegriff-Übersetzung | Pflicht-Eintrag bei Verwendung |
| Mermaid (KI-generierter Code) | Diagramm-Erstellung | Pflicht-Eintrag, wenn KI Code geliefert hat |

Details und Inline-Beleg-Format in [`ki-deklaration-bsc`](../ki-deklaration-bsc/SKILL.md).

---

## 9. Output-Format

Nach jedem Forschungs-Import einen strukturierten Bericht an Yanick:

```
## Forschungs-Import: <Bereich> → <Ziel-Kapitel>

### Geschriebener Text
[der eingesetzte LaTeX-Code oder Verweis auf editierte Dateien]

### Quell-Mapping
- LOG <Datei>:<Zeilenbereich> → latex/chapters/<...>:<Sektion>
- (alle Quellen sauber aufgeführt)

### Externe Belege
- \parencite{<key>} — verifiziert: ja/nein/TBD
- (Liste aller im Text gesetzten Belege)

### KI-Wissens-Verifikation
- <Bib-Key>:<Seite> — verifiziert gegen <PDF-Pfad>: ja/nein
- (nur wenn KI-vermittelte Belege übernommen wurden)

### Strukturelle Änderungen
- <Datei> neu angelegt
- <Wrapper-File> aktualisiert mit \input{...}

### Build-Verifikation
- Output von `make` (letzte 5–10 Zeilen) — keine «citation undefined»

### Offene Punkte / TBD
- [Liste der Stellen, die Yanick prüfen muss]
- [Bib-Keys, die fehlen]
- [Verifikations-Pflichten, die nicht durchgeführt werden konnten]

### Aktualisierungen an PLAN.md
- Status-Tabelle: <Kapitel> auf <neuer Stand>
```

---

## 10. Pre-Check vor jedem Import

- [ ] `research-inventory.md` für den relevanten Bereich gelesen (Mapping + Konflikte + Empfehlungen)
- [ ] Z6-Endwerte als Referenz präsent (R² 0.6936, MAPE 3.71 %, 6 Loops)
- [ ] Ziel-Unterkapitel existiert — oder Strukturvorschlag-Workflow gestartet (Abschnitt 6)
- [ ] `wiss-schreiben-bsc` aktiv (Stil, APA, Anti-KI, Schweizer Orthographie)
- [ ] Externe Belege im Log identifiziert, Bib-Keys verifiziert
- [ ] KI-Wissens-Zitate identifiziert, Verifikations-Plan steht (Abschnitt 2.6)
- [ ] Build vor dem Edit grün (`make 2>&1 | tail -5`)
