Everything Claude Code, an agent configuration set

ECC/                        # former name: everything-claude-code
├── agents/                 # agent roles, close to seventy directories
├── skills/                 # skills, close to three hundred directories
├── commands/               # ready made commands, close to a hundred
├── hooks/                  # hooks triggered by events
├── rules/                  # rules describing how to work
├── workflows/              # composed workflows
├── plugins/                # plugin bundles
├── scaffolds/              # project scaffolds
├── mcp-configs/            # MCP server configurations
├── docs/                   # documentation
├── examples/               # usage examples
├── integrations/           # integrations with external tools
├── research/               # the author's research notes
├── .claude/                # configuration for Claude Code
├── .cursor/ .codex/ .gemini/ .zed/   # the same for other tools
├── AGENTS.md CLAUDE.md RULES.md      # rules the agent reads
└── LICENSE                 # MIT

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

# Sign in to the Anthropic account
claude auth login

# Or use your own API key
export ANTHROPIC_API_KEY="your-api-key-here"

# Settings live in ~/.claude/settings.json (global)
# or in .claude/settings.json inside the repository (shared with the team)
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. 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 picks its model in the editor's own settings
# and does not read Claude Code configuration.

# Run Claude Code from Cursor's built-in terminal and
# attach it to the editor with the --ide flag:
claude --ide

# The same connection is available through the /ide
# command inside a running session.

# Anthropic ships no Neovim plugin - the repository
# anthropics/claude.nvim does not exist and returns a 404.
# What remains is a terminal beside the editor.

# A new session in the project directory
claude

# Back to the last session
claude --continue

# Pick a session from the list
claude --resume

# 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 handling
claude --continue           # continue the last one
claude --resume             # pick a session from the list
claude --fork-session       # branch off a chosen session

# Unattended run with a turn and budget cap
claude -p --max-turns 20 --max-budget-usd 5 "Your task..."

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

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

# Context overflowing
# Solution: /compact or /clear inside the running session

# Error: "Rate limit exceeded"
# Solution: a fallback model for the overloaded stretch
claude --fallback-model claude-haiku-4-5

# A file outside the session directory
# Solution: add the directory to the session
claude --add-dir ../shared-types

# Doubts about sign-in or the installation itself
claude auth status
claude doctor

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