| name | github |
| description | Issue-driven development with worktree isolation. 5-stage pipeline (new, plan, work, review, merge) with human gates between stages. Use when creating tasks, planning, implementing, reviewing, or merging. |
github
Overview
Linear pipeline for issue-driven development. Each stage updates the issue status and suggests the next command, requiring human approval to proceed.
/gh-new → /gh-plan → /gh-work → /gh-review → /gh-merge
Context
User wants to manage the lifecycle of a development task from issue creation through merge. Tasks are GitHub Issues with standard labels for status tracking.
Sub-skills
Load the appropriate sub-skill from sub-skills/ based on user intent.
-
new.md: Create a GitHub Issue with status and priority labels
- Triggers: "new task", "create issue", "add task"
- Status: →
status-plan
-
plan.md: Explore codebase, post plan as issue comment, create worktree
- Triggers: "plan task", "start planning", "plan issue N"
- Status:
status-plan → status-implement
-
work.md: Implement plan, commit, push, create draft PR
- Triggers: "work on task", "implement", "build"
- Status:
status-implement → status-review
-
review.md: Review PR for correctness, post findings
- Triggers: "review PR", "review task", "check PR"
- Status:
status-review → status-merge
-
merge.md: Merge PR, cleanup worktree
- Triggers: "merge", "merge task", "finish"
- Status:
status-merge → status-done
-
orchestrate.md: Automated end-to-end pipeline from main worktree
- Triggers: "orchestrate", "automate task", "run pipeline"
- Runs new + plan from main, launches subagent in worktree for work
- NEVER modifies code in main — all changes via worktree subagent
Process
- Determine which pipeline stage the user wants
- Load the appropriate sub-skill
- Execute sub-skill process
- Sub-skill updates status and suggests next command
Guidelines
- Each sub-skill MUST update the issue status label on completion
- Each sub-skill MUST suggest the next pipeline command at the end
- Use conventional commit format:
type(scope): description
- Worktree directory:
.worktrees/issue-{N}
- Branch naming:
issue/{N}-{slug}
- PR body MUST include "Closes #N" for auto-close on merge
Resources
- templates/: Issue, plan, implementation, review (one per pipeline stage)
Appendix
Label schema
Status labels
| Label | Description | Color |
|---|
status-plan | New issue, needs planning | #d4c5f9 (lavender) |
status-implement | Plan approved, ready for implementation | #c5def5 (light blue) |
status-review | PR created, needs review | #f9d0c4 (peach) |
status-merge | Review approved, ready to merge | #fbca04 (yellow) |
status-done | Merged and closed | #0e8a16 (green) |
Priority labels
| Label | Description | Color |
|---|
priority-p1 | Urgent, do first | #d73a4a (red) |
priority-p2 | High priority | #ff7b00 (orange) |
priority-p3 | Medium priority | #fbca04 (yellow) |
priority-p4 | Low priority, backlog | #c2e0c6 (light green) |
Size labels
| Label | Description | Color |
|---|
size-xs | Extra small, < 1 hour | #bfd4f2 (light blue) |
size-s | Small, 1-4 hours | #c2e0c6 (light green) |
size-m | Medium, 1-2 days | #fbca04 (yellow) |
size-l | Large, 3-5 days | #f9d0c4 (peach) |
size-xl | Extra large, 1+ week | #d73a4a (red) |
Create all labels
gh label create "status-plan" --description "New issue, needs planning" --color "d4c5f9"
gh label create "status-implement" --description "Plan approved, ready for implementation" --color "c5def5"
gh label create "status-review" --description "PR created, needs review" --color "f9d0c4"
gh label create "status-merge" --description "Review approved, ready to merge" --color "fbca04"
gh label create "status-done" --description "Merged and closed" --color "0e8a16"
gh label create "priority-p1" --description "Urgent, do first" --color "d73a4a"
gh label create "priority-p2" --description "High priority" --color "ff7b00"
gh label create "priority-p3" --description "Medium priority" --color "fbca04"
gh label create "priority-p4" --description "Low priority, backlog" --color "c2e0c6"
gh label create "size-xs" --description "Extra small, < 1 hour" --color "bfd4f2"
gh label create "size-s" --description "Small, 1-4 hours" --color "c2e0c6"
gh label create "size-m" --description "Medium, 1-2 days" --color "fbca04"
gh label create "size-l" --description "Large, 3-5 days" --color "f9d0c4"
gh label create "size-xl" --description "Extra large, 1+ week" --color "d73a4a"
