| name | internal-github-pr |
| description | Use when /internal-github routes pull-request lifecycle work covering creation, body updates, readiness, reviews, merge, or terminal-state verification. |
| user-invocable | false |
Internal GitHub PR
Own pull-request lifecycle work from template resolution through verified
terminal state. Ground every statement in the actual diff, review state, and
fresh validation evidence.
When to use
Use when the requested deliverable is pull-request content, review readiness,
merge execution, or repository-scoped terminal-state proof.
PR workflow
- Resolve one repository pull-request template and preserve its headings and
order.
- Extract specification outcomes and map them to the actual diff. Identify
gaps instead of inventing completion.
- Draft or update concise PR content with relevant scope, changes, risk,
rollback, and validation evidence.
- Detect the current PR state and update or create the draft as appropriate.
- For readiness, verify checks and qualifying non-author review state from
PR-specific evidence; green checks alone are insufficient under required
review policy.
- Prefer
gh pr merge --squash unless the repository standardizes another
allowed method. Use --admin only when policy permits a bypass.
- When Actions workflows or action pins are touched, require full-SHA pins
and consistent release references in the evidence.
- After merge, re-fetch repository-scoped terminal state with
gh pr view --json state,mergedAt and verify the final PR state.
Template resolution
Check these paths in order and use the first existing template:
.github/PULL_REQUEST_TEMPLATE.md
- the lowercase filename under
.github/
PULL_REQUEST_TEMPLATE.md
pull_request_template.md
Keep headings and section order unchanged. Mark an inapplicable section N/A.
Completion criteria
- Template fidelity is preserved.
- The summary and claims are grounded in the actual diff.
- Review state and required checks have fresh evidence.
- Validation evidence, risk, and rollback are explicit.
- Merge method and any admin bypass follow repository policy.
- The verified terminal state is recorded for merge or post-merge work.