soloscrum-tracker-github-transition-state
Transitions an Issue or Sub-issue between soloscrum lifecycle states. Active when tracker_profile = github-only.
Inputs
issue_number— target Issue or Sub-issue numberto_state— one ofin-progress/in-review/done
State → GH mapping
| soloscrum state | GH representation |
|---|---|
in-progress |
open + label state:in-progress |
in-review |
open + label state:in-review |
done |
open + label state:done (verdict passed; merge pending). The Issue itself closes when the linked PR merges via its Closes # keyword. |
The done state is deliberately decoupled from GH closed/open. GH "closed" is reserved for "merged into main" (the GH convention everyone outside soloscrum follows). soloscrum's done state is "verdict passed by /soloscrum:review — work is shippable, awaiting the user's gh pr merge." Querying state:done AND is:open enumerates Subtasks in this intermediate state; querying state:done AND is:closed enumerates fully-shipped work.
Steps
- Remove existing
state:*labels:gh issue edit <issue_number> \ --remove-label "state:in-progress" \ --remove-label "state:in-review" \ --remove-label "state:done" - Apply the new state label:
gh issue edit <issue_number> --add-label "state:<to_state>" - Do not call
gh issue closehere. GH-side close is downstream of merge; this skill never closes an Issue. (See "Notes" below.)
Output
- Confirmation of new state
Notes
- Only
soloscrum-reviewmay transition todone(persoloscrum-define-agent-responsibilities) - This skill never calls
gh issue close. Issue closure happens at merge time via the PR body'sCloses #keyword (which is in the DoD persoloscrum-define-dod); parent Issues that GH does not auto-close are picked up by the/soloscrum:refinejanitor sweep. Seesoloscrum-define-pr-lifecycle, "Issue close happens at merge". - If
state:*labels do not exist in the repo, create them once:gh label create state:in-progress --color BFD4F2 gh label create state:in-review --color D4C5F9 gh label create state:done --color C2E0C6 - The
state:donelabel is kept when the linked PR merges (and GH closes the Issue). A closed Issue withstate:doneis the canonical "shipped" record; loss of the label on close would erase that signal. - A
state:doneIssue that has been reopened (by the user, or because the merge was reverted) keeps thestate:donelabel while transitioning back to in-progress: the agent removesstate:doneand appliesstate:in-progressper the steps above. The transition skill always treatsstate:*labels as mutually exclusive on open Issues.