Vibe-coding, for everyone

Build real apps by describing them.

Vibe-Spec is a guided workflow that turns your idea into a working app. You describe what you want, then walk through it together — it plans, asks questions, and builds one step at a time, with you in control. No need to know how the code works.

You
I want a booking site for my yoga studio.
/
/spec-draft Got it — a couple of questions first. Should clients pay when they book, or just reserve a spot?
You
Pay by card when they book.
You
  1. Draft
  2. Refine
  3. Phases
  4. Plan
  5. Build

You guide each step and approve every phase before it’s built — currently building phase 2 of 4.

Paste into Claude Code
/plugin marketplace add Connorrmcd6/vibe-spec/plugin install vibe-spec

That’s it — the workflow is now available. Type /spec-draft to begin.

How it works

Five simple steps take you from an idea to a working app. You stay in plain language the whole way — the commands do the technical work.

  1. 1

    Describe it

    /spec-draft

    Tell it what you want to build. It interviews you and writes a plain-language spec — what the app does and how people use it.

  2. 2

    Refine it

    /spec-refine

    It asks questions, fills the gaps, and chooses the right tools for the job, so the plan is solid before any code is written.

  3. 3

    Break it down

    /spec-phases

    It splits the work into small, ordered phases — bite-sized pieces you can follow one at a time.

  4. 4

    Plan each phase

    /spec-plan

    It writes a short plan for every phase up front, so nothing is a surprise and you always know what’s next.

  5. 5

    Build it

    /spec-implement

    It builds one phase at a time and keeps the spec up to date as it goes, so the plan always matches the app.

Each step runs in a fresh session, and the spec is always kept current — so the AI never loses track of what you’re building.

Bonus

Make it beautiful

Vibe-Spec gets the foundation right — solid, working, production-grade. When you want it to look as good as it works, hand it to impeccable — a separate set of design skills (/polish, /bolder, /delight) that turn a working app into a beautiful one. This very site was built that way.

Built on solid ground

You don’t need to know any of this. Behind the scenes, Vibe-Spec draws on 18 battle-tested references — refined across real production apps — so what gets built is the real thing, not a throwaway prototype. It only uses the pieces your app actually needs.

  • AI-Assisted Development
  • Project Scaffolding
  • High-Performance APIs
  • Docker
  • Database Architecture
  • Prisma ORM
  • dbt Transforms
  • Authentication
  • RBAC (permissions)
  • Validation
  • Testing
  • UI Framework
  • File & Media Uploads
  • Push Notifications
  • CI/CD
  • Pre-commit Hooks
  • Deployment
  • Scripts & CLI Tools

Curious about the details? They’re all on GitHub.

Prefer not to install a plugin?

No problem — the whole thing is just markdown. Copy it and paste it into Claude, Cursor, or any AI tool, or save it as vibe-spec.md in your project so your assistant always has it on hand. It’s the same reference the plugin uses, kept in sync automatically.

vibe-spec.md
# Vibe-Spec: Stack Reference Guide

A reusable blueprint for building full-stack web apps with Next.js, Prisma, and
PostgreSQL — refined through real production projects using spec-driven
development. Every section is self-contained with skip/need conditions, key
files, copy-pasteable config, and gotchas.

**Only adopt what you need.** Most projects won't need all of it: a static site
doesn't need Prisma or Docker; a simple CRUD app doesn't need S3 or push
notifications. Load only the sections relevant to the task in front of you.

---

# AI-Assisted Development (Spec-Driven Workflow)

> **Skip this if:** you don’t use AI coding tools

18 sections · ~70 KB · always current with the plugin.

Ready to build your idea?

Install the workflow in two lines, then describe what you want to build. No setup, no boilerplate — just start.