Find the constraints before funding the move.
Explore how a shared inventory, early compatibility checks and ordered restore gates could avoid wasted migration effort and improve recovery evidence.
Establish the baseline
- Authorized environment access
- Backup and retention requirements
- Recovery and downtime constraints
Evidence to retain
- Shared inventory and dependencies
- Compatibility decisions and restore evidence
- Reviewed cutover and fallback plan
Why work this way?
The process, and what it could improve.
Cost
Reject an unsuitable route before building it.
Share one inventory and dependency map. Check support, licensing and restore constraints before spending implementation effort on a target.
- What to compare
- Discovery, tooling and engineering cost through an accepted rehearsal, including abandoned routes.
- The tradeoff
- Discovery may show a rebuild is necessary. A cloud target is not automatically cheaper.
Reject an unsuitable route before building it.
Compare the same scope and acceptance criteria. Include setup, coordination, failed attempts and human review alongside the successful model call.
Design the work
One problem. A coordinated agent team.
A model reasons. A harness runs its agent session and tool loop. Orchard coordinates the work, context and handoffs across them.
Orchestration phase 1: Split the work. Preserve the question.
Implementation lead
01Inventory the source and propose a supported replication/rehost route for the pilot workload.
Counterproposal agent
02Assume rehosting fails on OS support, drivers, or licensing. Develop a rebuild or archive alternative.
Independent reviewer
03Inspect backup provenance and restore evidence, then test application dependencies in an isolated target.
Rules · skills · hooks · MCP configuration
Adapted to each harnessSplit the work. Preserve the question.
One objective, distinct responsibilities
Preserve a recoverable legacy environment and choose a supported route to a cloud workload.
inventory.json + target architecturecompatibility-counterproposal.md + restore checklistrestore record + cutover readiness reportModel families and pairings are illustrative. Assignments here are manual examples, not measured model comparisons or automatic cost optimization.
Inspect the example work orderJSON
An illustrative work-order format for this scenario. Changing an example session updates this document; no agents run from this page.
{
"example": "legacy-os-cloud-migration",
"objective": "Preserve a recoverable legacy environment and choose a supported route to a cloud workload.",
"boundary": "Independent backups and isolated restore tests precede source changes or production cutover.",
"sessions": [
{
"role": "proposer",
"model_family": "Claude",
"harness": "Claude Code",
"task": "Inventory the source and propose a supported replication/rehost route for the pilot workload.",
"expected_artifact": "inventory.json + target architecture"
},
{
"role": "challenger",
"model_family": "GPT",
"harness": "Codex CLI",
"task": "Assume rehosting fails on OS support, drivers, or licensing. Develop a rebuild or archive alternative.",
"expected_artifact": "compatibility-counterproposal.md + restore checklist"
},
{
"role": "reviewer",
"model_family": "Gemini",
"harness": "Gemini CLI",
"task": "Inspect backup provenance and restore evidence, then test application dependencies in an isolated target.",
"expected_artifact": "restore record + cutover readiness report"
}
],
"project_contract": [
"Rules",
"Skills",
"Hooks",
"Tool configuration"
],
"shared_context": [
"Environment inventory",
"Recovery evidence"
],
"evidence_required": [
{
"label": "Recovery is demonstrated",
"evidence": "Restore the backup independently and record integrity and application checks."
},
{
"label": "Target is compatible",
"evidence": "Verify OS support, licensing, drivers, networking and dependent services."
},
{
"label": "Cutover is reversible",
"evidence": "Rehearse final sync, health checks and a timed fallback decision."
}
],
"release_owner_gate": "The system and application owners approve downtime, rollback conditions and retention before cutover."
}Chapter 1: Discover what the machine is really doing.
Chapter 01 / 04
Discover what the machine is really doing.
Record the OS, applications, storage, schedules, and network dependencies. Establish ownership and recovery requirements before making changes.
Discovery agent + system administrator
Environment inventory
OS · Applications · Storage · Jobs · DependenciesThe process principle
Spend discovery effort before committing migration effort.
Scope of this exampleCheck support per OS and workload. Unsupported systems may require an application rebuild or supported intermediary, not a direct lift-and-shift.
A migration scenario. It does not imply every legacy OS can run on a cloud platform. Migration support reference






