Subissue Orchestration

Hierarchical issue management using GitHub's native sub-issues API with automatic PR-subissue coordination.

Purpose

Subissue Orchestration enables breaking down large epics or features into smaller, trackable tasks. Uses GitHub's native sub-issues API (GA 2025) for proper parent-child relationships that appear in GitHub's UI and Projects, with markdown checklist fallback for compatibility.

Native Sub-Issues (Primary)

GitHub's native sub-issues provide:

• Proper parent-child relationships visible in GitHub UI
• Integration with GitHub Projects (filtering, grouping by parent)
• Up to 100 sub-issues per parent, 8 levels of nesting
• Cross-repository support

The sync-task-to-subissue hook automatically links created subissues using the native API.

When to Use