Vibe-Coding Workflow

The 5-Step Workflow

Idea -> Research -> PRD -> Tech Design -> Agent Config -> Build MVP
        (20 min)  (15 min)  (15 min)      (10 min)      (1-3 hrs)

Step 1: Assess Current State

docs/research-*.txt

docs/PRD-*.md

docs/TechDesign-*.md

AGENTS.md

src/

app/

Step 2: Guide to Next Step

If Starting Fresh (No files)

Welcome to the Vibe-Coding Workflow!

I'll help you transform your app idea into a working MVP in 5 steps:

Step	What Happens	Time
1. Research	Validate idea & market	20 min
2. PRD	Define what to build	15 min
3. Tech Design	Plan how to build	15 min
4. Agent Config	Generate AI instructions	10 min
5. Build	Create your MVP	1-3 hrs

Let's start with Step 1: Research

Tell me about your app idea! What problem does it solve?

If Research Exists (has research-*.txt)

Progress Check: Research complete!

Next Step: Create your Product Requirements Document (PRD)

I found your research at

docs/research-[name].txt

. I'll use this to inform your PRD.

Ready to define your product requirements?

If PRD Exists (has PRD-*.md)

Progress Check: Research and PRD complete!

Next Step: Create your Technical Design

I'll help you decide:

• What tech stack to use
• How to structure the project
• Which tools are best for your skill level

Ready to plan the technical architecture?

If Tech Design Exists (has TechDesign-*.md)

Progress Check: Research, PRD, and Tech Design complete!

Next Step: Generate AI agent configuration files

I'll create:

• AGENTS.md

  - Master build plan

• agent_docs/

  - Detailed specifications
• Tool configs based on your choices

Which AI tools will you use to build?

If AGENTS.md Exists

Progress Check: All planning complete! Ready to build!

Your project has:

• Research findings
• Product requirements (PRD)
• Technical design
• Agent configuration (AGENTS.md)

Let's build your MVP!

I'll follow the plan in AGENTS.md:

1. Set up the project foundation
2. Build core features one by one
3. Polish and prepare for launch

Shall I start with Phase 1: Foundation?

Workflow State Tracking

Workflow Progress:

• Step 1: Research
• Step 2: PRD
• Step 3: Tech Design <- You are here
• Step 4: Agent Config
• Step 5: Build MVP

Handling Interruptions

I recommend completing [step] before moving to [next step] because:

• [Reason 1]
• [Reason 2]

However, if you want to proceed anyway, I can work with what we have. Your choice?

Quick Commands

/vibe-research

/vibe-prd

/vibe-techdesign

/vibe-agents

/vibe-build

/vibe-workflow

Completion

Congratulations! Your MVP is live!

Journey Completed:

• Idea validated through research
• Requirements defined in PRD
• Architecture planned in Tech Design
• AI guidance in AGENTS.md
• MVP built and deployed

What's Next:

1. Share with 5-10 beta users
2. Collect feedback (use a simple form)
3. Identify top 3 improvements
4. Plan v2 features

Remember: The best time to build was yesterday. The second best time is now. You did it!