# Gotchas

Failure points discovered when applying the Stripe-inspired API design rules. Append-only — keep dated entries with concrete fix instructions.

## No known gotchas yet

This file is initialised empty. Add an entry the first time a rule produces a surprising failure or has an edge case worth documenting.

### Template for new gotchas

```markdown
### {Short, specific symptom title}
{One sentence describing what went wrong.}
{One sentence on the root cause.}
Fix: {Concrete action — what to do, where, when.}
Added: {YYYY-MM-DD}
```
