session-pr-audit
Audit what PRs this session produced. Ask: "What work did I do this session that isn't in a PR yet, or isn't merged?" Forces the agent to account for all code changes before declaring done. Use at any
Files1
View on GitHubSKILL.mdskills/session-pr-audit/SKILL.md
GitHubSession PR Audit
You are performing a session PR audit — a durable-accountability check over all code work done since this session started. The goal: surface any work that exists as commits or local changes but has not been captured in an open PR, has not been merged, or was superseded without a durable close note.
For manager-led waves, run this immediately after parley and before launching the next wave. Every agent-authored change in the wave must be PR-accounted: open and ready, queued, merged, or explicitly closed/superseded with a link to the PR that mined it.
Steps
Identify the session's worktrees and branches
git worktree list git log --oneline origin/main..HEAD 2>/dev/null | head -20Find all branches pushed this session (look at recent pushes in the reflog or list remote branches newer than main):
git for-each-ref --sort=-committerdate refs/remotes/origin \ --format='%(refname:short) %(committerdate:relative)' | head -20List open PRs to find which branches have PRs:
gh pr list --state open --json number,headRefName,title,url | head -40Identify orphans — branches with commits not in any PR:
- Compare pushed branches to open PRs
- Note any branch with work that has no PR yet
Check for local-only commits (unpushed):
git log --oneline @{u}..HEAD 2>/dev/null || git log --oneline HEAD | head -10For each open PR found, report its CI status:
gh pr checks <number> --watch=false 2>/dev/null | tail -5Account for merged or closed PRs referenced by notes
gh pr view <number> --json state,mergedAt,closed,headRefName,urlClosed is acceptable only when the close comment names the superseding PR, preserved branch, or deliberate abandonment reason.
Output format
Report a concise table:
SESSION PR AUDIT
================
✓ #344 feat(console): sortie pane + FleetBar launcher [open, CI pending]
✓ #306 feat(console): pd-console to main [open, CI red — blocked by #344 fix]
⚠ worktree-some-branch — has 2 commits, NO PR yet
✗ feat/old-thing — local only, never pushed
Verdict:
- All clear: every commit is in a PR or merged
- Orphans exist: list them with the exact branch name and how to create the PR
- Red CI: list the PRs with red CI and what's failing
- Superseded but accounted: list the closed PR and the merged/mined PR that replaces it
Obligation rule
Every code change in this session must eventually land as a PR. "I'll do it later" is not acceptable for this audit. If there are orphans, either create the PRs now or explicitly note them as deliberate WIP with a reason.
Every manager wave must leave the same accounting trail. "Agent finished" is not a state; the acceptable terminal states are PR open, queued, merged, or closed with a documented supersession.
This skill enforces the principle from ADR-0045 (loud-fail invariants): work that evaporates without a PR is a coordination failure, not a normal outcome.