Bootstrap

Phase 3: Execution

Based on the choice, run the appropriate scaffolding commands:

Web SaaS:

npx create-next-app@latest [project-name] --typescript --tailwind --app
cd [project-name]

Mobile App:

npx create-expo-app [project-name] --template tabs
cd [project-name]

Backend API (Node.js):

mkdir [project-name] && cd [project-name]
npm init -y
npm install express typescript @types/express @types/node
npx tsc --init

Phase 4: Project Setup

1. Initialize Git:

   git init
   git add .
   git commit -m "Initial commit"
   

2. Create .gitignore:

   • Copy from appropriate template (Node, Python, etc.)

3. Create README.md:

   • Use .claude/templates/README-TEMPLATE.md
   • Fill in project name and description

4. CRITICAL: Set up .claude/ folder structure:

   mkdir -p .claude/agents .claude/docs .claude/skills .claude/templates
   cp -r /path/to/vibe-coding-os/.claude/* .claude/
   

Phase 5: Record Decision

Invoke /record-decision with:

Initialized [Project Type] project with [Stack Details]

Error Handling

If command fails (e.g., npx not found):

• Check if Node.js is installed: node --version
• Suggest: "Please install Node.js 18+ from https://nodejs.org"

If Git is not initialized:

• Check: git --version
• Suggest: "Please install Git from https://git-scm.com"

If project directory already exists:

• Ask: "Directory exists. Delete and recreate? (Yes/No)"
• If No: Exit gracefully

If .claude/ setup fails:

• Provide manual instructions
• Offer to create minimal structure

Success Criteria

• Project created with correct structure
• Git initialized
• README.md created
• .claude/ folder configured
• Decision recorded
• User can run npm run dev (or equivalent)