DEV Community

appex.uk
appex.uk

Posted on Edited on

ProjectFlow: Agent-First Project Management — Vibe Coding Without Losing Control

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)