# Known Failures

Root causes, recurring problems, and how they were resolved.

## Format

```markdown
# Failure-NNNN: <title>

Date: YYYY-MM-DD
Author: <agent>
Status: OPEN | RESOLVED | RECURRING
Severity: critical | high | medium | low
Component: <affected area>

## Symptom

<what was observed>

## Root Cause

<why it happened>

## Resolution

<how it was fixed, or "not yet resolved">

## Prevention

<what prevents recurrence — Toolsmith safeguard, test, documentation>

## Related

- <links to related lessons, decisions, or failures>
```

## Index

_No failures recorded yet._