| name | github-workflow |
| description | GitHub issue, pull request, CI, release, and code review workflow for Product Factory OS projects. Use when work involves GitHub Issues, PR summaries, review comments, failing GitHub Actions, release branches, changelogs, or publishing project state to GitHub. |
| argument-hint | issue, pull request, branch, check run, release, or GitHub repo |
| license | MIT |
| metadata | {"category":"integration","tags":["github","pull-request","ci","release"],"effort":"medium","side_effect":"external-write","explicit_invocation":true,"skill_version":1,"prompt_version":"pfo-github-workflow-v1","eval_dataset":"tests/eval-datasets/github-workflow.json"} |
GitHub Workflow
Use this skill when Product Factory OS state needs to connect to GitHub work.
Capabilities
- Convert
EXECUTION_GRAPH.md nodes and blockers into GitHub issues.
- Inspect PR metadata, review comments, and check status through the GitHub plugin or
gh when available.
- Debug failing GitHub Actions before changing code.
- Prepare branch, changelog, release notes, and PR summaries.
- Keep
QUALITY_GATES.md and .codex-memory/STATE.json aligned with PR and CI status.
Procedure
- Identify the repository, branch, issue, PR, or check run.
- Read local git status before mutating anything.
- Use GitHub connector capabilities first; use
gh only when connector coverage is insufficient.
- Map findings back to PFO artifacts:
- issues -> execution nodes or blockers
- CI checks -> verification history
- review comments -> repair actions
- release notes -> completed modules and accepted risks
- Before branch completion, record
pfo finish-branch <project> --mode pr|merge|keep|discard --verification ....
- Update integration payloads with
python3 scripts/pfo.py export <project> --target github when a file export is requested.
Output
Return:
GITHUB TARGET:
PFO ARTIFACTS UPDATED:
CHECK STATUS:
ACTION TAKEN:
BLOCKERS:
NEXT ACTION:
Self-validation
Before final output, verify:
- Route, side-effect, and confirmation requirements match metadata.
- Required artifacts or read-only result are explicit.
- Verification, blockers, and next route are stated.
Rules
- Do not push, merge, close issues, resolve review threads, or create production releases without explicit user intent.
- Do not hide failing CI behind documentation-only status.
- Keep local worktree changes scoped to the active execution node.
- Do not mark branch work finished without fresh verification and
BRANCH_FINISH.md when branch finish is in scope.
- If GitHub is unavailable, produce
.pfo-integrations/github.json and state that live sync was not performed.
