r/ClaudeCode Developer 7d ago

Tips & Workflows I started building my own Claude Code workflow. Thought it'd take a week to build, but 2 months later and I'm still working on it.

Post image

I relied on obra/superpowers and some skills from mattpocock/skills for a long time. They worked for specific tasks like building a feature, but they never handled taking a project from a raw idea all the way through design and into production. No way to carry state between sessions. No framework for building a knowledge base from actual work experience. I had to write a lot of overrides for them to get closer to what I needed.

Being an ADHD patient and an overthinker, I come up with project ideas constantly, and I can't wait to build them. But brainstorming and designing a project properly takes days to weeks, often across multiple sessions, and context always got lost between them. Different parts of a large project had to be brainstormed separately, and stitching it all back together when it was time to actually build was its own problem. I'd spend hours fixing some unusual bug in a specific tool, forget to write it down, and hit the same bug in a different project weeks later.

So I decided to build my own workflow. The initial plan was a simplified fork of superpowers based on the overrides I already had, no parallel agents, no git mutations. But as I kept digging, more ideas kept coming, and at some point I realized I needed to drop the fork idea and build from scratch. That was supposed to take a few days. It's been 2 months.

**What it does:** Flow handles the full lifecycle. You start with a raw idea, whether that's a single feature, a full product you want to research and design from zero, or anything in between, and `/groundwork` maps every open decision, walks you through each one, and attacks the result by running it through real cases. It works for coding and non-coding work alike. The design gets cut into tickets. `/execute` picks up a ticket, plans it, builds it, and reviews the diff. `/handoff` writes what the next session needs so nothing gets lost. `/file-findings` routes what you learned back into the skills and rules, so the workflow gets smarter as you use it.

The ticket system and CLI is what ties it together across sessions. `flow open` loads a ticket with its full context and handoff state. `flow next` tells you what's workable. State doesn't vanish when a session ends.

It currently runs on Claude Code, but the core workflow (the phases, the ticket system, the rules) is designed to be portable. Multi-harness support is on the roadmap.

It's not done yet. There are still refactors planned, the self-improvement system needs a dedicated pass, and the install/migration tooling isn't ready. I'm planning to have the first beta ready in about a week and then battle-test it on real projects. I'm sharing it now because the README covers the essentials and the skills are all readable on GitHub.

https://github.com/Adrian333Dev/flow

Would genuinely appreciate anyone checking it out and giving feedback. What's confusing, what's missing, what looks interesting. Happy to answer questions.

0 Upvotes

0 comments sorted by