aiwg/agentic/code/frameworks/ops-complete/templates/troubleshooting.md

Deployment tool and support utility for AI context. Copies agents, skills, commands, rules, and behaviors into the paths each AI platform reads (Claude Code, Codex, Copilot, Cursor, Warp, OpenClaw, and 6 more) so one source of truth works across 10 platfo

# Troubleshooting: {System/Service Name}

## Quick Reference
| Symptom | Jump To |
|---------|---------|
| {symptom 1} | [Section](#symptom-1) |
| {symptom 2} | [Section](#symptom-2) |

## Symptom 1: {Description}

### Diagnosis
```bash
# Check {what}
{diagnostic command}
```
**If output shows {pattern}:**
→ Go to [Fix A](#fix-a)

**If output shows {other pattern}:**
→ Go to [Fix B](#fix-b)

### Fix A: {Description}
```bash
{fix command}
```
**Verify:**
```bash
{verification command}
```

### Fix B: {Description}
```bash
{fix command}
```
**Verify:**
```bash
{verification command}
```

## Symptom 2: {Description}

### Diagnosis
```bash
# Check {what}
{diagnostic command}
```
**If output shows {pattern}:**
→ Go to [Fix C](#fix-c)

### Fix C: {Description}
```bash
{fix command}
```
**Verify:**
```bash
{verification command}
```

## Escalation
If none of the above resolves the issue:
1. Collect diagnostic bundle: `{command}`
2. Open issue: {repo}#new with label `area: {area}`
3. Attach diagnostic bundle

## Known Issues
| Issue | Workaround | Tracking |
|-------|-----------|----------|
| {known issue} | {workaround} | {issue link} |