Index — All essays
Writing
Practical essays on AI coding, agents, architecture, and shipping fast.
15 essays
/0123 minClaude Code
CLAUDE.md Best Practices: What the Evidence Supports (2026)
A study ran 1,650 sessions: the file's length, layout and contradictions changed nothing. Having one at all took Claude from 0 out of 524 to 67.7%. Plus six things the advice gets wrong.
/0212 minClaude Code
Claude Code Remote Control: What It Is, What It Isn't
Remote Control runs on your machine, not the cloud. How it differs from Channels and Dispatch, the env vars that silently disable it, and why sleep killed my sessions when the docs say it shouldn't.
/0316 minClaude Code
CLAUDE.md vs AGENTS.md: It's the Loader, Not the File
AGENTS.md is a filename with no schema and no conformance language. What differs between sixteen tools is discovery, precedence, and fallback. The table, plus a test of what Claude Code really loads.
/0417 minClaude Code
Why Your Claude Code Hook Isn't Firing (2026 Decision Tree)
Hooks hot-reload now, so a restart proves nothing. A symptom-first tree for silent hooks: whole-file config rejection, exit 1 vs exit 2, unanchored matchers, and bloat that slows every tool call.
/0512 minClaude Code
Best Terminal for Claude Code (I Ran Agents in Five of Them)
cmux, Ghostty, Warp, Herdr, tmux. The verdict splits by OS. Platform-by-platform breakdown with real friction from running Claude Code agents in all five.
/062 minMCP
The MCP OAuth Flow, Drawn: The Broker Pattern in One Diagram (2026)
An MCP server fronting GitHub runs two OAuth relationships, not one, and the client never holds your GitHub or Google token. The broker pattern in a single diagram, plus the wiring underneath it.
/077 minMCP
MCP Server Authentication in FastMCP: The End-to-End Version (2026)
OAuth on an MCP server is two jobs, not one. Token verification is passive, remote OAuth is active, and picking wrong means Claude Desktop won't connect. The FastMCP wiring, end to end.
/0814 minClaude Code
Amp vs Claude Code: Is It Worth Switching in 2026?
I ran Amp and Claude Code on the same Python task. Amp routes across models and shows parallel agents better. Both went blind on ruff. Here's the honest take.
/095 minClaude Code
Claude Code auto mode, explained (and when it beats --dangerously-skip-permissions)
Auto mode auto-approves everything and runs each action through a classifier. Bypass has two tripwires and nothing else. When each one wins, and why sandbox is the real answer for the bypass crowd.
/1014 minClaude Code
Claude Code vs Cursor: Which AI Coding Tool in 2026?
I tested Claude Code and Cursor side by side. Real results, honest verdict, and which AI coding tool actually ships faster in 2026.
/1110 minClaude Code
How to Use Claude Code: From First Install to Shipping Real Features (2026)
From install to autonomous agents in parallel worktrees with adversarial review. The patterns that separate engineers who ship with Claude Code from engineers who fight it.
/127 minClaude Code
Claude Code Pricing 2026: What the Credits Actually Cost
Anthropic changed Claude Code pricing in 2026. Here's how autonomous credits work, what you'll really pay, and whether it's worth it.
/1313 minClaude Code
Pi vs Claude Code: Which AI Coding Agent in 2026?
I ran Pi and Claude Code on the same real work for weeks. Where each one wins, what Pi's minimal harness exposes about your own setup, and the honest verdict on running both.
/142 minTools
Motion Primitives: A Shadcn for React Animations
Copy paste animated React components built on Motion and Tailwind CSS. MIT licensed, one dependency, and underrated.
/157 minSEO
SEO for Developers Is Mostly Wrong: 2026 Edition
Core Web Vitals thresholds, Next.js metadata, AI Overviews killing CTR, and a prompt to audit your own site.