diff --git a/CLAUDE.md b/CLAUDE.md
index 3ccd518..2a975d1 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -130,6 +130,9 @@ Module path — `git.vakhrushev.me/av/jellybit`. Go 1.26, `CGO_ENABLED=0`.
 - Миграции БД (goose, `internal/store/migrations`; SQL для DDL, Go — когда
   нужен код) — при изменении структуры (таблица/столбец/индекс/связь) в том же
   change обновляем ER-схему [docs/specs/database.md](docs/specs/database.md).
+- Веб-UI на htmx — единый партиал = страница = фрагмент, ветвление по `isHTMX`,
+  деградация без JS, ошибка на htmx-пути = 200 + фрагмент, самозавершающийся
+  поллинг: [docs/conventions/web-ui.md](docs/conventions/web-ui.md).
 
 Кросс-каттинг конвенции (как пишем код, а не что система делает) живут в
 [docs/conventions/](docs/conventions/README.md) и не переносятся в OpenSpec.