К основному содержанию
скилл CX Codex

055-design-parallel-change — скилл для Claude Code

Скилл 055-design-parallel-change помогает спланировать безопасную миграцию схемы базы данных, когда старая и новая версии приложения должны работать одновременно. Разбивает сложные изменения на три отдельные фазы развёртывания.

Apache-2.0 172 установок ★ 465 обновлён 2026-10-21

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add jabrena/plinth --skill 055-design-parallel-change -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/055-design-parallel-change/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/055-design-parallel-change/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Данные и базы» →
flyway-expert 0xfurai Субагент flyway-expert для Claude Code ведёт миграции базы через Flyway: упорядочивает скрипты по версиям, проверяет их перед продакшеном и планирует откат. CX Codex ★ 1 029звёзд репо migration JuliusBrussee Скилл migration задаёт правила безопасных миграций схем, данных и API с обязательным откатом. Пригодится при изменениях, где нельзя терять данные или ломать совместимость. CX Codex +1 127 700установок convex-migrate-rehearse convex Скилл convex-migrate-rehearse для Claude Code, который репетирует изменение схемы и откат данных на копии продакшна, проверяет на ошибки, а потом применяет проверенное изменение в боевой системе. CX Codex +1 43 800установок database-patterns c0x12c Скилл database-patterns для Claude Code и Codex, задаёт правила проектирования БД: типы колонок, UUID-ключи, мягкое удаление и шаблоны миграций. Агент использует их при создании таблиц и репозиториев. CX Codex +1 ★ 111звёзд репо convex-migrations waynesutton Скилл convex-migrations для Claude Code. Проводит изменение схемы Convex за шесть шагов: сделать поле необязательным, залить данные батчами, переключить валидатор, подчистить. Решает падение npx convex dev на существующих документах. CX Codex +1 2 600установок convex-migrate convex Скилл convex-migrate для Claude Code и других агентов проводит миграцию схемы и бэкфилл данных в развёрнутом Convex-приложении через @convex-dev/migrations. Покрывает смену схемы на живом приложении. CX Codex +1 44 100установок

Из того же набора123

Весь набор →
500-frameworks-micronaut-create-project Скилл 500-frameworks-micronaut-create-project создаёт Maven-проект на Micronaut 4.x через SDKMAN и Micronaut CLI. Он пригодится, когда нужно подготовить новый сервис и проверить сборку. CX Codex +1 211установок 054-design-tdd Скилл 054-design-tdd ведёт разработчика через цикл «красный-зелёный-рефакторинг» при тестировании Java-кода. Пишешь падающий тест, минимум кода для прохода, потом переделываешь — всё время держа тесты зелёными. CX Codex +1 177установок 707-technologies-hexagonal-architecture Скилл 707-technologies-hexagonal-architecture помогает проверить и улучшить границы Hexagonal architecture в Java-проектах без привязки к Spring Boot, Quarkus или Micronaut. CX Codex +1 174установок 056-design-avoid-breaking-changes Скилл 056-design-avoid-breaking-changes проверяет планы, спецификации OpenSpec и код на риск несовместимости перед релизом. CX Codex +1 172установок 052-design-hamburger-method Скилл 052-design-hamburger-method разбивает крупные фичи и задачи на вертикальные срезы по методу гамбургера. Помогает выделить минимальную работающую версию вместо горизонтальных техзадач. CX Codex +1 172установок 053-design-simple-rules Скилл 053-design-simple-rules разбирает дизайн и рефакторинг Java-кода по четырём правилам Кента Бека: тесты, ясность замысла, отсутствие дублирования, минимум элементов. CX Codex +1 172установок 057-design-feature-toggles Скилл 057-design-feature-toggles для Claude Code помогает проектировать и проверять feature toggles в Java-сервисах — от kill switch до rollout и удаления старых флагов. CX Codex +1 171установок 051-design-two-steps-methods Скилл 051-design-two-steps-methods для Claude Code разбивает сложные или рискованные изменения кода на два этапа: рефакторинг без изменения логики, затем внесение нужного поведения. CX Codex +1 170установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой