soloflow

SoloFlow

Soloflow is a hooks-based workflow orchestration for solo product development with Claude Code.

It's built specifically to address some of the limitations of using Claude Code as a solo developer work on side projects and aims to solve two core problems:

1. No time to babysit: to be useful, Claude needs to be able to run autonomously for long stretches. You're using it for side projects, you don't have time to constantly babysit, approve permissions, and ask it to move along to the next stage
2. Limited time to review: because you might only have a 30 minutes or an hour in a day to make progress. You don't have time to do constant QA, read every line of output, or deal with correcting sloppy work. Your time reviewing should be spent on the things that need actual human input.

To address this, Soloflow automates the product development lifecycle through five stages: idea extraction → refinement → execution → verification → learning. Each stage is designed so you provide input at the beginning and then the agent runs autonomously while you walk away. Check in occasionally in your terminal or from your phone to tee up the next stage.

Some warnings

• This is my personal workflow tool. I build it for how I ship products, and I made it public so others can learn from it, fork it, or run it on their own projects. I'm happy to review issues and PRs, but I only merge changes that help my workflow. If something you want doesn't fit that, fork it — the MIT license makes that easy. See Contributing for details.
• It's still in alpha. this is still under development and has plenty of rough edges. Use it and experiment with it accordingly.
• It's hungry. you will trade tokens for time. The system adds a lot of checks and redundancy so you don't have to, but it will burn through tokens as a result. You will at a minimum need a max $100 plan and probably be tempted to get a max $200.
• Visual verification is tetchy. Visual verification is a game changer when it works, but it can be finicky to get set up and working correctly. The workflow will gracefully fall back to standard verification if it's not available so you'll still get the benefits of requirements verification and code review, but it might take some iteration cycles to get it up and running correctly.
• It's Claude all the way down. This plugin was created using Claude by telling Claude how I wanted to work better with Claude. There are no artisanally hand crafted lines of code here. In this house we trust (but verify) the machines.

With that said, even with the rough edges, it works.

Quick Start

The fastest way to get started is to install the plugin inside Claude Code (two steps — add the marketplace, then install):

/plugin marketplace add kesteva/soloflow
/plugin install soloflow@soloflow

By default this installs at user scope — available in every project on your machine. To scope it to a single project, use the CLI form with --scope project:

claude plugin install soloflow@soloflow --scope project

Alternatively, you install the plugin by opening /plugins within Claude Code, adding the marketplace, and then installing the plugin through there.

Once you've installed the plugin, run /soloflow:init to initialize the project. This will create a .soloflow/ directory which holds all workflow files.

From there, you can tackle a simple task using /soloflow:quick, for example:

/soloflow:quick "fix the loading indicator on the character generation screen which currently shows a question mark"

This will take a single task through the execution -> verification -> review loop.

To test on the full workflow, go through four commands in sequence:

• /soloflow:idea-extractor: use this to capture an idea that Claude will then refine. It will ask you questions to understand your intent.
• /soloflow:planner this turns the idea into execution ready tasks for Claude.
• /soloflow:sprint takes tasks through the execution -> verification -> review loop
• /soloflow:compound optional final stage, but extracts learnings from your sprint including clean-up items, tasks to add to the backlog, and improvements to your project documentation.

If you are working in an established project, an optional first step is to run /soloflow:map-codebase which will create Architecture and Code Patterns documentation for your project as well as nested claude.md's where applicable. If you don't want it editing or creating your Claude.md then call it with flag --skip-claudemd.

Installation

Plugin (recommended)

SoloFlow ships as a self-hosted plugin marketplace. From inside Claude Code:

/plugin marketplace add kesteva/soloflow
/plugin install soloflow@soloflow

The first command registers this repo as a marketplace (reading .claude-plugin/marketplace.json). The second installs the soloflow plugin from that marketplace.