flow-decompose-project

Decompose software projects into structured GitHub issues with dependencies and milestones.

25|3|Updated Feb 19, 2026

Search Tags:#automation #dependencies #epic #project-management #decompose #milestone #github-issues

Ready to run

npx skills add https://github.com/benkruger/flow --skill flow-decompose-project

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: flow-decompose-project
Source: https://github.com/benkruger/flow/tree/main/skills/flow-decompose-project
Command: npx skills add https://github.com/benkruger/flow --skill flow-decompose-project

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Decompose a large software project into a structured set of GitHub issues with native sub-issue relationships, blocked-by dependencies, milestones, and phase labels. Produce a fully linked issue graph ready for autonomous execution via /flow:flow-start or /flow:flow-orchestrate.

Core Features & Use Cases

Create an epic that represents the entire project and derive a topologically-sorted set of leaf tasks.
Generate phase-based labels and milestones, linking issues with sub-issue and blocked-by relationships.
Support a six-step, deterministic workflow that can resume from checkpoints and be executed via the Flow CLI.

Quick Start

Provide a project description to initiate the six-step DAG-based GitHub issue decomposition flow.

Frequently Asked Questions about flow-decompose-project

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I break down a large software project into linked GitHub issues with dependencies?▼

To break down a large project, this decomposition workflow generates a structured set of GitHub issues with native sub-issue relationships, blocked-by dependencies, milestones, and phase labels. It creates a topologically-sorted set of leaf tasks derived from a central project epic.

What's the best way to automate milestone creation and epic breakdown for multi-phase initiatives?▼

Automating milestone creation and epic breakdown is handled by a deterministic six-step workflow that creates phase-based milestones, generates an epic, and produces stepwise issues. The workflow includes checkpoints and resume capability for repeatable automation across complex feature sets.

Can I create a topologically-sorted task graph with blocked-by relationships in GitHub Issues?▼

Yes, you can create a topologically-sorted task graph by linking generated issues with native sub-issue and blocked-by dependencies. This enables dependency-aware task ordering for complex feature sets and multi-phase initiatives directly within GitHub Issues.

How does the six-step issue decomposition workflow handle interruptions?▼

The six-step issue decomposition workflow handles interruptions by using built-in checkpoints and resume capability. If the deterministic process stops during stepwise issue generation or relationship linking, it resumes from the last completed checkpoint without restarting.

Do I need the Flow CLI to execute the project decomposition and issue generation?▼

Executing the project decomposition and issue generation is designed to run via the Flow CLI. The six-step workflow generates a fully linked issue graph that is ready for autonomous execution by Flow CLI commands like flow-start or flow-orchestrate.