gh-workflow

name	gh-workflow
description	GitHub workflow using the gh CLI for PRs, issues, CI checks, and code review. Use this instead of the GitHub MCP — covers creating PRs with spec references, monitoring CI runs, and reviewing PR comments.
argument-hint	[pr|issue|ci|review]

Use the gh CLI for all GitHub operations in AgentForge.

---

PR Workflow

List open PRs:

gh pr list

View PR details:

gh pr view [number]

Check CI status for a PR:

gh pr checks [number]

Create a PR (always use a HEREDOC for the body):

gh pr create --title "SPEC-NNN: Short description" --body "$(cat <<'EOF'
## Summary
- What this PR does

## Test plan
- [ ] pnpm test — all green
- [ ] tsc --noEmit — 0 errors
- [ ] pnpm audit — 0 high/critical
- [ ] Manual: agentforge start / chat / status
- [ ] Related spec: SPEC-NNN

🤖 Generated with Claude Code
EOF
)"

Merge a PR:

gh pr merge [number] --squash --delete-branch

---

Issue Workflow

List issues:

gh issue list
gh issue list --label "bug"

View an issue:

gh issue view [number]

Create an issue linked to a spec:

gh issue create --title "SPEC-NNN: Short description" \
  --body "Implements specs/active/SPEC-NNN-<title>.md"

Close an issue:

gh issue close [number]

---

CI / Actions Workflow

List recent runs:

gh run list --limit 5

Watch a run live:

gh run watch

View failed run logs:

gh run view [run-id] --log-failed

---

Code Review

View PR with all comments:

gh pr view [number] --comments

Add a review comment:

gh pr review [number] --comment -b "Your comment here"

Approve or request changes:

gh pr review [number] --approve
gh pr review [number] --request-changes -b "Please fix X before merging"

---

AgentForge PR Guidelines

• Title must reference the related spec: SPEC-NNN: description
• Body must include test plan: pnpm test, tsc --noEmit, pnpm audit, manual CLI test
• Link to the spec file in specs/active/
• Never force-push to main