Mission — Praxis

Kernaussage: Dokumentation ist kein Anhängsel, sondern treibende Kraft für erfolgreiche KI-Projekte in KMU; sie reduziert Risiken, erhöht Transparenz und beschleunigt Wertschöpfung.

Warum Dokumentation für KI-Projekte zentral ist

Dokumentation schafft Nachvollziehbarkeit von Daten, Modellen und Entscheidungen. In KMU fehlt oft die Ressource für aufwändige Governance. Eine gezielte, pragmatische Dokumentation stellt sicher, dass Modelle später gewartet, angepasst oder auditierbar sind. Dokumentierte Datenquellen, Vorverarbeitungsschritte und Modellannahmen verhindern Fehler bei Updates und beim Wissenstransfer zwischen Mitarbeitenden oder Dienstleistern.

Beispiel: Ein Marketingteam nutzt ein Prognosemodell für Leads. Ohne Dokumentation weiss niemand, welche Kampagnen in den Trainingsdaten enthalten waren. Folge: falsche Interpretationen und Budgetverschiebungen.

Welche Inhalte jede KI-Dokumentation enthalten muss

Konzentrieren Sie sich auf das Wesentliche: Datenherkunft, Datenqualität, Vorverarbeitung, Modellversion, Bewertungsmassstäbe, Einsatzkontext und Verantwortlichkeiten. Kurze, standardisierte Einträge reichen oft aus. Verwenden Sie klare Begriffe statt vager Beschreibungen. Ein Eintrag für ein Datenset sollte mindestens Quelle, Aktualität, fehlende Werte-Handling und Zugriffsrechte enthalten.

Beispiel: Ein CRM-Export wird mit Version, Exportdatum und Filterregeln versehen. So erkennen spätere Nutzer sofort Abweichungen.

Praktisches Format und Ablage

Wählen Sie Formate, die im Alltag genutzt werden: einfache Markdown- oder Textvorlagen, ein zentrales Sharepoint- oder Nextcloud-Verzeichnis oder ein Ticketsystem mit Standardfeldern. Wichtiger als ein perfektes Tool ist eine verbindliche Ablage- und Benennungskonvention. Notieren Sie Checklisten für Deployment, Tests und Rollback-Prozeduren neben dem Modell.

Beispiel: Ein KMU legt für jedes Modell eine Ordnerstruktur an: /Modelle/ProjektX/v1/{Daten,Code,Docs,Tests}. Jede Änderung erfordert ein kurzes Changelog.

Integration in den Projektalltag

Machen Sie Dokumentation zur Aufgabe in jeder Sprint‑ oder Projektphase. Kurz, wiederkehrend und verpflichtend: beim Datenzugriff, nach Feature Engineering, vor jedem Training und bei jedem Release. Verknüpfen Sie Dokumentationsschritte mit Akzeptanzkriterien und Review-Punkten. Schulungen sind kurz und praktisch: eine Stunde, zwei Beispiele, Vorlagen zeigen.

Beispiel: In der täglichen Retrospektive wird überprüft, ob die Dokumentationsvorlage aktualisiert wurde, bevor ein Task als erledigt markiert wird.

Typische Fehler und Korrekturen

Fehler 1: Dokumentation entsteht erst nach Projektabschluss. Korrektur: Dokumentation als Teil der Definition of Done verankern; jeder Arbeitsschritt kurz dokumentieren, bevor er als abgeschlossen gilt.

Fehler 2: Zu technische oder zu allgemeine Dokumente, die Mitarbeitende nicht verstehen. Korrektur: Zwei Ebenen anlegen—eine technische (für Entwickler) und eine zusammenfassende, praxisnahe Version (für Fachabteilungen). Nutze klare Begriffe und konkrete Beispiele.

Fehler 3: Ablage verstreut und ohne Namenskonvention. Korrektur: Ein zentrales Register mit verbindlicher Ordnerstruktur und einfachen Namensregeln. Automatisierte Templates beim Anlegen neuer Projekte einsetzen.

Messbarer Nutzen und Governance

Setzen Sie einfache Kennzahlen: Anteil dokumentierter Modelle, Zeit bis Wiederinbetriebnahme nach Fehler, Anzahl reproduzierbarer Experimente. Definieren Sie Rollen: Datenverantwortlicher, Modellbetreuer, Reviewer. Regeln für Zugriff und Änderungsfreigabe reduzieren Betriebsrisiken und erleichtern externe Prüfungen.

Beispiel: Nach Einführung der Dokumentationsvorlage sank die Wiederanlaufzeit nach einem Modellfehler in einem Vertriebsprojekt von 10 auf 3 Arbeitstage.

Handlungsanleitung für die nächsten 14–30 Tage

Tag 1–3: Legen Sie eine minimale Dokumentationsvorlage an (Datenquelle, Vorverarbeitung, Modellversion, Metriken, Verantwortliche). Nutzen Sie ein vorhandenes Ablagesystem.

Tag 4–7: Erfassen Sie für ein laufendes KI‑Projekt rückwirkend die fehlenden Basisinformationen nach Vorlage. Kurzes Review mit Projektverantwortlichem.

Tag 8–12: Implementieren Sie die Namenskonvention und Ordnerstruktur als verbindlichen Standard. Erstellen Sie ein kurzes Anleitungsdokument (1 Seite).

Tag 13–17: Führen Sie eine 60‑Minuten‑Schulung für betroffene Teams durch. Zeigen Sie Beispiele und die Vorlage.

Tag 18–21: Verknüpfen Sie Dokumentation mit der Definition of Done in Ihrem Task- oder Ticketsystem. Stellen Sie sicher, dass Tasks ohne Dokumentation nicht abgeschlossen werden können.

Tag 22–26: Messen Sie erstes Ergebnis: erfassen Sie die Anzahl dokumentierter Projekte und die Zeit, die Teammitglieder für Dokumentation aufwenden. Ein kurzes Feedback sammeln.

Tag 27–30: Passen Sie Vorlage und Prozesse basierend auf Feedback an und planen Sie vierteljährliche Reviews. Benennen Sie eine verantwortliche Person für Governance.

Dokumentation ist ein Investitionsgegenstand, kein bürokratisches Hindernis. Wer sie systematisch als Teil der KI‑Mission führt, senkt Kosten, steigert Transparenz und schafft stabile Grundlagen für Wachstum.