ghpm-work

name	ghpm-work
description	End-to-end work session on a GitHub Project item. Setup → Clarify → Plan → Implement → PR, with decisions captured throughout. Use when starting work on an issue, picking up a task, or resuming an interrupted session.
argument-hint	<issue-number>
allowed-tools	Bash(gh:*), Bash(git:*), Read, Write, Edit, Grep, Glob
compatibility	Requires gh CLI authenticated with read:project and project scopes
metadata	{"author":"jackchuka","scope":"generic","confirms":["create git commit","create PR"]}

ghpm-work

PREREQUISITE: Read ../ghpm-shared/SKILL.md for prerequisites and error handling.

End-to-end workflow for a GitHub Project item. /ghpm-work <issue-number> drives the full lifecycle.

If no argument, ask for the issue number.

Flow

Setup → Clarify → Plan → Implementation Plan → Implement → Draft PR
                    ↕ decisions captured at every phase ↕

Phase	Reference	What happens
1. Setup	references/setup.md	Resolve item, assign, branch, status sync, write session
2. Clarify	references/clarify.md	Evaluate issue clarity, flesh out if needed, gather context
3. Plan	references/plan.md	Explore codebase, draft approach, post as issue comment
4. Impl Plan	references/implementation-plan.md	Concrete steps, files, tests — post as issue comment
5. Implement	references/implement.md	Execute plan, write code, commit, verify
6. Draft PR	references/draft-pr.md	Create draft PR with summary

Decisions: See references/decisions.md. Capture at ANY phase — not just coding. Watch every interaction for choices worth recording.

Wrap up: See references/wrap-up.md. Triggered by "wrap up" or "done".

Session Resume

Sessions track phase in .ghpm/sessions/<number>.json (schema in ../ghpm-shared/references/session.md).

Each phase writes its phase value to the session file on entry, before doing any work. This means on resume, re-run the recorded phase (it may have been interrupted):

phase	Resume from
missing/setup	Clarify (setup completed, phase field not yet added)
clarify	Clarify
plan	Plan
implementation_plan	Implementation Plan
implement	Implement
pr	Draft PR
done	Session complete — inform user and stop

On resume, briefly show what's already done before continuing.

Prompt Configuration

Per ../ghpm-shared/references/prompts.md. This skill's config lives at prompts.ghpm-work in .ghpm/config.json.

Action keys: status_sync, clarify_issue, post_plan, post_impl_plan, draft_pr, record_decision.

Rules

• Each phase updates "phase" in the session file on entry, before doing any work. This is critical for crash recovery.
• The user can say "skip" to skip any phase.
• Multiple sessions can run in parallel on different branches.
• Restarting Claude on the same branch auto-resumes via session detection.

See Also

• ghpm-shared — Prerequisites and error handling
• ghpm-status — Project health dashboard
• ghpm-suggest — Find what to work on next
• ghpm-view — Query project items