supabase-schema-architect — субагент для Claude Code: схемы Supabase
Субагент проектирует схемы PostgreSQL в Supabase, планирует миграции и пишет политики RLS. Пригодится, когда база растёт и надо навести порядок в доступе.
npx claude-code-templates@latest --agent database/supabase-schema-architectЧто делает supabase-schema-architect
Субагент работает с тремя вещами: схема, миграции, RLS. Он проектирует нормализованные таблицы, связи и индексы, готовит обратимые миграции с планом отката и описывает политики Row Level Security с ролевым доступом. Инструменты у него простые: Read, Write, Edit, Bash — то есть он читает файлы проекта, правит их и запускает команды.
Порядок работы такой: сначала анализ текущей схемы, потом разбор требований приложения, затем скрипты миграций и политики, в конце проверка на staging и тесты отката. В ответе он выдаёт разбор схемы, список новых таблиц с колонками и индексами, политики с оценкой влияния на производительность и файлы реализации — SQL миграций, определения политик, типы TypeScript.
Внутри заданы ориентиры: нормализация до 3NF, имена в snake_case, покрытие RLS для таблиц с чувствительными данными, миграции в транзакциях. Это не жёсткие лимиты, а то, к чему агент стремится. Для анализа текущей схемы ему нужен доступ к Supabase через MCP — без этого шага он будет работать только с тем, что лежит в файлах проекта.
Какие задачи решает
- спроектировать нормализованную схему под новую фичу
- составить миграцию с рабочим планом отката
- закрыть таблицы политиками RLS и не сломать доступ
- разложить связи и индексы так, чтобы запросы не тормозили
- сгенерировать типы TypeScript под изменённую схему
Примеры запросов агенту
- проанализируй текущую схему Supabase и предложи миграцию под таблицу заказов
- напиши политики RLS для таблицы profiles: пользователь видит только свою строку
- составь план миграции с откатом для переименования колонок в users
Как установить supabase-schema-architect
1Через claude-code-templates
npx claude-code-templates@latest --agent database/supabase-schema-architect2Вручную: положить файлы
.claude/agents/supabase-schema-architect.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/supabase-schema-architect.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/supabase-schema-architect.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о supabase-schema-architect
Как установить supabase-schema-architect в Claude?
Через шаблоны: npx claude-code-templates@latest --agent database/supabase-schema-architect. Файл агента появится по пути .claude/agents/supabase-schema-architect.md.
Что делает supabase-schema-architect?
Проектирует схемы PostgreSQL в Supabase, планирует миграции с откатом и пишет политики Row Level Security. В ответе даёт SQL, определения политик и типы TypeScript.
Нужен ли MCP-сервер Supabase для работы агента?
Для анализа текущей схемы — да, подключение идёт через MCP. Без него агент опирается только на файлы проекта.
