Claude Code Starter

Intelligent CLI that uses Claude to deeply analyze your project and generate tailored Claude Code configurations.

Quick Start

cd your-project
npx claude-code-starter
claude

Requires Claude CLI to be installed.

What It Does

1. Analyzes your repository - Detects languages, frameworks, tools, and patterns
2. Launches Claude CLI - Claude reads your actual source files and understands your architecture
3. Generates a professional CLAUDE.md - Project-specific documentation with architecture, conventions, and patterns
4. Creates supporting configurations - Skills, agents, rules, and commands tailored to your stack

How It Works

npx claude-code-starter
  |
  ├── 1. Detect tech stack (languages, frameworks, tools)
  ├── 2. Generate supporting files (skills, agents, rules, commands)
  ├── 3. Launch Claude CLI for deep project analysis
  │     └── Claude reads source files → understands architecture → writes CLAUDE.md
  └── 4. Done! Run `claude` to start working

The key difference from static scaffolding tools: Claude actually reads your codebase and generates documentation specific to your project's architecture, patterns, conventions, and domain knowledge.

Tech Stack Detection

Automatically detects and configures for:

Generated Configurations

Based on your stack, creates:

• CLAUDE.md - Comprehensive project documentation generated by Claude's deep analysis of your codebase
• Skills - Framework-specific patterns (e.g., Next.js App Router, FastAPI endpoints)
• Agents - Specialized assistants (code reviewer, test writer)
• Rules - Language conventions (TypeScript strict mode, Python PEP 8)
• Commands - Workflow shortcuts (/task, /status, /done, /analyze, /code-review)

Commands

CLI Options

npx claude-code-starter           # Interactive mode
npx claude-code-starter -y        # Non-interactive (use defaults)
npx claude-code-starter -f        # Force overwrite existing files
npx claude-code-starter -V        # Verbose output
npx claude-code-starter --help    # Show help

Example Output

Claude Code Starter v0.4.1
Intelligent AI-Assisted Development Setup

Analyzing repository...

Tech Stack
  Language: TypeScript
  Framework: Next.js
  Package Manager: bun
  Testing: vitest

Existing project with 42 source files

Generating supporting configuration...

Created:
  + .claude/settings.json
  + .claude/skills/pattern-discovery.md
  + .claude/skills/nextjs-patterns.md
  ...

Launching Claude for deep project analysis...
Claude will read your codebase and generate a comprehensive CLAUDE.md

Claude analysis complete!

Done! (15 files)

Generated for your stack:
  CLAUDE.md (deep analysis by Claude)
  9 skills (pattern-discovery, iterative-development, security, nextjs-patterns, ...)
  2 agents (code-reviewer, test-writer)
  2 rules

Next step: Run claude to start working!

Project Structure

After running, your project will have:

.claude/
├── CLAUDE.md           # Project-specific docs (generated by Claude analysis)
├── settings.json       # Permissions configuration
├── agents/             # Specialized AI agents
│   ├── code-reviewer.md
│   └── test-writer.md
├── commands/           # Slash commands
│   ├── task.md
│   ├── status.md
│   ├── done.md
│   ├── analyze.md
│   └── code-review.md
├── rules/              # Code style rules
│   ├── typescript.md   # (or python.md, etc.)
│   └── code-style.md
├── skills/             # Methodology guides + patterns
│   ├── pattern-discovery.md
│   ├── systematic-debugging.md
│   ├── testing-methodology.md
│   ├── iterative-development.md
│   ├── commit-hygiene.md
│   ├── code-deduplication.md
│   ├── simplicity-rules.md
│   ├── security.md
│   └── nextjs-patterns.md  # (framework-specific)
└── state/
    └── task.md         # Current task tracking

Architecture

flowchart LR
    A[CLI] --> B[Analyzer]
    B --> C[Generator]
    B --> D[Claude CLI]

    B -->|reads| E[package.json]
    B -->|reads| F[config files]
    B -->|reads| G[lock files]

    C -->|creates| H[skills/]
    C -->|creates| I[agents/]
    C -->|creates| J[rules/]
    C -->|creates| K[commands/]

    D -->|reads| L[source files]
    D -->|creates| M[CLAUDE.md]

Artifact Generation

Conflict Resolution

When running on an existing project with .claude/ configuration:

Framework-Specific Patterns

When a framework is detected, additional skills are generated:

Requirements

• Node.js 22.14+ (for running via npx)
• Claude CLI (for deep project analysis)

License

MIT License. See LICENSE for details.