[field troubleshooting]: validate the YAML locally before pushing with yaml.safe_load on the file. The classic silent killers: a stray closing tag left from a copy-paste, unquoted globs like feature/*, and secured variables used inside parse-time templates (empty at parse time). Also check triggers: without a default: block, a push to a branch that matches no branches: block runs nothing, and pull-requests matches the SOURCE branch of the PR, not the destination.

Context: Bitbucket reports 'error in your bitbucket-pipelines.yml' and nothing runs. A stray artifact (copy-pasted tag, broken indentation, invalid anchor) kills the entire config, not just the affected step.