Name workflows by concern or application area.

Section: Make pipelines maintainable

Use predictable workflow names

text
text
ci-web.yml
ci-api.yml
deploy-production.yml
nightly-maintenance.yml
Explanation

Good naming helps teams navigate automation quickly as the number of workflows grows.

Learn the surrounding workflow

Compare similar commands or jump into common fixes when this command is part of a bigger troubleshooting path.

Related commands

Same sheet · prioritizing Make pipelines maintainable
Wrap repeated commands in repo scripts
Keep YAML small by moving logic into versioned scripts.
OpenIn sheetbashsame section
Expose pipeline health publicly
Add workflow status badges to docs or README files.
OpenIn sheetmarkdownsame section
GitHub path filters
Run workflows only when selected folders change.
GitLab rules with changes
Conditionally run jobs based on file changes.
Generate jobs per package
Drive job fan-out from changed package lists or matrix inputs.