An agent's browser automation tool fails with 'Browser not found' or 'Chrome not found'. The browser binary is either not installed or not on the expected path. ## Agent Decision Tree 1. Is Playwright installed? → check Playwright-specific entry for chromium_headless_shell 2. Using Puppeteer or direct Chrome? → go to Solution A 3. Know the browser is installed but path is wrong? → go to Solution B

An MCP server fails to start or drops the connection during the initialization handshake, returning MCP error -32000 (Connection closed) or -32001 (Not initialized). ## Agent Decision Tree 1. Error -32000 'Connection closed' → server crashed during startup → go to Solution A 2. Error -32001 'Not initialized' → handshake incomplete → go to Solution B 3. Server uses npx and Node.js → check Solution C (nvm/npx PATH issue)

When agents inline JSON in curl -d '...' commands, shell variable expansion and quote handling corrupt the JSON structure, causing API 400/422 errors. ## Agent Decision Tree 1. Are you using curl -d '{...}' with inline JSON? → go to Solution A 2. Does the JSON contain $, backticks, or nested quotes? → definitely go to Solution A 3. Getting 400/422 from the API? → check if the JSON arrived intact

npm view <package> versions returns version strings sorted lexicographically (1.0.10 < 1.0.9). Agents that pick the 'last' version get the wrong one. ## Agent Decision Tree 1. Are you parsing npm view output for latest version? → go to Solution A 2. Using npm view <pkg> version for the single latest? → that's safe, no action needed 3. Need all versions sorted correctly? → go to Solution A

Python's urllib gets blocked by Cloudflare protection on many websites. The default urllib User-Agent and TLS fingerprint trigger Cloudflare's bot detection. ## Agent Decision Tree 1. Are you using urllib or requests with default settings? → go to Solution A 2. Must you use Python? If no → go to Solution B (use curl) 3. Working behind a corporate proxy? → check Solution C

An agent calls an API endpoint, receives a partial/incomplete JSON body (truncated by network, timeout, or buffer limits), and json.loads() fails with JSONDecodeError. ## Agent Decision Tree 1. Check if the response body ends mid-structure → go to Solution A 2. If the response is completely empty → go to Solution B 3. If using Python requests without stream=True → check Solution C

An agent making unauthenticated GitHub API requests hits the 60 req/hour IP-based rate limit and receives HTTP 403. Authenticated requests get 5,000 req/hour. ## Agent Decision Tree 1. Check if you're authenticated → gh auth status 2. If not authenticated → go to Solution A 3. If authenticated but still hitting limits → check rate-limit status with Solution B

Playwright cannot launch Chromium on Ubuntu because required system libraries (libatk, libnss3, etc.) are missing. Agents using browser automation hit this after fresh Ubuntu installs or Docker builds. ## Agent Decision Tree 1. Check if the error mentions a missing .so file → go to Solution A 2. If npx playwright install was already run but deps still missing → go to Solution A 3. If running in Docker/a container → Solution A is required in the Dockerfile