055-design-parallel-change — скилл для Claude Code
Скилл 055-design-parallel-change помогает спланировать безопасную миграцию схемы базы данных, когда старая и новая версии приложения должны работать одновременно. Разбивает сложные изменения на три отдельные фазы развёртывания.
Apache-2.0 172 установок ★ 465 обновлён 2026-10-21
npx skills add jabrena/plinth --skill 055-design-parallel-change -a claude-codeЧто делает 055-design-parallel-change
055-design-parallel-change направляет разработчиков через проектирование Parallel Change — паттерна для миграций, когда нужна совместимость между версиями. Скилл помогает классифицировать риск миграции, выбрать между Parallel Change и более простым подходом, а затем спланировать три этапа: expand (добавить новую структуру), migrate (перенести данные), contract (удалить старую).
Он охватывает переименование колонок, изменение типов данных, массовое заполнение таблиц, изменения отношений, переходы статусов, изменения часовых поясов и индексов. Для каждого сценария скилл объясняет компромиссы: временные двойные пути в коде, дополнительные миграции, усилия на проверку и отложенную очистку.
После проектирования подхода скилл передаёт реализацию фреймворк-специфичным навыкам Flyway для Spring Boot, Quarkus или Micronaut. Требует чтения справочного документа references/055-design-parallel-change.md перед применением.
Какие задачи решает
- спланировать миграцию схемы БД без простоев
- разбить переименование колонки на безопасные этапы
- синхронизировать развёртывание старого и нового кода приложения
- спроектировать откат миграции с минимальной потерей данных
- решить, нужна ли совместимость между версиями для этого изменения
Примеры запросов агенту
- Спланируй миграцию для переименования колонки с использованием expand-migrate-contract
- Проверь, нужен ли Parallel Change для этого изменения схемы
- Спроектируй нулевое время простоя для этого Flyway скрипта миграции
Как установить 055-design-parallel-change
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 055-design-parallel-change -a claude-code2Вручную: положить файлы
~/.claude/skills/055-design-parallel-change/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/055-design-parallel-change/
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 055-design-parallel-change -a codex2Вручную: положить файлы
.agents/skills/055-design-parallel-change/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 055-design-parallel-change -a cursor2Вручную: положить файлы
.cursor/skills/055-design-parallel-change/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jabrena/plinth skills/055-design-parallel-change2Вручную: положить файлы
.github/skills/055-design-parallel-change/SKILL.md1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 055-design-parallel-change -a gemini-cli2Командой платформы
gemini skills install https://github.com/jabrena/plinth --path skills/055-design-parallel-changeВручную: положить файлы
.devin/skills/055-design-parallel-change/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 055-design-parallel-change -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о 055-design-parallel-change
Как установить 055-design-parallel-change в Claude Code?
Выполни npx skills add jabrena/plinth --skill 055-design-parallel-change -a claude-code, а затем посмотри ~/.claude/skills/055-design-parallel-change/SKILL.md.
Что делает 055-design-parallel-change?
Скилл помогает спланировать безопасное изменение схемы БД, разбивая его на три развёртываемых этапа: расширение (expand), миграцию (migrate) и сжатие (contract). Это позволяет старой и новой версиям приложения работать одновременно.
Когда нужен Parallel Change вместо простой миграции?
Когда старая и новая версии приложения должны сосуществовать, когда изменение затрагивает большие таблицы или когда откат критичен. Если изменение аддитивно и безопасно, скилл рекомендует более простой подход.
Исходный текст
SKILL.md · Apache-2.0
--- name: 055-design-parallel-change description: Use when a database schema or data-meaning change needs Parallel Change, including expand, migrate, and contract sequencing for column renames, type or data reinterpretation, large-table backfills, relationship-table changes, enum/status transitions, timezone/default changes, and index or uniqueness changes. This should trigger before framework-specific Flyway implementation guidance when deciding whether a migration needs a compatibility window or whether a simpler migration is sufficient. Part of Plinth Toolkit license: Apache-2.0 metadata: author: Juan Antonio Breña Moral version: 0.19.0 --- # Parallel Change Design Guide Java Enterprise developers through Parallel Change for database migration scenarios. **This is an interactive SKILL**. **What is covered in this Skill?** - Deciding whether a database migration needs a compatibility window - Sequencing database changes as expand, migrate, and contract deployable steps - Preserving old and new application versions during rollout and rollback windows - Handling column renames, type or data reinterpretation, large backfills, relationship-table changes, and index or uniqueness changes - Explaining tradeoffs such as temporary dual paths, extra migrations, verification effort, and delayed cleanup - Routing framework-specific implementation to Spring Boot, Quarkus, or Micronaut Flyway skills after the design approach is clear ## Constraints Use Parallel Change as a database migration design pattern, then hand off implementation details to the framework-specific migration skill when needed. - **MUST** read `references/055-design-parallel-change.md` before applying Parallel Change guidance - **MUST** explain expand, migrate, and contract as separate deployable steps when recommending Parallel Change - **MUST** decide whether Parallel Change is needed before recommending framework-specific Flyway implementation details - **MUST** recommend a simpler single migration when the change is additive, immediately safe, and does not require old and new application versions to coexist - **MUST** describe the compatibility, data-preservation, verification, and cleanup tradeoffs of the chosen approach - **MUST** use framework-specific Flyway skills for Spring Boot, Quarkus, or Micronaut implementation details after the migration strategy is selected ## When to use this skill - Apply Parallel Change to this database migration - Use expand migrate contract for this schema change - Plan a safe column rename migration - Plan a zero-downtime database migration - Should this Flyway migration use Parallel Change? - Design a safe backfill and contract migration - Decide if this schema change needs a compatibility window ## Workflow 1. **Classify the Migration Risk** Read `references/055-design-parallel-change.md`, then identify the schema shape, data meaning, application read/write path, rollout window, rollback expectation, and production-data risk affected by the migration. 2. **Choose Parallel Change or Simpler Migration** Recommend Parallel Change when old and new application versions or data interpretations must coexist. Recommend a simpler forward-only migration when the change is additive, small, immediately safe, and does not require a compatibility window. 3. **Design Expand, Migrate, Contract** For Parallel Change, separate expand, migrate, and contract into independently deployable steps. Keep the old shape valid during expand and migrate; contract only after all deployed code and data have moved to the new shape. 4. **Plan Verification and Operations** Define previous-release fixture checks, row-count expectations, duplicate detection, backfill monitoring, rollback behavior, and cleanup ownership. Prefer production-dialect migration tests and production-like data samples where feasible. 5. **Route Framework Implementation** After the strategy is clear, use `313-frameworks-spring-db-migrations-flyway`, `413-frameworks-quarkus-db-migrations-flyway`, or `513-frameworks-micronaut-db-migrations-flyway` for framework-specific Flyway dependencies, configuration, migration locations, and tests. 6. **Report the Migration Plan** Report the chosen approach, rejected alternative, expand/migrate/contract sequence or simpler migration, verification evidence, cleanup trigger, tradeoffs, skipped checks, and remaining risks. ## Reference For detailed guidance, examples, and constraints, see [references/055-design-parallel-change.md](references/055-design-parallel-change.md).
© Juan Antonio Breña Moral · Apache-2.0 · jabrena/plinth