1. Check Prerequisites

Get active work from state.json. Verify current phase is wf6-verify or later. Check that verification has passed (no test/build failures recorded).

2. Check Existing PR

Query gh pr view to check if a PR already exists for the current branch. If exists and no update subcommand, inform user and suggest update.

3. Push Branch

git push -u origin <branch>

Get branch name from state.json.

4. Generate PR Title

Read Goal from 01_KICKOFF.md
For GitHub source: append (#<issue_number>) to link the issue
Keep title concise (under 72 characters)

5. Create PR (`gh pr create`)

Generate PR body with:

## Summary

<1-3 bullet points from Kickoff Goal and Spec>

## Changes

<List of main changes from Plan steps>

## Test Plan

<Testing approach from Spec or verification results>

## Related Issues

Closes #<issue_number>

---
📄 [Kickoff](docs/wf/<work-id>/01_KICKOFF.md) | [Spec](docs/wf/<work-id>/02_SPEC.md) | [Plan](docs/wf/<work-id>/03_PLAN.md)

Execute:

gh pr create --title "<title>" --body "<body>"

6. Update PR (`update` subcommand)

Push latest changes: git push
Optionally update PR description via gh pr edit if significant changes

7. Update state.json

{
  "current": "wf7-pr",
  "next": "complete",
  "pr": {
    "number": 123,
    "url": "https://github.com/..."
  }
}

8. Completion Message

Display:

PR number and URL
PR title
Base ← Branch
Suggest requesting review

Error Handling

Error	Action
Verification not passed	Instruct to run `/wf6-verify` first
PR already exists	Suggest `update` subcommand
Push fails	Show error, suggest checking remote status
`gh` not authenticated	Instruct `gh auth login`

Notes

Cannot create PR if verification has not passed
Issue number is automatically linked via (#N) in title and Closes #N in body
Existing PR is detected and handled gracefully

wf7-pr

/wf7-pr

Usage

Subcommands

Processing