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

SKILL.md

GitHub

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.