A Complete System for AI-Human Software Development Collaboration
npm install vibesuiteCode with the flow. Code with the vibe.
bash
Using npx (No installation required)
npx vibesuite init
Or using pnpm
pnpm dlx vibesuite init
`
This interactive CLI will let you choose exactly what you need:
- ✅ .agent Folder (For Cursor/Windsurf workflows)
- ✅ Kilo Code Agents (YAML definitions)
- ✅ Legacy Protocols (Manual prompts)
- ✅ Select Specific Workflows/Skills
---
🌟 What is VibeCode?
VibeCode isn't just a collection of prompts—it's a complete workflow system for collaborating with AI to build software. Think of yourself as the Visionary/CEO, and your AI assistants as a specialized, high-performance development team.
This repository contains the VibeCode Protocol Suite: a battle-tested collection of protocols, workflows, and prompts that transform AI from simple code generators into genuine project partners.
---
📂 Repository Structure
This repo is organized for two types of users:
| Folder | Purpose | Who It's For |
|--------|---------|--------------|
| .agent/ | Workflows & Skills for agentic IDEs | Cursor, Windsurf, Gemini Code Assist users |
| Legacy (Manual Method)/ | Copy-paste prompts & protocols | Browser-based AI users (ChatGPT, Claude.ai) |
| Deep_Source_Prompts/ | Reference docs & source materials | Prompt engineers, contributors |
---
🤖 For Agentic IDE Users (Recommended)
Using Cursor, Windsurf, VS Code + Gemini Code Assist, or similar?
Everything you need is in the .agent/ folder.
$3
1. Copy the .agent/ folder to the root of your project
2. The IDE will automatically detect workflows and skills
3. Invoke workflows with slash commands (e.g., /init_vibecode_genesis)
$3
`
.agent/
├── workflows/ # Executable step-by-step workflows
│ ├── vibe-genesis.md # Start new projects (V3)
│ ├── vibe-design.md # Generate design systems
│ ├── vibe-build.md # Execute the build
│ ├── vibe-continueBuild.md # Resume work in new sessions
│ ├── vibe-finalize.md # Final verification & handoff
│ ├── vibe-spawnTask.md # Break down complex features
│ ├── vibe-syncDocs.md # Update documentation
│ ├── vibe-primeAgent.md # Load project context
│ ├── reverse_genesis.md # Onboard to existing codebases
│ │
│ ├── mode-orchestrator.md # Coordinate multi-agent projects
│ ├── mode-architect.md # Plan and design systems
│ ├── mode-code.md # Write and refactor code
│ ├── mode-debug.md # Diagnose issues
│ ├── mode-ask.md # Explain and analyze
│ ├── mode-review.md # Code review (manual)
│ └── ...
│
└── skills/ # Implicit capabilities (auto-activated)
├── prime-agent/ # Load project context
├── code-review/ # J-Star code review loop
├── security-audit/ # Deep security analysis
├── nextjs-standards/ # Next.js coding standards
├── vercel-ai-sdk/ # AI SDK reference docs
├── youtube-pipeline/ # Video production workflow
└── ...
`
$3
#### 🏗️ Project Lifecycle (V3)
| Slash Command | What It Does |
|---------------|--------------|
| /vibe-genesis | Architect a new project with PRD, Issues, and Guidelines |
| /vibe-design | Generate design system and page mockups |
| /vibe-build | Scaffold and build the project with verification gates |
| /vibe-continueBuild | Resume work in a new chat session |
| /vibe-finalize | Final verification and handoff report |
| /reverse_genesis | Onboard AI to an existing codebase |
#### 🎯 Mode Workflows (Specialized Roles)
| Slash Command | What It Does |
|---------------|--------------|
| /mode-orchestrator | Coordinate complex multi-agent projects |
| /mode-architect | Plan and design technical systems |
| /mode-code | Write and refactor code |
| /mode-debug | Diagnose and troubleshoot issues |
| /mode-ask | Explain and analyze without making changes |
| /mode-review | Manual code review before commits |
#### 🔄 Daily Development
| Slash Command | What It Does |
|---------------|--------------|
| /vibe-primeAgent | Load project context at start of session |
| /vibe-spawnTask | Break down complex features into tasks |
| /vibe-syncDocs | Update documentation after code changes |
| /mode-review_code | Run J-Star automated code review |
| /escalate | Generate escalation report when stuck |
| /migrate | Transfer context to a new chat session |
---
📋 For Browser-Based AI Users
Using ChatGPT, Claude.ai, or Gemini in the browser?
Use the Legacy (Manual Method)/ folder with copy-paste prompts.
$3
| # | Protocol | Purpose |
|---|----------|---------|
| 0 | VibeCode User Manual | Complete guide to the system |
| 1 | Project Genesis Protocol | Start any new project (99% of cases) |
| 2 | Ultimate Orchestration Prompt | One-shot prompt for quick scripts |
| 3 | Design System Genesis Protocol | Create visual design systems |
| 4 | GitHub Issue Meta-Prompt | Structured issue creation |
| 5 | Escalation & Handoff Protocol | When AI gets stuck |
| 8 | Seamless Migration Meta-Prompt | Transfer context between sessions |
| 9 | Reverse Genesis Protocol | Onboard AI to existing codebases |
$3
1. Open the relevant .md file from Legacy (Manual Method)/
2. Copy the entire prompt
3. Paste it into your AI chat interface
4. Follow the conversation flow
---
📚 Deep Source Prompts (For Contributors)
The Deep_Source_Prompts/ folder contains the reference documentation and source materials used to create the workflows and protocols.
$3
- Coding Guidelines - React/TypeScript and Next.js App Router standards
- Vercel AI SDK Docs - Complete AI SDK reference (building RAG, streaming, tools)
- Design System Docs - Google's Material Design 3, mobile-first patterns
- Agent Prompts - Raw system prompts for various AI agents
- OpenRouter Docs - API reference for multi-model routing
> Note: These are raw, unprocessed reference materials. They're useful for understanding why the workflows are structured the way they are, or for creating new workflows.
---
🎯 The VibeCode Philosophy
- Structured Collaboration: Clear roles for different AI agents (Genesis, Designer, Builder, Orchestrator, Architect, Coder, Debugger)
- End-to-End Workflows: From project genesis to debugging escalations
- Documentation-Driven: Every project gets proper docs, issues, and roadmaps
- Multi-Agent Orchestration: Coordinate specialized agents for complex projects
- Scalable: Works for tiny scripts or enterprise applications
🆕 What's New (V3 + Mode Workflows)
$3
The V3 workflows introduce verification gates, TypeScript strict mode, and better continuation support:
- tsc --noEmit after every file edit
- 1:1 Feature Requirement ↔ Issue correlation
- Templates from nextjs-standards skill
- Seamless session continuation with /vibe-continueBuild
$3
New specialized mode workflows for targeted tasks:
- /mode-orchestrator - Coordinate multi-agent projects with session-based task management
- /mode-architect - Plan and design before coding
- /mode-code - Focused implementation mode
- /mode-debug - Systematic troubleshooting
- /mode-ask - Analysis without changes
- /mode-review - Quality assessment
$3
- vibe-* workflows = Project lifecycle (genesis, design, build, continue, finalize)
- mode-* workflows = Specialized agent modes (orchestrator, architect, code, debug, ask, review)
- Skills = Reusable capabilities with auto-loading (in .agent/skills/)
---
👥 Your AI Team
$3
| Role | Workflow | Responsibility | When to Use |
|------|----------|---------------|-------------|
| Genesis | /vibe-genesis | Strategic planning, PRD creation, issue generation | Starting new projects |
| Designer | /vibe-design | Visual design systems, UI mockups | Before implementation |
| Builder | /vibe-build | Initial code implementation with verification | Building the foundation |
| Continuer | /vibe-continueBuild | Resume work in new sessions | Continuing after breaks |
| Finalizer | /vibe-finalize | Verification, handoff reports | Project completion |
$3
| Role | Workflow | Responsibility | When to Use |
|------|----------|---------------|-------------|
| Orchestrator | /mode-orchestrator | Coordinate multi-agent projects, delegate tasks | Complex projects requiring coordination |
| Architect | /mode-architect | Technical planning, system design | Before coding complex features |
| Coder | /mode-code | Write, refactor, implement code | Day-to-day coding tasks |
| Debugger | /mode-debug | Systematic issue diagnosis | When bugs are hard to find |
| Analyst | /mode-ask | Explain, analyze, recommend | Understanding code without changes |
| Reviewer | /mode-review | Code quality assessment | Pre-commit quality gates |
---
🚀 Quick Start Guide
$3
`bash
1. Copy .agent folder to your project root
cp -r path/to/VibeCode-Protocol-Suite/.agent ./
2. Start a new project (V3 Workflow)
Type: /vibe-genesis
3. Generate design system
Type: /vibe-design
4. Build the project
Type: /vibe-build
5. Continue in new sessions
Type: /vibe-continueBuild
6. Finalize and handoff
Type: /vibe-finalize
`
$3
`bash
Use the orchestrator to coordinate multiple specialized agents
Type: /mode-orchestrator
The orchestrator will:
1. Break down your project into subtasks
2. Create task files in docs/tasks/orchestrator-sessions/[ID]/
3. Guide you to spawn sub-agents for each task
4. Track completion and synthesize results
`
$3
`bash
1. Open: Legacy (Manual Method)/1 Project Genesis Protocol The VibeCode Workflow.md
2. Copy the entire content
3. Paste into ChatGPT/Claude/Gemini
4. Follow the conversation flow
`
---
🤝 Contributing
This is a living system! If you discover improvements:
1. Test your changes with real projects
2. Add reference materials to Deep_Source_Prompts/ if needed
3. Create workflows in .agent/workflows/ for agentic IDEs
4. Update legacy prompts in Legacy (Manual Method)/` for browser users
Built with ❤️ for developers who want to code with the flow
Transform AI from a tool into a true development partner