Start Vibe Project

start-vibe-project

**start-vibe-project** is a CLI that bootstraps a new project with an AI-first documentation structure for **spec-driven development**. It creates a ready-to-fill `.project` workspace (about, specs, architecture, context, stories) so teams can align on requirements before writing code.

During setup you choose a template and stack, and the tool prepares agent directories and installs the required skills for your AI tool. The result is a clean, consistent starting point for OpenSpec-driven workflows.

https://github.com/user-attachments/assets/0e654592-78e4-47b3-b6a8-1b794720e051

**[⚠️ INSTALL FIRST!](#install-first)**

Quick Start

**Using bun (recommended)**

bunx start-vibe-project@latest

**Using npm/npx**

npx start-vibe-project

Features

• Interactive setup: Guided CLI prompts to configure your project
• AI-first documentation: Pre-structured .project/ folder for AI agents
• Multiple templates: Web app, mobile app, API service, library, or empty project
• Tech stack selection: Choose frontend and backend frameworks
• Multi-agent support: Works with GitHub Copilot, Claude Code, Cursor, and more
• Automatic skill installation: Installs essential skills for your AI tool

What Gets Created

my-project/
├── .project/
│   ├── INIT.md           # Project setup checklist for the creator agent
│   ├── about.md          # Project overview (pre-filled with your description)
│   ├── specs.md          # Technical specifications (with your stack choices)
│   ├── architecture.md   # System architecture (to be defined by agent)
│   ├── project-context.md # Living context document
│   └── stories/
│       └── stories.md    # User stories (to be defined)
├── .github/skills/       # Skills for your AI tool (or .claude/, .cursor/, etc.)
├── .github/agents/
│   └── creator.md        # Project Creat