cyberneticlibrary

Create clean PR with planning artifacts

prcommandsetup L11,344
datafolklabs/cement
What it does

Create code-only PR with deferred planning archive

Best for

Separating code review (clean diff) from planning artifact archiving, allowing reviewers to focus on implementation while preserving design rationale as write-once history.

Inputs
  • · feature branch with planning artifacts in .planning/
  • · phase verification document source-of-truth
Outputs
  • · PR title (<70 chars)
  • · PR body markdown (written to /tmp/)
  • · clean PR branch with .planning/ filtered
  • · two git commands for user to run
Requires
  • · gh CLI
  • · git
  • · /gsd-pr-branch skill
Preconditions
  • · on feature branch (not main)
  • · commits ahead of main
  • · working tree clean
  • · .planning/phases/<phase>/...-VERIFICATION.md exists
Failure modes
  • · on main branch (rejected)
  • · working tree dirty (rejected)
  • · PR branch cherry-pick loses pre-existing phase archives
  • · transient .planning/ paths not filtered (code review noise)
Trust signals
  • · phase verification sourced from actual VERIFICATION.md
  • · commit theme enumeration via git log
  • · explicit two-command recipe (code PR + archive PR)
  • · safety check: verify .planning/ filtered out post-build