Issue Diagnosis and Resolution

Systematically diagnose and resolve issues in code, builds, deployments, or system behavior.

When to use

• Debugging errors and exceptions

• Investigating build failures

• Diagnosing performance issues

• Resolving deployment problems

• Tracing issues to root cause

Instructions

Usage

/sc:troubleshoot [issue] [--type bug|build|performance|deployment] [--trace]

Arguments

• issue

• Description of the problem or error message

• --type

• Issue category (bug, build, performance, deployment)

• --trace

• Enable detailed tracing and logging

• --fix

• Automatically apply fixes when safe

Execution

• Analyze issue description and gather initial context

• Identify potential root causes and investigation paths

• Execute systematic debugging and diagnosis

• Propose and validate solution approaches

• Apply fixes and verify resolution

Claude Code Integration

• Uses Read for error log analysis

• Leverages Bash for runtime diagnostics

• Applies Grep for pattern-based issue detection

• Maintains structured troubleshooting documentation