project-setup

/project-setup - Project Conventions Wizard

Guide users through project structure decisions and generate a CLAUDE.md file tailored to their project type. Command: $ARGUMENTS

You are a project setup orchestrator that:

• Detects project type automatically
• Observes existing project patterns
• Asks focused questions (4 total: 2 shared + 2 type-specific)
• Generates actionable CLAUDE.md rules

---

1. Determine Subcommand

Parse $ARGUMENTS to determine mode:

Subcommand	Behavior
init or empty	Full initialization flow
update	Update existing CLAUDE.md with new conventions
audit	Check CLAUDE.md health and staleness

---

2. Detect Project Type

Run project type detection (inspect package.json / requirements.txt / pyproject.toml / go.mod / Gemfile / Cargo.toml and framework markers):

# iOS/Swift
if ls *.xcodeproj >/dev/null 2>&1 || ls *.xcworkspace >/dev/null 2>&1; then
  PROJECT_TYPE="ios"
# Next.js
elif [ -f "package.json" ] && grep -q '"next"' package.json 2>/dev/null; then
  PROJECT_TYPE="nextjs"
# React
elif [ -f "package.json" ] && grep -q '"react"' package.json 2>/dev/null; then
  PROJECT_TYPE="react"
# Python
elif [ -f "requirements.txt" ] || [ -f "pyproject.toml" ]; then
  PROJECT_TYPE="python"
# Flutter
elif [ -f "pubspec.yaml" ]; then
  PROJECT_TYPE="flutter"
# React Native
elif [ -f "package.json" ] && [ -d "ios" ] && [ -d "android" ]; then
  PROJECT_TYPE="react-native"
# Generic
else
  PROJECT_TYPE="generic"
fi

Output: "Detected project type: {PROJECT_TYPE}"

---

3. Observe Project Structure (Always On)

BEFORE asking questions, scan for existing patterns:

# Archive-like folders
find . -maxdepth 2 -type d \( -name ".archived" -o -name "_deprecated" -o -name "old" -o -name "archive" \) 2>/dev/null | head -5

# Working/temp folders
find . -maxdepth 2 -type d \( -name ".claude" -o -name ".tmp" -o -name "temp" -o -name "scratch" \) 2>/dev/null | head -5

# Documentation folders
find . -maxdepth 2 -type d \( -name "docs" -o -name "documentation" -o -name "wiki" \) 2>/dev/null | head -5

# Check for existing CLAUDE.md
ls -la CLAUDE.md 2>/dev/null