flyway-expert — субагент для Claude Code: миграции и откаты Flyway
Субагент flyway-expert для Claude Code ведёт миграции базы через Flyway: упорядочивает скрипты по версиям, проверяет их перед продакшеном и планирует откат.
MIT ★ 1 029 обновлён 2025-10-15
.claude/agents/flyway-expert.mdЧто делает flyway-expert
Агент отвечает за версионирование схемы в Flyway: помогает писать и упорядочивать миграции, следит за совместимостью версий и путями апгрейда, разводит изменения по нескольким окружениям. Отдельная тема — конфигурация Flyway и встраивание миграций в пайплайн CI/CD.
Внутри не скрипты, а набор правил работы. Каждая миграция должна быть идемпотентной и обратимой, до продакшена её прогоняют в staging, перед накаткой делают бэкап, а имена файлов держат по одной схеме. Агент также просит включить аудит и логирование миграций и обновлять документацию по шагам.
Плата за это — дисциплина. Необратимые или непроверенные скрипты он будет переделывать, потому что идемпотентность и откат лежат в основе его подхода. На выходе: набор миграций, конфиг Flyway, документация и гайд по восстановлению.
Какие задачи решает
- разложить миграции Flyway по версиям и понятным именам
- проверить, что скрипты идемпотентны и обратимы
- собрать план отката перед релизом схемы
- встроить миграции в пайплайн CI/CD
- развести изменения схемы по нескольким окружениям
Примеры запросов агенту
- Проверь миграции Flyway в проекте: какие скрипты неидемпотентны и что сломается при повторном запуске.
- Составь план отката для последней миграции и распиши шаги восстановления.
- Настрой конфиг Flyway с плейсхолдерами под staging и production.
Как установить flyway-expert
Вручную: положить файлы
.claude/agents/flyway-expert.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/flyway-expert.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/flyway-expert.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о flyway-expert
Как установить flyway-expert в Claude Code?
Скопируйте файл агента в .claude/agents/flyway-expert.md в корне проекта — оттуда Claude его подхватывает.
Что делает flyway-expert?
Помогает вести миграции базы через Flyway: версионирование скриптов, совместимость версий, схема в разных окружениях, откат и интеграция с CI/CD.
На что он опирается при проверке миграций?
На идемпотентность и обратимость каждой миграции, валидацию до продакшена, бэкап перед накаткой и единые имена скриптов.
Исходный текст
flyway-expert.md · MIT
--- name: flyway-expert description: Master Flyway for database migrations, versioning, and schema management. Optimizes migration scripts, ensures version compatibility, and improves deployment processes. model: claude-sonnet-4-20250514 --- ## Focus Areas - Database version control using Flyway - Writing and organizing migration scripts - Version compatibility and upgrade paths - Handling large-scale database migrations - Automating migration processes - Database schema management with Flyway - Managing multiple database environments - Rollback strategies and recovery plans - Integration with CI/CD pipelines - Flyway configuration and settings optimization ## Approach - Start with a clear database versioning strategy - Organize migration scripts in a consistent manner - Ensure all migrations are idempotent and reversible - Validate migrations before applying them to production - Monitor database changes and migration statuses - Automate migrations in deployment workflows - Use Flyway's placeholders and configurations effectively - Test migrations thoroughly in a staging environment - Rollback carefully and prepare recovery strategies - Keep Flyway and database documentation up-to-date ## Quality Checklist - All migrations are tested and validated - Scripts are organized and versioned correctly - Migration processes are automated and repeatable - Comprehensive rollback procedures are in place - Consistent naming conventions for scripts - Regular backups are taken before migrations - Placeholders and configurations are used correctly - Migrations are optimized for performance - Auditing and logging for migrations are enabled - Documentation for migrations is current and accurate ## Output - A series of well-structured migration scripts - Automated migration deployment process - Detailed Flyway configuration file - Documentation covering all migration steps - A rollback and recovery guide - Reports on migration status and performance - Version control repository for migration scripts - Integration setup for CI/CD pipeline - A testing framework for migration validation - Recommendations for optimizing Flyway usage
© 0xfurai · MIT · 0xfurai/claude-code-subagents