[PR #240] docs: add field learnings from real migrations to skill docs #411

New issue

Open

opened 2026-05-06 12:39:41 +02:00 by BreizhHardware · 0 comments

BreizhHardware commented

2026-05-06 12:39:41 +02:00

Owner

📋 Pull Request Information

Original PR: https://github.com/cloudflare/vinext/pull/240
Author: @southpolesteve
Created: 3/3/2026
Status: 🔄 Open

Base: main ← Head: docs/skills-field-learnings

📝 Commits (1)

583fb86 docs: add field learnings from real migrations to skill docs

📊 Changes

3 files changed (+78 additions, -0 deletions)

View changed files

📝 .agents/skills/migrate-to-vinext/SKILL.md (+17 -0)
📝 .agents/skills/migrate-to-vinext/references/config-examples.md (+49 -0)
📝 .agents/skills/migrate-to-vinext/references/troubleshooting.md (+12 -0)

📄 Description

Summary

Adds practical tips learned from real-world vinext migrations to the agent skill docs. Based on #233 by @vorcigernix, rebased cleanly on current main (preserving the Nitro deployment sections that were merged since that PR was opened).

Supersedes #233.

What's added

SKILL.md: "Field Learnings (From Real Migrations)" section covering auth guard gotchas, server action pitfalls, optimizeDeps.exclude risks, error boundary gaps, and dev warning noise
config-examples.md: "Known-Safe Migration Checklist" with concrete code examples for auth bypass, batch mutations, dependency optimization, and Better Auth + SIWE
troubleshooting.md: Three new error table rows (NEXT_REDIRECT, jsx export mismatch, CSS/JS loss on logout) and an "Auth + Session Stability" section

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/cloudflare/vinext/pull/240 **Author:** [@southpolesteve](https://github.com/southpolesteve) **Created:** 3/3/2026 **Status:** 🔄 Open **Base:** `main` ← **Head:** `docs/skills-field-learnings` --- ### 📝 Commits (1) - [`583fb86`](https://github.com/cloudflare/vinext/commit/583fb865380f4fa92144daed613ec7c4b29de09d) docs: add field learnings from real migrations to skill docs ### 📊 Changes **3 files changed** (+78 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `.agents/skills/migrate-to-vinext/SKILL.md` (+17 -0) 📝 `.agents/skills/migrate-to-vinext/references/config-examples.md` (+49 -0) 📝 `.agents/skills/migrate-to-vinext/references/troubleshooting.md` (+12 -0) </details> ### 📄 Description ## Summary Adds practical tips learned from real-world vinext migrations to the agent skill docs. Based on #233 by @vorcigernix, rebased cleanly on current main (preserving the Nitro deployment sections that were merged since that PR was opened). Supersedes #233. ### What's added - **SKILL.md**: "Field Learnings (From Real Migrations)" section covering auth guard gotchas, server action pitfalls, `optimizeDeps.exclude` risks, error boundary gaps, and dev warning noise - **config-examples.md**: "Known-Safe Migration Checklist" with concrete code examples for auth bypass, batch mutations, dependency optimization, and Better Auth + SIWE - **troubleshooting.md**: Three new error table rows (`NEXT_REDIRECT`, `jsx` export mismatch, CSS/JS loss on logout) and an "Auth + Session Stability" section --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>