mcpField
B
bitrix-sprint-migration

bitrix-sprint-migration

github.com/bxmaximumDevelopment47261 installsUpdated 2w ago
Repository

About bitrix-sprint-migration

bitrix-sprint-migration is a Bitrix module for tracking project schema and content changes as PHP classes in version control. It is aimed at Bitrix development teams and includes migration-writing guidance, CLI configuration, and safety checks.

Key features

  1. 01Store migrations as PHP classes
  2. 02Run migrations through the CLI
  3. 03Configure migrations and version naming
  4. 04Follow writing and safety-check rules

Use cases

  1. 01Manage schema changes in Bitrix projects
  2. 02Maintain content changes across environments
  3. 03Review and safely apply database migrations

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/bxmaximum/bitrix-framework-skills --skill bitrix-sprint-migration

After installing, type/bitrix-sprint-migrationin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

rules/
checklist.md
cli-config.md
helpers-builders.md
writing.md

Details

From the project README

sprint.migration

Baseline: main 23.0+ · Verified: sprint.migration 5.15.1, main 26.800.0

Marketplace/Composer module (andreyryabin/sprint.migration) that keeps project schema and content changes as PHP classes in VCS. Module-owned tables, events and agents of your own module go into its installer instead (bitrix-modules).

Not installed? Check /local/modules/sprint.migration/ and /bitrix/modules/sprint.migration/, then Loader::includeModule('sprint.migration'). If it is missing, propose installing it (Marketplace or Composer). Never write a home-made migration framework.

TaskRead
CLI commands, configs, version naming, console userrules/cli-config.md
Writing Version::up()/down(), restartable batches, exchange filesrules/writing.md
Helper and builder map, method namesrules/helpers-builders.md
Safety rules, review and apply checklistrules/checklist.md

Defaults (config cfg)

ItemDefault
Migration dir{local|bitrix}/php_interface/migrations (local if local/php_interface exists)
Versions tablesprint_migration_versions
Classnamespace Sprint\Migration; Version<YmdHis> extends Version
CLIphp {module}/tools/migrate.php <command>

Invariants

  • Never edit the module source; write only migration files and migrations.*.php configs.
  • Create files with add or a builder; hand-made names break timestamp validation.
  • Identify entities by CODE/XML_ID, never by ids from another database.
  • An applied migration is immutable: fix forward with a new one.
  • up/down on shared or production databases only with explicit human approval.

Comments

Markdown supported