{ "spinnerVerbs": { "mode": "replace", "verbs": [ "Analyzing…", "Thinking…", "Hacking…", "Spellcasting…", "Overthinking…", "Caffeinating…", "Rubber ducking…", "Hallucinating responsibly…", "Reading the docs…", "Pretending to know…", "Indexing…", "Refactoring…", "Debugging…", "Git blaming…", "Stack overflowing…", "Consulting the oracle…", "Writing tests nobody will read…", "Ignoring the linter…", "Compiling excuses…" ] }, "spinnerTipsOverride": { "excludeDefault": true, "tips": [ "── CONTEXT MANAGEMENT ──────────────────────────────", "Context >70%? Run /compact now — don't wait for slowdowns", "Context >90%? /clear for a fresh start — context is not precious", "Watch Ctx(u): in statusline — it's your most important metric", "/status shows context usage + session cost at any time", "/compact summarizes the conversation and keeps key decisions", "After /compact, re-state your current task so Claude stays aligned", "Ctrl+L clears the screen but keeps the full context intact", "── KEYBOARD SHORTCUTS ──────────────────────────────", "Shift+Tab cycles permission modes: Default → AcceptEdits → Plan → back", "Shift+Tab × 2 enters Plan Mode — no files touched until you approve", "Esc × 2 rewinds the last action — your undo button", "Alt+T toggles thinking on/off mid-session — disable for simple tasks", "Ctrl+R searches your command history interactively", "Shift+Enter adds a new line without submitting the prompt", "Ctrl+B opens background tasks panel", "Ctrl+C interrupts Claude mid-response — use before it writes the wrong file", "── PROMPTING FORMULA ───────────────────────────────", "Formula: WHAT (deliverable) / WHERE (file paths) / HOW (constraints) / VERIFY (success criteria)", "Bad: 'fix the bug'. Good: 'Fix null check in src/auth.ts:142, HOW: add early return, VERIFY: test passes'", "Use @file.ts to reference a specific file in your prompt", "Use @agent-name to call a custom agent directly", "Use !command to run a shell command inline and include its output", "Negative constraints alone don't work — always give an alternative", "Vague prompts = vague output. One concrete deliverable per prompt.", "── MODEL SELECTION ─────────────────────────────────", "Haiku: boilerplate, renames, simple fixes — fast & cheap", "Sonnet: feature dev, debugging, refactoring — your daily driver", "Opus: architecture decisions, security audits, complex reasoning", "OpusPlan: /model opusplan — Opus plans, Sonnet executes (best cost/quality ratio)", "Opus thinking is ON by default at max budget — 'think hard' is cosmetic", "Alt+T disables thinking → faster responses on simple tasks, real savings", "Swap models on task boundaries, not mid-implementation (context loss)", "/model haiku for lint/typo tasks, Opus only when depth truly matters", "── PLAN MODE & THINKING ────────────────────────────", "Plan Mode = read-only exploration. Nothing written until you approve.", "Use Plan Mode before any task touching >3 files or production systems", "Shift+Tab × 2 → state the task → review plan → Shift+Tab to execute", "/plan enters Plan Mode, /execute exits it", "In Plan Mode, Claude can read, search, analyze — but not write or edit", "OpusPlan workflow: plan with Opus (deep reasoning) → execute with Sonnet (speed)", "── FILE REFERENCES & MEMORY ────────────────────────", "CLAUDE.md at project root = team memory. Commit it. Keep it short.", "~/.claude/CLAUDE.md = your personal global instructions across all projects", "settings.json (committed) = team hooks. settings.local.json (gitignored) = your permissions.", ".claude/agents/ — define reusable AI personas for specialized tasks", ".claude/commands/ — build slash commands for repetitive workflows", ".claude/skills/ — preloaded knowledge modules injected into agent context", ".claude/hooks/ — shell scripts that run on tool events (PreToolUse, PostToolUse…)", "── GOLDEN RULES ────────────────────────────────────", "Golden Rule #1: Always read the diff before accepting any change", "Golden Rule #2: /compact before context hits 70% — not after", "Golden Rule #3: Be specific — WHAT, WHERE, HOW, VERIFY every time", "Golden Rule #4: Plan Mode first for complex or risky tasks", "Golden Rule #5: Create CLAUDE.md for every project you care about", "Golden Rule #6: Commit frequently — after each completed task, not at end of day", "Golden Rule #7: Know what's sent to Anthropic — prompts, files, MCP results", "── MCP SERVERS ─────────────────────────────────────", "Context7 MCP: official library docs on demand — no more hallucinated APIs", "Sequential MCP: structured multi-step reasoning for complex debugging", "Serena MCP: semantic code indexing + persistent memory across sessions", "grepai MCP: semantic search by intent — 'payment flow' finds it without grep", "Playwright MCP: browser automation built into Claude's tool chain", "/mcp shows the status of all connected MCP servers", "── TASK MANAGEMENT ─────────────────────────────────", "Tasks API (v2.1.16+): persistent task lists with dependencies across sessions", "export CLAUDE_CODE_TASK_LIST_ID=project-name → tasks survive /compact and /clear", "TaskCreate → TaskUpdate(in_progress) → TaskUpdate(completed) — the lifecycle", "TaskGet(id) for full description — TaskList shows summary only", "Store key context in task subject — it's visible in TaskList without fetching", "Agent Teams (v2.1.32+): spawn parallel sub-agents with TeamCreate/SendMessage", "── CI/CD & AUTOMATION ──────────────────────────────", "claude -p 'query' for non-interactive mode — perfect for CI pipelines", "claude -p --output-format json for structured output in scripts", "claude -p --model haiku --dangerously-skip-permissions for automated fixes", "--max-budget-usd 5.00 caps spending in print mode — use in CI", "Hooks run as shell scripts — exit 0 to continue, exit 2 to block the action", "── COST OPTIMIZATION ───────────────────────────────", "Most tasks: Sonnet. Architecture: Opus. Boilerplate: Haiku. Don't overpay.", "OpusPlan pays Opus only for planning (~10-20% of tokens) — Sonnet does the rest", "Thinking disabled = faster + cheaper. Enable only when depth matters.", "/insights shows your usage analytics and cost breakdown by session", "RTK (Rust Token Killer): 60-90% token reduction on CLI operations — brew install rtk-ai/tap/rtk", "── DEBUGGING & HEALTH ──────────────────────────────", "claude doctor — built-in diagnostic for common setup issues", "claude --debug — verbose mode showing all tool calls and API requests", "claude --mcp-debug — debug MCP server connections specifically", "/debug inside Claude triggers a systematic troubleshooting checklist", "Hook blocking? Check exit code: 0=continue, 2=block, anything else=continue", "MCP not working? claude mcp list to verify server registration", "── REMOTE & MOBILE ─────────────────────────────────", "Remote Control (v2.1.51+, Pro/Max): /rc or claude remote-control → QR code", "Press spacebar after /rc to show the QR code for phone scanning", "/mobile shows App Store + Play Store links for the Claude mobile app", "tmux + multiple panes = multiple independent Claude sessions in parallel", "Remote Control limitation: slash commands (/compact) must run from local terminal", "── GIT WORKTREES ───────────────────────────────────", "git worktree add ../project-feat feat — isolated branch, no stashing needed", "Multiple Claude instances on different worktrees = true parallel feature dev", "Rule: one worktree per task — never mix features in the main workspace", "Worktrees don't share stash or index — commit before switching back to main", "Clean up after merge: git worktree remove ../project-feat (then git branch -d feat)", "using-git-worktree skill automates setup + safety checks — /using-git-worktree", "── SECURITY & PERMISSIONS ──────────────────────────", "Default mode: every tool requires approval. AcceptEdits: file edits auto-approved.", "--dangerously-skip-permissions skips ALL confirmations — CI/CD only, never interactive", "settings.json (committed) = team-wide permissions. settings.local.json (gitignored) = yours.", "Review .claude/ before trusting a project — hooks run as shell scripts on your machine", "Claude can read your .env — check what's in context before sharing or logging sessions", "Scope your CLAUDE.md with explicit constraints to limit what Claude does autonomously", "── HOOKS (ADVANCED) ────────────────────────────────", "PreToolUse: intercept before execution — block dangerous commands, validate inputs", "PostToolUse: react after execution — auto-format, notify, log tool usage", "exit 2 from a hook = blocked with message shown to Claude. exit 0 = continue.", "Hook env vars: CLAUDE_TOOL_NAME and CLAUDE_TOOL_INPUT available in every hook script", "Cost guard pattern: PreToolUse on Read checks file size, warns before loading large files", "Chain hooks: block rm -rf on Bash (PreToolUse) + run linter on Write (PostToolUse)", "── CUSTOM AGENTS ───────────────────────────────────", ".claude/agents/agent-name.md — persona + tools injected when @agent-name is called", "Agent frontmatter: name, description, tools (whitelist), system prompt — that's it", "Specialized agents outperform generalist Claude on focused tasks (security, docs, tests)", "Limit tools per agent: a doc-writer agent doesn't need Bash, a reviewer doesn't need Write", "Security reviewer pattern: read-only tools (Read, Grep, Glob) + security-focused prompt", "subagent_type in Agent tool call selects which agent handles a delegated subtask", "── RESOURCES & TOOLS ───────────────────────────────", "Full guide (20K lines): cc.bruniaux.com/guide — search before asking Claude", "Whitepapers FR+EN (9 PDFs): florian.bruniaux.com/guides — focused deep dives", "RTK — 60-90% token reduction on CLI ops: rtk-ai.app — brew install rtk-ai/tap/rtk", "ccusage — daily cost tracking & reports: bunx ccusage daily", "ccstatusline — enriched statusline with context%/cost: npx -y ccstatusline@latest", "ccboard — TUI/Web dashboard for session economics: /ccboard skill inside Claude", "claude-code-viewer — browse session history: npx @kimuson/claude-code-viewer", "CHANGELOG.md on GitHub — read it weekly, every feature is documented there", "claude doctor — run this first when something breaks, before debugging manually", "DeepWiki — AI-indexed version of this guide: deepwiki.com/FlorianBruniaux/claude-code-ultimate-guide" ] } }