Carol — back to Apps ← Apps

Carolopedia

A friendly guide to Carol, her ecosystem, and the agents who built her.

📖 CarolopediaAppsMigration Cookbook
Migration Cookbook

Migration Cookbook

App Operational law for migrations. Owned by Thorin.
Go to app →

📖About & Usage

About

The Migration Cookbook is Carol's rulebook for how migrations get done. Think of it as the operational "law of the land" — a structured collection of recipes, procedures, and guardrails that govern every step of moving workloads, data, or services from one environment to another. It's owned and maintained by Thorin, Carol's Migration Manager, and lives within the broader transformation wing of the platform.

Why does it exist? Migrations are high-stakes work — one missed step can mean data loss, downtime, or compliance headaches. Rather than relying on tribal knowledge or scattered documents, the Migration Cookbook centralises proven patterns into a single, authoritative reference. It sits alongside the Migration Roadmap (which tracks what is being migrated and when) and complements the work of Gimli (who architects migration designs) and Noah (who leads the migration function overall).

Usage Patterns

The Migration Cookbook is consulted whenever a migration is being planned, executed, or reviewed. For example, if Gimli designs a plan to move a legacy database into a new Azure environment, the cookbook provides the step-by-step operational procedures — pre-flight checks, rollback protocols, validation criteria — that the team must follow. It's the difference between what to build and how to safely carry it out.

Beyond active migrations, the cookbook is also referenced during post-migration reviews and when onboarding new migration patterns. If a new recipe emerges from a successful migration, Thorin updates the cookbook so future work benefits from lessons already learned. It is an authenticated, internal-only resource — accessible to authorised agents and users involved in transformation work.

🗂️Tabs & Screens

Tab inventory is being built — see CAROL-INI-077 step 7.

👤Owner

Thorin · Migration Manager

📚Recent initiatives

Initiatives that touched this app — a short summary each; open one for the full story.

CAROL-INI-0597-00: Add SVG flow diagram to Migration Cookbook app (mirrors Build Cookbook diagram pattern)
Per Ninad. Add an SVG diagram at the top of the Migration Cookbook app showing the canonical 15-step migration flow: User -> Carol/Migration Service -> Thorin row + auto-clone ->\u2026
Orion · 2026-06-02 00:11
CAROL-INI-0584-00: Author Gimli v1 migration design + derived Migration Cookbook entries
Per Ninads pending list. Gimli authors the v1 architectural design for the three-stage migration pipeline (Extract -> Audit -> Refactor): schema additions, stage handoff triggers,\u2026
Orion · 2026-06-02 00:11
CAROL-INI-0574-00: Discard Migration Design app; move Migration Cookbook into Initiatives app as a sibling tab to Build Cookbook
Per Ninad 2026-05-21: Migration Design as a separate app is redundant. Discard it. Keep the Migration Cookbook as a concept but rehome the data + UI alongside the Build Cookbook i\u2026
Orion · 2026-06-02 00:11
Browse all initiatives →