# Runbook: [Issue Type]

**Last Updated:** [YYYY-MM-DD]
**Related Issues:** #[NUMBER]

---

## Symptoms

- [Observable symptom 1]
- [Observable symptom 2]
- Error pattern: `[error message regex]`

---

## Root Cause

[Brief description of what causes this issue]

---

## Resolution Steps

### Step 1: Diagnose
```bash
# Check [component]
[diagnostic command]
```

### Step 2: Verify
```bash
# Confirm [condition]
[verification command]
```

### Step 3: Fix
```bash
# Apply fix
[fix command or code]
```

### Step 4: Validate
```bash
# Verify resolution
[validation command]
```

---

## Prevention

- [ ] [Prevention measure 1]
- [ ] [Prevention measure 2]

---

## Metadata

```json
{
  "issue_type": "[type]",
  "severity": "[critical/high/medium/low]",
  "component": "[component]",
  "related_issues": ["#[NUMBER]"],
  "last_occurrence": "[YYYY-MM-DD]"
}
```
