Migration
DevelopmentmigrationMigration is an Agent Skill for development published in the fedify-dev/fedify repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Help the user migrate Fedify code between versions. Use when the user needs to upgrade their Fedify version, fix breaking-change errors, or update deprecated API usage.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/fedify-dev/fedify/blob/HEAD/claude-plugin/skills/migration/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/migration, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Help the user migrate Fedify code from “$ARGUMENTS”.
Migration workflow
- Fetch CHANGES.md from the repo to identify breaking changes between
the versions in question:
https://raw.githubusercontent.com/fedify-dev/fedify/main/CHANGES.md - List every breaking change that affects the user's code range.
- For each breaking change, show the old API, the new API, and a concrete before/after code snippet.
- Search the user's codebase for usages of deprecated symbols and suggest the replacement.
- Note any dependency changes (e.g., vocabulary moved to
@fedify/vocab, runtime to@fedify/vocab-runtime).
Key migration hints
@fedify/fedify/vocab→@fedify/vocab(dedicated package)@fedify/fedify/runtime→@fedify/vocab-runtime- In-tree src/webfinger →
@fedify/webfinger - src/x/ exports removed in 2.0.0