Skip to content

docs: add workflow migration guides and skill#1584

Open
johnlindquist wants to merge 2 commits intomainfrom
migration-guides
Open

docs: add workflow migration guides and skill#1584
johnlindquist wants to merge 2 commits intomainfrom
migration-guides

Conversation

@johnlindquist
Copy link
Copy Markdown
Contributor

@johnlindquist johnlindquist commented Apr 1, 2026

Summary

  • Add migration guides for AWS Step Functions, Inngest, and Temporal under getting-started with side-by-side code comparisons
  • Add skills/migrating-to-vercel-workflow/ skill with reference docs, evals, and shared patterns
  • Update create-webhook API reference with resume choice clarifications

Test plan

  • Verify migration guide MDX files render correctly in docs
  • Confirm getting-started nav includes new migration entries
  • Review migration skill SKILL.md for accuracy

@johnlindquist
docs: add workflow migration guides and migration skill
0040be7 
Create migration guides for AWS Step Functions, Inngest, and Temporal under
docs/content/docs/getting-started/. Each guide provides side-by-side code
comparisons and a realistic order-processing saga example.

Add skills/migrating-to-vercel-workflow/ with SKILL.md, reference docs for
each source platform (aws-step-functions, inngest, temporal), shared patterns,
resume routing, runtime targets, and 5 eval scenarios.

Update create-webhook API reference with webhook resume choice clarifications.
Update getting-started meta.json to include migration guide navigation entries.
@vercel
Copy link
Copy Markdown
Contributor

vercel bot commented Apr 1, 2026 •
edited
Loading

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
example-nextjs-workflow-turbopack Ready Ready Preview, Comment Apr 7, 2026 0:15am
example-nextjs-workflow-webpack Ready Ready Preview, Comment Apr 7, 2026 0:15am
example-workflow Ready Ready Preview, Comment Apr 7, 2026 0:15am
workbench-astro-workflow Ready Ready Preview, Comment Apr 7, 2026 0:15am
workbench-express-workflow Ready Ready Preview, Comment Apr 7, 2026 0:15am
workbench-fastify-workflow Ready Ready Preview, Comment Apr 7, 2026 0:15am
workbench-hono-workflow Ready Ready Preview, Comment Apr 7, 2026 0:15am
workbench-nitro-workflow Ready Ready Preview, Comment Apr 7, 2026 0:15am
workbench-nuxt-workflow Ready Ready Preview, Comment Apr 7, 2026 0:15am
workbench-sveltekit-workflow Ready Ready Preview, Comment Apr 7, 2026 0:15am
workbench-vite-workflow Ready Ready Preview, Comment Apr 7, 2026 0:15am
workflow-docs Ready Ready Preview, 💬 2 unresolved, Open in v0 Apr 7, 2026 0:15am
workflow-swc-playground Ready Ready Preview, Comment Apr 7, 2026 0:15am

@johnlindquist johnlindquist requested a review from a team as a code owner April 1, 2026 17:43
@changeset-bot
Copy link
Copy Markdown

changeset-bot bot commented Apr 1, 2026 •
edited
Loading

⚠️ No Changeset found

Latest commit: 86f6ab2

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 1, 2026 •
edited
Loading

🧪 E2E Test Results

❌ Some tests failed

Summary

Passed Failed Skipped Total
❌ ▲ Vercel Production 845 1 67 913
✅ 💻 Local Development 818 0 178 996
✅ 📦 Local Production 818 0 178 996
✅ 🐘 Local Postgres 818 0 178 996
✅ 🪟 Windows 75 0 8 83
❌ 🌍 Community Worlds 135 63 24 222
✅ 📋 Other 207 0 42 249
Total 3716 64 675 4455

❌ Failed Tests

▲ Vercel Production (1 failed)

express (1 failed):

🌍 Community Worlds (63 failed)

mongodb (3 failed):

  • hookWorkflow is not resumable via public webhook endpoint | wrun_01KNJMP9TX3NY2AG11PV6R4C1B
  • concurrent hook token conflict - two workflows cannot use the same hook token simultaneously | wrun_01KNJMXTJRJ326GAMMKD9PMF5H
  • resilient start: addTenWorkflow completes when run_created returns 500

redis (3 failed):

  • hookWorkflow is not resumable via public webhook endpoint | wrun_01KNJMP9TX3NY2AG11PV6R4C1B
  • concurrent hook token conflict - two workflows cannot use the same hook token simultaneously | wrun_01KNJMXTJRJ326GAMMKD9PMF5H
  • resilient start: addTenWorkflow completes when run_created returns 500

turso (57 failed):

  • addTenWorkflow | wrun_01KNJMMVPZ020G5FKBMK11P2QG
  • addTenWorkflow | wrun_01KNJMMVPZ020G5FKBMK11P2QG
  • wellKnownAgentWorkflow (.well-known/agent) | wrun_01KNJMP4JGPAH2CJDRA54F9NZD
  • should work with react rendering in step
  • promiseAllWorkflow | wrun_01KNJMN2HYZN0K705FBTE77EN5
  • promiseRaceWorkflow | wrun_01KNJMNFYQRGVMT0JHZ6RK34J9
  • promiseAnyWorkflow | wrun_01KNJMNHYBND7NKD52QKYD5GW9
  • importedStepOnlyWorkflow | wrun_01KNJMPG40FRBMQ3X3ZQC6GS74
  • hookWorkflow | wrun_01KNJMNYXZMM5PCQ3ZQ30734QC
  • hookWorkflow is not resumable via public webhook endpoint | wrun_01KNJMP9TX3NY2AG11PV6R4C1B
  • webhookWorkflow | wrun_01KNJMPJ4A5H9SWN3VDFCDVFX2
  • sleepingWorkflow | wrun_01KNJMPR88NCKH4GVR4F2XNPTE
  • parallelSleepWorkflow | wrun_01KNJMQ49YJEZTTR1W0XVXAGK0
  • nullByteWorkflow | wrun_01KNJMQ8CF9ENNZE71KNYQ7YD4
  • workflowAndStepMetadataWorkflow | wrun_01KNJMQA9QY2ATC03CY3Y54FSK
  • fetchWorkflow | wrun_01KNJMSSBASPRAV2MY9BBG1KB1
  • promiseRaceStressTestWorkflow | wrun_01KNJMSWDW3VN1Z7YQNFE6KTK4
  • error handling error propagation workflow errors nested function calls preserve message and stack trace
  • error handling error propagation workflow errors cross-file imports preserve message and stack trace
  • error handling error propagation step errors basic step error preserves message and stack trace
  • error handling error propagation step errors cross-file step error preserves message and function names in stack
  • error handling retry behavior regular Error retries until success
  • error handling retry behavior FatalError fails immediately without retries
  • error handling retry behavior RetryableError respects custom retryAfter delay
  • error handling retry behavior maxRetries=0 disables retries
  • error handling catchability FatalError can be caught and detected with FatalError.is()
  • error handling not registered WorkflowNotRegisteredError fails the run when workflow does not exist
  • error handling not registered StepNotRegisteredError fails the step but workflow can catch it
  • error handling not registered StepNotRegisteredError fails the run when not caught in workflow
  • hookCleanupTestWorkflow - hook token reuse after workflow completion | wrun_01KNJMX62VR1H8WV1CWA8R51FB
  • concurrent hook token conflict - two workflows cannot use the same hook token simultaneously | wrun_01KNJMXTJRJ326GAMMKD9PMF5H
  • hookDisposeTestWorkflow - hook token reuse after explicit disposal while workflow still running | wrun_01KNJMYEMT070PD1AM66FYY546
  • stepFunctionPassingWorkflow - step function references can be passed as arguments (without closure vars) | wrun_01KNJMZ2F4ESKQDRDR8YYFCCN7
  • stepFunctionWithClosureWorkflow - step function with closure variables passed as argument | wrun_01KNJMZB930P9QRNB0JTN105T2
  • closureVariableWorkflow - nested step functions with closure variables | wrun_01KNJMZG2GNCZ21AKXZMM172RV
  • spawnWorkflowFromStepWorkflow - spawning a child workflow using start() inside a step | wrun_01KNJMZJ086DSB29V8VBADACKC
  • health check (queue-based) - workflow and step endpoints respond to health check messages
  • pathsAliasWorkflow - TypeScript path aliases resolve correctly | wrun_01KNJN01H5TQT88GH5B9TNJ568
  • Calculator.calculate - static workflow method using static step methods from another class | wrun_01KNJN06B4H2EGPK9VVH8W06WA
  • AllInOneService.processNumber - static workflow method using sibling static step methods | wrun_01KNJN0CBQA78G3DCBXW7JXDRZ
  • ChainableService.processWithThis - static step methods using this to reference the class | wrun_01KNJN0J3WPQEKJF2R0TZ1WVXW
  • thisSerializationWorkflow - step function invoked with .call() and .apply() | wrun_01KNJN0R4H8S2AW5AZPCGWSQT1
  • customSerializationWorkflow - custom class serialization with WORKFLOW_SERIALIZE/WORKFLOW_DESERIALIZE | wrun_01KNJN0XXAPQWRVXYY8RT3BBHW
  • instanceMethodStepWorkflow - instance methods with "use step" directive | wrun_01KNJN13RQD4RC848GVAEDKJWQ
  • crossContextSerdeWorkflow - classes defined in step code are deserializable in workflow context | wrun_01KNJN1E2NJ7KWA2YA8FT9S7ZN
  • stepFunctionAsStartArgWorkflow - step function reference passed as start() argument | wrun_01KNJN1N1PP2ZEK13VNN48KJ31
  • cancelRun - cancelling a running workflow | wrun_01KNJN1V084PSKR20R79RS0K50
  • cancelRun via CLI - cancelling a running workflow | wrun_01KNJN23SNPPSPBYAQBZC7QM3P
  • pages router addTenWorkflow via pages router
  • pages router promiseAllWorkflow via pages router
  • pages router sleepingWorkflow via pages router
  • hookWithSleepWorkflow - hook payloads delivered correctly with concurrent sleep | wrun_01KNJN2EWXTF683DZ4FE79M94G
  • sleepInLoopWorkflow - sleep inside loop with steps actually delays each iteration | wrun_01KNJN32XNQF0KAECKXWNSS27A
  • sleepWithSequentialStepsWorkflow - sequential steps work with concurrent sleep (control) | wrun_01KNJN3EC41SE8TECHTTCZQ9A9
  • importMetaUrlWorkflow - import.meta.url is available in step bundles
  • metadataFromHelperWorkflow - getWorkflowMetadata/getStepMetadata work from module-level helper (#1577)
  • resilient start: addTenWorkflow completes when run_created returns 500

Details by Category

❌ ▲ Vercel Production
App Passed Failed Skipped
✅ astro 76 0 7
✅ example 76 0 7
❌ express 75 1 7
✅ fastify 76 0 7
✅ hono 76 0 7
✅ nextjs-turbopack 81 0 2
✅ nextjs-webpack 81 0 2
✅ nitro 76 0 7
✅ nuxt 76 0 7
✅ sveltekit 76 0 7
✅ vite 76 0 7
✅ 💻 Local Development
App Passed Failed Skipped
✅ astro-stable 69 0 14
✅ express-stable 69 0 14
✅ fastify-stable 69 0 14
✅ hono-stable 69 0 14
✅ nextjs-turbopack-canary 58 0 25
✅ nextjs-turbopack-stable 75 0 8
✅ nextjs-webpack-canary 58 0 25
✅ nextjs-webpack-stable 75 0 8
✅ nitro-stable 69 0 14
✅ nuxt-stable 69 0 14
✅ sveltekit-stable 69 0 14
✅ vite-stable 69 0 14
✅ 📦 Local Production
App Passed Failed Skipped
✅ astro-stable 69 0 14
✅ express-stable 69 0 14
✅ fastify-stable 69 0 14
✅ hono-stable 69 0 14
✅ nextjs-turbopack-canary 58 0 25
✅ nextjs-turbopack-stable 75 0 8
✅ nextjs-webpack-canary 58 0 25
✅ nextjs-webpack-stable 75 0 8
✅ nitro-stable 69 0 14
✅ nuxt-stable 69 0 14
✅ sveltekit-stable 69 0 14
✅ vite-stable 69 0 14
✅ 🐘 Local Postgres
App Passed Failed Skipped
✅ astro-stable 69 0 14
✅ express-stable 69 0 14
✅ fastify-stable 69 0 14
✅ hono-stable 69 0 14
✅ nextjs-turbopack-canary 58 0 25
✅ nextjs-turbopack-stable 75 0 8
✅ nextjs-webpack-canary 58 0 25
✅ nextjs-webpack-stable 75 0 8
✅ nitro-stable 69 0 14
✅ nuxt-stable 69 0 14
✅ sveltekit-stable 69 0 14
✅ vite-stable 69 0 14
✅ 🪟 Windows
App Passed Failed Skipped
✅ nextjs-turbopack 75 0 8
❌ 🌍 Community Worlds
App Passed Failed Skipped
✅ mongodb-dev 5 0 0
❌ mongodb 58 3 8
✅ redis-dev 5 0 0
❌ redis 58 3 8
✅ turso-dev 5 0 0
❌ turso 4 57 8
✅ 📋 Other
App Passed Failed Skipped
✅ e2e-local-dev-nest-stable 69 0 14
✅ e2e-local-postgres-nest-stable 69 0 14
✅ e2e-local-prod-nest-stable 69 0 14

📋 View full workflow run

❌ Some E2E test jobs failed:

  • Vercel Prod: failure
  • Local Dev: success
  • Local Prod: success
  • Local Postgres: success
  • Windows: success

Check the workflow run for details.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 1, 2026 •
edited
Loading

📊 Benchmark Results

📈 Comparing against baseline from main branch. Green 🟢 = faster, Red 🔺 = slower.

workflow with no steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 0.059s (~) 1.010s (~) 0.952s 10 1.00x
🐘 Postgres Express 0.060s (-0.8%) 1.011s (~) 0.951s 10 1.02x
workflow with 1 step

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 1.139s (-1.0%) 2.008s (~) 0.869s 10 1.00x
🐘 Postgres Nitro 1.143s (~) 2.011s (~) 0.868s 10 1.00x
workflow with 10 sequential steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 10.868s (~) 11.022s (~) 0.155s 3 1.00x
🐘 Postgres Express 10.910s (~) 11.023s (~) 0.113s 3 1.00x
workflow with 25 sequential steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 14.527s (~) 15.020s (~) 0.493s 4 1.00x
🐘 Postgres Express 14.568s (~) 15.027s (~) 0.459s 4 1.00x
workflow with 50 sequential steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 13.955s (~) 14.024s (-1.0%) 0.070s 7 1.00x
🐘 Postgres Express 14.138s (~) 14.880s (~) 0.743s 7 1.01x
Promise.all with 10 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 1.262s (~) 2.010s (~) 0.748s 15 1.00x
🐘 Postgres Express 1.278s (-0.6%) 2.009s (~) 0.732s 15 1.01x
Promise.all with 25 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 2.308s (-0.8%) 3.009s (~) 0.700s 10 1.00x
🐘 Postgres Nitro 2.334s (~) 3.010s (~) 0.676s 10 1.01x
Promise.all with 50 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 3.453s (-1.0%) 4.011s (~) 0.558s 8 1.00x
🐘 Postgres Nitro 3.502s (~) 4.010s (~) 0.508s 8 1.01x
Promise.race with 10 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 1.253s (+0.9%) 2.008s (~) 0.755s 15 1.00x
🐘 Postgres Express 1.262s (~) 2.009s (~) 0.746s 15 1.01x
Promise.race with 25 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 2.321s (-1.5%) 3.009s (~) 0.688s 10 1.00x
🐘 Postgres Nitro 2.343s (+0.9%) 3.011s (~) 0.669s 10 1.01x
Promise.race with 50 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 3.448s (-1.4%) 4.009s (~) 0.561s 8 1.00x
🐘 Postgres Nitro 3.468s (~) 4.011s (~) 0.543s 8 1.01x
workflow with 10 sequential data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 0.821s (-1.6%) 1.023s (+1.6%) 0.201s 59 1.00x
🐘 Postgres Express 0.837s (-2.9%) 1.006s (-1.7%) 0.169s 60 1.02x
workflow with 25 sequential data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 1.945s (-1.1%) 2.257s (~) 0.312s 40 1.00x
🐘 Postgres Express 2.053s (-2.0%) 2.767s (-5.0%) 0.713s 33 1.06x
workflow with 50 sequential data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 3.877s (-3.1%) 4.076s (-5.9% 🟢) 0.199s 30 1.00x
🐘 Postgres Express 4.059s (-3.7%) 4.741s (-4.7%) 0.682s 26 1.05x
workflow with 10 concurrent data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 0.278s (-3.3%) 1.007s (~) 0.729s 60 1.00x
🐘 Postgres Nitro 0.284s (+2.4%) 1.006s (~) 0.722s 60 1.02x
workflow with 25 concurrent data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 0.486s (-1.1%) 1.006s (~) 0.520s 90 1.00x
🐘 Postgres Nitro 0.490s (~) 1.006s (~) 0.516s 90 1.01x
workflow with 50 concurrent data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 0.774s (~) 1.007s (~) 0.233s 120 1.00x
🐘 Postgres Express 0.777s (-3.8%) 1.016s (+0.6%) 0.239s 119 1.00x
Stream Benchmarks (includes TTFB metrics)
workflow with stream

💻 Local Development

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 0.212s (+4.7%) 0.995s (~) 0.001s (+7.7% 🔺) 1.010s (~) 0.798s 10 1.00x
🐘 Postgres Express 0.215s (-1.1%) 0.997s (~) 0.001s (-38.5% 🟢) 1.009s (~) 0.794s 10 1.01x
stream pipeline with 5 transform steps (1MB)

💻 Local Development

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 0.600s (-3.2%) 1.007s (~) 0.004s (+44.0% 🔺) 1.025s (~) 0.425s 59 1.00x
🐘 Postgres Express 0.613s (+1.2%) 1.004s (~) 0.004s (+5.1% 🔺) 1.021s (~) 0.408s 59 1.02x
10 parallel streams (1MB each)

💻 Local Development

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 0.937s (-1.7%) 1.151s (-1.6%) 0.000s (+96.2% 🔺) 1.162s (-1.9%) 0.225s 52 1.00x
🐘 Postgres Nitro 0.954s (~) 1.166s (-2.5%) 0.000s (+92.3% 🔺) 1.181s (-2.3%) 0.226s 52 1.02x
fan-out fan-in 10 streams (1MB each)

💻 Local Development

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 1.675s (-5.2% 🟢) 2.100s (+1.3%) 0.000s (-50.0% 🟢) 2.119s (+0.5%) 0.444s 29 1.00x
🐘 Postgres Nitro 1.768s (~) 2.138s (+1.8%) 0.000s (+Infinity% 🔺) 2.152s (~) 0.384s 28 1.06x

Summary

Fastest Framework by World

Winner determined by most benchmark wins

World 🥇 Fastest Framework Wins
🐘 Postgres Nitro 12/21
Fastest World by Framework

Winner determined by most benchmark wins

Framework 🥇 Fastest World Wins
Express 🐘 Postgres 21/21
Nitro 🐘 Postgres 21/21
Column Definitions
  • Workflow Time: Runtime reported by workflow (completedAt - createdAt) - primary metric
  • TTFB: Time to First Byte - time from workflow start until first stream byte received (stream benchmarks only)
  • Slurp: Time from first byte to complete stream consumption (stream benchmarks only)
  • Wall Time: Total testbench time (trigger workflow + poll for result)
  • Overhead: Testbench overhead (Wall Time - Workflow Time)
  • Samples: Number of benchmark iterations run
  • vs Fastest: How much slower compared to the fastest configuration for this benchmark

Worlds:

  • 💻 Local: In-memory filesystem world (local development)
  • 🐘 Postgres: PostgreSQL database world (local development)
  • ▲ Vercel: Vercel production/preview deployment
  • 🌐 Turso: Community world (local development)
  • 🌐 MongoDB: Community world (local development)
  • 🌐 Redis: Community world (local development)
  • 🌐 Jazz: Community world (local development)

📋 View full workflow run

johnlindquist added a commit that referenced this pull request Apr 6, 2026
@johnlindquist
In PR #1584 (migration-guides branch), make two changes to the migrat…
3d44478 
…ion guides:

1. Move migration guides to a top-level "Migration Guides" nav section:
   - Create docs/content/docs/migration-guides/ directory
   - Move the 3 migrating-from-*.mdx files from getting-started/ into migration-guides/
   - Create migration-guides/meta.json with title "Migration Guides" listing temporal, inngest, aws-step-functions
   - Add "migration-guides" between "errors" and "api-reference" in docs/content/docs/meta.json
   - Remove the 3 migration entries from getting-started/meta.json

2. Replace all "Vercel Workflow" language with "Workflow SDK" across docs and skills:
   - In all 3 MDX migration guides: replace "Vercel Workflow" with "the Workflow SDK" or "Workflow SDK" in frontmatter, headings, table headers, and body text
   - Replace "shipping on Vercel" with neutral phrasing, "Vercel-managed execution" with "managed execution", "Vercel's infrastructure" with neutral phrasing
   - Replace Vercel-specific pricing paragraphs with generic "Efficient resource usage" bullet
   - Replace "Deploy to Vercel first..." checklist items with neutral deployment guidance
   - Keep vercel-world prerequisite links (real package name)
   - Rename skills/migrating-to-vercel-workflow/ to skills/migrating-to-workflow-sdk/
   - Update all skill SKILL.md, evals/, and references/ files to replace "Vercel Workflow" with "Workflow SDK"
   - Update runtime-targets.md section headers from "Non-Vercel" to "Self-hosted"
@johnlindquist
In PR #1584 (migration-guides branch), make two changes to the migrat…
86f6ab2 
…ion guides:

1. Move migration guides to a top-level "Migration Guides" nav section:
   - Create docs/content/docs/migration-guides/ directory
   - Move the 3 migrating-from-*.mdx files from getting-started/ into migration-guides/
   - Create migration-guides/meta.json with title "Migration Guides" listing temporal, inngest, aws-step-functions
   - Add "migration-guides" between "errors" and "api-reference" in docs/content/docs/meta.json
   - Remove the 3 migration entries from getting-started/meta.json

2. Replace all "Vercel Workflow" language with "Workflow SDK" across docs and skills:
   - In all 3 MDX migration guides: replace "Vercel Workflow" with "the Workflow SDK" or "Workflow SDK" in frontmatter, headings, table headers, and body text
   - Replace "shipping on Vercel" with neutral phrasing, "Vercel-managed execution" with "managed execution", "Vercel's infrastructure" with neutral phrasing
   - Replace Vercel-specific pricing paragraphs with generic "Efficient resource usage" bullet
   - Replace "Deploy to Vercel first..." checklist items with neutral deployment guidance
   - Keep vercel-world prerequisite links (real package name)
   - Rename skills/migrating-to-vercel-workflow/ to skills/migrating-to-workflow-sdk/
   - Update all skill SKILL.md, evals/, and references/ files to replace "Vercel Workflow" with "Workflow SDK"
   - Update runtime-targets.md section headers from "Non-Vercel" to "Self-hosted"
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@johnlindquist