Casestudy
Zelf-documenterende automatiseringsbibliotheek
Elke actieve workflow legt zichzelf uit: één run levert actuele documentatie in gewone taal voor de hele automatiseringsstack
Overzicht
Hoe meer een bedrijf automatiseert, hoe groter een stil risico wordt: niemand weet nog precies wat waar draait, wat elke workflow raakt en wat er omvalt als iets stopt. Wij bouwden een automatisering die de automatiseringen documenteert. Op verzoek vraagt hij via de n8n-API alle actieve workflows op, loopt per workflow de triggers, gekoppelde apps en stappen na, laat AI in gewone taal beschrijven wat hij doet en waarom dat ertoe doet, en publiceert het resultaat in een gedeeld document dat van de klant is. Eén run ververst de hele bibliotheek — zo blijft de automatiseringsstack leesbaar voor het team, niet alleen voor ons.
De uitdaging
Probleem: Een groeiende set automatiseringen deed serieus werk, maar de kennis over hoe alles samenhing zat in één hoofd. Dat maakte overdrachten riskant, audits traag en elke wijziging een kleine gok.
Zo werkt het
Eén run leest de volledige automatiseringsstack uit via de API en ververst een begrijpelijk document dat van de klant is.
Technische uitwerking
Inventarisatie op API-niveau
De workflow bevraagt de n8n-API rechtstreeks op elke actieve, niet-gearchiveerde workflow — de documentatie weerspiegelt dus wat er écht draait, niet wat iemand zich herinnert.
AI schrijft gewone taal
De structuur van elke workflow — trigger, gekoppelde apps, stappen — gaat naar een AI-model dat een beschrijving schrijft die ook een niet-technische lezer kan volgen: wat hij doet, wanneer hij draait en wat hij raakt.
Gebatcht en rustig verwerkt
Workflows worden in batches verwerkt met pauzes ertussen, zodat de run betrouwbaar blijft — ook als de bibliotheek groeit.
Output in eigendom van de klant
De documentatie landt in een Google Doc in de eigen werkruimte van de klant — leesbaar, deelbaar en van hen. Geen eigen formaat, geen afhankelijkheid van ons om de stack uit te leggen.
Belangrijkste functies
- Documenteert elke actieve workflow in één run
- Leest de echte stand uit via de n8n-API — nooit verouderde notities
- AI schrijft per workflow een beschrijving in gewone taal
- Legt triggers, gekoppelde apps en kernstappen vast
- Publiceert in een gedeeld Google Doc van de klant
- Op elk moment opnieuw te draaien voor een verse bibliotheek
Ook zo'n systeem nodig?
Vertel ons waar het werk vastloopt — in één gesprek hoor je wat er nodig is om dat op te lossen.
Impact
Gebruikte technologie
Wat het oplevert
- De automatiseringsstack is nooit een black box
- Overdrachten en audits starten met actuele, complete documentatie
- Nieuwe teamleden begrijpen wat er draait zonder speurwerk
- Geen lock-in: de klant kan alles lezen, bezitten en ernaar handelen