Skip to content

feat(skills): /prm — the "PR, CI green, then merge" wrap-up door - #248

Merged
Jammy2211 merged 1 commit into
mainfrom
feature/prm-wrap-up-shortcut
Aug 23, 2026
Merged

feat(skills): /prm — the "PR, CI green, then merge" wrap-up door#248
Jammy2211 merged 1 commit into
mainfrom
feature/prm-wrap-up-shortcut

Conversation

@Jammy2211

Copy link
Copy Markdown
Contributor

What

Adds /prm — a composition door for the sentence typed at the end of nearly every task: "PR CI green then merge". Three keystrokes instead of the sentence.

  1. Resolve the feature PR — argument (/prm 380, PyAutoArray#42, URL) → current branch → the claimed task's library-pr:/workspace-pr: in Mind's active.mdgh pr list. More than one candidate → lists them and asks once, never guesses.
  2. Judge CI honestly — enumerates every workflow run for the head sha (push and pull_request) and every job inside each, plus mergeable/mergeStateStatus. One green row is 1 of 4 signals.
  3. Wait or stop — polls ~90s, caps at ~30 min; on red it fetches the failing job log immediately (GitHub purges the blob) and stops.
  4. Merge in gate order — library PR first, workspace PR only once that reads MERGED. No --delete-branch (it would kill the local branch under a task worktree).
  5. Finish the ship — hands back to ship_*: Shipped comment, lifecycle.py record, Mind push, cleanup.

Why it owns no gate

The merge gates stay with /ship_library / /ship_workspace, the verdict stays with GitHub Actions. /prm only sequences them. It refuses on red / pending / conflicting / unmerged upstream library PR, never force-merges, and asks before closing the issue — typing /prm authorizes the merge, not the close.

Agent-agnostic + mobile

Every step is gh (2.4.0-safe — no gh search), so no checkout is required. The skill detects local vs remote (mobile Claude Code chat / Codex) and skips only the local-only cleanup with a note. Installed to all four surfaces; the committed .claude/ + .codex/ discovery links in this PR are what make it register in web/cloud sessions.

Changes

  • skills/prm/{SKILL.md,prm.md,reference.md} — 127-line mandatory load, gh mechanics in the lazy reference.md
  • skills/COMMANDS.md — registered as a tier-4 composition door
  • AGENTS.md — named in the command-surface prose
  • skills/ship_library + skills/ship_workspace — their merge steps point at /prm
  • regenerated committed discovery (also picks up the previously-missing sizing links)

Checks

  • bin/check_skill_line_counts.sh → OK, all 46 skills within the 200-line budget
  • bin/install.sh --check-project-discovery → OK (5 repos)
  • bin/install.sh --check-agents-surface → OK

🤖 Generated with Claude Code

https://claude.ai/code/session_01UrgmL8WMK82GxQJjPL8ZCs

Adds a composition skill for the sentence typed at the end of nearly every
task. `/prm` resolves the feature PR (argument / current branch / the claimed
task's `library-pr:` + `workspace-pr:` in Mind's active.md), judges CI over
EVERY workflow run for the head sha and EVERY matrix leg inside it, merges in
library-first order, then hands back to the ship skills' completion steps.

It owns no gate of its own: it refuses on red, pending, conflicting, or an
unmerged upstream library PR, fetches a failing job's log before GitHub purges
the blob, and asks before closing the issue — typing /prm authorizes the merge,
not the close.

Pure `gh` (2.4.0-safe: no `gh search`), so it runs on the CLI, mobile Claude
Code chat and Codex alike; the committed .claude/.codex discovery links are what
make it register in web/cloud sessions.

- skills/prm/{SKILL.md,prm.md,reference.md} — 127-line mandatory load
- skills/COMMANDS.md: registered as a tier-4 composition door
- AGENTS.md: named in the command-surface prose
- ship_library / ship_workspace: point their merge step at /prm
- regenerated committed discovery (also picks up the missing `sizing` links)

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UrgmL8WMK82GxQJjPL8ZCs
@Jammy2211
Jammy2211 merged commit 95a7fd2 into main Aug 23, 2026
2 checks passed
@Jammy2211
Jammy2211 deleted the feature/prm-wrap-up-shortcut branch August 23, 2026 15:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant