Debug: GitHub Actions workflow not triggering

GitHub Actions workflow doesn't run when expected. Push or PR events don't trigger the workflow.

Common causes and fixes:

1. Wrong branch filter:

on:
push:
branches: [main] # Only triggers on main, not feature/*
Fix: Add your branch pattern or use '**' for all

1. Wrong file path:

Workflow must be in .github/workflows/*.yml
NOT .github/workflow/ (missing 's')

1. YAML syntax error:

# Validate locally:
# yamllint .github/workflows/ci.yml
# Or check Actions tab for parsing errors

1. paths filter too restrictive:

on:
push:
paths: ['src/**'] # Won't trigger for README changes

1. Forked repo restrictions:

# Workflows from forks need approval for first-time contributors
# Check: Settings > Actions > Fork pull request workflows

1. Workflow disabled:

# Check: Actions tab > select workflow > Enable workflow

1. push to tag but on:push:branches configured:

# Tags need separate trigger:
on:
push:
tags: ['v*']

1. Check recent runs:

gh run list --workflow=ci.yml
gh run view <run-id> --log-failed