> For the complete documentation index, see [llms.txt](https://selmotech.gitbook.io/selmo-solution/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://selmotech.gitbook.io/selmo-solution/selmo-documentation/vorwort.md).

# Vorwort

### Diese Dokumentation ist normativ

Diese Dokumentation beschreibt **das Selmo-System in seiner verbindlichen Form**.

„Normativ“ bedeutet in diesem Kontext:

* Die beschriebenen Begriffe, Strukturen und Prinzipien\
  sind **maßgeblich** für das Verständnis und die Anwendung von Selmo.
* Abweichende Interpretationen, alternative Bedeutungen oder implizite Annahmen\
  sind **nicht Teil von Selmo**, sofern sie hier nicht beschrieben sind.

> **Was in dieser Dokumentation beschrieben ist, gilt.**\
> **Was nicht beschrieben ist, ist nicht Teil des Selmo-Systems.**

***

### Was „normativ“ hier bedeutet

Diese Dokumentation ist normativ in Bezug auf:

* die **Begriffe** (Plant, Hardware-Zone, Sequence, Zone, …)
* die **Struktur** des Modells
* die **Bedeutung** von Zuständen, Operanden und Überwachungen
* die **Prinzipien** von Betrieb, Sicherheit und Diagnose
* die **Haltung**, aus der heraus Selmo angewendet wird

Sie definiert:

* **was Selmo ist**
* **wie Selmo gedacht wird**
* **wie Selmo korrekt interpretiert wird**

***

### Was „normativ“ hier nicht bedeutet

Diese Dokumentation ist **keine Norm im rechtlichen Sinn**\
und ersetzt insbesondere **keine**:

* gesetzlichen Vorschriften
* harmonisierten Normen (z. B. ISO, IEC)
* Risikobeurteilungen
* Sicherheitsnachweise
* fachliche Verantwortung des Anwenders

Selmo stellt **kein automatisches Konformitätsversprechen** dar.

> **Normative Klarheit ersetzt keine Verantwortung –**\
> **sie macht sie nachvollziehbar.**

***

### Verhältnis zu Implementierung und Projekten

Diese Dokumentation beschreibt:

* **das Modell**
* nicht dessen konkrete Implementierung

Projekt- oder kundenspezifische Anpassungen:

* dürfen erfolgen
* müssen jedoch **auf dieses Modell zurückführbar bleiben**

Wenn eine Implementierung von dieser Dokumentation abweicht,\
ist nicht die Dokumentation falsch,\
sondern die Abweichung **explizit zu begründen und zu bewerten**.

***

### Änderungen und Weiterentwicklung

Diese Dokumentation ist:

* versionierbar
* weiterentwickelbar
* nachvollziehbar erweiterbar

Änderungen am Selmo-System erfolgen:

* bewusst
* explizit
* dokumentiert

Implizite Änderungen oder stille Bedeutungsverschiebungen widersprechen dem Grundgedanken von Selmo.

> **Stabilität entsteht nicht durch Stillstand,**\
> **sondern durch kontrollierte Weiterentwicklung.**

***

### Ziel dieses Vorworts

Dieses Vorwort soll sicherstellen, dass:

* alle Leser vom **gleichen Begriffsverständnis** ausgehen
* Diskussionen auf einer **gemeinsamen Grundlage** stattfinden
* Missverständnisse früh vermieden werden
* Selmo als das verstanden wird, was es ist: ein **formales Modell für erklärbares Maschinenverhalten**

***

### Abschließende Aussage

Selmo ist kein Meinungsraum.\
Selmo ist ein **definiertes System**.

Diese Dokumentation ist seine **Referenz**.

> **Wer Selmo anwendet,**\
> **wendet dieses Modell an.**


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://selmotech.gitbook.io/selmo-solution/selmo-documentation/vorwort.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
