Orchestrate-commando (multi-step workflows uitvoeren)

Dit bestand is door ToolBrain vertaald en inhoudelijk gewijzigd op 2026-08-30, op basis van orchestrate uit rohitg00/awesome-claude-code-toolkit (Apache-2.0), zie https://github.com/rohitg00/awesome-claude-code-toolkit/blob/ebdf1d596d2cde5c5cceb32177e8d1cf4829e7d9/commands/workflow/orchestrate.md en ../LICENSES/awesome-claude-code-toolkit-APACHE-2.0.txt.

Dit patroon beschrijft hoe je een complexe taak opsplitst in gecoördineerde subtaken en die gestructureerd uitvoert en rapporteert. Het is bedoeld als draaiboek voor een los commando of een sub-workflow die je aanroept zodra een taak te groot of te samengesteld is om in één stap uit te voeren — precies het soort orkestratie dat ook in een n8n-flow met meerdere deel-workflows terugkomt.

Stappen

1. Verwerk de workflow-specificatie uit de invoer:
   • Accepteer een natuurlijke-taal-omschrijving van het einddoel.
   • Of accepteer een gestructureerd plan met expliciete stappen.
2. Splits het geheel op in geordende subtaken:
   • Identificeer afhankelijkheden tussen taken (wat moet eerst klaar zijn voordat iets anders kan starten).
   • Bepaal welke taken parallel kunnen draaien.
   • Schat de complexiteit per taak in (klein, middel, groot).
3. Definieer voor elke subtaak:
   • Een duidelijk doel en succescriterium.
   • De benodigde input (bestanden, data, output van eerdere taken).
   • De verwachte output (aangemaakte bestanden, doorgevoerde wijzigingen, resultaten).
   • De verificatiemethode (test, handmatige controle, geslaagde build).
4. Voer de taken uit in afhankelijkheidsvolgorde:
   • Markeer elke taak als openstaand, bezig of afgerond.
   • Leg de output en eventuele fouten van elke stap vast.
   • Faalt een taak, bepaal dan of afhankelijke taken moeten worden overgeslagen of toch door kunnen gaan.
5. Draai na afloop van alle taken een eindverificatie:
   • Build slaagt.
   • Tests slagen.
   • Geen regressies geïntroduceerd.
6. Rapporteer de volledige uitvoeringssamenvatting.

Rapportageformaat

Workflow: <omschrijving>
Taken: <totaal> (<afgerond>/<totaal>)

| # | Taak | Status | Duur | Notities |
|---|------|--------|------|----------|
| 1 | <taak> | afgerond | 2m | <notities> |
| 2 | <taak> | afgerond | 5m | <notities> |
| 3 | <taak> | mislukt | 1m | <foutmelding> |

Totaal: <geslaagd/deels geslaagd/mislukt>
Duur: <totale tijd>

Vaste regels

• Voer nooit destructieve operaties (verwijderen, force push) uit zonder expliciete bevestiging.
• Faalt een kritieke taak, stop dan en rapporteer in plaats van blind door te gaan.
• Houd elke subtaak gefocust en onafhankelijk verifieerbaar.
• Sla voortgang op na elke afgeronde taak, zodat werk niet verloren gaat bij een storing.
• Beperk een workflow tot maximaal 10 taken; splits grotere workflows op in fasen.

Praktijkvoorbeeld (NL)

Een Nederlands administratiekantoor gebruikt een orkestrerende n8n-workflow om aan het einde van elk kwartaal de BTW-aangifte voor tien kleine MKB-klanten voor te bereiden. De hoofdworkflow splitst dit op in subtaken per klant: facturen ophalen uit Moneybird, bonnetjes matchen, afwijkingen signaleren, en een conceptaangifte samenstellen. Omdat het ophalen van facturen per klant onafhankelijk is, draaien die subtaken parallel, terwijl het samenstellen van de conceptaangifte pas start zodra zowel facturen als bonnetjes voor die klant compleet zijn. Gaat het bij één klant mis — bijvoorbeeld een ontbrekende factuurkoppeling — dan stopt alleen de subtaak van die klant met een duidelijke foutmelding in het eindrapport, terwijl de negen andere klanten gewoon worden afgerond; niemand hoeft te wachten tot het probleem bij die ene klant is opgelost.