Skip to content

docs: add field learnings from real migrations to skill docs#240

Open
southpolesteve wants to merge 1 commit intomainfrom
docs/skills-field-learnings
Open

docs: add field learnings from real migrations to skill docs#240
southpolesteve wants to merge 1 commit intomainfrom
docs/skills-field-learnings

Conversation

@southpolesteve
Copy link
Collaborator

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

Add practical tips learned from real-world vinext migrations:
- Field learnings section in SKILL.md (auth guards, server actions,
  optimizeDeps, error boundaries, dev warnings)
- Known-safe migration checklist in config-examples.md
- New troubleshooting entries for common regressions
- Auth + session stability guide for App Router

Based on PR #233 by @vorcigernix, rebased on current main.
@pkg-pr-new
Copy link

pkg-pr-new bot commented Mar 3, 2026

Open in StackBlitz

npm i https://pkg.pr.new/vinext@240

commit: c4fb682

@github-actions
Copy link

github-actions bot commented Mar 3, 2026

Example Preview Production Original
app-router-cloudflare preview production
pages-router-cloudflare preview production
app-router-playground preview production original
realworld-api-rest preview production
nextra-docs-template preview production
benchmarks preview production
hackernews preview production original

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant