lunora-migration-helper

Manage breaking schema transitions and data backfills across ShardDO, D1, and Hyperdrive.

214|7|Updated May 29, 2026
One-click install
npx skills add https://github.com/anolilab/lunora --skill lunora-migration-helper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lunora-migration-helper
Source: https://github.com/anolilab/lunora/tree/main/packages/cli/skills/lunora-migration-helper
Command: npx skills add https://github.com/anolilab/lunora --skill lunora-migration-helper

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the complexity of performing breaking schema changes and data migrations in Lunora applications, ensuring that state remains consistent across ShardDO, D1, and Hyperdrive backends without causing downtime or data loss.

Core Features & Use Cases

  • Widen-Migrate-Narrow Workflow: Provides a structured, multi-step discipline to safely evolve database schemas.
  • Online Data Migrations: Facilitates resumable, shard-aware data backfills using defineMigration to handle large datasets without hitting transaction limits.
  • Schema-Drift Protection: Integrates with the Lunora pre-deploy gate to prevent breaking changes from reaching production without proper migration paths.

Quick Start

Use the lunora-migration-helper skill to generate a migration plan for your current schema changes and verify the required steps for your specific backend.

Frequently Asked Questions about lunora-migration-helper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely manage breaking database schema changes in Lunora applications?

To safely manage breaking database schema changes in Lunora, use the widen-migrate-narrow workflow. This multi-step discipline ensures structural modifications and field reshaping occur without downtime or data loss across storage layers.

How do I run online data migrations on Cloudflare D1 and Hyperdrive without hitting transaction limits?

Run online data migrations on D1 and Hyperdrive using resumable, shard-aware data backfills. The defineMigration function processes large datasets incrementally, avoiding transaction limits while maintaining state consistency.

What is the widen-migrate-narrow discipline for database schema migrations?

The widen-migrate-narrow discipline is a structured process for evolving database schemas safely. It coordinates widening the schema, migrating backfill data, and narrowing the structure to ensure data integrity during breaking transitions.

How do I prevent schema drift and deployment failures when modifying Lunora database schemas?

Prevent schema drift and deployment failures by validating migration readiness against the pre-deploy schema-drift gate. This integration blocks breaking changes from reaching production without proper migration paths.

Does Lunora support resumable data backfills across ShardDO, D1, and Hyperdrive backends?

Yes, Lunora supports resumable data backfills across ShardDO, D1, and Hyperdrive backends. It coordinates shard-aware online migrations to maintain consistent state during structural modifications and field reshaping.