Prompt file imported from troylar/devsync (
.claude/commands/next.md). Copyright stays with the author.
/next Skill
Show a prioritized work queue of open issues, sorted by priority labels and grouped by VISION.md direction areas.
Usage
/next # Prioritized queue (excludes in-progress/blocked)
/next --all # Include in-progress and blocked issues
/next --area mcp # Filter by vision direction area
Workflow
Step 1: Ensure Labels Exist
Create all lifecycle labels idempotently:
gh label create "priority:critical" --color "B60205" --description "Blocking other work" --force
gh label create "priority:high" --color "D93F0B" --description "Important, should be next" --force
gh label create "priority:medium" --color "FBCA04" --description "Standard priority" --force
gh label create "priority:low" --color "0E8A16" --description "Nice to have" --force
gh label create "in-progress" --color "6F42C1" --description "Actively being worked on" --force
gh label create "ready-for-review" --color "0075CA" --description "PR submitted" --force
gh label create "blocked" --color "9E9E9E" --description "Blocked by something" --force
Step 2: Fetch Data (parallel)
A ā All open issues:
gh issue list --state open --limit 100 --json number,title,labels,assignees,body
B ā VISION.md direction areas:
Read VISION.md and extract the "Direction (Current)" section. Identify the 5 direction areas:
- AI Tool Integration
- Package Management
- MCP Integration
- CLI & UX
- Docs & Quality
C ā In-progress and blocked issues:
gh issue list --label "in-progress" --state open --json number,title,labels,assignees
gh issue list --label "blocked" --state open --json number,title,labels,assignees
Step 3: Categorize Each Issue
For each open issue:
-
Priority ā from
priority:*labels:priority:critical-> Criticalpriority:high-> Highpriority:medium-> Mediumpriority:low-> Low- No priority label -> Medium (default)
-
Vision area ā keyword match the issue title and body against direction areas:
- AI Tool Integration: ai tool, IDE, cursor, claude, windsurf, copilot, kiro, roo, cline, codex, translator, detection
- Package Management: package, manifest, template, version, dependency, bundle, component
- MCP Integration: MCP, server config, credential, sync
- CLI & UX: CLI, command, TUI, Typer, Rich, output, error, UX
- Docs & Quality: doc, test, CI, coverage, lint, quality, README
- Other: anything that doesn't match
-
Status:
in-progresslabel -> In Progressblockedlabel -> Blockedready-for-reviewlabel -> Ready for Review- None -> Ready
-
Dependencies ā scan issue body for "depends on #N" / "blocked by #N"
Step 4: Filter
- Default: exclude issues with
in-progress,blocked, orready-for-reviewlabels - With
--all: include everything - With
--area <area>: only show issues matching that vision area
Step 5: Display Queue
Sort by priority tier (critical -> high -> medium -> low), then by issue number.
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
š Work Queue
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
š AI Tool Integration
š” #83 ā Add Zed AI tool support
š¢ #91 ā Improve cursor rule translation
š Package Management
š” #95 ā Add version constraint support
š¢ #110 ā Template system for packages
š MCP Integration
š” #88 ā Credential sync improvements
š CLI & UX
š” #102 ā Better error messages for install failures
š Docs & Quality
š¢ #115 ā Increase test coverage
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
š“ Critical: 0 š High: 0 š” Medium: 4 š¢ Low: 3
š Total: 7 issues ready to work
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
Step 6: Recommend Next Item
ā Recommended: #83 ā Add Zed AI tool support
Rationale: Highest priority in AI Tool Integration,
no dependencies, aligns with IDE-agnostic principle.
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
š Next: /start-work 83
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
Guidelines
- Always show
#N ā titlefor issue references - Default view should be actionable ā only show issues you can start right now
- If there are 0 issues ready, say so and suggest
/triage --reassessor/new-issue - Priority indicators: š“ Critical, š High, š” Medium, š¢ Low
