sprint-planner

Define your tasks in a tasks.yml file with an epic field and a tasks array containing title, description, and labels. Run the create-sprint-issues.sh script, which validates the YAML, creates a milestone and parent Epic, then generates one labeled GitHub issue per task.

Use the gh CLI with a script that creates a milestone via the GitHub API, opens a parent Epic issue, and runs gh issue create for each task with milestone and labels. The script also auto-creates missing labels with color coding.

The script requires the gh CLI authenticated to your repository, yq for parsing the tasks.yml file, and jq for JSON processing of GitHub API responses. All three must be installed and available in your system PATH.

The script validates that tasks.yml contains a root-level epic field and a non-empty tasks array, and that each task has title, description, labels.type, and labels.component. Tasks missing required fields are skipped with an error message.

Yes. The script checks whether the milestone name you enter already exists via the GitHub API. If found, it reuses that milestone instead of creating a duplicate, then assigns all new issues to it.