Context Card
Context Cards
Kurze, in sich geschlossene Erklärungen der technischen Zusammenhänge hinter den Nachrichten: eine Frage, eine direkte Antwort, die wichtigsten Punkte und die Glossarbegriffe, auf denen sie aufbaut. Auf US-Englisch, britischem Englisch und Deutsch.
Die Glossare erscheinen auf US-Englisch.
How to read a context cardRole Card Funktionsrolle
Ontology Steward: die Funktionsrolle
Wer hält den gelenkten semantischen Kern einer Wissensarchitektur aus DITA und iiRDS stabil, während sich das Modell weiterentwickelt?
Der Ontology Steward hält die gelenkten Ontologien stabil und versioniert und modelliert freigegebene Änderungen – die Funktion hinter dem Vertrag.
Ontology · Semantic model · Semantic versioning · Schema governance · RDF (Resource Description Framework)
Zur CardContext CardÜbergangsthema
Was die Begriffstheorie der Ontologiearbeit bietet
Was kann die Arbeit an Ontologien und Wissensgraphen aus der Forschung zur Repräsentation von Begriffen übernehmen?
Drei Blickwinkel der Begriffstheorie für Ontologien und Wissensgraphen: definitorisch oder typisch, vergleichbare Werte, ein Geschehen auf mehreren Ebenen.
Ontology · Knowledge graph · Information model · RDF (Resource Description Framework) · Semantic drift · Ontology alignment · Frame (concept representation) · Cascade (frame theory) · Conceptual space · Lexical decomposition · Conceptual atomism · Default inheritance (knowledge representation)
Zur CardContext CardÜbergangsthema
Dekomposition oder Atomismus: Wie viel soll eine Definition tragen?
Hat die Bedeutung eines Terms Teile, die eine Definition aufzählen kann?
Dekomposition oder Atomismus: ob Bedeutungen Teile haben, die eine Definition nennt – und was das für Glossare, Terminologien und Ontologien heißt.
Ontology · Semantic drift · Information model · Lexical decomposition · Conceptual atomism · Analytic–synthetic distinction
Zur CardContext Card
Pausieren, Abbrechen, Rückgängigmachen: drei Funktionen der Agentenausführung
Worin unterscheiden sich Pausieren, Abbrechen und Rückgängigmachen einer von einem KI-Agenten gestarteten Aktion?
Pausieren hält den nächsten Schritt, Abbrechen beendet den Lauf, Rückgängigmachen braucht das Zielsystem. Nur eines holt ein Formular zurück.
Control (automation) · Transaction · Hypertext Transfer Protocol (HTTP) · Security (IT and OT)
Zur CardRole Card Funktionsrolle
Content Developer: die Funktionsrolle
Wer schreibt und pflegt die Inhalte, aus denen ein digitaler Zwilling aus DITA und iiRDS entsteht?
Der Content Developer schreibt die DITA-Topics und iiRDS-Metadaten eines Wissensgraphen und meldet, was der Inhalt Lesern nicht beantwortet.
DITA (Darwin Information Typing Architecture) · DITA topic · Metadata · iiRDS InformationType · User role
Zur CardRole Card Funktionsrolle
Freigabe durch die semantische Governance: die Funktionsrolle
Wer entscheidet, welche vorgeschlagenen Änderungen an der Ontologie Teil des Unternehmensmodells werden?
Die semantische Governance entscheidet, welche geprüften Ontologieänderungen ins Unternehmensmodell kommen – und warum. Nie ein Agent, immer Menschen.
Schema governance · Data governance · Semantic model · Ontology
Zur CardContext Card
Drei Verarbeitungszwecke, wenn KI die Fallbearbeitung unterstützt
Welche Verarbeitungszwecke müssen getrennt bleiben, wenn ein KI-System die Bearbeitung einzelner Fälle unterstützt?
Modellentwicklung, Verfahrensanalyse und Unterstützung im Einzelfall sind drei Zwecke mit drei Datenbeständen und drei Pflichtenkreisen.
Human oversight (AI Act) · Data quality · Validation · Technical documentation
Zur CardContext Card
Agentenflotte oder Agentenschwarm: was paralleler Betrieb zeigt
Worin unterscheiden sich Agentenflotte und Agentenschwarm, und was lässt sich von außen belegen?
Flotte heißt viele Agenten parallel, Schwarm heißt Koordination. Externe Spuren zeigen Anfragen und Zeitpunkte, keine Abstimmung.
Communication · Network · Security (IT and OT) · Technical documentation
Zur CardContext Card
Warum eine nachgebaute Oberfläche keine Testgrenze ist
Was macht einen Testaufbau für einen KI-Agenten isoliert – eine nachgebaute Oberfläche oder eine durchgesetzte Grenze?
Eine nachgebaute Oberfläche isoliert keinen Agententest. Die Grenze muss für Werkzeuge, Ziele, Anmeldedaten und Weiterleitungen gelten.
Evaluation (evals) · Network · Software defect · Security (IT and OT)
Zur CardRole Card Funktionsrolle
Informationsnutzer: die Funktionsrolle
Wessen Fragen treiben eine adaptive semantische Architektur an – und was darf das System mit ihnen tun?
Informationsnutzer fragen das System nach dem, was sie für eine Aufgabe brauchen; ihre wiederkehrenden Fragen sind die Evidenz, aus der der Kreislauf lernt.
AI agent · User role · Retrieval-augmented generation (RAG)
Zur CardRole Card Funktionsrolle
Betrieb der semantischen Plattform: die Funktionsrolle
Wer betreibt Graphen, Inferenz, semantische Sicht und Vektorindex – und hält sie mit dem freigegebenen Modell im Gleichschritt?
Der Plattformbetrieb führt Graphen, Inferenz, semantische Sicht und Vektorindex und hält sie mit der freigegebenen Modellversion im Gleichschritt.
Knowledge graph · Digital twin · Embedding · Vector database · Semantic versioning
Zur CardRole Card Funktionsrolle
KI-Agent als Vorschlagender: die Funktionsrolle
Welche Rolle hat der KI-Agent in einer adaptiven semantischen Architektur – Werkzeug, Evidenzquelle oder Entscheider?
Der KI-Agent nutzt das semantische Modell und liefert Evidenz für seine Verbesserung; er darf Änderungskandidaten entwerfen, gibt sie aber nie frei.
AI agent · Knowledge graph · Retrieval-augmented generation (RAG) · Semantic model
Zur CardPathway Map Landkarte
Von Wissensgraphen zu adaptiver Semantik: die Pathway Map
Wie kommt eine Wissensarchitektur aus DITA und iiRDS von gelenkter Semantik zu einem Modell, das aus der Nutzung durch KI-Agenten lernt – und wer tut was auf dem Weg?
Michael Iantoscas Whitepaper zur adaptiven Semantik als Pathway Map: sieben Spuren, 21 Stationen mit Reife, vier Rollenrouten über die Governance.
DITA (Darwin Information Typing Architecture) · DITA topic · iiRDS InformationType · Ontology · Knowledge graph · Digital twin · Semantic model · Embedding · Vector database · AI agent · Schema governance · Semantic versioning
Zur CardContext Card
ISO 20607 und IEC/IEEE 82079-1: zwei Normen, eine Betriebsanleitung
Welcher Norm sollte ein Maschinenhersteller bei der Betriebsanleitung folgen — ISO 20607 oder IEC/IEEE 82079-1?
ISO 20607 regelt die sicherheitsbezogenen Inhalte der Betriebsanleitung einer Maschine, IEC/IEEE 82079-1 Prozess und Qualität von Nutzungsinformationen.
ISO 20607 (instruction handbook for machinery) · IEC/IEEE 82079-1 · ISO 12100 · Instructions for use (IFU) · Information for use · Operating manual · Warning message · Harmonized standard · Presumption of conformity · Target audience analysis · Machinery Regulation (EU) 2023/1230 · Digital instructions for use (Machinery Regulation)
Zur CardContext Card
Digitale Betriebsanleitung nach der Maschinenverordnung: was das Recht erlaubt und was es weiter verlangt
Darf ein Maschinenhersteller die Betriebsanleitung nach der Maschinenverordnung nur digital liefern?
Ab 2027 erlaubt die Maschinenverordnung digitale Anleitungen — mit Zugang, Download, zehn Jahren Verfügbarkeit und Papier auf Anfrage.
Digital instructions for use (Machinery Regulation) · Machinery Regulation (EU) 2023/1230 · Machinery Directive 2006/42/EC · Instructions for use (IFU) · Operating manual · ISO 20607 (instruction handbook for machinery) · IEC/IEEE 82079-1 · Information and instructions to the user (CRA) · VDI 2770
Zur CardContext Card
Betriebsanleitung und CRA-Nutzerinformationen: ein Informationsset, zwei Regelwerke
Was fügt der Cyber Resilience Act der Anleitung einer vernetzten Maschine hinzu?
Für vernetzte Maschinen ergänzt der CRA Security-Informationen nach Anhang II — ein Informationsset kann beiden Regelwerken dienen.
Information and instructions to the user (CRA) · Support period (CRA) · Cyber Resilience Act (CRA) · Machinery Regulation (EU) 2023/1230 · Digital instructions for use (Machinery Regulation) · ISO 20607 (instruction handbook for machinery) · IEC/IEEE 82079-1 · Coordinated vulnerability disclosure (CVD) · Software bill of materials (SBOM) · Update capability · Decommissioning · Instructions for use (IFU)
Zur CardPathway Card Handlungsweg Methodischer Feinschliff
Im FokusAlle drei Platzhalter – vom Platzhalter zur Prüfregel
Von drei Lesern zu Prüfrollen
Die Startseite nennt drei Leser – die Quelle, den Menschen und den dritten Leser. Warum genügt das, um eine Prüfmethode zu entwerfen, und was muss sich ändern, bevor eine Prüfung laufen kann?
Drei Platzhalter genügen, um eine Prüfmethode zu entwerfen. Damit Prüfungen laufen, öffnet sich jeder zu Rollen, die eine Prüfregel nennen kann.
System of record · Golden record · System of engagement · Release decision · Instructed person (electrically) · Skilled person (electrically) · Data owner · Data lineage · Action approval gate (AI agent)
Zur CardContext CardÜbergangsthema
Das Kuh-Modell: ein Thema in Weite und Tiefe bearbeiten
Wie bearbeitet man ein Thema in Weite und Tiefe, bevor man darüber veröffentlicht?
Das Kuh-Modell von Saina Veigel als Rezept: Rahmen, vier Durchgänge, die Leserprobe, der Rest und die Gewohnheit – und worauf jeder Schritt beruht.
Inversion (thinking tool) · Curse of knowledge · Second-order thinking · Metacognition · Illusion of explanatory depth · Dual-process theory · Analysis and synthesis (method) · Mental model (thinking tool) · Latticework of mental models · Divergent and convergent thinking · Incubation (problem solving) · Spacing effect · Neuroplasticity · Zettelkasten · Deliberate practice · Hebbian learning · Habit formation · Implementation intention · Reward system · Digital dementia · Encephalization · Working memory · Cognitive load theory
Zur CardPathway Card Handlungsweg Methodischer Feinschliff
Im FokusDer dritte Leser – die Maschine
Die Maschine ist ein Netz, kein Monster
Wenn eine KI-Antwort falsch ist, warum ist „die Maschine hat sich geirrt“ keine Diagnose?
„Die Maschine“ ist ein Netz von Teilen – Index, Retrieval, Modell, Agent – mit eigenen Rollen und Eigentümern. Benannt zeigen sie, was zu korrigieren ist.
Retrieval-augmented generation (RAG) · Large language model (LLM) · AI agent · Excessive agency · Answer provenance · Data lineage
Zur CardPathway Card Handlungsweg Methodischer Feinschliff
Im FokusDer dritte Leser – die Antwortfunktion
Die Antwortfunktion stellt zusammen – sie liest nicht
Ist eine KI-Antwortfunktion eine Lesende der Dokumentation?
Eine Antwortfunktion wählt Einheiten aus und formuliert einen neuen, nicht freigegebenen Text. Sie stellt zusammen – und muss sagen, woraus.
Retrieval-augmented generation (RAG) · Answer provenance · Grounding · Translation memory · Release decision · Content provenance
Zur CardPathway Card Handlungsweg Methodischer Feinschliff
Im FokusDer Mensch – der Lesende
Drei Bediener, ein Warnhinweis
Warum braucht derselbe Warnhinweis für eine unterwiesene Bedienerin, einen geschulten Bediener und eine Elektrofachkraft unterschiedliche Informationen?
Unterwiesen, geschult, Fachkraft: Derselbe Warnhinweis braucht je Qualifikation eine eigene Aufgabe, und jede Qualifikation trifft auf jede Situation.
Instructed person (electrically) · Skilled person (electrically) · Ordinary person (electrically) · Qualified person · Competent person · Target audience analysis · Skill-, rule- and knowledge-based behavior · Lockout/tagout (LOTO) · Operating mode
Zur CardPathway Card Handlungsweg Methodischer Feinschliff
Im FokusDie Quelle – die Schreibenden
Eine Schreibende, viele Schreibende
Wer schreibt einen technischen Text – und warum ist es wichtig, dass es nicht eine Person ist?
Ein Text hat viele Schreibende: Redakteurin, Experte, Übersetzerin, Prüfer, Freigebende und KI-Funktionen. Benannt zeigen sie, wohin Fragen gehen.
Subject-matter expert (SME) · Release decision · Segregation of duties (SoD) · Translation memory · AI content disclosure · Content provenance
Zur CardContext Card Methodischer Feinschliff
Im FokusAlle drei Platzhalter – die fünf Tätigkeitsfamilien
Die Rollengrammatik: Lesen, Schreiben und Zusammenstellen
Wie sagt man, wer was mit einer technischen Information tut – wenn „der Schreibende“, „die Maschine“ und „der Lesende“ zu grob sind?
Vier Achsen für alle, die technische Information schreiben, entscheiden, zusammenstellen, nutzen oder zurückschreiben – Menschen und Systeme.
Target audience analysis · Qualified person · Competent person · Instructed person (electrically) · Skilled person (electrically) · Segregation of duties (SoD) · Retrieval-augmented generation (RAG) · Action approval gate (AI agent) · Subject-matter expert (SME)
Zur CardPathway Card Handlungsweg Methodischer Feinschliff
Im FokusDer Mensch und der dritte Leser – Berufsgruppen und der KI-Agent
Von Berufsgruppen zu Rollen
Warum zeigt ein Raster aus Berufsgruppen – Redaktion, Marketing, Projektleitung, Entwicklung, der Lesende, der KI-Agent –, wer beteiligt ist, aber nicht, wer was tut?
Berufsgruppen zeigen, wer beteiligt ist; Rollen, wer was tut. „Der KI-Agent“ allein verdeckt drei Rollen: übernehmen, antworten, zurückschreiben.
AI agent · Action approval gate (AI agent) · Excessive agency · Human in the loop · Role-based access control (RBAC) · Target audience analysis
Zur CardPathway Card Handlungsweg
Von strukturierten Inhalten zu kontrollierter Evidenz: fünf Stufen KI-fähiger Dokumentation
Genügen strukturierte Inhalte, um Medizinprodukte-Dokumentation KI-fähig zu machen?
Strukturierte Inhalte sind Stufe zwei von fünf: KI-fähige Produktdokumentation braucht auch Verknüpfungen, kontrollierte Versionen und belegte Antworten.
Structured writing · DITA (Darwin Information Typing Architecture) · Component content management system (CCMS) · Content provenance · Retrieval-augmented generation (RAG) · Traceability · Configuration management · Labeling and instructions for use (MDR and IVDR) · Risk control measure (ISO 14971) · ISO 14971 · Grounding · Source of truth · Document control
Zur CardContext Card
Eine technische Dokumentation, zwei Anforderungssätze: was die KI-Verordnung einer MDR- oder IVDR-Akte hinzufügt
Braucht ein Medizinprodukt mit KI eine zweite technische Dokumentation für die KI-Verordnung?
Ein Produkt mit KI behält eine Akte: Die KI-VO ergänzt die MDR- oder IVDR-Akte um Daten, Protokolle, Aufsicht und Genauigkeit.
AI in medical devices (MDR, IVDR and AI Act) · Single set of technical documentation (AI Act Art. 11(2)) · Technical documentation (MDR and IVDR) · Technical documentation (AI Act) · High-risk AI system (AI Act) · Annex I Section A and Section B (AI Act) · Medical Device Regulation (MDR) · In Vitro Diagnostic Medical Devices Regulation (IVDR) · Notified body (MDR and IVDR) · Conformity assessment (MDR) · Digital Omnibus on AI · Human oversight (AI Act) · Instructions for use (AI Act) · Post-market monitoring (AI Act) · Record-keeping and logs (AI Act) · Post-market surveillance (MDR and IVDR) · ISO 13485
Zur CardContext Card
Aussagen sind gelenkte Informationsobjekte: von der Aussage zur Evidenz in der Produktakte
Wie sollten Aussagen über ein Medizinprodukt gelenkt werden, damit jede durch Evidenz gedeckt ist?
Aussagen sind gelenkte Objekte mit Formulierung, Orten und Evidenz; eine Aussage, die sich von ihrer Evidenz löst, ist eine Evidenzlücke.
Claims matrix (medical devices) · Intended purpose (MDR) · Clinical benefit (MDR) · Clinical evaluation (MDR) · Labeling and instructions for use (MDR and IVDR) · Summary of safety and clinical performance (SSCP) · General safety and performance requirements (GSPR) · Traceability
Zur CardContext Card
Die Zweckbestimmung als semantischer Anker der technischen Dokumentation
Warum ist die Zweckbestimmung der Bezugspunkt jedes Dokuments in der technischen Dokumentation eines Medizinprodukts?
Die Zweckbestimmung ist der Anker der Akte: Klassifizierung, Risiken, Evidenz und Gebrauchsanweisung beziehen sich auf sie; Widersprüche sind Evidenzlücken.
Intended purpose (MDR) · Technical documentation (MDR and IVDR) · Clinical evaluation (MDR) · Labeling and instructions for use (MDR and IVDR) · Clinical benefit (MDR) · Claims matrix (medical devices) · Device classification (MDR) · General safety and performance requirements (GSPR) · ISO 14971
Zur CardContext Card
Die technische Dokumentation eines Medizinprodukts ist keine Sammlung von Dokumenten. Sie ist ein Evidenzsystem.
Was macht die technische Dokumentation eines Medizinprodukts zu einem Evidenzsystem statt zu einer Menge von Dokumenten?
Eine technische Dokumentation wirkt durch die Verknüpfung von Anforderung, Risiko, Kontrolle, Prüfung und klinischen Daten. Benannte Stelle und KI folgen ihr.
Technical documentation (MDR and IVDR) · General safety and performance requirements (GSPR) · Post-market surveillance (MDR and IVDR) · ISO 14971 · Clinical evaluation (MDR) · Notified body (MDR and IVDR) · Traceability · Intended purpose (MDR) · Claims matrix (medical devices) · Design history file (DHF) · Medical device file (ISO 13485) · Post-market clinical follow-up (PMCF) · Periodic safety update report (PSUR)
Zur CardRole Card Funktionsrolle
Verantwortung für Marktsignale: eine funktionale Rolle
Wer sorgt dafür, dass das, was über ein Produkt im Feld gelernt wird, Risikoakte, Gebrauchsanweisung und Claims erreicht?
Die funktionale Rolle, die Marktsignale in benannte Aktualisierungen von Risikoakte, Gebrauchsanweisung und Claims übersetzt, neben der Vigilanz.
Post-market surveillance (MDR and IVDR) · Post-market signal (medical devices) · Vigilance (MDR and IVDR) · Corrective and preventive action (CAPA)
Zur CardRole Card Funktionsrolle
Freigabe von Modelländerungen: eine funktionale Rolle
Wer entscheidet, ob ein Update eines KI-Modells in einem Medizinprodukt innerhalb der geplanten Änderungen bleibt – und wer stoppt es, wenn nicht?
Die funktionale Rolle, die Updates von KI-Modellen in Medizinprodukten gegen den Änderungsplan prüft und freigibt oder stoppt.
Predetermined change control plan (PCCP) · Model versioning · Change control · AI-enabled device software function (AI-DSF)
Zur CardRole Card Funktionsrolle
Verantwortung für Kennzeichnung und Gebrauchsanweisung: eine funktionale Rolle
Wer sorgt dafür, dass Etikett und Gebrauchsanweisung eines Produkts sagen, was Risikoakte, Evidenz und Produktversion verlangen?
Die funktionale Rolle, die Etikett und Gebrauchsanweisung mit Risikokontrollen, Evidenz, Versionen und Sprachen verknüpft und freigibt.
Labeling and instructions for use (MDR and IVDR) · Usability engineering file (IEC 62366-1) · Warning message · ISO 15223-1
Zur CardRole Card Funktionsrolle
Verantwortung für die klinische Evidenz: eine funktionale Rolle
Wer hält die klinische Evidenz und den Leistungsnachweis eines Produkts im Gleichschritt mit Gebrauchsanweisung, Claims und Marktdaten?
Die funktionale Rolle, die klinische Evidenz aktuell und benannt hält, damit Gebrauchsanweisung, Claims und Kurzberichte dieselben Werte nutzen.
Clinical evaluation (MDR) · Clinical benefit (MDR) · Post-market clinical follow-up (PMCF) · Performance evaluation (IVDR)
Zur CardRole Card Funktionsrolle
Verantwortung für die Risikomanagementakte: eine funktionale Rolle
Wer hält die Risikomanagementakte eines Medizinprodukts mit den Anforderungen, Tests und Warnhinweisen verbunden, die von ihr abhängen?
Die funktionale Rolle, die die Risikomanagementakte nach ISO 14971 und ihre Verknüpfungen zu Anforderungen, Verifikation, Kennzeichnung und Marktdaten führt.
ISO 14971 · Risk control measure (ISO 14971) · Benefit-risk determination (MDR) · Hazardous situation
Zur CardRole Card Funktionsrolle
Verantwortung für die Zweckbestimmung: eine funktionale Rolle
Wer hält die Zweckbestimmung eines Medizinprodukts in allen Dokumenten, die sie verwenden, konsistent?
Die funktionale Rolle, die eine gelenkte Zweckbestimmung führt und bei Änderungen die Auswirkungsanalyse anstößt.
Intended purpose (MDR) · Medical device (MDR) · Device classification (MDR) · Claims matrix (medical devices)
Zur CardPathway Map Landkarte
Die Evidenzkette eines Medizinprodukts: von der Zweckbestimmung zur Evidenz aus dem Markt
Wie hängen die Teile der technischen Dokumentation eines Medizinprodukts zusammen – und was muss stehen, bevor eine KI-Funktion daraus antworten darf?
Pathway-Map der Medizinprodukte-Dokumentation: Zweckbestimmung, Risiko, Gebrauchsanweisung, klinische Evidenz, KI und Marktdaten als eine Evidenzkette.
Medical Device Regulation (MDR) · In Vitro Diagnostic Medical Devices Regulation (IVDR) · Medical device (MDR) · Device classification (MDR) · Device classification (IVDR) · Rule 11: software classification (MDR) · ISO 13485 · Quality Management System Regulation (QMSR, 21 CFR Part 820) · Medical device file (ISO 13485) · Document control · ISO 14971 · Hazard · Hazardous situation · Harm · Risk control measure (ISO 14971) · Benefit-risk determination (MDR) · AI in medical devices (MDR, IVDR and AI Act) · High-risk AI system (AI Act) · Single set of technical documentation (AI Act Art. 11(2)) · Provider (AI Act) · FDA premarket pathways: 510(k), De Novo and PMA · Predetermined change control plan (PCCP) · Clinical decision support software (FDA) · Intended purpose (MDR) · Technical documentation (MDR and IVDR) · General safety and performance requirements (GSPR) · Traceability · Evidence chain · Design controls (medical devices) · Design history file (DHF) · Device master record (DMR) and device history record (DHR) · Labeling and instructions for use (MDR and IVDR) · Warning message · Usability engineering file (IEC 62366-1) · Hazard-related use scenario · Clinical evaluation (MDR) · Clinical benefit (MDR) · Performance evaluation (IVDR) · Post-market clinical follow-up (PMCF) · Summary of safety and clinical performance (SSCP) · Claims matrix (medical devices) · Post-market surveillance (MDR and IVDR) · Vigilance (MDR and IVDR) · Periodic safety update report (PSUR) · Corrective and preventive action (CAPA) · Post-market signal (medical devices) · Release decision · Unique Device Identification (UDI) · Evidence version · Change control · Software as a medical device (SaMD) · Medical device software (MDSW) · AI-enabled device software function (AI-DSF) · IEC 62304 · Software of unknown provenance (SOUP) · Software bill of materials (SBOM) · IEC 81001-5-1 · Cybersecurity · Training data · Representativeness of training data (medical AI) · Data lineage · Data governance · Model versioning · Human oversight (AI Act) · Instructions for use (AI Act) · Transparency obligations (AI Act) · Model card · Model monitoring · Model drift · Post-market monitoring (AI Act) · Terminology management · Taxonomy · ISO 15223-1 · Knowledge graph · Evidence architecture · Ontology · Single-sourcing · Configuration management · Version control · Translation memory · Retrieval-augmented generation (RAG) · Access control · Grounding · Source of truth · Human in the loop
Zur CardContext Card
Was eine Antwortfunktion lesen darf: Abrufrechte für die technische Dokumentation eines Medizinprodukts
Welche Teile der technischen Dokumentation eines Medizinprodukts darf eine KI-Antwortfunktion abrufen?
Eine Antwortfunktion liest nur, was für ihren Leser freigegeben ist, in passender Version und Sprache; Vertrauliches und Entwürfe bleiben draußen.
Retrieval-augmented generation (RAG) · Access control · Role-based access control (RBAC) · Technical documentation (MDR and IVDR) · Vigilance (MDR and IVDR) · Document control · Source of truth · Content provenance · Grounding · Machine translation post-editing (MTPE)
Zur CardContext Card
Hersteller, Anbieter, Betreiber: wer welche Rolle hat, wenn ein Medizinprodukt KI enthält
Welche Rolle nach KI-Verordnung übernimmt ein Medizinproduktehersteller, ein Krankenhaus oder ein Importeur?
Der MDR-Hersteller ist meist Anbieter nach KI-VO; das Krankenhaus, das das Produkt nutzt, ist Betreiber. Gleiche Namen, nicht immer gleiche Pflichten.
Provider (AI Act) · Deployer (AI Act) · Economic operators (MDR and IVDR) · AI in medical devices (MDR, IVDR and AI Act) · Medical Device Regulation (MDR) · Human oversight (AI Act) · Instructions for use (AI Act) · In-house devices (MDR and IVDR Article 5(5))
Zur CardContext Card
Modellversion, Softwareversion, Produktversion: drei Nummern, die nicht dasselbe sind
Was unterscheidet Modellversion, Softwareversion und Produktversion eines KI-gestützten Medizinprodukts?
Modell-, Software- und Produktversion bezeichnen Verschiedenes; nach einem Modellupdate müssen alle drei aufeinander und auf die Nachweise rückführbar sein.
Unique Device Identification (UDI) · IEC 62304 · Configuration management · Software of unknown provenance (SOUP) · Predetermined change control plan (PCCP) · AI drift · Model card · Software release · EUDAMED
Zur CardContext Card
Die Herkunft der Trainingsdaten gehört in die Produktakte, nicht nur ins Data-Science-Werkzeug
Warum gehört die Herkunft der Trainingsdaten in die technische Dokumentation eines KI-gestützten Medizinprodukts?
Die angegebene Leistung ist nur so gültig wie die Daten dahinter: Die Herkunft der Trainingsdaten gehört in die technische Dokumentation.
Representativeness of training data (medical AI) · Content provenance · Data lineage · Data governance · Training data · Bias (AI) · AI-enabled device software function (AI-DSF) · Clinical evaluation (MDR) · W3C PROV
Zur CardContext Card
Die Grenzen eines Modells dokumentieren: was die Gebrauchsanweisung eines KI-Produkts sagen muss
Wie sollten die Grenzen eines KI-Modells für die Anwender eines Medizinprodukts dokumentiert werden?
Modellgrenzen gehören als Sicherheitsinformation in die Gebrauchsanweisung, gebunden an Evidenz: validierte Population, Leistung, Fehlerarten, Prüfungen.
Instructions for use (AI Act) · Labeling and instructions for use (MDR and IVDR) · Model card · Representativeness of training data (medical AI) · Human oversight (AI Act) · AI-enabled device software function (AI-DSF) · AI drift · Hallucination (AI)
Zur CardPathway Card Handlungsweg
Vom gesperrten Modell zur geplanten Änderung: Modellupdates eines Medizinprodukts dokumentieren
Wie kann ein KI-gestütztes Medizinprodukt sein Modell ändern, ohne dass jedes Update zur neuen regulatorischen Frage wird?
Ein PCCP (USA) oder vorab festgelegte Änderungen nach Art. 43 Abs. 4 KI-VO erlauben Modelländerungen in dokumentierten Grenzen.
Predetermined change control plan (PCCP) · AI-enabled device software function (AI-DSF) · AI drift · FDA premarket pathways: 510(k), De Novo and PMA · Technical documentation (AI Act) · Configuration management · Design controls (medical devices) · IEC 62304 · Technical documentation (MDR and IVDR)
Zur CardContext Card
Wer entscheidet, welcher Wert gilt: Welches System entscheidet einen Wert der Produktinformation?
Wenn Produktinformationen durch PLM, ERP, Content-Systeme, Tabellen, Portale und KI-Funktionen laufen – woran erkennt man, welches System einen Wert entscheidet und welches nur eine Kopie hält?
Zehn Rollen, die Systeme mit Produktinformationen spielen, eine Prüffrage je Wert und ein kleiner Herkunftsnachweis – nach einem Blueprint von Saina Veigel.
Source of truth · Master data · Master-data synchronization · Product lifecycle management (PLM) · Enterprise resource planning (ERP) · Component content management system (CCMS) · Bill of materials (BOM) · Configuration management · Configuration baseline · Digital thread · Integration layer · Integration platform · Data pipeline · Data lineage · Data governance · Data quality · Metadata · iiRDS Consumer · Semantic interoperability · Retrieval-augmented generation (RAG) · Answer provenance · Knowledge graph · Excessive agency · Action approval gate (AI agent) · Human in the loop · Audit trail · Release decision · Content provenance · Shadow AI · System of record · Golden record · Master data management (MDM) · Data owner · Data steward · Data custodian · Source system · Downstream system · Derived data · End-user computing (EUC) · Semantic model (BI) · ETL and ELT · Data product · Data contract · W3C PROV · System of engagement · Product information management (PIM)
Zur CardContext Card
Emotions- und Schmerzexperimente an Sprachmodellen: was sie messen und was sie offenlassen
Wenn eine Studie ein Sprachmodell „ängstlich“, „traurig“ oder „schmerzerfüllt“ macht – was hat sie gezeigt und was nicht?
Emotions- und Schmerzexperimente an Sprachmodellen messen funktionale Zustände und Verhalten. Was sie zeigen, was offenbleibt, wie man darüber schreibt.
Evaluation (evals) · Computational functionalism · Biological naturalism · Model welfare · Anthropomorphism · Moral patient · Interpretability (AI)
Zur CardContext Card
Meldepflichten nach einem Vorfall mit einem KI-Agenten: KI-Verordnung, CRA, NIS 2 und DSGVO
Welche EU-Meldepflichten können gelten, wenn ein KI-Agent einen Vorfall verursacht hat – wer meldet, an wen und bis wann?
KI-Verordnung, CRA, NIS 2 und DSGVO nebeneinander: welche Meldepflichten nach einem Agentenvorfall gelten können, wer meldet und bis wann.
Serious incident (AI Act) · Severe incident (CRA) · Incident reporting (reporting obligations) · NIS 2 Directive · Post-market monitoring (AI Act) · Record-keeping and logs (AI Act) · Deployer (AI Act) · Provider (AI Act) · Cyber Resilience Act (CRA) · EU AI Act
Zur CardPathway Map Landkarte
Wenn ein KI-Agent die Grenze überschreitet: erkennen, eindämmen und den Betrieb wiederherstellen
Was muss bereitstehen, wenn ein KI-Agent etwas tut, das er nicht darf – in IT-Systemen, IoT-Flotten, der OT und an Maschinen –, und wie wird das erkannt, gestoppt und wieder freigegeben?
Pathway-Map: KI-Agenten, die ihre Grenze überschreiten, in IT, IoT, OT und an Maschinen erkennen, eindämmen und wieder anlaufen lassen.
Agent permission scope · Excessive agency · AI agent · Tool allowlist (AI agent) · Agent identity · Principle of least privilege · Action approval gate (AI agent) · Irreversible action (AI agent) · Human in the loop · Agent trace · AI interaction log · OpenTelemetry · Audit trail · Canary token · Anomaly detection · Security monitoring · Rogue agent (AI) · Blast radius (AI agent) · Agent goal hijack · Security incident · Incident response · Agent containment · Agent kill switch · Credential revocation · Stop button or similar procedure (AI Act) · Record-keeping and logs (AI Act) · Serious incident (AI Act) · Severe incident (CRA) · Incident reporting (reporting obligations) · NIS 2 Directive · Return to service (after an incident) · Rollback · Compensating action · Restart prevention · Post-incident review · Root-cause analysis · Management of change (MOC) · Enterprise resource planning (ERP) · Sandboxing · Rollback capability · Continuous deployment · Configuration management · Over-the-air update (OTA) · Building automation · Energy management system (EMS) · Rate limiting · Cyber Resilience Act (CRA) · IoT gateway · Internet of Things (IoT) · Historian · Manufacturing execution system (MES) · Human-machine interface (HMI) · SCADA software · Distributed control system (DCS) · Batch control · Zone and conduit model · PLC programming · Programmable logic controller (PLC) · Industrial robot · Collaborative robot · Robot controller · Emergency stop · Safety function · Autonomous mobile robot (AMR) · Automated guided vehicle (AGV) · Fleet management system · Controlled stop · Coordinated restart · Operating mode · Machinery Regulation (EU) 2023/1230
Zur CardContext Card
Befugnis, Fähigkeit, Auftrag: die drei Teile der Grenze eines KI-Agenten
Welche Grenze überschreitet ein KI-Agent, wenn er „zu weit geht“ – und warum ist es wichtig, welche?
Die Grenze eines KI-Agenten hat drei Teile – Befugnis, Fähigkeit, Auftrag. Jeder kann einzeln überschritten werden und braucht eigene Maßnahmen.
Agent permission scope · Tool allowlist (AI agent) · Excessive agency · Agent goal hijack · Rogue agent (AI) · Agent identity · Blast radius (AI agent) · Principle of least privilege · AI agent
Zur CardContext Card
Erkennen, dass ein KI-Agent seine Grenze überschreitet
Woran merkt man, dass ein KI-Agent etwas getan hat, das er nicht durfte – bevor es Kunden, Bedienpersonal oder der Monatsbericht merken?
Grenzüberschreitungen von KI-Agenten erkennen: Traces, abgelehnte Aufrufe, ungewöhnliche Muster, Köder-Tokens – und warum gute Ergebnisse nichts beweisen.
Agent trace · Canary token · Anomaly detection · Security monitoring · Rogue agent (AI) · Agent goal hijack · Tool allowlist (AI agent) · AI interaction log · OpenTelemetry
Zur CardContext Card
Einen KI-Agenten eindämmen: pausieren, Zugang entziehen, isolieren, abschalten
Wie stoppt man einen KI-Agenten, der seine Grenze überschritten hat – ohne die Lage zu verschlimmern und ohne es mit dem Stoppen einer Maschine zu verwechseln?
Einen KI-Agenten in vier Stufen eindämmen – pausieren, Zugang entziehen, isolieren, abschalten – und warum ein Agenten-Stopp kein Not-Halt ist.
Agent containment · Agent kill switch · Credential revocation · Stop button or similar procedure (AI Act) · Emergency stop · Safe state · Zone and conduit model · Network segmentation · Blast radius (AI agent) · Controlled stop
Zur CardContext Card
Den Betrieb nach einem Vorfall mit einem KI-Agenten wiederherstellen
Was lässt sich rückgängig machen, nachdem ein KI-Agent seine Grenze überschritten hat, was nicht – und wann dürfen der Agent und die Systeme, die er berührt hat, wieder laufen?
Nach einem Agentenvorfall: was ein Rollback rückgängig macht, was Ausgleichsaktionen braucht und wann Agent, Systeme und Maschinen wieder laufen.
Return to service (after an incident) · Post-incident review · Rollback · Rollback capability · Compensating action · Irreversible action (AI agent) · Restart prevention · Coordinated restart · Over-the-air update (OTA) · Management of change (MOC)
Zur CardContext Card
Anbieterregeln, nationales Recht, EU-Recht und Menschenrechte: wer die Regeln für KI setzt
Welche Texte regeln, was ein KI-System sagen und tun darf – und wen bindet jeder von ihnen?
Menschenrechte, Verfassungen, EU- und nationales Recht, Ko-Regulierung und Anbieterregeln für KI: wer jede Ebene setzt, wen sie bindet, wer durchsetzt.
Constitution (law) · Charter of Fundamental Rights of the European Union · Primacy of EU law · Canadian Charter of Rights and Freedoms · Constitution of the People's Republic of China · International Covenant on Civil and Political Rights (ICCPR) · Council of Europe Framework Convention on AI · Co-regulation (AI) · Provider usage policy (AI) · Model specification (AI) · EU AI Act · Provider (AI Act) · Deployer (AI Act) · Fundamental rights impact assessment (AI Act) · GPAI Code of Practice · Harmonized standard · NIST AI Risk Management Framework · Executive Order 14365 · California SB 53 (Transparency in Frontier AI Act) · Artificial Intelligence and Data Act (AIDA) · Canadian Voluntary Code of Conduct on Generative AI · Directive on Automated Decision-Making (Canada) · Interim Measures for Generative AI Services (China) · AI-generated content labeling measures (China) · Legal personhood (AI) · AI usage policy · Horizontal AI regulation
Zur CardContext Card
In-Band- und Out-of-Band-Überwachung eines KI-Agenten
Was unterscheidet die In-Band- von der Out-of-Band-Überwachung eines KI-Agenten?
In-Band-Kontrollen laufen in der Agentenlaufzeit, Out-of-Band-Kontrollen getrennt davon und können unabhängig eingreifen.
AI agent · Runtime environment · Access control · Logging · System boundary
Zur CardPathway Card Handlungsweg
Indirekte Prompt-Injection in Agentenketten
Wie wandert indirekte Prompt-Injection durch eine Kette von KI-Agenten, und was ändert sich, wenn die Kette Kontrollpunkte bekommt?
Wie indirekte Prompt-Injection durch Agentenketten wandert, was Kontrollpunkte ändern, was nicht, und ein Weg in neun Schritten zur kontrollierten Kette.
Prompt injection · Prompt · AI agent · Evaluation (evals) · Test harness · Authorization · Principle of least privilege · Audit trail · Human in the loop · Logging · Agent containment · Agent goal hijack · Excessive agency
Zur CardContext Card
Unautorisierter Zugriff und Benachrichtigungspflicht
Warum sind das Verhindern unautorisierter Agentenzugriffe und die Benachrichtigung zwei getrennte Pflichten?
Eine Aktion zu blockieren und sie zu melden sind verschiedene Pflichten mit eigenen Verantwortlichen, Nachweisen und Fristen.
Authorization · Access control · Incident response · Logging · Responsibility assignment
Zur CardContext Card
KI-Systeme und die Maschine: Scope und Out of Scope jeder Ebene
Wo enden die KI-Systeme eines Unternehmens, wo reicht die Maschine in sie hinein, und was liegt außerhalb jeder Konfiguration?
Fünf Ebenen, die Maschine quer durch sie, zwei Grenzen: was KI-Systeme und die KI-Umgebung umfassen, wo die Maschine hineinreicht und wer entscheidet.
AI system (AI Act) · General-purpose AI model (AI Act) · Provider (AI Act) · Deployer (AI Act) · Foundation model · Large language model (LLM) · Retrieval-augmented generation (RAG) · Knowledge graph · AI agent · API gateway · System-of-systems · AI management system (AIMS) · AI usage policy · AI governance
Zur CardContext Card
Workflow-gebundene KI und frei handelnde Agenten
Was unterscheidet KI, die in einen definierten Arbeitsablauf eingebettet ist, von einem frei handelnden KI-Agenten?
Workflow-gebundene KI hängt an Verfahrensschritt, Rollen und freigegebenem Wissen; ein freier Agent wählt seinen Weg innerhalb externer Grenzen.
AI agent · Technical documentation · Version release · Responsibility assignment · Validation
Zur CardContext Card
Der Agentenstammsatz als Dokumentationsobjekt
Was muss ein Agentenstammsatz für einen KI-Agenten enthalten?
Der Agentenstammsatz verbindet Zweck, delegierte Rechte, Laufzeitkonfiguration, Protokolle und Verantwortliche eines KI-Agenten nachvollziehbar.
AI agent · Technical documentation · Configuration management · Responsibility assignment · Authorization · Logging
Zur CardContext Card
Aussagen über KI-Bewusstsein: vier Fragen, die vermischt werden
Welche verschiedenen Fragen stecken in einem Satz wie "Die KI ist nicht bewusst"?
Aussagen über KI-Bewusstsein vermischen vier Fragen: Nachweis, Design, Sicherheit, moralisch-rechtlicher Status. Mit Kontextmatrix und Debatten-Log.
Claim (assurance) · AI system (AI Act) · Risk · Categories (Aristotle) · Transparency obligations (AI Act) · Evaluation (evals) · Human oversight (AI Act) · Moral patient · Computational functionalism · Biological naturalism · Anthropomorphism · Sycophancy (AI) · AI companion · Model welfare · Legal personhood (AI) · Model specification (AI) · Provider usage policy (AI) · Constitution (law)
Zur CardContext Card
Vom Verhaltensziel zum Bewertungskriterium
Wie wird aus einer formulierten Verhaltensregel ein Score in einer Modellevaluierung?
Aus einer Verhaltensregel wird über Teilverhalten, Prompts und Rubrik ein Score: Er zeigt Regelkonformität, nicht die Wahrheit der Prämissen.
Evaluation (evals) · Requirement · Verification · Claim (assurance)
Zur CardContext Card
Was ein Konnektivitätsserver zwischen KI-System und Maschine leistet
Welche Rolle übernimmt ein industrieller Konnektivitätsserver zwischen einem KI-System und der Maschine?
Ein Konnektivitätsserver vereinheitlicht Steuerungsdaten zu OPC UA oder MQTT und überführt freigegebene KI-Ergebnisse in definierte Zugriffe.
OPC Unified Architecture (OPC UA) · Integration layer · MQTT · OPC · Information model
Zur CardContext Card
Verhaltensrichtlinie und Model Card: zwei Dokumente, zwei Zeitrichtungen
Was ist eine Verhaltensrichtlinie für Modelle, und wie unterscheidet sie sich von einer Model Card?
Eine Verhaltensrichtlinie legt fest, wie künftige Modelle antworten sollen; eine Model Card berichtet, was eine veröffentlichte Version getan hat.
Model card · Training vs. inference · AI governance · Technical documentation
Zur CardContext Card
Agenten-Workloads, Microservices und Batch-Jobs
Wie unterscheidet sich ein KI-Agent im Betrieb von einem Microservice oder einem Batch-Job?
Agenten sind langlebig, zustandsbehaftet und nicht deterministisch — daher unterscheidet sich ihre Orchestrierung von Microservices und Batch-Jobs.
Orchestration · Microservice architecture · Checkpoint (software) · AI agent · Process (computing)
Zur CardContext Card
Erklärbarkeit und Handlungstraceability
Was unterscheidet Erklärbarkeit von der Nachvollziehbarkeit tatsächlicher Handlungen?
Erklärbarkeit beantwortet das Warum eines Ergebnisses, Handlungstraceability das Was: ausgelöst, erlaubt, ausgeführt, geprüft.
Explainability (AI) · Observability · Logging · Change control
Zur CardContext Card
Kuratierte Quellensammlungen einschätzen
Was macht eine kuratierte Sammlung von Reaktionen oder Quellen belastbar?
Eine kuratierte Quellensammlung ist belastbar, wenn Auswahlregeln, Standpunkt, Known-Item-Prüfungen und Änderungshistorie offenliegen.
Source code repository · Accountability (AI) · Bias (AI) · View (systems engineering)
Zur CardContext CardÜbergangsthema
Arbeitsgedächtnis und Handlungsschritte: warum „sieben plus minus zwei“ die falsche Regel ist
Rechtfertigt die Forschung zum Arbeitsgedächtnis eine feste Höchstzahl von Schritten in einer Handlungsanweisung, etwa sieben plus minus zwei?
Miller (1956) setzte keine Schrittgrenze, Cowan nennt etwa vier Chunks. Schritte stehen auf der Seite: Gestalten Sie jeden Schritt, nicht die Anzahl.
DITA task · Instructions for use (IFU) · Usability · Safety information usability · Mental model
Zur CardContext CardÜbergangsthema
Kognitionspsychologie in der technischen Kommunikation: Theorie, Anwendung und die Brücken dazwischen
Worin unterscheidet sich Kognitionspsychologie als Theorie von ihrer Anwendung in der Dokumentation, und wie hängen beide zusammen?
Theorie beschreibt, wie Leser wahrnehmen, behalten und entscheiden; Anwendung macht daraus Dokumentationspraxis. Brücken machen jeden Schritt prüfbar.
Mental model · Human error · Warning message · Safety information usability · Usability · Risk assessment · Instructions for use (IFU) · DITA concept · DITA task
Zur CardContext CardÜbergangsthema
Fehlerarten und Fehlersuche: von Patzern, Aussetzern und Irrtümern zu Informationen für die Behebung
Wie helfen die Fehlerarten von James Reason und Jens Rasmussens fertigkeits-, regel- und wissensbasiertes Verhalten bei der Gestaltung von Fehlersuche- und Behebungsinformationen?
Patzer, Aussetzer und Irrtümer brauchen andere Hilfe: Konstruktion, Checklisten, Tabellen mit Symptom, Ursache und Abhilfe und Systemmodelle.
Human error · Troubleshooting · DITA troubleshooting topic · Reasonably foreseeable misuse · Risk assessment · Alarm management · Mental model
Zur CardContext CardÜbergangsthema
Kognitive Belastung und geteilte Aufmerksamkeit: die drei Belastungsarten, der Split-Attention-Effekt und was sie für die Dokumentation bedeuten
Was ist kognitive Belastung, wie hängt der Split-Attention-Effekt damit zusammen, und welche Gestaltungsentscheidungen in der Technischen Dokumentation folgen daraus?
Die Cognitive Load Theory kennt drei Belastungsarten; geteilte Aufmerksamkeit ist eine vermeidbare Ursache extrinsischer Belastung. Was daraus folgt.
Cognitive load theory · Intrinsic cognitive load · Extraneous cognitive load · Split-attention effect · Working memory · Cognitive schema · Chunking (working memory) · Expertise reversal effect · Worked example · Redundancy principle (multimedia learning) · Spatial contiguity principle · Coherence principle (multimedia learning) · Signaling principle (multimedia learning) · Cognitive theory of multimedia learning · Progressive disclosure · Minimalism (technical communication) · Think-aloud protocol · Cognitive walkthrough · Symbol · Safety information readability · Usability · DITA task · Instructions for use (IFU) · Safety sign
Zur CardContext CardÜbergangsthema
Mentale Modelle und Konzeptinformation: warum Leser wissen müssen, wie etwas funktioniert, bevor sie handeln
Wie stützt die Forschung zu mentalen Modellen, dass Konzeptinformation in der Technischen Dokumentation vor der Handlungsinformation steht?
Leser handeln nach einem mentalen Modell aus dem Systembild, Dokumentation eingeschlossen. Konzeptinformation vor Handlungen hilft beim Vorhersagen.
Mental model · DITA concept · DITA task · Human-machine interface (HMI) · Instructions for use (IFU) · Operating mode · Mental model (thinking tool)
Zur CardContext CardÜbergangsthema
Aufmerksamkeit und die Platzierung von Warnhinweisen: von selektiver Aufmerksamkeit und Gewöhnung zum richtigen Ort
Was sagt die Forschung zu Aufmerksamkeit und Warnhinweisen darüber, wo und wie Warnhinweise in Anleitungen stehen sollten?
Ein Warnhinweis wirkt nur, wenn er bemerkt, gelesen, verstanden und befolgt wird. Er steht direkt vor dem Schritt mit der Gefährdung.
Warning message · Safety information usability · Safety information readability · Safety sign · Warning (HMI message) · Alarm flooding · Risk assessment · Residual risk
Zur CardContext CardÜbergangsthema
Wie sich First Principles Thinking entwickelt hat: eine Abwandlung vieler Abwandlungen
Woher kommt First Principles Thinking, und wie hat es sich auf dem Weg ins technische Schreiben verändert?
Von Aristoteles über Euklid, Descartes, Boyd und Musk zu mentalen Modellen: Die Fassung für Technische Redakteure ist eine weitere Abwandlung.
First principles thinking · First principle (philosophy) · Socratic questioning · Axiomatic method · Analysis and synthesis (method) · Cartesian method · First-principles calculation · Destruction and creation (John Boyd) · Reasoning by analogy · Mental model · Latticework of mental models · Five whys · Risk assessment · Assumption (systems engineering)
Zur CardContext Card
Vorhersehbare Fehlanwendung dokumentieren, ohne sie zur Option zu machen
Wie beschreibt eine Anleitung vernünftigerweise vorhersehbare Fehlanwendung, ohne sie als Art der Verwendung darzustellen?
Vorhersehbare Fehlanwendung wird als klare Grenze mit Begründung formuliert, getrennt von bestimmungsgemäßer Verwendung, nie wie ein Bedienschritt.
Reasonably foreseeable misuse · Intended use · Residual risk · Risk assessment · Information for use · Machinery Regulation (EU) 2023/1230 · ISO 12100 · Warning message
Zur CardContext Card
Betriebsarten in der Technischen Dokumentation
Warum verändern Betriebsarten, was die Dokumentation einer Maschine sagen muss?
Jede Betriebsart ändert, wer wo arbeitet, welche Schutzeinrichtungen wirken und welche Gefährdungen bleiben – jede braucht eigene Dokumentationsentscheidungen.
Operating mode · Operating-mode management · Residual risk · Reasonably foreseeable misuse · Safeguard · Enabling device · Lockout/tagout (LOTO) · Personal protective equipment (PPE) · Qualified person · Machinery Regulation (EU) 2023/1230 · ISO 12100
Zur CardContext Card
Wohin eine Warnung gehört: Sicherheitskapitel oder vor die Handlung
Gehört eine Warnung ins Sicherheitskapitel oder direkt vor den Schritt, den sie betrifft?
Allgemeine Sicherheitsinformationen gehören ins Sicherheitskapitel; eine Warnung zu einer bestimmten Handlung direkt vor diese Handlung.
Warning message · Safety chapter · Residual risk · Risk assessment · Information for use · DITA hazard statement · Three-step method · Safety information usability
Zur CardContext Card
Aufgabenanalyse: eine Aufgabe, drei Blickwinkel
Ist die Aufgabenanalyse eine Methode – oder sind technische, kollaborative und kognitive Aufgabenanalyse verschiedene Dinge?
Hierarchische, Team- und kognitive Aufgabenanalyse betrachten dieselbe Aufgabe: Schritte und Pläne, Übergaben zwischen Rollen und das Denken dahinter.
Usability · DITA task · Task allocation · Human error · RACI matrix · Training needs analysis
Zur CardContext Card
Betriebsanweisung: ein Wort, viele Betreiberdokumente
Was ist eine Betriebsanweisung, und wie unterscheidet sie sich von der Betriebsanleitung des Herstellers?
Die Betriebsanweisung ist die verbindliche Anweisung des Arbeitgebers, nicht die Betriebsanleitung des Herstellers. Firmen nutzen das Wort vielfältig.
Ordinance on Industrial Safety and Health (BetrSichV) · Ordinance on Hazardous Substances (GefStoffV) · Operating manual · Instructions for use (IFU) · Personal protective equipment (PPE) · Lockout/tagout (LOTO)
Zur CardContext Card
Aufgabenanalyse in den Disziplinen der Dokumentation
Wer nutzt die Aufgabenanalyse, und in welche Dokumente fließt sie ein?
Sicherheit, Regulatory, Qualität, Entwicklung, Redaktion, Rollout und Betreiber nutzen die Aufgabenanalyse – für verschiedene Dokumente und Zielgruppen.
Risk assessment · ISO 12100 · IEC 62366-1 · Training needs analysis · Quality documentation · Product lifecycle management (PLM)
Zur CardContext Card
Betriebsanleitung: ein Handbuch oder ein Satz von Informationsprodukten?
Ist mit „Gebrauchsanleitung“ ein einzelnes Handbuch gemeint oder eine Sammlung von Dokumenten?
Eine Gebrauchsanleitung kann ein Handbuch oder ein Satz von Informationsprodukten sein; er wird übergeben und bleibt auch in den technischen Unterlagen.
Instructions for use (IFU) · Information for use · Operating manual · Maintenance manual · Technical file · Labeling and instructions for use (MDR and IVDR)
Zur CardContext Card
Interne und externe Technische Dokumentation: was „extern“ wirklich heißt
Heißt „externe Dokumentation“, dass die Dokumentation veröffentlicht wird?
„Extern“ heißt: verlässt den Hersteller – nicht unbedingt öffentlich. Funktion, Zielgruppe, Verfasser und Zugang bestimmen, was ein Dokument ist.
Technical documentation · Technical file · Information for use · Instructions for use (IFU) · Operating manual · Machinery Regulation (EU) 2023/1230
Zur CardContext Card
Die Funkanlagenrichtlinie: wenn Sektorrecht Aspektanforderungen aufnimmt
Warum schafft der Cybersicherheitsteil der Funkanlagenrichtlinie parallele Konformitätswege?
Die RED ist Sektorrecht mit Aspektanforderungen; ihr Cybersicherheitsteil doppelte den CRA bis zur Aufhebung zum 11. Dezember 2027.
Cyber Resilience Act (CRA) · Low Voltage Directive · Electromagnetic compatibility (EMC) · Harmonized standard · Presumption of conformity · CE marking
Zur CardContext Card
BSI-Leitlinien zum CRA: kontextabhängig, nicht widersprüchlich
Wenn zwei Empfehlungen des BSI zum Cyber Resilience Act unvereinbar wirken – ist die Leitlinie widersprüchlich?
Die BSI TR-03183-1 knüpft jede Kontrolle an ein Risikoszenario; scheinbare Konflikte löst die Risikobewertung, unvereinbar sind sie nicht.
Cyber Resilience Act (CRA) · Security risk assessment · Harmonized standard · Presumption of conformity · Software bill of materials (SBOM) · State of the art
Zur CardContext Card
Modul H nach dem CRA: BSI TR-03183-H baut die umfassende Qualitätssicherung auf ISO/IEC 27001 auf
Wie kann ein Hersteller die CRA-Konformität über seine Prozesse statt Produkt für Produkt nachweisen, und was ergänzt die BSI TR-03183-H?
Die BSI TR-03183-H zeigt, wie ein Modul-H-System nach CRA auf ISO/IEC 27001 aufbauen kann – auditiert von einer notifizierten Stelle, produktbezogen.
Conformity assessment · Notified body (MDR and IVDR) · Information security management system (ISMS) · Quality management · Security development lifecycle (SDL) · Harmonized standard · Presumption of conformity · Cyber Resilience Act (CRA)
Zur CardContext Card
Schwachstellenmeldungen annehmen nach BSI TR-03183-3: Meldung, Benachrichtigung, Sicherheitshinweis
Was erwartet die BSI TR-03183-3 von einem Hersteller, bevor die erste Schwachstellenmeldung eintrifft?
Die BSI TR-03183-3 richtet die Annahme von Schwachstellenmeldungen ein: security.txt, PSIRT und CSIRT, CVD-Richtlinie, Fristen und Offenlegung.
Coordinated vulnerability disclosure (CVD) · Vulnerability disclosure · Security advisory · Common Vulnerability Scoring System (CVSS) · Vulnerability management · Cyber Resilience Act (CRA)
Zur CardContext Card
Die SBOM nach BSI TR-03183-2: ein Inventar, kein Schwachstellenbericht
Was verlangt die BSI TR-03183-2 von einer Software-Stückliste, und wie hängt das mit dem CRA zusammen?
Die BSI TR-03183-2 legt Format, Felder und Tiefe der SBOM fest; die SBOM inventarisiert Komponenten und enthält nie Schwachstelleninformationen.
Software bill of materials (SBOM) · Cyber Resilience Act (CRA) · Supply chain security · License management · Security advisory · Common Vulnerabilities and Exposures (CVE) · Vulnerability management
Zur CardContext Card
Produktkategorien des CRA: Standard, wichtig und kritisch
Welche CRA-Produkte brauchen eine notifizierte Stelle, und wie viele Produkte fallen in die strengeren Kategorien?
Die meisten CRA-Produkte gehören zur Standardkategorie mit Selbstbewertung; Anhang III und IV listen die wichtigen und kritischen Ausnahmen.
Cyber Resilience Act (CRA) · Conformity assessment · Notified body (MDR and IVDR) · Harmonized standard · Presumption of conformity · Declaration of Conformity · CE marking
Zur CardContext Card
EN 50742: Safety-Related Security Levels und IEC 62443 im Zusammenspiel
Zeigt die EN 50742, dass Gesetzgeber Technisches nicht verstehen, und widersprechen ihre SRSL der IEC 62443?
Die EN 50742 ist eine CENELEC-Norm, kein Gesetz: SRSL setzen den Schutzbedarf einer Sicherheitsfunktion, IEC 62443 liefert die Maßnahmen.
Machinery Regulation (EU) 2023/1230 · IEC 62443 · Security level (SL) · Safety-security convergence · Tamper resistance · Harmonized standard · Presumption of conformity · Risk assessment
Zur CardContext Card
Maschinenverordnung und CRA: gekoppelt über Normen, nicht über Verweise
Warum können Maschinenverordnung und Cyber Resilience Act nicht einfach aufeinander verweisen?
Die MVO setzt Sicherheitsziele, der CRA Cybersicherheitsziele; die Anwendungsbereiche differieren, Konsistenz entsteht über Normen, nicht über Verweise.
Machinery Regulation (EU) 2023/1230 · Cyber Resilience Act (CRA) · Harmonized standard · Safety-security convergence · Safety-security interface · IEC 62443 · Presumption of conformity
Zur CardContext Card
Retrofit und wesentliche Veränderung nach der Maschinenverordnung
Wann macht ein Retrofit den Betreiber zum Hersteller einer Maschine?
Ein Retrofit macht nur bei wesentlicher Veränderung zum Hersteller; jedes Retrofit braucht die Gefährdungsbeurteilung, die darüber entscheidet.
Retrofit · Retrofit under the Machinery Regulation · Substantial modification · Machinery Regulation (EU) 2023/1230 · Machinery Directive 2006/42/EC · Assembly of machinery · Stop controls of an assembly of machinery (1.2.4.4) · Ordinance on Industrial Safety and Health (BetrSichV) · Technical file · Safety PLC · Remote software update · Configuration management
Zur CardContext Card
BetrSichV oder GefStoffV: Welche Verordnung trägt die Pflicht?
Kommt die Pflicht, das Explosionsschutzdokument aktuell zu halten, aus der BetrSichV oder aus der GefStoffV?
Das Explosionsschutzdokument hängt an § 6 GefStoffV, nicht an der BetrSichV – gleiches Ergebnis, andere Anspruchsgrundlage, häufig verwechselt.
Ordinance on Industrial Safety and Health (BetrSichV) · Ordinance on Hazardous Substances (GefStoffV) · Explosion protection document · Presumption effect (technical rules) · Adaptation to the state of the art (work equipment) · Grandfathering (work equipment)
Zur CardContext Card
Bestandsschutz gilt für die Bauart, nie für die Akte
Schützt der Bestandsschutz eine bestehende Anlage und ihre Dokumentation?
Kein allgemeiner Bestandsschutz für Arbeitsmittel: Ältere Bauarten dürfen bleiben, wenn sicher – veraltete Beurteilungen und Dokumente nie.
Grandfathering (work equipment) · Ordinance on Industrial Safety and Health (BetrSichV) · Adaptation to the state of the art (work equipment) · Presumption effect (technical rules) · As-built documentation · Explosion protection document · State of the art
Zur CardContext Card
Das Explosionsschutzdokument nach einem Umbau
Wann muss das Explosionsschutzdokument aktualisiert werden?
Das Explosionsschutzdokument muss jeder maßgeblichen Veränderung der Anlage folgen; Erweiterung oder versetzte Kabine gehören dazu (§ 6 GefStoffV).
Explosion protection document · Hazardous area classification (Ex zones) · Ordinance on Hazardous Substances (GefStoffV) · Grandfathering (work equipment) · Management of change (MOC) · Explosion protection · Retrofit
Zur CardContext Card
Topicbasierte vs. aufgabenorientierte Dokumentation
Ist topicbasierte Dokumentation dasselbe wie aufgabenorientierte Dokumentation?
Topicbasierte Dokumentation legt die Inhaltseinheit fest, aufgabenorientierte, welche Inhalte nötig sind. Beides ist verschieden und wird oft kombiniert.
DITA topic · DITA task · DITA concept · DITA reference · DITA map · DITA information typing
Zur CardContext Card
Minimalismus und strukturiertes Schreiben
Wie wirken Minimalismus und strukturiertes Schreiben zusammen?
Minimalismus bestimmt, was Inhalte für Nutzer leisten, strukturiertes Schreiben ihre Form. Inhaltsmodelle machen minimalistische Grundsätze zu Regeln.
Schema (data) · Schema validation · DITA (Darwin Information Typing Architecture) · DITA task · DITA specialization · Information for use
Zur CardContext Card
Every Page is Page One vs. semantische Dokumentation
Ist Every Page is Page One eine Form semantischer Dokumentation?
EPPO ist ein Schreibmodell für eigenständige Seiten, semantische Dokumentation macht Bedeutung maschinenlesbar. Zwei Modelle, die sich stärken.
DITA topic · Metadata · Taxonomy · Ontology · Information model · iiRDS Topic · Knowledge graph
Zur CardContext Card
Sechs Modelle der Technischen Dokumentation im Vergleich
Worin unterscheiden sich topicbasierte, aufgabenorientierte, EPPO-, semantische, minimalistische und strukturierte Dokumentation?
Sechs Dokumentationsmodelle beantworten sechs Fragen – Einheit, Auswahl, Eigenständigkeit, Bedeutung, Handeln, Form – und werden meist kombiniert.
Technical documentation · DITA (Darwin Information Typing Architecture) · DITA topic · DITA task · Metadata · Information model · Schema (data)
Zur CardContext Card
SDK vs. API
Was ist der Unterschied zwischen einem SDK und einer API?
Eine API ist der Vertrag zwischen zwei Programmen; ein SDK ist der Baukasten aus Bibliotheken, Werkzeugen und Beispielen, der diesen Vertrag nutzbar macht.
Software development kit (SDK) · Application programming interface (API) · REST API · Software library · Authentication · Interface contract · Semantic versioning
Zur CardContext Card
Wie die vier SDK-Typen zusammenwirken
Wo treffen Developer-, Publishing-, Plattform- und Hardware-SDKs in der Praxis aufeinander?
Hardware-, Developer-, Plattform- und Publishing-SDKs treffen sich an Gateways, APIs, Erweiterungen und Doku-Pipelines – verbunden durch Verträge und Formate.
Interoperability · Interface contract · Serialization format · JSON · Distributed tracing · Observability · IoT gateway · Digital twin · Software bill of materials (SBOM)
Zur CardContext Card
Schichten eines Hardware-SDK
Welche Schichten liefert ein Hardware-SDK zwischen Anwendungscode und Gerät?
Ein Hardware-SDK stapelt Toolchain, Treiber, Abstraktionsschicht, Laufzeit und Bibliotheken zwischen Anwendungscode und Gerät, dazu Debug-Werkzeuge.
Device driver · Firmware · Microcontroller (MCU) · Real-time operating system (RTOS) · Compiler · Debugging · Abstraction · Application binary interface (ABI) · Embedded software
Zur CardContext Card
Erweiterungspunkte einer Plattform
Wie erlaubt ein Plattform-SDK fremdem Code, eine Host-Anwendung zu erweitern?
Ein Plattform-SDK öffnet eine Host-Anwendung an benannten Erweiterungspunkten; ein Manifest nennt Beiträge und Rechte, der Host behält die Kontrolle.
Software framework · Application programming interface (API) · Authorization · Interface contract · Backward compatibility · Deprecation path · Low-code/no-code platform
Zur CardContext Card
Vier SDK-Typen im Vergleich
Was unterscheidet Developer-, Publishing-, Plattform- und Hardware-SDKs?
Developer-, Publishing-, Plattform- und Hardware-SDKs teilen eine Idee – ein Baukasten –, unterscheiden sich aber in Ziel, Artefakten, Nutzern und Steuerung.
Software development kit (SDK) · Application programming interface (API) · DITA (Darwin Information Typing Architecture) · Device driver · Firmware · Software library · Compiler
Zur CardContext Card
Stufen einer Publishing-Pipeline
Was geschieht mit strukturiertem Content in einem Publishing-SDK?
Ein Publishing-SDK löst auf, validiert, filtert, transformiert und verpackt strukturierten Content – aus einer Quelle entstehen HTML, PDF und mehr.
DITA (Darwin Information Typing Architecture) · DITA map · DITA topic · DITA conditional processing · DITA content reference (conref) · DITA key · Schema validation · Metadata
Zur CardContext Card
MQTT vs. OPC UA: Transport und Bedeutung
Was ist der Unterschied zwischen MQTT und OPC UA?
MQTT verteilt Nachrichten über einen Broker, OPC UA ergänzt Informationsmodell, Dienste und Sicherheit. Unterschiede und warum man beide kombiniert.
MQTT · OPC Unified Architecture (OPC UA) · Publish-subscribe pattern · Message broker · Information model · OPC UA PubSub
Zur CardContext Card
Kontrollpunkte für KI-Agenten
Wer kontrolliert, was ein KI-Agent tun darf?
Ein KI-Agent handelt über Identitäten, Rechte, Gateways und Protokolle. Die Kontrollpunkte, die ihn begrenzen, und was die Dokumentation dazu festhält.
AI agent · Model Context Protocol (MCP) · Role-based access control (RBAC) · Principle of least privilege · Audit trail · Human in the loop · Logging
Zur CardContext Card
KI vs. klassische Automatisierung
Worin unterscheidet sich KI von klassischer Automatisierung?
Klassische Automatisierung führt festgelegte Regeln aus, KI leitet Verhalten aus Daten ab. Warum man beides kombiniert und wie KI begrenzt wird.
Artificial intelligence (AI) · Automation · Machine learning (ML) · Programmable logic controller (PLC) · Robotic process automation (RPA) · Human in the loop
Zur Card
Methodischer Feinschliff
Methodischer Feinschliff: wo die Blueprints ihre eigenen Modelle nachschärfen
Die Blueprints auf dieser Website sprechen vom Schreibenden, von der Maschine und vom Lesenden im Singular – bewusst, denn eine Linse im Singular stellt eine Frage scharf. Diese Pathway-Karten zeigen, wo dieser Singular für eine Entscheidung zu grob wird und wie die Rollengrammatik ihn nachschärft. Die früheren Blueprints bleiben gültig; die Karten zeigen, wie sich die Modelle entwickeln.
- 1Im FokusDie Quelle – die SchreibendenEine Schreibende, viele SchreibendeWer schreibt einen technischen Text – und warum ist es wichtig, dass es nicht eine Person ist?
- 2Im FokusDer Mensch – der LesendeDrei Bediener, ein WarnhinweisWarum braucht derselbe Warnhinweis für eine unterwiesene Bedienerin, einen geschulten Bediener und eine Elektrofachkraft unterschiedliche Informationen?
- 3Im FokusDer Mensch und der dritte Leser – Berufsgruppen und der KI-AgentVon Berufsgruppen zu RollenWarum zeigt ein Raster aus Berufsgruppen – Redaktion, Marketing, Projektleitung, Entwicklung, der Lesende, der KI-Agent –, wer beteiligt ist, aber nicht, wer was tut?
- 4Im FokusDer dritte Leser – die MaschineDie Maschine ist ein Netz, kein MonsterWenn eine KI-Antwort falsch ist, warum ist „die Maschine hat sich geirrt“ keine Diagnose?
- 5Im FokusDer dritte Leser – die AntwortfunktionDie Antwortfunktion stellt zusammen – sie liest nichtIst eine KI-Antwortfunktion eine Lesende der Dokumentation?
- 6Im FokusAlle drei Platzhalter – die fünf TätigkeitsfamilienDie Rollengrammatik: Lesen, Schreiben und ZusammenstellenWie sagt man, wer was mit einer technischen Information tut – wenn „der Schreibende“, „die Maschine“ und „der Lesende“ zu grob sind?
- 7Im FokusAlle drei Platzhalter – vom Platzhalter zur PrüfregelVon drei Lesern zu PrüfrollenDie Startseite nennt drei Leser – die Quelle, den Menschen und den dritten Leser. Warum genügt das, um eine Prüfmethode zu entwerfen, und was muss sich ändern, bevor eine Prüfung laufen kann?