database · first-fluke — правило для Claude Code: что делает и как установить
Правило database задаёт стандарты проектирования схем, нормализации, индексации и миграций для SQL, NoSQL и векторных баз. Срабатывает при работе с файлами .sql и .prisma.
MIT ★ 1 472 обновлён 2026-10-29
/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agentЧто делает 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-agent2Вручную: положить файлы
.claude/rules/database.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/database.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/database.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/database.mdВручную: положить файлы
.clinerules/database.mdПо шагам, с командами для каждой платформы: 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 от других авторов.