database-patterns — скилл для Claude Code: схемы, миграции, Exposed

Что делает database-patterns

Скилл подключается к агенту и подсовывает ему свод правил по схемам и миграциям. Жёсткие требования простые: колонки типа TEXT вместо VARCHAR, первичные ключи на UUID вместо SERIAL и BIGINT, мягкое удаление через deleted_at TIMESTAMP вместо DELETE FROM, внешние ключи проверяются на уровне приложения, а не через REFERENCES и ON DELETE CASCADE. Стандартный набор колонок — id, created_at, updated_at, deleted_at.

Внутри лежат шаблоны: SQL-миграция с таблицей, триггером и частичными индексами под мягкое удаление, объект таблицы на Exposed с наследованием от UUIDTable, data-класс сущности с Entity<Instant> и репозиторий по схеме «интерфейс + Default*». Чтение идёт на db.replica, запись на db.primary, а метод convert() переводит ResultRow в сущность. Отдельный чек-лист перечисляет семь шагов создания новой таблицы — от файла миграции до тестов репозитория.

Есть раздел с граблями. Например, .value работает только у id: у остальных колонок row[Table.projectId] уже возвращает UUID, и лишний .value ломает компиляцию. Если сущность наследуется от SoftDeleteTable, поля createdAt, updatedAt и deletedAt объявлять повторно нельзя — получите ошибку о дублирующейся колонке. По Flyway правило жёсткое: не заполнять пропуски в уже развёрнутой последовательности миграций и не переименовывать применённые файлы.