All Articles
Claude Keeps Saying 'Response Incomplete' — A Layered Troubleshooting Guide
Diagnose why Claude or Claude Code freezes with a 'Response incomplete' or 'Try stopping' message. Walk through the four layers where generation can stall and recover the session without losing context.
Three Minutes with /doctor: Catching Claude Code Config Drift Before It Costs You an Hour
When Claude Code acts up, the first thing to run is /doctor. It shows merged settings, MCP server status, and permission mode at a glance.
Write the Repro Test Before Delegating Bug Fixes to Claude Code
After watching Claude Code spin its wheels on ambiguous bug reports, I started writing the failing test myself before delegating. This post walks through the design principles, a concrete repro test, and the three-stage workflow I run in production.
Finishing Long-Running Claude Code Tasks: A Resilience Playbook You Can Ship
Multi-hour Claude Code jobs — bulk refactors, TypeScript migrations, mass test generation — always stop before they finish, and recovery is painful when you cannot tell what already ran. This guide ships concrete patterns: a checkpoint-driven manifest, a three-state circuit breaker, idempotent retry rules, and a freeze-and-resume protocol you can copy into your repo today.
Turning Claude Skills and Claude Code Plugins Into Products That Actually Sell
How to design, price, distribute, and improve Claude Skills and Claude Code Plugins as real products — with concrete patterns for packaging, billing, churn control, and knowing when to shut it down.
Safety Valves for Large Refactors with Claude Code — Designing Commit Granularity and Reversibility
Asking Claude Code to rewrite a whole module feels great — until you face a giant diff in review. Here are the commit granularity, reversibility, and verification loop tactics I've been using across client work and my own apps.
ANTHROPIC_API_KEY Not Loading? A Diagnostic Workflow for Claude Code Env Var Issues
You added ANTHROPIC_API_KEY to your shell config, but Claude Code still complains about a missing key. This is the five-minute diagnostic flow I actually use — shell quirks, GUI launches, settings.json, Docker — in the order that catches the most causes first.
Auto-Generating Conventional Commits with Claude Code — Letting it Infer Type and Scope from the Diff
Are your commit messages starting to look like a wall of update and fix? Here's a small, stable setup that lets Claude Code read your staged diff and turn it into proper Conventional Commits.
Stop Rewriting Code: Using Claude Code Plan Mode as a Real Design Phase
Claude Code's Plan Mode sounds unremarkable on paper, but treating it as a dedicated design phase dramatically reduces token spend and rework. Here's when to switch into it, the prompt template that produces useful plans, and the pitfalls I kept hitting.
Stabilizing Solo Revenue: A Customer Portfolio Playbook for Claude Code Consultants
After you have raised your rate, the next challenge is revenue volatility. A practical framework for solo Claude Code consultants to design a client portfolio that keeps monthly income predictable.
How to Read Claude Code Logs to Diagnose Issues Quickly
When Claude Code misbehaves, the logs almost always contain the answer. Here's how I structure log reading so that the time to diagnosis drops by half or more in real projects.
Tripling Your Consulting Rate with Claude Code: Proposals, Estimates, and Delivery Playbook
A practical guide for freelance engineers using Claude Code who want to rework their proposals, estimates, and delivery processes to justify meaningfully higher rates.