neon-database-architect — субагент для Claude Code: схемы Neon
Субагент для проектирования схем Neon, настройки Drizzle ORM и оптимизации запросов в serverless-окружении.
npx claude-code-templates@latest --agent database/neon-database-architectЧто делает neon-database-architect
Субагент разбирает текущее состояние проекта: ищет drizzle.config.*, файлы схем и миграций, грепает упоминания DATABASE_URL, drizzle и neon. Дальше предлагает конкретные правки — структуру таблиц, миграции, оптимизации под холодные старты serverless.
Внутри — рабочий процесс из анализа окружения и реализации с проверкой. Технические стандарты: подключение через neon-http адаптер Drizzle, DATABASE_URL из переменных окружения, нормализованные схемы с типами Postgres вроде JSONB, массивов и enum, индексы и ограничения. Для повторяющихся запросов — prepared statements, для вставок — batch-операции. Есть примеры транзакций и обёртка для обработки ошибок подключения.
Инструменты субагента — Read, Write, Edit, Bash, Grep, Glob, так что он сам читает и правит файлы в проекте. Для работы нужны установленные @neondatabase/serverless, drizzle-orm и drizzle-kit, а также строка подключения в DATABASE_URL. Если проект не на Neon и не на Drizzle, пользы от него не будет — это повод проверить стек до установки.
Какие задачи решает
- спроектировать нормализованную схему Postgres под Neon
- подключить Drizzle ORM через
neon-httpадаптер - ускорить холодные старты serverless-функций
- переписать повторяющиеся запросы на prepared statements
- собрать batch-вставку вместо цикла одиночных insert
Примеры запросов агенту
- проанализируй схему базы и предложи оптимизации под Neon
- настрой подключение Drizzle к Neon через переменные окружения
- перепиши этот запрос на prepared statement
Как установить neon-database-architect
1Через claude-code-templates
npx claude-code-templates@latest --agent database/neon-database-architect2Вручную: положить файлы
.claude/agents/neon-database-architect.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/neon-database-architect.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/neon-database-architect.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о neon-database-architect
Как установить neon-database-architect в Claude?
Выполните npx claude-code-templates@latest --agent database/neon-database-architect, затем проверьте, что файл появился по пути .claude/agents/neon-database-architect.md.
Что делает neon-database-architect?
Проектирует схемы базы, настраивает Drizzle ORM, оптимизирует запросы и подключения под serverless-особенности Neon. Работает как субагент: сам читает файлы проекта и вносит правки.
Что нужно для работы субагента?
Установленные @neondatabase/serverless, drizzle-orm и drizzle-kit, а также DATABASE_URL в переменных окружения. Без проекта на Neon и Drizzle он не пригодится.
