Troubleshooting

When to Activate This Skill

Activate this skill MANDATORY when:

• Encountering unexpected errors or behavior
• Something doesn't work as expected and the cause is unclear
• You're about to spend time debugging without a clear direction

How to Use This Skill

This skill acts as a diagnostic router to help you identify the type of issue and activate the appropriate specialized skill.

Validating Your Success Metrics

CRITICAL: Before you begin diagnosing a problem, you must establish what success looks like and verify that your measurement is actually valid.

An incorrectly defined success metric can create a phantom problem - you'll see a problem that doesn't exist and spend time "fixing" something that's already working correctly. This wastes effort and pollutes the codebase with unnecessary changes.