Repository navigation
Releases
STG-DE v0.5.0
Agent Skill
- Der Skill verlangt nach jedem WRITE und REWRITE einen erneuten Lauf des Linters mit dem Endergebnis. Der Agent behebt jeden Befund mit der Stufe
error, bevor er das Ergebnis zurückgibt. Ein vages Wort wieggf.oderzeitnahersetzt der Agent durch die genaue Bedingung oder Frist aus dem Ausgangstext, sonst schreibt er eineHinweis:-Zeile. In den Evaluationen waren solche Wörter die häufigste Ursache für Fehler.
Linter
STG-8.1meldet kein Semikolon zwischen Listeneinträgen mehr, zum Beispiel zwischen Autoren (Apfeld, R.; Schaefer, M.), Normen (IEC 60601-1; IEC 60601-1-2) oder Werten (-7,5; +15). Auf dem Holdout waren 10 von 12 Befunden dieser Art falsch. Semikolons zwischen Aussagen bleiben ein Fehler.
Evaluation
- Wiederholung der Evaluation mit dem korrigierten Skill in
evals/results/2026-11-12-rerun.md: Claude besteht 115 von 115 Prüfungen, Codex 112 von 115. tools/run_evals.pyliest füravoids …dieHinweis:-Zeile nicht mehr mit und erkennt dieErgebnis:-Zeile auch mit Markdown wie**FAIL**.
Struktur des Repositorys
- Der Code von Linter, Analysewerkzeug und Vergleich steht nur noch in
stg_de/. Die Kopien intools/sind entfernt. Der Skill enthält auch in Zukunft eine Kopie inscripts/, weil der Skill ohne das Repository funktionieren muss. Die GitHub Action und die Dokumentation verwendenstg_de/stg_lint.py. STG-DE.mdundmanifest.yamlsind nicht mehr im Repository. Der Release-Workflow erzeugt beide Dateien und hängt sie an das GitHub-Release an.- Die Zahlen zu Regeln, Wörterbuch, Zuordnung und Korpus stehen nur noch in
README.md.tests/test_readme_counts.pyvergleicht diese Zahlen mit den Daten.dictionary/coverage.yamlist entfernt. - Die Dokumente auf der obersten Ebene heißen einheitlich in Großbuchstaben:
SPECIFICATION.md,SOURCES.md,VALIDATOR-CONTRACT.md. dictionary/GOVERNANCE.mdist jetzt der Abschnitt „Lexikalische Änderungen“ inGOVERNANCE.md. Die Vorlage für lexikalische Vorschläge steht jetzt inproposals/LEX-CHANGE-TEMPLATE.yaml.
STG-DE v0.4.0
Neue Nummerierung der Releases
- Die Releases heißen jetzt 0.1.0 (vorher 0.4.0), 0.2.0 (vorher 0.5.0) und 0.3.0 (vorher 0.6.0). Die Entwürfe vor dem öffentlichen Repository heißen 0.0.1 bis 0.0.3.
- Die Historie des Repositorys ist umgeschrieben. Die Dateien der alten Stände nennen die neuen Nummern. Die Tags
v0.1.0,v0.2.0undv0.3.0zeigen auf diese Stände.
Aufräumen
ROADMAP.mdnennt nur noch offene Arbeit. Erledigte Arbeit steht in diesem Änderungsprotokoll.- Die Vale-Regeln in
vale/sind entfernt. Der Linter prüft dieselben Fälle. - Die Dateien des alten Korpus aus 0.1.0 sind entfernt, auch
tools/corpus_validate.py. - Neue Namen ohne Version:
corpus/fulltext-sources.yaml,corpus/fulltext-metrics.yaml,tools/build_corpus.py. - Die Werte von
review_statusim Wörterbuch haben keine Version mehr, zum Beispielprovisional. - Ein Test prüft die Daten von Wörterbuch und Regelindex gegen die JSON-Schemas in
schemas/. build_standalone.py --checkprüft in der CI, dassSTG-DE.mdzu den Quelldateien passt.
Modalität von Empfehlungen (STG-2026-002)
STG-GR-5bleibt eine Empfehlung. Der Text verwendet jetzt den Imperativ statt „dürfen nicht“.STG-DE-4.5: Ein Validator muss ein Pronominaladverb mit ungeklärtem Bezug zur Prüfung melden. Vorher war diese Meldung eine Empfehlung.- Spezifikation Abschnitt 10: Veröffentlichte Regel-IDs müssen auch vor 1.0 stabil bleiben. Ein Satz mit „Wir empfehlen“ ist auch in einer Pflichtregel eine Empfehlung.
dictionary/README.mdnennt jetzt dieselbe Reihenfolge der Auflösung wiedictionary/MORPHOLOGY.md: zuerst die Morphologie, danach die Sperrliste.dictionary/DECISIONS.mdnennt den Autorenkern bis Version 0.1.
Korpus: Branchen und Textsorten (Issue #18)
- 15 neue öffentliche Quellen in
corpus/v0.2-sources.yaml. Die neuen Domänen sind Embedded und IoT, funktionale Sicherheit, Produktsicherheit, Messtechnik, IIoT und Energietechnik, Finanzen, B2B-Software und Texte für Agenten. Eine neue Quelle ist ein zweites Medizinprodukt. Neue Textsorten sind Release Notes, Anleitungen für Firmware-Updates, Anforderungsspezifikationen, FAQ für Hersteller und Anweisungen für Agenten. - Das Korpus hat jetzt 359.075 Token aus 28 Quellen.
- Jede Quelle hat jetzt die Felder
text_type,organization,accessed_onundextraction_method. - Eine Obergrenze von 10.000 Token je Quelle gleicht die Kennzahlen aus (
capped_tokens,capped_coverage). Die größte Quelle hat jetzt 9,4 % der begrenzten Token. Vorher hatte das Medizinhandbuch 59 % aller Token. - Neue Holdout-Partition mit 7 Quellen. Die 4 Quellen der Messung für Linter 0.3.0 sind jetzt in der Entwicklungspartition (
previous_partition: holdout, Protokoll Abschnitt 9). build_corpus_v02.pyliest Textdateien auch in der Kodierung cp1252, meldet Kennzahlen je Textsorte und liest die Version auspyproject.toml.
Evaluation und Beispiele
- 7 neue Fälle in
evals/cases.yaml. Die Fälle sind eine Anforderung nach dem Muster EARS, eine Sicherheitsanforderung mit SIL, Release Notes, eine Meldung einer Schwachstelle und eine Prüfanweisung. Dazu kommen eine Anleitung für ein Firmware-Update und ein Audit. - Vier Beispiel-Glossare in
examples/glossaries/: Embedded und IoT, funktionale Sicherheit, Produktsicherheit, Medizinprodukte.
Werkzeug für die Präzisionsmessung (Issue #19)
- Fehler korrigiert: Die Stichprobe der Sätze ohne Befund konnte Sätze mit einem gemeldeten Wort enthalten. Der Linter meldet ein Wort aus der Sperrliste nur einmal je Dokument. Das Werkzeug prüft jetzt jeden Satz der Stichprobe einzeln.
- Die Bewertungsdatei enthält jetzt die Quellen mit Hash und die Version des Linters.
scoreverwendet diese Quellen. - Neue Bewertung
skip: Ein Eintrag zählt dann nicht in den Kennzahlen. - Neue Optionen
--sourcesund--prefillfürsample.
Präzision auf dem Holdout (Issue #3)
- Neues Werkzeug
tools/holdout_precision.py: Stichprobe von Befunden auf dem Holdout, Bewertung und Kennzahlen. Fremder Text bleibt außerhalb des Repositorys. - Erste Messung für Linter 0.3.0 in
corpus/HOLDOUT-PRECISION.mdundcorpus/holdout-precision.yaml: 92,9 % Präzision ohne Extraktionsfehler, 57 % der Befunde sind Extraktionsfehler. Ein Modell hat bewertet, ein Mensch hat die Bewertung noch nicht geprüft.
Linter
- Befunde zu
STG-1.1nennen jetzt den ersten Satz mit dem Wort und die Zahl der Sätze mit dem Wort (occurrences). •,‣,◦,▪,▸,→und–am Zeilenanfang gelten als Listenpunkte.- Abkürzungen wie
bzw.,z. B.,ca.,Nr. 5,Abb. 3und Datumsangaben wie31. Dezemberbeenden keinen Satz mehr. Linter und Analysewerkzeug verwenden dieselbe Satztrennung ausstg_markdown.py. - Der Linter wertet das Feld
surface_formsder Sperrliste aus. 20 gesperrte Adjektive haben gebeugte Formen erhalten, zum Beispielaktuellenundeinfache.
Ergebnisse der Evaluation
- Erste veröffentlichte Ergebnisse in
evals/results/2026-11-12.md: Claude Code und Codex, jeweils mit Skill und ohne Skill. Mit Skill bestehen 94,8 % und 97,4 % der Prüfungen, ohne Skill 81,7 % und 82,6 %. run_evals.pystartet die CLI jetzt in einem leeren temporären Verzeichnis (--workdir). Der Agent liest dann nicht die Regeln des Repositorys.- Skill: Konformer Text bleibt in WRITE und REWRITE ohne Kommentar. Ein allgemeiner Vorschlag für mehr Genauigkeit ergibt im AUDIT kein
PASS WITH REVIEW.
Zweite Messung der Präzision
- Messung des Linters nach 0.3.0 auf den 7 neuen Holdout-Quellen: 79,8 % Präzision ohne Extraktionsfehler, 197 Befunde.
- Zwei Modelle von zwei Anbietern bewerten jeden Befund unabhängig. Die Modelle hatten bei 93 % der Einträge dasselbe Label.
- Die Prüfung
STG-8.1meldet Semikolons in Listen von Namen und Normen. 10 von 12 dieser Befunde sind falsch. Die Korrektur steht inROADMAP.md.
Ordnung und Konsistenz
validate_release.pyprüft die Zahl der Quellen gegen die Daten des Korpus statt gegen eine feste Zahl.AGENTS.mdenthält jetzt die einzige Liste der Prüfungen vor einem Commit.CONTRIBUTING.mdundREADME.mdverweisen auf diese Liste.VERSIONING.mdlegt fest:schema_versionist die Version des Dateiformats.profiles/profiles.yamlhat jetztschema_version0.2.- Veraltete Titel mit „v0.1“ und englische Überschriften sind korrigiert.
validator-contract.mdbeschreibt jetzt die echten Statuswerte und Schweregrade des Linters. quality/RULE-COVERAGE.mdstimmt jetzt mitquality/rule-coverage.yamlüberein (19 implementierte Regeln).- Der Vorschlag STG-2026-001 hat den Dateinamen
STG-2026-001-form-of-address.md. - CI prüft jetzt auch
CHANGELOG.mdmit dem Linter.
Verpackung
pyproject.tomlverwendet die Lizenzangabe nach PEP 639.
STG-DE v0.3.0
Diese Version macht STG-DE in OpenAI Codex nutzbar und automatisiert Release und Aufräumen auf GitHub. Regeln, Wörterbuch und Werkzeuge bleiben inhaltlich gleich.
OpenAI Codex
- Das Repository ist ein Codex-Plugin:
.codex-plugin/plugin.jsonund der Marketplace.agents/plugins/marketplace.json. agents/openai.yamlfolgt den Vorgaben von Codex: kurze Beschreibung mit 25 bis 64 Zeichen und ein Standard-Prompt mit$simplified-technical-german.SKILL.mdnennt die Pfade der Skripte relativ zum Ordner des Skills. Codex führt Befehle im Projektverzeichnis aus.- Das README beschreibt die Installation in Codex als Plugin, über
$skill-installerund als Ordner in.agents/skills/. - Tests prüfen Manifest, Marketplace und
agents/openai.yaml.
Automatisierung auf GitHub
- Der Workflow
Releaseist auch manuell startbar (workflow_dispatchmitversion). Er erstellt dann den Tag aufmainselbst. Die Notizen kommen aus dem Abschnitt der Version inCHANGELOG.md. - Neuer Workflow
Clean up branches: Er löscht den Branch eines gemergten Pull Requests automatisch. Ein manueller Start löscht alle Branches ohne eigene Commits außerhalb vonmain.
STG-DE v0.2.0
0.2.0 — 2026-11-12
Diese Version ist die erste Version, deren Werkzeuge und Agent Skill für den praktischen Einsatz vorgesehen sind. Die kontrollierten Bedeutungen im Wörterbuch bleiben gleich. Alle veröffentlichten Regel-IDs bleiben stabil.
Anrede (STG-2026-001)
STG-5.3erlaubt jetzt die Anredeformensie(Standard),duundinfinitiv. Ein Dokumentsatz verwendet genau eine Form. Die Einstellunganredesteht in.stg-de.yaml. Neuer Titel: „Anweisungen in einer festgelegten Anredeform“.stg_lint.pyprüftSTG-5.3:errorbei einer anderen als der festgelegten Anrede,warningbei gemischter Anrede ohne Festlegung. Neue Option--anrede.- Der Skill behält bei REWRITE die Anrede des Originals bei, wenn das Projekt keine Anrede festlegt.
- Neues Schema
schemas/project.schema.jsonfür.stg-de.yaml.
Dokumentation auf Deutsch
- Die Prosa des Repositorys ist jetzt deutsch und folgt selbst STG-DE. Das README enthält einen kurzen Abschnitt auf Englisch.
- Die Markierungen
<!-- stg-lint: off -->und<!-- stg-lint: on -->schließen absichtlich nicht konforme Beispiele von der Prüfung aus.
Zuordnung zu ASD-STE100
- Neue Datei
mapping/ste100-issue9.yaml: Alle 53 Schreibregeln und 8 Empfehlungen von ASD-STE100 Issue 9 sind STG-DE zugeordnet (35 gleich, 15 angepasst, 3 ersetzt). Jede STG-DE-Regel ist rückverfolgbar. Tests undvalidate_release.pyprüfen die Vollständigkeit. - Neue Datei
NOTICE.md. Das Repository enthält keinen Regeltext, keine Beispiele und keine Wörterbucheinträge aus ASD-STE100.
Werkzeuge
stg_lint.pyprüft mehrere Dateien und Verzeichnisse und gibt Zeilennummern aus. Neu sind--fail-on {error,warning,review,never},--format githubfür Annotationen in Pull Requests und das automatische Laden von./.stg-de.yaml(--no-projectschaltet das Laden ab).stg_lint.pyundstg_analyze.pyzerlegen Markdown korrekt in Blöcke (Codeblöcke, HTML-Kommentare, Überschriften, Listenpunkte, Tabellenzellen). Die gemeinsame Logik steht instg_markdown.py. Vorher zählte eine ganze Markdown-Liste als ein Satz.stg_lint.pyschützt zitierten Text vor lexikalischen Prüfungen. Zitierter Text zählt als ein Wort (STG-8.6).- Korrekturen nach einem Test mit einem echten deutschen Monorepo: Befunde in Sätzen über mehrere Zeilen haben jetzt eine Zeilennummer. Technische Begriffe aus dem Projektglossar haben Vorrang vor der zentralen Sperrliste. Ein geändertes zitiertes Wort (
„Provision“→„Provisionen“) ergibt jetztFAILin der Bedeutungsprüfung. - Korrektur: Der Linter hat
manzweimal gemeldet (STG-DE-4.3undSTG-1.1). Jetzt meldet nurSTG-DE-4.3das Wort. - Neues Werkzeug
stg_compare.pyfür die Bedeutungsprüfung von Umschreibungen. Fehlende Zahlen, Einheiten, Code, URLs, Zitate, Kennungen oder Signalwörter ergebenFAIL. Geänderte Verbote, Modalität, Verneinungen, Einschränkungen, Bedingungen und Grenzwerte ergebenREVIEW.
Agent Skill
- Neue Modi
strikt(STG-T) undpragmatisch(STG-R) mit Standardwerten je Anwendungsprofil. - Neue Regeln für Texte, die Agenten lesen: Tool-Beschreibungen, Fehlermeldungen, Systemprompts.
- Der Skill führt nach jeder Umschreibung
stg_compare.pyaus. Konformer Text bleibt unverändert. - Neue Beschreibung mit Auslösern auf Deutsch und Englisch und mit ausdrücklichen Ausschlüssen.
- Neue Datei
prompts/agents-md.mdmit einer kurzen und einer vollständigen Fassung fürAGENTS.md,CLAUDE.md,.cursorrulesund Systemprompts.
Verpackung und CI
- Python-Paket
stg-demit dem Befehlstgund den Unterbefehlenlint,analyzeundcompare(aus dem früheren Branchv0.5/tooling). Das Paket enthält Kopien der kanonischen Werkzeuge und Daten.tools/sync_package.py --checkprüft die Kopien. - pre-commit-Hook
stg-de-lintund erste Vale-Regeln invale/. - Plugin und Marketplace für Claude Code in
.claude-plugin/. tools/package_skill.pyerzeugt ein reproduzierbares ZIP des Skills mit SHA-256-Prüfsumme.- Wiederverwendbare GitHub Action
action.ymlfür STG-DE-Prüfungen in anderen Repositorys. - Release-Workflow für Tags
v*. Die CI erzeugt das ZIP und prüft das eigene Repository mit der Action.
Evaluation
evals/: Fälle für WRITE, REWRITE und AUDIT über alle sieben Anwendungsprofile, Prompts für die Auslöser und Referenzausgaben.tools/run_evals.py: deterministische Bewertung. Das Werkzeug erzeugt Ausgaben mit jedem CLI, das einen Prompt über stdin liest.
Seit 0.1.0 (vorher nicht veröffentlicht)
- Matrix der automatisierten Regeln (
quality/rule-coverage.yaml) und Golden-Audit-Fälle. - Korpusprotokoll v0.2 mit festen Partitionen für Entwicklung, Validierung und Holdout. Das Korpus hat 139.646 Token aus 13 öffentlichen Volltextquellen (nur abgeleitete Metriken).
- Schema und Vorlage für Lexikonvorschläge, Vorlage für Änderungsvorschläge, Governance, Versionierungsrichtlinie, Release-Checkliste und
CITATION.cff. - Anwendungsprofile (
procedure,safety,description,requirement,support,consumer,agent) in Linter und Skill. - Konservatives Analysewerkzeug
stg_analyze.pyfür die deutsche Sprache.
STG-DE v0.1.0
Erster öffentlicher Stand des Repositorys vom 22.08.2026. Dieses Release wurde am 12.11.2026 nachträglich angelegt. Damals gab es keinen Tag.
Die Entwürfe vor dem öffentlichen Repository heißen 0.0.1 bis 0.0.3. Für diese Entwürfe gibt es keine Commits und keine Releases. Die Änderungen stehen in CHANGELOG.md.
Für dieses Release gibt es keine Artefakte mit Prüfsummen. Den Release-Workflow gibt es seit 0.2.0.