Claude Code
44 items across foundations, the built-in tool surface, engineering workflows, customization (slash commands, hooks, sub-agents, the Agent SDK), and integrations (MCP, IDEs, GitHub). Each kind follows a consistent H2 template so writeups are scannable across topics.
Foundations
10 items What Claude Code is, how its conversation loop works, and the small set of concepts (CLAUDE.md, permission modes, plan mode, context) that change everything downstream.
Foundations
10 items- What Is Claude Code?
An agentic coding tool, not a chat box. How Claude Code differs from a code-completion assistant and from a raw chat model.
Concept Foundational - Installation and First Run
Installing the CLI, signing in, picking a model, and running your first conversation against a repository.
Concept Foundational - The Conversation Loop
How Claude Code reads, plans, calls tools, and emits text — the loop that makes everything else make sense.
Concept Foundational - Context Window and Token Budget
What lives in context, what gets summarized, what falls out — and how to plan a long session so the model still has what it needs.
Concept Intermediate - CLAUDE.md and Memory Files
Project-scoped instructions, auto-loaded memory, and the per-user memory system. The highest-leverage customization point.
Feature Foundational - Permission Modes
Default, accept-edits, plan, bypass — what each mode allows, when to use it, and how it interacts with allowlists.
Concept Foundational - Plan Mode
Read-only research mode for designing changes before touching the codebase. When to enter, how to write a good plan, when to exit.
Feature Foundational - Advanced Prompting Strategies
Specificity, examples, role/context priming, anti-patterns. How to phrase a task so Claude Code does it well the first time.
Concept Intermediate - Claude Code Best Practices — A Checklist
The consolidated playbook. The 15 highest-leverage habits, with cross-links to the writeups they expand on.
Concept Foundational - Settings and Configuration
settings.json layers (user, project, local), env vars, model selection, and the configuration precedence rules.
Feature Foundational
Tools & Features
11 items The built-in surface — file tools, Bash, search, Task, web, slash commands, skills, sub-agents, hooks, status line. The reference for what's already there.
Tools & Features
11 items- File Tools — Read, Edit, Write
The three primary file tools. When to use each, the read-before-edit invariant, and why Edit is preferred over Write for existing files.
Feature Foundational - The Bash Tool
Running shell commands, persistent working directory, parallel execution, background jobs, and the sandbox model.
Feature Foundational - Search Tools — Grep and Glob
Fast targeted search across the repository. When to prefer Grep over Bash-ripgrep, when to delegate broader searches to an Explore agent.
Feature Foundational - The Task Tool — Background Work
Running long operations in the background, getting notified on completion, and the no-polling rule that makes this fast.
Feature Intermediate - WebFetch and WebSearch
Pulling content from a URL or searching the web from inside a session. Caching, content extraction, and where the limits sit.
Feature Foundational - TodoWrite and Task Management
The built-in task list. When to use it, when not to, and how it interacts with sub-agent task tracking.
Feature Foundational - Slash Commands
Built-in slash commands (/help, /clear, /loop, /ultrareview, /schedule), and the ones you'll use most as a daily driver.
Feature Foundational - Skills — User-Invocable Workflows
Bundled prompt + tool + instruction packages that Claude Code can invoke. How they differ from sub-agents and custom slash commands.
Feature Intermediate - Sub-Agents
Specialised agents (Explore, Plan, claude-code-guide, general-purpose). Parallel and isolated execution, when to delegate, and context-window protection.
Feature Intermediate - Hooks Overview
Event-driven shell hooks that fire on tool calls and prompt submission. The four event types and where each one is the right tool.
Feature Intermediate - The Status Line
Customising the always-visible status line — model, branch, token usage, custom indicators. Useful for long sessions.
Feature Intermediate
Workflows
9 items Patterns for using Claude Code across real engineering tasks — conversation-driven dev, TDD, bug hunts, refactors, code review, long sessions, headless mode.
Workflows
9 items- Conversation-Driven Development
The core workflow: state intent, watch Claude propose, accept or redirect. Why this beats prompt-and-hope.
Workflow Foundational - Guiding the Conversation Mid-Task
When to interrupt, when to let it cook, how to course-correct without scrapping context. The Esc-then-corrected-message rhythm.
Workflow Intermediate - Test-Driven Development with Claude Code
Writing tests first, letting Claude implement against them, and the feedback loop that makes it reliable on non-trivial features.
Workflow Intermediate - Bug Hunting and Root-Cause Analysis
Reproducing, isolating, root-causing, fixing, and writing the regression test. The structured loop for not-just-making-it-go-away.
Workflow Intermediate - Refactoring with Claude Code
Small refactors, large refactors, and the heuristics for when to split into a series of PRs versus one bundled change.
Workflow Intermediate - Code Review Workflow
Using Claude Code as a reviewer, getting a second opinion on a migration, and where /ultrareview fits in the cycle.
Workflow Intermediate - Long-Running Sessions and Context Management
How to run a multi-hour session without losing the thread. Summarisation, plan files, memory writes, and the cache-friendly cadence.
Workflow Advanced - Headless / Non-Interactive Mode
Running Claude Code in CI, in scripts, and in cron-style autonomous loops. JSON output, exit codes, and timeouts.
Workflow Advanced - Pair-Programming Patterns
Driver-navigator, ping-pong, and explain-as-you-go. How to keep yourself in the loop while Claude does the typing.
Workflow Foundational
Customization
8 items Reshaping Claude Code to your repo and team — custom slash commands, sub-agents, hooks, the Agent SDK, status line, and permission rules.
Customization
8 items- Writing Custom Slash Commands
Authoring a slash command from a markdown file. Argument handling, model selection, and team-shared command libraries.
Feature Intermediate - Custom Sub-Agents
Defining a sub-agent with a tool allowlist, a system prompt, and an invocation pattern. When a sub-agent beats a slash command.
Feature Intermediate - PreToolUse and PostToolUse Hooks
Intercepting and reacting to tool calls. Common patterns: linting after edits, logging Bash commands, blocking dangerous operations.
Feature Intermediate - UserPromptSubmit Hooks
Hooks that fire when the user submits a prompt. Use cases: redaction, secret-scrubbing, injecting context, audit logging.
Feature Intermediate - Building a Security Hook
End-to-end recipe for a hook that blocks dangerous commands and writes an audit log. The threat model and the test plan.
Workflow Advanced - The Claude Agent SDK
Programmatic Claude agents from Python or TypeScript. When the SDK beats the CLI, and how it shares conventions with Claude Code.
Feature Advanced - Custom Status Line
Authoring a status-line script. Reading session metadata, formatting output, and the refresh cadence.
Feature Intermediate - Permission Rules and Allowlists
Auto-approving safe Bash commands, denying risky ones, and the project-scoped allowlist file.
Feature Intermediate
Integrations
6 items Connecting Claude Code to external systems — MCP servers, IDE extensions, GitHub, and the first-party app MCPs (Slack, Gmail, Drive, Calendar).
Integrations
6 items- MCP Servers Overview
The Model Context Protocol. What MCP is, how Claude Code talks to MCP servers, and the difference between local and remote servers.
Integration Intermediate - Building an MCP Server
Writing a custom MCP server in TypeScript or Python. Tools, resources, prompts, and the JSON-RPC contract.
Integration Advanced - GitHub Integration
Using `gh` for issues, PRs, and reviews from inside Claude Code. The committing checklist and the PR-creation workflow.
Integration Foundational - VS Code Extension
Running Claude Code inside VS Code. Diagnostics, inline diffs, and the split between IDE and terminal sessions.
Integration Foundational - JetBrains Extension
Running Claude Code inside IntelliJ-family IDEs. Feature parity with VS Code and the IDE-specific affordances.
Integration Foundational - App MCPs — Slack, Gmail, Drive, Calendar
First-party MCP integrations to common SaaS apps. Auth flow, scope, and the privacy considerations before turning each one on.
Integration Foundational