When a freestyle step command contains a colon or other YAML-special characters, write it as a block scalar with |- (keeps line breaks) or >- (folds to spaces). Any generated codefresh.yml should default to block scalars for commands rather than inline strings; it costs nothing and avoids the whole class of parse failures.

Context: Official docs (Codefresh codefresh.yml reference): documents the YAML gotcha that breaks pipelines agents generate. A command like echo hello: world fails to parse because the colon collides with YAML syntax, and the pipeline fails before anything runs. The docs show the fix: multi-line string scalars.