shield_lock
JinDaGe
← Back to skills
extension
Category: Development & EngineeringNo API key required

ghpm-work

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.

personAuthor: jakexiaohubgithub
open_in_newRepositorydownloadDownload package

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