bun-move

Migrate Node.js monorepos to Bun/Turborepo with phased verification and rollback.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/aphrody-code/n2b --skill bun-move
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bun-move
Source: https://github.com/aphrody-code/n2b/tree/main/skills/move
Command: npx skills add https://github.com/aphrody-code/n2b --skill bun-move

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It coordinates a complete, risk-controlled migration and consolidation of a Node.js monorepo into a unified Turborepo/Bun-ready structure, executing each phase in order while validating outcomes and automatically rolling back on failure.

Core Features & Use Cases

  • End-to-end migration runner (A→Z): Executes the full sequence of migration phases (0→8) with post-phase verification and phase-by-phase rollback.
  • Safety and state management: Uses a migration state file, lock file to prevent concurrent runs, and an append-only journal to track actions and enable resuming.
  • Targeted delegation to specialized sub-agents: Delegates Node→Bun audits and post-phase review, and hands off the live cutover to a deployment-focused agent.

Use case: Migrating a live codebase spread across multiple repositories into a single Turborepo under Bun while ensuring build artifacts exist before downtime and validating HTTP endpoints during the live switch.

Quick Start

Run the migration by starting the bootstrap step, then chain all phases automatically by executing the single all mode command in the vps directory.

Frequently Asked Questions about bun-move

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

FAQPage Schema
How do I migrate a Node.js monorepo to Bun safely?

A Bun monorepo migration consolidates multiple Node.js repositories into a single Turborepo structure using phased commits, preflight audits, and automatic rollback on invariant failures to ensure a risk-controlled cutover.

Can I consolidate multiple repositories into a single Turborepo without downtime?

Consolidating multiple repositories into a single Turborepo without downtime requires validating build artifacts exist before the switch and verifying HTTP endpoints during the live cutover, which this migration workflow delegates to specialized agents.

How does automated rollback work during a CI/CD cutover to Bun?

Automated rollback during a CI/CD cutover to Bun triggers when post-phase verification detects invariant failures, reverting the current phase actions using an append-only journal to maintain migration state and safety.

What is the best way to resume an interrupted Bun migration?

Resuming an interrupted Bun migration requires a lock file to prevent concurrent runs and a state file tracking the append-only journal of completed actions, allowing the sequential phase execution to continue safely.

Do I need to run preflight audits before migrating from Node to Bun?

Preflight audits are required before migrating from Node to Bun to identify remediation needs, allowing the migration runner to delegate Node to Bun code fixes to specialized sub-agents before executing the live cutover.