Troubleshooting Guides
A curated collection of 5 troubleshooting guides for building with AI coding agents.
Claude Code Troubleshooting: Fixes for the Most Common Problems
Fixes for the Claude Code problems people actually hit — install and auth failures, context-limit errors, MCP servers that won't connect, permission loops.
Claude Skills Not Working? Fixes for Every Failure Mode
Skill missing from the / menu, never auto-triggering, firing too often, or breaking mid-run — the symptom-by-symptom fix list for Claude skills.
Why Your Agent Loops: Debugging AI Agents
The recurring agent failure modes — loops, premature victory, tool misuse, context poisoning, scope creep — diagnosed by their signatures, with fixes.
MCP Troubleshooting: Server Won't Connect & Other Fixes
Fixes for the MCP problems people actually hit — servers failing to connect, missing tools, OAuth loops, timeouts, truncated output, and Windows quirks.
Why RAG Fails: A Debugging Checklist
A diagnostic checklist for broken RAG — localize the failure to ingestion, retrieval, ranking, or generation, and apply the fix that matches, in order.