← Syntagma Forschung · Iterationsprüfer · FORSCH-PROV0459 · Anleitung · Paket v0.1.0 (ZIP, AGPL-3.0) · Technik

FORSCH-PROV0459_anleitung_v1.0_2026-10-06_doku

title: “Iterationsprüfer — Anleitung für Nutzende”
kennung: “FORSCH-PROV0459”
author: “Thomas Schüller”
date: “2026-10-06”
license: “CC BY 4.0”
zweck: “Bedienung”

Anleitung

Wofür

Sie haben einen Text, der von einem Sprachmodell stammt, und wollen ihn weiterverwenden — als Quelle, als Ausgangspunkt, als Material. Der Iterationsprüfer sagt Ihnen, ob dieser Text eine Prüfung behauptet, die er nicht durchgeführt hat.

Er sagt Ihnen nicht, ob der Text fachlich stimmt. Das bleibt Ihre Aufgabe.

Schnellstart

Text in eine Datei speichern, dann:

python3 -m iterationspruefer meintext.md

Sie bekommen einen Bericht mit einem Gesamtwert, einer Empfehlung und den Belegstellen.

Den Bericht lesen

Der Gesamtwert liegt zwischen 0,00 und 1,00. Darunter steht eine von drei Empfehlungen.

Wert Empfehlung Was das heißt
unter 0,30 akzeptieren keine Auffälligkeit in den geprüften Dimensionen
0,30 bis 0,60 mit Vorbehalt als Modellmaterial kennzeichnen, Primärquelle ergänzen
über 0,60 ablehnen nicht als Quelle nutzen, höchstens als Beispiel

Die Markertabelle zeigt, woher der Wert kommt. Marker mit „n/a” sind in dieser Fassung nicht gebaut; der Gesamtwert ist deshalb eher zu niedrig als zu hoch.

Die Belegstellen sind das Eigentliche. Jede nennt die Zeichenposition und den Grund. Lesen Sie die Stellen, bevor Sie dem Wert glauben.

Die Marker in einem Satz

Marker Fragt
M1 Werden verworfene Vorschläge benannt, mit Grund?
M2 Stehen die Bewertungsmaßstäbe vor oder nach der Auswahl?
M3 Wird Bekanntes als neu dargestellt? (noch nicht gebaut)
M3b Fehlen die erwartbaren Quellen des Fachgebiets? (noch nicht gebaut)
M4 Stehen starke Urteile ohne Beleg? (noch nicht gebaut)
M5 Werden Zahlen präziser, ohne belegter zu werden?

Häufige Fälle

Der Wert ist hoch, aber der Text ist ein Lehrtext. Lehrtexte vereinfachen und reframen bewusst. Das Werkzeug kann das nicht unterscheiden. Prüfen Sie, ob der Text sich als Lehrtext zu erkennen gibt oder als Forschungsvorgang auftritt. Nur das Zweite ist das Problem.

Der Wert ist niedrig, aber der Text kommt mir falsch vor. Das Werkzeug prüft die Form, nicht den Inhalt. Ein sauber gebauter Text kann sachlich falsch sein.

Ich will eigene Wortlisten. Die Listen stehen am Kopf von iterationspruefer/marker.py. Nach jeder Änderung den sauberen Referenztext prüfen: er muss bei 0,00 bleiben.

Weiterverwendung der Ausgabe

python3 -m iterationspruefer text.md --format json --out bericht.json

Die JSON-Ausgabe folgt einem werkzeugübergreifenden Analyse-Schema und lässt sich in andere Auswertungen übernehmen.

Was das Werkzeug nicht tut

Es ruft kein Sprachmodell auf. Es sendet nichts ins Netz. Es speichert nichts außerhalb der von Ihnen angegebenen Ausgabedatei. Der Eingangstext wird nur gehasht, damit Sie Berichte später zuordnen können.