// Recommended Setup

# Using npm (recommended)
npm install -g @anthropic-ai/claude-code

# Using Homebrew
brew install claude-code

# Verify installation
claude --version

claude auth

# Authenticate with your Team Premium account
claude auth

# (Optional) Set your preferred model
export ANTHROPIC_MODEL='claude-sonnet-4-20250514'

# (Optional) Enable high-reasoning mode
export CLAUDE_CODE_EFFORT_LEVEL=max

# Launch Claude Code
claude

/plan Refactor the authentication module to support OAuth2

# Claude Code will generate a plan like:
# 1. Create OAuth2 provider interface
# 2. Implement Google OAuth2 provider
# 3. Update auth middleware
# 4. Add token refresh logic
# 5. Update tests

# CLAUDE.md

## Project Overview
This is a TypeScript monorepo using Turborepo.

## Coding Conventions
- Use functional components with hooks
- Prefer named exports over default exports
- All API routes must include error handling
- Use Zod for runtime validation

## Architecture
- /packages/ui - Shared component library
- /apps/web - Next.js frontend
- /apps/api - Express backend

## Testing
- Run tests with: pnpm test
- Coverage threshold: 80%
- Always mock external API calls

# Enable Agent Teams (experimental)
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

# Launch Claude Code and spawn a team
claude
> "Refactor the auth module. Use 2 teammates:
>  - Agent 1: Rewrite the token refresh logic
>  - Agent 2: Update all affected tests"

# Navigate between agents: Shift+Down/Up

# .clinerules

## Project Stack
- Framework: Next.js 14 with App Router
- Database: PostgreSQL with Prisma ORM
- Styling: Tailwind CSS
- State: Zustand for client state

## Rules
- Always use TypeScript strict mode
- Prefer server components by default
- Use 'use client' only when necessary
- All API routes must validate input with Zod

## Avoid
- Do not use class components
- Do not add unnecessary dependencies
- Avoid inline styles; use Tailwind classes

your-project/
├── CLAUDE.md                    # Claude Code project memory (committed)
├── CLAUDE.local.md              # Personal overrides (gitignored)
├── .clinerules                  # Cline project rules (committed)
├── .claude/
│   ├── settings.json            # Claude Code settings & hooks
│   └── rules/
│       ├── frontend.md          # Loads only for src/components/**
│       ├── api.md               # Loads only for src/api/**
│       └── testing.md           # Loads only for **/*.test.*
├── memory-bank/                 # Cline Memory Bank (committed)
│   ├── projectbrief.md          # Foundation: goals & scope
│   ├── productContext.md        # The "why" behind the project
│   ├── activeContext.md         # Current focus & next steps
│   ├── systemPatterns.md        # Architecture & design patterns
│   ├── techContext.md           # Tech stack & constraints
│   └── progress.md              # Milestones & known issues
├── src/
│   ├── CLAUDE.md                # Module-level overrides (optional)
│   └── ...
├── .gitignore
└── package.json

# Store your GitHub Personal Access Token
export GITHUB_TOKEN="ghp_your_token_here"

# After Claude Code creates an architecture plan, tell Cline:
"I just used Claude Code to plan a refactor of the auth module.
The plan is in the terminal output. Please implement step 1:
Create the OAuth2 provider interface at src/auth/providers/oauth2.ts"

# After Cline implements changes, tell Claude Code:
"Cline just created 3 new files for OAuth2 support.
@src/auth/providers/ Review these files and run the test suite."

# Claude Code local overrides
CLAUDE.local.md

# Claude Code internal state
.claude/tasks/
.claude/todos/

# Understand-Anything cache (optional: commit knowledge-graph.json)
.understand-anything/cache/

# Environment variables
.env
.env.local

# IDE
.vscode/settings.json

# Dependencies
node_modules/

#!/bin/bash
# AI Development Setup Script
# Creates the recommended file structure for Claude Code + Cline

echo "🚀 Setting up AI development environment..."

# Create CLAUDE.md
cat > CLAUDE.md << 'EOF'
# CLAUDE.md

## WHAT — Project Context
- Project: [Your Project Name]
- Stack: TypeScript, Next.js 14, PostgreSQL, Prisma, Tailwind CSS

## WHY — Architecture Decisions
- Server Components by default
- Zod for ALL runtime validation
- Prefer named exports over default exports

## HOW — Workflows
- Build: yarn build
- Test: yarn test
- Lint: yarn lint
EOF

# Create .clinerules
cat > .clinerules << 'EOF'
# .clinerules

## Project Stack
- Framework: Next.js 14 with App Router
- Language: TypeScript (strict mode)
- Styling: Tailwind CSS

## Rules
- Use functional components with hooks
- Prefer named exports
- All API routes must validate input with Zod
EOF

# Create Claude Code rules directory
mkdir -p .claude/rules
touch .claude/settings.json

# Create Memory Bank
mkdir -p memory-bank
touch memory-bank/projectbrief.md
touch memory-bank/activeContext.md
touch memory-bank/progress.md
touch memory-bank/techContext.md
touch memory-bank/systemPatterns.md

echo "✅ Setup complete! Files created:"
echo "  - CLAUDE.md"
echo "  - .clinerules"
echo "  - .claude/rules/"
echo "  - memory-bank/"
echo ""
echo "Next steps:"
echo "  1. Customize CLAUDE.md with your project details"
echo "  2. Run 'claude auth' to authenticate Claude Code"
echo "  3. Configure Cline with your API key"