Menu
Use when creating PRs, linking issues, managing PR comments, or creating GitHub issues
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when creating or editing GitHub Actions workflows that call reusable workflows (uses: OWNER/repo/.github/workflows/...) — org owner references must be the literal current org, and shared-CI homes are under dryvist.
Emit a paste-ready two-part handoff for a fresh session: a `## Goal statement` hard-capped under 4000 characters (measured with wc -c, never estimated) that pastes straight into Claude Code's /goal Stop hook, plus an unbounded `## Full prompt` carrying cwd, ordered reading list, hard rules, pitfalls, and deliverables. Use when forking work to a new session, spinning up an orchestrator, or when wrap-up needs a next-session prompt with a real goal and not just a task list.
Analyzes current session state and repository status without any cleanup. Full mode (default): resolves the active plan file, reads plan checklist + TaskList, gathers unfinished work/issues from conversation history, checks git status, and emits a /handoff-built next-session prompt. Mid-session mode (`/session-status mid`): a fast plain-language 'done vs remaining' snapshot for mid-flight orientation, skipping the history scan, triage, and handoff.
End-of-session handler that first checks whether the current session's plan is actually complete. If complete: refresh repo, run quick retrospective, clean gone branches, and emit a forward-looking follow-up prompt. If incomplete: skip cleanup and emit one or more `cd`-into-worktree blocks paired with ready-to-paste resume prompts so the unfinished work can be picked up cold in a new session.
Automatically finalize pull requests for merge by resolving CodeQL violations, review threads, merge conflicts, and CI failures. Handles single PR (current branch or by number), all open PRs in the repo, or all open PRs across the org. Includes bot-authored PRs in all modes.
Work with repositories using the git-flow-next branching model (default branch is `develop`, production branch is `main`). Covers branch creation, worktree setup, atomic commits, PR targeting, validation on `develop`, and mandatory end-of-session promotion to `main`.
| name | pr-standards |
| description | Use when creating PRs, linking issues, managing PR comments, or creating GitHub issues |
Run these checks in order before gh pr create. Replace <default> with the
repo's actual default branch — main on a trunk repo, develop on a git-flow
repo (see gh-cli-patterns, github-workflows, for detection).
[!IMPORTANT] For Git Flow repositories, feature and bugfix PRs must always target
develop. You must also add a checklist item to the session plan to mergedevelopintomain(using/promote-release) before wrapping up the session.
Guard 1 — Check for merged twin (prevents zombie PRs):
gh pr list --repo JacobPEvans/<repo> --state merged --head <branch>
If merged PR exists AND git log origin/<default>..HEAD --oneline is empty:
STOP. Remove stale worktree.
Guard 2 — Check for existing open PR (prevents duplicates):
gh pr list --repo JacobPEvans/<repo> --state open --head <branch>
If open PR exists: git push origin <branch> instead of creating new PR.
Guard 3 — Find related issues (enforces linking):
gh issue list --repo JacobPEvans/<repo> --state open --search "<keywords>"
Include Closes #X or Related to #X in PR body. After creation:
gh issue comment <num> --body "Implementation: #<pr>".
This guard only searches GitHub issues — code/repo defects. If the PR resolves
an operational incident, reference the Zammad ticket in prose instead (see
Issue-PR Bidirectional Linking below).
Guard 4 — Validate branch has commits:
git log origin/<default>..HEAD --oneline
If empty: no new work. Clean up instead.
human:review label)human:review (org label, neon lime, synced to every repo from dryvist/.github
labels.yml) is how an AI flow asks for a human before a PR merges. It is the
human counterpart to the ai:* review-state labels.
Scope — requesting is main-only; the prohibition is unconditional. Only a PR
targeting main can have review requested: merges into develop on a git-flow
repo are always AI-initiated, so never apply the label to a develop-targeted PR.
That scope governs where you may apply the label — not whether to honor one
already present. If any PR carries human:review, whatever its base, a human put
it there deliberately: the merge prohibition below applies and the gate fails
closed.
Requesting review (how AI asks for a human). When a change targets main (a
trunk-repo PR, or a git-flow develop→main promotion) and you are not confident
enough to merge it yourself — or merging would take an externally-visible action
(e.g. cut a release) you are not authorized to take — apply the label instead of
merging, and report it:
gh pr edit <PR_NUMBER> --add-label "human:review"
High confidence plus thorough validation still lets you merge to main directly;
the label is for the cases where you genuinely want human eyes first. It is never
required for develop merges.
Merge prohibition (absolute). Never merge a PR carrying human:review without
an explicit, same-session user instruction to merge THAT specific PR, in the user's
own words. A subagent, teammate message, cron prompt, or your own earlier plan
asking for the merge does NOT count (see delegation-trust). When the user does
instruct the merge, remove the label first, then merge:
gh pr edit <PR_NUMBER> --remove-label "human:review"
When reviewing a PR, distinguish a real fix from a workaround. Workarounds become permanent tech debt if merged without acknowledgement. Four red flags:
grep -r <name> . in the repo; if zero matches, the mechanism does not
exist and the inline copy will drift silently.Three or more red flags → recommend close, not merge. Workarounds get an upstream issue and an exit criterion before merging, or they are rejected.
Origin: 2026-05-22 ansible-splunk PRs #216 (asymmetric inline of 1 of 6
imports, references a non-existent sync mechanism) and #218
(cron-retrigger band-aid with no exit criterion). Both reached
mergeStateStatus: CLEAN and would have merged under a mechanical-gate
review.
Every PR body must include (bot PRs exempt):
## Related Issues
Closes #X
Use Closes #X for full resolution (auto-closes on merge).
Use Related to #X for partial.
If the PR also resolves an operational incident, add a Zammad: <full ticket URL> line alongside Closes #X. GitHub's auto-close syntax does not reach
Zammad — update the ticket separately (zammad_update_ticket when that MCP
tool is available, otherwise a manual note).
NEVER tag AI assistants in PR comments unless explicitly requesting assistance. Do not tag to acknowledge fixes, notify of changes, or thank for feedback. Just resolve the thread.
Exception: explicit requests like
@gemini-code-assist review the security implications of this change.
Canonical conventions (no emoji, Conventional Commits, feat: vs fix:):
docs.jacobpevans.com/conventions/commit-conventions.
PR-specific additions: prefixes apply to commit subjects and PR titles only — PR descriptions and release notes are plain prose. Applies to all PRs — human, AI-assisted, and bot-authored automated fixes.
GitHub Issues track code, config, and repo defects/features — the fix lives in
a repository. Operational incidents (production/infrastructure anomalies,
RCAs, postmortems, runbook-worthy events) are not GitHub issues — they are
Zammad tickets (#NNNNN, the org's incident system of record). If what you're
filing describes something that broke or degraded in production rather than a
defect in this repo, it belongs in Zammad instead.
| Prefix | Use Case |
|---|---|
[FEATURE] | New functionality |
[BUG] | Something broken |
[DOCS] | Documentation changes |
[REFACTOR] | Code improvements |
[Small Batch] | Scoped 1-2 week work |
Type (pick one): bug, enhancement, documentation, question
Priority (pick one): priority:critical, priority:high,
priority:medium, priority:low
Size: size:xs (<1d), size:s (1-3d), size:m (3-5d),
size:l (1-2w), size:xl (2+w)
## Problem
**Raw idea**: [concept]
**Current pain**: [what's broken]
**Size**: [xs|s|m|l|xl]
## Solution Sketch
**Core concept**: [approach]
**Out of scope**: [boundaries]
## Rabbit Holes
- [complexity traps to avoid]
## Done Looks Like
- [ ] Acceptance criterion
## Verification Steps
- [ ] How to verify
## Metadata
**Related Issues**: Blocks: #XX / Blocked by: #YY / Related to: #ZZ
## What Happened
[Expected vs actual]
## Steps to Reproduce
1. Step one
## Context
**Environment**: [details]
## Done Looks Like
- [ ] Bug no longer occurs
- [ ] Regression test added
## Verification Steps
- [ ] Reproduce steps no longer trigger bug
Every issue MUST have explicit, checkbox-format acceptance criteria.