output-debug-workflow

name	output-debug-workflow
description	Debug Output SDK workflow issues. Use when user reports a workflow failing, erroring, hanging, producing wrong results, or asks to debug, troubleshoot, or investigate a workflow execution.

Your task is to systematically debug an Output SDK workflow issue in a local development environment.

The arguments the user provided describe the problem they're experiencing, and may include a specific workflow ID.

Use the todo tool to track your progress through the debugging process.

Debugging Process

Overview

Follow a systematic approach to identify and resolve workflow execution issues: verify infrastructure, gather evidence, analyze traces, and apply targeted fixes.

<pre_flight_check> EXECUTE: Claude Skill: output-meta-pre-flight </pre_flight_check>

<process_flow>

Step 1: Verify Services Running

Before debugging, confirm that all required services are operational. The output-services-check skill provides comprehensive guidance.

<verification_commands>

# Check Docker containers are running
docker ps | grep output

# Verify Output services respond
curl -s http://localhost:3001/health || echo "API not responding"

# Check Temporal UI is accessible
curl -s http://localhost:8080 > /dev/null && echo "Temporal UI accessible" || echo "Temporal UI not accessible"

</verification_commands>

<decision_tree> IF docker_not_running: RUN: docker compose up -d WAIT: for services to start (30-60 seconds) IF output_dev_not_running: RUN: npx output dev WAIT: for services to initialize IF all_services_running: PROCEED: to step 2 </decision_tree>

After applying fix: ```bash # Re-run the workflow to verify npx output workflow run --input ''