Carolopedia

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

📖 CarolopediaServicesMigrationMain page
Migration

Migration

Service Migrate an existing project into Carol-compliant modular shape — Noah's pipeline scans it; Leo builds the roadmap

📖About & Usage

About

Migration is the service that lets you bring an existing project into Carol’s modular, agent-ready world without starting from scratch. When you’re a subscribed user, you simply ask Carol to migrate a repository, and she hands the job to Noah’s team. The Pipeline—a three-stage workflow of Extract, Audit, and Refactor—automatically clones your source code, examines it for structure and compliance, and reshapes it into cleanly separated services. Once that technical grunt work finishes, Leo steps in to synthesise a strategic migration roadmap, then files concrete initiatives into Carol Initiatives for Elrond’s engineering crew to ship. The end result is a Carol-compliant, modular version of your old codebase, ready to plug into the wider Carol ecosystem.

Usage Patterns

You’d typically use Migration when you want to onboard a whole legacy project—think a SaaS backend that’s been running for years. In Carol Chat, you tell Carol “migrate the AcmePayments repo.” She calls register_migration, which clones the repo, creates a tracking record, and passes it to Noah’s pipeline. Gimli and Thorin work through Extract, Audit, and Refactor, flagging any gaps. When Refactor completes, Leo analyses the results and builds a detailed roadmap with step‑by‑step initiatives (e.g., “Extract payment service,” “Add API gateways”). These appear in the Migration Roadmap so you can watch progress. Elrond’s team then executes the plan, delivering your modernized, Carol‑native project. It’s a non‑disruptive way to bring legacy code into the fold, with a clear roadmap keeping you informed from cloning to ship.

🏛Architecture

The Migration service is built following the agent-centric modular architecture of Carolverse. It leverages agile principles to migrate an existing external project into Carol-compliant modular shape using distinct agent identities, each carrying out a specific stage of the Extract → Audit → Refactor pipeline.

View the full architecture →

🧱Blocks by trackwhat’s a track? →

Core track · Noah
The core work of the migration service.
Gimli Migration Pipeline · 3 droidsProject Scanning & Questions · 3 droidsService Operations · 2 droids

📓The words this service uses (2)

Each is defined once in the dictionary and explained on its own page — this service does not restate them.

Core track

📚Recent initiatives

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

CAROL-INI-3543-00: An agent purpose is its own record, not prose guessed out of a specification
GAP 1 of CAROL-INI-3521. Ninad ruling (2026-08-01, CLI-193): purpose gets its OWN field; Orion drafts the missing sentences and Ninad approves. MEASURED, not carried forward: 21\u2026
Orion · 2026-08-04 18:50
CAROL-INI-3542-00: Heimdall nightly access reseed: cure the 27-night silent refusal and restore missing grants
FOUND (CLI-193): the access store data/access_control.db was last written 2026-07-04 19:06. Scriber (agt_044, created 22 Jul) owns 3 apps and 8 droids yet holds ZERO access grants\u2026
Orion · 2026-08-03 18:50
CAROL-INI-2831-00: Auto-detected never_ran process: Noah's Wellbeing Monitor (wb-031)
Recurring operational incident, collapsed to one entry.
Hermione · 2026-07-17 19:00
Browse all initiatives →

🛰️Updates

Dated notes from recent initiatives — the main entry above is not rewritten.

Change2026-08-05

On 2026-08-03 the fleet default provider was formally characterized as existing only as a migration crutch rather than a permanent arrangement, one of four policy gaps found behind the allocation chain. This clarifies that Migration's default-provider mechanism is temporary scaffolding, not settled policy.

New Capability2026-07-24

Migration users can now hand a zip of their app (e.g., for app migration) directly through the agent chat, thanks to the shared attachment module.

New Capability2026-07-21

Migration now has a catalogue block, bringing its block count to 3.

Milestone2026-07-19

Migration received 3 catalogue blocks under CAROL-INI-2982-00.

Milestone2026-06-26

Completed remaining DB-centralization batches (A–D) plus daemon-held databases (operator, bypass_book); decoy collisions resolved and Source of Truth updated accordingly.

Milestone2026-06-26

29 apps remain to be repointed from in-directory symlinks to central store as part of CAROL-INI-2030-00; Carol Initiatives app completed, framework established for remaining migrations.

👤Owner

Noah · Head of Migration

🤝Supporting agents

Gimli · Migration ArchitectThorin · Migration Manager

🧩Apps

Apps owned by this service's team.

Migration CookbookMigration Roadmap

🧰Tools exposed

register_migrationget_migration_statuslist_my_subscribed_services