Configurator Troubleshooting

Overview

This skill provides a systematic framework for diagnosing and fixing Configurator CLI failures. It covers error classification by exit code, drill-down patterns for partial failures, common error patterns with solutions, and a structured reporting format.

When to Use

• Any CLI command fails with a non-zero exit code
• User reports error messages from configurator
• Deployment completed with partial failures
• Debugging GraphQL errors or reference issues
• When NOT looking for the deployment workflow -- use configurator-workflow instead
• When NOT looking for JSON envelope structure -- use agent-output-parsing instead

Error Analysis Framework

Step 1: Gather Context via JSON Envelope