/ Directory / Playground / Flow Next
● Community gmickel ⚡ Instant

Flow Next

by gmickel · gmickel/flow-next

Plan-first orchestration: every non-trivial ask becomes a checkable plan you can edit before any code is written.

Flow Next slots between you and the agent: it prompts for a structured plan first, you approve, then execution. Works across Claude Code, OpenAI Codex, and Factory Droid.

Why use it

Key features

Live Demo

What it looks like in practice

ready

Install

Pick your client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "flow-next-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/gmickel/flow-next"
      ],
      "_inferred": true
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "flow-next-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/gmickel/flow-next"
      ],
      "_inferred": true
    }
  }
}

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "flow-next-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/gmickel/flow-next"
      ],
      "_inferred": true
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "flow-next-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/gmickel/flow-next"
      ],
      "_inferred": true
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "flow-next-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/gmickel/flow-next"
      ]
    }
  ]
}

Continue uses an array of server objects rather than a map.

~/.config/zed/settings.json
{
  "context_servers": {
    "flow-next-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/gmickel/flow-next"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

claude mcp add flow-next-skill -- git clone https://github.com/gmickel/flow-next

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use Flow Next

Plan a feature before coding

👤 Claude Code users ⏱ ~15 min intermediate

When to use: You want to align on approach before agents start writing.

Flow
  1. Trigger
    Invoke flow-next with your feature description.✓ Copied
    → Plan emitted
  2. Edit
    Tweak / reorder / drop steps.✓ Copied
    → Approved plan
  3. Execute
    Run the plan; agent ticks steps as they complete.✓ Copied
    → Feature built per plan

Outcome: Reviewed plan executed without surprise scope creep.

Combinations

Pair with other MCPs for X10 leverage

flow-next-skill + github

Attach the plan to the PR for reviewer context

Combine flow-next-skill with github: Attach the plan to the PR for reviewer context✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
plan / approve / execute (see docs) Three-phase command surface 1 call

Cost & Limits

What this costs to run

API quota
N/A
Tokens per call
Plans add ~1 plan-sized round-trip
Monetary
Free
Tip
Save plans alongside the PR — great for retros

Security

Permissions, secrets, blast radius

Minimum scopes: fs-read fs-write
Credential storage: None
Data egress: None

Troubleshooting

Common errors and fixes

Plan too vague

Ask for "concrete file paths" in the brief

Alternatives

Flow Next vs others

AlternativeWhen to use it insteadTradeoff
Direct executionTrivial changeRiskier on bigger work

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills