Spec-TasksToIssues

Convert tasks.md into GitHub issues.

Prerequisites:

• •tasks.md must exist
• •Git remote must be a GitHub URL
• •GitHub CLI (gh) must be authenticated

Workflow

1. •Initialize - Run .specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks
2. •Get tasks path - Extract from script output
3. •Verify remote - Check git config --get remote.origin.url
4. •Create issues - Use GitHub MCP server for each task

Script Usage

# Get prerequisites
.specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks

# Get remote URL
git config --get remote.origin.url

Safety Checks

⚠️ CRITICAL CONSTRAINTS:

1. •Remote must be GitHub - Only proceed if URL matches github.com
2. •Match repository - NEVER create issues in wrong repository
3. •Parse tasks correctly - Extract ID, description, dependencies

Issue Format

For each task in tasks.md:

Title: [TaskID] Description
Body:
  - Phase: [Phase name]
  - Dependencies: [Dependent task IDs]
  - Files: [File paths mentioned]
  - Parallel: [Yes/No based on [P] marker]
  - Story: [User story if [USx] present]

Task Parsing

From format: - [ ] T001 [P] [US1] Description with path

Extract:

• •T001 → Issue title prefix
• •[P] → Label: parallel
• •[US1] → Label: user-story-1
• •Description → Issue title
• •File path → Issue body

Labels

Create/use labels:

• •spec-task - All generated tasks
• •parallel - Tasks with [P] marker
• •user-story-N - Tasks with [USx] marker
• •phase-N - Based on phase in tasks.md

GitHub CLI Commands

# Create issue
gh issue create --title "[T001] Create project structure" \
  --body "Phase: Setup\nDependencies: None" \
  --label "spec-task,phase-1"

# List issues
gh issue list --label "spec-task"

Error Handling

• •Skip already-created issues (check by title prefix)
• •Report failed creations
• •Continue with remaining tasks

Next Steps

After /spec-taskstoissues:

• •Assign issues to team members
• •Set milestones
• •/spec-implement - Execute tasks