Everything Claude Code, zestaw konfiguracji dla agentów

ECC/                        # dawna nazwa: everything-claude-code
├── agents/                 # role agenta, blisko siedemdziesiąt katalogów
├── skills/                 # umiejętności, blisko trzysta katalogów
├── commands/               # gotowe polecenia, blisko sto pozycji
├── hooks/                  # haki uruchamiane przy zdarzeniach
├── rules/                  # reguły opisujące sposób pracy
├── workflows/              # złożone przepływy pracy
├── plugins/                # paczki wtyczek
├── scaffolds/              # szkielety projektów
├── mcp-configs/            # konfiguracje serwerów MCP
├── docs/                   # dokumentacja
├── examples/               # przykłady użycia
├── integrations/           # integracje z zewnętrznymi narzędziami
├── research/               # notatki badawcze autora
├── .claude/                # konfiguracja dla Claude Code
├── .cursor/ .codex/ .gemini/ .zed/   # to samo dla innych narzędzi
├── AGENTS.md CLAUDE.md RULES.md      # reguły czytane przez agenta
└── LICENSE                 # MIT

# 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"

# Logowanie do konta Anthropic
claude auth login

# Albo własny klucz API
export ANTHROPIC_API_KEY="your-api-key-here"

# Ustawienia leżą w ~/.claude/settings.json (globalne)
# albo w .claude/settings.json w repozytorium (wspólne dla zespołu)
mkdir -p ~/.claude
cat > ~/.claude/settings.json << 'EOF'
{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-5",
  "permissions": {
    "allow": ["Bash(npm run lint)", "Bash(npm run test *)"],
    "deny": ["Read(./.env)", "Read(./secrets/**)"]
  },
  "cleanupPeriodDays": 20
}
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 własny wybór modelu w ustawieniach edytora
# i nie korzysta z konfiguracji Claude Code.

# Claude Code uruchamiasz w Cursorze z wbudowanego terminala
# i spinasz z edytorem flagą --ide:
claude --ide

# To samo połączenie włącza polecenie /ide
# w trwającej już sesji.

# Anthropic nie wydaje wtyczki do Neovima - repozytorium
# anthropics/claude.nvim nie istnieje i zwraca błąd 404.
# Zostaje terminal obok edytora.

# Nowa sesja w katalogu projektu
claude

# Powrót do ostatniej sesji
claude --continue

# Wybór sesji z listy
claude --resume

# 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"

# Obsługa sesji
claude --continue           # kontynuacja ostatniej
claude --resume             # wybór sesji z listy
claude --fork-session       # rozgałęzienie od wskazanej sesji

# Przebieg bezobsługowy z limitem tur i budżetu
claude -p --max-turns 20 --max-budget-usd 5 "Twoje zadanie..."

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

# Parallel execution
parallel claude -p ::: \
  "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"

# Przepelniony kontekst
# Rozwiązanie: /compact albo /clear w trwającej sesji

# Błąd: "Rate limit exceeded"
# Rozwiązanie: model zapasowy na czas przeciążenia
claude --fallback-model claude-haiku-4-5

# Plik poza katalogiem sesji
# Rozwiązanie: dopisz katalog do sesji
claude --add-dir ../wspolne-typy

# Wątpliwości co do logowania albo instalacji
claude auth status
claude doctor

{
  "permissions": {
    "deny": [
      "Read(./dist/**)",
      "Read(./build/**)",
      "Read(./coverage/**)",
      "Read(./.env)"
    ],
    "additionalDirectories": ["../wspolne-typy"]
  }
}