Speckit 08 Taskstoissues

Spec-Kit Tasks to Issues

Convert existing tasks into actionable, dependency-ordered GitHub issues for the feature based on available design artifacts.

User Input

$ARGUMENTS

You MUST consider the user input before proceeding (if not empty).

Prerequisites Check

1. Run prerequisites check:

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

2. Parse JSON for FEATURE_DIR and AVAILABLE_DOCS.

3. Extract the path to tasks.md from the output.

GitHub Remote Validation

Get the Git remote:

git config --get remote.origin.url

CRITICAL: ONLY PROCEED TO NEXT STEPS IF THE REMOTE IS A GITHUB URL

Valid GitHub URLs:

• git@github.com:owner/repo.git
• https://github.com/owner/repo.git
• https://github.com/owner/repo

If the remote is NOT a GitHub URL:

ERROR: Git remote is not a GitHub repository.
Remote URL: [actual remote URL]

This skill only supports GitHub repositories.

Execution Flow

1. Parse tasks.md

Read the tasks file and extract:

• Task IDs (T001, T002, etc.)
• Task descriptions
• Phase groupings
• Parallel markers [P]
• User story labels [US1], [US2], etc.
• Dependencies between tasks

2. Create GitHub Issues

For each task in the list, create a GitHub issue:

Issue Title Format: [TaskID] [Story] Description

Example: [T012] [US1] Create User model in src/models/user.py

Issue Body Template:

## Task Details

**Task ID**: T012
**Phase**: Phase 3: User Story 1
**User Story**: US1
**Parallel**: Yes (can be executed in parallel with other [P] tasks)

## Description

Create User model in src/models/user.py

## File Path

`src/models/user.py`

## Dependencies

- Depends on: T011 (if applicable)
- Blocks: T014, T015 (if applicable)

## Acceptance Criteria

- [ ] File created at specified path
- [ ] Model implements required fields from data-model.md
- [ ] Tests pass (if applicable)

---

*Generated from tasks.md by /speckit-05-taskstoissues*
*Feature: [###-feature-name]*

Issue Labels (create if they don't exist):

• speckit - All spec-kit generated issues
• phase-1, phase-2, etc. - Phase grouping
• us-1, us-2, etc. - User story grouping
• parallel - Tasks that can be parallelized

3. Create Issues via gh CLI

Use the GitHub CLI to create issues:

gh issue create --title "[T012] [US1] Create User model" --body "..." --label "speckit,phase-3,us-1"

CRITICAL SAFETY CHECK:

UNDER NO CIRCUMSTANCES EVER CREATE ISSUES IN REPOSITORIES THAT DO NOT MATCH THE REMOTE URL

Before each gh issue create command, verify:

1. You are in the correct repository
2. The remote URL matches a GitHub repository
3. The issue is being created in the correct repo

4. Link Dependencies

After all issues are created, add cross-references:

• Edit issue bodies to include links to blocking/blocked-by issues
• Use GitHub's issue reference syntax: #123

Report

Output:

• Number of issues created
• List of issue numbers and titles
• Any errors encountered
• Link to the GitHub issues list for the repository

Error Handling

Next Steps

After creating issues:

• Review issues in GitHub
• Assign team members
• Add to project boards
• Begin implementation following the task order