Workflow Debugging

Debug a Network Issue

Workflow for troubleshooting API call and network failures

debuggingnetworkapi
CLAUDE.md

When debugging a network issue:

  1. Check the HTTP status code and response body of the failed request.
  2. Verify the request URL, method, headers, and body are correct. Log the outgoing request.
  3. Test the endpoint independently with curl or a REST client to isolate whether the issue is in your code or the server.
  4. Check for CORS errors in the browser console.
  5. Check for SSL/TLS certificate issues.
  6. Check if the server is reachable: DNS resolution, firewall rules, VPN requirements.
  7. Check for timeout issues: is the server responding slowly? Is the timeout configured correctly?
  8. Check auth: is the token expired, missing, or malformed?

Copy this workflow into your CLAUDE.md or agent config file so your agent follows this process automatically.

get crystl