[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.

## Matched source
Source: Source: https://github.com/yoselingt/resuenawebapp/blob/HEAD/.claude/skills/deployment-skill/SKILL.md
Original query: "Bitbucket Pipelines: a single YAML artifact invalidates the whole config"
Key terms: artifact, bitbucket, config, invalidates, pipelines, single, whole, yaml