init-project

What this skill does

# Project Initializer

Scaffold project from reference template, then create PRD and checkpoints through interactive questions.

## What Gets Created

```
<CWD>/
├── app/                 # Next.js app router (from template)
├── components/          # UI components (from template)
├── hooks/               # Custom hooks (from template)
├── lib/                 # Utilities (from template)
├── stores/              # Zustand stores (from template)
├── supabase/            # Migrations (from template)
├── public/              # Static assets (from template)
├── .claude/             # Rules + skills + settings (from template)
├── .planning/
│   ├── PRD.md           # Requirements + features (generated)
│   └── CHECKPOINTS.md   # Progress tracker (generated)
├── package.json         # Dependencies (from template)
├── CLAUDE.md            # Project instructions (from template)
└── ...config files      # tsconfig, biome, etc. (from template)
```

## Flow

```
/init-project → Scaffold from reference/ → bun install → Interactive Questions → PRD → Checkpoints → Auto-start CP1
```

---

## Step 1: Scaffold from Reference

### 1.1 Locate Reference Directory

The `reference/` directory lives inside this skill's directory:

```
.claude/skills/init-project/reference/
```

Resolve the path relative to this SKILL.md file location.

### 1.2 Copy Files to CWD

Copy all files from `reference/` to the current working directory:

```bash
rsync -a --exclude='node_modules' --exclude='.next' --exclude='tsconfig.tsbuildinfo' --exclude='next-env.d.ts' \
  .claude/skills/init-project/reference/ ./
```

**Important**: This uses rsync to merge (not overwrite existing files unless they exist in reference). The `.claude/` directory in reference will be merged with the existing `.claude/` in CWD.

### 1.3 Install Dependencies

```bash
bun install
```

Show progress:

```
Scaffolding project from template...
✅ Copied template files to project
✅ Dependencies installed

Proceeding to project setup...
```

---

## Step 2: Verify MCP

Check connections silently:
```
mcp__supabase__list_projects
mcp__shadcn__list_shadcn_components
```

Show status:
```
MCP servers connected:
- Supabase: Connected (project: "xxx")
- shadcn/ui: Connected (59 components)
```

If not connected, warn and stop.

---

## Step 3: Interactive Discovery

Use `AskUserQuestion` for EACH question with smart suggestions.

### Question 1: Project Type

```
AskUserQuestion:
  question: "What type of app are you building?"
  header: "App Type"
  options:
    - label: "SaaS / Dashboard"
      description: "Admin panels, analytics, user management"
    - label: "E-commerce"
      description: "Product listings, cart, checkout"
    - label: "Social / Community"
      description: "Posts, comments, user profiles"
    - label: "Productivity / Tools"
      description: "Task management, notes, utilities"
```

### Question 2: Project Name

Based on app type, suggest names:

```
AskUserQuestion:
  question: "What's your project name?"
  header: "Name"
  options:
    # If SaaS:
    - label: "AdminHub"
      description: "Dashboard and admin panel"
    - label: "MetricFlow"
      description: "Analytics and metrics"
    # If E-commerce:
    - label: "ShopBase"
      description: "Online store"
    - label: "CartFlow"
      description: "Shopping platform"
    # If Productivity:
    - label: "TaskFlow"
      description: "Task management"
    - label: "NoteSpace"
      description: "Notes and docs"
    # Always include Other for custom input
```

### Question 3: Core Problem

```
AskUserQuestion:
  question: "What problem does this solve?"
  header: "Problem"
  options:
    # Based on app type, suggest common problems:
    # If SaaS:
    - label: "Track and manage user data"
      description: "CRUD operations, user management"
    - label: "Visualize metrics and analytics"
      description: "Charts, reports, dashboards"
    # If E-commerce:
    - label: "Sell products online"
      description: "Product catalog, checkout flow"
    - label: "Manage inventory"
      description: "Stock tracking, orders"
    # If Productivity:
    - label: "Organize tasks and projects"
      description: "Todo lists, project boards"
    - label: "Take and organize notes"
      description: "Note-taking, knowledge base"
```

### Question 4: MVP Features

```
AskUserQuestion:
  question: "Select MVP features (pick 3-4)"
  header: "Features"
  multiSelect: true
  options:
    # Based on app type, suggest relevant features:
    # If SaaS/Dashboard:
    - label: "User authentication"
      description: "Login, signup, profile"
    - label: "Dashboard overview"
      description: "Stats, charts, summary"
    - label: "Data management (CRUD)"
      description: "Create, read, update, delete"
    - label: "Search & filters"
      description: "Find and filter data"

    # If E-commerce:
    - label: "Product catalog"
      description: "List and view products"
    - label: "Shopping cart"
      description: "Add to cart, manage items"
    - label: "Checkout flow"
      description: "Payment, order confirmation"
    - label: "Order history"
      description: "View past orders"

    # If Productivity:
    - label: "Task CRUD"
      description: "Create, edit, delete tasks"
    - label: "Categories/Projects"
      description: "Organize items"
    - label: "Due dates & reminders"
      description: "Time-based features"
    - label: "Search & filters"
      description: "Find items quickly"
```

---

## Step 4: Confirm Before Creating

Show summary and ask confirmation:

```
## Project Summary

**Name**: TaskFlow
**Type**: Productivity / Tools
**Problem**: Organize tasks and projects

**MVP Features**:
1. User authentication
2. Task CRUD
3. Categories/Projects
4. Search & filters

**Checkpoints** (auto-generated):
- CP1: Database & Auth (3 tasks)
- CP2: Core Features (4 tasks)
- CP3: Polish & Deploy (3 tasks)

Create project files?
```

```
AskUserQuestion:
  question: "Create project with these settings?"
  header: "Confirm"
  options:
    - label: "Yes, create project"
      description: "Generate PRD and checkpoints, start CP1"
    - label: "Change features"
      description: "Go back and modify feature selection"
    - label: "Start over"
      description: "Begin from app type selection"
```

---

## Step 5: Generate PRD & Customize

Write `.planning/PRD.md` with collected info:

```markdown
# [Name] - PRD

## Overview
- **Project**: [name]
- **Type**: [type]
- **Created**: [date]
- **Status**: In Progress

## Problem
[selected problem]

## Target User
[inferred from type]

## MVP Features

| ID | Feature | Description | Priority |
|----|---------|-------------|----------|
| F1 | [feature] | [description] | P0 |
| F2 | [feature] | [description] | P0 |
| F3 | [feature] | [description] | P1 |
| F4 | [feature] | [description] | P1 |

## Tech Stack
- Framework: Next.js 16
- Styling: Tailwind CSS v4
- UI: shadcn/ui
- Backend: Supabase
- Forms: react-hook-form + zod
```

### Customize Project Files

After generating the PRD, update scaffolded files with the user's project name:

1. **`package.json`** → Update `"name"` field to kebab-case of project name
2. **`.claude/settings.json`** → Update `"name"` and `"description"` fields

```bash
# Example: If user chose "TaskFlow"
# package.json: "name": "task-flow"
# .claude/settings.json: "name": "TaskFlow", "description": "Organize tasks and projects"
```

---

## Step 6: Generate Checkpoints

Auto-generate checkpoints based on features:

**Pattern**:
- CP1: Database + Auth (always first)
- CP2: Core features (main functionality)
- CP3: Polish + Deploy (always last)

```markdown
# Project Checkpoints

## Status
- **Project**: [name]
- **Progress**: 0/3 checkpoints
- **Current**: CP1

---

## CP1: Database & Auth ⬜
> Setup foundation

- [ ] Create database tables with RLS
- [ ] Setup authentication flow
- [ ] Generate TypeScript types

**Done when**: User can sign up, login, and data is secure

---

## CP2: Core Fea