flux-plan

Convert feature requests or Flow IDs into epics and task trees via fluxctl.

7|1|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/Nairon-AI/flux --skill flux-plan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: flux-plan
Source: https://github.com/Nairon-AI/flux/tree/main/skills/flux-plan
Command: npx skills add https://github.com/Nairon-AI/flux --skill flux-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts vague feature requests or Flow IDs into a concrete epic with organized tasks, enabling clear planning and coordination without writing implementation code.

Core Features & Use Cases

  • Generate epics and a hierarchical task tree from feature requests or Flow IDs.
  • Enforce planning discipline by outlining scope, dependencies, acceptance criteria, and future pressure checks, with state managed via fluxctl.
  • Refine existing epics or create new ones from Flow IDs, supporting cross-team collaboration and traceability.

Quick Start

Invoke the Flux plan with /flux:plan followed by a brief description of the work or a Flow ID to generate an epic and task tree under the .flux/ directory.

Frequently Asked Questions about flux-plan

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

FAQPage Schema
How do I turn a vague feature request into a structured epic with task trees?▼

To turn a vague feature request into a structured epic, use the flux-plan Skill to organize software work by generating hierarchical task trees, scoping boundaries, and acceptance criteria via fluxctl without writing implementation code.

What is the best way to plan dependencies and acceptance criteria for a new feature?▼

The best way to plan dependencies and acceptance criteria is applying planning discipline through the flux-plan system, which encodes scope, future pressure checks, and cross-team traceability directly into the generated task tree.

How do I refine existing epics using a Flow ID?▼

You can refine existing epics by invoking the plan with a Flow ID, allowing the system to update the scope, dependencies, and hierarchical tasks for cross-team collaboration without embedding implementation code.

Does flux-plan write implementation code for bug fixes or refactoring?▼

No, flux-plan does not write implementation code for bug fixes or refactoring; it communicates only through fluxctl to enforce planning discipline and manage state under the .flux/ directory.

Can I use flux-plan for scoping upgrades and refactors, or is it only for new features?▼

You can use flux-plan for scoping upgrades, refactors, and bug fixes, as it converts varied software work requests into organized epics with future pressure checks and clear task trees.