GitHub Workflow
Use for GitHub-hosted collaboration and publishing. Use git-workflow for local staging, commits, rebases, conflicts, branch cleanup, Git tag safety, or history rewrites.
Rules
- Read repository-specific GitHub guidance first:
.github/, PR templates, release workflows, branch protection notes, CONTRIBUTING.md, and README.md.
- Never claim GitHub status, checks, reviews, or release state unless you inspected them.
- Do not merge, close, publish, mark latest, delete releases, or delete remote branches unless explicitly requested.
- Treat green status as necessary but not sufficient: also check annotations, warnings, bot comments, and review state.
- For local Git history decisions, follow
git-workflow.
Reference Routing
Read only the references needed for the requested task.
| Reference |
Use For |
references/pull-requests.md |
Creating PRs, PR descriptions, review responses, merge readiness |
references/stacked-prs.md |
Stacked PR chains, sequential squash merges, base retargeting |
references/github-releases.md |
GitHub Releases, release publishing, latest flag, published release recovery |
references/upstream-sync.md |
Explicit requests to create or review fork upstream-sync GitHub Actions workflows |
GitHub Action Safety Checklist
Before merging, enabling auto-merge, publishing a release, changing release latest, or dismissing review/check state:
- Check worktree and branch state using
git-workflow when local changes or branch history matter.
- Inspect the exact PR, release, check run, or review thread targeted by the request.
- Confirm required checks, review state, branch protection, and requested merge/release mode.
- Act only on the target named by the user or verified from repository metadata.
- Report the command, URL, or API result used as evidence.
Default Workflow
- Read repository-specific GitHub guidance.
- Check worktree and branch state using
git-workflow when needed.
- Inspect GitHub status, reviews, and templates relevant to the request.
- Make or recommend GitHub changes only within the user's requested scope.
- Report verification source, remaining blockers, and follow-up actions.
1---2name: github-workflow3description: Use when working with GitHub workflows: pull requests, PR reviews, review threads, PR merges, auto-merge, GitHub Actions checks, CI annotations, branch protection, GitHub Releases, gh CLI commands, release publishing, or fork upstream-sync automation.4---56# GitHub Workflow78Use for GitHub-hosted collaboration and publishing. Use `git-workflow` for local staging, commits, rebases, conflicts, branch cleanup, Git tag safety, or history rewrites.910## Rules11121. Read repository-specific GitHub guidance first: `.github/`, PR templates, release workflows, branch protection notes, `CONTRIBUTING.md`, and `README.md`.132. Never claim GitHub status, checks, reviews, or release state unless you inspected them.143. Do not merge, close, publish, mark latest, delete releases, or delete remote branches unless explicitly requested.154. Treat green status as necessary but not sufficient: also check annotations, warnings, bot comments, and review state.165. For local Git history decisions, follow `git-workflow`.1718## Reference Routing1920Read only the references needed for the requested task.2122| Reference | Use For |23| --- | --- |24| `references/pull-requests.md` | Creating PRs, PR descriptions, review responses, merge readiness |25| `references/stacked-prs.md` | Stacked PR chains, sequential squash merges, base retargeting |26| `references/github-releases.md` | GitHub Releases, release publishing, latest flag, published release recovery |27| `references/upstream-sync.md` | Explicit requests to create or review fork upstream-sync GitHub Actions workflows |2829## GitHub Action Safety Checklist3031Before merging, enabling auto-merge, publishing a release, changing release `latest`, or dismissing review/check state:3233- Check worktree and branch state using `git-workflow` when local changes or branch history matter.34- Inspect the exact PR, release, check run, or review thread targeted by the request.35- Confirm required checks, review state, branch protection, and requested merge/release mode.36- Act only on the target named by the user or verified from repository metadata.37- Report the command, URL, or API result used as evidence.3839## Default Workflow40411. Read repository-specific GitHub guidance.422. Check worktree and branch state using `git-workflow` when needed.433. Inspect GitHub status, reviews, and templates relevant to the request.444. Make or recommend GitHub changes only within the user's requested scope.455. Report verification source, remaining blockers, and follow-up actions.