Vibe Workflow
A vibe coding workflow with skills: idea research, PRD, tech design, AGENTS.md, build, verification and debugging
Install
npx vibeworkflowRun in the project folder; the installer asks follow-up questions
This is third-party code. Review the repository files before installing.
What it does
The project takes a beginner or solo developer from idea to a working MVP in five steps. The first three, research, PRD and tech design, run as prompts in any chat tool. Then npx vibeworkflow installs vibe-* skills into the project and generates AGENTS.md and an agent_docs folder. In an existing app, vibe-change, vibe-debug and vibe-verify help make changes, fix breakage and verify user journeys.
Who it is for. For beginner developers, founders and product managers building an MVP with AI agents.
Good fit when
- You have an app idea and need requirements and a stack
- You need AGENTS.md before an agent starts on a new project
- The project broke after a series of agent edits and you need structured debugging
Not a fit when
- The team already has an established design process
- You need strict spec-driven development with phase approvals
Example request
Run npx vibeworkflow and help me plan a booking app for a barbershopLimitations
Document quality depends on user answers and the chosen model. The research step relies on web search when the chat tool supports it. The process targets small products and MVPs.
How to disable. Delete the vibe-* skill folders from .claude/skills or .agents/skills in the project.
Security check
- Build and debug skills write code and run commands in the project
README in short
The README offers two paths: ask an agent to run npx vibeworkflow, or walk through the prompts manually. Each step lists which file to copy, how long it takes and where to save the output. Sections cover tools, agent practices, safety, project structure and common pitfalls. A web version lives at vibeworkflow.app. MIT licensed.
FAQ
Can I use it without an agent?
Yes, you can paste the repo prompts into any chat in order; an agent is only needed for the build step.
Which agents are supported?
The README names Claude Code, Cursor, Codex and Gemini CLI.
Related
A skills library that gives coding agents a development process: brainstorming, planning, TDD, subagents and code review
Skills for real engineers by Matt Pocock
Skills For Real Engineers
Small composable skills for engineering with agents: plan grilling, TDD, bug diagnosis, code review and architecture
Reference MCP servers
Model Context Protocol servers
Official reference MCP servers: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time and Everything
Up-to-date, version-specific library docs and code examples in your agent's context, via MCP or a CLI plus skill