Eine Automatisierung ohne Dokumentation wird zum Risiko, sobald die Person ausfällt, die sie gebaut hat. Es braucht aber keine langen Handbücher, sondern die richtigen Angaben.
Die kurze Vorlage
- Zweck: Was tut der Workflow und warum?
- Auslöser: Wann startet er?
- Systeme und Zugänge: Was wird genutzt?
- Verantwortung: Wer ist fachlich zuständig?
- Fehlerfall: Was ist zu tun?
- Änderungen: Was wurde wann warum geändert?
Direkt im Werkzeug
Sprechende Namen und kurze Notizen in n8n oder Make helfen im Alltag oft mehr als ein separates Dokument, das schnell veraltet.
Ein Fehlerprotokoll lohnt sich
Halten Sie bei jedem Vorfall Ursache und Gegenmaßnahme fest. Mit der Zeit entsteht daraus das wertvollste Wissen über das System.
Ein ausgefülltes Beispiel statt Theorie
Abstrakte Vorlagen werden oft erst verständlich, wenn man sie angewendet sieht. Nehmen wir einen Workflow, der Eingangsrechnungen aus einem Postfach liest und dem Sachbearbeiter zur Freigabe vorlegt. Ein brauchbarer Steckbrief ist in wenigen Minuten gelesen: Er liest neue Mails im Rechnungspostfach, erkennt Anhänge, liest die Pflichtangaben aus und erstellt eine Freigabeaufgabe. Fachlich zuständig ist die Buchhaltung, technisch die IT.
Entscheidend sind die Sätze, die sonst fehlen: „Wenn Rechnungen ausbleiben, zuerst das Postfach-Passwort prüfen.“ Oder: „Der Workflow darf gestoppt werden, Mails bleiben ungelesen und werden später nachgeholt.“ Solche Hinweise helfen der Vertretung in einer Störung mehr als jede technische Beschreibung, weil sie sagen, was gefahrlos möglich ist.
Drei Leser, drei Bedürfnisse
Eine Dokumentation scheitert häufig daran, dass sie alle zugleich bedienen will. Besser ist es, sie gedanklich nach den Lesern zu ordnen. Die Fachabteilung will wissen, was der Workflow tut und wie sie Fehler bemerkt. Die Vertretung in der Technik braucht Zugänge, Abhängigkeiten und den sicheren Neustart. Die Geschäftsführung oder ein Prüfer möchte vor allem sehen, welche Systeme verbunden sind, welche Daten fließen und wer verantwortlich ist.
- Fachabteilung: Ablauf in einfacher Sprache, Grenzen, Ansprechperson
- Technik: Auslöser, Schnittstellen, Abhängigkeiten, Neustart und Nachlauf
- Prüfung und Leitung: Datenarten, beteiligte Anbieter, Zuständigkeit, Stand der Dokumentation
Zugänge dokumentieren, ohne sie preiszugeben
Passwörter und API-Schlüssel gehören nicht in die Dokumentation, in Notizen oder in Screenshots. Notieren Sie stattdessen, wie der Zugang heißt, wo er liegt und wer ihn erneuern darf. Das gilt für den Passwort-Manager ebenso wie für den Credential-Speicher von n8n oder Make.
Besonders tückisch sind Zugänge, die an eine einzelne Person gebunden sind. Verlässt die Kollegin das Unternehmen und wird ihr Konto deaktiviert, steht plötzlich der Workflow still. Halten Sie deshalb fest, unter welchem Konto eine Verbindung läuft, und nutzen Sie, wo möglich, technische Konten. Auch Ablaufdaten von Schlüsseln und Zertifikaten gehören in die Notizen, am besten mit einer Erinnerung im Kalender des zuständigen Teams.
Vergessen Sie auch Abhängigkeiten zwischen Workflows nicht. Wenn ein Ablauf eine Tabelle füllt, aus der ein anderer liest, kann eine harmlose Änderung an anderer Stelle eine Störung auslösen. Eine einfache Übersicht aller produktiven Workflows mit Eingängen und Ausgängen macht solche Verbindungen sichtbar und zeigt zugleich, welche Abläufe niemand mehr benötigt.
Damit die Dokumentation aktuell bleibt
Dokumentation veraltet nicht aus Bosheit, sondern weil niemand beim Ändern daran denkt. Machen Sie sie deshalb zum Teil der Freigabe: Eine Änderung gilt erst als fertig, wenn auch der Steckbrief stimmt. Exportieren Sie den Workflow zudem regelmäßig in eine Versionsverwaltung, damit frühere Stände auffindbar bleiben.
Der beste Test ist einfach: Bitten Sie jemanden, der den Workflow nicht gebaut hat, nur mit Hilfe der Unterlagen einen Fehlerfall durchzuspielen. Jede Rückfrage zeigt eine Lücke. KI kann beim Schreiben helfen und aus einem exportierten Workflow einen ersten Entwurf ableiten. Die fachlichen Gründe für einen Ablauf stehen aber nicht im Export und müssen von Menschen ergänzt werden.
Wie viel Dokumentation braucht welcher Workflow?
| Art des Workflows | Mindestumfang | Zusätzlich sinnvoll |
|---|---|---|
| Interne Hilfe ohne Außenwirkung | Zweck, Verantwortung, kurze Notizen im Werkzeug | Hinweis, was bei einem Ausfall zu tun ist |
| Regelmäßiger Fachprozess | Vollständiger Steckbrief mit Fehlerfall | Protokoll der Vorfälle und Änderungen |
| Mit personenbezogenen Daten | Steckbrief plus Datenarten und beteiligte Anbieter | Abgleich mit dem Verarbeitungsverzeichnis |
| Geschäftskritisch oder mit Außenwirkung | Steckbrief, Notfallablauf, Vertretungsregel | Regelmäßig geübter Wiederanlauf |
Ein Workflow gilt als dokumentiert, wenn
Typische Fehler
Die Reihenfolge der Schritte zeigt das Werkzeug selbst. Schreiben Sie auf, warum ein Schritt nötig ist und welche Geschäftsregel dahintersteckt.
Sie veralten bei der nächsten Änderung und können versehentlich sensible Daten zeigen. Sprechende Namen, kurzer Text und Versionsstände sind pflegeleichter.
Dann fehlen Zeit und die Erinnerung an wichtige Entscheidungen. Halten Sie Gründe und Annahmen beim Bauen fest, und sei es nur in einer Notiz im Workflow.
Häufige Fragen
Was gehört in eine Workflow-Dokumentation?
Mindestens Zweck, Auslöser, beteiligte Systeme, Verantwortliche, Verhalten im Fehlerfall und ein Änderungsverlauf. Bei personenbezogenen Daten kommen die Datenarten und die beteiligten Anbieter hinzu.
Wie dokumentiert man n8n- oder Make-Workflows am besten?
Nutzen Sie sprechende Namen und Notizen direkt im Werkzeug und ergänzen Sie einen kurzen Steckbrief an einem festen Ort. Regelmäßige Exporte sichern zusätzlich frühere Stände.
Kann KI Workflows automatisch dokumentieren?
Aus einem Export kann KI einen guten ersten Entwurf der technischen Beschreibung erstellen. Warum etwas so gebaut wurde und wer zuständig ist, müssen Menschen prüfen und ergänzen. Entfernen Sie vor der Übergabe Geheimnisse aus dem Export.
Von Patrick Thomas, KI Sidekick. Dieser Artikel ersetzt keine Rechts- oder Steuerberatung.
