init-project

Initialize Claude Code Project Structure

Set up a complete Claude Code project structure in the target directory. Adapts to existing projects by detecting language, framework, and directory layout.

Step 1: Determine Target Directory

Target: $ARGUMENTS

• If a path is provided, use it as the project root
• If empty, use the current working directory
• If the directory doesn't exist, create it

ls -la <target_dir> 2>/dev/null

Step 2: Detect Existing Project

Scan for existing project files to determine if this is a new or existing project:

# Detect language/framework
ls package.json pyproject.toml go.mod Cargo.toml pom.xml build.gradle Gemfile composer.json 2>/dev/null

# Detect existing source directories
ls -d src/ app/ lib/ cmd/ pkg/ internal/ components/ pages/ routes/ 2>/dev/null

# Check dependency files for framework detection
cat package.json 2>/dev/null | head -30
cat pyproject.toml 2>/dev/null | head -30

If existing project detected:

• Do NOT create src/api/ or src/persistence/ if they don't match the project
• Instead, identify the actual source directories and create module CLAUDE.md files for each
• Adapt Tech Stack, Commands, and Conventions based on detected framework
• Warn the user before overwriting any existing files

Project type detection rules:

File Found	Project Type	Source Dirs	Key Commands
package.json	Node.js	src/, app/, lib/, components/	npm/yarn/pnpm
pyproject.toml / requirements.txt	Python	src/, app/, lib/	pip, pytest, ruff
go.mod	Go	cmd/, pkg/, internal/	go build, go test
Cargo.toml	Rust	src/	cargo build, cargo test
pom.xml / build.gradle	Java/Kotlin	src/main/, src/test/	mvn, gradle
None detected	New project	src/api/, src/persistence/	(ask user)

If new project (no existing files):

• Ask the user for project name, description, tech stack
• Create the default src/api/ and src/persistence/ structure