session-pr-audit

name	session-pr-audit
description	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 point — especially at session end, after a manager wave, or when asked "what's left?"
usage	/session-pr-audit
io-contract	{"kind":"deliverable","produces":[{"kind":"report","description":"Accounting of the session's PRs, commits, and uncommitted work with unshipped-change flags"}]}

Session 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

1. Identify the session's worktrees and branches

   git worktree list
   git log --oneline origin/main..HEAD 2>/dev/null | head -20
   

2. Find 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 -20
   

3. List open PRs to find which branches have PRs:

   gh pr list --state open --json number,headRefName,title,url | head -40
   

4. Identify orphans — branches with commits not in any PR:

   • Compare pushed branches to open PRs
   • Note any branch with work that has no PR yet

5. Check for local-only commits (unpushed):

   git log --oneline @{u}..HEAD 2>/dev/null || git log --oneline HEAD | head -10
   

6. For each open PR found, report its CI status:

   gh pr checks <number> --watch=false 2>/dev/null | tail -5
   

7. Account for merged or closed PRs referenced by notes

   gh pr view <number> --json state,mergedAt,closed,headRefName,url
   

   Closed 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.