# Workflow Fix Template

> workflow-fix-template

- Skill: `jajupmochi/workflow-fix-template` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jajupmochi/workflow-fix-template`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jajupmochi/workflow-fix-template/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: jajupmochi (https://skillmd.com/u/jajupmochi)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jajupmochi/workflow-fix-template

---


# workflow-fix-template

## RESEARCH phase checklist

1. List ALL workflow files: `ls .github/workflows/`
2. Check CI run logs (gh CLI or web UI): `gh run list --limit 5; gh run view <id> --log`
3. Identify EVERY failing job — do not stop at the first one
4. For each failure: read the log output, identify root cause
5. Common failure patterns:
   - Gitleaks false positives → needs .gitleaks.toml
   - npm ERR_OSSL_EVP_UNSUPPORTED → needs NODE_OPTIONS=--openssl-legacy-provider
   - Missing binary → check bin field in package.json
   - Permission denied → check chmod +x, workflow scope
   - Raw URL 404 → check file paths in raw-url job

## DESIGN phase checklist

1. For each failure: design minimal fix
2. Check if fix affects other jobs in the same workflow
3. Check if fix affects the OTHER workflow file (install-verify ↔ privacy-scan)
4. Any new config files needed? (.gitleaks.toml, .npmrc, etc.)

## PLAN template

```
1. Fix [JOB_NAME] in [WORKFLOW_FILE]: [ROOT_CAUSE] → [FIX]
2. Fix [JOB_NAME] in [WORKFLOW_FILE]: [ROOT_CAUSE] → [FIX]
3. Create [CONFIG_FILE] if needed
4. Local verify: [VERIFY_COMMANDS]
5. Commit with conventional format: fix(ci): [DESCRIPTION]
6. Push
7. Check CI status: gh run watch
```

## VERIFY phase checklist

1. Run CI locally if possible
2. Push and watch: `gh run watch`
3. ALL jobs must pass — if any fail, go back to RESEARCH
4. Check both main AND codex-adapter branches
5. Confirm no regression in previously-passing jobs

## Anti-patterns

- Fixing only the first error found → audit ALL failures
- Assuming a fix works without checking CI → always verify
- Forgetting to check the OTHER workflow file → cross-check both
- Using force push for workflow fixes → use normal push, let CI validate