Subchapter 23.16
references/handoff/handoff-migration.mdMarkdown2 KBView on GitHub
Loaded from Generate Step 6 for migrate (always — Step 1 runs before Gate 1 is asked)
and from migration-plan.md Step 2 for build_deploy (when handoff-summary.md is
needed as the injection payload source but doesn’t exist yet). Step 1 writes the summary;
Steps 2–4 run ONLY on Gate 1’s “No” branch (the classic pointer-downstream ending).
serves two purposes: the machine-readable companion for downstream
skills, and the rationale source for Stage 2’s injection context block.
handoff-summary.mdWrite $RUN_DIR/handoff-summary.md (a compact, machine-readable companion to
recommendation.md for the downstream plugins) containing: recommended runtime + deployment
model + services, coarse model family mapping (the source model from the user’s current_model
answer → the Bedrock family per model-selection.md; no prices), and the rationale (top scoring
signals + eliminations, from design.json’s scores/eliminated).
Both downstream skills — gcp-to-aws and llm-to-bedrock — are part of this same plugin, so
they are always available; no availability check or install is needed.
gcp-to-aws
skill — it lives in this same plugin. Point the user to re-run it with
the handoff summary at $RUN_DIR/handoff-summary.md.llm-to-bedrock skill
(/aws-startup-advisor:llm-to-bedrock) — also in this same plugin, no separate install. Point
the user to re-run it with the handoff summary at $RUN_DIR/handoff-summary.md.Return to Generate Step 7 (Gate 1 was answered “No” — phases.migration_plan = “skipped”).
Tell the user the advisor phase is done: they have the recommendation doc + architecture
diagram (recommendation.md), and the handoff summary (handoff-summary.md) is saved for
the downstream plugins. Offer to kick off the recommended downstream plugin.