Flux Plugin

Agent-orchestrated, spec-driven workflow for Claude Code.

Prerequisites

This plugin requires Bun. If you don't have Bun installed, the installer will offer to install it for you.

Installation

bunx @cliangdev/flux-plugin

This installs:

• Commands (/flux, /flux:prd, /flux:breakdown, /flux:implement)
• Skills for AI orchestration
• MCP server for project data

Options

bunx @cliangdev/flux-plugin --global   # Install to ~/.claude (all projects)
bunx @cliangdev/flux-plugin --local    # Install to ./.claude (current project)

What Gets Configured

The installer automatically:

1. Copies commands to .claude/commands/
2. Copies skills to .claude/skills/
3. Adds MCP server config to .claude.json

Commands

Command	Purpose
/flux	Smart entry point - shows status and guides you to the next step
/flux:prd	Create PRDs through discovery, research, and guided writing
/flux:breakdown	Break PRDs into epics and tasks with acceptance criteria
/flux:implement	Implement tasks with TDD workflow

Typical Workflow

1. Start: Run /flux to initialize your project
2. Define: Run /flux:prd to create requirements through interactive Q&A
3. Plan: Run /flux:breakdown to generate implementation tasks
4. Build: Run /flux:implement to code with test-driven development

The orchestrator tracks your progress and always suggests the logical next step.

How It Works

flowchart TB
    subgraph User["User Intent"]
        U["/flux - Start Here"]
    end

    subgraph Orchestrator["Flux Orchestrator"]
        O{Analyze Context}
        O -->|No Project| Init[Initialize Project]
        O -->|No PRDs| PRD[Guide to /flux:prd]
        O -->|PRD Ready| Break[Guide to /flux:breakdown]
        O -->|Tasks Ready| Impl[Guide to /flux:implement]
    end

    subgraph PRDPhase["Requirements Phase"]
        P1["/flux:prd"]
        P2[Interactive Interview]
        P3[Generate PRD Document]
        P1 --> P2 --> P3
    end

    subgraph BreakdownPhase["Planning Phase"]
        B1["/flux:breakdown"]
        B2[Analyze PRD]
        B3[Create Epics & Tasks]
        B4[Define Acceptance Criteria]
        B1 --> B2 --> B3 --> B4
    end

    subgraph ImplementPhase["Implementation Phase"]
        I1["/flux:implement"]
        I2[Select Next Task]
        I3[TDD: Write Tests First]
        I4[Implement Code]
        I5[Verify & Commit]
        I1 --> I2 --> I3 --> I4 --> I5
        I5 -->|More Tasks| I2
    end

    U --> O
    Init --> PRD
    PRD --> P1
    Break --> B1
    Impl --> I1
    P3 -->|PRD Complete| O
    B4 -->|Breakdown Complete| O
    I5 -->|All Done| Done[Project Complete]

Features

• Intelligent Orchestration: Automatically guides you through the workflow based on project state
• Spec-Driven Development: All implementation traces back to documented requirements
• Test-Driven Implementation: Write tests first, then implement until they pass
• Acceptance Criteria: Every task has verifiable criteria for completion
• Backend Agnostic: Works with local SQLite or Linear for team collaboration

Project Structure

your-project/
├── .flux/
│   ├── project.json    # Project configuration
│   ├── flux.db         # Local database
│   └── docs/
│       └── prd-*/      # PRD documents
└── ...

Updating

To update to the latest version, simply re-run the installer:

bunx @cliangdev/flux-plugin@latest --global

This will:

• Update commands and skills to the latest version
• Update the MCP server configuration

Check your current version:

/flux version

Uninstall

Global Installation

rm -rf ~/.claude/commands/flux.md ~/.claude/commands/flux
rm -rf ~/.claude/skills/agent-creator ~/.claude/skills/epic-template ~/.claude/skills/flux-orchestrator ~/.claude/skills/prd-writer
rm -f ~/.claude/flux-version
# Edit ~/.claude.json and remove the "flux" entry from "mcpServers"

Local Installation

rm -rf .claude/commands/flux.md .claude/commands/flux
rm -rf .claude/skills/agent-creator .claude/skills/epic-template .claude/skills/flux-orchestrator .claude/skills/prd-writer
rm -f .claude/flux-version
# Edit .claude.json and remove the "flux" entry from "mcpServers"

Note: Your project data in .flux/ is preserved. Delete it manually if you want to remove all Flux data.

Support

GitHub: github.com/cliangdev/flux-plugin

License

MIT