# neon-database-architect

Субагент для проектирования схем Neon, настройки Drizzle ORM и оптимизации запросов в serverless-окружении.

- субагент · `type=agent` · Claude Code · 478 установок
- Автор: davila7
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/database/neon-database-architect.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/agents/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, пользы от него не будет — это повод проверить стек до установки.

## Требования
- Работает с: PostgreSQL

## Установка

### Claude Code (родная платформа)

1. **Через claude-code-templates**
```bash
npx claude-code-templates@latest --agent database/neon-database-architect
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/neon-database-architect.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/neon-database-architect.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/neon-database-architect.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/database/neon-database-architect.md

## Когда брать
- спроектировать нормализованную схему Postgres под Neon
- подключить Drizzle ORM через `neon-http` адаптер
- ускорить холодные старты serverless-функций
- переписать повторяющиеся запросы на prepared statements
- собрать batch-вставку вместо цикла одиночных insert

## Примеры запросов агенту
- проанализируй схему базы и предложи оптимизации под Neon
- настрой подключение Drizzle к Neon через переменные окружения
- перепиши этот запрос на prepared statement

## Похожие
- [neon](https://affpapa.org/nevibecode/skills/neon.md) — скилл · 234000 установок
- [neon-functions](https://affpapa.org/nevibecode/skills/neon-functions.md) — скилл · 27900 установок
- [database-design](https://affpapa.org/nevibecode/skills/spencerpauly-database-design.md) — скилл · 462 установки
- [database-migrations](https://affpapa.org/nevibecode/skills/database-migrations.md) — скилл · 5200 установок
- [golang-database](https://affpapa.org/nevibecode/skills/golang-database.md) — скилл · 40800 установок
- [postgresql-database-engineering](https://affpapa.org/nevibecode/skills/postgresql-database-engineering.md) — скилл · 1800 установок

Из того же набора: [davila7/claude-code-templates](https://affpapa.org/nevibecode/by/davila7/claude-code-templates.md) — 205 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md