# Workflow: Troubleshooting

## Intent Classification

**Triggers:** Errors, failures, unexpected behavior, debugging requests

## Fixed Output Format

```markdown
## Problem
[Symptom observed]

## Diagnosis
- Checked: [what was checked]
- Found: [what was found]

## Cause
[Root cause - trace to why, not just what]

## Fix
[What was changed]

## Validation
[How verified it's fixed]
```

## Tool Access Rules

1. **Inspect first** - logs, config, state before changing anything
2. **Reproduce** - understand the failure before fixing
3. **Trace to root** - fix cause, not symptom
4. **Document** - add to ISSUES.md if pattern

## Constraints

- NO: Restart-as-first-response
- NO: Regex patches without understanding root cause
- NO: Fixes without verification
- YES: Documented workaround if root cause blocked
- YES: Regression test if applicable