Workflow Design Guide

Cylc/Rose Workflow Design Best Practice Guide.

This document provides guidance on making complex Cylc + Rose workflows that are clear, maintainable, and portable. Note that best practice advice may evolve over time with the capabilities of Rose and Cylc.

Content is drawn from the Rose and Cylc user guides, earlier Met Office workflow design and operational workflow review documents, experience with real workflows across the Unified Model Consortium, and discussion among members of the UM TISD (Technical Infrastructure Workflow Design) working group.

We start with the most general topics (coding style, general principles), move on to more advanced topics (efficiency and maintainability, portable workflows), and end with some pointers to future developments.


A good working knowledge of Cylc and Rose is assumed. For further details, please consult the:


For non-Rose users: this document comes out of the Unified Model Consortium wherein Cylc is used within the Rose workflow management framework. However, the bulk of the information in this guide is about Cylc workflow design; which parts are Rose-specific should be clear from context.