Skip to content

feat(cli): add an AI prompt for migrating to v4 - #4226

Draft
vladfrangu wants to merge 1 commit into
masterfrom
feat/cli-v4-upgrade-skill
Draft

vladfrangu wants to merge 1 commit into
masterfrom
feat/cli-v4-upgrade-skill

Conversation

@vladfrangu

Copy link
Copy Markdown
Member

Adds crawlee upgrade-to-v4 so users can paste a migration prompt into an AI tool. The prompt guides project inspection, planning, migration and verification, with {SKILL_ROOT} replaced by the absolute path to bundled references.

Common breaking changes stay in the main prompt. Specialized APIs, Crawlee and Apify package roles, and Dockerfile and installation updates have separate references. Git guidance asks once for permission to create a migration branch and make incremental commits.

The CLI build bundles the prompt and references. The upgrade command uses the invoked CLI version even when the project has a local v3 installation.

Closes #4122.

Validation:

  • Five CLI tests pass, covering prompt rendering, packaged references, special characters in paths, and delegation to a project-local CLI.
  • CLI TypeScript compilation, command execution, and package dry run pass. All 13 skill assets are included in the published layout.
  • Type-aware lint, formatting, skill validation and git diff --check pass.

[🤖] Codex using GPT-6.1-Sol

@vladfrangu vladfrangu added feature Issues that represent new features or improvements to existing features. t-tooling Issues with this label are in the ownership of the tooling team. labels Oct 7, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

feature Issues that represent new features or improvements to existing features. t-tooling Issues with this label are in the ownership of the tooling team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Create an AI skill / codemod for migrating from v3 to v4

1 participant