diff --git a/docs/bugs.md b/docs/bugs.md
new file mode 100644
index 0000000..7eee168
--- /dev/null
+++ b/docs/bugs.md
@@ -0,0 +1,25 @@
+# acdream — known bugs
+
+Track visual, gameplay, and protocol bugs here. Close by moving to
+the "Fixed" section with the commit hash that resolved it.
+
+---
+
+## Open
+
+### BUG-001: Wrong cloth textures on characters
+- **Observed:** 2026-04-13
+- **Description:** Character clothing renders with incorrect textures.
+  ObjDesc Phase 5 (AnimPartChange + TextureChanges + SubPalettes) is
+  shipped but something is off — either a texture-swap ordering issue,
+  a missing remapping step, or a palette application bug.
+- **Repro:** Connect to ACE server, observe player character or NPCs.
+- **Likely area:** `WorldEntity` ObjDesc application, `TextureCache`,
+  or the CreaturePalette pipeline in `InstancedMeshRenderer`.
+- **Phase:** Unassigned (investigate after rendering rebuild Step 5).
+
+---
+
+## Fixed
+
+_(none yet)_