migration-phase-awareness

Tracks multi-phase component migration progress and emits checkpoint blocks for cross-session continuity.

1.5k|261|Updated Nov 19, 2018
One-click install
npx skills add https://github.com/adobe/spectrum-web-components --skill migration-phase-awareness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migration-phase-awareness
Source: https://github.com/adobe/spectrum-web-components/tree/main/.ai/skills/migration-phase-awareness
Command: npx skills add https://github.com/adobe/spectrum-web-components --skill migration-phase-awareness

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Multi-phase component migrations span many sessions and engineers, making it easy to lose track of which phases are complete, what obligations remain, and whether work drifted from the migration plan. This Skill keeps migration phase state explicit and produces a standardized handoff artifact.

Core Features & Use Cases

  • Phase completion verification: Checks the active phase against the skill's quality gate, the component's migration plan, and the plan checklist before declaring a phase done.
  • Migration Checkpoint blocks: Emits a standardized Markdown checkpoint at each phase completion so any engineer can resume the migration in a new session.
  • Drift handling: When work drifts away from the migration, it finishes the request and outputs a one-line resume prompt naming the skill to re-invoke.
  • Use Case: While migrating a Spectrum Web Components component from 1st-gen to 2nd-gen, an engineer finishes the accessibility phase; the Skill verifies the plan checklist, updates the status table, and emits a checkpoint the next engineer pastes into a fresh session.

Quick Start

Ask the AI to check migration phase status or state what is left for this migration while any migration skill is active.

Frequently Asked Questions about migration-phase-awareness

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

FAQPage Schema
How do I track progress across a multi-phase component migration?

Invoke any migration-* skill and this awareness layer activates automatically for the session. At each phase completion it verifies the quality gate and migration plan, then emits a Migration Checkpoint block recording the completed phase, next phase, and any blockers.

How do I resume a component migration in a new session?

Paste the most recent Migration Checkpoint block into the new session as context. The checkpoint names the completed phase, the next phase, and the exact migration-* skill to invoke, so no shared tracking file is needed.

What happens if migration work drifts to unrelated tasks?

The requested work is completed normally, then the response ends with a one-line resume prompt naming the migration skill that was active. This gives the engineer an exact phrase to resume the migration without reconstructing context.

Does this skill replace the migration plan or status files?

No. It reads and updates the component's migration-plan.md checklist and the workstream status table rather than replacing them. If the plan is missing or the implementation drifted from it, that is flagged explicitly as a risk.

When should the conformance sub-task run in the migration sequence?

The migration-conformance sub-task runs after Phase 6 (testing) and before Phase 7 (documentation). It is not optional; if it was skipped, the omission must be noted in the Migration Checkpoint block.