TL;DR: I built an MCP-native project management tool that AI agents use themselves, keeping vibe-coded work on track, stories completing in order, and epics actually finishing — no more spinning off into the weeds. Free and open source.
The Problem: When Vibe Coding Spins Out
Back in June 2025, before Model Control Protocol (MCP) was everywhere in commercial tools, I was deep in "vibe coding" mode — building quickly, iterating fast, leaning hard on AI assistance. But I kept hitting the same wall: the AI would drift. It'd jump between tasks, start half a feature, forget what the actual goal was, and suddenly we're three hours deep on something that doesn't matter.
Vibe coding is wonderful for momentum — until momentum becomes directionless.
I realised what was missing: structure that the AI itself understands and respects. Not just project management for me — project management for the agent.
Enter ProjectFlow
ProjectFlow is a project management system built first and foremost to be used by AI agents — via MCP — while I'm building. The core design is deliberately simple:
- Stories → individual actionable tasks
- Epics → groups of stories that form a meaningful chunk of work
- Projects → collections of epics that deliver the end goal
My standing instruction — I call it harness — tells the agent: work through stories to complete them, complete all stories to finish an epic, and finish all epics to complete the project. That's it. No fancy workflows, no complicated permissions — just clear hierarchy and clear direction.
It solved the problem beautifully. The agent knows exactly what's next, what it's working toward, and when something is actually "done." No more scope creep by accident. No more "I'll just refactor this one unrelated thing" derailing the afternoon.
There's also a UI for the human in the loop, just to keep an eye on things :)
Why This Matters
There are plenty of project management tools for humans. But when you're pairing with AI throughout your development process, the agent needs the same clarity you'd give a teammate. If the AI doesn't see your project structure, it can't respect it.
By making ProjectFlow MCP-native, the agent reads the roadmap, updates progress, and knows what comes next — all without me constantly reminding it. It's less me herding the AI and more us working from the same plan.
Open & Ready
The code is free and available at https://github.com/appex-uk/projectflow. Grab it, try it on your own vibe-coded projects, and let me know what works — and what doesn't.
What's Next
This started as a personal utility that solved a daily frustration. Now I'm curious — how do you keep AI-assisted work focused? Do you use prompts, tools, or good old-fashioned discipline? Let's chat in the comments.


Top comments (0)