everything-claude-code

everything-claude-code/
├── docs/                    # Dokumentacja i poradniki
│   ├── getting-started/    # Przewodnik początkowy
│   ├── configuration/      # Konfiguracja Claude Code
│   ├── best-practices/     # Najlepsze praktyki
│   ├── troubleshooting/    # Rozwiązywanie problemów
│   └── advanced/           # Zaawansowane techniki
├── examples/               # Przykłady projektów
│   ├── nextjs-app/        # Przykład Next.js
│   ├── python-api/        # Przykład Python API
│   ├── cli-tool/          # Przykład narzędzia CLI
│   └── fullstack/         # Przykład fullstack
├── templates/              # Szablony CLAUDE.md
│   ├── frontend/          # Dla projektów frontend
│   ├── backend/           # Dla projektów backend
│   ├── mobile/            # Dla aplikacji mobilnych
│   └── monorepo/          # Dla monorepo
├── integrations/           # Integracje z narzędziami
│   ├── vscode/            # VS Code extension
│   ├── cursor/            # Cursor integration
│   ├── neovim/            # Neovim setup
│   └── cicd/              # CI/CD pipelines
├── prompts/                # Kolekcja efektywnych promptów
│   ├── coding/            # Prompty do kodowania
│   ├── debugging/         # Prompty do debugowania
│   ├── refactoring/       # Prompty do refaktoringu
│   └── documentation/     # Prompty do dokumentacji
└── community/              # Materiały społeczności
    ├── tips-tricks/       # Porady użytkowników
    ├── workflows/         # Sprawdzone workflow
    └── case-studies/      # Case studies

# Instalacja Claude Code
# macOS / Linux
curl -fsSL https://claude.ai/install.sh | sh

# lub przez npm
npm install -g @anthropic-ai/claude-code

# Weryfikacja instalacji
claude --version

# Pierwsza sesja
claude

# Z konkretnym zadaniem
claude "Stwórz funkcję do walidacji email w TypeScript"

# Ustaw klucz API
export ANTHROPIC_API_KEY="your-api-key-here"

# Alternatywnie, użyj pliku konfiguracyjnego
mkdir -p ~/.config/claude-code
cat > ~/.config/claude-code/config.json << 'EOF'
{
  "model": "claude-sonnet-4-5-20241022",
  "maxTokens": 8192,
  "temperature": 0.7,
  "autoSave": true,
  "gitIntegration": true
}
EOF

# Project: My Awesome App

## Tech Stack
- Next.js 15 (App Router)
- TypeScript 5.x (strict mode)
- Tailwind CSS 3.x
- Prisma ORM + PostgreSQL
- NextAuth.js for authentication

## Project Structure

## Coding Conventions
- Use functional components with hooks
- Prefer server components where possible
- Keep components under 150 lines
- Use TypeScript strict mode
- Follow Prettier formatting

## Important Files
- `prisma/schema.prisma` - Database schema
- `src/lib/auth.ts` - Authentication configuration
- `src/components/ui/` - Shared UI components

## Commands
- `npm run dev` - Start development server
- `npm run build` - Production build
- `npm run test` - Run tests
- `npm run lint` - Check for linting errors

# CLAUDE.md Best Practices

## 1. Bądź konkretny o stacku technologicznym
Nie: "Używamy React"
Tak: "Next.js 15 App Router z TypeScript 5.x w strict mode"

## 2. Opisz strukturę katalogów
Claude potrzebuje zrozumieć organizację projektu,
żeby efektywnie nawigować i modyfikować pliki.

## 3. Zdefiniuj konwencje kodowania
- Styl nazewnictwa (camelCase, PascalCase)
- Preferowane patterny (hooks vs classes)
- Formatowanie (Prettier, ESLint rules)

## 4. Wymień kluczowe pliki
Wskaż Claude najważniejsze pliki, które powinien
znać przed wprowadzaniem zmian.

## 5. Udokumentuj komendy
Lista wszystkich npm scripts z opisem co robią.

## 6. Określ ograniczenia
- Maksymalna długość plików
- Wymagania dotyczące testów
- Zasady importów

## 7. Aktualizuj regularnie
CLAUDE.md powinien ewoluować wraz z projektem.

# Inicjalizacja projektu
claude "Stwórz nowy projekt Next.js 15 z:
- TypeScript
- Tailwind CSS
- Prisma + SQLite
- NextAuth z GitHub OAuth
- Podstawową strukturę katalogów"

# Claude wykona:
# 1. npx create-next-app@latest
# 2. Zainstaluje zależności
# 3. Skonfiguruje Prisma
# 4. Doda NextAuth
# 5. Stworzy CLAUDE.md

# Stwórz API w FastAPI
claude "Stwórz REST API w FastAPI z:
- Endpointy CRUD dla użytkowników
- SQLAlchemy + PostgreSQL
- JWT authentication
- Pydantic validation
- Swagger docs"

# Sesja 1: Setup projektu
$ claude
You: Zainicjalizuj projekt e-commerce z Next.js

# Sesja 2: Dodaj funkcjonalność
$ claude --continue
You: Dodaj koszyk zakupowy z persystencją w localStorage

# Sesja 3: Integracja płatności
$ claude --continue
You: Zintegruj Stripe Checkout

# Sesja 4: Deployment
$ claude --continue
You: Skonfiguruj deployment na Vercel z środowiskiem produkcyjnym

// .vscode/settings.json
{
  "terminal.integrated.profiles.osx": {
    "claude": {
      "path": "/usr/local/bin/claude",
      "args": ["--interactive"]
    }
  },
  "terminal.integrated.defaultProfile.osx": "claude"
}

// .vscode/tasks.json
{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Claude: Review Code",
      "type": "shell",
      "command": "claude",
      "args": ["Zrób code review pliku ${file}"],
      "presentation": {
        "reveal": "always",
        "panel": "new"
      }
    },
    {
      "label": "Claude: Add Tests",
      "type": "shell",
      "command": "claude",
      "args": ["Dodaj testy jednostkowe dla ${file}"],
      "presentation": {
        "reveal": "always"
      }
    },
    {
      "label": "Claude: Fix Errors",
      "type": "shell",
      "command": "claude",
      "args": ["Napraw błędy TypeScript w ${file}"],
      "presentation": {
        "reveal": "always"
      }
    }
  ]
}

// Keybindings
// keybindings.json
[
  {
    "key": "ctrl+shift+c",
    "command": "workbench.action.tasks.runTask",
    "args": "Claude: Review Code"
  }
]

# Cursor ma wbudowaną integrację z Claude
# Wystarczy skonfigurować API key

# 1. Otwórz Cursor Settings
# 2. Przejdź do "AI" → "Provider"
# 3. Wybierz "Claude" i wpisz API key
# 4. Ustaw model na claude-sonnet-4-5-20241022

# Korzystaj z Cmd+K (macOS) lub Ctrl+K (Windows)
# dla inline suggestions

-- lua/plugins/claude.lua
return {
  {
    "anthropics/claude.nvim",
    config = function()
      require("claude").setup({
        model = "claude-sonnet-4-5-20241022",
        keymap = {
          ask = "<leader>ca",
          review = "<leader>cr",
          refactor = "<leader>cf",
        },
        window = {
          position = "right",
          width = 80,
        }
      })
    end
  }
}

-- Użycie
-- <leader>ca - Zapytaj Claude o zaznaczony kod
-- <leader>cr - Code review bieżącego pliku
-- <leader>cf - Refaktoruj zaznaczony kod

# Aliasy dla .bashrc / .zshrc
alias cc="claude"
alias ccr="claude 'Zrób code review ostatniego commita'"
alias cct="claude 'Dodaj testy dla zmienionych plików'"
alias ccf="claude 'Napraw błędy ESLint w projekcie'"
alias ccd="claude 'Wyjaśnij co robi ten kod'"

# Funkcja do pipe'owania błędów
function claude-fix() {
  $@ 2>&1 | claude "Przeanalizuj te błędy i zaproponuj rozwiązanie"
}

# Użycie:
# claude-fix npm run build
# claude-fix pytest tests/

# Git hooks z Claude
# .git/hooks/pre-commit
#!/bin/bash
changed_files=$(git diff --cached --name-only --diff-filter=ACM)
if [ -n "$changed_files" ]; then
  echo "$changed_files" | claude "Sprawdź czy te pliki są gotowe do commita.
  Zwróć uwagę na:
  - Potencjalne bugi
  - Brakujące testy
  - Problemy z bezpieczeństwem"
fi

# .github/workflows/claude-review.yml
name: Claude Code Review

on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code

      - name: Run Code Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          # Pobierz listę zmienionych plików
          changed_files=$(git diff --name-only origin/main...HEAD)

          # Uruchom review
          for file in $changed_files; do
            if [[ -f "$file" ]]; then
              echo "Reviewing $file..."
              claude "Zrób code review pliku $file.
                      Sprawdź: bezpieczeństwo, wydajność, jakość kodu.
                      Zwróć wynik jako markdown." >> review.md
            fi
          done

      - name: Post Review Comment
        uses: actions/github-script@v7
        with:
          script: |
            const fs = require('fs');
            const review = fs.readFileSync('review.md', 'utf8');
            github.rest.issues.createComment({
              issue_number: context.issue.number,
              owner: context.repo.owner,
              repo: context.repo.repo,
              body: `## 🤖 Claude Code Review\n\n${review}`
            });

# .gitlab-ci.yml
stages:
  - review
  - test

claude-review:
  stage: review
  image: node:20
  before_script:
    - npm install -g @anthropic-ai/claude-code
  script:
    - |
      export ANTHROPIC_API_KEY=$CLAUDE_API_KEY
      git diff origin/main...HEAD --name-only | while read file; do
        if [ -f "$file" ]; then
          claude "Review $file for security and code quality" >> review.txt
        fi
      done
  artifacts:
    paths:
      - review.txt
    expire_in: 1 week
  only:
    - merge_requests

# Stwórz komponent z typami
claude "Stwórz komponent React <UserCard> z:
- Props: user (id, name, email, avatar, role)
- TypeScript interfaces
- Tailwind CSS styling
- Loading i error states
- Accessibility (ARIA labels)"

# Implementuj hook
claude "Stwórz custom hook useDebounce z:
- Generic type support
- Configurable delay
- Cleanup na unmount
- Testy w Jest"

# API endpoint
claude "Stwórz endpoint API POST /api/users z:
- Zod validation dla body
- Error handling z proper status codes
- TypeScript types
- Rate limiting"

# Analiza błędu
claude "Błąd: TypeError: Cannot read property 'map' of undefined
Plik: components/UserList.tsx:25
Kontekst: Komponent renderuje listę użytkowników z API
Znajdź przyczynę i zaproponuj fix"

# Debugging performance
claude "Komponent re-renderuje się zbyt często.
Przeanalizuj kod i znajdź:
- Niepotrzebne re-rendery
- Brakujące memoizacje
- Problemy z useEffect dependencies"

# Memory leak
claude "Wykryto memory leak w komponencie Dashboard.
Przeanalizuj:
- Event listenery
- Subscriptions
- Async operations
- Cleanup functions"

# Refaktoring do hooks
claude "Przekształć ten class component na functional z hooks.
Zachowaj:
- Całą funkcjonalność
- Lifecycle behavior
- State management
Dodaj TypeScript types"

# Extract component
claude "Wyodrębnij logikę formularza z tego komponentu do:
- Custom hook useContactForm
- Komponent ContactFormFields
- Validation schema z Zod"

# SOLID principles
claude "Zrefaktoruj ten kod zgodnie z SOLID:
- Single Responsibility - rozdziel odpowiedzialności
- Open/Closed - użyj abstrakcji
- Dependency Inversion - wstrzyknij zależności"

# JSDoc
claude "Dodaj kompletne JSDoc komentarze do wszystkich
eksportowanych funkcji w src/utils/.
Uwzględnij: @param, @returns, @throws, @example"

# README
claude "Wygeneruj README.md dla tego projektu z:
- Opis projektu
- Tech stack
- Instalacja
- Użycie
- API reference
- Contributing guidelines"

# API docs
claude "Stwórz dokumentację OpenAPI/Swagger dla
wszystkich endpointów w src/app/api/"

# Przekaż tylko relevantne pliki
claude "W kontekście plików:
- src/components/Auth/LoginForm.tsx
- src/hooks/useAuth.ts
- src/lib/auth.ts
Dodaj obsługę 2FA"

# Użyj kontekstu z git
git diff HEAD~3 | claude "Podsumuj te zmiany i sprawdź czy
nie ma breaking changes"

# Przekaż strukturę projektu
tree -I node_modules -L 3 | claude "Mając tę strukturę,
zaproponuj gdzie dodać nowy moduł notifications"

# Session management
claude --session my-feature  # Nazwana sesja
claude --continue           # Kontynuuj ostatnią
claude --history 10         # Pokaż ostatnie 10 sesji

# Tryb watch
claude --watch "Obserwuj pliki *.ts i naprawiaj
błędy TypeScript na bieżąco"

# Batch operations
find src -name "*.tsx" -exec claude "Dodaj data-testid
do wszystkich interaktywnych elementów w {}" \;

# Parallel execution
parallel claude ::: \
  "Dodaj testy do UserService" \
  "Dodaj testy do ProductService" \
  "Dodaj testy do OrderService"

# Stack trace analysis
cat error.log | claude "Przeanalizuj ten stack trace i:
1. Zidentyfikuj root cause
2. Zaproponuj fix
3. Dodaj error handling żeby to się nie powtórzyło"

# Network debugging
curl -v https://api.example.com/endpoint 2>&1 | claude \
  "Przeanalizuj ten request/response.
   Dlaczego dostaję 403?"

# Performance profiling
node --prof app.js
node --prof-process isolate-*.log | claude \
  "Przeanalizuj ten profil. Gdzie są bottlenecki?"

# Projekt: Migracja 50k linii JavaScript do TypeScript

# Krok 1: Analiza
claude "Przeanalizuj projekt i stwórz plan migracji
do TypeScript. Zidentyfikuj:
- Pliki do migracji (od najprostszych)
- Współdzielone typy do wyodrębnienia
- Potencjalne problemy"

# Krok 2: Setup
claude "Skonfiguruj TypeScript z:
- Strict mode
- Path aliases
- ESLint z typescript-eslint"

# Krok 3: Migracja iteracyjna
for file in $(find src -name "*.js" | head -10); do
  claude "Przekonwertuj $file na TypeScript.
          Dodaj pełne typy, nie używaj any."
done

# Wynik: 2 tygodnie zamiast szacowanych 2 miesięcy

# Projekt: Przeprojektowanie REST API do GraphQL

# Analiza istniejących endpointów
claude "Przeanalizuj wszystkie endpointy w src/api/
i stwórz schemat GraphQL z:
- Types dla wszystkich entities
- Queries i Mutations
- Resolvers structure"

# Generowanie schematu
claude "Na podstawie analizy, wygeneruj:
- schema.graphql
- TypeScript types z graphql-codegen
- Podstawowe resolvers"

# Migracja klientów
claude "Stwórz migration guide dla klientów API
pokazujący mapowanie REST → GraphQL"

# Błąd: "Context too long"
# Rozwiązanie: Ogranicz kontekst
claude --max-context 50000 "Twoje zadanie..."

# Błąd: "Rate limit exceeded"
# Rozwiązanie: Użyj backoff
claude --retry 3 --retry-delay 5000 "Twoje zadanie..."

# Błąd: "File not found"
# Rozwiązanie: Użyj pełnych ścieżek
claude "Edytuj $(pwd)/src/components/Button.tsx"

# Błąd: "Permission denied"
# Rozwiązanie: Sprawdź uprawnienia
chmod +x $(which claude)
sudo chown -R $USER ~/.config/claude-code

# Błąd: "Invalid API key"
# Rozwiązanie: Sprawdź zmienną środowiskową
echo $ANTHROPIC_API_KEY
claude --check-auth

# .claudeignore - pliki do ignorowania
node_modules/
dist/
build/
.git/
*.log
*.lock
coverage/

# Użyj workspace mode dla monorepo
claude --workspace packages/frontend "Twoje zadanie..."

# Incremental context
claude --include-changed "Od ostatniego commita,
zaktualizuj dokumentację"

everything-claude-code/
├── docs/                    # Documentation and guides
│   ├── getting-started/    # Getting started guide
│   ├── configuration/      # Claude Code configuration
│   ├── best-practices/     # Best practices
│   ├── troubleshooting/    # Troubleshooting
│   └── advanced/           # Advanced techniques
├── examples/               # Example projects
│   ├── nextjs-app/        # Next.js example
│   ├── python-api/        # Python API example
│   ├── cli-tool/          # CLI tool example
│   └── fullstack/         # Fullstack example
├── templates/              # CLAUDE.md templates
│   ├── frontend/          # For frontend projects
│   ├── backend/           # For backend projects
│   ├── mobile/            # For mobile applications
│   └── monorepo/          # For monorepos
├── integrations/           # Tool integrations
│   ├── vscode/            # VS Code extension
│   ├── cursor/            # Cursor integration
│   ├── neovim/            # Neovim setup
│   └── cicd/              # CI/CD pipelines
├── prompts/                # Collection of effective prompts
│   ├── coding/            # Coding prompts
│   ├── debugging/         # Debugging prompts
│   ├── refactoring/       # Refactoring prompts
│   └── documentation/     # Documentation prompts
└── community/              # Community materials
    ├── tips-tricks/       # User tips
    ├── workflows/         # Proven workflows
    └── case-studies/      # Case studies

# Install Claude Code
# macOS / Linux
curl -fsSL https://claude.ai/install.sh | sh

# or via npm
npm install -g @anthropic-ai/claude-code

# Verify installation
claude --version

# First session
claude

# With a specific task
claude "Create an email validation function in TypeScript"

# Set the API key
export ANTHROPIC_API_KEY="your-api-key-here"

# Alternatively, use a configuration file
mkdir -p ~/.config/claude-code
cat > ~/.config/claude-code/config.json << 'EOF'
{
  "model": "claude-sonnet-4-5-20241022",
  "maxTokens": 8192,
  "temperature": 0.7,
  "autoSave": true,
  "gitIntegration": true
}
EOF

# Project: My Awesome App

## Tech Stack
- Next.js 15 (App Router)
- TypeScript 5.x (strict mode)
- Tailwind CSS 3.x
- Prisma ORM + PostgreSQL
- NextAuth.js for authentication

## Project Structure

## Coding Conventions
- Use functional components with hooks
- Prefer server components where possible
- Keep components under 150 lines
- Use TypeScript strict mode
- Follow Prettier formatting

## Important Files
- `prisma/schema.prisma` - Database schema
- `src/lib/auth.ts` - Authentication configuration
- `src/components/ui/` - Shared UI components

## Commands
- `npm run dev` - Start development server
- `npm run build` - Production build
- `npm run test` - Run tests
- `npm run lint` - Check for linting errors

# CLAUDE.md Best Practices

## 1. Be specific about the tech stack
Don't: "We use React"
Do: "Next.js 15 App Router with TypeScript 5.x in strict mode"

## 2. Describe the directory structure
Claude needs to understand the project organization
to effectively navigate and modify files.

## 3. Define coding conventions
- Naming style (camelCase, PascalCase)
- Preferred patterns (hooks vs classes)
- Formatting (Prettier, ESLint rules)

## 4. List key files
Point Claude to the most important files it should
know before making changes.

## 5. Document commands
List all npm scripts with descriptions of what they do.

## 6. Specify constraints
- Maximum file length
- Testing requirements
- Import rules

## 7. Update regularly
CLAUDE.md should evolve along with the project.

# Project initialization
claude "Create a new Next.js 15 project with:
- TypeScript
- Tailwind CSS
- Prisma + SQLite
- NextAuth with GitHub OAuth
- Basic directory structure"

# Claude will execute:
# 1. npx create-next-app@latest
# 2. Install dependencies
# 3. Configure Prisma
# 4. Add NextAuth
# 5. Create CLAUDE.md

# Create a FastAPI application
claude "Create a REST API in FastAPI with:
- CRUD endpoints for users
- SQLAlchemy + PostgreSQL
- JWT authentication
- Pydantic validation
- Swagger docs"

# Session 1: Project setup
$ claude
You: Initialize an e-commerce project with Next.js

# Session 2: Add functionality
$ claude --continue
You: Add a shopping cart with localStorage persistence

# Session 3: Payment integration
$ claude --continue
You: Integrate Stripe Checkout

# Session 4: Deployment
$ claude --continue
You: Configure deployment on Vercel with a production environment

// .vscode/settings.json
{
  "terminal.integrated.profiles.osx": {
    "claude": {
      "path": "/usr/local/bin/claude",
      "args": ["--interactive"]
    }
  },
  "terminal.integrated.defaultProfile.osx": "claude"
}

// .vscode/tasks.json
{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Claude: Review Code",
      "type": "shell",
      "command": "claude",
      "args": ["Review the file ${file}"],
      "presentation": {
        "reveal": "always",
        "panel": "new"
      }
    },
    {
      "label": "Claude: Add Tests",
      "type": "shell",
      "command": "claude",
      "args": ["Add unit tests for ${file}"],
      "presentation": {
        "reveal": "always"
      }
    },
    {
      "label": "Claude: Fix Errors",
      "type": "shell",
      "command": "claude",
      "args": ["Fix TypeScript errors in ${file}"],
      "presentation": {
        "reveal": "always"
      }
    }
  ]
}

// Keybindings
// keybindings.json
[
  {
    "key": "ctrl+shift+c",
    "command": "workbench.action.tasks.runTask",
    "args": "Claude: Review Code"
  }
]

# Cursor has built-in Claude integration
# You just need to configure the API key

# 1. Open Cursor Settings
# 2. Go to "AI" → "Provider"
# 3. Select "Claude" and enter the API key
# 4. Set the model to claude-sonnet-4-5-20241022

# Use Cmd+K (macOS) or Ctrl+K (Windows)
# for inline suggestions

-- lua/plugins/claude.lua
return {
  {
    "anthropics/claude.nvim",
    config = function()
      require("claude").setup({
        model = "claude-sonnet-4-5-20241022",
        keymap = {
          ask = "<leader>ca",
          review = "<leader>cr",
          refactor = "<leader>cf",
        },
        window = {
          position = "right",
          width = 80,
        }
      })
    end
  }
}

-- Usage
-- <leader>ca - Ask Claude about selected code
-- <leader>cr - Code review of the current file
-- <leader>cf - Refactor selected code

# Aliases for .bashrc / .zshrc
alias cc="claude"
alias ccr="claude 'Do a code review of the last commit'"
alias cct="claude 'Add tests for changed files'"
alias ccf="claude 'Fix ESLint errors in the project'"
alias ccd="claude 'Explain what this code does'"

# Function for piping errors
function claude-fix() {
  $@ 2>&1 | claude "Analyze these errors and suggest a solution"
}

# Usage:
# claude-fix npm run build
# claude-fix pytest tests/

# Git hooks with Claude
# .git/hooks/pre-commit
#!/bin/bash
changed_files=$(git diff --cached --name-only --diff-filter=ACM)
if [ -n "$changed_files" ]; then
  echo "$changed_files" | claude "Check if these files are ready to commit.
  Pay attention to:
  - Potential bugs
  - Missing tests
  - Security issues"
fi

# .github/workflows/claude-review.yml
name: Claude Code Review

on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code

      - name: Run Code Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          # Get the list of changed files
          changed_files=$(git diff --name-only origin/main...HEAD)

          # Run review
          for file in $changed_files; do
            if [[ -f "$file" ]]; then
              echo "Reviewing $file..."
              claude "Do a code review of the file $file.
                      Check: security, performance, code quality.
                      Return the result as markdown." >> review.md
            fi
          done

      - name: Post Review Comment
        uses: actions/github-script@v7
        with:
          script: |
            const fs = require('fs');
            const review = fs.readFileSync('review.md', 'utf8');
            github.rest.issues.createComment({
              issue_number: context.issue.number,
              owner: context.repo.owner,
              repo: context.repo.repo,
              body: `## 🤖 Claude Code Review\n\n${review}`
            });

# .gitlab-ci.yml
stages:
  - review
  - test

claude-review:
  stage: review
  image: node:20
  before_script:
    - npm install -g @anthropic-ai/claude-code
  script:
    - |
      export ANTHROPIC_API_KEY=$CLAUDE_API_KEY
      git diff origin/main...HEAD --name-only | while read file; do
        if [ -f "$file" ]; then
          claude "Review $file for security and code quality" >> review.txt
        fi
      done
  artifacts:
    paths:
      - review.txt
    expire_in: 1 week
  only:
    - merge_requests

# Create a component with types
claude "Create a React component <UserCard> with:
- Props: user (id, name, email, avatar, role)
- TypeScript interfaces
- Tailwind CSS styling
- Loading and error states
- Accessibility (ARIA labels)"

# Implement a hook
claude "Create a custom hook useDebounce with:
- Generic type support
- Configurable delay
- Cleanup on unmount
- Tests in Jest"

# API endpoint
claude "Create an API endpoint POST /api/users with:
- Zod validation for the body
- Error handling with proper status codes
- TypeScript types
- Rate limiting"

# Error analysis
claude "Error: TypeError: Cannot read property 'map' of undefined
File: components/UserList.tsx:25
Context: The component renders a list of users from the API
Find the cause and suggest a fix"

# Performance debugging
claude "The component re-renders too frequently.
Analyze the code and find:
- Unnecessary re-renders
- Missing memoizations
- Problems with useEffect dependencies"

# Memory leak
claude "A memory leak was detected in the Dashboard component.
Analyze:
- Event listeners
- Subscriptions
- Async operations
- Cleanup functions"

# Refactoring to hooks
claude "Convert this class component to a functional one with hooks.
Preserve:
- All functionality
- Lifecycle behavior
- State management
Add TypeScript types"

# Extract component
claude "Extract the form logic from this component into:
- A custom hook useContactForm
- A ContactFormFields component
- A validation schema with Zod"

# SOLID principles
claude "Refactor this code following SOLID:
- Single Responsibility - separate concerns
- Open/Closed - use abstractions
- Dependency Inversion - inject dependencies"

# JSDoc
claude "Add complete JSDoc comments to all
exported functions in src/utils/.
Include: @param, @returns, @throws, @example"

# README
claude "Generate a README.md for this project with:
- Project description
- Tech stack
- Installation
- Usage
- API reference
- Contributing guidelines"

# API docs
claude "Create OpenAPI/Swagger documentation for
all endpoints in src/app/api/"

# Pass only relevant files
claude "In the context of the files:
- src/components/Auth/LoginForm.tsx
- src/hooks/useAuth.ts
- src/lib/auth.ts
Add 2FA support"

# Use context from git
git diff HEAD~3 | claude "Summarize these changes and check
for breaking changes"

# Pass the project structure
tree -I node_modules -L 3 | claude "Given this structure,
suggest where to add a new notifications module"

# Session management
claude --session my-feature  # Named session
claude --continue           # Continue the last one
claude --history 10         # Show the last 10 sessions

# Watch mode
claude --watch "Watch *.ts files and fix
TypeScript errors on the fly"

# Batch operations
find src -name "*.tsx" -exec claude "Add data-testid
to all interactive elements in {}" \;

# Parallel execution
parallel claude ::: \
  "Add tests for UserService" \
  "Add tests for ProductService" \
  "Add tests for OrderService"

# Stack trace analysis
cat error.log | claude "Analyze this stack trace and:
1. Identify the root cause
2. Suggest a fix
3. Add error handling to prevent this from happening again"

# Network debugging
curl -v https://api.example.com/endpoint 2>&1 | claude \
  "Analyze this request/response.
   Why am I getting a 403?"

# Performance profiling
node --prof app.js
node --prof-process isolate-*.log | claude \
  "Analyze this profile. Where are the bottlenecks?"

# Project: Migrating 50k lines of JavaScript to TypeScript

# Step 1: Analysis
claude "Analyze the project and create a migration plan
to TypeScript. Identify:
- Files to migrate (starting with the simplest)
- Shared types to extract
- Potential issues"

# Step 2: Setup
claude "Configure TypeScript with:
- Strict mode
- Path aliases
- ESLint with typescript-eslint"

# Step 3: Iterative migration
for file in $(find src -name "*.js" | head -10); do
  claude "Convert $file to TypeScript.
          Add full types, do not use any."
done

# Result: 2 weeks instead of the estimated 2 months

# Project: Redesigning REST API to GraphQL

# Analyze existing endpoints
claude "Analyze all endpoints in src/api/
and create a GraphQL schema with:
- Types for all entities
- Queries and Mutations
- Resolvers structure"

# Generate the schema
claude "Based on the analysis, generate:
- schema.graphql
- TypeScript types with graphql-codegen
- Basic resolvers"

# Client migration
claude "Create a migration guide for API clients
showing the REST → GraphQL mapping"

# Error: "Context too long"
# Solution: Limit the context
claude --max-context 50000 "Your task..."

# Error: "Rate limit exceeded"
# Solution: Use backoff
claude --retry 3 --retry-delay 5000 "Your task..."

# Error: "File not found"
# Solution: Use full paths
claude "Edit $(pwd)/src/components/Button.tsx"

# Error: "Permission denied"
# Solution: Check permissions
chmod +x $(which claude)
sudo chown -R $USER ~/.config/claude-code

# Error: "Invalid API key"
# Solution: Check the environment variable
echo $ANTHROPIC_API_KEY
claude --check-auth

# .claudeignore - files to ignore
node_modules/
dist/
build/
.git/
*.log
*.lock
coverage/

# Use workspace mode for monorepos
claude --workspace packages/frontend "Your task..."

# Incremental context
claude --include-changed "Since the last commit,
update the documentation"