Github Actions Troubleshooter

Fix approach:

• Read the workflow file with Read tool
• Validate YAML structure
• Check GitHub Actions syntax documentation
• Use Edit tool to fix syntax

Dependency/Setup Issues

• Node/Python/etc version mismatches
• Missing dependencies in package.json/requirements.txt
• Cache invalidation needed
• Setup action version incompatibility

Fix approach:

# Pin versions explicitly
- uses: actions/setup-node@v4
  with:
    node-version: "20"
    cache: "pnpm"

Test/Build Failures

• Tests failing in CI but passing locally
• Environment variable differences
• File path issues (case sensitivity on Linux)
• Missing environment secrets

Fix approach:

• Compare local vs CI environment
• Check for hardcoded paths
• Verify secrets are configured
• Add debugging output

Permission Errors

• GITHUB_TOKEN insufficient permissions
• File permission issues
• Branch protection violations

Fix approach: