# KNOWN FAILURES — read before similar tasks. Append-only.

Format: `date | what went wrong | root cause | RULE it produced`

A journal entry is only finished when the RULE is executable by someone with zero
context. "Be more careful" is not a rule. "Wait >=15s, then verify by cold-load" is.

---

2026-XX-XX | Saved a product 3s after upload; the file silently dropped; the product
published empty. | The UI preview fires before storage settles (~13s). | RULE: wait
>=15s after upload before Save; cold-load verify file size before publish.

2026-XX-XX | <what went wrong, one line to one paragraph> | <the root cause under the
obvious cause> | RULE: <the executable instruction the next agent must follow>

<!-- Seed this file with your last three mistakes before you write a new one.
     You already know them. -->