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

``bash
bunx @cliangdev/flux-plugin
`

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

$3

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

$3

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 |

$3

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

`mermaid
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:

`bash
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

$3

`bash
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"


`

$3

`bash
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