К основному содержанию
правило CX Codex

database · first-fluke — правило для Claude Code: что делает и как установить

Правило database задаёт стандарты проектирования схем, нормализации, индексации и миграций для SQL, NoSQL и векторных баз. Срабатывает при работе с файлами .sql и .prisma.

MIT ★ 1 472 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agent
Открыть на GitHub

Что делает database

Инструкция активируется на файлах с маской **/*.{sql,prisma} и заставляет агента соблюдать строгие правила архитектуры данных. Для реляционных баз по умолчанию требуется третья нормальная форма (3NF), а любые отступления требуют обоснования. Правило обязывает фиксировать границы транзакций, уровни изоляции и стратегии блокировок для критических потоков.

Изменения живых таблиц регламентированы шаблоном expand-contract с добавлением колонок, батчевым бэкфиллом и отложенным удалением. Для DDL обязательны таймауты блокировок. Векторные базы правило прямо определяет как инфраструктуру поиска, запрещая хранить в них канонический источник правды.

Бизнес-логику, триггеры и хранимые функции стандарт требует переносить в код приложения. Оптимизация запросов строится строго на планах выполнения и замерах p95 без гадания на кофейной гуще.

Какие задачи решает

  • спроектировать реляционную схему данных с соблюдением 3NF
  • провести безопасную миграцию живой таблицы по схеме expand-contract
  • настроить гибридный поиск и версионирование эмбеддингов для векторной базы
  • оптимизировать медленные SQL-запросы по плану выполнения и метрике p95

Примеры запросов агенту

  • Проверь схему в schema.prisma на соответствие третьей нормальной форме и опиши ограничения целостности.
  • Подготовь безопасный скрипт миграции live-таблицы users.sql через шаблон expand-contract.
  • Сделай explain для медленного запроса в reports.sql и предложи оптимизацию под p95.

Как установить database

1Через маркетплейс плагинов

/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agent

2Вручную: положить файлы

.claude/rules/database.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о database

Как установить database в Claude Code?

Выполните команду /plugin marketplace add first-fluke/oh-my-agent, а затем установите плагин через /plugin install oma@oh-my-agent. Также можно вручную поместить файл правила по пути .claude/rules/database.md.

Для каких файлов автоматически включается правило database?

Оно срабатывает при открытии файлов, подходящих под паттерн **/*.{sql,prisma}. На остальных файлах агент его игнорирует, так как флаг alwaysApply выключен.

Какие требования предъявляются к векторным базам данных?

Векторные базы рассматриваются исключительно как инфраструктура поиска, а не основной источник данных. Документы должны храниться отдельно, а для эмбеддингов требуется версионировать размерность, чанкинг и предобработку.

Исходный текст

database.md · MIT
---
description: Database schema design, normalization, indexing, and integrity standards for SQL, NoSQL, and vector databases
globs: "**/*.{sql,prisma}"
alwaysApply: false
---

# Database Standards

## Core Rules

1. Choose model first, engine second: workload, access pattern, consistency, and scale drive DB selection.
2. For relational workloads, enforce at least **3NF** by default. Break 3NF only with explicit performance justification.
3. For distributed/non-relational workloads, model around aggregates and access paths; document **BASE** and consistency tradeoffs.
4. Document **ACID** expectations for relational transactions. For distributed tradeoffs, document consistency compromises explicitly.
5. For schema architecture work, document the relevant schema layers: **external schema**, **conceptual schema**, **internal schema**.
6. Treat integrity as first-class: entity, domain, referential, and business-rule integrity must be explicit.
7. Concurrency is never implicit: define transaction boundaries, locking strategy, and isolation level per critical flow.
8. For new or changed data models, specify: naming, definition, format, allowed values, and validation rules.
9. Update the affected schema decisions and data definitions; add capacity estimates when the task changes capacity requirements.
10. Proactively flag anti-patterns and insecure shortcuts instead of silently implementing them.
11. Vector DBs are retrieval infrastructure, not source-of-truth databases. Store embeddings and metadata there; keep canonical documents elsewhere.
12. Never treat vector search as a drop-in for lexical search. Default to hybrid retrieval when exact match or explainability matters.
13. Embeddings are schema-like assets: version model, dimension, chunking, and preprocessing. Plan re-embedding migrations explicitly.
14. Schema or data changes on live tables follow expand-contract: additive expand, dual-write + batched backfill, verified read switch, delayed contract. Use lock-aware DDL with timeouts; ship destructive steps in a separate deploy after a soak window.
15. Tune queries from measurement and execution plans, never guesswork: measure, explain, nominate the dominant cost node, optimize, re-measure p95.
16. Strongly recommend explicit application ownership of business policies, workflows, and external side effects in both new and existing triggers, stored procedures/functions, views, DB jobs, and ORM hooks. For affected existing logic, give a concrete alternative and transition priority; existing convention alone does not justify retention. Use `.agents/skills/oma-db/resources/anti-patterns.md` §5 for review and technical retention criteria. This is a strong recommendation, not a blanket feature ban or authorization for an unrelated rewrite.
17. Preserve DB integrity constraints, atomic updates, transactions/isolation/locking, RLS and privileges, DB audit, justified dependent cascades, and efficient set-based operations. For an accepted transition, follow `.agents/skills/oma-db/resources/migration-playbook.md` to cover every writer, prevent duplicate side effects, and define rollback.

© First Fluke · MIT · first-fluke/oh-my-agent

Похожие правила IDE

Все правила IDE по теме «Данные и базы» →

Сначала — database от других авторов.

database PatrickJS Правило database для Cursor с набором практик по Prisma и Supabase: схемы, миграции, запросы, RLS-политики. Подключается к файлам базы по маске. CX Codex +1 ★ 41 178звёзд репо schema-consistency-checker patricio0312rev Скилл schema-consistency-checker проверяет схему базы на единый стиль имён, типы id, NULL в критичных полях и внешние ключи без индекса, а потом отдаёт список нарушений с рекомендациями. CX Codex +1 265установок database-schema alinaqi Скилл database-schema для Claude Code сверяет схему базы перед запросами и изменением моделей. Он подключается перед работой с базой и при обращении к файлам схемы, миграций или моделей. CX Codex +1 308установок database-design spencerpauly Скилл database-design помогает спроектировать реляционную схему базы данных, расставить внешние ключи, индексы и сгенерировать модели для Prisma или Drizzle по требованиям к проекту. CX Codex +1 505установок design-database-schema davila7 Команда design-database-schema проектирует структуру базы данных с учётом связей, ограничений и запросов. Она пригодится при создании схемы или пересмотре существующей. CX Codex +1 1 021установок database-schema-designer softaworks Плагин database-schema-designer помогает проектировать схемы баз данных SQL и NoSQL: выбрать нормализацию, продумать индексы и подготовить миграции. ★ 2 707звёзд репо database-designer Alireza Rezvani Скилл database-designer для Claude Code проектирует схемы БД, анализирует индексы и готовит миграции. Проверяет структуру и помогает изменить её без резкого переключения приложения. CX Codex +1 819установок

Из того же набора69

Весь набор →
refactor-engineer Субагент refactor-engineer, который переделывает код, сохраняя его функциональность. Помогает упростить сложные участки, подстраховывая каждый шаг тестами. CX Codex ★ 1 472звёзд репо pm-planner Субагент pm-planner роли Product Manager для Claude Code и Codex. Разбирает требования, формирует API-контракты и декомпозирует фичи на параллельные задачи. CX Codex ★ 1 472звёзд репо oma-bootstrap Скилл oma-bootstrap проверяет, готов ли oma к задаче: CLI, нужные провайдеры и состояние проекта. Запускается перед скиллом или рабочим процессом, которому нужна команда oma. CX Codex +1 ★ 1 472звёзд репо research-explorer Субагент research-explorer, который ищет ответы сразу в трёх источниках: документация и код, сигналы рынка, академические работы. Собирает выводы с указанием источников и уровня надёжности. CX Codex ★ 1 472звёзд репо docs-curator Субагент docs-curator, который следит за дрейфом документации и обновляет MD-файлы, когда код меняется. Ловит неработающие ссылки, предлагает патчи и держит docs/**/*.md в актуальном состоянии. CX Codex ★ 1 472звёзд репо i18n-guide Правило i18n-guide задаёт язык ответов агента и определяет, какие строки переводить, а какие оставлять на английском. Пригодится в проектах с несколькими локалями и агентскими workflow. CX Codex +1 ★ 1 472звёзд репо frontend Правило frontend для React и Next.js проектов: shadcn/ui, Tailwind CSS v4, FSD-lite архитектура, Server Components по умолчанию. CX Codex +1 ★ 1 472звёзд репо oma-docs Сверяет ссылки в документации, обновляет тексты под изменения в коде и находит рассинхрон в переводах. Работает через CLI oma docs или ручной парсинг ссылок. CX Codex +1 ★ 1 472звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой